SAP Connector-Methoden

Die SAPConnector bietet verschiedene Methoden, mit denen Sie Workflows automatisieren können SAPGrafische Anwenderoberflächenschnittstellen (GUI). SAPConnector-Methoden sind auf verschiedenen Ebenen verfügbar – Connector, Bildschirm und Element.

SAP Connector-Methoden

Die SAPConnector-Methoden sind auf drei Ebenen verfügbar.

• Anwendung : Sie können diese Methoden finden, wenn Sie auf doppelklicken SAPConnector-Objekt. Führen Sie die folgenden Schritte aus, um auf diese Methoden zuzugreifen:
  1. Fügen Sie den SAP-Connector unter hinzu Globale Objekte In Projekt-Explorer Bereich.

     Weitere Informationen finden Sie unter Konfigurieren Sie SAPConnector.

  2. Doppelklicken Sie auf das SAP-Connector-Objekt.

     Die Methoden werden im Objekt-Explorer-Bereich angezeigt.

• Bildschirm : Verwenden Sie diese Methoden, um Aufgaben auf einem von Ihnen hinzugefügten SAP-Anwendungsbildschirm zu automatisieren. Automatisieren Sie beispielsweise die Maximierung eines Anwendungsfensters. Führen Sie die folgenden Schritte aus, um auf diese Methoden zuzugreifen:
  1. Fügen Sie einen oder mehrere SAP-Anwendungsbildschirme hinzu. Informationen zum Konfigurieren finden Sie unter Konfigurieren Sie SAPConnector.
  2. Doppelklicken Sie auf den Bildschirm, den Sie hinzugefügt haben.

     Die Methoden werden im Objekt-Explorer-Bereich angezeigt.

• Element : Verwenden Sie diese Methoden, um Aktionen auf zu automatisieren SAPBildschirm-UI-Elemente, z. B. eine Schaltfläche oder ein Kontrollkästchen. Automatisieren Sie beispielsweise die Auswahl einer Schaltfläche. Führen Sie die folgenden Schritte aus, um auf diese Methoden zuzugreifen:
  1. Fügen Sie einen oder mehrere SAP-Anwendungsbildschirme hinzu. Informationen zum Konfigurieren finden Sie unter Konfigurieren Sie SAPConnector.
  2. Erfassen Sie ein oder mehrere Bildschirmelemente. Informationen zum Erfassen finden Sie unter Verwenden Sie das Dialogfeld „Element erfassen“.

     Die Bildschirmelemente werden unter dem erfassten SAP-Bildschirm angezeigt.

  3. Doppelklicken Sie auf das Bildschirmelement.

     Die Methoden werden im Objekt-Explorer-Bereich angezeigt.

Verwenden Sie die Methoden

Um eine Automatisierung mithilfe der Methoden zu erstellen, ziehen Sie sie aus dem Bereich „Objekt-Explorer“ auf die Entwurfsoberfläche, und verbinden Sie sie.

Methoden auf Anwendungsebene

Einsatzbereitschaft

Stellt eine Verbindung zwischen dem Connector und her SAPAnwendung. Sie müssen diese Methode zuerst verwenden, bevor Sie eine Automatisierung ausführen.

Tabelle : 1. Parameter der OPENCONECTION-Methode

Parameter	Beschreibung	Datenport-Eingabetyp	Datentyp	Standardwert	Obligatorisch?
name	Name der Verbindung.	Daten In	Zeichenfolge	Keine	Ja
username	Anwendername Zum Erstellen Die Verbindung.	Daten In	Zeichenfolge	Keine	Ja
Passwort	Passwort Zum Erstellen Die Verbindung.	Daten In	Zeichenfolge	Keine	Ja

Standardsitzung festlegen

Macht die ausgewählte Sitzung zu einer Standardsitzung .

Tabelle : 2. Legen Sie die Parameter der DefaultSession-Methode fest

Parameter	Beschreibung	Datenport-Eingabetyp	Datentyp	Standardwert	Obligatorisch?
sessionId	Eindeutige ID der Sitzung, die Sie als Standard festlegen möchten.	Daten In	Zeichenfolge	Keine	Ja

