IBM Méthodes d’émulateur de communications personnelles

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 8 minutes de lecture
  • Utilisez les méthodes de l’émulateur Personal IBM Communications pour effectuer diverses tâches d’automatisation sur l’émulateur IBM Personal Communications.

    Méthodes au niveau de l’écran

    Utilisez des méthodes au niveau de l’écran pour effectuer les tâches d’automatisation sur l’écran de l’émulateur. Par exemple, vous pouvez simuler une commande à l’écran ou obtenir du texte à partir de l’écran.

    Obtenir du texte sur le champ

    Renvoie le texte qu’un champ contient après avoir identifié le champ à l’aide du numéro de ligne et de colonne que vous spécifiez. La ligne et la colonne que vous spécifiez constituent le point de départ du champ. La méthode identifie l’ensemble du champ, puis renvoie le texte dans le champ. Dans l’exemple suivant, H est la première lettre et le point de départ dans le champ et Host OS : est le texte complet dans le champ.

    Écran qui affiche la première lettre du champ et le texte complet du champ.

    La méthode GetFieldText avec ses paramètres.

    Tableau 1. Paramètres de méthode GetFieldText
    Paramètre Description Type d’entrée de port de données Type de données Valeur par défaut Obligatoire Notes
    Ligne Numéro de ligne de champ qui identifie le champ. Données dans Entier N/A Oui
    Colonne Numéro de colonne de champ qui identifie le champ. Données dans Entier N/A Oui
    Retour Renvoie le texte dans le champ. Sortie de données Chaîne N/A N/A

    GetTextFromRect

    Renvoie le texte dans tous les champs d’une zone rectangulaire que vous définissez à l’écran. Vous définissez une zone en fournissant les lignes de début et de fin et les numéros de colonne. La méthode localise et identifie le premier et le dernier champ et renvoie tout le texte dans tous les champs de cette zone. L’exemple suivant montre la zone que vous avez définie.

    Zone que vous avez définie pour afficher la première cellule du premier champ et la dernière cellule du dernier champ.

    Image de la méthode GetTextFromRect.

    Tableau 2. Paramètres de la méthode GetTextFromRect
    Paramètre Description Type d’entrée de port de données Type de données Valeur par défaut Obligatoire Notes
    Ligne de départ Numéro de ligne qui indique le premier caractère du premier champ de la zone rectangulaire. Données dans Entier N/A Oui
    StartCol (en anglais seulement) Numéro de colonne qui contient le premier caractère du premier champ de la zone rectangulaire. Données dans Entier N/A Oui
    Ligne de fin Numéro de ligne contenant le dernier caractère du dernier champ de la zone rectangulaire. Données dans Entier N/A Oui
    Col de fin Numéro de colonne contenant le dernier caractère du dernier champ de la zone rectangulaire. Données dans Entier N/A Oui
    Retour Renvoie le texte de tous les champs de la zone rectangulaire. Sortie de données Chaîne N/A N/A

    IsCreated (Créé le )

    Vérifie si l’écran de l’émulateur existe en fonction de la règle de correspondance d’écran et peut accepter les entrées de l’utilisateur. Après vérification, la méthode renvoie la valeur booléenne appropriée.

    Méthode IsCreated.

    Tableau 3. Paramètres de la méthode IsCreated
    Paramètre Description Type d’entrée de port de données Type de données Valeur par défaut Obligatoire Notes
    MatchAllChildren (en anglais seulement) Option permettant de trouver l’écran de l’émulateur en faisant correspondre les éléments enfants que vous avez capturés. Données dans Booléen Faux Oui
    Avertissement :
    L’utilisation de cette option peut ralentir la méthode.
    Retour Renvoie la valeur booléenne selon que l’écran de l’émulateur existe ou non en fonction de la règle de correspondance d’écran et peut accepter des entrées de l’utilisateur. Sortie de données Booléen N/A N/A

    SearchText

    Renvoie les numéros de la ligne et de la colonne contenant le premier caractère du texte que vous spécifiez. Par exemple, si vous spécifiez l’émulateur de chaîne, la méthode renvoie les numéros de ligne et de colonne du point de départ de l’émulateur de mots qui est e.
    Remarque :
    Si vous fournissez le texte qui s’étend sur plusieurs champs, les ports Ligne et Col renvoient 0, car la méthode ne prend en charge le texte qu’à partir d’un seul champ.

    Méthode SearchText.

    Tableau 4. Paramètres de la méthode SearchText
    Paramètre Description Type d’entrée de port de données Type de données Valeur par défaut Obligatoire Notes
    Texte Texte recherché par la méthode. Données dans Chaîne N/A Oui Le texte que vous spécifiez peut être sensible à la casse en fonction de l’émulateur que vous utilisez.
    Ligne Numéro de ligne contenant le premier caractère du texte que vous spécifiez. Sortie de données Entier N/A N/A Si le texte que vous spécifiez se trouve sur plusieurs lignes et colonnes, la méthode renvoie la première ligne et la première colonne qui contient le texte.
    Col Numéro de colonne qui contient le premier caractère du texte que vous spécifiez. Sortie de données Entier N/A N/A Si le texte que vous spécifiez se trouve sur plusieurs lignes et colonnes, la méthode renvoie la première ligne et la première colonne qui contient le texte.

    SendKeys (Envoyer des clés)

    Simule les frappes que vous saisissez à partir du clavier à la position du périphérique de la souris sur l’écran de l’émulateur. Par exemple, vous pouvez simuler la frappe de la touche [Entrée] à l’écran.

    SendKeys.

    Tableau 5. Paramètres de la méthode SendKeys
    Paramètre Description Type d’entrée de port de données Type de données Valeur par défaut Obligatoire Notes
    Clés Frappes que vous saisissez à partir de votre clavier. Données dans Chaîne Aucun Oui
    Conseil :
    Pour en savoir plus sur les frappes au clavier, reportez-vous à la documentation de l’émulateur de terminal respectif.

    SendKeysSecure

    Simule la frappe au clavier qui est une chaîne sécurisée à la position du périphérique de la souris sur l’écran de l’émulateur.

    Méthode SendKeysSecure.

    Tableau 6. SendKeysParamètres de la méthode sécurisée
    Paramètre Description Type d’entrée de port de données Type de données Valeur par défaut Obligatoire Notes
    Clés Frappes clavier que vous saisissez en tant que chaîne sécurisée. Données dans Chaîne sécurisée Aucun Oui
    Conseil :
    Pour en savoir plus sur les frappes au clavier, reportez-vous à la documentation de l’émulateur de terminal respectif.

    Définir CursorPosition

    Tente de définir le périphérique de la souris sur le numéro de ligne et de colonne que vous spécifiez.

    Méthode SetCursorPosition.

    Tableau 7. Paramètres de la méthode SetCursorPosition
    Paramètre Description Type d’entrée de port de données Type de données Valeur par défaut Obligatoire Notes
    Ligne Option permettant de fournir le numéro de la ligne sur la base de laquelle la méthode tente de définir le périphérique de souris sur l’écran. Données dans Entier N/A N/A Le numéro de ligne doit être positif et dans la taille de l’écran de l’émulateur. Par exemple, si la taille de l’écran est 24X80, la valeur maximale que vous pouvez fournir pour une ligne est 24.
    Col Option permettant de fournir le numéro de la ligne sur la base de laquelle la méthode tente de définir le périphérique de souris sur l’écran. Données dans Entier N/A N/A Le numéro de colonne doit être positif et dans la taille de l’écran de l’émulateur. Par exemple, si la taille de l’écran est de 24X80, la valeur maximale que vous pouvez fournir pour une colonne est 80.

    AttendreCréer

    Attend pendant la durée que vous spécifiez pendant que le connecteur utilise la règle de correspondance d’écran pour vérifier si l’écran existe.

    Méthode WaitForCreate.

    Tableau 8. Paramètres de la méthode WaitForCreate
    Paramètre Description Type d’entrée de port de données Type de données Valeur par défaut Obligatoire Notes
    timeoutinSeconds Option permettant de fournir le nombre de secondes pendant lesquelles la méthode attend pendant que le connecteur utilise la règle de correspondance d’écran pour déterminer si l’écran existe. Données dans Entier 30 Oui
    MatchAllChildren (en anglais seulement) Option permettant de faire correspondre tous les éléments d’écran que vous avez capturés pour trouver si l’écran existe. Données dans Booléen Faux Oui
    Avertissement :
    L’utilisation de cette option peut retarder l’exécution de la méthode.
    Retour Renvoie la valeur booléenne selon que l’écran de l’émulateur a été trouvé ou non. Sortie de données Booléen N/A N/A

    Méthodes au niveau de l’élément

    Les méthodes au niveau de l’élément effectuent des tâches d’automatisation sur les éléments de l’écran de l’émulateur que vous ajoutez à partir de l’écran Connecteur de terminal. Vous pouvez ajouter un élément d’écran sous la forme d’un champ ou d’une table.

    Obtenir une table

    Renvoie le texte que vous avez capturé en tant qu’objet de table de données. Utilisez cette méthode lorsque vous capturez les données d’un écran sous forme de table. Toutefois, vous pouvez également utiliser cette méthode pour les données que vous capturez en tant que champ. Pour apprendre à capturer les données sous forme de table, reportez-vous à la section Configurer l’émulateur IBM Personal Communications.

    Méthode GetAsTable.

    Tableau 9. Paramètres de méthode GetAsTable
    Paramètre Description Type d’entrée de port de données Type de données Valeur par défaut Obligatoire Notes
    Retour Renvoie le texte capturé à partir de l’écran du terminal en tant qu’objet de table de données. Sortie de données Table de données N/A N/A Pour afficher la table, cliquez avec le bouton droit sur le paramètre et sélectionnez Prévisualiser les données.

    Obtenir du texte

    Renvoie le texte dans le champ que vous avez capturé à partir de l’écran de l’émulateur. Si vous utilisez cette méthode pour une table que vous avez capturée, elle renvoie le texte dans le premier champ du rectangle.

    Méthode GetText.

    Tableau 10. Paramètres de méthode GetText
    Paramètre Description Type d’entrée de port de données Type de données Valeur par défaut Obligatoire? Notes
    Retour Renvoie le texte du champ capturé. Sortie de données Chaîne N/A N/A

    IsCreated (Créé le )

    Correspond aux règles et vérifie si l’élément capturé existe.

    Méthode IsCreated.

    Tableau 11. Paramètres de la méthode IsCreated
    Paramètre Description Type d’entrée de port de données Type de données Valeur par défaut Obligatoire Notes
    Retour Renvoie la valeur booléenne selon que l’élément est actif ou non. Sortie de données Booléen N/A N/A

    Définir le texte

    Tente de définir le texte sur le champ.

    SetText.

    Tableau 12. Paramètres de la méthode SetText
    Paramètre Description Type d’entrée de port de données Type de données Valeur par défaut Obligatoire Notes
    Texte Option permettant de spécifier le texte que la méthode tente de définir dans le champ. Données dans Chaîne N/A Oui Vous ne pouvez pas utiliser cette méthode sur les écrans d’émulateur protégés.

    AttendreCréer

    Attend la durée que vous spécifiez pendant que le connecteur utilise la règle de correspondance pour déterminer si l’élément existe.

    Méthode WaitForCreate.

    Tableau 13. Paramètres de la méthode WaitForCreate
    Paramètre Description Type d’entrée de port de données Type de données Valeur par défaut Obligatoire Notes
    timeoutinSeconds Option permettant de fournir le nombre de secondes pendant lesquelles la méthode attend pendant que le connecteur utilise la règle de correspondance pour déterminer si l’élément existe. Données dans Entier 30 Oui
    Retour Renvoie la valeur booléenne selon que l’élément a été trouvé ou non. Sortie de données Booléen N/A N/A