App Connect

 View Only

Using IBM® App Connect to interact with Toggl Track

By Irene A Peter posted 5 days ago

  

Using IBM® App Connect to interact with Toggl Track

Toggl Track is a time-tracking software for businesses and freelancers. It can track time spent on projects and analyze productivity.

Building a flow in IBM App Connect with Toggl Track

Use App Connect to build flows that integrate with Toggl Track and other applications. The connector is displayed as Toggl Track on the App Connect User Interface (UI). 

To allow App Connect to connect to your Toggl Track account, you need to fill in the connection fields that you see in the App Connect Designer Catalog page or flow editor.

Supported authorization types:

  • BASIC 
  • API KEY

For detailed information about different authorization types, how to generate connection field values, and how to use the Templates gallery, see How to use IBM App Connect with Toggl Track on the IBM Documentation page.

Supported objects in Toggl Track

The following are the Toggl Track objects that can be run in App Connect.

Object  Description
Clients Assigning clients to your projects will allow you to get an extra level of time tracking data categorization and make it easier to create reports by applying both the project and the client filter. 
Workspace invites Workspace invites create new workspace invitations for the user.
Tags
Tags provide extra information about an individual time entry. Most often, they are used to mark time as invoiced or billed. 
Workspace projects The workspace project is the main organizational structure in Toggl Track. Only one client can be added to a single project. One project may contain multiple time entries. Billable rates, estimates and other features are defined on the project level.
Workspace users Workspace users contain the details of all the users that are mapped to a specific workspace.
Time entries Time entries contain the time information. Time entries can be directly associated with tasks and projects, but not clients (that connection is made through projects). 
Workspaces

The workspace contains the list of projects and tasks that are associated with the workspace. Everything you do in Toggl Track gets allocated to a workspace: time entries, projects, clients, etc. 

 

Scenario: Send an invite to fill time entries in Toggl Track for each new employee added to BambooHR

Consider the following scenario:

In this flow, when a new employee is added to the Bamboo HR, the employee details are retrieved during specific intervals, and an invitation for filling in time entries in Toggl Track is sent to the employee's mail through Toggl Track. 

The following are the steps involved in the flow:

1. In the event Scheduler node, specify a time schedule based on your requirement (choose how often you want to run the flow).
2. Using the Retrieve employees operation, a list of new employees is retrieved based on the previous event time set in the Scheduler node.
3. For each new employee, a condition is set to retrieve all the employee details of the new employees added to BambooHR.

4. Using the Toggl Track Create an invitation node, a customized invitation for filling in time entries in Toggl Track as a non-admin user is sent to the mail of the new employees.

Resources

You can view this template and other useful templates in the Templates gallery of your App Connect Designer instance.

Get started with a free IBM App Connect Enterprise as a Service trial for 30 days to try out all our templates, visit https://ibm.biz/app-trial.

If you are running a containerized instance of IBM App Connect, use the following URL to directly access the template:

  • Send an invite to fill time entries in Toggl Track for each new employee added to BambooHR: https://<your-instance-id>/templates/Send%20an%20invite%20to%20fill%20time%20entries%20in%20Toggl%20Track%20for%20each%20new%20employee%20added%20to%20BambooHR
  • Create time entries in Toggl Track for each new issue created in Jira: https://<your-instance-id>/templates/Create%20time%20entries%20in%20Toggl%20Track%20for%20each%20new%20issue20created%20in%20Jira

            Note: Replace <your-instance-id> in the URL with your custom instance ID.

You must enable the Designer AI features in your containerized environment to access the App Connect templates. For more information, see The preloaded IBM App Connect templates.

You also have the option to import the .yaml file for this template directly into your App Connect Designer instance. These templates are available in a public GitHub repository.

0 comments
1 view

Permalink