CLOSECONECTION

Schließt die Verbindung zwischen dem Connector und SAPAnwendung.

Methoden auf Bildschirmebene

Klicken Sie auf Menüelement

Wählt das Menüelement aus, dessen ID Sie angeben Auf SAPBildschirm .

Tabelle : 3. Klicken Sie auf Parameter der MenuItem-Methode

Parameter	Beschreibung	Datenport-Eingabetyp	Datentyp	Standardwert	Obligatorisch?
Menü-ID	Die ID des Menüs, das ausgewählt werden muss.	Daten In	Zeichenfolge	Keine	Ja

Schließen

Schließt die Sitzung von SAPBildschirm.

Erstellungssitzung

Erstellt eine Sitzung von SAPBildschirm.

Tabelle : 4. CreateSession-Methodenparameter

Parameter	Beschreibung	Datenport-Eingabetyp	Datentyp	Standardwert	Obligatorisch?
Tcode	Transaktionscode, mit dem Sie auf einen bestimmten Teil der SAP-Anwendung zugreifen können.	Daten In	Zeichenfolge	NA	Ja
Zurück	Gibt zurück ID der erstellten Sitzung.	Daten Aus	Zeichenfolge	NA	NA

Endsitzung

Beendet die offene Sitzung.

Endtransaktion

Beendet eine Transaktion.

Fokus

Legt den Fokus auf die offene Sitzung fest.

GetMenuItem

Ruft den Namen des angegebenen Menüelements ab.

Tabelle : 5. Parameter der GetMenuItem-Methode

Parameter	Beschreibung	Datenport-Eingabetyp	Datentyp	Standardwert	Obligatorisch?
Menü-ID	ID des Menüelements zum Abrufen des Namens.	Daten In	Zeichenfolge	Keine	Ja
Zurück	Gibt den Namen des Menüelements zurück	Daten Aus	Zeichenfolge	Keine	NA

GetMenuItemsIdsNachName

Ruft die ID des Menüs ab, das Sie anhand seines Namens angeben.

Tabelle : 6. GetMenuItemsIdsByName-Methodenparameter

Parameter	Beschreibung	Datenport-Eingabetyp	Datentyp	Standardwert	Obligatorisch?
MenuItemName	Name des Menüelements.	Daten Aus	Liste	Keine	NA

WindowHandle abrufen

Gibt das Fenster-Handle von zurück SAPAnwendungsbildschirm.

Ist erstellt

Gibt Zurück Wahr Wenn die Sitzung erstellt wird, Falsch Wenn die Sitzung nicht erstellt wird.

IsSessionBusy

Gibt Zurück Wahr Wenn die Sitzung ausgelastet ist, und Falsch Wenn die Sitzung nicht ausgelastet ist.

Maximieren

Maximiert SAPBildschirm.

Minimieren

Minimiert SAPBildschirm.

Größe ändern

Ändert die Größe von SAPBildschirm gemäß den angegebenen Abmessungen.

Tabelle : 7. Ändern Sie die Größe der Methodenparameter

Parameter	Beschreibung	Datenport-Eingabetyp	Datentyp	Standardwert	Obligatorisch?
XPos	Position des Bildschirms entlang der X-Achse.	Daten In	Ganzzahl	Keine	Ja
YPos	Position des Bildschirms entlang der Y-Achse.	Daten In	Ganzzahl	Keine	Ja
Breite	Breite des Bildschirms.	Daten In	Ganzzahl	Keine	Ja
Höhe	Höhe des Bildschirms.	Daten In	Ganzzahl	Keine	Ja

Wiederherstellung

Stellt die ursprünglichen Abmessungen des Bildschirms wieder her.

ScreenId

Gibt die ID von zurück SAPAnwendungsbildschirm als Zeichenfolge.

SendKeys

Sendet die Tastaturstriche an SAPAnwendungsbildschirm.

Tabelle : 8. SendKeys-Methodenparameter

