Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 4 Next »

To list all recently delivered workflows, this method is vital for those intending to "poll" for new deliveries on a routine basis, such as daily. Following the acquisition of this list, you can then advance to downloading the files and subsequently confirming each download.

URL

(GET) /api/projects/{pid}/workflows/list/delivered

PARAMETERS

The URL parameters are:

pid

The project ID.

int, Mandatory

minutes

Optional. If specified then you get the workflows finished since that amount of minutes.

int?, Optional

date

Optional. If this date is specified, then you get the workflows finished since this date. Use either “minutes” or “date”.

datetime?, Optional

skip

Used for pagination. Skip the first number of rows.

int, Optional

take

Used for pagination. The number of rows per page. Default is 100 and maximum is 200.

int, Optional

RESULTS

The method returns a JSON object with a list of finished workflows. Example:

{
    "total": 2,
    "count": 2,
    "rows": [
        {
            "did": 18494,
            "dname": "file-002.htm",
            "pid": 6757,
            "preference": "WM-17228",
            "branch": "fr",
            "brancht": "French (fr)",
            "src": "en",
            "trg": "fr",
            "srct": "English (en)",
            "trgt": "French (fr)",
            "status": 4,
            "statusTitle": "◀Work delivered▶",
            "statusDate": "2024-04-03T06:32:37Z",
            "segments": 3,
            "openJobs": 0,
            "messageDate": null
        },
        {
          ....
        }
    ],
    ...
}    

The properties are:

  • total: Grand total number of rows.

  • count: Rows included in result. With pagination total may be greater than count.

  • rows: The workflows:

    • did: The document ID.

    • dname: Document name

    • pid: Project ID

    • preference: Project reference

    • branch, brancht: Branch language code and name

    • src, srct: Source language code and name

    • trg, trgt: Target language code and name

    • status, statusTitle, StatusDate: The workflow status, name and date of change

    • segments: Total segments in document

    • openJobs: Total open jobs in workflow

    • messageDate: Last user message in workflow

COMMENTS

This method is a convenient shortcut for the more powerful workflows/list API. It simply applies a filter on status and status date.

  • No labels