SAP Méthodes de connecteur

Le SAP 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 méthodes de connecteur sont disponibles à différents niveaux : connecteur, écran et élément.

SAP Méthodes de connecteur

Les SAP méthodes de 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 du volet Explorateur de projet .

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

  2. Double-cliquez sur l’objet du 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’applications 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’applications 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 un é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	Néant	Oui
nom d'utilisateur	Nom d’utilisateur pour établir la connexion.	Données dans	Chaîne	Néant	Oui
mot de passe	Mot de passe pour établir la connexion.	Données dans	Chaîne	Néant	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	Néant	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 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	ID du menu qui doit être sélectionné.	Données dans	Chaîne	Néant	Oui

Fermer

Ferme la session de l’écran SAP .

Créer une session

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

Tableau 4. Paramètres de 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 (en anglais)	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.

Transaction finale

Met fin à une transaction.

Focus

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	Néant	Oui
Retour	Renvoie le nom de l’élément de menu	Sortie de données	Chaîne	Néant	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 ?
nom_menuItemName	Nom de l’élément de menu.	Sortie de données	Liste	Néant	N/A

GetWindowHandle

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

IsCreated

Renvoie 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 ne l’est pas.

Maximiser

Agrandit l’écran SAP .

Minimiser

Réduit l’écran SAP .

Redimensionner

Redimensionne l’écran en fonction des SAP 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	Néant	Oui
yPos	Position de l’écran le long de l’axe des Y.	Données dans	Entier	Néant	Oui
Largeur	Largeur de l’écran.	Données dans	Entier	Néant	Oui
Hauteur	Hauteur de l’écran.	Données dans	Entier	Néant	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 du 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 du 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 (en anglais)	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 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	Néant	Oui
MatchAllChildren	Option permettant d’indiquer si, avant de charger l’écran, la méthode fait correspondre tous les écrans et éléments enfants capturés avec l’écran.	Données dans	Booléen	Faux	Non

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

Dans le SAP connecteur, vous pouvez utiliser ces méthodes au niveau des éléments pour identifier les é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 de connecteur.

Tableau 11. Méthodes GuiButton

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

Tableau 12. Méthodes GuiCheckBox

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

Tableau 13. Méthodes GuiComboBox

Élément	Méthodes
GuiComboBox	Obtenir
	GetIconName
	Liste d’obtention
	Points forts
	IsCreated
	Clés d’envoi
	Ensemble
	SetFocus
	MouseClick
	Attendre pour créer

Tableau 14. Méthodes GuiCtrlGridView

Élément	Méthodes
GuiCtrlGridView	CliquerBoutonCellule
	CliquezCellule
	DeselectAllRows
	GetCellType
	GetCellValue
	GetColumns
	GetColumnsKeyValuePair
	GetRowCount
	GetRows
	GetRowsByColumn
	GetSelectedColumns
	GetSelectedRows
	GetSingleRow
	GetVisibleRows
	Points forts
	IsCreated
	MouseClick
	Clés d’envoi
	SetFocus
	Sélectionner toutes les lignes
	Cellule sélectionnée
	SelectContextMenuItemById
	SelectContextMenuItemByPosition
	SelectContextMenuItemByText
	Sélectionner une seule ligne
	Sélectionner la barre d’outils MenuItemById
	Sélectionner une barre d’outils MenuItemByPosition
	Sélectionner une barre d’outils MenuItemByText
	Valeur SetCellValue
	Attendre pour créer

Tableau 15. Méthodes GuiLabel

Élément	Méthodes
Étiquette Gui	GetText
	Points forts
	IsCreated
	MouseClick
	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
	MouseClick
	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
	MouseClick
	Attendre pour créer

Tableau 18. Méthodes GuiStatusBar

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

Tableau 19. Méthodes GuiTab

Élément	Méthodes
Onglet Gui	Points forts
	IsCreated
	Onglet de sélection
	Clés d’envoi
	SetFocus
	MouseClick
	Attendre pour créer

Tableau 20. Méthodes GuiTableControl

Élément	Méthodes
GuiTableControl	DeselectAllVisibleRows
	DeselectRow
	DeselectVisibleRow
	GetAllVisibleRows
	GetColumnNames
	GetMaximumScrollOffset
	GetScrollPosition
	GetSingleRow
	GetTable (Table à obtenir)
	GetVisibleRowCount
	Points forts
	IsCreated
	MouseClick
	ScrollDownByOneRow
	ScrollToHorizontalPosition
	ScrollToNextPage
	ScrollToPreviousPage
	ScrollToVerticalPosition
	ScrollUpByOneRow
	Sélectionner toutes les lignes
	Sélectionner une seule ligne
	Sélectionner une ligne visible
	Clés d’envoi
	SetFocus
	Attendre pour créer

Tableau 21. Méthodes GuiTextBox

Élément	Méthodes
Zone de texte Gui	GetText
	Points forts
	IsCreated
	Clés d’envoi
	SetCaretPosition
	SetFocus
	SetText
	MouseClick
	Attendre pour créer

Tableau 22. Méthodes GuiTree

Élément	Méthodes
GuiTree	Vérifier
	ClickNodeItem (ÉlémentNœud)
	CollapseNodeItem
	Nœud DoubleClickNode
	DoubleClickNodeItem (en anglais seulement)
	GetColumnsKeyValuePair
	GetTreeType
	GetNodeKeyByPath
	GetNodeKeyByText
	GetNodeItemText
	GetSelectedNodes
	GetNodeItemCheckBoxState
	Points forts
	IsCreated
	PressNodeItemButton
	Onglet de sélection
	Clés d’envoi
	SetFocus
	MouseClick
	Sélectionner un élément de nœud
	Nœud de sélection
	SelectContextMenuItemById
	SelectContextMenuItemByText
	SelectContextMenuItemByPosition
	Décocher
	Attendre pour créer

Tableau 23. Méthodes GuiUserArea

Élément	Méthodes
Zone GuiUserArea	Points forts
	IsCreated
	MouseClick
	ScrollToNextPage
	ScrollToPreviousPage
	Clés d’envoi
	SetFocus
	SetHorizontalScroll
	SetVerticalScroll
	Attendre pour créer