User Manual

2.6 Production Jobs and Imposing

Updated on

1. Create a Production Job

Compatibility: from Durst Workflow v1.7.5

Available in
Durst Workflow Print Label / Durst Workflow Print Label +
Durst Workflow Print / Durst Workflow Print +

Production Jobs allows importing and management of print data, technical and qualitative verification of PDF-based files, imposing and final transfer of the data to the printer. Basically, the Workflow is used as a RIP and controls the printer for output.

In earlier versions of the Durst Workflow (before 1.7.6) the Create a Production Job Function used to be POST /api/v1/productionJobs. One of the reasons for this change is that with /api/v1/productionJobs/validate we have also implemented a validation function into the Workflow (for integration development purposes) and standardised the naming system. With GET /api/v1/productionJobs/{id} it is then also possible to retrieve information about the Production Job created.

POST /api/v1/productionJobs/create

1.1. Parameters

Type
Name
Description
Schema
Body
productionJobApi required
productionJobApi
ProductionJobApi
Body
ReferencedColorPolicyApi required
ReferencedColorPolicyApi
ReferencedColorPolicyApi
Body
MotifApiCreate optional
MotifApiCreate
MotifApiCreate
Body
ReferencedSubstrateShapeApi optional
ReferencedSubstrateShapeApi
ReferencedSubstrateShapeApi
Body
FileLinkApi optional
FileLinkApi
FileLinkApi

1.2. Responses

HTTP Code Description Schema
201 Created ProductionJobApi
401 Unauthorized No Content
403 Forbidden No Content
404 Not Found No Content

1.3. Consumes

application/json

1.4. Produces

*/*

1.5. Tags

Production Job Controller Api

1.6. Example HTTP request

Request path

/api/v1/productionJobs/create

Request body

{
  "externalId": "EXT-123",
  "name": "Create Production Job",
  "comment": "Comment",
  "shippingDate": "2019-12-10",
  "productionDate": "2019-08-19T13:37:00Z",
  "colorPolicyReference": {
    "id": 3
  },
  "substrateShapeReference": {
    "id": 3
  },
  "motifs": [
    {
      "externalId": "EXT-123",
      "name": "Label 123",
      "checkinTemplateGuid": "47e8e6c4-2ebc-412f-b427-e6393e66b67e",
      "comment": "string",
      "widthMm": 210,
      "heightMm": 297,
      "pages": 1,
      "numberCopies": 100,
      "windingTypeKey": "INSIDE",
      "orientationTypeKey": "TOP",
      "colorPolicyReference": {
        "id": 3
      },
      "pdfFileLink": {
        "externalId": "EXT-123",
        "uri": "https://domain.at:443/path/to/file.pdf"
      },
      "additionalFilesList": [
        {
          "externalId": "EXT-123",
          "uri": "https://domain.at:443/path/to/file.pdf"
        }
      ]
    }
  ]
}

1.7. Example HTTP response

Response 201

{
  "id": 26,
  "externalId": "EXT-123",
  "name": "Create Production Job",
  "comment": "Comment",
  "shippingDate": "2019-12-10",
  "productionDate": "2019-08-19T13:37:00Z",
  "colorPolicyReference": {
    "id": 3
  },
  "substrateShapeReference": {
    "id": 3
  },
  "motifs": [
    {
      "id": 72,
      "externalId": "EXT-123",
      "name": "Label 123",
      "comment": "string",
      "widthMm": 210,
      "heightMm": 297,
      "pages": 1,
      "numberCopies": 100,
      "windingTypeKey": "INSIDE",
      "orientationTypeKey": "TOP",
      "colorPolicyReference": {},
      "additionalFilesList": []
    }
  ]
}
2. Create a Production Job using an Output Template

Compatibility: from Durst Workflow v1.8.1

Available in
Durst Workflow Print Label / Durst Workflow Print Label +
Durst Workflow Print / Durst Workflow Print +

Creating a Production Job with certain Output Setting using an Output Template

When creating a Production job either an Output Setting (outputTemplateReference) or a Color Policy (colorPolicyReference) is required

POST /api/v1/productionJobs/create

2.1. Parameters

Type
Name
Description
Schema
Body
productionJobApi required
productionJobApi
ProductionJobApi
Body
ReferencedColorPolicyApi required
ReferencedColorPolicyApi
ReferencedColorPolicyApi
Body
MotifApiCreate optional
MotifApiCreate
MotifApiCreate
Body
ReferencedSubstrateShapeApi optional
ReferencedSubstrateShapeApi
ReferencedSubstrateShapeApi
Body
FileLinkApi optional
FileLinkApi
FileLinkApi

2.2. Responses

HTTP Code Description Schema
201 Created ProductionJobApi
401 Unauthorized No Content
403 Forbidden No Content
404 Not Found No Content

2.3. Consumes

application/json

2.4. Produces

*/*

2.5. Tags

Production Job Controller Api

2.6. Example HTTP request

Request path

/api/v1/productionJobs/create

Request body

