BMC Helix Data Connector
The BMC Helix ITSM Data Connector syncs records from your BMC Helix instance via the BMC AR REST API. Each connector pulls from one or more AR form. Common forms include:
AR form | Description |
|---|---|
HPD:Help Desk | Incidents |
CHG:Infrastructure Change | Change requests |
PBM:Problem Investigation | Problems |
WOI:WorkOrder | Work orders |
Any AR form can be configured. Output table names are sanitized from the form name — for example, HPD:Help Desk becomes HPD_Help_Desk.
Authentication
BMC Helix uses AR-JWT authentication. The connector exchanges a username and password for a JWT via the AR REST endpoint POST /api/jwt/login. Tokens are refreshed automatically. Provide the following to your BigPanda account team:
BMC Helix tenant base URL (the AR REST endpoint).
Username of the BigPanda service account on Helix.
Password of the BigPanda service account on Helix.
Other authentication options (basic auth, OAuth) are not currently supported for the Helix connector. Contact your account team if your environment requires a different method.
Sync preferences
Provide the following information about your sync preferences to BigPanda:
Required Configuration
Option | Description |
|---|---|
Mode | Determine whether you’d like to set up an incremental or historical sync. Most organizations will need to use both modes. See the Streaming Modes section for more information. |
Connector Configuration
Option | Default | Description |
|---|---|---|
tables | required | Map of AR form name → per-form configuration (above). |
start_date | — | Earliest record date to ingest, |
end_date | — | Latest record date to ingest, |
rate_limit | 5 | Maximum API requests per interval. |
rate_limit_timeout_ms | 1000 | Wait time after the rate limit is reached, in milliseconds. |
Per-form Pipeline Configuration
Configure each form via the connector's forms) map. Each entry accepts:
Option | Description |
|---|---|
fields | A list of AR field names to fetch. Omit to fetch all fields. |
qualification | An AR REST qualification string applied to that form independently. For example, |
primary_key | The AR field used as the primary key for deduplication. For example, |
Filters use BMC's qualification-string syntax with single-quoted field names, double-quoted values. Refer to BMC's AR REST API documentation for operator and function support.