Table of Contents

Search

  1. Preface
  2. Introduction to Services Integration Framework
  3. Setting Up the SIF SDK
  4. Request and Response Objects
  5. Transactions and Exception Handling
  6. ORS-Specific SIF API
  7. Asynchronous SIF Requests
  8. ORS-Specific JMS Event Messages
  9. Using Security Access Manager
  10. Using Dynamic Data Masking
  11. SIF API Reference
  12. Troubleshooting
  13. Appendix A: Identifiers
  14. Appendix B: Frequently Asked Questions

Services Integration Framework Guide

Services Integration Framework Guide

ValidateTasks

ValidateTasks

The
ValidateTasks
API checks each merge task specified in the request to verify there is a match table record. The
ValidateTasks
API can also validate external workflow engine merge tasks in addition to Hub merge tasks.

TaskData

The
TaskData
object contains information about a task.
The following table lists the TaskData fields that you can configure:
Field
Description
TaskRecord
A link to a data record associated with a task.
Comment
An optional task comment.
TaskType
The task type.
SubjectAreaUID
The UID of the task subject area.
Title
The task title.
TaskID
The ROWID of the task. Cannot be set by user.
DueDate
The date when the task is due.
Priority
The priority of the task.
1
: High priority.
0
: Normal priority. The default is
0
.
-1
: Low priority.
StatusEnum
The workflow status. The default is
TaskStatusEnum.OPEN
.
OwnerUID
The user or role ID to whom the task is assigned.
InteractionID
The Interaction ID.
WorkflowProcessID
The ID of the workflow process that contains the task. Cannot be set by user.
CreateDate
The date when the task was created. Cannot be set by user.
Creator
The name of the user who created the task. Cannot be set by user.
LastUpdateDate
The date when the task was updated. Cannot be set by user.
LastUpdatedBy
The name of the user who updated the task. Cannot be set by user.
PreviousOwner
The name of the user or role to whom the task was previously assigned. The value is Null if the task is new or has not been assigned. Cannot be set by user.

TaskRecord

The
TaskRecord
object contains information about a record.
The following table describes the TaskRecord fields:
Field
Description
SiperianObjectUID
An identifier for an object in Informatica MDM Hub.
RecordKey
An identifier for a record in Informatica MDM Hub.
MatchRuleUID
An identifier for a match rule in Informatica MDM Hub. Only merge tasks require a MatchRuleUID.

Required Request Parameters

The following table describes the required
ValidateTasks
request parameters:
Parameter
Description
TaskData
Specifies the task to validate.

Optional Request Parameters

The
ValidateTasks
API does not have any optional request parameters.

Response Fields

The
ValidateTasks
response returns the TaskValidationResult which contains the following information for each task specified in the request:
Parameter
Description
TaskID
This parameter identifies the task.
isValid
If
true
, the task is valid.
If
false
, the task is not valid.
errorCode
Contains an error code, if any errors are returned.
errorMessage
Contains an error message, if any errors are returned.

Use Cases

The following scenario is a common use case for using the
ValidateTasks
request:
  • Validate a merge task to ensure there is a match table record.

Usage Example

The code in the following example validates a task:
ValidateTasksRequest request = new ValidateTasksRequest(); TaskMetaData task = new TaskMetaData(); task.setTaskId("1234"); task.setTitle("Research and resolve item"); task.setDueDate(new Date()); task.setSubjectAreaUid("SUBJECT_AREA.test|Person"); task.setTaskType("Merge"); ArrayList tasks = new ArrayList(); tasks.add(task); request.setTasks(tasks); ValidateTasksResponse response = (ValidateTasksResponse) sipClient.process(request);

0 COMMENTS

We’d like to hear from you!