Ana içeriğe atla

​
Task Flow Features

Task Output Usage

Can use the output of the task that ran before it.

Multiple Execution

Can run the task once or multiple times.

​
Creating Task Flow

1

Go to Task Flows Page

Go to the Task Flows page within API Integration under the Development tab from the navigation bar on the left side of your screen.Task Flows List
2

Create New Task Flow

Create a new Task Flow by clicking the Create button in the top right corner.
3

Name and Save Task Flow

Create the task flow by naming it and clicking the Save and Next button.Task Flow Creation Form

​
Creation Form Fields

Name

Field: NameType: stringRequired: YesUnique name that identifies the task flow

Description

Field: DescriptionType: stringRequired: NoInformation text about the content of the task flow (optional)

​
Task Flow Configurations

Task Flow Configuration Screen

​
Configuration Fields

Name

The name of the task flow as it appears in the list. It is required and must be unique within the project.

Description

Description related to the task flow.

Status

Indicates whether the task flow is active/passive.

Trace Status

Indicates whether the Trace (Debugging) feature is on/off.

Trigger Every

Indicates how often the task flow will be automatically triggered.

Tasks

Tasks defined in the content of the task flow are shown on the graph. Addition, deletion, and configuration operations are performed from here.

Endpoint

Option to trigger the task flow via its REST API endpoint.

Actions

Indicates actions to be performed if an error occurs during the execution of the defined task flow.

​
Trigger Frequency Configuration (Trigger Every)

You can define a scheduler to automatically run the task flow at specific times.
1

Open Trigger Configuration Window

Configuration regarding how often the created task flow should be triggered is performed through the window that opens when the Change button under Trigger Every is pressed.Trigger Configuration
2

Fill Value and Unit Fields

Fill the Value and Unit fields to define the scheduler configuration.Task Flow Definition SettingsAvailable units:
  • Minute - Minute
  • Hour - Hour
  • Custom - Custom Quartz Cron Expression
Scheduling can be done with the desired Quartz Cron Expression by selecting the Custom option in the scheduler definition.

​
Task Flow Definition Settings

Task flow definition settings are performed through the window that opens via the Edit button in the top right corner. Task Flow Definition Settings Task Flow Definition Settings Detail

Name

The name of the task flow as it appears in the list. It is required and must be unique within the project.

Description

Description related to the task flow.

Status

Active/passive status of the task flow.

Trace Status

Status of monitoring task flow steps. When active, data belonging to running steps is shown in logs, while when passive (suspend), detailed logging is not performed.

​
Task Settings

​
What is a Task?

In the API Integration module, each integration operation with a system or application is called a task. Since Apinizer adopts doing integrations as much as possible with API calls, it has adopted defining a task/connection type for each endpoint that can be called via API.

​
Task Types

Email Sending

Used for email sending

API Call

Used to send requests to external APIs

Database Connector

Used for database operations

Linux Script Execution

Used to run Linux commands

Script (JS/Groovy)

Used to run JavaScript or Groovy scripts

Notification

Used to send notifications

SNMP

Used for SNMP protocol operations

​
Task Definition

1

Click Task Addition Button

Sequentially running operations (transactions) are managed through the definition interface. To define a new task, press the + button on the schema under Tasks.Task Addition
2

Select Task Type

Task selection screen:Task SelectionContinue with task definition by selecting the task that is desired to be added.Task Selection
3

Configure Task Details

For example purposes, explanation will be made through the API Call example in this document.
You can see the window screen where the working steps of the task are defined in the screenshot below.API Call ConfigurationAPI Call Configuration

​
Data Transfer Between Tasks

In tasks within the task flow, the output of the previous task can be used as input for subsequent tasks. How the output of Api Call will be used as input for the Script policy added after it is shown in the screenshots below.
Data Transfer

​
Output Key Usage

