Using the Boomi Data Hub connector
This topic provides a worked example of a Flow using the Boomi Data Hub connector to retrieve and work with data from with Data Hub.
About this worked example
This worked example is provided to help you get started with using the Boomi Data Hub connector by walking through a simple example Flow.
Setup
In this worked example, a simple Data Hub setup is configured and deployed.
Repository: Boomi Data Hub connector
A repository is created and assigned to the appropriate runtime.
Repository Name: Boomi Data Hub connector
Model: Employee
A simple "employee" type of model is set up, containing a repeatable and a non-repeatable field group.
| Field/Field Group | Name | Type | Unique ID | Repeatable | Required |
|---|---|---|---|---|---|
| Field | Employee badge id | Text | EMPLOYEE_BADGE_ID | - | Yes |
| Field Group | Person | - | PERSON | No | No |
| → Field | Name | Text | NAME | - | No |
| Field Group | Equipment | - | EQUIPMENT | Yes | No |
| → Field | equipment name | Text | EQUIPMENT_NAME_1 | - | No |
Match Rules: Employee badge id
A simple match rule is added that checks for a match on:
Employee badge id AND Incoming Employee badge id is similar to (Jaro-Winkler) Existing Employee badge id
Source: Flow
A single source is attached to the repository:
Name: Flow
Entity ID URL: https://flow.boomi.com/flow
Installing the Boomi Data Hub connector in Flow
The Boomi Data Hub connector is installed into a tenant, using the following configuration values:
| Name | Value Name | Value Kind | Access | Default Value |
|---|---|---|---|---|
| Hub Hostname | Hub: Hostname | String | Private - No external access | c01-usa-east.hub.boomi.com |
| Hub Token | Hub: Token | Password | Private - No external access | The value of the repository Token, taken from the My Hub Authentication Token field. |
| Hub Username | Hub: Username | String | Private - No external access | The value of the repository Username, taken from the Username field. |
Once the connector has been installed, a number of types are automatically generated to allow the Flow to interact with the model:
-
The overall 'Employee' Model is translated into an 'employee' type.
-
The 'Person' field group is translated into an 'employee - person' type.
-
The 'Equipment' field group is translated into an 'employee - equipment' type.
An overview of the example Flow
A simple Flow is built to demonstrate how to interact with Data Hub via the connector:
When the Flow is run in a web browser, the user is presented with a welcome screen:
-
A simple top navigation element is added to allow a user to access each of the main Flow areas.
-
The Flow allows a user to view a list of golden records ('Show golden records'), create a new golden record ('Create golden record'), update a golden record, or delete a golden record.
Refer to golden records. -
The Flow allows a user to display a list of quarantined records ('Show quarantined records').
Refer to quarantined records. -
The Flow allows a user to input a value in order to test the match rules configured in ('Match rules').
Refer to match rules.
