Configuration de M-Files Ground Link

Avant de configurer la fonction Ground Link, assurez-vous que les conditions préalables suivantes sont remplies :

Les connexions gRPC sont autorisées sur le serveur in-situ sur lequel le proxy Ground Link sera configuré. Ce serveur sera appelé serveur proxy Ground Link dans la suite de ces instructions.

Si vous connectez le proxy Ground Link à un coffre in-situ, assurez-vous également que les conditions préalables suivantes sont remplies :

Les connexions gRPC sont autorisées sur le serveur M-Files.
Le serveur M-Files dispose d'un certificat TLS valide pour le cryptage des connexions gRPC.

Pour plus d'informations, reportez-vous au document de la base de connaissances Setting Up M-Files to Use gRPC.

Pour configurer la fonction Ground Link, vous devez d'abord installer des connecteurs de référentiel externe sur un proxy Ground Link. Vous devez ensuite configurer les connexions du référentiel dans le coffre. Par la suite, vous pourrez accéder aux données locales et les modifier directement depuis le coffre.

Activation de la connexion Ground Link

Exécutez les étapes suivantes pour activer la connexion de canal pour Ground Link dans un coffre :

Ouvrez M-Files Admin et accédez à un coffre.
1. Ouvrez M-Files Admin.
2. Dans l'arborescence de gauche, déployez une connexion au serveur M-Files.
3. Déployez Coffres.
4. Déployez un coffre.
Cliquez sur Configurations.
Dans la zone de navigation, déployez Advanced Vault Settings > Configuration.
Cliquez sur Ground Link.
Dans l'onglet Configuration, définissez Enabled sur Yes.
Cliquez sur Save.
Redémarrez le coffre pour que les paramètres entrent en vigueur.

Remarque : La mise hors ligne d’un coffre devrait toujours être réalisée de manière contrôlée et les utilisateurs de coffre devraient en être informés à l’avance.
Dans la zone de navigation grise, déployez External Repositories > Ground Link puis sélectionnez Configuration.

Dans l'onglet Configuration, indiquez les paramètres suivants :


Nom du paramètre		Description	Exemple de valeur
Enabled		Ce paramètre indique si Ground Link est activé ou non.	Yes
Remoting Service	Shared Secrets	Un secret partagé permet à un proxy Ground Link d'authentifier le coffre. Assurez-vous que le secret partagé est complexe et suffisamment long. Vous pouvez indiquer un ou plusieurs secrets partagés. Vous devez saisir le secret partagé lorsque vous configurez le proxy Ground Link.
Remoting Service	Timeouts	Les valeurs de délai d’attente indiquent la durée en secondes pendant laquelle les appels à distance vont attendre une réponse. Utilisez les valeurs par défaut. Remarque : Ces paramètres ne sont pas disponibles pour les coffres M-Files Cloud.
Keep Alive Interval		Ce paramètre indique la fréquence en secondes à laquelle le coffre vérifie que les services Ground Link sont connectés.	60 (valeur par défaut)

Optionnelle : Indiquez les autres paramètres.
Pour davantage d'informations, sélectionnez un paramètre et consultez l'onglet Info.
Cliquez sur Save.

Maintenant que le coffre utilise Ground Link, vous pouvez configurer le proxy Ground Link.

Configuration d'un proxy Ground Link

Avant de commencer, assurez-vous que les conditions préalables suivantes sont remplies :

Votre serveur proxy Ground Link a suffisamment de ressources matérielles. Reportez-vous à la configuration matérielle recommandée.
M-Files Server et M-Files Admin sont installés sur le serveur proxy Ground Link. Une licence distincte pour M-Files Server n'est toutefois pas nécessaire.
Vous êtes connecté à M-Files Server avec un compte de connexion ayant le rôle serveur Administrateur système. Pour créer un compte de connexion, reportez-vous à Créer un compte de connexion.
Votre serveur proxy Ground Link peut se connecter aux ressources locales (par exemple, un dossier de réseau ou une base de données externe) que vous souhaitez rendre disponibles dans le coffre.

Pour configurer un proxy Ground Link sur le serveur proxy Ground Link :

