EBX® includes a number of built-in user services. Built-in user services can be used:
This reference page describes the built-in user services and their parameters.
By default, workflows automatically consider this service as complete. That is, the 'Accept' button is always available.
This is the default service used if no service is specified.
| Parameter | Label | Description |
|---|---|---|
branch | Dataspace | The identifier of the specified dataspace - A dataspace is required for this service. |
disableAutoComplete | Disable Accept at start | By default, the interaction associated with this service is directly considered as complete. Therefore, the Accept button is automatically displayed at the opening of the work item. This parameter is useful to disable this behavior. If the value is 'true', the developer will be in charge of completing the interaction by using SessionInteraction in a user service or a trigger, for example. The default value is 'false'. Perspectives do not use this parameter. |
firstCallDisplay | First call display mode | Defines the display mode that must be used when displaying a filtered table or a record upon first call. Default (value = 'auto'): the display is automatically set according to the selection. View (value = 'view'): forces the display of the tabular view or of the hierarchical view. Record (value = 'record'): if the predicate has at least one record, forces the display of the record form. |
instance | Dataset | The value must be the reference of a dataset that exists in the selected dataspace. |
scope | Scope | Defines the scope of the user navigation for this service, namely, the entities that the user is able to select during their session. If left blank, the default value will be used. For perspectives, the default value is always 'node'. For workflows, the default value depends on the selected entities or service. |
trackingInfo | Tracking information | Tracking information is logged into 'history' logs. It may also be used for any other purpose like access control or additional export information. |
version | Snapshot | The identifier of the specified snapshot - A dataspace is required for this service. |
viewPublication | View | The publication name of the view to display. The view must be configured for the selected table. |
xpath | Dataset node (XPath) | The value must be a valid absolute location path in the selected dataset. The notation must conform to a simplified XPath, in its abbreviated syntax. |
For a workflow, the creation service is considered complete when the first successful submit is performed (record has been created). If this service is called whereas it is already complete, the created record is displayed in update or read-only mode (depending on the user rights).
Service name parameter: service=@creation
| Parameter | Label | Description |
|---|---|---|
branch | Dataspace | The identifier of the specified dataspace - This field is required for this service. |
instance | Dataset | The value must be the reference of a dataset that exists in the selected dataspace - This field is required for this service. |
scope | Scope | Defines the scope of the user navigation for this service, namely, the entities that the user is able to select during their session. If left blank, the default value will be used. For perspectives, the default value is always 'node'. For workflows, the default value depends on the selected entities or service. |
trackingInfo | Tracking information | Tracking information is logged into 'history' logs. It may also be used for any other purpose like access control or additional export information. |
xpath | Dataset table (XPath) | The value must be a valid absolute location path of a table in the selected dataset. The notation must conform to a simplified XPath, in its abbreviated syntax - This field is required for this service. |
| Parameter | Label | Description |
|---|---|---|
created | Created record | Contains the XPath of the created record. |
For a workflow, the duplicate service is considered complete when the first successful submit is performed (record has been created). If this service is called whereas it is already complete, the created record is displayed in update or read-only mode (depending on the user rights).
Service name parameter: service=@duplicate
| Parameter | Label | Description |
|---|---|---|
branch | Dataspace | The identifier of the specified dataspace - This field is required for this service. |
instance | Dataset | The value must be the reference of a dataset that exists in the selected dataspace - This field is required for this service. |
scope | Scope | Defines the scope of the user navigation for this service, namely, the entities that the user is able to select during their session. If left blank, the default value will be used. For perspectives, the default value is always 'node'. For workflows, the default value depends on the selected entities or service. |
trackingInfo | Tracking information | Tracking information is logged into 'history' logs. It may also be used for any other purpose like access control or additional export information. |
xpath | Record to duplicate (XPath) | The value must be a valid absolute location path of an existing record. The notation must conform to a simplified XPath, in its abbreviated syntax - This field is required for this service. |
| Parameter | Label | Description |
|---|---|---|
created | Created record | Contains the XPath of the created record. |
The exportToXML service is considered complete when export is done and file downloaded.
Service name parameter: service=@exportToXML
| Parameter | Label | Description |
|---|---|---|
branch | Dataspace | The identifier of the specified dataspace - A dataspace is required for this service. |
instance | Dataset | The value must be the reference of a dataset that exists in the selected dataspace - This field is required for this service. |
scope | Scope | Defines the scope of the user navigation for this service, namely, the entities that the user is able to select during their session. If left blank, the default value will be used. For perspectives, the default value is always 'node'. For workflows, the default value depends on the selected entities or service. |
trackingInfo | Tracking information | Tracking information is logged into 'history' logs. It may also be used for any other purpose like access control or additional export information. |
version | Snapshot | The identifier of the specified snapshot - A dataspace is required for this service. |
xpath | Dataset table to export (XPath) | The value must be a valid absolute location path of a table in the selected dataset. The notation must conform to a simplified XPath, in its abbreviated syntax - This field is required for this service. |
Workflows consider the exportToCSV service as complete when export is done and file downloaded.
Service name parameter: service=@exportToCSV
| Parameter | Label | Description |
|---|---|---|
branch | Dataspace | The identifier of the specified dataspace - A dataspace is required for this service. |
instance | Dataset | The value must be the reference of a dataset that exists in the selected dataspace - This field is required for this service. |
scope | Scope | Defines the scope of the user navigation for this service, namely, the entities that the user is able to select during their session. If left blank, the default value will be used. For perspectives, the default value is always 'node'. For workflows, the default value depends on the selected entities or service. |
trackingInfo | Tracking information | Tracking information is logged into 'history' logs. It may also be used for any other purpose like access control or additional export information. |
version | Snapshot | The identifier of the specified snapshot - A dataspace is required for this service. |
xpath | Dataset table to export (XPath) | The value must be a valid absolute location path of a table in the selected dataset. The notation must conform to a simplified XPath, in its abbreviated syntax - This field is required for this service. |
Workflows consider the importFromXML service as complete when import is performed.
Service name parameter: service=@importFromXML
| Parameter | Label | Description |
|---|---|---|
branch | Dataspace | The identifier of the specified dataspace - A dataspace is required for this service. |
instance | Dataset | The value must be the reference of a dataset that exists in the selected dataspace - This field is required for this service. |
scope | Scope | Defines the scope of the user navigation for this service, namely, the entities that the user is able to select during their session. If left blank, the default value will be used. For perspectives, the default value is always 'node'. For workflows, the default value depends on the selected entities or service. |
trackingInfo | Tracking information | Tracking information is logged into 'history' logs. It may also be used for any other purpose like access control or additional export information. |
xpath | Dataset table to import (XPath) | The value must be a valid absolute location path of a table in the selected dataset. The notation must conform to a simplified XPath, in its abbreviated syntax - This field is required for this service. |
Workflows consider the importFromCSV service as complete when import is performed.
Service name parameter: service=@importFromCSV
| Parameter | Label | Description |
|---|---|---|
branch | Dataspace | The identifier of the specified dataspace - A dataspace is required for this service. |
instance | Dataset | The value must be the reference of a dataset that exists in the selected dataspace - This field is required for this service. |
scope | Scope | Defines the scope of the user navigation for this service, namely, the entities that the user is able to select during their session. If left blank, the default value will be used. For perspectives, the default value is always 'node'. For workflows, the default value depends on the selected entities or service. |
trackingInfo | Tracking information | Tracking information is logged into 'history' logs. It may also be used for any other purpose like access control or additional export information. |
xpath | Dataset table to import (XPath) | The value must be a valid absolute location path of a table in the selected dataset. The notation must conform to a simplified XPath, in its abbreviated syntax - This field is required for this service. |
A workflow automatically considers that the dataspace selection service is complete.
Service name parameter: service=@selectDataSpace
| Parameter | Label | Description |
|---|---|---|
branch | Dataspace | The identifier of the specified dataspace - A dataspace is required for this service. |
scope | Scope | Defines the scope of the user navigation for this service, namely, the entities that the user is able to select during their session. If left blank, the default value will be used. For perspectives, the default value is always 'node'. For workflows, the default value depends on the selected entities or service. |
trackingInfo | Tracking information | Tracking information is logged into 'history' logs. It may also be used for any other purpose like access control or additional export information. |
version | Snapshot | The identifier of the specified snapshot - A dataspace is required for this service. |
Workflows automatically consider the validation service as complete.
Service name parameter: service=@validation
| Parameter | Label | Description |
|---|---|---|
branch | Dataspace | The identifier of the specified dataspace - A dataspace or snapshot is required for this service. |
instance | Dataset | The value must be the reference of a dataset that exists in the selected dataspace. |
scope | Scope | Defines the scope of the user navigation for this service, namely, the entities that the user is able to select during their session. If left blank, the default value will be used. For perspectives, the default value is always 'node'. For workflows, the default value depends on the selected entities or service. |
trackingInfo | Tracking information | Tracking information is logged into 'history' logs. It may also be used for any other purpose like access control or additional export information. |
version | Snapshot | The identifier of the specified snapshot - A dataspace or snapshot is required for this service. |
| Parameter | Label | Description |
|---|---|---|
hasError | Found errors | Contains 'true' if validation has produced errors. |
hasFatal | Found fatal errors | Contains 'true' if validation has produced fatal errors. |
hasInfo | Found informations | Contains 'true' if validation has produced informations. |
hasWarning | Found warnings | Contains 'true' if validation has produced warnings. |
Workflows consider the merge service as complete when merger is performed and dataspace is closed.
Service name parameter: service=@merge
| Parameter | Label | Description |
|---|---|---|
branch | Dataspace | The identifier of the specified dataspace - A dataspace is required for this service. |
scope | Scope | Defines the scope of the user navigation for this service, namely, the entities that the user is able to select during their session. If left blank, the default value will be used. For perspectives, the default value is always 'node'. For workflows, the default value depends on the selected entities or service. |
trackingInfo | Tracking information | Tracking information is logged into 'history' logs. It may also be used for any other purpose like access control or additional export information. |
| Parameter | Label | Description |
|---|---|---|
mergeResult | Merge success | Contains 'true' if merge succeeded, otherwise 'false'. |
mergeState | Merge state | Contains the return code of the merge. It is strongly recommended to parse this value by using the InteractionMergeState UIHttpManagerComponentReturnCode. |
The merge.view service is automatically considered complete.
Service name parameter: service=@merge.view
| Parameter | Label | Description |
|---|---|---|
branch | Dataspace | The identifier of the specified dataspace - A dataspace is required for this service. |
scope | Scope | Defines the scope of the user navigation for this service, namely, the entities that the user is able to select during their session. If left blank, the default value will be used. For perspectives, the default value is always 'node'. For workflows, the default value depends on the selected entities or service. |
trackingInfo | Tracking information | Tracking information is logged into 'history' logs. It may also be used for any other purpose like access control or additional export information. |
Workflows automatically consider the compare service as complete.
Service name parameter: service=@compare
| Parameter | Label | Description |
|---|---|---|
branch | Dataspace | The identifier of the specified dataspace - A dataspace or snapshot and a dataspace or snapshot to compare to are required for this service. |
compare.branch | Dataspace to compare | The identifier of the dataspace to compare - A dataspace or snapshot and a dataspace or snapshot to compare to are required for this service. |
compare.filter | Comparison filter | To ignore inheritance and function fields in the comparison (disable resolved mode), the filter "persistedValuesOnly" must be specified. By default, when no filter is defined, the comparison uses resolved mode. |
compare.instance | Dataset to compare | The value must be the reference of a dataset that exists in the selected dataspace to compare. |
compare.version | Snapshot to compare | The identifier of the snapshot to compare - A dataspace or snapshot and a dataspace or snapshot to compare to are required for this service. |
compare.xpath | Table or record to compare (XPath) | The value must be a valid absolute location path of a table or a record in the selected dataset to compare. The notation must conform to a simplified XPath, in its abbreviated syntax. |
instance | Dataset | The value must be the reference of a dataset that exists in the selected dataspace. |
scope | Scope | Defines the scope of the user navigation for this service, namely, the entities that the user is able to select during their session. If left blank, the default value will be used. For perspectives, the default value is always 'node'. For workflows, the default value depends on the selected entities or service. |
trackingInfo | Tracking information | Tracking information is logged into 'history' logs. It may also be used for any other purpose like access control or additional export information. |
version | Snapshot | The identifier of the specified snapshot - A dataspace or snapshot and a dataspace or snapshot to compare to are required for this service. |
xpath | Table or record (XPath) | The value must be a valid absolute location path of a table or a record in the selected dataset. The notation must conform to a simplified XPath, in its abbreviated syntax. |
This service provides access to the data workflows user interfaces.
Service name parameter: service=@workflow
This service is for perspectives only.
| Parameter | Label | Description |
|---|---|---|
scope | Scope | Defines the scope of the user navigation for this service. |
viewPublication | View publication | Defines the publication name of the view to apply for this service. |
workflowView | Workflow view | Specifies the workflow view type. Value can be one of the following: "inbox", "launcher", "monitoringPublications", "monitoringWorkflows", "monitoringWorkItems" or "completedWorkflows". |
xpath | Filter (XPath) | An optional filter. The syntax should conform to an XPath predicate surrounded by "[" and "]". |