User Manual

2.13 Fetching Preflight Results

Updated on

The Preflight Results show predefined Errors and Warnings of an Article or Print Item within a Print Order or Production Job depending on the Preflight Check configured and used in the Durst Workflow. These results can be retrieved for Articles and Print Items and stored in a MIS/ERP system, so that operators of connected systems can obtain appropriate information on customer Print Data. In case of errors it is therefore possible to correct them (e.g. by applying a Fixup) or to ask the customer for revised Print Data.

1. Fetching Preflight Results of an Article

Compatibility: from Durst Workflow v1.8

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

Fetch Preflight Results of an Article

GET /api/v1/articles/{id}/preflightResult?severity=

1.1. Parameters

Type Name Description Schema
Path id required The id of the Article integer (int32)
Query severity optional The severity of the Validation INFO, ERROR, WARNING

The severity Query is optional. If you don't add severity to the path all validation results will be shown.

1.2. Responses

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

1.3. Consumes 

application/json

1.4. Produces 

*/*

1.5. Tags

Article Controller Api

1.6. Example HTTP request 

/api/v1/articles/10048/preflightResult?severity=ERROR

1.6.1. Example HTTP response

Response 200

{
  "validationResults": [
    {
      "severity": "ERROR",
      "message": "White text is not set to knockout",
      "comment": "White objects should be set to knockout, otherwise they may simply disappear when the PDF is printed. This check lists text objects inside the TrimBox using white which are set to overprint."
    },
    {
      "severity": "ERROR",
      "message": "Font is not embedded",
      "comment": "Used Font is not embedded and is missing."
    }
  ]
}

1.7. Example HTTP request 

/api/v1/articles/2147/preflightResult

1.8. Example HTTP response

Response 200

{
  "validationResults": [
    {
      "severity": "INFO",
      "message": "Text less than 10000pt",
      "comment": "1000"
    },
    {
      "severity": "WARNING",
      "message": "Effective Text x-height is below 1.2 mm",
      "comment": "Some EU regulations for food packaging require that the x-height (the size of a small character without ascender) of all mandatory text information is at least 1.2 mm. This applies only to packaging that has 80 cm^2 or more, otherwise the effective x-height has to be at least 0.9. (REGULATION (EU) No 1169/2011 OF THE EUROPEAN PARLIAMENT AND OF THE COUNCIL of 25 October 2011, Article 13)"
    },
    {
      "severity": "ERROR",
      "message": "White text is not set to knockout",
      "comment": "White objects should be set to knockout, otherwise they may simply disappear when the PDF is printed. This check lists text objects inside the TrimBox using white which are set to overprint."
    },
    {
      "severity": "INFO",
      "message": "[PAGE_SIZE_NOT_MM] [E] Page size not 210 x 297 mm",
      "comment": " "
    },
    {
      "severity": "INFO",
      "message": "[GET_PAGE_COUNT] [I] Number of Pages",
      "comment": "PDF contains more than 0 pages\n"
    },
    {
      "severity": "INFO",
      "message": "White line is thinner than10000",
      "comment": "thickest line width (White)"
    },
    {
      "severity": "INFO",
      "message": "White text smaller than",
      "comment": "Identifies white text with a size of less than 10 pt within the BleedBox. Small white text in front of a color object may cause registration problems on a printing press. "
    },
    {
      "severity": "INFO",
      "message": "[MAX_XHEIGHT] Highest effective text x-height is below 1000",
      "comment": "The x-height is the effective height of the lower case character x in mm."
    },
    {
      "severity": "INFO",
      "message": "Rendering Intent used",
      "comment": "Rendering Intent used"
    },
    {
      "severity": "ERROR",
      "message": "Font is not embedded",
      "comment": "Used Font is not embedded and is missing."
    },
    {
      "severity": "WARNING",
      "message": "Registration Color used",
      "comment": "Registration color is typically used for print elements like crop and registration marks. The registration color prints on all separations, printing the maximum total ink coverage for the selected printer."
    }
  ]
}
2. Fetching Preflight Results of a Print Item within a Print Order

Compatibility: from Durst Workflow v1.8

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

Fetch Preflight Results of a Print Item within a Print Order

GET /api/v1/printOrders/{id}/printOrderItems/{printOrderItemId}/motifs/{motifId}/preflightResult

2.1. Parameters

Type Name Description Schema
Path id required The id of the Print Order integer (int32)
Path
 printOrderItemId required
 The id of the Print Order Item integer (int32)
Path
 motifId required
 The id of the Motif/Print Item  integer (int32)
Query severity optional The severity of the Validation INFO, ERROR, WARNING

The severity Query is optional. If you don't add severity to the path all validation results will be shown.

2.2. Responses

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

2.3. Consumes 

application/json

2.4. Produces 

*/*

