2023.1:PDF Data Mapping (Behavior)

2021	This article is in development for the upcoming version of Grooper, Grooper 2021. PDF Generate is a new Content Type Behavior option in 2021. This information is incomplete and/or may change by the time of release.

PDF Generate' is a Content Type 'Behavior' designed to create an exportable PDF file using the classification and extraction content of a Batch Folder. This includes capabilities to export extracted data as PDF metadata, inserting bookmarks, and creating PDF annotations, such as highlighting, checkbox and signature widgets.

About

The PDF Generate Behavior allows Grooper users to more fully leverage the capabilities of the PDF file type. The standard PDF Export Format in Grooper will use the page image files and their text data to create a multipage PDF file for each document folder upon Export. However, this is just the "display information" required to open and read the document. There's a lot more to what a PDF can be than just a multipage document with page images and machine readable text. PDF content can also include metadata, keywords, bookmarks, annotations, and more!

PDF Generate creates an exportable PDF file that includes some of this additional content available to the PDF format. This is part of Grooper's evolving "Smart PDF Architecture". This is a design philosophy, striving to more fully utilize the capabilities of the PDF file type and merge them with Grooper's own document processing capabilities.

The expanded PDF Generate Behavior functionality can be divided into three categories:

• Metadata
• Bookmarks
• Annotations

AnnotationsBookmarksMetadata

Annotations

Bookmarks

Metadata

As a Behavior, PDF Generate is configured on a Content Type object, commonly a Content Model or a Document Type. Here, we have selected a Content Model in the Node Tree. To add a Behavior, select the Behaviors property and press the ellipsis button at the end. This will bring up a dialogue window to add various behaviors to the Content Model, including the PDF Generate Behavior. Add the PDF Generate Behavior to the list using the "Add" button. Select PDF Generate Behavior from the listed options.
Once added, you will see a PDF Generate Behavior item added to the Behaviors list. Selecting this Behavior, you will see property options to configure PDF creation. The expanded PDF Generate Behavior functionality can be divided into three categories: Metadata Bookmarks Annotations Before we get into what these properties do, how to configure them, and how they effect the exported PDF, there's one key thing to keep in mind when using the PDF Generate Behavior.
Along with the PDF Generate Behavior, you will also need an Export Behavior configured to export a PDF formatted file. The PDF Generate Behavior does the job of configuring all the extra content (metadata, bookmarks and/or annotations) you want to add to the exported PDF. The Export Behavior does the job of actually creating the PDF (with the content configuration information supplied by the PDF Generate Behavior) and sending it off to an external storage platform. Export Behaviors can be added to Content Types, such as the Content Model here. To add an Export Behavior, press the "Add" button in a Behaviors list collector. Select Export Behavior. FYI Export Behaviors can also be configured on the Export activity as local Export Behaviors to the activity configuration. The benefit to adding it to a Content Model is you will often use information collected from a Content Model upon exporting your documents, such as a document folder's classified Document Type or collected data from a Data Model for field mapping purposes. You might as well do it now, adding it to the Content Model while you're adding the PDF Generate Behavior.
Once the Export Behavior is added, you will need to add an Export Definition. This will control how the file is exported, most notably where the file is exported. Whether exporting to a Windows file system, or an IMAP email mailbox, or a CMIS content management system, Grooper needs to know where to put the file. An Export Definition is how Grooper knows where the file goes. Importantly for the PDF Generate Behavior, you will also use an Export Definition to define what type(s) of file you want to export. For whichever Export Definition you choose, you will need to ensure you've configured an Export Format for a PDF formatted file in order to export the generated PDF. To add an Export Definition, select the property and press the ellipsis button at the end. This will bring up an Export Definitions list collector window. Here, we've added a CMIS Export definition, using a CMIS Connection to a local NTFS folder. The Export Definition is up to you and your needs. There are many different external storage platforms Grooper can export to. Note, we've added a PDF Format configuration to the Export Formats property. We will review some specifics of the PDF Format option's configuration later. For now, just be aware adding a PDF Export Format is a necessary step to export the PDF file generated by the PDF Generate Behavior.