Set up PDS

By the end of this section a project created from a template generates its folders and its starting documents in SharePoint.

Time: two to three hours, once CtrlSync is working. Most of it is building the vault structure, not configuring PDS.

Who you need: someone with administrative access to the vault through M-Files Admin. No Microsoft 365 administrator is needed for PDS itself — it reaches SharePoint through CtrlSync, using CtrlSync’s credentials.

Before you start

• CtrlSync installed, configured, licensed, and demonstrably synchronising one connection. PDS calls into it and refuses to activate a project when it cannot.
• M-Files 23.6.0.0 or later, and administrative access to the vault.
• The PDS .mfappx file and its .lic licence file.
• An agreed window for a vault restart.
• A decision about whether the deployment needs starting documents or only folders. A folders-only deployment skips the artefact settings entirely.

Steps

1. Install the application and its licence.

   Follow Install a vault application, then Install a vault application licence.

   Without a licence the check-in handler that drives everything is disabled, and the log says so on startup.

   Check: PDS appears under the vault’s Applications node and the vault has been restarted.

2. Create the vault structure.

   Every setting in the PDS configuration points at an object type, class, property, workflow or state that has to exist first. See Vault structure.

   Check: you can create a path object, a project object template and a document object template by hand, and link them to each other.

3. Configure the project and path sections.

   Point PDS at the project object type and class, the property that links artefacts and documents to a project, and the property holding the project’s template. Then do the same for paths: the path object type, the partial path title, the full path and the directory structure property.

   Check: the application status in M-Files Admin reports no configuration error. PDS refuses to run its handlers at all while the configuration is invalid.

4. Configure the workflow.

   Name the project workflow and its states: generate baseline, baseline generated, activate, activated, and the two error states. The activate, activated and activation error states are required; the baseline pair is not, though nothing is created without them.

   Check: the states named in the configuration are the ones on the project workflow, and a project can be moved into the baseline state by hand.

5. Configure the hand-over to CtrlSync.

   In Graph Configuration, name the property holding the project’s SharePoint URL, the one holding its SharePoint ID, and — if synchronisation should start by itself — the active flag.

   The URL property has to be the one CtrlSync reads on its connections. This is the single setting that most often stops a working-looking deployment from producing anything.

   Check: the property named here is the same one named in CtrlSync’s configuration.

6. Configure document templates and artefacts.

   Skip this step if the deployment only needs folders.

   Name the artefact object type and class, the property linking an artefact to its document object template, and the property holding the document template on a document object template. Decide what happens to later edits with Default Synchronization Behavior.

   Check: the application status still reports no error.

7. Build one template and run it end to end.

   See Build a project template.

   Check: a project created from the template generates its artefacts, activates, and its folders and documents appear in SharePoint under the expected names.

Test with one document, not twenty

The first template to build is one project template with a single document object template. Every configuration mistake shows up on the first one, and a template with twenty documents just produces twenty copies of the same error.

If something goes wrong

See Troubleshooting. PDS puts its reason on the workflow transition that failed, so read the message before anything else — it names the object that is incomplete.