BrassRing Connector
Intro
IBM Kenexa BrassRing Inc. designs and develops cloud-based recruitment consulting and outsourcing solutions. Use Domo's BrassRing connector to send a custom XML envelope to the BrassRing API. To learn more about the BrassRing API, visit their page (http://www-01.ibm.com/support/docview.wss?uid=swg21995062).
You connect to your BrassRing account in the Data Center. This topic discusses the fields and menus that are specific to the BrassRing connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in Adding a DataSet Using a Data Connector.
Prerequisites
To connect to your BrassRing account and create a DataSet, you must have the following:
-
The API URL domain for your BrassRing account. For example: https://stagingimport.brassring.com
-
Your BrassRing Sender ID.
-
Your BrassRing Credential.
-
Your BrassRing Client ID.
-
Your BrassRing Site ID.
Connecting to Your BrassRing Account
This section enumerates the options in the Credentials and Details panes in the BrassRing Connector page. The components of the other panes in this page, Scheduling and Name & Describe Your DataSet, are universal across most connector types and are discussed in greater length in Adding a DataSet Using a Data Connector.
Credentials Pane
This pane contains fields for entering credentials to connect to your BrassRing account. The following table describes what is needed for each field:
Field |
Description |
---|---|
API URL |
Enter the API URL domain for your BrassRing account. |
Sender ID |
Enter your BrassRing Sender ID. |
Credential |
Enter your BrassRing credential. |
Client ID |
Enter your BrassRing Client ID. |
Site ID |
Enter your BrassRing Site ID. |
Once you have entered valid BrassRing credentials, you can use the same account any time you go to create a new BrassRing DataSet. You can manage connector accounts in the Accounts tab in the Data Center. For more information about this tab, see Managing User Accounts for Connectors.
Details Pane
This pane contains only two configuration options—a Report menu (which currently contains only one report) and a field where you enter your XML envelope content.
Menu |
Description |
||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Report |
Select the desired BrassRing report. Currently only one report type is available.
|
||||||||||
XML Envelope |
Enter the BrassRing XML envelope to POST to the API. The envelope content must be valid and well-formed XML. For more information on constructing the XML envelope, please see BrassRing API documentation at http://www-01.ibm.com/support/docview.wss?uid=swg21995062. Credential fields in the XML envelope MUST be aliased in the following format:
To get an idea of how an envelope is constructed, you can look at the example envelope provided in the BrassRing connector UI. |
Other Panes
For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see Adding a DataSet Using a Data Connector.