You can use the output of the API Call task as input for the Script policy added after it: Output Key Usage You can access the output of a previous API Call task within the Script task through the variable specified when defining the API Call task from within the menu button. Script Variable Access
To use the output of a previous task within the current task, the variable must be used in double curly braces with a hash (#) sign at the end.Example: {{myOutputKey#}}
As seen in the screenshot below, the needed data has been retrieved from the output variable of the Api Call task by performing filtering operations within JsonPath/XPath Syntax. This retrieved data can be used as the LOOP_VARIABLE variable within the Script task. Variable Usage
The # sign at the end of variables represents JsonPath/XPath. It corresponds to the $ operator in JsonPath. This is a Syntax specific to Apinizer. You can review the Common Fields in Tasks table below for detailed usage of this Syntax.
The Script task’s ability to transfer data to the task to be defined in the next step is performed through the resultMap object and the variable value in the form interface where the Script task is defined. Variable Usage After the tasks that the task flow will perform are defined, the task is manually triggered once from the Execute button. To access the executed state and outputs of the task, click the Details button to access the execution log records of the task flow.

​
Viewing Task Flow Details

1

Open Details Menu

Logs can be viewed by clicking the menu button in the rightmost column of the record whose details are desired to be viewed from the task flow list and selecting Details.Details Menu
2

Examine Log Records

The screen containing the log details of the Task Flow is reached.Log Details
3

View Execution Details

Press the three-dot button next to the relevant execution moment log record to examine the execution details of the task flow.Execution Details
4

Task Log Details

Select Task Log Details to access the detailed execution log and outputs of each task within the task flow.Task Log Details
5

View Task Outputs

Execution logs of each task defined within the task flow are displayed through the opened window. Log details and task outputs can be viewed by pressing the three-dot button next to the relevant log record.Task OutputsTask Outputs DetailOutput of API Call task:API Call Task Output
The Trace option in Task Flow Definition Settings must be active to see the output data of tasks. Otherwise, results produced by tasks are not displayed on the log detail screen.

​
Common Fields in Tasks

Some input and output fields that are the same for each type are found when creating a task. Fields used for configuring common information in tasks are shown in the table below.

​
Common Field Descriptions

FieldDescription
Execute This Task ForThe type of how the result produced from the previous task will be executed within the current task is selected. Once: The current task is executed once. Loop: The current task runs in loop form with the definition to be specified on the result it receives from the previous task.
JSON Path/XPath SyntaxThis option becomes active if the task execution type is selected as Loop. The result of the value given with JSON Path/XPath is executed as a loop.
Continue if operation failsThis option becomes active if the task execution type is selected as Loop. When actions in the loop are executed, if an error occurs, it manages whether the task should continue running or be stopped immediately.
Output Keys List buttonThe list of output keys created in previous tasks is viewed. Thus, this output key can be used in task definition inputs.
Output KeyThe variable name to which the value that will be created when the task is executed will be assigned is entered. Subsequent tasks after this task will use the output key entered in this field if they want to process with this task’s output.
**Name **The name of the task is written. This information is assigned as the value of the {{taskflow.name}} variable.
**Description **The description of the task is written.
  • No space should be left in the output key.
  • Output key names in the defined flow must be unique.

​
Apinizer Syntax

The critical point in this field is that the value is written in accordance with Apinizer’s syntax. There are 2 elements to pay attention to in this rule.
Syntax rules:
  • Must open and close with 2 curly braces
  • In the first part of the syntax, the output key name of the previous task is given. A # sign is placed at the end
  • In the second part of the syntax, the value to be retrieved from within the output value is written in the query language (JSONPath, XPath) belonging to the data type
Formula:
{{previous-task-output-name#<this-part-is-written-in-either-JSONPath-or-XPath-format>}}
Example: A result named centralRates is produced in one of the previous tasks. The values of the result contain exchange rate information belonging to the Central Bank. An XPath query /Date/Currency has been written to get the elements in the array contained in this result one by one.
{{centralRates#/Date/Currency}}

​
Triggering Task Flow

Task flow can be triggered in three different ways:
The task flow is triggered every time the marked Execute button in the top right corner is clicked.Manual Triggering

​
Deleting Task Flow

The record is deleted by clicking the menu button in the rightmost column of the record desired to be deleted in the task flow list and selecting Delete. Deleting Task Flow

​
Endpoint Configuration

In addition to being triggered with a scheduler or manually with the execute button, task flows can also be triggered via HTTP requests through the special and unique endpoint created for the task flow at the moment the task flow is created.
1

Activate Endpoint Option

The endpoint option must be activated from the task flow editing interface.
2

Use Endpoint URL

After the endpoint option is activated, the task flow can be triggered by sending a request to the displayed URL.Endpoint URL
3

Create Token

To trigger the task flow via its access URL, it is necessary to send a request by adding the user token to the Authorization header.To create a token: Token can be created with the logged-in user from Profile menu from top right > My Profile.

​
Actions Configuration

​
What is an Action?

Action refers to operations to be performed when an error occurs during the execution of a task flow.
1

Action Addition

You can define tasks desired to be performed in case of a possible error by pressing the + button from the Actions section.Action Addition
2

Select Action Type

You can be notified of error situations or perform special operations for error situations by defining a task through the opened window when a possible error is encountered in the task flow.Action Type Selection
For example, you can define an action to send an email or make an API call when the task flow fails.