Developer Guide > Data Integration Hub Transformations > DX_Start_Publication Transformation
  

DX_Start_Publication Transformation

The DX_Start_Publication transformation instructs the Data Integration Hub PowerCenter Integration Service to trigger the publication workflow for the specified publication.
You use the transformation to start a publication from PowerCenter. For example, if you run a publication pre-process workflow that prepares the data before the publication process can start, add the DX_Start_Publication transformation at the end of the workflow. PowerCenter sends a request to the Data Integration Hub server, and the Data Integration Hub server triggers the publication workflow that publishes the data to the publication repository.
Note: Do not call the DX_Start_Publication transformation more than once in a workflow. If you do, Data Integration Hub starts the publication multiple times.
If you use a PowerCenter parameter file, you can pass the contents of the file to the DXParameterFileContents port and use the parameters in the publication workflow.

Input/Output Ports

Configure input/output ports for the DX_Start_Publication transformation on the Ports tab.
Note: You can add ports with specific parameters to pass to the workflow. The parameters type must be string. You cannot add Passthrough input ports to the transformation.
The following table describes the DX_Start_Publication input/output ports:
Port
Type
Description
DXPublicationName
string
Optional. Name of the publication to start. The name must match the name of the publication in the Operation Console.
Note: If you do not define a DXPublicationName port you must define a DXEventId port.
DXEventId
string
Identifier of the event that is associated with the publication pre-process and with the publication. You can get the value from the $$DXEventId parameter.
Recommended when a publication pre-process starts a single publication. Ensures that Data Integration Hub uses the same event for both the publication pre-process workflow and the publication workflow and changes the event status accordingly.
When a publication pre-process starts multiple publications, do not use the event ID in the DX_Start_Publication transformation. In this case, you can use the Event Details PowerCenter transformation to change the event status.
Note: If you do not define a DXEventId port you must define a DXPublicationName port.
DXParameterFileContents
string
Parameter names and values from a PowerCenter parameter file. You cannot use a file path in the value of the port.
DXErrorMessage
string
Error message that the transformation generates.
DXErrorCode
string
Error code that the transformation generates. If the transformation fails, the value of the DXErrorCode port is greater than zero.

Data Integration Hub Properties

Configure properties for the DX_Start_Publication transformation on the DX Properties tab.
The following table describes the Data Integration Hub properties of the DX_Start_Publication transformation:
Property
Description
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.