Technischer Aufbau der Lösung
Die CRM M-Files DMS Connector App besteht im Kern aus den folgenden Tabellen:
M-Files Objekt Konfiguration
Zusammen mit den Tabellen M-Files Klasse, M-Files Eigenschaft und M-Files Werteliste, bilden diese vier Tabellen die Metadaten aus M-Files ab. In dieser Tabelle werden sämtliche Objekte aus M-Files dargestellt. Informationen wie diese eingerichtet werden finden Sie im Abschnitt zum Einrichten der App.
M-Files Klasse
Diese Tabelle enthält sämtliche M-Files Klassen (auch Dokumentenklassen). Ein M-Files Klasse Datensatz enthält lediglich den Namen und die M-Files ID der Klasse.
M-Files Eigenschaft
Für die korrekte Zuweisung der einzelnen Eigenschaften, werden die Datensätze in dieser Tabelle mit den entsprechenden Spalten der Tabelle versehen. Weiterhin enthält ein Datensatz die dazugehöre M-Files Klasse und die Eigenschafts ID aus M-Files. Anders als in M-Files, wo es jede Eigenschaft nur ein einziges mal gibt, wird in der Connector App für jedes Vorkommen in einer Klasse, ein eigener Datensatz erstellt. Der Grund dafür sind die unterschiedlichen Spaltennamen in den verschiedenen Tabellen im CRM System. Weitere Informationen dazu folgen im Abschnitt zum Einrichten der App.
M-Files Werteliste
Die M-Files Werteliste Tabelle speichert die entsprechenden Wertelisten aus M-Files. Ein Datensatz enthält den Namen und die interne M-Files ID. Zu jeder Werteliste werden die dazugehörigen Werte in der Tabelle M-Files Wertelistenwerte hinterlegt. Die beiden tabellen stehen entsprechend in einer 1:N Beziehung.
M-Files Wertelistenwert
Entsprechend enthält ein Wertelistenwertdatensatz immer auch die dazugehörige Werteliste als Suchfeld. Zusätzlich wird in jedem Datensatz auch der Wert und die interne M-Files ID des Werts gespeichert.
M-Files Objekt Klasse Relation
Damit das Steuerelement weiß, welche Dokumentenklassen dargestellt werden sollen und auf welchem Objekt bzw. Tabelle man sich gerade befinden, wird die Relation zwischen Objekten und Klassen in dieser Tabelle konfiguriert. Einem Objekt können dabei mehrere Klassen zugeordnet werden. Zusätzlich können auch Relationen zwischen zwei Objekten konfiguriert werden. Wie eine Relation konfiguriert wird, wird ebenfalls im Abschnitt zum Einrichten der App erläutert.
M-Files Verbindung
In dieser Tabelle befindet sich nur ein Datensatz. Er enthält alle notwendigen Informationen für die Verbindung zur M-Files REST-API. Dementsprechend werden in diesem Datensatz die Vault URL und die GUID, sowie der Nutzername und das Passwort für den M-Files DMS Connector Nutzer gespeichert. Die sensiblen Spalten für den M-Files Nutzer sind jedoch nur für Admins sichtbar. Weitere Informationen dazu folgen im Abschnitt zum Einrichten der App.
M-Files Warteschlangenelement
Um nachzuverfolgen welche Datensätze neu erstellt und verändert wurden, wird für jede aktivität ein Queue Item erzeugt. Es enthält alle wichtigen Information zum erstellten Datensatz oder den geänderten Informationen in einem Datensatz. Erzeugt und verarbeitet werden die Informationen von Workflows. Dabei muss für jede Tabelle die überwacht werden soll, ein entsprechender Workflow erzeugt werden, der bei erkannten Änderungen ein Plugin ausführt. Das Plugin erzeugt das Queue Item woraufhin ein weiteres Plugin, das auf die Erzeugung von Queue Items wartet, die bereitgestellten Informationen verarbeitet. Abgearbeitete Aufträge werden anschließend als bearbeitet und Inaktiv markiert.
Benutzerkonfiguration
Diese Tabelle ist in der App nicht sichtbar und verfügt über keine Einstellmöglichkeiten. Sie wird genutzt, um die ausgewählten Eigenschaften und deren Reihenfolge für jeden Nutzer und jede Tabelle zu speichern. Die Konfigurationen werden als JSON-Objekt gespeichert.