2.5. Tags

Print Order Motif Controller Api

2.6. Example HTTP request 

/api/v1/printOrders/291/printOrderItems/486/motifs/9841/preflightResult?severity=INFO

2.6.1. Example HTTP response

Response 200

{
  "validationResults": [
    {
      "severity": "INFO",
      "message": "Image resolution less than",
      "comment": "largest image resolution"
    },
    {
      "severity": "INFO",
      "message": "[PAGE_SIZE_NOT_MM] [E] Page size not 210 x 297 mm (Kopie 1)",
      "comment": " "
    },
    {
      "severity": "INFO",
      "message": "[GET_PAGE_COUNT] [I] Number of Pages  (Kopie 1)",
      "comment": "PDF contains more than 0 pages\n"
    },
    {
      "severity": "INFO",
      "message": "White line is thinner than10000",
      "comment": "thickest line width (White)"
    },
    {
      "severity": "INFO",
      "message": "Rendering Intent used",
      "comment": "Rendering Intent used"
    },
    {
      "severity": "INFO",
      "message": "[ALL_SPOT_COLOR_OBJECTS]Object is defined as a Spot Color",
      "comment": "Object is defined in a spot color"
    }
  ]
}
3. Fetching Preflight Results of a Print Item within a Production Job

Compatibility: from Durst Workflow v1.8

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

Fetch Preflight Results of a Print Item within a Print Order

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

3.1. Parameters

Type Name Description Schema
Path id required The id of the Production Job integer (int32)
Path
 motifId required
 The id of the Motif/Print Item  integer (int32)
Query severity optional The severity of the Validation INFO, ERROR, WARNING

The severity Query is optional. If you don't add severity to the path all validation results will be shown.

3.2. Responses

HTTP Code Description Schema
200 OK ValidationResultApi
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 Motif Controller Api

3.6. Example HTTP request 

/api/v1/productionJobs/207/motifs/8061/preflightResult

3.6.1. Example HTTP response

Response 200

{
  "validationResults": [
    {
      "severity": "INFO",
      "message": "[HIGHEST_TEXTSIZE] [I] Text kleiner als 10000pt",
      "comment": "1000"
    },
    {
      "severity": "INFO",
      "message": "[GET_PAGE_COUNT] [I] Number of Pages ",
      "comment": "PDF contains more than 0 pages\n"
    },
    {
      "severity": "INFO",
      "message": "[WHITE_LINE_THINNER_THAN] [I] White line thinner than 10000pt",
      "comment": ""
    },
    {
      "severity": "INFO",
      "message": "[RENDERING_INTENT_USED] Rendering Intent is used",
      "comment": "Which Rendering Intent Saturation is used"
    },
    {
      "severity": "INFO",
      "message": "[ALL_SPOT_COLOR_OBJECTS] Object is defined in a spot color",
      "comment": "Object is defined in a spot color"
    },
    {
      "severity": "INFO",
      "message": "[IS_LINEART_OVERPRINT]",
      "comment": ""
    }
  ]
}
Previous Article 2.12 Generating Reports
Next Article 2.14 Splitting Documents

Automation

1. Integration Possibilities 1
2. Rest API Documentation – Workflow 18
3. Rest API Documentation – Durst Analytics 10

Other Resources
Print Article
Still Need Help? Contact Us