Utilisation de l'action Exécuter la fonction

Utilisez l'action Exécuter la fonction pour exécuter une fonction dans un fichier .dll, spécifier les paramètres à transmettre à une fonction et stocker le résultat en tant que variable.

  • Cette action vous permet de transmettre un paramètre de n'importe quel type.
  • L'action Exécuter la fonction ne prend pas en charge l'utilisation de Windows Forms.
  • Si le fichier .dll utilise des fonctions .NET ou des classes d'un autre fichier .dll, vous devez ajouter le deuxième fichier .dll en tant que dépendance manuelle du robot.

    Dépendances de Robot

  • Cette action prend en charge les fonctions surchargées à partir d'Enterprise A2019.17. L'action peut gérer des fichiers .dll qui contiennent plusieurs fonctions du même nom. Elle appelle la fonction selon le nombre de paramètres transmis.
  • Lorsque vous utilisez cette action, veillez à utiliser les types de données pris en charge pour les fonctions DLL.

    package DLL

Procédure

Pour exécuter une fonction, effectuez les étapes suivantes :

  1. Dans la palette Actions, double-cliquez sur l'action Exécuter la fonction ou faites-la glisser à partir du package DLL.
  2. Dans le champ Nom de session, entrez le nom de la session.
  3. Dans le champ Entrer l'espace de noms (facultatif), spécifiez l'espace de noms.
    Vous pouvez spécifier l'un des espaces de noms définis dans le fichier DLL.
    Remarque : Assurez-vous que la valeur indiquée dans le champ est correcte.
    Important : Ce champ est sensible à la casse.
  4. Dans le champ Saisir le nom de la classe, spécifiez le nom de la classe.
    Vous pouvez spécifier le nom d'une des classes disponibles dans l'espace de noms.
    Important : Ce champ est sensible à la casse.
  5. Dans le champ Saisir le nom de la fonction à exécuter, spécifiez le nom de la fonction que vous souhaitez exécuter.
    Assurez-vous que le nom indiqué est correct et disponible dans la classe spécifiée à l'étape précédente.
    Important : Ce champ est sensible à la casse.
  6. Facultatif : Dans la section Paramètres d'entrée, cliquez sur le bouton Ajouter des paramètres.
    1. Dans le champ Nom du paramètre de la boîte de dialogue Détails du paramètre DLL, entrez le nom du paramètre.
    2. Dans la liste Type de paramètre, sélectionnez un type de données.
      Pour le type de données Entier (UInt16, Int16, Int32, Int64, Int, Single, Float, Decimal, Double, UInt32 ou UInt64), vous pouvez utiliser une valeur provenant d'un coffre d'informations d'authentification ou d'une variable d'authentification comme paramètre d'entrée.
    3. Dans le champ Valeur, saisissez la valeur que vous souhaitez transmettre.
      Si vous sélectionnez le type de données Entier, vous pouvez choisir l'une des options suivantes :
    • Nombre : Dans le champ Nombre, saisissez la valeur que vous souhaitez transmettre.

    • Information d'identification : Pour utiliser une valeur provenant d'un coffre d'informations d'authentification, sélectionnez Information d'identification. Pour utiliser une variable d'information d'identification, sélectionnez Variable.
    Pour plus d'informations sur les coffres d'informations d'identification et leur utilisation, reportez-vous à la section Informations d'identification et consignes dans le Credential Vault.
    Répétez l'étape 6 si vous souhaitez ajouter d'autres paramètres.
    Important : Les noms et l'ordre des paramètres que vous ajoutez doivent être identiques à ceux de la fonction DLL.
  7. Utilisez l'option Exécuter la fonction en arrière-plan lorsqu'aucune opération liée au système Windows, telle qu'une frappe au clavier, un clic de souris ou un changement de fenêtre, n'est appelée sous la DLL C#. Dans ce cas, vous pouvez maintenant cocher la case Exécuter la fonction en arrière-plan pour contourner la fenêtre intermédiaire (AAZeroSizeForm) et exécuter la DLL C# dans l'application de la console sans le formulaire. Nous vous recommandons de cocher cette case si la fonction DLL n'interagit pas avec l'API Windows pour effectuer des opérations telles que la frappe au clavier, le clic de souris ou le changement de fenêtre. Cette fonctionnalité permet également d'améliorer les performances d'exécution de la DLL si l'option Exécuter la fonction en arrière-plan est cochée.
  8. Facultatif : Dans la liste Attribuer le résultat à une variable, sélectionnez une variable à utiliser pour stocker le résultat de la fonction.
    Vous pouvez utiliser des variables de type booléen, date/heure, dictionnaire, liste, numérique, chaîne ou tableau pour stocker le résultat, selon le type de sortie de la fonction.
  9. Cliquez sur Enregistrer.