Design > Designing Processes > System Service Actions
  

System Service Actions

When you configure a Service step in a process and select system service as the service type, you can choose from a list of supported actions.

Delete Object

This Delete Object action lets you delete a record. Depending upon your application, what is being deleted can be called an object or an object instance.
As the figure shows, you will need to enter information for three fields.

Execute Data Marketplace API

You can use Data Marketplace APIs to access data assets and data collections through GET, POST, and PUT methods, and perform business orchestration. You can execute Data Marketplace APIs for processes that run on the Cloud Server.
You can configure a Data Marketplace API in the Service step and invoke it using API Gateway.
To use Data Marketplace APIs in a process, you must configure the Allowed Groups or the Allowed Users fields. Users must have the Data Marketplace administrator role to invoke a process that integrates with a Data Marketplace API.
The following image shows the Execute Data Marketplace API properties:
The image shows the input fields that you can configure for a Data Marketplace API.

Input Fields

Configure the following input fields in the Service step for a Data Marketplace API:
HTTP Method
Required. The HTTP method to invoke the Data Marketplace API such as GET, PUT, or POST.
Relative Path
Required. The relative path of the Data Marketplace API.
For example, to perform operations on the data assets in Data Marketplace, enter the following as the relative path:
dataAssets
To perform operations on the data elements in Data Marketplace, enter the following as the relative path:
dataAssets/{{id}}/dataElements
Payload
The JSON payload to be sent to the Data Marketplace API using the PUT or POST method.
For example, to send employee data to the Data Marketplace API, enter the data in the JSON format as shown in the following sample:
'{
"Employee": [
{
"firstName ": "Cindy",
"lastName": "Louis",
"department": "IT"
"status": "Employed"
}
]
}'
Query Parameter
The process object that returns the data associated with the Data Marketplace API query parameters.
You can use the API query parameters such as sort or status to sort or filter the data using the GET method. Based on the query parameter, the API returns the associated data in the XML format.
You can configure the Query Parameter field by using a formula or field.
For example, to use a formula to get the maximum number of assets with the enabled status, use the status query parameter as shown in the following sample:
<DataMarketplaceQueryParameters>
<queryParams>
<name>status</name>
<value>ENABLED</value>
</queryParams>
<queryParams>
<name>limit</name>
<value>10</value>
</queryParams>
</DataMarketplaceQueryParameters>
For information about using another field to configure the Query Parameter field, see Creating fields to execute Data Marketplace API.
Path Variable
The process object that is associated with the Data Marketplace API path variables.
You can configure the Path Variable field by using a formula or field.
For example, to insert data elements into the data asset, provide the ID in the path variable as shown in the following sample:
<DataMarketplacePathVariables>
<pathVariables>
<name>id</name>
<value>eu33-39839j2</value>
</pathVariables>
<pathVariables>
<name>categoryId</name>
<value>ad2c915-60c4</value>
</pathVariables>
</DataMarketplacePathVariables>
For information about using another field to configure the Path Variable field, see Creating fields to execute Data Marketplace API.

Output Field

Configure the following output field in the Assignment step or Decision step for a Data Marketplace API:
Name
Type
Description
Data Marketplace Response
Text
The string variable that stores the output.
For more information about Data Marketplace APIs, see the Data Marketplace help.

Creating fields to execute Data Marketplace API

You can configure the query parameter and path variable by passing the value as a field.
To pass the value of the query parameter and path variable as a field, you must create temporary fields. You must select the custom type as Data Marketplace Query Parameters process object for the query parameter field and Data Marketplace Path Variables process object for the path variable field as shown in the following image:
The image shows the temporary fields that you can configure for a Data Marketplace API.
The temporary fields you created appear in the Assignment step. In the Assignment step, you can configure the values for the query parameter and path variable temporary fields as shown in the following image:
The image shows the name value pairs that you can configure for query parameter and path variable.
Here, queryParams and pathVariables are the input fields configured in the Data Marketplace Query Parameters and Data Marketplace Path Variables process objects with the name-value pair.
In the Service step, you must select the temporary fields that were added for the query parameter or path variable field values as shown in the following image:
The image shows the query parameter and path variable configured with the temporary fields.

JMS Enqueue Service

Use the JMS Enqueue Service to send a message to a JMS service, where it will be queued. When the receiving process is ready, the service sends the message to it. The message is sent using the Informatica Secure Agent to communicate with an on-premise service.
The data in the message contains the following components:
Messaging Manager Name
The name of the messaging manager that contains the destination.
Destination Name
The name of the message's destination.
Format
The format to be serialized to the destination.
Message
The message to be sent to the destination.
Unwrap Root Element
Describes how the process object is serialized when it is sent to the destination.
The following image shows the JMS Enqueue Service properties:

