Export Definition

Export Behaviors are defined by adding and configuring one or more Export Definitions (See Export Definition Types or the Export Definitions section of the Export article). An Export Definition defines export parameters to external systems, such as file systems, content management repositories, databases, or mail servers.

About Export Definitions

Export Definitions are key to exporting document content from Grooper to an end destination, such as file systems, content management systems, and databases.

• One or more Export Definitions are added to an Export Behavior.
• The Export activity executes each Export Definition for each Batch Folder.

Export Definitions functionally determine three things:

• Destination – Where the document content ends up upon export. In other words, the storage platform you are exporting to.
• Content – What document content is exported: attached file content, Batch Page images, full text/OCR data, and/or extracted data from a Data Model.
• File Format – What format the exported content takes, such as a PDF file or XML data file.
  • Not applicable to Data Export. Files are not generated from document content for this Export Definition. Only Data Model data is exported.

How To: Add an Export Definition to an Export Behavior

An Export Definition, as the name implies, defines the connection to a storage destination outside of Grooper. How this connection is made varies depending on the export method.

Click here for an interactive walkthrough

1. Click ... on the Export Definitions property to open the Export Definitions list window.
2. Click the Add button to access the dropdown list.
3. Select an Export Definition from the list.
   • You can have more than one Export Definition configured on an Export Behavior.

Types of Export Definitions

CMIS Export

With a CMIS Export, document content is exported from Grooper to a CMIS Repository via a CMIS Connection.

Click here for an interactive walkthrough

1. Click the Add button within the Export Definitions list window and select CMIS Export.
2. Click the hamburger icon on the CMIS Repository property to expose the Node Object list, then navigate to and select the desired CMIS Repository.
   • You will need to have a CMIS Connection created and a Repository imported FIRST before configuring this Export Definition.
3. Define the CMIS content being exported by selecting the Object Type.
   • Most typically, this will be the CMIS type that corresponds to a "document" for the destination CMIS Repository.
4. The Target Folder property defaults to the root of the repository. Configure this property if you want to export to a specific folder.
5. Configure one or more Export Formats.
   • There are Export Format options for PDF and TIFF, as well as JSON and other text-based files suitable for data extracted from a document's Data Model.
6. Configure additional properties as needed.
7. Click OK when finished.

Data Export

A Data Export sends extracted data from documents to a SQL database via a Data Connection.

Click here for an interactive walkthrough

1. Click the Add button within the Export Definitions list window and select Data Export.
   • You will need to have created a Data Connection within Grooper before configuring the Export Definition.
2. Expand the Connection dropdown (click the ☰ button) and select the Data Connection from the Node selector.
3. Configure Table Mappings.
4. Configure Custom Statements (optional).
5. Click OK when finished.

File Export

With File Export, document content is exported from Grooper to a folder within a Windows file system.

Click here for an interactive walkthrough

1. Click the Add button within the Export Definitions list window and select File Export.
2. Enter the UNC path of the target folder in the Target Folder property.
3. If you want to export to a specific subfolder, define it in the Relative Path property.
4. Configure one or more Export Formats.
   • There are Export Format options for PDF and TIFF, as well as JSON and other text-based files suitable for data extracted from a document's Data Model.
5. Click OK when finished.

⚠

File Export is old. CMIS Export is better. The File Export definition is an older method of exporting to the Windows file system in Grooper. File Export exists for backward compatibility. It can still be used for simple exports to Windows folders, but no further development of this feature will occur. For better long-term support, use the CMIS Export definition with an NTFS CMIS Repository to export documents to Windows file folders.

FTP Export

The FTP Export Definition sends documents from Grooper to an FTP site using the FTP protocol.

Click here for an interactive walkthrough

1. Click the Add button within the Export Definitions list window and select FTP Export.
2. Enter the FTP server URL.
3. Configure one or more Export Formats.
   • There are Export Format options for PDF and TIFF, as well as JSON and other text-based files suitable for data extracted from a document's Data Model.
4. Click OK.

⚠

FTP Export is old. CMIS Export is better. The FTP Export definition is an older method of exporting to FTP sites in Grooper. FTP Export exists for backward compatibility. It can still be used for simple exports to FTP folders, but no further development of this feature will occur. For better long-term support, use the CMIS Export definition with an FTP CMIS Repository to export documents to SFTP folders.

SFTP Export

SFTP Export sends document content to an SFTP site using the SFTP protocol.

Click here for an interactive walkthrough

1. Click the Add button within the Export Definitions list window and select SFTP Export.
2. Enter the server host name.
3. Configure one or more Export Formats.
   • There are Export Format options for PDF and TIFF, as well as JSON and other text-based files suitable for data extracted from a document's Data Model.
4. Click OK.

⚠

SFTP Export is old. CMIS Export is better. The SFTP Export definition is an older method of exporting to SFTP sites in Grooper. SFTP Export exists for backward compatibility. It can still be used for simple exports to SFTP folders, but no further development of this feature will occur. For better long-term support, use the CMIS Export definition with an SFTP CMIS Repository to export documents to SFTP folders.

Mail Export (seldom used)

Mail Export (formerly IMAP Export) exports documents as email messages to a mail server using the IMAP protocol. The export operation appends each document as a new message in the specified mail folder.

Click here for an interactive walkthrough

1. Click the Add button within the Export Definitions list window and select Mail Export.
2. Enter the mail server name.
3. Enter the username and password Grooper will use to access the mail server.
4. Click OK.