Create publications

Task in alpha phase

This Data Factory task is in phase. You can contact the Product-Live team at contact@product-live.com if you want more details and get an early access.

This task enables to create publication from a list of items toward a partner.

Task name:

Examples

Create publications from exported items

{
    "name": "exchange-create-publications",
    "taskReferenceName": "create_publications",
    "description": "Create publications",
    "type": "SUB_WORKFLOW",
    "optional": false,
    "inputParameters": {
        "items": "${table_export_items.output.file}",
        "screenKey": "SUPPLIERS",
        "partnerAccountKey": "${workflow.variable.partnerKey}"
    }
}

Definition

Property	Type	Required	Description
			The name (or type) of the task
			The unique name of the task in your job. It is used to reference this task in the workflow.
			The functional description of this task in your job.
			The type of the task. It must be SUB_WORKFLOW.
	:		true: the job continues if there is an error on this task. false: the job fails.
			Input parameters of the task. See below

Inputs Parameters

Property	Type	Required	Description
			A valid items input. It can reference the output of a previous task, example: ${previous_taskReferenceName.output.file} , or a user input, example: ${workflow.input.file}. See export-items for more information.
			The key of the screen on which to create the publications.
			The account key to which to create the publications.

Input items

See details on the input items in the Data Factory task table-export-items output - file.

Outputs

Property	Type	Description
		A XML file as described below.
		The report.
	:	YES: All publications has been created. NO: At least one publication has not been properly created.
		An XML file containing a set of logs related to the execution of the task. This output is not available if the input skipReportGeneration=true.

Output publications example

<Publications>
   <Publication id="22154" fromItemId="6590598" screenId="3970" partitionId="2394" tableId="1476"/>
   <Publication id="22155" fromItemId="6590599" screenId="3970" partitionId="2394" tableId="1476"/>
</Publications>

XPath	Description	Occurs
Publications	The root element.	1
Publications/Publication	The publications created	1..*
./@id	The publication id	1..1
./@fromItemId	The item id on which the publication has been created	1..1
./@screenId	The screen id on which the publication has been created	1..1
./@partitionId	The item partition id on which the publication has been created	1..1
./@tableId	The table id on which the publication has been created	1..1

Output report example

Successfull creation

<Report task="exchange-create-publications" date="2026-03-30T12:52:13.496Z">
   <Log type="info" code="PUBLICATION_CREATED">
      <Metadata-Collection name="publicationDefinition">
         <Metadata name="id">22221</Metadata>
         <Metadata name="fromItemId">6591597</Metadata>
         <Metadata name="screenId">3970</Metadata>
         <Metadata name="partitionId">2394</Metadata>
         <Metadata name="tableId">1476</Metadata>
      </Metadata-Collection>
      <Metadata-Collection name="identifiers">
         <Metadata name="EAN">2000099919335</Metadata>
      </Metadata-Collection>
      <Message>The publication has been created successfully</Message>
   </Log>
</Report>

Erroneous creation

<Report task="exchange-create-publications" date="2026-03-26T09:45:54.999Z">
   <Log type="error" code="ERROR_WHEN_PUBLICATION_CREATION">
      <Metadata-Collection name="errorData">
         <Metadata name="errorMessage">item not found</Metadata>
         <Metadata name="position">1</Metadata>
         <Metadata name="status">404</Metadata>
      </Metadata-Collection>
      <Metadata-Collection name="identifiers">
         <Metadata name="EAN">2000099919335</Metadata>
      </Metadata-Collection>
      <Message>An error happened during publication creation at position 1</Message>
   </Log>
</Report>

XPath	Description	Occurs
Report	The root element.	1
Report/Log	A log for each publication	1..*
./Metadata-Collection[@name="identifiers"]	The item identification data	1..1
./Metadata-Collection[@name="publicationDefinition"]	If success, all the information about created publication.	1..1
./Metadata[@name="id"]	The created publication id	1..1
./Metadata[@name="fromItemId"]	The item id from which publication has been created	1..1
./Metadata[@name="screenId"]	The screen id from which publication has been created	1..1
./Metadata[@name="partitionId"]	The partition id from which publication has been created	1..1
./Metadata[@name="tableId"]	The table id from which publication has been created	1..1
./Metadata-Collection[@name='errorData']	If failed, all the information about the error during publication creation.	1..1
./Metadata[@name="errorMessage"]	The error description	0..1
./Metadata[@name="warningMessage"]	The warning description	0..1
./Metadata[@name="position"]	The item position in the items.xml input file	0..1
./Metadata[@name="position"]	The item position in the items.xml input file	0..1
./Metadata[@name="status"]	The http response error code	1..1
./Message	The publication status message description	1..1