Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Macro name changed from html to html-bobswift during server to cloud migration processing.

...

Examples

XML

JSON

Example Request

Expand
titleXML
<task-insert>
    <name>Sleep 30</name>
    <alias>Test</alias>
    <workflowInstanceId>ac2cfdd14c8c4238a4a6ecd03db41e87</workflowInstanceId>
    <predecessors> 
        <predecessor>Sleep 30</predecessor>
    </predecessors>
    <successors> 
        <successor>Sleep 60</successor>
    </successors>
    <vertexX>25</vertexX>
    <inheritTriggerTime>true</inheritTriggerTime>
    <vertexY>25</vertexY>
</task-insert>
Expand
titleJSON
{
"name": "Sleep 10",
"alias": "Test",
"workflowInstanceId": "1513717759915306953T5FNZB71S6OUF",
"predecessors": [ "Task 1" ],
"successors": [ "Sleep 60" ],
"vertexX": "25",
"inheritTriggerTime": "true",
"vertexY": "25"
}

Example Response

Expand
titleXML
Panel
Html bobswift
<pre>
&lt;command-response&gt;
    &lt;type&gt;create_task&lt;/type&gt;
    &lt;success&gt;true&lt;/success&gt;
    &lt;info&gt;Command Insert Task executed successfully against task instance "test workflow".&lt;/info&gt;
    &lt;errors /&gt;
&lt;/command-response&gt;
</pre>
Expand
titleJSON
Panel
Html bobswift
<pre>
{
  "type": "create_task",
  "success": true,
  "info": "Command Insert Task executed successfully against task instance \"Test Workflow\".",
  "errors": ""
}
</pre>

Anchor
Insert a Task into a Workflow with Dependencies Request Properties
Insert a Task into a Workflow with Dependencies Request Properties
Insert a Task into a Workflow with Dependencies: Request Properties

Property

UI Field Name

Description

Specifications

Required

Mutually Exclusive With

Anchor
alias - IT
alias - IT
alias

n/a

Alias used for the task within the Workflow; specifically, the value of ops_exec_workflow_vertex.name.


N


Anchor
id - IT
id - IT
id

n/a

sys_id of the task to be inserted.


Y
(unless name
is specified)

name

Anchor
name - IT
name - IT
name

Task Name

Name of the task to be inserted.


Y
(unless id
is specified)

id

Anchor
predecessors - IT
predecessors - IT
predecessors

Predecessors

Comma-separated list of predecessor task instances within the workflow for the task to be inserted.


N


Anchor
successors - IT
successors - IT
successors

Successors

Comma-separated list of successor task instances within the workflow for the task to be inserted.


N


Anchor
vertexX - IT
vertexX - IT
vertexX

n/a

x-coordinate of the task to be inserted within the workflow.

Default is 0.

N


Anchor
vertexY- IT
vertexY- IT
vertexY

n/a

y-coordinate of the task to be inserted within the workflow.

Default is 0.

N


Anchor
inheritTriggerTime - IT
inheritTriggerTime - IT
inheritTriggerTime

n/a

Specification for whether or not the inserted task will inherit the Trigger Time of the Workflow task instance.

Boolean; Valid values (not case-sensitive):

Html bobswift
<ul>
<li> Yes,Y,true
<li> No, N, false
</ul>

Default is Yes, Y, true.

N


Anchor
workflowInstanceCriteria- IT
workflowInstanceCriteria- IT
workflowInstanceCriteria

n/a

If search is by workflowInstanceName; Specific Workflow task instance with this task instance name which you want to insert the task into.

Valid values:

Html bobswift
<ul>
<li> As String = oldest active instance, As Value = 1
<li> As String = newest active instance, As Value = 2
<li> As String = oldest instance, As Value = 3
<li> As String = newest instance, As Value = 4
</ul>

Default is oldest active instance (1).
 

Note
titleNote

Values with an underscore characters ( _ )
instead of spaces also are supported
(for example, oldest_active_instance).

N


Anchor
workflowInstanceId - IT
workflowInstanceId - IT
workflowInstanceId

n/a

sys_id of the Workflow to insert the task into.


Y
(unless workflowInstanceName
is specified)

workflowInstanceName

Anchor
workflowInstanceName - IT
workflowInstanceName - IT
workflowInstanceName

Instance Name

Name of the Workflow to insert the task into.


Y
(unless workflowInstanceId
is specified)

workflowInstanceId

...

Parameter

Description

Specifications

Required

Mutually Exclusive With

criteria

If taskinstancename is specified; Specific task instance with this task instance name for which you want to list predecessors and successors.

Valid values:

Html bobswift
<ul>
<li> As String = oldest active instance, As Value = 1
<li> As String = newest active instance, As Value = 2
<li> As String = oldest instance, As Value = 3
<li> As String = newest instance, As Value = 4
</ul>

Default is oldest active instance (1).
 

Note
titleNote

Values with an underscore characters ( _ )
instead of spaces also are supported
(for example, oldest_active_instance).

N


dependencytype

Type of dependency to list for the task instance.

Valid values: predecessors, successors, * (all predecessors and successors).

N


taskinstanceid

sys_id of the task instance for which you want to list predecessors and successors.


Y
(unless taskinstancename
is specified)

taskinstancename

taskinstancename

Name of the task instance for which you want to list predecessors and successors.


Y
(unless taskinstanceid
is specified)

taskinstanceid

workflowinstancename

If taskinstancename is specified; Name of the Workflow task instance containing the task instance for which you want to list predecessors and successors.


N


...