2021:Import Provider (Property)

From Grooper Wiki

This article is about an older version of Grooper.

Information may be out of date and UI elements may have changed.

2025202320212.90

Import Providers enable Grooper to import file-based content from a variety of sources, such as file systems, mail servers, and content repositories. An Import Provider is selected and configured when configuring Import Jobs. Ad-hoc or "user directed" Import Jobs are submitted from the Imports Page, using the "Submit Import Job" button. Automated or "scheduled" Import Jobs are submitted by an Import Watcher service according to its Poling Loop or Specific Times specification. In all cases, the Import Provider is selected using the Provider property.

Import Providers can be used in two ways:

  • To perform manual "ad-hoc" file imports when creating a new Batch in Grooper Dashboard or Grooper Design Studio.
  • To perform automatic, scheduled file imports using one or more Import Watcher services.

There are two categories of Import Providers: CMIS Import and Other Import

CMIS Import

CMIS Import is an Import Provider used to import content over a CMIS Connection from CMIS Repositories. This allows users to import from various on-premise and cloud based storage platforms.

Documents are imported from CMIS Connections using either the Import Descendants or Import Query Results providers.

  • Import Descendants will import all documents within a designated folder location of a CMIS Repository.
  • Import Query Results allows you to use a query syntax similar to a SQL query (called a CMISQL query) to set conditions for import based on the item's available metadata, such as a documents name, file type, creation date, archive status, or other variables.

For more information, visit the CMIS Import article.

Other Import

WIP

This section needs expanding. It's about importing from Test Batch

Legacy Import

The "Legacy Import" providers are the Import Providers used for document import operations prior to the switch to Grooper's CMIS+ infrastructure in version 2.72.

There are four "Legacy Import" providers:

  • File System Import - This provider imports content over a local network to the Windows file system.
  • FTP Import - This provider imports content using the FTP and FTPS protocols.
  • Mail Import - This provider imports content to mail servers using the IMAP protocol.
  • SFTP Import - This provider imports content using the SFTP protocol.

These are depreciated Grooper components.  Depreciated means they are still available for use, just not recommended.  These Import Providers exist primarily to allow for backwards compatibility.  By and large, these legacy providers operate the same as they did in previous versions.

Going forward, input operations should be implemented using CMIS Import.  There are two main differences.  One, connection settings found in the legacy providers properties will be entered in the connection settings of whichever CMIS Binding is selected, when configuring the Connection Type property.  Connection information such as the server you're connecting to, the file paths you're using, and any login credentials necessary will be entered there.  Two, you will need to "import repositories". This creates a Grooper object called a CMIS Repository that is used to traverse a file structure for import and export operations.

  • Refer to the CMIS Connection article for information about setting up a CMIS Connection and importing CMIS Repositories.
  • Refer to the CMIS Import article for information on CMIS Import.