Connexions à des bases de données externes pour les Listes de valeurs

Vous pouvez configurer M-Files pour mettre à jour des listes de valeurs vers et depuis une base de données externe.

Cette rubrique vous indique comment définir les listes de valeurs pour utiliser une connexion d'application à une base de données externe. Pour utiliser une connexion à la base de données selon l'ancienne méthode, consultez la rubrique Utilisation de la connexion à la base de données selon l'ancienne méthode pour les Listes de valeurs.

Conditions préalables

Prenez note des informations importantes suivantes avant de commencer la configuration :

  • Avant de configurer une connexion d'application à une base de données externe, vous devez avoir un connecteur de type d'objet externe installé et activé.
    • Le connecteur doit prendre en charge la connexion d'application. Vous pouvez utiliser M-Files OLE DB External Object Type Connector, qui est normalement installé pour le coffre mais désactivé.
    • Si vous utilisez le service Ground Link, le connecteur doit être activé sur le proxy Ground Link. Consultez Configuration des types d'objets externes via Ground Link pour obtenir les instructions. Si vous utilisez un service local, le connecteur doit être activé dans le coffre.
  • Si vous utilisez la réplication et la connexion d'application à un service de base de données externe, vous devez configurer la connexion séparément pour chaque coffre du mécanisme de réplication. Assurez-vous que les modifications de configuration nécessaires sont également apportées à chaque coffre. Nous vous recommandons également de lire la section Replication of External Objects du document Replication and Archiving - User's Guide.
  • Il est impossible d'inclure la configuration pour External Object Type Connector dans les paquets de réplication.
  • Dans les expressions SELECT FROM, les colonnes sont sélectionnées par ordre d'apparition. Il n'y a aucun lien entre les noms de colonnes et de propriétés, ce qui explique pourquoi l'ordre doit être le même dans les expressions SELECT FROM et INSERT INTO et dans les expressions SELECT FROM et UPDATE. Par ailleurs, les colonnes non utilisées dans les expressions INSERT INTO et UPDATE doivent toujours être répertoriées en dernier dans l'expression SELECT FROM.

Pour utiliser une connexion à une base de données externe et ouvrir la configuration du service :

  1. 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.
  2. Développez Structure des Métadonnées (Vue Classique).
  3. Cliquez sur Listes de valeurs.
    Résultat :La liste de liste de valeurs s’ouvre dans le volet droit.
  4. Dans la liste du volet droit, double-cliquez sur le liste de valeurs.
    Résultat :La boîte de dialogue Propriétés de la Liste de valeurs s'ouvre.
  5. Rendez-vous dans l'onglet Connexion à une Base de Données Externe et cochez l'option Utiliser·une·connexion·à·une·base·de·données·externe·pour·synchroniser·et·modifier·des·objets·se·trouvant·dans·cette·base.
  6. Sélectionnez Connexion·créée·via·une·application.
  7. Dans Service, sélectionnez le service.
    OptionDescription
    M-Files OLE DB dans le coffre <nom du coffre> Sélectionnez cette option pour utiliser le service local.
    M-Files OLE DB depuis le proxy Ground Link <nom du proxy Ground Link> Sélectionnez cette option pour établir la connexion avec un service distant par l'intermédiaire de Ground Link.

    Les services qui ont le suffixe (OK) ont une configuration pour le liste de valeurs.

    Résultat :Des informations relatives à la configuration du service et aux éventuelles erreurs s'affichent.
  8. Cliquez sur Configurer.
    Résultat :La boîte de dialogue External Object Type Connector s’ouvre.