{
  "externalId": "EXT-123",
  "name": "Create Production Job",
  "comment": "Comment",
  "shippingDate": "2019-12-10",
  "productionDate": "2019-08-19T13:37:00Z",
  "outputTemplateReference": {
    "id": 5
  },
  "motifs": [
    {
      "externalId": "EXT-123",
      "name": "Label 123",
      "comment": "string",
      "pages": 1,
      "numberCopies": 100,
      "pdfFileLink": {
        "externalId": "EXT-123",
        "uri": "https://domain.at:443/path/to/file.pdf"
      }
    }
  ]
}

2.7. Example HTTP response

Response 201

{
  "id": 341,
  "externalId": "EXT-123",
  "status": "OUTPUT_CONFIG_ASSIGNED",
  "name": "Create Production Job",
  "comment": "Comment",
  "shippingDate": "2019-12-10",
  "productionDate": "2019-08-19T13:37:00Z",
  "motifs": [
    {
      "id": 3879,
      "externalId": "EXT-123",
      "status": "CREATED",
      "name": "Label 123",
      "comment": "string",
      "pages": 1,
      "numberCopies": 100,
      "colorPolicyReference": {
        "id": 2
      }
    }
  ],
  "colorPolicyReference": {
    "id": 2
  },
  "substrateShapeReference": {
    "id": 4
  }
}
3. Validate a Production Job

Compatibility: from Durst Workflow v1.7.5

Available in
Durst Workflow Print Label / Durst Workflow Print Label +
Durst Workflow Print / Durst Workflow Print +

This function enables you to check whether all parameters are correct without actually transferring the data directly into the system. Of course, this validation is also done automatically when creating a Production Job. An alternative possibility is to check everything in advance during the development of an API integration.

POST /api/v1/productionJobs/validate

3.1. Parameters

Type
Name
Description
Schema
Body
productionJobApi required
productionJobApi
ProductionJobApi
Body
ReferencedColorPolicyApi required
ReferencedColorPolicyApi
ReferencedColorPolicyApi
Body
MotifApiCreate optional
MotifApiCreate
MotifApiCreate
Body
ReferencedSubstrateShapeApi optional
ReferencedSubstrateShapeApi
ReferencedSubstrateShapeApi
Body
FileLinkApi optional
FileLinkApi
FileLinkApi

3.2. Responses

HTTP Code Description Schema
200 OK ProductionJobApi
401 Unauthorized No Content
403 Forbidden No Content
404 Not Found No Content

3.3. Consumes

application/json

3.4. Produces

*/*

3.5. Tags

Production Job Controller Api

3.6. Example HTTP request

Request path

/api/v1/productionJobs/validate

Request body

{
  "externalId": "EXT-123",
  "name": "Create Production Job",
  "comment": "Comment",
  "shippingDate": "2019-12-10",
  "productionDate": "2019-08-19T13:37:00Z",
  "colorPolicyReference": {
    "id": 3
  },
  "substrateShapeReference": {
    "id": 3
  },
  "motifs": [
    {
      "externalId": "EXT-123",
      "name": "Label 123",
      "status": "CREATED",
      "comment": "string",
      "widthMm": 210,
      "heightMm": 297,
      "pages": 1,
      "numberCopies": 100,
      "windingTypeKey": "INSIDE",
      "orientationTypeKey": "TOP",
      "colorPolicyReference": {
        "id": 3
      },
      "pdfFileLink": {
        "externalId": "EXT-123",
        "id": 0,
        "uri": "https://domain.at:443/path/to/file.pdf"
      },
      "additionalFilesList": [
        {
          "externalId": "EXT-123",
          "id": 0,
          "uri": "https://domain.at:443/path/to/file.pdf"
        }
      ]
    }
  ]
}

3.7. Example HTTP response

Response 201

{
    "ok": true,
    "validationFailures": []
}
4. Get a Production Job

Compatibility: from Durst Workflow v1.7.5

Available in
Durst Workflow Print Label / Durst Workflow Print Label +
Durst Workflow Print / Durst Workflow Print +

Get a response of all stored data of a specific Production Job by ID, including Color Policy, Substrates and a list of included Motifs / Print Items.

GET /api/v1/productionJobs/{id}

4.1. Parameters

Type
Name
Description
Schema
Path
id required
ID of the Production Job
integer (int32)

4.2. Responses

HTTP Code Description Schema
200 OK ProductionJobApi
401 Unauthorized No Content
403 Forbidden No Content
404 Not Found No Content

4.3. Consumes

application/json

4.4. Produces

*/*

4.5. Tags

Production Job Controller Api

4.6. Example HTTP request

Request path

/api/v1/productionJobs/{id}

4.7. Example HTTP response

Response 200

{
  "id": 26,
  "externalId": "EXT-123",
  "name": "Create Production Job",
  "comment": "Comment",
  "shippingDate": "2019-12-10",
  "productionDate": "2019-08-19T13:37:00Z",
  "colorPolicyReference": {
    "id": 3
  },
  "substrateShapeReference": {
    "id": 3
  },
  "motifs": [
    {
      "id": 72,
      "externalId": "EXT-123",
      "name": "Label 123",
      "status": "CHECKED_IN",
      "comment": "string",
      "widthMm": 210,
      "heightMm": 297,
      "pages": 1,
      "numberCopies": 100,
      "windingTypeKey": "INSIDE",
      "orientationTypeKey": "TOP",
      "colorPolicyReference": {},
      "additionalFilesList": []
    }
  ]
}
5. Create an empty Production Job