Ouvrez M-Files Admin.
Dans l'arborescence de gauche, déployez une connexion au serveur M-Files.
Cliquez sur Proxies Ground Link.
Dans le volet droit, cliquez sur Nouveau proxy Ground Link.
Résultat :La boîte de dialogue Nouveau proxy Ground Link s'ouvre.
Saisissez un nom pour le proxy Ground Link.
Sélectionnez le moteur de base de données à utiliser pour le stockage des données du proxy Ground Link.
- Pour utiliser Firebird, sélectionnez Firebird.
  ou
- Pour utiliser Microsoft SQL Server, sélectionnez Microsoft SQL Server.
Pour davantage d'informations, veuillez vous reporter à Moteur de base de données et stockage des données.
Cliquez sur Définir.
Résultat :La boîte de dialogue des paramètres du moteur de base de données s'ouvre.

Effectuez l'une des opérations suivantes :

Option	Description
Dans la boîte de dialogue Proxy Ground Link - Firebird	Cliquez sur le bouton ... et sélectionnez l'emplacement de destination des données du proxy Ground Link. Cliquez sur OK pour fermer la boîte de dialogue.
Dans la boîte de dialogue Proxy Ground Link - Microsoft SQL Server	Suivez les étapes de 6 à 10 dans Migration de la base de données du proxy Ground Link vers Microsoft SQL Server.

Cliquez sur OK pour fermer la boîte de dialogue Nouveau proxy Ground Link.
Installez sur le proxy Ground Link qui vient d'être créé les connecteurs de référentiel externe que votre coffre va utiliser.

Remarque : Si une licence d'application de coffre valide est nécessaire pour un connecteur, la licence servira pour le coffre et pour le serveur contenant le coffre.

Pour davantage d'informations, veuillez vous reporter à Installer et gérer des applications pour coffre.

Exemple : Pour accéder aux dossiers de réseau local depuis M-Files Cloud, installez M-Files Network Folder Connector.

Résultat :Le proxy Ground Link est désormais prêt à être configuré.
Dans l'arborescence de gauche, sous Proxies Ground Link, sélectionnez le proxy Ground Link venant d'être créé.

Dans l'onglet Configuration, indiquez les paramètres suivants :


Nom du paramètre		Description	Exemple de valeur
Enabled		Ce paramètre indique si Ground Link est activé ou non.	Yes
Password		Saisissez un mot de passe que vous utiliserez lorsque vous appliquerez une configuration pour un service Ground Link dans le coffre.
Channel	Network Address	Saisissez l'emplacement réseau du serveur auquel se connecter. Si vous connectez le proxy Ground Link à un M-Files Cloud, saisissez le nom DNS du coffre.	aa-consulting.cloudvault.m-files.com
	Port number	Saisissez le port que le serveur écoute. Si vous connectez le proxy Ground Link à un coffre M-Files Cloud, le numéro de port correct est 443. Si vous utilisez le protocole gRPC, utilisez le même numéro de port que celui utilisé par votre client M-Files pour se connecter au serveur. Pour davantage d'informations, veuillez vous reporter à Ajouter une connexion à un coffre. Vérifiez que les ports nécessaires sont ouverts sur le coupe-feu.	443 ou 7766
	Secure	Ce paramètre indique si une connexion de canal sécurisée (cryptée SSL) est utilisée. Les connexions non sécurisées ne sont pas recommandées dans les environnements de production.	Yes
	Vault GUID	Saisissez l'ID de votre coffre. Pour voir l'ID du coffre, cliquez, à l'aide du menu bouton droit, sur le coffre et sélectionnez Propriétés. L'ID s'affiche dans le champ ID unique de la boîte de dialogue Propriétés du Coffre.	{990827D8-8AF2-4A4EB1214C1A8AD8ECD0}
	Shared Secret	Copiez le secret partagé depuis la configuration du coffre. La connexion du canal ne peut pas être établie si le secret partagé ne correspond pas à l’un des secrets partagés indiqués pour Ground Link.
	Reconnect Interval	Cette valeur indique la fréquence en secondes à laquelle le proxy Ground Link essaie de se connecter lorsque le coffre est déconnecté.	60 (valeur par défaut)
	Keep Alive Interval	Cette valeur indique la fréquence en secondes à laquelle le proxy Ground Link vérifie que la connexion au coffre fonctionne correctement.	60 (valeur par défaut)
	Timeouts	Les valeurs de délai d’attente indiquent la durée en secondes pendant laquelle les appels à distance vont attendre une réponse. Utilisez les valeurs par défaut.
