Task User API

Workflow engine is configured by zen. We do not support it and do not recommend to use it anymore. Please, use any other workflow engine e.g. Temporal.

Since the 2405 release, using Aidbox in FHIR schema validation engine is recommended, which is incompatible with zen or Entity/Attribute options.

Setup Aidbox with FHIR Schema validation engine

Task User API allows users to manually control Aidbox tasks by RPC methods.

`awf.task/create-and-execute`

Creates an instance of a defined task and makes it ready to be executed immediately or at a specified time.

Params:

Parameter	Type	Required	Description
id	string	false	Identifier of task (If not provided, will be auto-generated).
label	string	false	Human- or machine-readable description of task instance. Example: `Import Patient resources`
definition	string	true	Definition of predefined task or custom-defined task. Example: `aidbox.archive/create-archive`
params	object	true	The input parameters described in the task definition.
executeAt	string	false	Time at which the task will become ready. If not provided - task will become ready immediately. Example: `2023-05-03T13:30:43`

Result:

Parameter	Type	Description
resource	object	Created AidboxTask resource.

POST /rpc
content-type: text/yaml
accept: text/yaml

method: awf.task/create-and-execute
params:
  definition: aidbox.bulk/import-resource-task
  params:
    type: aidbox
    input:
      url: https://storage.googleapis.com/aidbox-public/synthea/100/Organization.ndjson.gz
      resourceType: Organization

result:
  resource:
    params:
      type: aidbox
      input:
        url: >-
          https://storage.googleapis.com/aidbox-public/synthea/100/Organization.ndjson.gz
        resourceType: Organization
    status: ready
    definition: aidbox.bulk/import-resource-task
    id: >-
      61053bc2-aac6-49a1-91e7-7f9fa29afe21
    resourceType: AidboxTask
    meta:
      lastUpdated: '2023-05-03T15:21:19.357771Z'
      createdAt: '2023-05-03T15:21:19.357771Z'
      versionId: '17525'

`awf.task/status`

Returns the status of a task instance with the specified id.

Params:

Parameter	Type	Required	Description
id	string	true	Id of the task whose status will be returned.
include-settings?	boolean	false	If `true` , includes setting parameters predefined in definition. Default: `false`
include-log?	boolean	false	If `true,` includes log of task status transitions according to #task-instance-lifecycle. Default: `false`

Result:

Parameter	Type	Description
resource	object	Created AidboxTask resource.
settings	object	TODO
log	object[]	AidboxTaskLog resources for task with specified id

POST /rpc
content-type: text/yaml
accept: text/yaml

method: awf.task/status
params:
  id: c9555892-6221-42b4-9b34-1428a18e893c

result:
  resource:
    definition: aidbox.bulk/import-resource-task
    meta:
      lastUpdated: '2023-04-24T09:30:51.562261Z'
      createdAt: '2023-04-24T09:30:50.888731Z'
      versionId: '128371'
    params:
      type: aidbox
      input:
        url: >-
          https://storage.googleapis.com/aidbox-public/synthea/100/Organization.ndjson.gz
        resourceType: Organization
      contentEncoding: gzip
    retryCount: 1
    outcome: succeeded
    resourceType: AidboxTask
    status: done
    result:
      imported-resources: 100
    execId: ea82769d-e083-461c-8cb0-3427ed466f19
    label: >-
      Organization
      https://storage.googleapis.com/aidbox-public/synthea/100/Organization.ndjson.gz
    id: >-
      c9555892-6221-42b4-9b34-1428a18e893c

`awf.task/cancel`

Cancels execution of a created task instance.

Params:

Parameter	Type	Required	Description
id	string	true	Id of the task that will be canceled.

Result:

Parameter	Type	Description
resource	object	Created AidboxTask resource.

POST /rpc
content-type: text/yaml
accept: text/yaml

method: awf.task/cancel
params:
  id: 485b9cbd-0a78-4909-9908-0ae2e66a2b12

result:
  resource:
    params:
      type: aidbox
      input:
        url: >-
          https://storage.googleapis.com/aidbox-public/synthea/100/Organization.ndjson.gz
        resourceType: Organization
    status: done
    outcome: canceled
    executeAt: '2023-05-04T15:30:43'
    definition: aidbox.bulk/import-resource-task
    id: >-
      485b9cbd-0a78-4909-9908-0ae2e66a2b12
    resourceType: AidboxTask
    meta:
      lastUpdated: '2023-05-04T12:25:38.800464Z'
      createdAt: '2023-05-04T12:25:24.355856Z'
      versionId: '17563'

`awf.task/list`

Returns the list of all tasks.

Params:

Parameter	Type	Required	Description
filter	object	false
filter.includeDefinitions	string[]	false	Array of task definitions to include.
filter.excludeDefinitions	string[]	false	Array of task definitions to exclude.
filter.status	string	false	Include task with specified status. Possible values: `created`, `waiting`, `ready`, `requested`, `in-progress`, `done`
filter.outcome	string	false	Include task with status `done` and specified outcome. Possible values: `succeeded`, `failed`, `canceled`
filter.ilike	string	false	ilike search by resource content
sort	object	false	May contain either `createdAt` or `lastUpdated`.
sort.createdAt	string	false	Sorts result by `createdAt` DateTime. Possible values: `asc`, `desc`
sort.lastUpdated	string	false	Sorts result by `lastUpdated` DateTime. Possible values: `asc`, `desc`

Result:

Parameter	Type	Description
resources	object[]	Created AidboxTask resources.

POST /rpc
content-type: text/yaml
accept: text/yaml

method: awf.task/list
params:
  filter:
    ilike: import-resource-task

result:
  resources:
    - definition: aidbox.bulk/import-resource-task
      meta:
        lastUpdated: '2023-04-24T09:30:51.562261Z'
        createdAt: '2023-04-24T09:30:50.888731Z'
        versionId: '128371'
      params:
        type: aidbox
        input:
          url: >-
            https://storage.googleapis.com/aidbox-public/synthea/100/Organization.ndjson.gz
          resourceType: Organization
        contentEncoding: gzip
      retryCount: 1
      outcome: succeeded
      resourceType: AidboxTask
      requester:
        id: >-
          38239f30-2e67-45fb-8e67-992c5c1b350e
        resourceType: AidboxWorkflow
      status: done
      result:
        imported-resources: 100
      execId: ea82769d-e083-461c-8cb0-3427ed466f19
      label: >-
        Organization
        https://storage.googleapis.com/aidbox-public/synthea/100/Organization.ndjson.gz
      id: >-
        c9555892-6221-42b4-9b34-1428a18e893