Éléments de SAP GUI pour Java pris en charge

Les interfaces SAP contiennent une variété de contrôles spécifiques avec lesquels vous pouvez interagir comme illustré dans cette page.

Boutons SAP

Représente tous les boutons trouvés dans les fenêtres de SAP GUI pour Java. Il en existe de plusieurs types, chacun défini par un élément particulier :

Icônes

Les icônes sont des boutons interactifs qui n’affichent pas de libellés de texte.

Boutons-poussoirs

Un bouton poussoir est un élément d’IU simple qui vous donne un accès direct à une commande dans l’application.

Boutons radio

Les cases d'option présentent un ensemble d'options. Une liste contient au moins deux cases d'option, et vous ne pouvez en choisir qu'une.

Utilisez l'activité Cliquer (Click) pour interagir avec les boutons.

Case à cocher SAP

Les cases à cocher représentent une liste de choix multiples. Vous pouvez sélectionner une option, plusieurs ou aucune option.

Vous pouvez utiliser l'activité Click pour interagir avec le menu contextuel SAP.

Menu contextuel SAP

Représente une liste d’éléments à l’intérieur d’un menu contextuel. Notez que plusieurs menus contextuels enfants peuvent être disponibles dans un menu contextuel parent.

Vous pouvez utiliser les sélecteurs Java et l'activité Click pour interagir avec le menu contextuel SAP.

Boîte de dialogue SAP

Représente une fenêtre externe qui peut contenir différents types d’autres contrôles SAP tels que des boutons, des messages texte ou des fenêtres contextuelles.

Les sélecteurs à l’intérieur d’une boîte de dialogue sont générés en fonction de l’élément qu’ils représentent.

Si vous souhaitez fermer une boîte de dialogue à l’aide du bouton Fermer, vous devez utiliser le cadre de détection des éléments AA.

Utilisez des activités UIAutomation comme Cliquer (Click) ou Saisir dans (Type Into) pour interagir avec les boîtes de dialogue.

Listes déroulantes SAP

Les listes déroulantes vous permettent de sélectionner des éléments à partir de listes prédéfinies.

Utilisez l'activité Sélectionner l'élément (Select Item) pour interagir avec les éléments de liste.

Champ d’entrée SAP

Représente un domaine spécialisé qui accepte l’entrée de l’utilisateur.

Utilisez l'activité Saisir dans (Type Into) pour interagir avec les champs d'entrée.

SAP Logon

SAP Logon est un programme installé localement que vous utilisez pour vous connecter directement à un système SAP.

Vous pouvez utiliser l'activité Click (Cliquer) pour ouvrir SAP.

Barre d’état SAP

Représente une section située en bas de la fenêtre de SAP GUI pour Java qui affiche des messages. Elle n'affiche pas les informations système et de connexion.

Vous pouvez utiliser l'activité Get Attribute (Obtenir un attribut) pour lire les propriétés d'état de la barre d'état SAP.

Remarque : ce contrôle SAP n’est pas pris en charge par Recording dans Studio.

Informations sur la session SAP

Affiche des informations détaillées sur la session SAP en cours, telles que le système, le client, l’utilisateur connecté ou le programme et la transaction ouverts actuellement.

Les attributs de sélecteur facultatifs suivants sont disponibles dans UIExplorer. Utilisez-les avec d'autres activités comme Obtenir l'attribut (Get Attribute) quand vous créez votre automatisation SAP :

sapClient, sapLanguage, sapProgram, sapScreen, sapSession,sapSysName, sapSysNumber, sapSysSessionId, sapTransaction, sapUser

Onglet SAP

L'onglet SAP représente un ensemble de boutons qui vous permettent d’accéder à des informations et des contrôles spécifiques.

Utilisez l’activité Cliquer (Click) pour sélectionner un seul onglet à la fois, ou l'activité Sélectionner l'élément (Select Item) pour choisir l’onglet qui vous intéresse dans une liste.

Cas particuliers d'automatisation

Certaines transactions SAP ont une barre oblique / dans leur nom, ce qui peut entraîner des problèmes d'identification lors de l'utilisation d'un caractère générique dans le sélecteur.

Par exemple, dans la transaction SAP : /COCKPIT/1, le sélecteur pour l'un des onglets SAP à l'intérieur de la transaction peut être :

<sap id='usr/subSUB_MAIN:/COCKPIT/SAPLDISPLAY46:0389/subSUB_HDR:/COCKPIT/SAPLDISPLAY46:04051/tabsG_STRIP_HDR/tabpTAB4' />

La partie dynamique du sélecteur est : SAPLDISPLAY46:0389, où le nombre 0389 change de manière dynamique et ne permet pas d'effectuer une identification stable.

La structure du sélecteur est la suivante :

Pour que l'identification soit stable, vous devrez utiliser des caractères génériques entre les séparateurs hiérarchiques ; ensuite, toutes (et uniquement) les barres obliques entre ces séparateurs/barres obliques doivent être remplacées par ?

Avant <sap id='usr/subSUB_MAIN:/COCKPIT/SAPLDISPLAY46:0389/subSUB_HDR:/COCKPIT/SAPLDISPLAY46:04051/tabsG_STRIP_HDR/tabpTAB4' />

Après <sap id='usr/subSUB_MAIN:?COCKPIT?SAPLDISPLAY46:038*/subSUB_HDR:/COCKPIT/SAPLDISPLAY46:04051/tabsG_STRIP_HDR/tabpTAB4' />