Parameter	Beschreibung	Datenport-Eingabetyp	Datentyp	Standardwert	Obligatorisch?
Keys	Tastaturstriche, die Sie an senden möchten SAPBildschirm.	Daten In	Zeichenfolge	NA	Ja

Transaktion starten

Startet eine Transaktion.

Tabelle : 9. StartTransaktionsmethodenparameter

Parameter	Beschreibung	Datenport-Eingabetyp	Datentyp	Standardwert	Obligatorisch?
Tcode	Transaktionscode, mit dem Sie auf einen bestimmten Teil der SAP-Anwendung zugreifen können.	Daten In	Zeichenfolge	NA	Ja

Warten auf Erstellen

Wartet für die angegebene Dauer, während der Bildschirm erstellt wird. Dadurch können alle dynamischen Steuerungen geladen werden, nachdem der Bildschirm erstellt wurde.

Tabelle : 10. WaitForCreate-Methodenparameter

Parameter	Beschreibung	Datenport-Eingabetyp	Datentyp	Standardwert	Obligatorisch?
ZeitüberschreitInSekunden	Dauer, nach der die Methode abläuft.	Daten In	Ganzzahl	Keine	Ja
Übereinstimmungalle untergeordneten Elemente	Option, um anzugeben, ob die Methode vor dem Laden des Bildschirms alle erfassten untergeordneten Bildschirme und Elemente mit dem Bildschirm abgleicht.	Daten In	Boolean	Falsch	Nein

Methoden auf Elementebene

In SAPConnector, können Sie diese Methoden auf Elementebene verwenden, um Elemente zu identifizieren, ihre Anwesenheit auf dem Bildschirm zu überprüfen oder Aktionen zu definieren, die für die Elemente ausgeführt werden sollen.

Die folgenden Tabellen enthalten Elemente und ihre verfügbaren Methoden. Eine Beschreibung dieser Methoden und ihrer Parameter finden Sie unter SAP Connector-Methoden.

Tabelle : 11. GuiButton-Methoden

Element	Methoden
Leitfadenschaltfläche	Klicken
	Hervorhebung
	Ist erstellt
	Mausklick ausführen
	SendKeys
	SetFocus
	Warten auf Erstellen

Tabelle : 12. GuiCheckBox-Methoden

Element	Methoden
Kontrollkästchen für Leitfaden	Überprüfen
	Hervorhebung
	Ist überprüft
	Ist erstellt
	SendKeys
	SetFocus
	Deaktivieren
	Mausklick ausführen
	Warten auf Erstellen

Tabelle : 13. GuiComboBox-Methoden

Element	Methoden
GuiComboBox	Abrufen
	GetIconName
	Liste abrufen
	Hervorhebung
	Ist erstellt
	SendKeys
	Satz
	SetFocus
	Mausklick ausführen
	Warten auf Erstellen

Tabelle : 14. GuiStrgGridView-Methoden

Element	Methoden
GuiStrgRasterAnsicht	Klicken Sie auf SchaltflächenCell
	Klicken Sie auf Cell
	Auswahl aller Zeilen aufheben
	GetCellType
	CellValue abrufen
	Spalten abrufen
	GetColumnsKeyValuePair
	Abrufen der Zeilenanzahl
	Zeilen abrufen
	Ruft RowsByColumn ab
	GetSelectedColumns
	Auswahl der Zeilen abrufen
	SingleRow abrufen
	Ruft VisibleRows ab
	Hervorhebung
	Ist erstellt
	Mausklick ausführen
	SendKeys
	SetFocus
	Wählen Sie alle Zeilen aus
	Wählen Sie Zelle aus
	Wählen Sie KontextmenüItemById aus
	Wählen Sie KontextmenüItemPosition aus
	Wählen Sie KontextmenüItemByText aus
	Wählen Sie Einzelzeile aus
	Wählen Sie ToolbarMenuItemById aus
	Wählen Sie ToolbarMenuItemPosition aus
	Wählen Sie ToolbarMenuItemText aus
	Wert festlegen
	Warten auf Erstellen

