SAP Méthodes du connecteur

Le connecteur fournit différentes méthodes que vous pouvez utiliser pour automatiser les workflows sur SAP les interfaces d’interface utilisateur graphique (GUI). SAP Les SAP méthodes de connecteur sont disponibles à différents niveaux : connecteur, écran et élément.

SAP Méthodes du connecteur

Les SAP méthodes du connecteur sont disponibles à trois niveaux.

• Application : Vous pouvez trouver ces méthodes lorsque vous double-cliquez sur l’objet SAP du connecteur. Pour accéder à ces méthodes, procédez comme suit :
  1. Ajoutez le connecteur SAP sous les objets globaux dans le volet Explorateur de projet .

     Pour plus d'informations, consultez Configurer le SAP connecteur.

  2. Double-cliquez sur l’objet connecteur SAP.

     Les méthodes apparaissent dans le volet Explorateur d’objets.

• Écran : utilisez ces méthodes pour automatiser les tâches sur un écran d’application SAP que vous avez ajouté. Par exemple, automatisez l’agrandissement d’une fenêtre d’application. Pour accéder à ces méthodes, procédez comme suit :
  1. Ajoutez un ou plusieurs écrans d’application SAP. Pour apprendre à configurer, reportez-vous à la section Configurer le SAP connecteur.
  2. Double-cliquez sur l’écran que vous avez ajouté.

     Les méthodes apparaissent dans le volet Explorateur d’objets.

• Élément : utilisez ces méthodes pour automatiser les actions sur les éléments d’interface utilisateur à l’écran SAP , par exemple, un bouton ou une case à cocher. Par exemple, automatisez la sélection d’un bouton. Pour accéder à ces méthodes, procédez comme suit :
  1. Ajoutez un ou plusieurs écrans d’application SAP. Pour apprendre à configurer, reportez-vous à la section Configurer le SAP connecteur.
  2. Capturez un ou plusieurs éléments d’écran. Pour apprendre à capturer, reportez-vous à la section Utiliser la boîte de dialogue Capturer l’élément.

     Les éléments de l’écran apparaissent sous l’écran SAP capturé.

  3. Double-cliquez sur l’élément d’écran.

     Les méthodes apparaissent dans le volet Explorateur d’objets.

Utiliser les méthodes

Pour créer une automatisation à l’aide des méthodes, faites-les glisser du volet Explorateur d’objets vers l’aire de conception et connectez-les.

Méthodes au niveau de l’application

OpenConnection

Établit une connexion entre le connecteur et l’application SAP . Vous devez d’abord utiliser cette méthode avant d’exécuter une automatisation.

Tableau 1. Paramètres de méthode OpenConnection

Paramètre	Description	Type d’entrée de port de données	Type de données	Valeur par défaut	Obligatoire ?
nom	Nom de la connexion.	Données dans	Chaîne	Aucun	Oui
nom d'utilisateur	Nom d’utilisateur pour établir la connexion.	Données dans	Chaîne	Aucun	Oui
mot de passe	Mot de passe pour établir la connexion.	Données dans	Chaîne	Aucun	Oui

SetDefaultSession

Fait de la session sélectionnée une session par défaut.

Tableau 2. Paramètres de méthode SetDefaultSession

Paramètre	Description	Type d’entrée de port de données	Type de données	Valeur par défaut	Obligatoire ?
sessionId	ID unique de la session que vous souhaitez définir par défaut.	Données dans	Chaîne	Aucun	Oui

FermerConnexion

Ferme la connexion entre le connecteur et l’application SAP .

Méthodes au niveau de l’écran

CliquezMenuItem

Sélectionne l’élément de menu dont vous spécifiez l’ID à l’écranSAP.

Tableau 3. Paramètres de la méthode ClickMenuItem

Paramètre	Description	Type d’entrée de port de données	Type de données	Valeur par défaut	Obligatoire ?
ID de menu	L’ID du menu qui doit être sélectionné.	Données dans	Chaîne	Aucun	Oui

Fermer

Ferme la session de l’écran SAP .

CreateSession

Crée une session de l’écran SAP .

Tableau 4. Paramètres de la méthode CreateSession

Paramètre	Description	Type d’entrée de port de données	Type de données	Valeur par défaut	Obligatoire ?
tCode	Code de transaction qui vous permet d’accéder à une partie spécifique de l’application SAP.	Données dans	Chaîne	N/A	Oui
Retour	Renvoie l’ID de la session créée.	Sortie de données	Chaîne	N/A	N/A

Session de fin

