Reference

The Microsoft Dataverse integration retrieves and updates customer party data in Dataverse for Microsoft Dynamics 365 CRM. The party connector is outbound: it reads and updates contact records. The party inbound connector receives create, update, and delete webhooks from Dataverse and publishes party update events to the Sync Hub ASB producer. For setup steps, see Get started. Supported version: Microsoft Dataverse Contact Entity API.

Connector	Property file	Purpose
`gc-dataverse-party-connector`	`party-v0.values.yaml`	Outbound party retrieval and update
`gc-dataverse-party-inbound-connector`	`party-inbound-v0.values.yaml`	Inbound party update events from Dataverse webhooks

Configuration properties

gc-dataverse-party-connector

Set these properties in party-v0.values.yaml. This connector sends outbound requests to Dataverse.

Property	Description	Default
`dataverse.serviceUri`	Target API endpoint for Dataverse, including the API version.	N/A (environment-specific)
`dataverse.resourcePath`	Resource path for the Dataverse entity mapped to a party.	`/contacts`
`errorTemplate`	Error mapping template file used to translate Dataverse errors.	`transform-dataverse-error-details.json`
`http.client.connect.timeout`	HTTP connect timeout, in milliseconds.	`5000`
`http.client.request.timeout`	HTTP request timeout, in milliseconds.	`10000`
`http.client.socket.timeout`	HTTP socket timeout, in milliseconds.	`5000`
`http.client.connection.max.per.route`	Maximum HTTP connections per route.	`100`
`http.client.connection.max.total`	Maximum total HTTP connections.	`200`
`thread.profile.core.pool.size`	Core thread pool size.	`20`
`thread.profile.max.pool.size`	Maximum thread pool size.	`20`
`retryFlag`	Enable automatic request retries on connection failure.	`true`
`retry.statuses`	HTTP status codes that trigger a retry.	`429,502,503`
`redelivery.maximumRetries`	Maximum number of redelivery attempts.	`3`
`redelivery.delay`	Initial delay between redelivery attempts, in milliseconds.	`200`
`redelivery.backOffMultiplier`	Backoff multiplier for redelivery attempts.	`2`

gc-dataverse-party-inbound-connector

Set these properties in party-inbound-v0.values.yaml. This connector receives Dataverse webhooks and publishes events to the Sync Hub ASB producer.

Property	Description	Default
`asb.producer.apiUri`	Callback URI of the Sync Hub ASB producer.	`http://asb-producer-v0.synchub-producer.svc.cluster.local`
`asb.event.topic`	ASB topic for party update events.	`party-updates`
`asb.event.type`	ASB event type for party update events.	`com.backbase.party.event.spec.v1.PartyUpdateEvent`
`asb.event.source`	ASB source for party update events.	`com.backbase.party`
`asb.event.version`	ASB schema version for party update events.	`1.0.0`
`connectionsPerRoute`	Maximum HTTP connections per route.	`200`
`retryFlag`	Enable automatic request retries on connection failure.	`true`
`retry.statuses`	HTTP status codes that trigger a retry.	`429,500,502,503,504`
`redelivery.maximumRetries`	Maximum number of redelivery attempts.	`3`
`redelivery.delay`	Initial delay between redelivery attempts, in milliseconds.	`200`
`redelivery.backOffMultiplier`	Backoff multiplier for redelivery attempts.	`2`

Supported operations

The Dataverse connector exposes the party operations of the Grand Central Unified API. For the operation-to-endpoint table, see Overview. For the full contract, see the unified API specifications.

Method	Endpoint	Purpose
GET	`/parties/{partyId}`	Get party details.
PUT	`/parties/{partyId}`	Update party details.

Events

The party inbound connector publishes the following event to the Sync Hub ASB producer.

Event	Type property	Source property	Version property	Topic property
Party update	`asb.event.type`	`asb.event.source`	`asb.event.version`	`asb.event.topic`

The party inbound connector consumes notifications from the following source.

Source	Configuration
Dataverse contact create, update, and delete webhooks	Registered callback URL in the Dataverse webhook configuration

The party connector is synchronous and doesn’t publish or consume events.

Error mapping

The connector maps Dataverse error codes to Grand Central status codes using the shared transform-dataverse-error-details.json template. For the full list, see Error codes.

Dependencies

Microsoft Dataverse Contact Entity API (outbound), reachable at dataverse.serviceUri.
Dataverse contact webhooks (inbound), delivered to the registered callback URL.
Sync Hub ASB producer, which receives the published party update events.
dataverse-connector-sdk (shared HTTP configuration and Dataverse error code mapping).

Overview

Grand Central connectors

Release notes

Configuration properties

gc-dataverse-party-connector

gc-dataverse-party-inbound-connector

Supported operations

Events

Error mapping

Dependencies

​Configuration properties

​gc-dataverse-party-connector

​gc-dataverse-party-inbound-connector

​Supported operations

​Events

​Error mapping

​Dependencies

Configuration properties

gc-dataverse-party-connector

gc-dataverse-party-inbound-connector

Supported operations

Events

Error mapping

Dependencies