Tabelle : 15. Schuldhafte Methoden

Element	Methoden
Schuldig	GetText
	Hervorhebung
	Ist erstellt
	Mausklick ausführen
	SendKeys
	SetFocus
	Warten auf Erstellen

Tabelle : 16. GuiPassword-Methoden

Element	Methoden
GuiPassword	Hervorhebung
	Ist erstellt
	SendKeys
	CaretPosition festlegen
	SetFocus
	SetText
	Mausklick ausführen
	Warten auf Erstellen

Tabelle : 17. GuiRadioButton-Methoden

Element	Methoden
LeitfadenSchaltfläche	Hervorhebung
	Ist überprüft
	Ist erstellt
	Auswählen
	SendKeys
	SetFocus
	Mausklick ausführen
	Warten auf Erstellen

Tabelle : 18. GuiStatusBar-Methoden

Element	Methoden
GuiStatusleiste	GetStatus
	Hervorhebung
	Ist erstellt
	Mausklick ausführen
	SendKeys
	SetFocus
	Warten auf Erstellen

Tabelle : 19. GuiTab-Methoden

Element	Methoden
Registerkarte „Anleitung“	Hervorhebung
	Ist erstellt
	Wählen Sie Registerkarte aus
	SendKeys
	SetFocus
	Mausklick ausführen
	Warten auf Erstellen

Tabelle : 20. GuiTableControl-Methoden

Element	Methoden
GuiTableControl	Auswahl aller Sichtzeilen aufheben
	Auswahl der Zeile aufheben
	Deaktivieren Sie die sichtbare Zeile
	Ruft alle Sichtzeilen ab
	GetColumnName
	GetMaximumScrollOffset
	ScrollPosition abrufen
	SingleRow abrufen
	Gettable
	Ruft VisibleRowCount ab
	Hervorhebung
	Ist erstellt
	Mausklick ausführen
	Scrollen Sie nach unten nach OneRow
	Scrollen bis HorizontalPosition
	Scrollen bis Seite
	ScrollToPreviousPage
	Scrollen Sie zu VertikalPosition
	Scrollen nach OneRow
	Wählen Sie alle Zeilen aus
	Wählen Sie Einzelzeile aus
	Wählen Sie Sichtbare Zeile aus
	SendKeys
	SetFocus
	Warten auf Erstellen

Tabelle : 21. GuiTextBox-Methoden

Element	Methoden
GuiTextfeld	GetText
	Hervorhebung
	Ist erstellt
	SendKeys
	CaretPosition festlegen
	SetFocus
	SetText
	Mausklick ausführen
	Warten auf Erstellen

Tabelle : 22. GuiTree-Methoden

Element	Methoden
Leitfadenstruktur	Überprüfen
	Klicken Sie auf NodeItem
	CollapseNodeItem
	Doppelklicken Sie auf Knoten
	Doppelklicken Sie auf NodeItem
	GetColumnsKeyValuePair
	GetTreeType
	GetNodeKeyByPath
	GetNodeKeyByText
	GetNodeItemText
	GetSelectedNodes
	GetNodeItemCheckBoxState
	Hervorhebung
	Ist erstellt
	PresNodeItemButton
	Wählen Sie Registerkarte aus
	SendKeys
	SetFocus
	Mausklick ausführen
	Wählen Sie NodeItem aus
	Wählen Sie Knoten aus
	Wählen Sie KontextmenüItemById aus
	Wählen Sie KontextmenüItemByText aus
	Wählen Sie KontextmenüItemPosition aus
	Deaktivieren
	Warten auf Erstellen

Tabelle : 23. GuiUserArea-Methoden

Element	Methoden
GuiUserArea	Hervorhebung
	Ist erstellt
	Mausklick ausführen
	Scrollen bis Seite
	ScrollToPreviousPage
	SendKeys
	SetFocus
	HorizontalScrollen festlegen
	Vertikalen Bildlauf festlegen
	Warten auf Erstellen