This Specification Task will add a page numbering stamp to a PDF file.
| Property Name | Description |
|---|---|
| Title | Changes the Title (not the name) of the task. |
| PDF File | The path to the PDF file to add page stamps.
Relative paths are resolved to the Specification directory if no prefix is defined. Accepted prefixes: <Project>, <Specification>, <SpecificationMetadata>, <GroupContent> |
| Page Range | Use '*' or leave empty to select all pages.
Also accepts pipebar delimited list of page numbers, e.g. '1|2|3', or a range using a hyphen, e.g. '1-3'. |
| Stamp Schema | Define the Stamp name schema.
Provide a string and use arguments: '{0}' for the page number and '{1}' for the total page count. Leaving this field blank will default to page number. |
| Stamp Position | Pipebar delimited a list of stamp positions on the page in the following order: vertical|horizontal.
The vertical position accepts following values: Top, Center or Bottom. The horizontal position supports: Left, Center and Right. Leaving this field empty will default to 'Bottom|Right'. |
| Stamp Margins | Pipebar delimited list of page margins in following order: Top|Right|Bottom|Left.
Leave this field empty will default to '15|15|15|15' margins. |
| Stamp Font | Specifies the font used to create page stamps within the PDF document.
For example: 'font-family: bell mt; font-size: 14.25pt; font-style: italic; text-decoration: underline'. |
| Stamp Color | Color name, hex or RGB codes. Leave empty to use black. |
| Stamp Page Offset | The stamp starting page number.
Changing this value from 1 will amend the stamp text, for example changing this value to 0 will result in page stamp text showing 0 for the first document page. |
When this Task is added the properties are static. To be able to build rules on a static property see How To: Change A Static Property To A Dynamic Property.
| Property Name | Example Rule | Meaning |
|---|---|---|
| PDF File | D:\DriveWorks\ProductGuide.pdf | Will add page stamps to the ProductGuide.pdf document. |
| Page Range | 2|3|4|5 | Will add page stamps to pages 2 to 5 (omitting the first page). |
| Stamp Schema | {0} of {1} | The page stamp include the page number, the word of and the total number of pages on each page.
For example: 2 of 5 3 of 5 |
| Stamp Position | Bottom|Left | Will place the stamp at the foot of the page (bottom) in the left position. |
| Stamp Margins | 15|15|10|20 | Will position the page stamp within the margins corresponding to the Stamp Position property values used.
For example, with the Stamp Position property of Bottom|Left the margin values 10|20 will be used. |
| Stamp Font | "font-family: microsoft sans serif; font-size: 9pt; font-weight: bold; text-decoration: underline" | Will use this font for the page stamp.
The full font declaration is not needed, to only change the size of font from the document default just use: font-size: 9pt; |
| Stamp Color | Blue | Will use blue as the page stamp font color. |
| Stamp Page Offset | 1 | Will use the number 1 for the first page. |
This task has different types of Outputs. For more information about Outputs see Specification Macros Task Node.
Outputs are only available within Specification Macros. Currently Outputs are not available for Specification Flow.
This task supports Status Outputs. These can be used to perform different actions depending on what the status outcome of the task is. For more information see Status Outputs in the Task Node Outputs section of Specification Macros Task Node.
The status output navigation is as follows:
Success
Success with Warnings
Failed