Exécuter une requête

UiPath.Database.Activities.ExecuteQuery

Exécute une requête sur une base de données et renvoie le résultat de la requête dans un DataTable.

Propriétés

Commun

• Poursuite sur erreur (ContinueOnError) - Spécifie si l'automatisation doit continuer même si l'activité génère un message d'erreur. Ce champ prend uniquement en charge les valeurs booléennes (True, False). La valeur par défaut est False. Par conséquent, si le champ est vide et si une erreur est renvoyée, l'exécution du projet s'interrompt. Si la valeur est configurée sur True, l'exécution du projet continue indépendamment de toute erreur.

  Remarque : si cette activité est incluse dans l'activité Try Catch et que la valeur de la propriété ContinuerSurErreur est « True », aucune erreur ne sera détectée lors de l'exécution du projet.
• NomAffichage (DisplayName) - Nom affiché de l'activité. Ce champ prend uniquement en charge les variables String.
• Délai d'attente (Timeout ) - Spécifie la durée (en millisecondes) à attendre pour que la commande sql s'exécute avant qu'une erreur soit renvoyée. La valeur par défaut est de 30 000 millisecondes (30 secondes) et doit être supérieure ou égale à 0. Ce champ ne prend en charge que les variables Int32 .
  Remarque : la durée spécifiée dans ce champ n'inclut pas le temps de réponse pour la récupération des résultats de la requête. Cela signifie que la durée totale d'exécution de l'activité peut être supérieure à la durée réelle d'exécution de la requête, à laquelle la propriété TimeoutMS s'applique.

Configuration des connexions

• Nom du fournisseur (ProviderName) - Nom du fournisseur de base de données utilisé pour accéder à la base de données. Ce champ prend uniquement en charge les variables String.
• Chaîne de connexion (ConnectionString) - Chaîne de connexion utilisée pour établir une connexion à la base de données. Ce champ prend uniquement en charge les variables String.
• Connexion existante (Existing Connection) - Une connexion à une base de données déjà ouverte obtenue à partir des activités Se connecter (Connect) ou Démarrer une transaction (Start Transaction). Si une telle connexion est fournie, les propriétés ConnectionString et SecureConnectionString sont ignorées. Ce champ ne prend en charge que les variables DatabaseConnection .
• SecureConnectionString : la chaîne de connexion utilisée pour établir une connexion à la base de données en tant que chaîne sécurisée. Ce champ ne prend en charge que SecureString variables.

Entrée

• Paramètres : un dictionnaire de paramètres nommés liés à la commande sql. La liaison est effectuée en spécifiant l'instruction @parameterName dans la commande sql. Au moment de l'exécution, le nom du paramètre sera remplacé par sa valeur provenant du dictionnaire.
• Sql - Une commande SQL à exécuter. Ce champ doit être rempli en fonction de la sélection effectuée dans la propriété CommandType. Ce champ ne prend en charge que String variables.

Divers

• TypeCommande - Spécifie la façon dont une chaîne de commande est interprétée. Les options suivantes sont disponibles :

  • Texte - Exécute la requête indiquée dans le paramètre SQL.
  • StoredProcedure : invoque le nom de la procédure spécifié dans le paramètre SQL.
  • TableDirect : invoque tous les enregistrements d'une table.
• Privé (Private) - Si cette option est sélectionnée, les valeurs des variables et des arguments ne sont plus enregistrées au niveau Détaillé (Verbose).

Sortie

• Table de données ( DataTable ) - Sortie de la commande SQL encapsulée dans une variable DataTable .
  Remarque : Lorsque vous interrogez une table comportant des colonnes avec le type de données Date , les colonnes correspondantes dans la sortie DataTable seront de type de données DateTime .