Compatibility: from Durst Workflow v1.7.8

Available in
Durst Workflow Print Label / Durst Workflow Print Label +
Durst Workflow Print / Durst Workflow Print +

With Durst Workflow 1.7.8 a new function was introduced to add existing articles to a Production Job. So it is possible now, to create am empty Production Job without creating Print Items and then add existing Articles.

POST /api/v1/productionJobs/create

5.1. Parameters

Type
Name
Description
Schema
Body
productionJobApi required
productionJobApi
ProductionJobApi
Body
ReferencedColorPolicyApi required
ReferencedColorPolicyApi
ReferencedColorPolicyApi
Body
MotifApiCreate optional
MotifApiCreate
MotifApiCreate
Body
ReferencedSubstrateShapeApi optional
ReferencedSubstrateShapeApi
ReferencedSubstrateShapeApi
Body
FileLinkApi optional
FileLinkApi
FileLinkApi

5.2. Responses

HTTP Code Description Schema
201 Created ProductionJobApi
401 Unauthorized No Content
403 Forbidden No Content
404 Not Found No Content

5.3. Consumes

application/json

5.4. Produces

*/*

5.5. Tags

Production Job Controller Api

5.6. Example HTTP request

Request path

/api/v1/productionJobs/create

Request body

{
  "name": "Production Job without Print Item",
  "shippingDate": "2020-07-07",
  "productionDate": "2007-07-07T00:37:00Z",
  "colorPolicyReference": {
    "id": 13
  }
}

5.7. Example HTTP response

Response 201

{
  "id": 3389,
  "status": "OUTPUT_CONFIG_ASSIGNED",
  "name": "Production Job without Print Item",
  "shippingDate": "2020-07-07",
  "productionDate": "2007-07-07T00:37:00Z",
  "motifs": [],
  "colorPolicyReference": {
    "id": 1
  },
  "substrateShapeReference": {
    "id": 1
  }
}
6. Create an empty Production Job using an Output Template

Compatibility: from Durst Workflow v1.8.1

Available in
Durst Workflow Print Label / Durst Workflow Print Label +
Durst Workflow Print / Durst Workflow Print +

With Durst Workflow 1.7.8 a new function was introduced to add existing articles to a Production Job. So it is possible now, to create am empty Production Job without creating Print Items and then add existing Articles. Creating an empty Production Job with certain Output Setting using an Output Template

POST /api/v1/productionJobs/create

6.1. Parameters

Type
Name
Description
Schema
Body
productionJobApi required
productionJobApi
ProductionJobApi
Body
ReferencedColorPolicyApi required
ReferencedColorPolicyApi
ReferencedColorPolicyApi
Body
MotifApiCreate optional
MotifApiCreate
MotifApiCreate
Body
ReferencedSubstrateShapeApi optional
ReferencedSubstrateShapeApi
ReferencedSubstrateShapeApi
Body
FileLinkApi optional
FileLinkApi
FileLinkApi

6.2. Responses

HTTP Code Description Schema
201 Created ProductionJobApi
401 Unauthorized No Content
403 Forbidden No Content
404 Not Found No Content

6.3. Consumes

application/json

6.4. Produces

*/*

6.5. Tags

Production Job Controller Api

6.6. Example HTTP request

Request path

/api/v1/productionJobs/create

Request body

{
  "name": "Production Job without Print Item",
  "shippingDate": "2020-07-07",
  "productionDate": "2007-07-07T00:37:00Z",
  "outputTemplateReference": {
    "id": 3
  }
}

6.7. Example HTTP response

Response 201

{
  "id": 1341,
  "status": "OUTPUT_CONFIG_ASSIGNED",
  "name": "Production Job without Print Item",
  "shippingDate": "2020-07-07",
  "productionDate": "2007-07-07T00:37:00Z",
  "motifs": [],
  "colorPolicyReference": {
    "id": 15
  },
  "substrateShapeReference": {
    "id": 9
  }
}
7. List all linked Print Items of a Production Job

Compatibility: from Durst Workflow v1.7.8

Available in
Durst Workflow Print Label / Durst Workflow Print Label +
Durst Workflow Print / Durst Workflow Print +

List all linked Print Items of a Production Job

GET /api/v1/productionJobs/{id}/motifs

7.1. Parameters

Type
Name
Description
Schema
Path
id required
ID of the Production Job
integer (int32)

7.2. Responses

HTTP Code Description Schema
200 OK MotifApi
401 Unauthorized No Content
403 Forbidden No Content
404 Not Found No Content

7.3. Consumes

application/json

7.4. Produces