Met fin à la session ouverte.

EndTransaction

Met fin à une transaction.

Foyer

Met l’accent sur la session ouverte.

GetMenuItem

Obtient le nom de l’élément de menu spécifié.

Tableau 5. Paramètres de méthode GetMenuItem

Paramètre	Description	Type d’entrée de port de données	Type de données	Valeur par défaut	Obligatoire ?
ID de menu	ID de l’élément de menu pour obtenir le nom.	Données dans	Chaîne	Aucun	Oui
Retour	Renvoie le nom de l’élément de menu	Sortie de données	Chaîne	Aucun	N/A

GetMenuItemsIdsByName

Récupère l’ID du menu que vous spécifiez par son nom.

Tableau 6. Paramètres de méthode GetMenuItemsIdsByName

Paramètre	Description	Type d’entrée de port de données	Type de données	Valeur par défaut	Obligatoire ?
menuItemName	Nom de l’élément de menu.	Sortie de données	Liste	Aucun	N/A

GetWindowHandle

Renvoie le descripteur de fenêtre de l’écran de l’application SAP .

IsCreated

Renvoie la valeur vrai si la session est créée, faux si la session n’est pas créée.

IsSessionBusy

Renvoie la valeur vrai si la session est occupée et la valeur faux si la session n’est pas occupée.

Maximiser

Agrandit l’écran SAP .

Minimiser

Réduit l’écran SAP .

Redimensionner

Redimensionne l’écran SAP en fonction des dimensions spécifiées.

Tableau 7. Paramètres de méthode de redimensionnement

Paramètre	Description	Type d’entrée de port de données	Type de données	Valeur par défaut	Obligatoire ?
xPos	Position de l’écran le long de l’axe X.	Données dans	Entier	Aucun	Oui
yPos	Position de l’écran le long de l’axe Y.	Données dans	Entier	Aucun	Oui
Largeur	Largeur de l’écran.	Données dans	Entier	Aucun	Oui
Hauteur	Hauteur de l’écran.	Données dans	Entier	Aucun	Oui

Restaurer

Restaure l’écran dans ses dimensions d’origine.

ScreenId

Renvoie l’ID de l’écran de l’application SAP sous forme de chaîne.

Clés d’envoi

Envoie les frappes clavier à l’écran de l’application SAP .

Tableau 8. 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 ?
Clés	Frappes de clavier que vous souhaitez envoyer à l’écran SAP .	Données dans	Chaîne	N/A	Oui

StartTransaction

Démarre une transaction.

Tableau 9. Paramètres de méthode StartTransaction

Paramètre	Description	Type d’entrée de port de données	Type de données	Valeur par défaut	Obligatoire ?
tCode	Code de transaction qui vous permet d’accéder à une partie spécifique de l’application SAP.	Données dans	Chaîne	N/A	Oui

Attendre pour créer

Attend pendant la durée spécifiée pendant la création de l’écran. Cela permet à tous les contrôles dynamiques de se charger après la création de l’écran.

Tableau 10. 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 ?
timeoutInSeconds	Durée après laquelle la méthode expire.	Données dans	Entier	Aucun	Oui
MatchAllChildren	Option permettant d’indiquer si, avant de charger l’écran, la méthode associe tous les écrans et éléments enfants capturés à l’écran.	Données dans	Booléen	Faux	Non

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

Dans le connecteur, vous pouvez utiliser ces méthodes au niveau de l’élément SAP pour identifier des éléments, vérifier leur présence à l’écran ou définir des actions à effectuer sur les éléments.

Les tableaux suivants incluent les éléments et leurs méthodes disponibles. Pour la description de ces méthodes et de leurs paramètres, reportez-vous à la section SAP Méthodes du connecteur.

Tableau 11. Méthodes GuiButton

Élément	Méthodes
Bouton Gui	Cliquer sur
	Points forts
	IsCreated
	Clic sur la souris
	Clés d’envoi
	SetFocus
	Attendre pour créer

Tableau 12. Méthodes GuiCheckBox

Élément	Méthodes
Case GuiCheckBox	Vérifier
	Points forts
	IsChecked
	IsCreated
	Clés d’envoi
	SetFocus
	Décocher
	Clic sur la souris
	Attendre pour créer

Tableau 13. Méthodes GuiComboBox

Élément	Méthodes
GuiComboBox	Obtenir
	GetIconName
	Obtenir une liste
	Points forts
	IsCreated
	Clés d’envoi
	Ensemble
	SetFocus
	Clic sur la souris
	Attendre pour créer

