Export Rules

Export rules of the rules engine.

Json

Example

{
  "name": "rules-engine-export-rules",
  "taskReferenceName": "export target table rules",
  "description": "The business description of the task",
  "type": "SUB_WORKFLOW",
  "optional": false,
  "inputParameters": {
    "tableKey": "PRODUCT"
  }
}

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
			The table key of the table to export the rules from.
			The account key of the partner owning the shared table. Only needed when you export the rules of a table a partner shared with you - omit it and the task exports the rules of the table in the account the job runs under.

This task produces no execution report, so it takes none of the report-related inputs.

Outputs

Property	Type	Description
		An XML document holding the table's rules. It uses the same Rules-Engine grammar as the rules-engine-import-rules request document, so read that page to interpret it - but see the warning below before re-importing one.

What the task exports, and when it fails

The rules exported are the ones the account running the job has defined on that table. For a table a partner shared with you, accountKey only says where to find the table - it never exports the partner's own rules.

There is no partial success: every error aborts the task and no file is produced. The task fails when

• tableKey is missing;
• no table matches that key in the resolved account - your own, or the one named by accountKey;
• the account running the job has no access to that table (You do not have access to this table);
• the table carries no rules at all - an empty export is not produced;
• accountKey matches no account. Be aware that this last case reports An error occured, unable to retrieve table owner, the same message you get if the account service is unreachable, so it does not distinguish a typo from an outage.

Limits and additional notes

These limits apply to one mapping - the rules of a single target table, for your account.

Element	Limit
Fields with rules	20 000
Rules by field	1 000
Source tables	500
Rules by table	20 000