Logging for the JMS Enqueue Service

By default, the JMS Enqueue Service logs only errors. To enable additional logging for the entire flow of message processing, perform the following steps:
  1. 1Access the log4j2.xml file from the following directory:
  2. <Secure Agent installation directory>\apps\process-engine\<latest_version>\conf
  3. 2Add the following code:
  4. <Logger name="org.apache.camel.component.file.remote" level="DEBUG" additivity="false"> 
    <AppenderRef ref="catalina"/>
    </Logger>
  5. 3Save the log4j2.xml file.

MDM human tasks

Informatica Intelligent Cloud Services Business 360 Console uses the Application Integration processes as workflows for the user-triggered and system-generated business events. If you do not want to use any predefined approval workflows in Business 360 Console, define a process in Application Integration and use it to configure business events. These processes must contain at least one human task.
A human task indicates that the process requires user interaction as part of the workflow. The MDM human task supports the following user tasks:
You can use the predefined MDM Multi-Step Approval Template to design a process. For more information about the predefined template, see MDM Multi-Step Approval Template.
To configure an MDM human task in a Service step, select MDM > HumanTask > Generic User Task or MDM > HumanTask > Originator User Task as a system service action.
Note: The options other than Generic User Task and Originator User Task under HumanTask are reserved for future use.
The following image shows the MDM human task properties:
The image shows the input and output fields that you can configure for a General User Task.

Input Fields

Configure the following input fields in the Service step for an MDM human task:
Template
Required. The template field that you added to the Input Fields tab of the Start step.
TaskTypes
Required. The taskTypes field that you added to the Input Fields tab of the Start step.
Change List
Required. The input field that you added to the Input Fields tab of the Start step.
TaskName
Required. The unique name of the Service step that you specified on the General tab.
Task Actions
Required. The list of actions that the users can perform with this step. Use a semicolon as a delimiter. For example, Send for Translation;Send Back to Originator;Release. You can also use the action text to provide more information on the next process step. The output that returns from each task action must be handled within the process.

Output Fields

You can use the LastAction and LastApprover fields to define additional process steps, such as Assignment step or Decision step, to access data and services and to perform related orchestration activities. Each process step returns information about the last approver and the last action taken by the approver.
The following fields store the step values that the additional process steps return:
LastAction
The last task action, such as Send for Translation, Send Back to Originator, or Release.
LastApprover
The identifier of the user who took the last action.
For step-by-step instructions about creating a process with a human task, see Defining Cloud Application Integration processes for user-triggered business events.

Run a Shell Command

You can use the Run a Shell Command action in a Service step to automate the call to a shell command as part of your application integration. For example, you might add this action in a subprocess to move files on the agent or to read the file contents of a particular directory by running cp or cat shell commands.
Note: When you use this action in a process, be sure to select a Secure Agent where you want to run the shell command in the Server Configuration > System Services list in Application Integration Console. However, you can access a shell command from a process running on the Cloud Server by calling the shell command in a subprocess that contains this Service step. Running system commands with this step is not recommended.

Enabling the Shell Command Service

Before you can execute a process that includes this action, enable the shell service in the Application Integration Console with the following steps:
  1. 1In Application Integration Console, choose Server Configuration.
  2. 2Choose the agent where you want to run the shell service from the Server Configuration list.
  3. 3On the System Services tab, choose Shell Service.
  4. 4Click Save.

Input and Output Fields

When you include a Service step for Run a Shell Command, you can use the following options:
Name
Type
Description
Input Fields
Command
Text
Required. The command name to be executed, which is specific to the operating system (Windows or Linux).
Character Set
Text
The character set of the command to be run.
Default, if not provided: UTF-8.
Merge Output
Checkbox
When checked, the contents of the output are merged with the error string, if any.
By default, this is enabled.
Input
Text
File name with path to use for the input, if any.
Working Directory
Text
Required. Path of the directory where the command executes
Output Fields
Error String
Text
String of error returned, if any.
Response Code
Text
0 (success) or 1 (failure).
Output String
Text
String of output returned, if any
The following image shows the properties required to run a Shell command:

Run Cloud Task

You can use a Service step to run Data Integration tasks. You can run mapping tasks and synchronization tasks through a Service step.
Perform the following steps to run a Data Integration task through a Service step:
  1. 1Add a Service step to the process.
  2. 2On the Service tab, select the service type as System Service, and then select the action as Run Cloud Task.
  3. 3On the Input Fields tab, configure the required properties:
  4. The following image shows the input fields that you can configure for a Run Cloud Task Service step:
    The image shows the input fields that you can configure for a Run Cloud Task Service step.
After you publish and run the process that contains the Run Cloud Task Service step, you can view the task execution history in Application Integration Console.