Utilisation de l\'action Connecter pour la base de données

L\' Connecter action vous permet d\'établir une connexion avec un serveur de bases de données que vous souhaitez utiliser pour automatiser des tâches liées aux bases de données. Cette action prend en charge les serveurs de bases de données Microsoft Access, Microsoft SQL Server, MySQL, Serveur PostgreSQL , et SQLite, ainsi que l\'utilisation de fichiers CSV, Microsoft Excel et TXT en tant que bases de données.

Important : Si votre installation de bureau actuelle est l\'une des suivantes :
  • Microsoft 365 Apps for Enterprise
  • Office 2016, 2019 ou 2021 (version grand public 2009 ou ultérieure)

Dans ce cas, vous n\'avez pas besoin d\'installer le moteur de base de données Microsoft Access en tant que composant supplémentaire dans votre système.

Toutefois, si Microsoft 365 Apps et le moteur de base de données Microsoft Access sont installés sur votre système, vous pouvez désinstaller le moteur de base de données Microsoft Access et réparer Microsoft 365 Apps.

Microsoft vous recommande de ne pas installer séparément le pilote du moteur de base de données Microsoft Access, car le moteur de base de données Microsoft Access 2016 et Microsoft 365 Apps utilisent le même identifiant de version majeure (16.0). Pour en savoir plus sur la condition d\'installation du pilote du moteur de base de données Microsoft Access, consultez la rubrique Unable to use the Access ODBC or OLEDB provider.
Remarque : Le pilote SQL Server ne dépend pas de l\'installation de Microsoft Office. Seule la version du pilote Excel dépend de la version de Microsoft Office. Cependant, si vous souhaitez utiliser un autre pilote, tel que Notepad ou CSV, vous devez installer le pilote ODBC pris en charge correspondant.

Spécifiez les détails du serveur de bases de données et associez-le à un nom de session. Utilisez le nom de session indiqué dans cette action dans les autres actions pour éviter d\'avoir à fournir à nouveau les détails du serveur de base de données dans ces actions.

Procédure

