Rotate PDF Content

4 minute read Last updated on June 22, 2021

Rotate PDF Content Node

Note: This node works with PDF files (version 1.3 or later).

The Rotate PDF Pages Node is a process node that can be used to rotate the content of pages in a PDF document. Use the node’s setting window to specify which pages are rotated and the rotation angle that should be applied.

Using the Rotate PDF Content Node

Add the Rotate PDF Pages Node to the workflow by dragging the node’s icon onto the Workflow Builder canvas, and then double-clicking on the icon to open the Rotate PDF Pages Node’s window:

Rotate PDF Content Node

  • Select the Enabled checkbox so that the process will run. When unchecked, this process is ignored. Documents pass through as if the node were not present (i.e., continue along the default or positive path). Note that a disabled node will not check for logic or error conditions.
  • In the Node Name field, enter a meaningful name for the Shift PDF Pages Node.
  • In the Description field, enter a description for the Shift PDF Pages. This is not required, but can be helpful with multiple collection points. If the description is long, hover the mouse over the field to read its entire contents.
  • Select the Save button to apply the settings. Select the Cancel button to exit the window without saving any changes.
  • Select the Help button to access online help.

Page Filter

In this panel, specify the pages to be rotated, based on ordinance, ranges, or per-document metadata properties.

Rotate PDF Content Node

  • Page Filter: Choose one of the pre-defined page filters from the drop-down menu. The supported options are: All, First, Last, Odd, Even, and Custom.

    Rotate PDF Content Node

    If Custom is chosen, the Page Range input field appears. Use the field to enter a custom range of page numbers. Both comma-separated values and ranges (e.g., 3-5 instead of 3,4,5) are accepted. A maximum of 100 characters may be entered in the field.

    Note: The page number must not be greater than 2147483647.

  • Page Filter from Metadata: Use this option to select pages to process based on document-level metadata. Click on the Metadata Button (see below) to open the metadata browser.

    Note: The result of the entered metadata expression must be a Custom Page Filter (see above), i.e. a string containing one or more comma-separated, single page numbers (e.g. 2) or page ranges (e.g. 3-5).

  • Metadata Button: Click to open a Metadata browser window. Either a metadata key or a custom string value may be entered. To select a metadata key, double-click on it, and then click on the Select button to apply the metadata key.

    All Metadata syntax specified in the Help topic Metadata Reference Information may be used. For example, if there are multiple document-level values containing page numbers for the metadata key {data:page}, use {data:page[]|,} as the page filter from metadata to concatenate them with commas in order to generate a valid page filter. For a single value, use {data:page[]}.

Rotation Angle

In this panel, the rotation angle may be entered using fixed values or by using metadata.

Rotate PDF Content Node

  • Fixed Angle: Enter the new rotation angle the node will apply to pages. Use positive values to rotate the page to the right, and negative values to rotate the page to the left.

    Note: The Rotate PDF Content Node only rotates the page contents but does not change the page dimensions.

    Note: The entered rotation angle is not limited to a specific range, but will always be taken as modulo 360.

  • Angle from Metadata: Click this button to open a metadata browser window. In it, select a metadata key by double-clicking on it, or type in a custom string. The metadata information will then define the rotation angle of the pages (as described in the Fixed Angle section above). Only page-level metadata may be used.

    If incorrect metadata is selected or entered manually, the workflow will still run, but the pages will not be rotated. In such cases, a warning/error message is added to the Dispatcher Phoenix’s error log.