Functional Mapping to Documentation (Holistic View)

Purpose

Provide traceability between each functional element listed in the Functional Overview matrix and its detailed documentation location(s), procedures, and tables across the reorganized documentation.

Legend

  • Covered: Narrative page(s) + object docs

  • Partial: Some coverage exists (procedure/table doc or brief narrative), but more examples or guidance planned

  • Gap: No current coverage (needs authoring)

  • External: Object page exists only; narrative integration pending

Metadata Structure

Class Tables

Special Functions

  • Delimited string handling: Partial — add parsing & multi-lookup mapping recipe. Blog: Using delimiter functions. Examples: Example scripts to get started (“16.101.Using functions in custom procs”).

  • HTML conversion for reporting: External — spMFConvertTableToHtml.

  • Include table in notification: Partial — combine HTML table + email send pattern.

  • Send HTML formatted email: Partial — spMFSendHTMLBodyEmail; add end-to-end sample.

  • Remove special characters: Covered — include before/after snippet (function doc). Blog: Illegal XML Characters.

  • Insert/update multi-lookup values: Partial — add performance note.

  • Send bulk notifications using templates: Partial — covered conceptually under User messages and notifications (bulk email section); add full recipe.

Files

Views & Reporting

Value Lists & Workflow Items

Operations in M-Files

Error Handling

Special Applications

  • External application user to filter updates: Gap — security pattern.

  • Action M-Files Reporting Data Export: Partial — link to reporting export flow.

  • Update metadata on demand: Partial — targeted sync examples (per-doc strict links and agent usage).

  • Update metadata scheduled: Covered — Agent scheduling and batching.

  • Change history of any class property: Partial — combine change history procedure + conflict remediation narrative.

Scheduling & Automation

Installation & Upgrade (External)

All related procedures and scripts remain in Getting Started sections; cross-link from the matrix where appropriate.

Appendix A: Object-Level Mapping (Snapshot)

Legend: T=Table, P=Procedure, F=Function, V=View

Metadata Structure Objects

  • Auto create metadata structure tables: P spMFCreateAllMFTables, P spMFCreateAllLookups; T tbMFClass, tbMFProperty, tbMFObjectType, tbMFValueList, tbMFValueListItems, tbMFWorkflow, tbMFWorkflowState – Status Partial.

  • Analyse metadata refresh: P spMFSynchronizeMetadata, P spMFSynchronizeSpecificMetadata, P spMFSynchronizeClasses; V MFvwMetadataStructure – Partial.

  • Drop & recreate metadata: P spMFDropAndUpdateMetadata – Gap.

  • Update names & aliases: P spMFAliasesUpsert – Covered.

  • Valuelist item insert/update: P spMFInsertValueListItems; T tbMFValueListItems – Covered.

  • Alias bulk update: P spMFAliasesUpsert – Partial.

  • Relationship analysis: V MFvwMetadataStructure, V MFvwClassTableColumns – Gap.

  • Accounts & users: P spMFInsertLoginAccount, P spMFInsertUserAccount – External.

  • Workflows/states: P spMFInsertWorkflow, P spMFInsertWorkflowState – Partial.

  • Complex ownership: (No direct object) – Gap.

  • Usage analysis: V MFvwClassTableColumns – Partial.

  • Structure version: F fnMFLastConnectorVersion – External.

