M-Files Ground Link einrichten

Vor dem Einrichten der Ground Link Funktion, müssen Sie sicherstellen, dass:

gRPC-Verbindungen auf dem lokalen Server, auf dem der Ground Link Proxy konfiguriert wird, zulässig sind. Dieser Server wird nachfolgend in dieser Anleitung Ground Link Proxy-Server genannt.

Wenn Sie eine Verbindung zwischen dem Ground Link Proxy und einer lokalen Dokumentenverwaltung herstellen, müssen Sie ebenfalls sicherstellen, dass:

gRPC-Verbindungen auf dem M-Files Server zulässig sind.
Der M-Files Server über ein gültiges TLS-Zertifikat für die Verschlüsselung der gRPC-Verbindungen verfügt.

Weitere Informationen finden Sie im folgenden Dokument der Wissensdatenbank: Setting Up M-Files to Use gRPC.

Um die Ground Link Funktion einzurichten, zunächst externe Repository-Konnektoren auf einem Ground Link Proxy installieren. Als nächstes richten Sie Repository-Verbindungen in der Dokumentenverwaltung ein. Anschließend können Sie die lokalen Daten direkt in der Dokumentenverwaltung anzeigen und ändern.

Ground Link Verbindung aktivieren

Diese Schritte ausführen, um die Kanalverbindung für Ground Link in einer Dokumentenverwaltung zu aktivieren:

M-Files Admin öffnen und zu einer Dokumentenverwaltung navigieren.
1. M-Files Admin öffnen.
2. In der hierarchischen Ansicht auf der linken Seite, eine M-Files Serververbindung erweitern.
3. Dokumentenverwaltungen erweitern.
4. Eine Dokumentenverwaltung erweitern.
Auf Konfigurationen klicken.
Im Navigationsbereich Advanced Vault Settings > Configuration erweitern.
Auf Ground Link klicken.
Auf der Configuration Registerkarte, den Enabled Wert auf Yes festlegen.
Auf Save klicken.
Dokumentenverwaltung neu starten, damit die Einstellungen wirksam werden.

Hinweis: Die Dokumentenverwaltung sollte jedoch immer in einer kontrollierten Art und Weise offline geschaltet werden und die Benutzer der Dokumentenverwaltung sollten dabei vorab darüber informiert werden.
Im ausgegrauten Navigationsbereich External Repositories > Ground Link erweitern und Configuration auswählen.

Auf der Configuration Registerkarte die folgenden Einstellungen festlegen:


Festlegung des Namens		Beschreibung	Beispielwert
Enabled		Diese Einstellungen gibt an, ob Ground Link aktiviert ist.	Yes
Remoting Service	Shared Secrets	Mit einem geteilten geheimen Schlüssel kann ein Ground Link Proxy die Dokumentenverwaltung authentifizieren. Stellen Sie sicher, dass der geteilte geheime Schlüssel ausreichend komplex und lang ist. Sie können einen oder mehrere geteilte geheime Schlüssel festlegen. Sie müssen den geteilten geheimen Schlüssel bei der Konfiguration des Ground Link Proxys eingeben.
Remoting Service	Timeouts	Timeout-Werte geben in Sekunden an, wie lange Remote-Aufrufe auf eine Antwort warten. Verwenden Sie die Standardwerte. Hinweis: Diese Einstellungen sind für M-Files Cloud Dokumentenverwaltungen nicht verfügbar.
Keep Alive Interval		Diese Einstellung gibt in Sekunden an, wie häufig die Dokumentenverwaltung sicherstellt, dass eine Verbindung zu den Ground Link besteht.	60 (Standardwert)

Optional: Die weiteren Einstellungen festlegen.
Weitere Informationen erhalten Sie auf der Info Registerkarte, wenn Sie eine Einstellung auswählen.
Auf Save klicken.

Da die Dokumentenverwaltung nun Ground Link verwendet, kann der Ground Link Proxy konfiguriert werden.

