IBM Méthodes d’émulation de communications personnelles

Utilisez les méthodes de l’émulateur IBM Personal 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.

GetFieldText

Renvoie le texte qu’un champ contient après avoir identifié le champ par le 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 le système d’exploitation hôte : est le texte complet dans le champ.

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.

Tableau 2. Paramètres de 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ébut	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	Numéro de colonne contenant 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 final	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

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.

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	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 les 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 qui contient 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 mot qui est e.

Remarque :

Si vous fournissez un texte qui s’étend sur plusieurs champs, les ports Ligne et Col renvoient la valeur 0, car la méthode ne prend en charge le texte qu’à partir d’un seul champ.

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 ayant 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 colonne contenant le texte.
Col.	Numéro de colonne ayant 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 colonne contenant le texte.

Clés d’envoi

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

Tableau 5. Paramètres de 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	Néant	Oui	Conseil : Pour en savoir plus sur les frappes au clavier, consultez la documentation de l’émulateur de terminal respectif.

SendKeysSecure

Simule les frappes qui sont une chaîne sécurisée à la position de la souris sur l’écran de l’émulateur.

Tableau 6. Paramètres de méthode SendKeysSecure

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	Néant	Oui	Conseil : Pour en savoir plus sur les frappes au clavier, reportez-vous à la documentation de l’émulateur de terminal respectif.

SetCursorPosition

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

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 laquelle la méthode tente de définir la souris à 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 de 24 X 80, la valeur maximale que vous pouvez fournir pour une ligne est 24.
Col.	Option permettant de fournir le numéro de la ligne sur laquelle la méthode tente de définir la souris à 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 24 x 80, la valeur maximale que vous pouvez fournir pour une colonne est 80.

Attendre pour créer

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

Tableau 8. Paramètres de 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 voir si l’écran existe.	Données dans	Entier	30	Oui
MatchAllChildren	Option permettant de faire correspondre tous les éléments d’écran que vous avez capturés pour rechercher 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 l’écran de l’émulateur éléments que vous ajoutez à partir de l’écran du connecteur de terminal. Vous pouvez ajouter un élément d’écran sous la forme d’un champ ou d’une table.

GetAsTable (en anglais seulement)

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 la méthode pour les données que vous capturez en tant que champ. Pour savoir comment capturer les données sous forme de table, reportez-vous à la section Configurer l’émulateur Personal IBM Communications.

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.

GetText

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.

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

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

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

SetText

Tente de définir le texte sur le champ.

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 protégés de l’émulateur.

Attendre pour cré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.

Tableau 13. Paramètres de 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