Class Table Objects

  • Creation: P spMFCreateTable, P spMFInsertClass – Covered.

  • Recreate all: P spMFDropAllClassTables – Gap.

  • Batch update: P spMFUpdateTableinBatches; P spMFUpdateTableInternal – Partial.

  • Delta update: P spMFUpdateTableWithLastModifiedDate; P spMFUpdateMFilesToMFSQL – Partial.

  • Concurrent processing: T tbMFProcessBatch; P update procs – Partial.

  • Directional updates: P spMFUpdateMFilesToMFSQL (MF→SQL), P spMFUpdateTable / spMFUpdateTableinBatches (SQL→MF) – Partial.

  • Date filter: P spMFUpdateTableWithLastModifiedDate – Covered.

  • ObjID filter: P spMFUpdateTable_ObjIDs_Grouped; P spMFUpdateTable_ObjIDs_GetGroupedList – Covered.

  • User-based filter: audit tables tbMFUpdateHistory – Gap (no dedicated proc).

  • Inclusion flag batch: P spMFUpdateAllncludedInAppTables – Partial.

  • Filter helpers: P spMFUpdateTable_ObjIDs_GetGroupedList – Partial.

  • Inserts: P spMFUpdateTable (insert path) – Covered.

  • Hyperlinks: F fnMFObjectHyperlink; F fnMFExcelObjectHyperlink – Covered.

  • Public link hyperlink: P spMFCreatePublicSharedLink + F hyperlink fn – Partial.

  • Change class/property: P spMFChangeClass (and related) – Partial.

  • Delete records: standard update procs with delete flags – Covered.

  • Bulk adhoc property delete: P spMFDeleteAdhocProperty loop – Partial.

  • ObjVer retrieval: (view/proc) – External.

  • Comments: P spMFGetAndUpdateObjectComments – External.

  • Search: P spMFSearchForObject – External.

  • Single adhoc property delete: P spMFDeleteAdhocProperty – Covered.

Scheduling & Automation Objects

  • Daily/weekly/monthly routines: documented patterns using P spMFUpdateAllncludedInAppTables, P spMFDeleteHistory, P spMFDropAndUpdateMetadata, P spMFCheckAndUpdateAssemblyVersion – Covered.

  • Sync error remediation: P spMFUpdateSynchronizeError – Covered.

  • Conflict stats: P spMFClassTableStats – Covered (monitoring).

  • Value list sync: P spMFSynchronizeValueListItemsToMFiles – Covered.

  • Assembly version: P spMFCheckAndUpdateAssemblyVersion – Covered.

  • Escalation (planned): new script (Gap).

Error Handling & Logging Objects

  • Synchronization errors: P spMFUpdateSynchronizeError; T tbMFProcessBatch; T tbMFProcessBatchDetail – Covered (synchronization conflicts deep dive).

  • History retention: P spMFDeleteHistory – Covered (automated updates deep dive).

  • Email error notification: P spMFLogError_EMail – Partial.

File Pipeline Objects

  • Import/export control & history: T tbMFFileImport, tbMFFileExportControl, tbMFExportFileHistory – Covered (file ingestion & export pipeline deep dive pending anchor verification).

Appendix B: Remaining Unmapped / Review

Procedures needing placement or decision: - spMFObjectTypeUpdateClassIndex (metadata usage counts) — candidate under Metadata Structure diagnostics. - spMFSetAdditionalProperty (adhoc property management) — integrate under Class Tables property changes. - spMFSetUniqueIndexes (index/constraint management) — consider performance subsection. - spMFUsersByUserGroup (security introspection) — map to Users & Permissions: Users and permissions. - spMFsettingsForDBUpdate / spMFsettingsForVaultUpdate (internal) — decide to omit or document as internal. - spMFUpdateItemByItem (row-by-row fallback) — performance caveats subsection. - spMFSynchronizeLookupColumnChange / spMFSynchronizeWorkFlowStateColumnChange — change history / structure drift subsection.

Utility Functions (possible consolidation): - fnMFVariableTableName, fnMFGetCulture, fnMFTextToDate, fnMFFloatToString, fnMFCapitalizeFirstLetter — group under Utility Conversions (or keep external). - fnMFVaultSettings — map to settings/metadata structure.

Views / Diagnostics: - MFvwTableID — metadata diagnostics; include in Metadata Structure analysis.

Recommendation: treat minor utilities collectively to avoid table bloat; prioritize authoring Gap items tied to safety, data integrity, or core update correctness before cosmetic enhancements.

Next Actions

  1. Validate status accuracy; adjust any misclassified items.

  2. Create missing anchors (delta-only updates, alias maintenance, escalation script placeholder, complex ownership examples).

  3. Author Gap content (metadata drop/recreate safety, email sent log, checksum/file metadata access, escalation script, complex ownership).

  4. Merge summarized mapping into functional overview table via footnotes or hover tooltips (future enhancement).

  5. Reassess remaining External items; either keep or integrate if they gain deep-dive coverage.

End of Mapping