Pour spécifier les paramètres de connexion et obtenir les colonnes source :
  1. Déployez Service-Specific Settings > Connection to External Database.
  2. Dans Provider, sélectionnez le fournisseur pour la connexion à la base de données externe.
    Exemple :Microsoft OLE DB Driver for SQL Server.
    Remarque : La liste des fournisseurs indique tous les fournisseurs disponibles sur le serveur qui exécute le connecteur de type d'objet externe. Elle peut donc inclure des fournisseurs qui ne peuvent pas être utilisés dans les connexions à des bases de données externes.
    La syntaxe de la chaîne de connexion est différente pour chaque fournisseur Object Linking and Embedding Database (OLE DB) utilisé pour l'établissement de la connexion à la base de données externe. Si Open Database Connectivity (ODBC) est nécessaire pour créer la connexion, il faut accéder au stock de données via OLE DB et ODBC. Pour obtenir une liste des fournisseurs recommandés, consultez Recommandations du fournisseur pour les connexions aux bases de données externes.
  3. Optionnelle : Si vous avez sélectionné Custom provider (manual configuration), dans Custom provider, indiquez le fournisseur.
  4. Sous Connection to External Database, exécutez l'une des étapes suivantes :
    OptionDescription
    Indiquez les autres paramètres.

    Les valeurs correctes sont différentes pour chaque fournisseur et base de données externe.

    Pour davantage d'informations, sélectionnez un paramètre et consultez l'onglet Info.
    Dans Advanced Options, saisissez la chaîne de connexion. Utilisez cette option s'il est impossible d'utiliser les autres paramètres avec le fournisseur sélectionné. Lorsque vous saisissez la chaîne de connexion, assurez-vous que toutes les valeurs sont correctement encadrées et que la chaîne de connexion a le formatage nécessaire.
  5. Optionnelle : Dans Optional SELECT Statements, définissez les paramètres.
    Remarque : La connexion d'application ne prend pas en charge les paramètres Connections to External Databases de la section Advanced Vault Settings de M-Files Admin. Pour utiliser les paramètres suivants, définissez-les ici.
  6. Sous Service-Specific Settings, dans SELECT Statement, saisissez l'expression SELECT permettant d'obtenir les colonnes sources depuis la base de données externe.
    Exemples d'expressions SELECT :

    SELECT CustomerNumber, CustomerName FROM Customer

    SELECT ID, Name + ' ' + Department FROM Company

    SELECT ID, Name, CustomerID FROM Contacts

    SELECT * FROM Customer

    Conseil : Vous pouvez saisir une expression à plusieurs lignes.
  7. Cliquez sur Save.
  8. Optionnelle : Pour configurer un service à distance :
    1. Cliquez sur Apply.
      Résultat :La boîte de dialogue Enter Password s’ouvre.
    2. Saisissez le mot de passe qui est défini dans la configuration du proxy Ground Link.
    3. Cliquez sur OK.
  9. Pour authentifier l'utilisateur commun, ouvrez l'onglet Dashboard et cliquez sur Authenticate.
    Résultat :La boîte de dialogue Log In s’ouvre.
  10. Entrez les informations d'identification de l'utilisateur commun et cliquez sur Log In.
    Remarque : Le pilote ODBC ne prend pas en charge tous les caractères spéciaux. Si votre connexion utilise ODBC , les valeurs contenant des caractères spéciaux doivent être placées entre accolades. Le format correct est {nom d'utilisateur ou mot de passe}.
  11. Dans la boîte de dialogue qui s'ouvre, cliquez sur OK.
  12. Cliquez sur Save pour obtenir les colonnes sources.
    1. Optionnelle : Pour configurer un service distant, répétez l'étape 16.
    Remarque : Vous ne pouvez pas enregistrer la configuration s'il n'y a pas de modifications.
    Résultat :La boîte de dialogue se ferme et la configuration est actualisée. Dans l'onglet Configuration, la section Column Mappings affiche les colonnes source que votre expression SELECT a renvoyées depuis la base de données externe.
Pour mettre en correspondance les colonnes source avec les propriétés M-Files :
  1. Dans l'onglet Configuration, allez à Column Mappings et déployez un nœud de colonne source.
  2. Dans Mapping Type, indiquez comment la colonne source est mise en correspondance avec M-Files.
    • Pour mettre en correspondance une colonne source en tant qu'ID externe, sélectionnez Object ID.
    • Pour mettre en correspondance la colonne source en tant que nom de l'élément de la liste de valeurs, sélectionnez Name or Title.
    • Pour mettre en correspondance la colonne source en tant qu'ID de l'élément de la liste de valeurs propriétaire, sélectionnez Owner.
    • Pour mettre en correspondance la colonne source en tant qu'ID de l'élément parent de la liste de valeurs, sélectionnez Parent.
    Pour davantage d'informations sur la hiérarchie de la liste de valeurs, veuillez vous reporter à Hiérarchie de la liste de valeurs.
  3. Optionnelle : Si le Mapping Type est Name or Title, indiquez le paramètre Use in Insert Operation et définissez les expressions associées.
    Si vous souhaitez...Réalisez les étapes suivantes :
    Autoriser l'accès en lecture seule Définissez le paramètre Use in Insert Operation sur No. N'indiquez pas les expressions dans ce tableau.
    Permettre aux utilisateurs de créer des informations, mais pas de les mettre à jour ni de les supprimer
    1. Définissez le paramètre Use in Insert Operation sur Yes.
    2. Sous Service-Specific Settings, dans INSERT INTO statement, saisissez les deux expressions dans ce tableau.
    Expression Définition Exemples
    UPDATE Lorsque vous modifiez un objet dans M-Files, M-Files Server modifie l'enregistrement correspondant dans la base de données externe à l'aide de l'expression UPDATE. Utilisez un point d'interrogation (?) pour indiquer les champs à mettre à jour.

    UPDATE Customers SET CustomerName = ? WHERE CustomerID = ?

    UPDATE Contact SET Name = ?, CustomerID = ? WHERE ContactID = ?
    INSERT INTO Lorsque vous créez un nouvel élément de la liste de valeurs dans M-Files, M-Files Server ajoute l’enregistrement correspondant dans la base de données externe à l'aide de l'expression INSERT INTO. Utilisez un point d'interrogation (?) pour indiquer la valeur de chaque champ.
    Remarque : L'expression INSERT INTO dans M-Files ne définit pas de valeur d'identifiant pour les champs. La base de données doit être configurée pour fournir automatiquement un identifiant aux nouveaux enregistrements. Dans des bases de données Microsoft SQL Server par exemple, configurez le type de la colonne ID en tant qu’identité. Si la base de données externe ne peut créer de nouveaux ID, l'expression INSERT INTO ne peut pas être utilisée.

    INSERT INTO Customers( CustomerName ) VALUES( ? )

    INSERT INTO ContactPersons( Name, CustomerID ) VALUES( ?, ? )
    Get ID SELECT Une fois qu’un nouvel enregistrement a été créé avec l’expression INSERT INTO, M-Files Server obtient l’identifiant de l’enregistrement qui vient d’être créé à l’aide de cette expression SELECT.

    SELECT MAX( CustomerID ) FROM Customer
    DELETE Lorsque vous supprimez un objet dans M-Files, M-Files Server supprime l'enregistrement correspondant de la base de données externe à l'aide de l'expression DELETE. Utilisez un point d'interrogation (?) pour l'identifiant de l'enregistrement à supprimer.

    DELETE FROM Customers WHERE CustomerID = ?

    DELETE FROM Contacts WHERE ContactID = ?
  4. Répétez les étapes de 21 à 23 pour toutes les colonnes sources nécessaires.
Pour utiliser la configuration :
  1. Sous General Settings, définissez Enabled sur Yes.
    Conseil : Vous pouvez également activer et désactiver la connexion à la base de données externe à l'aide de la case à cocher Désactivée située dans l'onglet Connexion à une Base de Données Externe de la boîte de dialogue Propriétés de la Liste de valeurs.

    Si la connexion est désactivée, les informations entre le coffre et la base de données externe ne sont pas synchronisées.

  2. Optionnelle : Pour configurer un service à distance :
    1. Cliquez sur Apply.
      Résultat :La boîte de dialogue Enter Password s’ouvre.
    2. Saisissez le mot de passe qui est défini dans la configuration du proxy Ground Link.
    3. Cliquez sur OK.
  3. Cliquez sur OK pour fermer la boîte de dialogue Propriétés de la Liste de valeurs.
Le liste de valeurs est maintenant mis à jour vers et depuis la base de données externe.