Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Panel
titleEnable viewing, creating, and deleting Salesforce Files within Pulsar.

To enable Salesforce Files, you must configure the two settings shown below.   The first one setting is to include the actual objects that store the Content File information on Salesforce either with pulsar.sync.objects or with pulsar.sync.relationship.directives.  The second one setting (pulsar.sync.cdl.objects) allows you to specify which parent objects that Pulsar should sync Files for.

Modify your existing sync object list setting to include these objects as wellone of the following two settings depending on your setup.

Keypulsar.sync.objects
Value...
ContentDocument
ContentDocumentLink
ContentVersion
...

If you are using relationship sync directives instead, add these objects only at depth 0:

Keypulsar.sync.
objects
relationship.directives
Value

...
0 ; ContentDocument
|
0 ; ContentDocumentLink
|
0 ; ContentVersion
...


Also specify this setting to sync files attached to specific objects.

Keypulsar.sync.cdl.objects
Value<object type list separated by commas or newlines>

For example, to sync Files for Contacts and Accounts specify this value:

Account
Contact


When using relationship directives in combination with this setting, a ContentDocumentLink directive will be automatically added (behind the scenes) for every directive where the target object type is one of the types in this cdl.objects setting (at the next higher depth). Also, subsequent sync stages will retrieve the ContentDocument and ContentVersion objects that are specifically referenced by the downloaded ContentDocumentLink objects.


Note

Specifying these two settings will sync the content records that the user can access, but will not automatically retrieve the actual file during sync.  Depending on your requirements, you may prefer to have your users not pre-download all the files, but to download individual files on demand (network connectivity permitting). If, however, you require your users to always have access to the files, specify the base64 setting below.


...

Panel
titleAutomatically Download Files During Sync

Include or modify the Base64 download sync setting to include ContentVersion:

Keypulsar.sync.base64download.enabledObjects
ValueContentVersion


Note

Admins will need to add the Files related list to the page layouts in order to see Files within Pulsar.



Due to API limitations,
Info
iconfalse
titlePlease Note:
API Limitations

While Salesforce generally allows Pulsar to query for server deleted records in order to remove them from the local device, they do not provide this feature for all objects. The objects associated with content files (ContentDocument, ContentDocumentLink, and ContentVersion) are among those that do not have this support. This means that Pulsar is currently unable to determine when files get deleted from the server via a typical sync. The current work around to this is to run a special type of sync (single object sync) from the parent object. This limited sync can query for all content document link records associated with that single parent object and automatically removes any local records that were not found. 

Salesforce Files related list support is also not available within Pulsar for Event and Task objects. 


Tip
titleEstimate Additional API Calls

Also, note that enabling Salesforce Files sync may result in an increase of API calls during the catch-up syncs compared to other stages of sync depending on how many Files the user has access to. To estimate how many additional calls are made with each sync, take the number of files the user has access to and divide by 100.

...