Taskflows > Taskflows > Running a taskflow using taskflow inputs
  

Running a taskflow using taskflow inputs

After you publish a taskflow, you can create one or more taskflow inputs and run the taskflow using taskflow inputs to test it. After you run the taskflow, you can view details of the successful and unsuccessful executions of the taskflow instances.
To run a taskflow using taskflow inputs, you must include values for Allowed Users and Allowed Groups in the taskflow designer.

Creating a taskflow input

After you publish a taskflow, you can create a taskflow input and use it to run a taskflow for testing purposes. You can create multiple taskflow inputs and run a taskflow with all the inputs.
You can create a taskflow input in JSON or XML format. Then, validate and save the taskflow input.
When you export, copy, or move a taskflow that contains taskflow inputs, the taskflow inputs are retained.
    1. On the Explore page, navigate to the taskflow for which you want to create a taskflow input.
    2. From the Actions menu, select Run Using.
    The Test Taskflow Input Collection page opens.
    The following image shows the Test Taskflow Input Collection page:
    The image shows the Test Taskflow Input Collection page.
    3. Click New Input.
    4. Enter a name for the taskflow input and click Save.
    The name must not exceed 80 characters.
    The Taskflow Input section is populated with the input fields required for the taskflow.
    Note: For the input fields with custom types, the fault and output parameters are added in the input payload and appear in the Taskflow Input section, by default. You must remove them manually for the taskflow input to be valid.
    The following image shows the Taskflow Input section populated with input fields for an Employee custom type:
    The image shows the Taskflow Input section populated with input fields for an Employee custom type.
    The Custom Type section shows the custom type input fields that the taskflow uses. For more information about custom type fields, see Creating an input field with a custom type.
    5. From the Encoding list, select JSON or XML based on the format that you want to work with and specify the taskflow input.
    Note: If the taskflow contains input fields with space characters in them, select JSON as the encoding type.
    6. Click the Validate icon to validate the syntax of the taskflow input.
    A confirmation message appears stating if the validation was successful or not. If the validation fails, correct the syntax of the taskflow input and validate again.
    7. Click Save to save the taskflow input.
    You can click Save As to save the taskflow input with a different name. You can also click the Reset icon to reset a taskflow input to the last saved taskflow input.
After you create taskflow inputs, you can run the taskflow with the required inputs.

Running a taskflow with taskflow inputs

After you publish a taskflow and create taskflow inputs, you can run the taskflow with taskflow inputs to test it. After you run the taskflow, you can view details of the taskflow execution.
    1. On the Explore page, navigate to the taskflow that you want to run with one or more taskflow inputs.
    2. To run a taskflow with a specific taskflow input or all the taskflow inputs, from the Actions menu, select Run Using.
    The Test Taskflow Input Collection page opens.
    The following image shows the Test Taskflow Input Collection page:
    The image shows the Test Taskflow Input Collection page.
    Note: The Run Using option is disabled if the taskflow contains unsaved or unpublished changes. To run the taskflow, you must save and publish the taskflow.
    3. Perform one of the following steps:
    Data Integration runs the taskflow with the specified inputs. After the taskflow execution is complete, the Taskflow Execution Status page opens displaying details of the successful and unsuccessful taskflow executions. For long running taskflows, it might take some time for the Taskflow Execution Status page to appear.
    The following image shows the Taskflow Execution Status page:
    The image shows the Taskflow Execution Status page.
    4. Click the links under the Successful executions or Unsuccessful executions sections to view details of the taskflow execution.
    The taskflow run ID is appended to the link. You can use the run ID to verify the taskflow execution details on the My Jobs page.

Deleting a taskflow input

You can delete a taskflow input if you do not need it.
    1. On the Explore page, navigate to the taskflow for which you want to delete a taskflow input.
    2. From the Actions menu, select Run Using.
    The Test Taskflow Input Collection page opens.
    The following image shows the Test Taskflow Input Collection page:
    The image shows the Test Taskflow Input Collection page.
    3. Select the taskflow input that you want to delete from the Select the input to run the taskflow with field and click the Delete icon.
    A message appears prompting you to confirm the taskflow input deletion.
    4. Click Delete to proceed with the deletion or click Cancel to cancel the deletion.