*/*

7.5. Tags

Production Job Motif Controller

7.6. Example HTTP request

Request path

/api/v1/productionJobs/{id}/motifs 

7.7. Example HTTP response

Response 200

[
  {
    "id": 12026,
    "status": "CHECKED_IN",
    "name": "New Print Item",
    "widthMm": 307.722,
    "heightMm": 170.406,
    "pages": 1,
    "numberCopies": 43,
    "colorPolicyReference": {
      "id": 5
    }
  }
]
8. Get a Print Item of a Production Job

Compatibility: from Durst Workflow v1.7.8

Available in
Durst Workflow Print Label / Durst Workflow Print Label +
Durst Workflow Print / Durst Workflow Print +

List all linked Print Items of a Production Job

GET /api/v1/productionJobs/{id}/motifs/{id}

8.1. Parameters

Type
Name
Description
Schema
Path
id required
ID of the Production Job
integer (int32)
Path
id required
ID of the Motif
integer (int32)

8.2. Responses

HTTP Code Description Schema
200 OK MotifApi
401 Unauthorized No Content
403 Forbidden No Content
404 Not Found No Content

8.3. Consumes

application/json

8.4. Produces

*/*

8.5. Tags

Production Job Motif Controller

8.6. Example HTTP request

Request path

/api/v1/productionJobs/{id}/motifs/{id}

8.7. Example HTTP response

Response 200

{
  "id": 12026,
  "status": "CHECKED_IN",
  "name": "New Print Item",
  "widthMm": 307.722,
  "heightMm": 170.406,
  "pages": 1,
  "numberCopies": 43,
  "colorPolicyReference": {
    "id": 5
  }
}
9. Update a Print Item of a Production Job

Compatibility: from Durst Workflow v1.8.2

Available in
Durst Workflow Print Label / Durst Workflow Print Label +
Durst Workflow Print / Durst Workflow Print +

The status of a motif within a Production Job can now be updated by using a PATCH request. Use this function to set the status of a motif from an external system.  The possible statuses depend on whether the original Motif is an Article (Article from Article List was assigned to a Production Job) or a Motif from a Print Order or Production Job. This can be determined from the new motifType attribute. The possible statuses for Articles are CREATED, CHECKED_IN, CHECK_REQUIRED, FINAL_ARTWORK, WAITING_FOR_APPROVAL, APPROVED and LOCKED as well as CREATED, CHECKED_IN, CHECK_REQUIRED, READY_FOR_PRINT, WAITING_FOR_APPROVAL, APPROVED, IMPOSED, SENT_TO_PRINTER, PRINTED and QUANTITY_REACHED for Motifs. These statuses are also synchronised with the underlying original document.

PATCH /api/v1/productionJobs/{id}/motifs/{id}

9.1. Parameters

Type
Name
Description
Schema
Path
id required
ID of the Production Job
integer (int32)
Path
id required
ID of the Motif
integer (int32)

9.2. Responses

HTTP Code Description Schema
200 OK MotifApi
204 No Content No Content
400 Bad Request Error Code
403 Forbidden No Content
404 Not Found No Content

9.3. Consumes

application/json

9.4. Produces

*/*

9.5. Tags

Production Job Motif Controller

9.6. Example HTTP request

Request path

/api/v1/productionJobs/{id}/motifs/{id}

Request Body

{
  "status": "WAITING_FOR_APPROVAL"
}

9.7. Example HTTP response

Response 200

{
  "externalId": "EXT-123",
  "name": "Print Item 1",
  "comment": "Comment",
  "widthMm": 210,
  "heightMm": 297,
  "pages": 1,
  "numberCopies": 23,
  "windingTypeKey": "INSIDE",
  "orientationTypeKey": "TOP",
  "colorPolicyReference": {
    "id": 1
  },
  "id": 11100,
  "status": "WAITING_FOR_APPROVAL",
  "motifType": "motif"
}
10. Create a Print Item and assign it to a Production Job

Compatibility: from Durst Workflow v1.7.8

Available in
Durst Workflow Print Label / Durst Workflow Print Label +
Durst Workflow Print / Durst Workflow Print +

Add a Print Item to an existing Production Job

POST /api/v1/productionJobs/{id}/motifs/create

10.1. Parameters

Type
Name
Description
Schema
Path id required
The ID of a Production Job integer (int32)
Body
motifApiCreate required
MotifApiCreate
MotifApiCreate

10.2. Responses

HTTP Code Description Schema
201 Created ProductionJobApi
401 Unauthorized No Content
403 Forbidden No Content
404 Not Found No Content

10.3. Consumes

application/json

10.4. Produces

*/*

10.5. Tags

Production Job Motif Controller

10.6. Example HTTP request

Request path

/api/v1/productionJobs/{id}/motifs/create

Request body

{
  "name": "New Print Item",
  "numberCopies": "43",
  "checkinTemplateGuid": "47e8e6c4-2ebc-412f-b427-e6393e66b67e",
  "pdfFileLink": {
    "externalId": "EXT-123",
    "uri": "https://domain.at/path/to/file.pdf"
  }
}

10.7. Example HTTP response

Response 201

{
  "id": 12026,
  "status": "CREATED",
  "name": "New Print Item",
  "colorPolicyReference": {
    "id": 5
  }
}
11. Fetch Output Templates

Compatibility: from Durst Workflow v1.8.1

Available in
Durst Workflow Print Label / Durst Workflow Print Label +
Durst Workflow Print / Durst Workflow Print +

