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:
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:
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:
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 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:
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:
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:
1Access the log4j2.xml file from the following directory:
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:
•Generic User Task. Defines actions for users included in the workflow.
•Originator User Task. Defines actions for users who trigger a workflow with their actions.
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:
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.
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:
1In Application Integration Console, choose Server Configuration.
2Choose the agent where you want to run the shell service from the Server Configuration list.
3On the System Services tab, choose Shell Service.
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:
1Add a Service step to the process.
2On the Service tab, select the service type as System Service, and then select the action as Run Cloud Task.
3On the Input Fields tab, configure the required properties:
- Task Name: The name of the Data Integration task that you want Process Designer to run. You can select from a list of mapping tasks and synchronization tasks. You can also enter keywords to search for a mapping task or synchronization task.
- Wait for Task to Complete: Defines whether Process Designer waits for the task to complete before Process Designer resumes execution.
- Max Wait: Defines the maximum number of seconds that Process Designer waits for a task to complete. The default value is 300 seconds.
Important: You must enter a Max Wait value that is lesser than 604800 seconds, that is, 7 days or fewer. Process Designer waits for a maximum of 7 days for a task to complete.
- Fail on Cloud Task Errors: Defines whether the process faults when the mapping task or synchronization task fails.
The following 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.