Run +PReS Enhance Workflow Configuration

Submits a request to run a +PReS Enhance workflow configuration via the Weaver engine directly, using a list of command-line arguments.

Request takes no content, and on success returns a response containing the result of the request to run/execute the workflow configuration.

Request

Method Type:

GET

URI:

/rest/serverengine/workflow/outputcreation/execute/{args}/{size}

Content: –
Content Type:

–

Add. Headers:

If server security settings are enabled, then one of the following:

  • Authorization – Basic Authentication (Username and Password) credentials (Base64 encoded)
  • auth_token – Authorization Token

Parameters

Path

Name Required Type Default Value Description

args

– – –

A comma delimited, URI encoded list of command-line arguments to use to execute the Weaver engine including1:

  • -c,<workflow file> – the path to +PReS Enhance workflow configuration
  • -O,<output dir> – the path to directory to be used for output
  • <input file> – the path(s) to the file(s) to be used as input

size

– – –

The estimated page size, used by PReS Connect to determine the job size (which determines the number of speed units to use)

1 For a list of all the available command-line arguments accepted by the Weaver engine, please reference the +PReS Enhance documentation.

Response

Success

The following lists status codes indicative of a successful response:

Status Code Content Content-Type Add. Headers Description
200
OK		 Result of request to run +PReS Enhance workflow text/plain – +PReS Enhance Workflow Configuration successfully run/executed

Error

The following lists status codes indicative of a failed or error response:

Status Code Content Content-Type Add. Headers Description

401 Unauthorized

–

–

WWW-Authenticate – BASIC (Basic Authentication credentials are accepted)

Server authentication is required.

Response when neither basic authentication credentials nor an authorization token have been specified in the request headers.

401 Unauthorized

Error message

–

–

Server authentication has failed.

Response when the authorization token specified in the request headers has now expired.

403 Forbidden

Error message

–

–

Server authentication has failed.

Response when either the basic authentication credentials or the authorization token specified in the request headers are invalid.