List all available Output Templates.
Output Templates are created and managed in the Durst Workflow and can be used for creating a Production Job using the Rest-API.

GET /api/v1/outputTemplates

11.1. Parameters

Type
Name
Description
Schema
Body
OutputTemplateApi required
OutputTemplateApi
OutputTemplateApi

11.2. Responses

HTTP Code Description Schema
200 OK OutputTemplateApi
401 Unauthorized No Content
403 Forbidden No Content
404 Not Found No Content

11.3. Produces

*/*

11.4. Tags

Output Template Controller Api

11.5. Example HTTP request

Request path

/api/v1/outputTemplates

11.6. Example HTTP response

Response 200

[
  {
    "id": 1,
    "name": "Test Output Template"
  },
  {
    "id": 2,
    "name": "TAU 330 RSC Output"
  },
  {
    "id": 3,
    "name": "TAU 330 RSC Output Extreme Save"
  },
  {
    "id": 4,
    "name": "Rhotex with Simulation"
  }
]
12. Fetch Output Template details

Compatibility: from Durst Workflow v1.8.1

Available in
Durst Workflow Print Label / Durst Workflow Print Label +
Durst Workflow Print / Durst Workflow Print +

Fetch a specific Output Template.
Output Templates are created and managed in the Durst Workflow and can be used for creating a Production Job using the Rest-API.

GET /api/v1/outputTemplates/{id}

12.1. Parameters

Type
Name
Description
Schema
Body
OutputTemplateApi required
OutputTemplateApi
OutputTemplateApi
Path id required
The ID of the Impose Template
integer (int32)

12.2. Responses

HTTP Code Description Schema
200 OK OutputTemplateApi
401 Unauthorized No Content
403 Forbidden No Content
404 Not Found No Content

12.3. Produces

*/*

12.4. Tags

Output Template Controller Api

12.5. Example HTTP request

Request path

/api/v1/outputTemplates/{id}

12.6. Example HTTP response

Response 200

{
  "id": 3,
  "name": "TAU 330 RSC Output Extreme Save"
}
13. Fetch Impose Templates

Compatibility: from Durst Workflow v1.7.6

Available in
Durst Workflow Print Label / Durst Workflow Print Label +
Durst Workflow Print / Durst Workflow Print +

Impose Templates are created and stored in the Durst Workflow and can be used to impose print data for a Production Job via the API. The IDs of the available Templates are listed in the Durst Workflow under User Settings.

GET /api/v1/impose/templates

13.1. Parameters

Type
Name
Description
Schema
Body
ImposeRequestOptionsApi required
ImposeRequestOptionsApi
ImposeRequestOptionsApi
Body
ReferencedImposeTemplateApi required
ReferencedImposeTemplateApi
ReferencedImposeTemplateApi

13.2. Responses

HTTP Code Description Schema
200 OK ImposeTemplateApi
401 Unauthorized No Content
403 Forbidden No Content
404 Not Found No Content

13.3. Produces

*/*

13.4. Tags

Impose Template Controller Api

13.5. Example HTTP request

Request path

/api/v1/impose/templates

13.6. Example HTTP response

Response 200

[
  {
    "id": 1,
    "name": "Default Template",
    "type": "STEP_AND_REPEAT",
    "defaultTemplate": true
  },
  {
    "id": 2,
    "name": "Default Template Nesting",
    "type": "NESTING",
    "defaultTemplate": true
  },
  {
    "id": 3,
    "name": "Default Tiling",
    "type": "TILING",
    "defaultTemplate": true
  }
]
14. Fetch Impose Template details

Compatibility: from Durst Workflow v1.7.6

Available in
Durst Workflow Print Label / Durst Workflow Print Label +
Durst Workflow Print / Durst Workflow Print +

Impose Templates are created and stored in the Durst Workflow and can be used to impose print data for a Production Job via the API. The IDs of the available Templates are listed in the Durst Workflow under User Settings.

GET /api/v1/impose/templates/{id}

14.1. Parameters

Type
Name
Description
Schema
Body
ImposeRequestOptionsApi required
ImposeRequestOptionsApi
ImposeRequestOptionsApi
Body
ReferencedImposeTemplateApi required
ReferencedImposeTemplateApi
ReferencedImposeTemplateApi
Path id required
The ID of the Impose Template
integer (int32)

14.2. Responses

HTTP Code Description Schema
200 OK ImposeTemplateApi
401 Unauthorized No Content
403 Forbidden No Content
404 Not Found No Content

14.3. Produces

*/*

14.4. Tags

Impose Template Controller Api

14.5. Example HTTP request

Request path

/api/v1/impose/templates/{id}

14.6. Example HTTP response

Response 200

{
  "id": 22,
  "name": "My Impose Template",
  "type": "STEP_AND_REPEAT",
  "defaultTemplate": false
}
15. Fetch Sheet Templates

Compatibility: from Durst Workflow v1.11.1

Available in
Durst Workflow Print Label / Durst Workflow Print Label +
Durst Workflow Print / Durst Workflow Print +