Einen Ground Link Proxy konfigurieren

Stellen Sie vor dem Beginn sicher, dass die folgenden Voraussetzungen erfüllt sind:

Ihr Ground Link Proxy-Server über ausreichende Hardwareressourcen verfügt. Siehe die empfohlene Hardwarekonfiguration.
M-Files Server und M-Files Admin auf dem Ground Link Proxy-Server installiert sind. Eine separate Lizenz für den M-Files Server ist jedoch nicht erforderlich.
Sie bei M-Files Server mit einem Anmeldekonto, das über die Systemadministrator Serverrolle verfügt, angemeldet sind. Um ein Anmeldekonto zu erstellen, siehe Neues Benutzerkonto erstellen.
Ihr Ground Link Proxy-Server kann eine Verbindung zu den lokalen Ressourcen (z. B. ein Netzwerkordner oder eine externe Datenbank) herstellen, die Sie in der Dokumentenverwaltung verfügbar machen möchten.

Um einen Ground Link Proxy auf dem Ground Link Proxy-Server zu konfigurieren, die folgenden Schritte durchführen:

M-Files Admin öffnen.
In der hierarchischen Ansicht auf der linken Seite, eine Verbindung zum M-Files Server erweitern.
Auf Ground Link-Proxys klicken.
Im rechten Fensterbereich auf Neuer Ground Link-Proxy klicken.
Ergebnis:Das Neuer Ground Link Proxy Dialogfeld wird geöffnet.
Einen Namen für den Ground Link-Proxy eingeben.
Die Datenbankengine zum Speichern von Ground Link-Proxy-Daten auswählen.
- Um Firebird zu verwenden, Firebird verwenden auswählen.
  oder
- Um Microsoft SQL Server zu verwenden, Microsoft SQL Server verwenden auswählen.
Weitere Informationen finden Sie im Abschnitt Datenbankmodul und Datenspeicherung.
Auf Definieren klicken.
Ergebnis:Das Einstellungsdialogfeld für die Suchmaschine wird geöffnet.

Eine der folgenden Optionen ausführen:

Option	Bezeichnung
Im Ground Link Proxy - Firebird Dialogfeld:	Auf die ... Schaltfläche klicken, und den Dateispeicherort für die Ground Link-Proxy-Daten auswählen. Auf OK klicken, um das Dialogfeld zu schließen.
Im Ground Link-Proxy - Microsoft SQL Server Dialogfeld:	Die Schritte von 6 bis 10 unter Migration der Ground Link-Proxy-Datenbank auf einen Microsoft SQL Server durchführen.

Auf OK klicken, um das Neuer Ground Link Proxy Dialogfeld zu schließen.
Die Konnektoren für das externe Repository installieren, die von der Dokumentenverwaltung für den neu erstellten Ground Link Proxy verwendet werden.

Hinweis: Wenn eine gültige Lizenz für die Dokumentenverwaltung für einen Konnektor erforderlich ist, gilt diese Lizenz für die Dokumentenverwaltung und den Server, auf dem die Dokumentenverwaltung gespeichert ist.

Weitere Informationen finden Sie im Abschnitt Installieren und Verwalten von Dokumentenverwaltungsanwendungen.

Beispiel: Um Zugriff auf lokale Netzwerkordner über M-Files Cloud zu erhalten, M-Files Network Folder Connector installieren.

Ergebnis:Der Ground Link Proxy kann nun konfiguriert werden.
In der hierarchischen Ansicht links unter Ground Link-Proxys den neu erstellten Ground Link-Proxy auswählen.

Auf der Configuration Registerkarte die folgenden Einstellungen festlegen:


