1 PrintData element
Data elements that point to locations used for the actual printing process. Data elements will be wrapped in a group to aggregate certain elements. This can be used to assign multiple orders of the same article to the appropriate print data. Usually the format is an Uri which will be downloaded asynchronously after the order call has been placed.
1.1 Elements
| Name | Type | Datatype | Example | Default | Description |
|---|
| DataGroup
| required
| list of elements
| -
| -
| Holding the grouped data items.
|
1.1.1 DataGroup Elements
| Name | Type | Datatype | Example | Default | Description |
|---|
| GroupName
| optional
| string
| -
| -
| Optional element to describe the group. Will later be attached to the actual filename on the server. If this element is omitted a numeric index will be used.
|
| FitMethod
| optional
| string
| None;Meet;Meet,OrientateWest
| None
| Optional element that can be used to preprocess print documents to meet the required dimensions. This element can combine several values which must be separated by a comma. For example combining Zooming and Orientation(West) will result in a value like: Meet,OrientateWest. This feature is only available for PDF files right now.
|
| | None: This is the default behaviour and will leave the data files untouched.
|
| | Meet: Will process the source data according to the target dimensions as specified in the Article element. Aspect ratio will be maintained and no clipping will occur, so that at least two sides of the source document bounds rectangle will meet the required target dimensions. If the source document aspect ratio differs from the target's aspect ratio, the source document will be aligned in the center of the target document.
|
| | OrientateEast: The document will be rotated 90° clockwise. This can be used to fix document orientation issues, when a Landscape document should be used to target Portrait dimensions.
|
| | OrientateWest: The document will be rotated 90° counterclockwise. This can be used to fix document orientation issues, when a Landscape document should be used to target Portrait dimensions.
|
| | OrientateSouth: The document will be rotated 180° counterclockwise. This can be used to flip the document upside down. Notice that the document will not be mirrored.
|
| Items
| required
| list of elements
| http://www.delivergo.com/ThisNeedsToBePrinted.pdf
| -
| Holding the actual targets to the data files wrapped in string elements.
|
1.2 Example
XML:
<PrintData>
<DataGroup>
<GroupName>First</GroupName>
<Items>
<string>http://www.delivergo.com/ThisNeedsToBePrinted.pdf</string>
<string>http://www.delivergo.com/ThisNeedsToBePrintedToo.jpg</string>
</Items>
</DataGroup>
<DataGroup>
<GroupName>Second</GroupName>
<Items>
<string>http://www.delivergo.com/ThatNeedsToBePrinted.pdf</string>
<string>http://www.delivergo.com/ThatNeedsToBePrintedToo.jpg</string>
</Items>
</DataGroup>
</PrintData>
JSON:
"PrintData": [
{
"GroupName": "First",
"Items": [
"http://www.delivergo.com/ThisNeedsToBePrinted.pdf",
"http://www.delivergo.com/ThisNeedsToBePrintedToo.jpg"
]
},
{
"GroupName": "Second",
"Items": [
"http://www.delivergo.com/ThatNeedsToBePrinted.pdf",
"http://www.delivergo.com/ThatNeedsToBePrintedToo.jpg"
]
}
]