Tables SAP

La table SAP représente un ensemble standard de commandes pour les éléments affichés dans une structure tabulaire.

Opérations courantes

Plusieurs types de tableaux sont disponibles dans SAP. Les plus couramment utilisés sont les tableaux Standard (par défaut), les tableaux en grille et les tableaux ALV. Tous les types de tableaux SAP peuvent être automatisés avec Studio.

Vous pouvez utiliser les activités suivantes pour interagir avec les tableaux SAP et leur contenu :

• Cliquer (Click)
• Obtenir le texte (Get Text)
• Saisir dans (Type Into)
• Vérifier (Check)

Table standard SAP

Le tableau SAP standard prend en charge les opérations courantes suivantes :

• Cliquer (Click)
• Obtenir le texte (Get Text)
• Saisir dans (Type Into)
• Vérifier (Check)

Table Grid SAP

Le tableau en grille SAP prend en charge les opérations de sélection/désélection, l'extraction de données et les opérations courantes suivantes :

• Cliquer (Click)
• Obtenir le texte (Get Text)
• Saisir dans (Type Into)
• Vérifier (Check)

Sélectionner/Désélectionner

Les activités Click (Cliquer) et Check (Vérifier) vous permettent d'effectuer les opérations suivantes dans votre projet d'automatisation SAP :

• Sélectionner/Désélectionner une colonne
• Sélectionner/Désélectionner une colonne
• Sélectionner/Désélectionner tout
  

Capture de données

L'extraction de données (Data scraping) vous permet d'extraire des données structurées de tableaux SAP.

Si vous automatisez un tableau qui contient plusieurs colonnes du même nom, le mécanisme d'extraction incrémente automatiquement le nom des colonnes (par ex., column1, column2, column3, etc.).

L'activité Extraire les données de structure (Extract Structure Data) offre des possibilités supplémentaires quand vous extrayez des données de la table GridView SAP. Utilisez les valeurs suivantes pour le paramètre columns_name_source pour définir comment vous souhaitez obtenir les informations de la table :

• Plus long - Le nom complet de la colonne est extrait et utilisé.
• Plus court - Le nom court de la colonne est extrait et utilisé.
• Displayed (Affiché) – Le nom visible/affiché dans SAP GUI pour Java est utilisé.
• Technique - Le nom de l’en-tête technique de la colonne est extrait et utilisé.
• Info-bulle - Le nom de l'info-bulle qui apparaît après avoir fait passer la souris au-dessus d'un nom de colonne.

Table SAP ALV

Les tableaux ALV SAP prennent en charge toutes les opérations courantes disponibles, comme mentionné ci-dessus, ainsi que l'extraction de données pour les tableaux d'en-tête simples et l'extraction de données d'écran. Vous pouvez extraire un seul tableau ALV sur l'écran SAP.

Capture de données

Cela fonctionne de la même manière que la capture de données pour les tableaux SAP en grille mentionnés, à l'exception des points suivants :

Remarque :

• Le défilement horizontal n'est pas pris en charge. La largeur du tableau doit tenir entièrement sur l'écran et être entièrement visible. Les colonnes hors de la vue ne seront pas extraites.

• La présence de plusieurs lignes dans une cellule n'est pas prise en charge.

• Dans certains cas, le nom l'info-bulle d'une colonne peut être différent du nom d'affichage dans les tableaux ALV SAP.

Extraction de données d'écran

Si vous décidez d'utiliser l'extraction de données d'écran, la méthode d'extraction recommandée est FullText, et la case à cocher Ignorer les éléments masqués (Ignore Hidden) doit être cochée. Veuillez noter que seul le texte visible sur l'écran SAP est extrait en utilisant cette méthode.

Pour en savoir plus sur l'extraction de données d’écran, consultez cette page.

Textedit SAP

Le contrôle SAP Textedit représente un champ/éditeur de texte modifiable.

Vous pouvez utiliser les activités suivantes pour interagir avec ce contrôle :

• L’activité Saisir dans (Type Into) pour les champs de texte.
• L’activité Envoyer le raccourci (Send Hotkey) pour les boutons qui prennent en charge les raccourcis clavier ou l’activité Cliquer sur l'image (Click Image) pour les boutons.

Barre d’outils SAP

La barre d’outils SAP représente un ensemble de boutons avec lesquels vous pouvez interagir. Dans SAP, il existe plusieurs types de barres d’outils, selon la transaction SAP ou le programme SAP.

• Barre d’outils système SAP
• Barre d'outils d'applications SAP
• Barre d'outils spéciale SAP
• Barre d'outils GridTable SAP
• Services d'objet génériques SAP

Vous pouvez utiliser l'activité Click (Cliquer) pour interagir avec les boutons des barres d'outils.

Remarque : ce contrôle SAP n’est pas pris en charge par Recording dans Studio.

Arborescence SAP

L’arborescence SAP représente une liste d’éléments organisés dans une structure d’arborescence. Plusieurs types de commandes d'arborescence SAP sont disponibles :

• Arborescence simple

  

• Arborescence en liste

  

• Arborescence en colonne

  

Vous pouvez utiliser l'activité Cliquer ( Click ) ou Obtenir le texte ( Get Text ) pour interagir avec un nœud ou un élément dans n'importe quel type de contrôle de l'arborescence SAP.

Remarque : nous vous recommandons d'utiliser la propriété SimulateClick lorsque vous interagissez avec les arborescences SAP.