Kimai

Kimai is an open-source time-tracking software designed for freelancers, agencies, and small teams. It provides tools to record and manage work hours across projects, facilitating accurate project time tracking and reporting.

How to Connect Kimai to ZBrain Flow?

To integrate Kimai with ZBrain Flow, follow these steps to select and utilize the desired capabilities:

1. Search for the Kimai Component: Search the Kimai component within the ZBrain interface.

2. Select the Required Capability: Select the desired element from these:

• Create Timesheet

• Create a new timesheet

• Custom API Call

• Send a custom API call to a specific endpoint

Additional Settings to Create Kimai Connection

To configure API access:

1. Go to Kimai Web UI;

2. Click on your user profile and then go to "API Access";

3. Configure an API password (different from user password).

To create Kimai connection, provide these details:

• Connection Name: Specify a unique name for this connection to identify it in your settings.

• Server URL: Enter the URL of your Kimai instance where the API can be accessed.

• Username: Provide the username or email associated with your Kimai account.

• API Password: Input the specific API password you created in your Kimai user profile under 'API Access'.

Additional Settings to Create Timesheet

• Connection - Select the integration connection to use for accessing Kimai.

• Project - Specify the Kimai project to which the timesheet relates.

• Activity - Choose the specific activity within the selected project for time tracking.

• Begin Date - Set the start date and time for the timesheet entry.

• End Date - Set the end date and time for the timesheet entry.

• Description - Provide additional details or notes about the timesheet entry.

Additional Settings for Custom API Call

• Connection - Select the previously configured connection to Kimai for API access.

• Method - Choose the HTTP method (e.g., GET, POST) appropriate for the API call you need to make.

• Headers - Add any necessary HTTP headers; typically used for content type or authentication tokens. Headers are automatically injected based on the selected connection.

• Query Parameters - Add query parameters required by the API endpoint to refine the request or provide necessary information.

• Body - Input the JSON or other data structure necessary for POST or PUT requests to the API.

• Timeout (in seconds) - Set the duration the API call waits for a response before timing out.

• No Error on Failure - Toggle whether to treat API call failures as errors.