Festlegung des Namens		Beschreibung	Beispielwert
Enabled		Diese Einstellungen gibt an, ob Ground Link aktiviert ist.	Yes
Password		Ein Kennwort eingeben, das Sie benötigen, wenn Sie eine Konfiguration für einen Ground Link Service in der Dokumentenverwaltung anwenden.
Channel	Network Address	Den Netzwerkspeicherort des Servers eingeben, mit dem die Verbindung hergestellt werden soll. Wenn Sie eine Verbindung zwischen dem Ground Link Proxy und einer M-Files Cloud Dokumentenverwaltung herstellen, geben Sie den DNS-Namen der Dokumentenverwaltung ein.	aa-consulting.cloudvault.m-files.com
	Port number	Den Port eingeben, den der Server abhört. Wenn Sie eine Verbindung zwischen dem Ground Link Proxy und einer M-Files Cloud Dokumentenverwaltung herstellen, lautet die richtige Portnummer 443. Bei Verwendung des gRPC-Protokolls, die gleiche Portnummer verwenden, die Ihr M-Files Client für die Verbindung zum Server verwendet. Weitere Informationen finden Sie im Abschnitt Verbindung mit Dokumentenverwaltung hinzufügen. Sicherstellen, dass die notwendigen Ports der Firewall geöffnet sind.	443 oder 7766
	Secure	Diese Einstellung gibt an, ob eine Verbindung über einen sicheren Kanal (SSL-verschlüsselt) verwendet wird. In Produktionsumgebungen werden unsichere Verbindungen nicht empfohlen.	Yes
	Vault GUID	Die GUID Ihrer Dokumentenverwaltung eingeben. Um die GUID der Dokumentenverwaltung anzuzeigen, mit der rechten Maustaste auf die Dokumentenverwaltung klicken und Eigenschaften auswählen. Die GUID wird im Eindeutige ID Feld im Eigenschaften der Dokumentenverwaltung Dialogfeld angezeigt.	{990827D8-8AF2-4A4EB1214C1A8AD8ECD0}
	Shared Secret	Den geteilten geheimen Schlüssel aus der Konfiguration der Dokumentenverwaltung kopieren. Die Kanalverbindung kann nicht aufgebaut werden, wenn der geteilte geheime Schlüssel nicht mit einem der für Ground Link angegebenen geteilten geheimen Schlüsseln übereinstimmt.
	Reconnect Interval	Dieser Wert gibt in Sekunden an, wie häufig der Ground Link Proxy versucht, eine Verbindung herzustellen, wenn die Verbindung zur Dokumentenverwaltung unterbrochen wird.	60 (Standardwert)
	Keep Alive Interval	Dieser Wert gibt in Sekunden an, wie häufig der Ground Link Proxy sicherstellt, dass die Verbindung zur Dokumentenverwaltung ordnungsgemäß funktioniert.	60 (Standardwert)
	Timeouts	Timeout-Werte geben in Sekunden an, wie lange Remote-Aufrufe auf eine Antwort warten. Verwenden Sie die Standardwerte.
Multi-Server Compatibility	Check Compatibility	Diese Einstellung gibt an, ob die Multi-Server Mode-Kompatibilität geprüft wird. Wenn Sie eine Verbindung zwischen dem Ground Link Proxy und einer M-Files Cloud Dokumentenverwaltung herstellen, muss diese Einstellung auf Yes festgelegt werden.	Yes (Standardwert)

Optional: Die weiteren Einstellungen festlegen.
Weitere Informationen erhalten Sie auf der Info Registerkarte, wenn Sie eine Einstellung auswählen.
Auf Save klicken.

Die Verbindung zwischen der Dokumentenverwaltung und dem Ground Link Proxy wurde hergestellt. Als nächstes können Sie die Ground Link Services in der Dokumentenverwaltung einrichten.

Sie können den Status der Verbindung mit der Dokumentenverwaltung auf der Registerkarte Dashboard anzeigen.

Externe Objekttypen über Ground Link konfigurieren