Multi-Server Compatibility	Check Compatibility	Ce paramètre indique si la compatibilité avec le mode multi-serveur est vérifiée. Si vous connectez le proxy Ground Link à un M-Files Cloud, ce paramètre doit être défini sur Yes.	Yes (valeur par défaut)

Optionnelle : Indiquez les autres paramètres.
Pour davantage d'informations, sélectionnez un paramètre et consultez l'onglet Info.
Cliquez sur Save.

La connexion entre le coffre et le proxy Ground Link est établie. Vous pouvez ensuite configurer les services Ground Link dans le coffre.

Vous pouvez voir l’état de la connexion du coffre dans l’onglet Dashboard.

Configuration des types d'objets externes via Ground Link

Cet exemple vous explique comment configurer M-Files OLE DB External Object Type Connector dans un coffre en tant que service Ground Link pour mettre à jour les types d'objets vers et depuis une base de données externe. Vous pouvez également utiliser le connecteur external object type (EOT) pour les listes de valeurs. Pour savoir comment configurer les autres connecteurs de types d'objets externes (EOT) M-Files disponibles, reportez-vous à Installing and Configuring M-Files Connector for Salesforce et à Installing and Configuring M-Files Connector for Microsoft Dynamics 365 dans M-Files Support Portal.

Sur le serveur proxy Ground Link, assurez-vous que l'application M-Files OLE DB External Object Type Connector est activée :

Ouvrez M-Files Admin.
Dans l'arborescence de gauche, déployez une connexion au serveur M-Files.
Déployez Proxies Ground Link.
Cliquez, à l'aide du menu bouton droit, sur un proxy Ground Link et sélectionnez Applications.
Résultat :La boîte de dialogue Applications s’ouvre.
Dans la liste d'applications, recherchez M-Files OLE DB External Object Type Connector et assurez-vous que son statut est Activé. Par défaut, l'application est désactivée.
Pour activer l'application :
1. Sélectionnez M-Files OLE DB External Object Type Connector.
2. Cliquez sur Activer.
3. Dans la boîte de dialogue qui s'ouvre, cliquez sur Oui pour redémarrer le proxy Ground Link.
Cliquez sur Fermer pour fermer la boîte de dialogue Applications.
Dans le tableau de bord du proxy Ground Link, vérifiez que le coffre et le connecteur de type d'objet externe (EOT) sont connectés :
- Cloud Vault Connection affiche un cercle vert ().
- Dans Installed Connectors, M-Files OLE DB External Object Type Connector indique qu'un ou plusieurs serveurs sont connectés.
  
  Par exemple :
  
  Remarque : Une fois l'application activée, quelques minutes peuvent être nécessaires pour créer la connexion de serveur pour le connecteur de type d'objet externe (EOT). Si nécessaire, cliquez sur Refresh pour mettre à jour la vue.

Créez ensuite un type d'objet utilisant le connecteur de type d'objet externe (EOT) dans le coffre :

Ouvrez M-Files Admin et accédez à un coffre pour lequel vous avez activé la connexion Ground Link.
1. Ouvrez M-Files Admin.
2. Dans l'arborescence de gauche, déployez une connexion au serveur M-Files.
3. Déployez Coffres.
4. Déployez un coffre.
Développez Structure des Métadonnées (Vue Classique).
Cliquez sur Types d'Objet.
Dans le volet de commandes, cliquez sur Nouveau Type d'Objet.
Résultat :La boîte de dialogue Propriétés de Type d'Objet s'ouvre.
Indiquez les informations dans les onglets Général, Avancé et Autorisations. Consultez Création d’un nouveau type d'objet pour obtenir les instructions.

Enfin, configurez la connexion à la base de données externe :

