CMIS Import (Import Provider)

From Grooper Wiki
Revision as of 11:52, 27 December 2019 by Configadmin (talk | contribs)

CMIS Import is an Import Provider used to import content over a CMIS Connection, allowing users to import from various external storage platforms.

Version Differences

2.72 Import Mode

In version 2.72 the "Import Mode" property replaces previous versions' "Sparse Import" property.

Import Mode allows control over the connections Grooper makes and/or retains to the imported documents.

Mode Speed Comments
Full Slow
  • Full import of content and their properties.
  • Required if deleting content from the source on import.
Sparse Fast
  • Imports a link to the document's source and its properties but not their content.
  • This produces a usable document in Grooper without copying the full content into Grooper, saving time upon import.
  • This mode is the same as enabling the old "Sparse Import" property in previous versions.
Link Only Fastest
  • Only imports a link to the document's source.
  • Does not produce a usable document. The document's properties must be loaded in a step in a Batch Process.

Full

Both properties and content will be loaded. This is the slowest import mode, because the full content of each document is copied during a single-threaded import process. As such, this mode is not well-suited for high-volume imports, but provides some useful advantages in low-volume import scenarios.

For example, Normal mode allows items to be deleted immediately on import, which can be important when using the Import Watcher service. Also, Normal mode avoids the need for any follow-up load operations in the Batch Process.

Sparse

Properties will be loaded, but content will not. This mode is much faster than a Full import, because no content files are copied into Grooper. Instead, a link is saved on each Grooper document, and content is retrieved on demand directly from the CMIS Repository. This type of document is called a sparse document. Sparse documents can be used just like any other document, with the caveat that display and processing speeds may be reduced.

After a sparse import, document content can be loaded in parallel using the "Link Action > CMIS Document Link - Load" command.

Link Only

No content or properties will be loaded, making this the fastest import mode. It imports nothing more than a link to each document, and offloads all property and content loading to parallel operations in the Batch Process.

After a LinkOnly import, document properties and/or content can be loaded using the Link Action > CMIS Document Link - Load command.

2.72 Import Disposition

2.72 also adds an Import Disposition property to CMIS Import. This allows you to change your documents disposition upon importing them into Grooper. You can delete them, move them to a folder, or update one or more properties on the document itself. This can be leveraged with Import Watcher to prevent repeatedly importing the same document.

Disposition Comments
Delete Item
  • Enables or disables deletion of the input item immediately after import
  • Can only be enabled if "Import Mode" is set to "Full"
Move to Folder
  • Specifies an optional folder in your CMIS Repository to which items are moved after import.
Update Properties
  • Defines one or more property values to be updated on import.
  • Allows you to type a list of "key-value pairs" where the "key" is the name of the property and the "value" is what change you want to make to that property. You can type one entry per line in the format key=value
    • Examples:
    • Archive=true Sets the archive attribute on a file
    • Status=PENDING Sets the "Status" field on ApplicationXtender documents.
    • Imported=true Sets the "Imported" field on SharePoint documents.
    • IsRead=true Sets the "IsRead" flag on an Exchange message.