dataService Business Rule Component

A Data Service business rule component allows you to retrieve rows of data from a database, spreadsheet, file, or URL that is external to Loftware Enterprise SP. A Data Service can initiate row events to be processed by other business rule components. A Data Service business rule component is similar to a Database data source, a File data source, or an HTTP data source.

Before You Begin: In Data Services , an administrator must create the data service with which you intend to associate the Data Service business rule component. You can use any type of data service. For more information, see Managing Data Services.

The following is the syntax for a Data Service business rule component.

Important! Content in a business rule is case sensitive. This includes business rule component names, attributes, and values.

Note: For each business rule component, most elements and attributes are optional, but you should specify enough to achieve the functionality that you intend. In most cases, you can omit attributes that are not relevant to your task and default values will be used. You must specify a name and a namespace. Except where otherwise indicated, attributes accept string values.

About the syntax documentation

<dataService name="This_component" namespace="Parent_of_component"
failOnNoRows="true|false"
mergeRowToJobData="true|false"
sticky="true|false" configuratorType="Block_type_ID" alias="Data_reference">

<!-- Triggers -->

<!-- Required. Specify which event will cause this business rule component to run. For more information, see Triggers. -->

<triggers>

<trigger eventTrigger="ENQUEUE|PRINTJOBDETAIL|LABEL|Custom_Event" priority="integer" propagation="NONE|BEFORE|AFTER"/>

</triggers>

 

<!-- Execution condition -->

<!-- You can specify a condition that must be true for this business rule component to run. For more information, see Conditions. -->

<executionCondition>

<!-- Logical expression resulting in a condition of true or false. You can perform a logical operation, a comparison, or a data map entry state operation. You can nest operations to create a more complex expression. For more information, see Logical Operations and Comparisons. -->

</executionCondition>

 

<!-- Default data -->

<!-- You can specify default data to be added to the data map. For more information, see Default Data. -->

<defaultData>

<!-- Default data entries are stored as data map entries that include a name (key) and a value. When defining an entry, name and value are required. -->

<entry name="Name_of_data_map_entry"
dataType="STRING|INTEGER|BOOLEAN|NUMBER|BINARY|DATE"
mergePolicy="MERGE_ALL|MERGE_NONE|MERGE_FROM_CHILD|MERGE_TO_PARENT"
action="OVERRIDE|NOT_EXISTS|DELETE|APPEND|PREPEND">

<value>Value_of_data_map_entry</value>

</entry>

</defaultData>

 

<!-- Parameters -->

<!-- You can create parameters, which are evaluated when the business rule is run. For more information, see Parameters. -->

<parameters>

<!-- Parameters are stored as data map entries that include a name (key) and a value. When defining a parameter, parameterKey is required. -->

<!-- To cause any data map entries within the parameter value to be resolved to their associated values at run time, set resolveValue to true. -->

<parameter parameterKey="Name_of_parameter"
dataType="STRING|INTEGER|BOOLEAN|NUMBER|BINARY|DATE" resolveValue="true|false">

<parameterValue>Initial_value_of_parameter</parameterValue>

</parameter>

</parameters>

 

<!-- Common custom events -->

<!-- You can define pre-processing events, post-processing events, and error processing events that you can use as triggers. By using these events as triggers for other business rule components, you can cause a state to occur before or after this business rule component is run, or you can respond to an error. For more information, see Events. -->

<preProcessingEvents>

<preProcessEvent eventName="Custom_Event" includeSiblings="true|false" />

</preProcessingEvents>

 

<postProcessingEvents>

<postProcessEvent eventName="Custom_Event" includeSiblings="true|false" />

</postProcessingEvents>

 

<errorProcessingEvents>

<errorProcessEvent eventName="Custom_Event" includeSiblings="true|false" />

</errorProcessingEvents>

 

<!-- Child business rule components -->

<!-- You can create child business rule components to be run whenever the trigger event for this business rule component occurs. -->

<children>

<!-- The child business rule components have the potential to run once per triggering of the business rule component. However, a child business rule component will not run unless its own trigger event occurs. -->

<!-- You can use a perRowEvent as the trigger for a child business rule component to cause the child to run once for each row of the database that is processed.-->

</children>

 

<!-- Data Service functionality -->

<!-- Specify a path to an existing data service in Loftware Enterprise SP. -->

<dataServiceUrl>Path</dataServiceUrl>

 

<!-- If you specify a stopRowProcessingCondition, no further rows are processed when the condition is evaluated as true. -->

<stopRowProcessingCondition>

<!-- Logical expression resulting in a condition of true or false. You can perform a logical operation, a comparison, or a data map entry state operation. You can nest operations to create a more complex expression. For more information, see Logical Operations and Comparisons. -->

</stopRowProcessingCondition>

 

<!-- If you specify a skipCurrentRowCondition, the current row is not processed when the condition is evaluated as true. Processing continues with the next row. -->

<skipCurrentRowCondition>

<!-- Logical expression resulting in a condition of true or false. You can perform a logical operation, a comparison, or a data map entry state operation. You can nest operations to create a more complex expression. For more information, see Logical Operations and Comparisons. -->

</skipCurrentRowCondition>

 

<perRowEvents>

<!-- You can create a custom event to occur once for each row of data returned by the database query specified in the data service. -->

<rowEvent eventName="Event_if_iterating_through_a row" includeSiblings="false|true"/>

</perRowEvents>

</dataService>

Syntax Tips

Additional information is available about the following items.

alias

configuratorType

failOnNoRows

mergeRowToJobData

name

namespace

sticky

Tip: For assistance with a business rule that you have created or to have Loftware create business rules for you, contact Loftware's Professional Services Group.