Sheet Templates are created and stored in the Durst Workflow in the Impose Editor and can be used to impose print data for a Production Job via the API with a certain Sheet definition. The IDs of the available Templates are listed in the Durst Workflow under User Settings.

GET /api/v1/impose/sheetTemplates

15.1. Parameters

Type
Name
Description
Schema
Body
ImposeSheetTemplateApi required
ImposeSheetTemplateApi
ImposeSheetTemplateAPI

15.2. Responses

HTTP Code Description Schema
200 OK ImposeSheetTemplateApi
401 Unauthorized No Content
403 Forbidden No Content
404 Not Found No Content

15.3. Produces

*/*

15.4. Tags

Impose Template Controller Api

15.5. Example HTTP request

Request path

/api/v1/impose/sheetTemplates

15.6. Example HTTP response

Response 200

[
  {
    "id": 1,
    "name": "Default"
  },
  {
    "id": 11,
    "name": "All color bars Template"
  },
  {
    "id": 21,
    "name": "SmartMarks Sheet Template"
  }
]
16. Fetch Sheet Template details

Compatibility: from Durst Workflow v1.11.1

Available in
Durst Workflow Print Label / Durst Workflow Print Label +
Durst Workflow Print / Durst Workflow Print +

Sheet Templates are created and stored in the Durst Workflow in the Impose Editor and can be used to impose print data for a Production Job via the API with a certain Sheet definition. The IDs of the available Templates are listed in the Durst Workflow under User Settings..

GET /api/v1/impose/sheetTemplates/{id}

16.1. Parameters

Type
Name
Description
Schema
Body
ImposeSheetTemplateApi required
ImposeSheetTemplateApi
ImposeSheetTemplateApi
Path id required
The ID of the Sheet Template
integer (int32)

16.2. Responses

HTTP Code Description Schema
200 OK ImposeSheetTemplateApi
401 Unauthorized No Content
403 Forbidden No Content
404 Not Found No Content

16.3. Produces

*/*

16.4. Tags

Impose Template Controller Api

16.5. Example HTTP request

Request path

/api/v1/impose/sheetTemplates/{id}

16.6. Example HTTP response

Response 200

{
  "id": 21,
  "name": "SmartMarks Sheet Template"
}
17. Fetch Plate Templates

Compatibility: from Durst Workflow v1.11.1

Available in
Durst Workflow Print Label / Durst Workflow Print Label +
Durst Workflow Print / Durst Workflow Print +

Plate Templates are created and stored in the Durst Workflow inside Impose editor and can be used to impose print data for a Production Job via the API with additional Plate settings. The IDs of the available Templates are listed in the Durst Workflow under User Settings.

GET /api/v1/impose/plateTemplates

17.1. Parameters

Type
Name
Description
Schema
Body
ImposePlateTemplateApi required
ImposePlateTemplateApi
ImposePlateTemplateApi

17.2. Responses

HTTP Code Description Schema
200 OK ImposePlateTemplateApi
401 Unauthorized No Content
403 Forbidden No Content
404 Not Found No Content

17.3. Produces

*/*

17.4. Tags

Impose Template Controller Api

17.5. Example HTTP request

Request path

/api/v1/impose/plateTemplates

17.6. Example HTTP response

Response 200

[
  {
    "id": 13,
    "name": "Offsetplatte Template",
    "comment": "Comment"
  },
  {
    "id": 26,
    "name": "Platte 600 x 600 | CMYKcm Channels | ColPol & PJ Name"
  }
]
18. Fetch Plate Template details

Compatibility: from Durst Workflow v1.11.1

Available in
Durst Workflow Print Label / Durst Workflow Print Label +
Durst Workflow Print / Durst Workflow Print +

Plate Templates are created and stored in the Durst Workflow inside Impose editor and can be used to impose print data for a Production Job via the API with additional Plate settings. The IDs of the available Templates are listed in the Durst Workflow under User Settings.

GET /api/v1/impose/plateTemplates/{id}

18.1. Parameters

Type
Name
Description
Schema
Body
ImposePlateTemplateApi required
ImposePlateTemplateApi
ImposePlateTemplateApi
Path id required
The ID of the Plate Template
integer (int32)

18.2. Responses

HTTP Code Description Schema
200 OK ImposeTemplateApi
401 Unauthorized No Content
403 Forbidden No Content
404 Not Found No Content

18.3. Produces

*/*

18.4. Tags

Impose Template Controller Api

18.5. Example HTTP request

Request path

/api/v1/impose/plateTemplates/{id}

18.6. Example HTTP response

Response 200

{
  "id": 13,
  "name": "Offsetplatte Template",
  "comment": "123"
}
19. Fetch Print Item Templates

Compatibility: from Durst Workflow v1.11.1

Available in
Durst Workflow Print Label / Durst Workflow Print Label +
Durst Workflow Print / Durst Workflow Print +

Print Item (Motif) Templates are created and stored in the Durst Workflow inside Impose editor and can be used to impose print data for a Production Job via the API with additional Plate settings. The IDs of the available Templates are listed in the Durst Workflow under User Settings.

GET /api/v1/impose/motifTemplates

19.1. Parameters

