When the connector retrieves content from a single Dropbox account, or content from a Dropbox for Business account that is not in a shared folder, it creates a document for each file. Each document contains the path to the source file in a field named DROPBOX_PATH
.
Users in a Dropbox for Business team can share files with other users in the team. This section describes how the connector handles paths for these shared files.
Consider the following scenario:
/My/Shared/Folder
, and they share this folder with User2./SharedFolders/User1
.MyDocument.txt
.The document is accessible from two locations:
/My/Shared/Folder/MyDocument.txt
./SharedFolders/User1/MyDocument.txt
.The connector therefore indexes the following:
A metadata-only document that represents the shared folder from the perspective of User1. This document has only User1 in the ACL, and contains the following metadata:
DROPBOX_PATH=/My/Shared/Folder DROPBOX_SHARED_FOLDER_ID=12456ABCDE
A metadata-only document that represents the shared folder from the perspective of User2. This document has only User2 in the ACL, and contains the following metadata:
DROPBOX_PATH=/SharedFolders/User1 DROPBOX_SHARED_FOLDER_ID=12456ABCDE
A document that represents MyDocument.txt
. This document includes the file content and the following metadata, and has both User1 and User2 in the ACL:
DROPBOX_PATH_IN_SHARED_FOLDER=/MyDocument.txt DROPBOX_PARENT_SHARED_FOLDER_ID=12456ABCDE
The field DROPBOX_PATH_IN_SHARED_FOLDER
contains the path of the document relative to the shared folder. The field DROPBOX_PARENT_SHARED_FOLDER_ID
contains the ID of the shared folder.
You can obtain the full path of a document in a shared folder by concatenating the value from the field DROPBOX_PATH_IN_SHARED_FOLDER
to the value of the field DROPBOX_PATH
in the document that represents the shared folder. You can match the document to the correct folder by matching the value of the field DROPBOX_PARENT_SHARED_FOLDER_ID
to the value of the field DROPBOX_SHARED_FOLDER_ID
in the document that represents the shared folder.
NOTE: To index documents that represent folders, you must set the configuration parameter IndexFolders
to TRUE
.
|