CRDevelopment.BambooNET 0.1.10

BambooNET

A .NET client library for the BambooHR API.

Table of Contents

• Usage
• Reference
• Code of Conduct
• Issues / Support
• Contributing
• Author
• License

Usage

static readonly string COMPANY_SUBDOMAIN = "yourcompany";
static readonly string API_KEY = "YourBamb00HRAPIKey";

static readonly int BAMBOO_ID = 123;
static readonly DateTime START_DATE = new(2024, 11, 30);
static readonly DateTime END_DATE = new(2024, 12, 13);

try
{
  var bambooClient = new BambooClient(COMPANY_SUBDOMAIN, API_KEY);

  var timesheets = await bambooClient.TimeTracking.GetTimesheetEntriesAsync(START_DATE, END_DATE);
  Console.WriteLine($"TimeTracking.GetTimesheetEntriesAsync Results: {timesheets.Count}");

  var requests = await bambooClient.TimeOff.GetRequestsAsync(START_DATE, END_DATE);
  Console.WriteLine($"TimeOff.GetRequestsAsync Results: {requests.Count}");

  var whosout = await bambooClient.TimeOff.GetWhosOutAsync(START_DATE, END_DATE);
  Console.WriteLine($"TimeOff.GetWhosOutAsync Results: {whosout.Count}");

  var employeedata = await bambooClient.Employees.GetEmployeeDataAsync(BAMBOO_ID);
  Console.WriteLine($"Employees.GetEmployeeDataAsync Results: {employeedata.FirstName} {employeedata.LastName}");

  var ex_employeedata = await bambooClient.Employees.GetEmployeeDataAsync<ExtendedEmployeeData>(BAMBOO_ID);
  Console.WriteLine($"Employees.GetEmployeeDataAsync Results: {ex_employeedata.FirstName} {ex_employeedata.LastName}, Hours: {ex_employeedata.HoursPerWeek}");

  var tabledata = await bambooClient.Employees.GetTabularDataAsync<JobInfoData>(BAMBOO_ID, "jobInfo");
  Console.WriteLine($"Employees.GetTabularDataAsync Results: {tabledata.Count}");

  var dataset = await bambooClient.Datasets.GetDatasetDataAsync<ExtendedEmployeeData>("employee",
    new(FiltersMatch.ANY,
    [
      new("hireDate", FilterOperator.GreaterThanOrEqual, START_DATE.ToString(bambooClient.DateFormat))
    ]),
    [
      new("hireDate", SortDirection.DESC),
      new("lastName", SortDirection.ASC),
      new("firstName", SortDirection.ASC)
    ]
  );
  Console.WriteLine($"Datasets.GetDatasetData Results: {dataset.Count}");
}
catch (Exception ex)
{
  Console.WriteLine(ex.ToString());
}

Reference

• BambooHR API Reference

Code of Conduct

This project has adopted the code of conduct defined by the Contributor Covenant to clarify expected behavior.
For more information see the Code of Conduct.

Issues / Support

See SECURITY.md for feature requests or bug reports.

Contributing

See CONTRIBUTING.md for more information.

Author

Craig Roberts

License

Copyright © 2024 CR Development. Licensed under the MIT license.
See LICENSE.md or https://opensource.org/license/mit for more details.