WorkflowAPI

Restful API for InterSystems Data Platforms Workflow. This is the latest version, previous projects are deprecated and should not be used in new projects.

UI client is available here.

Installation

1. Import and compile this isc.wf.REST.
2. Create a web-application for REST in the Portal Management System (for ex. /workflow/rest). Set dispatch class to isc.wf.REST, Authentication methods to ‘Unauthorized’ and ‘Password’.
3. (Optional) Add isc.wf package mapping if you need to query another namespace.

Requests

These are the possible requests to web application. Postman collection is available.

Prerequisites

If you work with Ensemble Workflow it is recommended to familiarize yourself with EnsLib.Workflow package. Here’s a quick primer on the main classes:

GET tasks

It’s the basic and first request you need to execute after logging in (by authentication method you configured for REST web application). It returns basic information unassigned tasks or tasks assigned to a current user.
You can provide two parameters:

• count - number of records to return (defaults to 100)
• maxId - last id from previous page (if left empty all tasks would be returned)

Tasks are returned in reverse chronological order, newest to oldest. Here’s how it looks like:

[
    {
        "id": "318||dev",
        "isNew": 1,
        "priority": 3,
        "subject": "Problem reported by 1",
        "message": "2",
        "timeCreated": "2018-08-24 07:07:22.717",
        "role": "Demo-Development"
    },
    {
        "id": "308||dev",
        "isNew": 1,
        "priority": 3,
        "subject": "Problem reported by 3",
        "message": "3",
        "timeCreated": "2018-11-28 19:03:41.95",
        "role": "Demo-Development"
    }
]

Here we can see two tasks, fist unassigned and second assigned to a current user (dev). Object properties are

GET task/:id

After you received main information about available tasks, you can see it in more detail, by requesting it by id (308||dev in the example). Here’s how response object looks like:

{
    "id": "308||dev",
    "isNew": 1,
    "priority": 3,
    "subject": "Problem reported by 3",
    "message": "3",
    "timeCreated": "2018-11-28 19:03:41.95",
    "role": "Demo-Development",
    "actions": "Corrected,Ignored",
    "formFields": {
        "Comments": "Comment value, if any"
    }
}

Properties are the same, except two new properties are added

It’s just a JSON representation of EnsLib.Workflow.Worklist object.
This request provides enough information to display task to the user.

POST task/:id

After a user is done working on a task, you need to notify Workflow engine about a new state of a task. To do that, execute this request, with the JSON representation of EnsLib.Workflow.Worklist object (received from the previous request) as a body.
To express changes made by a user, send this object:

• Set action property to one of the %Actions values or $Accept to accept a task, $Relinquish to relinquish task and $Save to save changes made to a task
• Provide formValues object with ALL values, even unmodified ones.

Here’s an example of a user modifying 308||dev task (by choosing Save action):

{
	"action": "$Save", 
	"formFields": {
		"Comments": "New comment value"
	}
}

Images and Links

If some of your form fields are links and/or images, you can use a special form field: $$$Handler. Set it like this {"myLink":"link","myImg":"img"} where myLink is a name of a form field containig the link and myImg is a name of a form field containig the image. WorkflowUI-ngx would display them appropriately.

DOCKER Support

Prerequisites

Make sure you have git and Docker desktop installed.

Installation

Clone/git pull the repo into any local directory

$ git clone https://github.com/intersystems-community/WorkflowAPI.git

Open the terminal in this directory and run:

$ docker-compose build

Run IRIS container with your project:

$ docker-compose up -d

Test from docker console

$ docker-compose exec iris1 iris session iris
USER>

or using WebTerminal

http://localhost:42773/terminal/