Using the wizard for PDF/VT or AFP files

Note: The option to use AFP input is included only in the Enterprise edition of OL Connect.

AFP input is dependent on a third party library (CDP), which allows OL Connect to run up to 4 AFP input processes on a given machine, at any given time. This license requires a stable MAC address, and therefore AFP input is not compatible with virtual servers or cloud environments that cannot provide a network interface with a stable MAC address.

The pages in PDF/VT and AFP files can be grouped on several levels. Additional information, such as TLEs (a TLE is a Tagged Logical Element) in AFP files, can be attached to each level in the structure. The structure and additional information are stored in the file's metadata.

The DataMapper wizard for PDF/VT and AFP files lets you select a level to trigger the start of a new record and it also enables you to extract the additional information from the metadata. You can extract data from the content afterwards.

Tip: How to extract information from the metadata in the extraction workflow itself is explained in: Extracting metadata.

If the data file doesn't contain any metadata, each page is a new record - in other words, a boundary is set at the start of a new page -, which is exactly what happens when you open the file without a wizard.

You can open a PDF/VT or AFP file with a wizard using the Welcome screen or the File menu.

  • From the Welcome screen

    1. Open the OL ConnectWelcome page by clicking the icon at the top right or select the Help menu and then Welcome.

    2. Click New at the left.

    3. Click Data at the right and select PDF/VT or AFP.

    4. Click the Browse button and open the PDF/VT or AFP file you want to work with. Click Next.

  • From the File menu

    1. In the menu, click File > New.

    2. Click the Data mapping Wizards drop-down and select From PDF/VT or AFP.

    3. Click Next.

    4. Click the Browse button and open the PDF/VT or AFP file you want to work with. Click Next.

After selecting the file, select the following options in the Metadata page:

  • Metadata record levels: Use the drop-down to select what level in the metadata defines a record.

  • Field List: This list displays all fields on the chosen level and higher levels in the PDF/VT or AFP metadata. The right column shows the field name. The left column displays the level on which it is located. Check any field to add it to the extraction.

Note: NOP (No Operation) records in AFP files cannot be extracted.

Click Finish to close the dialog and open the actual Data Mapping configuration.
On the Settings pane, you will see that the boundary trigger is set to On metadata. The selected metadata fields are added to the Data Model.

Note: Extracting data from a PDF that comes from a Windows printer queue (a PDF converted to PostScript, converted back to PDF by an Input task in Workflow) might not work (see the Connect Knowledge Base.)
The rule of thumb is: if copy-paste from Acrobat works, so will data mapping; if not, the DataMapper won't either.

Note: Rotated pages in a PDF are supported (if rotated 0/90/180/270 degrees). The Extract step will be able to extract data from horizontal and vertical lines of text on rotated pages. Motion steps (such as the Repeat step and the Goto step) however, can only work as expected if text on a page has the same orientation as the page, not when text has been rotated after the page was rotated.
The page number and rotation of a page are shown in the status bar at the bottom, next to the region selection information.