Type
Name
Description
Schema
Body
ImposeMotifTemplateApi required
ImposeMotifTemplateApi ImposeMotifTemplateApi

19.2. Responses

HTTP Code Description Schema
200 OK ImposeMotifTemplateApi
401 Unauthorized No Content
403 Forbidden No Content
404 Not Found No Content

19.3. Produces

*/*

19.4. Tags

Impose Template Controller Api

19.5. Example HTTP request

Request path

/api/v1/impose/motifTemplates

19.6. Example HTTP response

Response 200

[
  {
    "id": 1,
    "name": "Default",
    "type": "DEFAULT"
  },
  {
    "id": 2,
    "name": "Default Double-Sided Output",
    "type": "DOUBLEPAGE"
  }
]
20. Fetch Print Item Template details

Compatibility: from Durst Workflow v1.11.1

Available in
Durst Workflow Print Label / Durst Workflow Print Label +
Durst Workflow Print / Durst Workflow Print +

Print Item (Motif) Templates are created and stored in the Durst Workflow inside Impose editor and can be used to impose print data for a Production Job via the API with additional Plate settings. The IDs of the available Templates are listed in the Durst Workflow under User Settings.

GET /api/v1/impose/motifTemplates/{id}

20.1. Parameters

Type
Name
Description
Schema
Body
ImposeMotifTemplateApi required
ImposeMotifTemplateApi
ImposeMotifTemplateApi
Path id required
The ID of the motifTemplate
integer (int32)

20.2. Responses

HTTP Code Description Schema
200 OK ImposeMotifTemplateApi
401 Unauthorized No Content
403 Forbidden No Content
404 Not Found No Content

20.3. Produces

*/*

20.4. Tags

Impose Template Controller Api

20.5. Example HTTP request

Request path

/api/v1/impose/motifTemplates/{id}

20.6. Example HTTP response

Response 200

{
  "id": 2,
  "name": "Default Double-Sided Output",
  "type": "DOUBLEPAGE"
}
21. Impose a Production Job using an Impose Template

Compatibility: from Durst Workflow v1.7.6

Available in
Durst Workflow Print Label / Durst Workflow Print Label +
Durst Workflow Print / Durst Workflow Print +

Apply an Impose Template to a Production Job.

Step and Repeat Templates can only be applied to a Production Job if all Print Items have the same size.

POST /api/v1/productionJobs/{id}/impose

21.1. Parameters

Type
Name
Description
Schema
Body
ImposeRequestOptionsApi required
ImposeRequestOptionsApi
ImposeRequestOptionsApi
Body
ReferencedImposeTemplateApi required
ReferencedImposeTemplateApi
ReferencedImposeTemplateApi
Path id required
The ID of the Production Job
integer (int32)

21.2. Responses

HTTP Code Description Schema
200 OK WorkflowControllerApi
401 Unauthorized No Content
403 Forbidden No Content
404 Not Found No Content

21.3. Consumes

application/json

21.4. Produces

*/*

21.5. Tags

Production Job Controller Api

21.6. Example HTTP request

Request path

/api/v1/productionJobs/{id}/impose

Request body

{
  "referencedImposeTemplateApi": {
    "id": 22
  }
}

21.6.1. Example HTTP response

Response 200

{
  "id": 1322,
  "status": "IMPOSED",
  "name": "Production",
  "shippingDate": "2021-12-10",
  "productionDate": "2021-08-19T13:37:00Z",
  "motifs": [
    {
      "name": "Print Item 1",
      "widthMm": 145,
      "heightMm": 170,
      "pages": 1,
      "numberCopies": 27,
      "colorPolicyReference": {
        "id": 4
      },
      "id": 28237,
      "status": "IMPOSED",
      "motifType": "motif",
      "dropdown": "Option2",
      "additionalinfo": "Lorem ipsum dolor sit amet"
    }
  ],
  "colorPolicyReference": {
    "id": 4
  },
  "substrateShapeReference": {
    "id": 8
  }
}
22. Impose a Production Job using Impose/Sheet/Plate/Motif Templates

Compatibility: from Durst Workflow v1.11.1

Available in
Durst Workflow Print Label / Durst Workflow Print Label +
Durst Workflow Print / Durst Workflow Print +

Apply an Impose Template to a Production Job.

Plate, Sheet and Motif Templates are optional. If just the Impose Template is used their defaults are used for Imposition.

POST /api/v1/productionJobs/{id}/impose

22.1. Parameters

Type
Name
Description
Schema
Body
ImposeRequestOptionsApi required
ImposeRequestOptionsApi
ImposeRequestOptionsApi
Body
ReferencedImposeTemplateApi required
ReferencedImposeTemplateApi
ReferencedImposeTemplateApi
Body
ReferencedPlateTemplateApi optional

Body
ReferencedSheetTemplateApi optional

Body
ReferencedMotifTemplateApi optional

Path id required
The ID of the Production Job
integer (int32)

22.2. Responses

HTTP Code Description Schema
200 OK WorkflowControllerApi
401 Unauthorized No Content
403 Forbidden No Content
404 Not Found No Content

22.3. Consumes

application/json

22.4. Produces

*/*

22.5. Tags

