Skip to main content

​
Intro

IBM Kenexa BrassRing Inc. designs and develops cloud-based recruitment consulting and outsourcing solutions. 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 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:
FieldDescription
API URLEnter the API URL domain for your BrassRing account.
Sender IDEnter your BrassRing Sender ID.
CredentialEnter your BrassRing credential.
Client IDEnter your BrassRing Client ID.
Site IDEnter 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. Aqui está uma explicação sobre a integração com o BrassRing.

Menu

Description

Report

Select the desired BrassRing report. Currently only one report type is available.

XML Envelope Lets you post custom-created XML envelope content to the BrassRing API.
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:

Credential Alias
Sender ID
Credential
Client ID
Site ID

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 a DataSet Using a Data Connector.