Get Golden Record operation

The Get Golden Record operation retrieves a specified golden record from the authenticated repository. You can retrieve it based on a golden record ID or source entity ID. This operation aligns with the Get Golden Record operation in the Repository API.

Prerequisites

You must have the following:

• A Hub repository
• A deployed model in the repository
• Active or end-dated golden records in the repository
• A deployed Boomi basic runtime to run connector operations (Integration > Manage > Runtime Management)

Setting up the Get Golden Record operation

1. In the connector, select Get Golden Record in the Action drop-down.
2. Click the plus icon in the Operation field to create a new operation.
3. Click Import Operation.
4. Select the basic runtime you want to use to run your integration. The basic runtime must be online.
5. Ensure the connection you created to the repository is selected in the Connection field.
6. Optional: In Source, enter the source ID, which acts as a filter to help you select the deployed model name. You can find the source ID on the Sources page in Hub.
7. Optional: In Filter, enter a regex as a filter to help you select the deployed model name.
8. Click Next.
9. Select the deployed model name.
10. Click Next.
11. Click Finish. The import operation creates a response profile. You can use this response profile to map data in a Map step within your integration.
12. If you use a source entity ID in step 18, enter the source ID in Source for the source attached to the record. You can find the source ID on the Sources page in Hub.
13. Optional: Select Return Application Error Responses if you want the operation to continue when there is an application error. Processing continues and passes the error to the next component processed as the connection output. When the checkbox is clear, the process stops and reports the error in Process Reporting.
14. Click Save and Close.
15. Select the Parameters tab to import the ID parameter. Click the link to import all.
16. Select the parameter in the list.
17. Click the edit icon.
18. Add the golden record ID or the source entity ID as the Static Value.
19. Click OK.
20. Click Save.

Active golden record response example

<contact createddate="04-29-2024T19:41:22.000+0000" grid="12bf3e7e-fa64-4bf9-12gh-12abcd245ef6" updateddate="05-16-2024T19:57:03.000+0000" source="SFDC">
  <id>12bf3e7e-fa64-4bf9-12gh-12abcd245ef6</id>
  <name>Quinn</name>
  <city>New York</city>
  <state>NY</state>
  <country>USA</country>
</contact>

info

The connector uses administrator privileges to authenticate. Therefore, masked field values are unmasked in responses.

Element	Definition
createddate	Date and time of record creation. The format is yyyy-MM-dd'T'HH:mm:ss'Z', where 'T' separates the date and time.
grid	Golden record unique ID (GRID).
updateddate	Timestamp of the most recent update to the record. The format is yyyy-MM-dd'T'HH:mm:ss'Z', where 'T' separates the date and time.
source	Source's unique ID specified in Hub's Sources page.
id	Golden record unique ID.

End-dated golden record response example

If the retrieved golden record is end-dated, the response includes additional root element attributes in place of createddate and updateddate.

<contact enddate="09-24-2019T15:34:07.000-0400" grid="8219b49a-7806-4cdf-b73e-935d9e3a6bb8" source="SF"
 enddatesource="SF" startdate="01-07-2016T15:59:05.000-0500" version="723"
 transactionId="ce62727a-8d80-4fe3-b6de-52a43c3fe856">
  <id>8219b49a-7806-4cdf-b73e-935d9e3a6bb8</id>
  <name>pete</name>
  <city>west chester</city>
  <email>pete@gmail.com</email>
</contact>

Element	Definition
enddate	The timestamp of when the golden record was end-dated. Replaces createddate and updateddate for end-dated records.
grid	Golden record unique ID (GRID).
source	Source's unique ID specified in Hub's Sources page.
enddatesource	Optional field. The source that requested end-dating of the golden record. A value of *MDM* indicates the end-dating was a user action within Boomi Data Hub.
startdate	The timestamp of the creation of the end-dated version of the golden record.
version	The unique ID of the end-dated version.
transactionId	The transaction ID for the contribution of the end-dated version.
id	Golden record unique ID.