Dans la boîte de dialogue Propriétés de Type d'Objet, allez dans l'onglet Connexion à une Base de Données Externe et activez l'option Utiliser une connexion à une base de données externe pour synchroniser et modifier des objets se trouvant dans cette base.
Sélectionnez Connexion·créée·via·une·application.
Dans Service, sélectionnez M-Files OLE DB depuis le proxy Ground Link <nom du proxy Ground Link>.
Cliquez sur Configurer.
Si M-Files demande si vous souhaitez créer le type d'objet, sélectionnez Oui.
Dans la boîte de dialogue External Object Type Connector qui est ouverte, configurez la connexion à la base de données externe. Consultez Connexions à des bases de données externes pour les Types d'Objet pour obtenir les instructions.
Après avoir enregistré la configuration, effectuez les opérations suivantes pour vous assurer que la connexion fonctionne sans erreurs :
1. Cliquez sur Test Select dans le coin supérieur droit de la boîte de dialogue pour tester l'expression SELECT. Si le test est réussi, M-Files affiche un récapitulatif des mappages de propriétés. Si le test échoue, les erreurs sont affichées à la place. Dans ce cas, modifiez la configuration puis réessayez.
2. Vérifiez qu'il n'y a pas d'erreurs dans les onglets Local et Server situés dans le coin inférieur gauche de la boîte de dialogue. S'il y a des erreurs, utilisez les informations fournies pour les corriger.
Cliquez sur Fermer pour fermer la boîte de dialogue External Object Type Connector.
Dans la boîte de dialogue Propriétés de Type d'Objet, cliquez sur OK.

Le type d'objet est maintenant mis à jour vers et depuis la base de données externe.

Configuration de connecteurs sur Ground Link

Cet exemple vous explique comment configurer M-Files Network Folder Connector dans un coffre en tant que service Ground Link. Pour obtenir des informations sur la prise en charge d’autres connecteurs, contactez notre service clientèle via M-Files Support Portal ou votre revendeur M-Files.

Avant de commencer, assurez-vous que M-Files Network Folder Connector est installé sur le proxy Ground Link qui est connecté à votre coffre.

Pour configurer une connexion à un proxy Ground Link :

Ouvrez M-Files Admin et accédez à un coffre pour lequel vous avez activé la connexion Ground Link.
1. Ouvrez M-Files Admin.
2. Dans l'arborescence de gauche, déployez une connexion au serveur M-Files.
3. Déployez Coffres.
4. Déployez un coffre.
Cliquez sur Configurations.
Dans la zone de navigation, déployez External Repositories.
Cliquez sur Ground Link.

Dans l’onglet Dashboard, vous voyez les proxys Ground Link raccordés et les services Ground Link disponibles. Vérifiez que le service que vous souhaitez configurer, dans le cas présent Network Folder, est en ligne.
Dans la zone de navigation grise, déployez tout d’abord le nœud Ground Link, puis le proxy Ground Link dont vous souhaitez utiliser le service.
Dans la zone de navigation grise, sélectionnez le service Ground Link, dans le cas présent Network Folder.
Dans l'onglet Dashboard, sélectionnez Add Connection.
Dans la boîte de dialogue de confirmation qui s'ouvre, cliquez sur OK.
Dans l'onglet Dashboard , cliquez sur Configure pour configurer la nouvelle connexion.
Pour davantage d'informations, veuillez vous reporter à la section Installing and Configuring M-Files Network Folder Connector.
Cliquez sur Save.
Cliquez sur Apply.
Résultat :La boîte de dialogue Enter Password s’ouvre.
Saisissez le mot de passe qui est défini dans la configuration du proxy Ground Link.
Optionnelle : Authentifiez les utilisateurs d’arrière-plan. Après avoir indiqué les identifiants, enregistrez et appliquez de nouveau les paramètres.
Pour davantage d'informations, veuillez vous reporter à la section Installing and Configuring M-Files Network Folder Connector.
Cliquez sur Save.
Optionnelle : Effectuez de nouveau les étapes de 5 à 12 pour ajouter d’autres connexions.

Vous avez désormais accès aux dossiers de réseau local à partir du coffre. Les objets des dossiers de réseau sont affichés dans M-Files. Vous pouvez les modifier et leur donner des métadonnées de la même façon que pour les objets stockés dans le coffre.