In diesem Beispiel wird gezeigt, wie Sie M-Files OLE DB External Object Type Connector in einer Dokumentenverwaltung als Ground Link Service zum Aktualisieren von Objekttypen für oder aus einer externen Datenbank konfigurieren. Sie können auch den external object type (EOT) Konnektor für Wertelisten verwenden. Anleitungen zum Konfigurieren anderer verfügbarer M-Files EOT-Konnektoren finden Sie unter Installing and Configuring M-Files Connector for Salesforce und Installing and Configuring M-Files Connector for Microsoft Dynamics 365 im M-Files Support Portal.

Stellen Sie auf dem Ground Link Proxy-Server sicher, dass die M-Files OLE DB External Object Type Connector Anwendung aktiviert ist:

M-Files Admin öffnen.
In der hierarchischen Ansicht auf der linken Seite, eine Verbindung zum M-Files Server erweitern.
Ground Link-Proxys erweitern.
Klicken Sie mit der rechten Maustaste auf einen Ground Link Proxy und wählen Sie Anwendungen.
Ergebnis:Das Anwendungen Dialogfeld wird geöffnet.
Suchen Sie in der Liste der Anwendungen M-Files OLE DB External Object Type Connector und vergewissern Sie sich, dass ihr Status Aktiviert ist. Standardmäßig ist die Anwendung deaktiviert.
Um die Funktion zu aktivieren, die folgenden Schritte durchführen:
1. M-Files OLE DB External Object Type Connector auswählen.
2. Auf Aktivieren klicken.
3. Im angezeigten Dialogfeld auf Ja klicken, um den Ground Link Proxy neu zu starten.
Auf Schließen klicken, um das Anwendungen Dialogfeld zu schließen.
Vergewissern Sie sich auf dem Dashboard des Ground Link Proxys, dass eine Verbindung zwischen der Dokumentenverwaltung und dem EOT-Konnektor besteht:
- Cloud Vault Connection zeigt einen grünen Kreis () an.
- Unter Installed Connectors, M-Files OLE DB External Object Type Connector wird angezeigt, dass mindestens ein Server verbunden ist.
  
  Beispiel:
  
  Hinweis: Nachdem die Anwendung aktiviert wurde, kann es einige Minuten dauern, bis die Serververbindung für den EOT-Konnektor hergestellt ist. Falls erforderlich auf Refresh klicken, um die Ansicht zu aktualisieren.

Als nächstes einen Objekttyp erstellen, der den EOT-Konnektor für die Dokumentenverwaltung verwendet:

M-Files Admin öffnen und zu einer Dokumentenverwaltung wechseln, für die Sie die Ground Link Verbindung aktiviert haben.
1. M-Files Admin öffnen.
2. In der hierarchischen Ansicht auf der linken Seite, eine M-Files Serververbindung erweitern.
3. Dokumentenverwaltungen erweitern.
4. Eine Dokumentenverwaltung erweitern.
Die Metadatenstruktur (Flache Ansicht) erweitern.
Auf Objekttypen klicken.
Im Aufgabenbereich auf Neuer Objekttyp klicken.
Ergebnis:Das Eigenschaften des Objekttyps Dialogfeld wird geöffnet.
Die Informationen auf den Registerkarten Allgemein, Erweitert und Berechtigungen eingeben. Siehe Einen neuen Objekttyp erstellen für weitere Anleitungen.

Schließlich die Verbindung zur externen Datenbank konfigurieren:

Im Eigenschaften des Objekttyps Dialogfeld zur Verbindung mit einer externen Datenbank Registerkarte wechseln und die Objekte in einer externen Datenbank können über eine Verbindung mit dieser Datenbank importiert und geändert werden Option aktivieren.
Anwendungsverbindung auswählen.
Unter Service M-Files OLE DB von Ground Link-Proxy <Name des Ground Link-Proxys> auswählen.
Auf Konfigurieren klicken.
Wenn M-Files Sie fragt, ob Sie den Objekttyp erstellen möchten, Ja wählen.
Im External Object Type Connector Dialogfeld die Verbindung zur externen Datenbank konfigurieren. Siehe Verbindungen mit externen Datenbanken für Objekttypen für weitere Anleitungen.
Nach dem Speichern der Konfiguration, diese Schritte durchführen, um sicherzustellen, dass die Verbindung fehlerfrei funktioniert:
1. Auf Test Select in der oberen rechten Ecke des Dialogfelds klicken, um die SELECT Anweisung zu testen. Ist der Test erfolgreich, zeigt M-Files eine Zusammenfassung der Eigenschaftszuordnungen an. Andernfalls werden Fehler angezeigt. In diesem Fall die Konfiguration bearbeiten und es erneut versuchen.
2. Sicherstellen, dass keine Fehler auf den Registerkarten Local und Server in der unteren linken Ecke des Dialogfelds angezeigt werden. Wenn Fehler angezeigt werden, die angegebenen Informationen verwenden, um diese zu beheben.
Auf Schließen klicken, um das External Object Type Connector Dialogfeld zu schließen.
Im Eigenschaften des Objekttyps Dialogfeld auf OK klicken.

Der Objekttyp wird nun in und aus der externen Datenbank aktualisiert.

Konfiguration von Konnektoren über Ground Link

In diesem Beispiel wird gezeigt, wie Sie M-Files Network Folder Connector in der Dokumentenverwaltung als Ground Link Service speichern. Informationen zur Unterstützung anderer Ports finden Sie unter wenden Sie sich über das M-Files Support Portal an unseren Kundendienst oder an Ihren M-Files Händler.

Vor dem Beginnen sicherstellen, dass M-Files Network Folder Connector auf dem Ground Link Proxy installiert ist, der mit Ihrer Dokumentenverwaltung verbunden ist.

Um eine Verbindung zu einem Ground Link Proxy zu konfigurieren, die folgenden Schritte durchführen:

M-Files Admin öffnen und zu einer Dokumentenverwaltung wechseln, für die Sie die Ground Link Verbindung aktiviert haben.
1. M-Files Admin öffnen.
2. In der hierarchischen Ansicht auf der linken Seite, eine M-Files Serververbindung erweitern.
3. Dokumentenverwaltungen erweitern.
4. Eine Dokumentenverwaltung erweitern.
Auf Konfigurationen klicken.
Im Navigationsbereich External Repositories erweitern.
Auf Ground Link klicken.

Auf der Dashboard Registerkarte werden die verbundenen Ground Link Proxys mit den verfügbaren Ground Link Services angezeigt. Sicherstellen, dass der zu konfigurierende Service – im konkreten Fall Network Folder – online ist.
Im ausgegrauten Navigationsbereich zuerst den Ground Link Knoten und dann den Ground Link Proxy, dessen Service verwendet werden soll, erweitern.
Im ausgegrauten Navigationsbereich den Ground Link Service auswählen – in diesem Fall Network Folder.
Auf der Dashboard Registerkarte Add Connection auswählen.
Im angezeigten Bestätigungsdialogfeld auf OK klicken.
Auf der Dashboard Registerkarte auf Configure klicken, um die neue Verbindung zu konfigurieren.
Weitere Informationen finden Sie im Abschnitt Installing and Configuring M-Files Network Folder Connector.
Auf Save klicken.
Auf Apply klicken.
Ergebnis:Das Enter Password Dialogfeld wird geöffnet.
Das in der Ground Link Proxy-Konfiguration festgelegte Passwort eingeben.
Optional: Hintergrundbenutzer authentifizieren. Nach der Eingabe der Anmeldeinformation die Einstellungen erneut sichern und übernehmen.
Weitere Informationen finden Sie im Abschnitt Installing and Configuring M-Files Network Folder Connector.
Auf Save klicken.
Optional: Die Schritte von 5 bis 12 wiederholen, um weitere Verbindungen hinzuzufügen.

Nun können Sie über die Dokumentenverwaltung auf lokale Netzwerkordner zugreifen. Die Objekte in den Netzwerkordnern werden in M-Files angezeigt. Diese können Sie wie Objekte der Dokumentenverwaltung bearbeiten und ihnen Metadaten zuweisen.