Pour établir une connexion avec un serveur de bases de données, procédez comme suit :

  1. Double-cliquez sur l\' Connecter action à partir du Base de données package dans la palette Actions.
  2. Sélectionnez l\'option de connexion Par défaut ou Définie par l\'utilisateur.
    Lorsque vous sélectionnez le mode de connexion Définie par l\'utilisateur et que vous utilisez action Lire depuis avec le codage ANSI pour enregistrer les données récupérées dans un fichier CSV, vous constatez que les enregistrements récupérés dans la base de données Oracle affichent des caractères tronqués.

    Pour en savoir plus sur ce problème, consultez la rubrique Fullwidth hyphen is garbled when exporting data to csv by Database: Read from action with encoding ANSI (A-people login required).

    • Si vous sélectionnez l\'option Par défaut, vous pouvez saisir directement la chaîne de connexion pour toute base de données prenant en charge les chaînes de connexion JDBC et un pilote 64 bits. Pour obtenir la liste des bases de données prises en charge, consultez la rubrique Matrice de support du serveur de base de données.
      Remarque : Lorsque vous sélectionnez l\'option Par défaut pour vous connecter à un fichier Excel et que vous utilisez des caractères non anglais dans un fichier Excel, vous devez utiliser le codage UTF-8 pour prendre en charge les caractères Unicode.

      Si vous avez configuré votre base de données et votre référentiel partagé dans le secondairevotre site, utilisez la connexion JDBC pour vous connecter à la base de données réplique. Par exemple, jdbc:sqlserver://AGL-ADDRESS:1433;databaseName=DB_NAME;user=username;password=password;applicationIntent=ReadOnly

      Vous pouvez établir une connexion avec la base de données Snowflake à l\'aide de pilotes ODBC. Pour plus d\'informations sur le téléchargement du pilote ODBC, référez-vous à Snowflake using ODBC Driver

      Vous pouvez saisir la chaîne de connexion pour vous connecter à la base de données. Par exemple, Driver={SnowflakeDSIIDriver};Server={account}.aws.snowflakecomputing.com;Database=DB_NAME;uid=username;pwd=password;

      Utilisez cette option pour vous connecter à un fichier Excel, CSV ou TXT. Reportez-vous à la rubrique Connection Strings by database type.

      Remarque : Pour accéder à une base de données via ODBC, vous devez d\'abord installer un pilote ODBC 32 bits sur votre périphérique.

      Paramètre : Vous pouvez utiliser les valeurs d\'information d\'identification de la consigne dédiée sans exposer les infos d\'identification (nom d\'utilisateur ou mot de passe) en texte brut dans la chaîne de connexion. Pour ce faire, vous devez mapper les infos d\'identification dans le mappeur d\'infos d\'identification, puis utiliser le nom du paramètre dans la chaîne de connexion entre accolades doubles.

      Par exemple, si le nom du paramètre est db_username et que la valeur du paramètre est sélectionnée à partir de la valeur d\'information d\'identification, la chaîne de connexion avec 3 paramètres est la suivante : “Provider=SQLOLEDB.1;Initial Catalog=master;Password={{db_credentials}};Persist Security Info=True;User ID={{db_username}};Data Source={{db_datasource}}”

      Pour utiliser le mot de passe de la consigne d\'informations d\'identification, procédez comme suit :
      1. Cliquez sur Ajouter un paramètre.
      2. Renseignez le champ Nom du paramètre.
      3. Dans le champ Valeur du paramètre, sélectionnez Information d\'identification pour utiliser une valeur disponible dans le coffre d\'informations d\'identification, Variable pour utiliser une variable d\'information d\'identification ou Chaîne non sécurisée pour spécifier manuellement la valeur que vous souhaitez utiliser.
      4. Cliquez sur Ajouter.

      Afin de garantir une automatisation plus sécurisée, utilisez une variable Credential Vault pour la chaîne de connexion.

      Sélectionnez l\'option Utiliser le pilote ODBC 64 bits pour la connexion pour vous connecter à la base de données.
      Remarque :
      • Assurez-vous que le pilote ODBC d\'accès 64 bits est installé sur votre système pour accéder à n\'importe quelle base de données et effectuer des opérations à l\'aide des actions de la base de données.
      • L\'action suivante n\'est pas compatible avec les pilotes OBDC 32 bits ou 64 bits, car les actions énumérées concernent des transactions de base de données qui sont effectuées après avoir établi une connexion avec la base de données :
        • Commencer une transaction de base de données
        • Terminer une transaction de base de données
        • Gérer la procédure stockée
      • Si vous utilisez Excel comme base de données, vous pouvez traiter plus de lignes avec des pilotes 64 bits qu\'avec des pilotes 32 bits.
    • Si vous sélectionnez l\'option Définie par l\'utilisateur, sélectionnez le type de base de données parmi les options disponibles et remplissez les champs suivants en fonction de la sélection :
      Type de base de données Options
      Microsoft SQL Server, Serveur PostgreSQL
      • Nom du serveur : saisissez le nom du serveur de bases de données auquel vous souhaitez vous connecter.
      • Nom de la base de données : saisissez le nom de la base de données.
      • Nom d\'utilisateur : saisissez le nom d\'utilisateur que vous souhaitez utiliser pour accéder au serveur de bases de données. Pour garantir l\'utilisation d\'un nom d\'utilisateur sécurisé, sélectionnez une variable Credential Vault. Sinon, saisissez une valeur.
      • Mot de passe: saisissez le mot de passe correspondant au nom d\'utilisateur que vous avez spécifié. Pour garantir l\'utilisation d\'un mot de passe sécurisé, sélectionnez une variable Credential Vault. Sinon, saisissez une valeur.
      • Nom de l\'instance : saisissez un nom pour cette instance de connexion.
      • Champ Délai d\'expiration en secondes (facultatif) : spécifiez le délai entre 1 et 9999 pendant lequel vous souhaitez que le système attende avant d\'annuler un robot.

        L\'automatisation expirera et échouera si la connexion à la base de données n\'est pas établie dans le délai spécifié. Si vous ne saisissez pas de valeur dans le champ Délai d\'expiration en secondes (facultatif), le délai d\'expiration par défaut spécifié dans la bibliothèque du pilote est utilisé.

        Remarque : Microsoft SQL Server ne prend en charge que cette option.
      Se connecter à un Microsoft SQL Server avec l'authentification Windows
      MySQL Saisissez les mêmes options que dans le type Microsoft SQL Server de base de données. Saisissez également le numéro de port. Le numéro de port par défaut est 3306.
      Remarque : Nous vous recommandons de ne pas utiliser le pilote My SQL version 8.0.40 car si vous exécutez des procédures stockées paramétrées à l\'aide de cette version, vous risquez de rencontrer certains problèmes. Contactez Automation Anywhere Customer Success Manager (CSM) pour obtenir de l\'aide.
      Microsoft Access, SQLite Sélectionnez le chemin de fichier de base de données dans :
      • dossier Robots
      • périphérique local
      • variable de fichier existante
      Remarque : Si vous établissez une connexion en utilisant un pilote JDBC, pour Microsoft SQL Server, le Base de données package inclut déjà le pilote JDBC. Cependant, pour les autres serveurs de bases de données, vous devez fournir le fichier jar du pilote JDBC correspondant après l\'avoir téléchargé depuis les ressources appropriées.

      Si vous établissez une connexion en utilisant un pilote ODBC, vous n\'avez pas besoin de fournir de fichier jar.

  3. Sélectionnez un fichier pilote dans le dossier Robots, le périphérique local ou une variable de fichier.
  4. Sélectionnez l\'un des onglets suivants pour créer une session de base de données :
    • Session locale : Spécifiez un nom de session qui ne peut être utilisé que dans le robot en cours.
    • Session globale : Spécifiez un nom de session qui peut être utilisé sur plusieurs robots, notamment des robots parents et des robots enfants.
      Recommendation : Les robots parents et enfants doivent avoir la même version du package.
    • Variable : Spécifiez ou créez une variable de session du sous-type Session de base de données.
  5. Cliquez sur Enregistrer.

Étapes suivantes

Choisissez l\'une des options suivantes :
  • Utilisez l\'action Lire depuis pour récupérer les enregistrements de la base de données.

    Utilisation de l\'action Lire depuis

  • Si vous automatisez une tâche qui implique d\'apporter des modifications à la base de données, insérez l\' Commencer une transaction de base de données action.

    Cette action garantit que tous les enregistrements seront mis à jour ou supprimés dans leur intégralité, et empêche les mises à jour ou suppressions accidentelles de données incomplètes si le robot rencontre une erreur pendant le temps d\'exécution.

    Base de données package