DX_Notification Transformation
The DX_Notification transformation sets the status of an event and optionally notifies the Data Integration Hub server that the processing completed.
When you use the transformation in a publication workflow, you can notify the Data Integration Hub server that the publication process is complete and the published data is ready to consume. The Data Integration Hub server then creates child events for the subscriptions and triggers the subscription batch workflows for subscriptions that consume the data when it is published. Scheduled subscription events remain pending until the scheduled subscribers start to consume the data. The notification that the transformation sends is optional. Therefore, you can use the transformation to change the event status to error without triggering the subscriptions if the publication process ended with errors.
When you use the transformation in a subscription post-processing workflow, you must notify the Data Integration Hub server that the subscription post-process is complete and send the post-processing status to the server. The Data Integration Hub server then creates a child event for the subscription that evoked the post-processing workflow, with the status of the post-process.
Input/Output Ports
Configure input/output ports for the DX_Notification transformation on the Ports tab.
The following table describes the DX_Notification input/output ports:
Port | Type | Description |
|---|
DXEventId | string | Required. Identifier of the event for which you want to set the status. You can get the value from the $$DxeventId parameter. |
DXStatusName | string | Name of the status to set. If the value is null, the transformation sets the value based on the transformation properties. |
DXNotifySubscribers | string | Required. Indicates whether to send a notification to the Data Integration Hub server. Possible values: - - True. The transformation sends a notification to the Data Integration Hub server. The Data Integration Hub server triggers the subscription batch workflow and creates a child event for each subscription.
- - False. The transformation sets the event status without a notification to the Data Integration Hub server.
|
DXErrorMessage | string | Error message generated by the transformation. |
DXErrorCode | string | Error code generated by the transformation. If the transformation fails, the value of the DXErrorCode port is greater than zero. |
Data Integration Hub Properties
Configure properties for the DX_Notification transformation on the DX Properties tab.
The following table describes the Data Integration Hub properties of the DX_Notification transformation:
Property | Description |
|---|
Event Status | Status of the event to create. Default is Complete. |
Notify the hub that the publication is ready for subscribers | Indicates whether to send a notification to the Data Integration Hub server that the workflow run ended successfuly. If selected, the Data Integration Hub server creates a child event for each subscription and triggers a subscription batch workflow for subscriptions that you define to consume the data when it is published. Selected by default. |
Generate an error in case a failure occurs in this transformation | Indicates whether to set the status of the event to error when the transformation generates an error. Selected by default. |