Tableau 14. Méthodes GuiCtrlGridView

Élément	Méthodes
GuiCtrlGridView	CliquezBoutonCellule
	CliquezCellule
	DésélectionnezAllRows
	GetCellType
	GetCellValue
	GetColumns
	GetColumnsKeyValuePair
	GetRowCount
	GetRows
	GetRowsByColumn
	GetSelectedColumns
	GetSelectedRows
	GetSingleRow
	GetVisibleRows
	Points forts
	IsCreated
	Clic sur la souris
	Clés d’envoi
	SetFocus
	Sélectionner toutes les lignes
	Cellule sélectionnée
	Sélectionner le contexte MenuItemById
	SelectContextMenuItemByPosition
	SelectContextMenuItemByText
	Sélectionner une seule ligne
	Sélectionner la barre d’outils MenuItemById
	SelectToolbarMenuItemByPosition
	Sélectionner une barre d’outils MenuItemByText
	Valeur SetCellValue
	Attendre pour créer

Tableau 15. Méthodes GuiLabel

Élément	Méthodes
GuiLabel	GetText
	Points forts
	IsCreated
	Clic sur la souris
	Clés d’envoi
	SetFocus
	Attendre pour créer

Tableau 16. Méthodes GuiPassword

Élément	Méthodes
Mot de passe Gui	Points forts
	IsCreated
	Clés d’envoi
	SetCaretPosition
	SetFocus
	SetText
	Clic sur la souris
	Attendre pour créer

Tableau 17. Méthodes GuiRadioButton

Élément	Méthodes
GuiRadioButton	Points forts
	IsChecked
	IsCreated
	Sélectionner
	Clés d’envoi
	SetFocus
	Clic sur la souris
	Attendre pour créer

Tableau 18. Méthodes GuiStatusBar

Élément	Méthodes
GuiStatusBar	GetStatus
	Points forts
	IsCreated
	Clic sur la souris
	Clés d’envoi
	SetFocus
	Attendre pour créer

Tableau 19. Méthodes GuiTab

Élément	Méthodes
GuiTab	Points forts
	IsCreated
	Onglet de sélection
	Clés d’envoi
	SetFocus
	Clic sur la souris
	Attendre pour créer

Tableau 20. Méthodes GuiTableControl

Élément	Méthodes
GuiTableControl	DésélectionnerToutesVisibleLignes
	DésélectionnerLigne
	DeselectVisibleRow
	GetAllVisibleRows
	GetColumnNames
	GetMaximumScrollOffset
	GetScrollPosition
	GetSingleRow
	GetTable
	GetVisibleRowCount
	Points forts
	IsCreated
	Clic sur la souris
	Défilement vers le bas parune ligne
	Défilement vers la position horizontale
	Faites défiler vers la page suivante
	Faire défiler vers la page précédente
	Défilement vers la position verticale
	Faire défiler vers le haut parune ligne
	Sélectionner toutes les lignes
	Sélectionner une seule ligne
	SelectVisibleRow
	Clés d’envoi
	SetFocus
	Attendre pour créer

Tableau 21. Méthodes GuiTextBox

Élément	Méthodes
GuiTextBox	GetText
	Points forts
	IsCreated
	Clés d’envoi
	SetCaretPosition
	SetFocus
	SetText
	Clic sur la souris
	Attendre pour créer

Tableau 22. Méthodes GuiTree

Élément	Méthodes
GuiTree	Vérifier
	CliquezNœudÉlément
	CollapseNodeItem
	Nœud DoubleClickCliquer
	DoubleClickNodeItem
	GetColumnsKeyValuePair
	GetTreeType
	GetNodeKeyByPath
	GetNodeKeyByText
	GetNodeItemText
	GetSelectedNodes
	GetNodeItemCheckBoxState
	Points forts
	IsCreated
	PressNodeItemButton
	Onglet de sélection
	Clés d’envoi
	SetFocus
	Clic sur la souris
	Élément SelectNodeItem
	Nœud de sélection
	Sélectionner le contexte MenuItemById
	SelectContextMenuItemByText
	SelectContextMenuItemByPosition
	Décocher
	Attendre pour créer

Tableau 23. Méthodes GuiUserArea

Élément	Méthodes
Zone GuiUserArea	Points forts
	IsCreated
	Clic sur la souris
	Faites défiler vers la page suivante
	Faire défiler vers la page précédente
	Clés d’envoi
	SetFocus
	SetHorizontalScroll
	SetVerticalScroll
	Attendre pour créer