Connectors provide an easy way to connect your data from external sources to Ragie.

For example, you can connect a Google Drive folder and all of its content will be sent to Ragie automatically and kept up to date.

To connect a data source, start by going to the Connections tab in the left nav menu. Then, click the Add Connection button in the top right. Next, select a connector you want to use.

Authentication

Because connectors are linked to external data, Ragie needs permissions to this data.

When you click on a connector you will be redirected to authenticate and give Ragie permissions to access the files. After authentication is complete, you will be redirected to a screen where you can choose what content to keep in sync with Ragie. See the individual connectors pages for connector specific information.

Daily Sync

To keep your files up to date, Ragie performs a sync for all connections every 4 hours. The sync process is smart and can detect new files, updated files, and deleted files. Ragie will pick up these changes and keep your documents in sync.

However, this does mean you might not see changes immediately. If you add a bunch of files, it may take up to 4 hours for your files to be synchronized.

If you need to see the changes immediately, you can manually trigger a Sync now by clicking the ellipses on the connection table row and selecting Sync now.

Metadata

Metadata for the documents synced by a connection can be configured in the settings for the connection. Connector type specific metadata will also be set on managed documents. Those connector specific metadata values are detailed in the documentation for each connection type. Every time a document is synced by its connection, its metadata will be updated based on the connection settings and its connector specific metadata.

Metadata can also be set on a document by document basis in the Ragie application on the document's detail page. Setting metadata on a connection managed document creates a Metadata Overlay which will be applied any time the document is updated. The Patch Document Metadata endpoint will similarly produce a Metadata Overlay when used to update metadata for a connection managed document. Metadata Overlays ensure that modifications to metadata are not overwritten by future connection syncs.