Production Job Controller Api

22.6. Example HTTP request

Request path

/api/v1/productionJobs/{id}/impose

Request body

{
  "referencedImposeTemplateApi": {
    "id": 12
  },
  "referencedImposePlateTemplateApi": {
    "id": 25
  },
  "referencedImposeSheetTemplateApi": {
    "id": 5
  },
  "referencedImposeMotifTemplateApi": {
    "id": 3
  }
}

22.6.1. Example HTTP response

Response 200

{
  "id": 1322,
  "status": "IMPOSED",
  "name": "Production",
  "shippingDate": "2021-12-10",
  "productionDate": "2021-08-19T13:37:00Z",
  "motifs": [
    {
      "name": "Print Item 1",
      "widthMm": 145,
      "heightMm": 170,
      "pages": 1,
      "numberCopies": 27,
      "colorPolicyReference": {
        "id": 4
      },
      "id": 28237,
      "status": "IMPOSED",
      "motifType": "motif",
      "dropdown": "Option2",
      "additionalinfo": "Lorem ipsum dolor sit amet"
    }
  ],
  "colorPolicyReference": {
    "id": 4
  },
  "substrateShapeReference": {
    "id": 8
  }
}
23. Fetch Thumbnail or PDF Preview of a Production Job.

Compatibility: from Durst Workflow v1.7.6

Available in
Durst Workflow Print Label / Durst Workflow Print Label +
Durst Workflow Print / Durst Workflow Print +

Fetch a Thumbnail or PDF Preview of a Production Job. The Print Item that is checked in first is used for the preview unless the Production Job is Imposed. Available Download Formats are Direct Download or Base64 encrypted.

GET /api/v1/productionJobs/{id}/files/{fileTypeKey}/{downloadFormat}

23.1. Parameters

Type
Name
Description
Schema
Path id required
The id of the Production Job
int32 (integer)
Path
downloadFormat required
Download Format of the files
enum (direct, base64)
Path
fileTypeKey required
File Type
enum (thumbnail, pdf)

23.2. Responses

HTTP Code Description Schema
200 OK Download of the File
401 Unauthorized No Content
403 Forbidden No Content
404 Not Found No Content

23.3. Produces

*/*

23.4. Tags

Production Job Controller Api

23.5. Example HTTP request

Request path

/api/v1/productionJobs/{id}/files/{fileTypeKey}/{downloadFormat}
24. Send to Printer

Compatibility: from Durst Workflow v1.7.3

Available in
Durst Workflow Print Label / Durst Workflow Print Label +
Durst Workflow Print / Durst Workflow Print +

Send the Production Job to the Printer

GET /api/v1/productionJobs/{id}/sendToPrinter

24.1. Parameters

Type
Name
Description
Schema
Path
id required
The ID of the Production Job integer (int32)

24.2. Responses

HTTP Code Description Schema
200 OK ProductionJobApi
401 Unauthorized No Content
403 Forbidden No Content
404 Not Found No Content

24.3. Consumes

application/json

24.4. Produces

*/*

24.5. Tags

Production Job Controller Api

24.6. Example HTTP request

Request path

/api/v1/productionJobs/{id}/sendToPrinter

24.6.1. Example HTTP response

Response 200

{
  "id": 1361,
  "externalId": "EXTNR123",
  "status": "OUTPUT_CONFIG_ASSIGNED",
  "name": "API Test Production Job 3 Items",
  "comment": "Further Information of Production Job",
  "shippingDate": "2019-12-10",
  "productionDate": "2020-01-21T13:37:00Z",
  "colorPolicyReference": {
    "id": 61
  },
  "substrateShapeReference": {
    "id": 12
  },
  "motifs": [
    {
      "id": 7044,
      "externalId": "EXT-123",
      "status": "READY_FOR_PRINT",
      "name": "Print Item 3",
      "comment": "Comment on Print Item 3",
      "widthMm": 66,
      "heightMm": 136,
      "pages": 2,
      "numberCopies": 81,
      "orientationTypeKey": "TOP",
      "colorPolicyReference": {
        "id": 61
      },
      "additionalFilesList": []
    },
    {
      "id": 7043,
      "externalId": "EXT-123",
      "status": "READY_FOR_PRINT",
      "name": "Print Item 2",
      "comment": "Comment on Print Item 2",
      "widthMm": 50,
      "heightMm": 130,
      "pages": 1,
      "numberCopies": 12,
      "colorPolicyReference": {
        "id": 61
      },
      "additionalFilesList": []
    },
    {
      "id": 7042,
      "externalId": "EXT-123",
      "status": "READY_FOR_PRINT",
      "name": "Print Item 1",
      "comment": "Comment on Print Item 1",
      "widthMm": 61.383,
      "heightMm": 145.034,
      "pages": 1,
      "numberCopies": 72,
      "windingTypeKey": "INSIDE",
      "orientationTypeKey": "TOP",
      "colorPolicyReference": {
        "id": 61
      },
      "additionalFilesList": []
    }
  ]
}
Previous Article 2.5 Print Orders, Print Order Items and Print Items
Next Article 2.7 Substrates
Still Need Help? Contact Us