Dropbox document routing

Your rules for routing an incoming Dropbox document to the right folder.

Part of Documents in the register catalog.

Register ID

dropbox_document_routingUse this name to ask for the register. The API calls it a shelf ID.

Each record is

A procedureA rule or method Demiton follows.

Status

AvailableFilled today from connected systems, uploads or public data.

Data

OrganisationPrivate to each organisation's own workspace.

Version

v1Current version.

Download JSON SchemaSee an example record

Connectors

Connected today

Demiton keeps this register current from these systems now.

No system fills this register yet.

On the roadmap

Systems in the planned connector rollout that can fill this register. Partial means the system holds only some of its fields.

• SitematePartial

Fields

15 fields: 6 required, 9 optional.

Required

Every record carries these fields.

rulesList

The ordered rule set, one element per routing rule; the shelf's entire payload.

default_actionText

What happens to a file matching no rule; the only value observed in the live ruleset is skip

Example: skip

dropbox_prefixText

The Dropbox path prefix this rule claims; it is simultaneously the literal list_folder path, the startswith() needle, and the delta-cursor scope key.

Example: /Bridgeworks/Projects

scopeText

The functional label a rule belongs to; the write path filters rules by it.

Example: projects

subject_entity_idWhole number

The entity the ruleset is about: the tenant organisation itself.

Example: 1

source_systemText

The producing system of the fact; PLATFORM_SEED on the one observed fact.

Example: AUTHORED

Optional

Present when the source system records them.

destination_kindText

Which class of destination the rule targets; absent means SharePoint.

sp_connector_aliasText

The logical alias of the connector that reaches the SharePoint destination.

Example: bridgeworks-sharepoint

sp_site_pathText

The SharePoint site the rule delivers into.

Example: /sites/BridgeworksProjects

sp_libraryText

The document library inside that site.

Example: Documents

sp_folder_prefixText

The library-relative folder the rule's files land under, before the stripped remainder of the source path is re-appended.

Example: Projects

strip_prefixTrue or false

Whether the matched dropbox_prefix is removed before the destination folder is built.

Example: true

always_full_scanTrue or false

Whether this prefix bypasses the delta cursor and the modified_after cutoff on every dispatch.

Example: false

blob_connector_aliasText

The logical alias of the connector that reaches the blob destination.

blob_prefixText

The container-relative prefix placed in front of the source path's remainder, mirroring the Dropbox layout so a file is findable from its Dropbox path alone.

Example record

A sample from Bridgeworks Group, Demiton's demonstration company. The values are illustrative; the shape is exactly what the contract describes.

dropbox_document_routing.example.json

{
  "always_full_scan": false,
  "default_action": "skip",
  "dropbox_prefix": "/Bridgeworks/Projects",
  "rules": [
    {
      "destination_kind": "sharepoint",
      "match": "*.pdf"
    }
  ],
  "scope": "projects",
  "source_system": "AUTHORED",
  "sp_connector_alias": "bridgeworks-sharepoint",
  "sp_folder_prefix": "Projects",
  "sp_library": "Documents",
  "sp_site_path": "/sites/BridgeworksProjects",
  "strip_prefix": true,
  "subject_entity_id": 1
}

Use this contract

The contract is a standard JSON Schema (draft 2020-12) document, so any JSON Schema validator can check a record against it. Keywords starting with x-demiton- add Demiton's own meaning, such as units and requiredness, and validators ignore them.

Schema URL

https://docs.demiton.io/registers/dropbox_document_routing/v1.json

Show the full JSON Schema

Loading the schema…