SAP Connector-Methoden

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 5 Minuten Lesedauer
  • Der Connector SAP bietet verschiedene Methoden, mit denen Sie Workflows auf GUI-Schnittstellen (GUI) SAP von automatisieren können. SAP Connector-Methoden sind auf verschiedenen Ebenen verfügbar – Connector, Bildschirm und Element.

    SAP Connector-Methoden

    Die SAP Connector-Methoden sind auf drei Ebenen verfügbar.
    • Anwendung: Sie können diese Methoden finden, indem Sie auf das Connector-Objekt SAP doppelklicken. Um auf diese Methoden zuzugreifen, führen Sie die folgenden Schritte aus:
      1. Fügen Sie den SAP-Connector unter „ Globale Objekte“ im Bereich „Projektexplorer“ hinzu.

        Weitere Informationen finden Sie unter Konfigurieren Sie den Connector SAP.

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

        Die Methoden werden im Objekt-Explorer-Fenster angezeigt.

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

        Die Methoden werden im Objekt-Explorer-Fenster angezeigt.

    • Element: Verwenden Sie diese Methoden, um Aktionen für UI-Elemente des Bildschirms SAP zu automatisieren, z. B. für eine Schaltfläche oder ein Kontrollkästchen. Automatisieren Sie beispielsweise die Auswahl einer Schaltfläche. Um auf diese Methoden zuzugreifen, führen Sie die folgenden Schritte aus:
      1. Fügen Sie einen oder mehrere SAP-Anwendungsbildschirme hinzu. Informationen zur Konfiguration von finden Sie unter Konfigurieren Sie den Connector SAP.
      2. Erfassen Sie ein oder mehrere Bildschirmelemente. Informationen zum Erfassen von 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-Fenster angezeigt.

    Verwenden Sie die -Methoden

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

    Methoden verbunden.

    Methoden auf Anwendungsebene

    OpenConnection
    Stellt eine Verbindung zwischen dem Connector und der Anwendung SAP her. Sie müssen diese Methode zuerst verwenden, bevor Sie eine Automatisierung ausführen.
    Tabelle : 1. Parameter der OpenConnection-Methode
    Parameter Beschreibung Datenport-Eintragstyp Datentyp Standardwert Obligatorisch?
    name Name der Verbindung Dateneingang Zeichenfolge Keine Ja
    username Anwendername für die Herstellung der Verbindung. Dateneingang Zeichenfolge Keine Ja
    Passwort Passwort zum Herstellen der Verbindung. Dateneingang Zeichenfolge Keine Ja
    Standardsitzung festlegen
    Macht die ausgewählte Sitzung zu einer Standardsitzung.
    Tabelle : 2. Parameter der SetDefaultSession-Methode
    Parameter Beschreibung Datenport-Eintragstyp Datentyp Standardwert Obligatorisch?
    sessionId Eindeutige ID der Sitzung, die Sie als Standard festlegen möchten. Dateneingang Zeichenfolge Keine Ja
    Verbindung schließen
    Schließt die Verbindung zwischen dem -Connector und der Anwendung SAP.

    Methoden auf Bildschirmebene

    Klicken Sie auf Menüelement
    Wählt das Menüelement aus, für das Sie die ID von im Bildschirm SAP angeben.
    Tabelle : 3. Parameter der ClickMenuItem-Methode
    Parameter Beschreibung Datenport-Eintragstyp Datentyp Standardwert Obligatorisch?
    Menü-ID Die ID des Menüs, das ausgewählt werden muss. Dateneingang Zeichenfolge Keine Ja
    Schließen
    Schließt die Sitzung des Bildschirms SAP.
    CreateSession
    Erstellt eine Sitzung des Bildschirms SAP.
    Tabelle : 4. Parameter der CreateSession-Methode
    Parameter Beschreibung Datenport-Eintragstyp Datentyp Standardwert Obligatorisch?
    tCode Transaktionscode, mit dem Sie auf einen bestimmten Teil der SAP-Anwendung zugreifen können. Dateneingang Zeichenfolge NA Ja
    Zurück Gibt die ID der erstellten Sitzung zurück. Daten aus Zeichenfolge NA NA
    EndSession
    Beendet die offene Sitzung.
    EndTransaction
    Beendet eine Transaktion.
    Fokus
    Legt den Fokus auf die geöffnete Sitzung fest.
    GetMenuItem
    Ruft den Namen des angegebenen Menüelements ab.
    Tabelle : 5. Parameter der GetMenuItem-Methode
    Parameter Beschreibung Datenport-Eintragstyp Datentyp Standardwert Obligatorisch?
    Menü-ID ID des Menüelements, um den Namen abzurufen. Dateneingang Zeichenfolge Keine Ja
    Zurück Gibt den Namen des Menüelements zurück Daten aus Zeichenfolge Keine NA
    GetMenuItemsIdsByName
    Ruft die ID des Menüs ab, das Sie über den Namen angeben.
    Tabelle : 6. Parameter der GetMenuItemsIdsByName-Methode
    Parameter Beschreibung Datenport-Eintragstyp Datentyp Standardwert Obligatorisch?
    menuItemName Name des Menüelements. Daten aus Liste Keine NA
    GetWindowHandle
    Gibt das Fenster-Handle des Anwendungsbildschirms SAP zurück.
    IstErstellt
    Gibt „wahr“ zurück, wenn die Sitzung erstellt wird, und „falsch“, wenn sie nicht erstellt wird.
    IstSitzungBeschäftigt
    Gibt „true“ zurück, wenn die Sitzung ausgelastet ist, und „false“, wenn die Sitzung nicht ausgelastet ist.
    Maximieren
    Maximiert den Bildschirm SAP.
    Minimieren
    Minimiert den Bildschirm SAP.
    Größe ändern
    Ändert die Größe des Bildschirms SAP entsprechend den angegebenen Abmessungen.
    Tabelle : 7. Ändern Sie die Größe der Methodenparameter
    Parameter Beschreibung Datenport-Eintragstyp Datentyp Standardwert Obligatorisch?
    xPos Position des Bildschirms entlang der X-Achse. Dateneingang Ganzzahl Keine Ja
    yPos Position des Bildschirms entlang der Y-Achse. Dateneingang Ganzzahl Keine Ja
    Breite Breite des Bildschirms. Dateneingang Ganzzahl Keine Ja
    Höhe Höhe des Bildschirms. Dateneingang Ganzzahl Keine Ja
    Wiederherstellung
    Stellt die ursprünglichen Abmessungen des Bildschirms wieder her.
    ScreenId
    Gibt die ID des Anwendungsbildschirms SAP als Zeichenfolge zurück.
    SendKeys

    Sendet die Tastaturanschläge an den Anwendungsbildschirm SAP.

    Tabelle : 8. Parameter der SendKeys-Methode
    Parameter Beschreibung Datenport-Eintragstyp Datentyp Standardwert Obligatorisch?
    Keys Tastenanschläge, die Sie an den Bildschirm SAP senden möchten. Dateneingang Zeichenfolge NA Ja
    StartTransaction
    Startet eine Transaktion.
    Tabelle : 9. StartTransaction-Methodenparameter
    Parameter Beschreibung Datenport-Eintragstyp Datentyp Standardwert Obligatorisch?
    tCode Transaktionscode, mit dem Sie auf einen bestimmten Teil der SAP-Anwendung zugreifen können. Dateneingang Zeichenfolge NA Ja
    WartenAufErstellen
    Wartet die angegebene Dauer, während der Bildschirm erstellt wird. Dadurch können alle dynamischen Steuerelemente geladen werden, nachdem der Bildschirm erstellt wurde.
    Tabelle : 10. Parameter der Methode „WaitForCreate“.
    Parameter Beschreibung Datenport-Eintragstyp Datentyp Standardwert Obligatorisch?
    timeoutInSeconds Dauer, nach der die Methode abläuft. Dateneingang Ganzzahl Keine Ja
    AlleUntergeordnetenAbgleichen Option, um anzugeben, ob die Methode vor dem Laden des Bildschirms alle erfassten untergeordneten Bildschirme und Elemente mit dem Bildschirm abgleicht. Dateneingang Boolean falsch Nein

    Methoden auf Elementebene

    Im Connector SAP 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 die verfügbaren Methoden. Eine Beschreibung dieser Methoden und ihrer Parameter finden Sie unter SAP Connector-Methoden.

    Tabelle : 11. GUIButton-Methoden
    Element REST-Nachrichtenfunktionen
    GUIButton Klicken
    Hervorhebung
    IstErstellt
    Mausklick
    SendKeys
    Fokus festlegen
    WartenAufErstellen
    Tabelle : 12. GUICheckBox-Methoden
    Element REST-Nachrichtenfunktionen
    GUICheckBox Überprüfen
    Hervorhebung
    IstÜberprüft
    IstErstellt
    SendKeys
    Fokus festlegen
    Deaktivieren
    Mausklick
    WartenAufErstellen
    Tabelle : 13. GUIComboBox-Methoden
    Element REST-Nachrichtenfunktionen
    GUIComboBox Abrufen
    GetIconName
    GetList
    Hervorhebung
    IstErstellt
    SendKeys
    Satz
    Fokus festlegen
    Mausklick
    WartenAufErstellen
    Tabelle : 14. GUICTrGgridView-Methoden
    Element REST-Nachrichtenfunktionen
    GUIStrgRasterAnsicht Klicken Sie auf Schaltfläche Zelle
    Klicken Sie auf Zelle
    AuswahlAlleZeilen aufheben
    GetCellType
    GetCellValue
    GetColumns
    „GetColumnsKeyValuePair“
    GetRowCount
    GetRows
    GetRowsByColumn
    GetSelectedColumns
    GetSelectedRows
    GetSingleRow
    GetVisibleRows
    Hervorhebung
    IstErstellt
    Mausklick
    SendKeys
    Fokus festlegen
    Wählen SieAlle Zeilen aus
    Wählen SieZelleaus
    SelectContextMenuItemById
    SelectContextMenuItemByPosition
    Wählen SieKontextMenüElementNachText
    SelectSingleRow
    Wählen SieSymbolleisteMenüElementNachID aus
    Wählen SieSymbolleisteMenüElementNachPositionaus
    Wählen SieSymbolleisteMenüElementNachTextaus
    Zellenwert festlegen
    WartenAufErstellen
    Tabelle : 15. GUILabel-Methoden
    Element REST-Nachrichtenfunktionen
    GUILabel GetText
    Hervorhebung
    IstErstellt
    Mausklick
    SendKeys
    Fokus festlegen
    WartenAufErstellen
    Tabelle : 16. GUIPassword-Methoden
    Element REST-Nachrichtenfunktionen
    GUIPassword Hervorhebung
    IstErstellt
    SendKeys
    CaretPosition festlegen
    Fokus festlegen
    Text festlegen
    Mausklick
    WartenAufErstellen
    Tabelle : 17. GUIOptionsButton-Methoden
    Element REST-Nachrichtenfunktionen
    GUIOptionsschaltfläche Hervorhebung
    IstÜberprüft
    IstErstellt
    Auswahlvorgang
    SendKeys
    Fokus festlegen
    Mausklick
    WartenAufErstellen
    Tabelle : 18. GUIStatusBar-Methoden
    Element REST-Nachrichtenfunktionen
    GUIStatusBar GetStatus
    Hervorhebung
    IstErstellt
    Mausklick
    SendKeys
    Fokus festlegen
    WartenAufErstellen
    Tabelle : 19. GUITAB-Methoden
    Element REST-Nachrichtenfunktionen
    GUITAB Hervorhebung
    IstErstellt
    Wählen Sie Registerkarte
    SendKeys
    Fokus festlegen
    Mausklick
    WartenAufErstellen
    Tabelle : 20. GUITableControl-Methoden
    Element REST-Nachrichtenfunktionen
    GUITableControl DeselectAllVisibleRows
    DeselectRow
    DeselectVisibleRow
    GetAllVisibleRows
    GetColumnNames
    Maximalen BildlaufOffset abrufen
    GetScrollPosition
    GetSingleRow
    GetTable
    GetVisibleRowCount
    Hervorhebung
    IstErstellt
    Mausklick
    ScrollDownByOneRow
    ScrollToHorizontalPosition
    ScrollToNextPage
    ScrollToPreviusPage
    ScrollToVerticalPosition
    ScrollUpByOneRow
    Wählen SieAlle Zeilen aus
    SelectSingleRow
    SelectVisibleRow
    SendKeys
    Fokus festlegen
    WartenAufErstellen
    Tabelle : 21. GUITextBox-Methoden
    Element REST-Nachrichtenfunktionen
    GUITextBox GetText
    Hervorhebung
    IstErstellt
    SendKeys
    CaretPosition festlegen
    Fokus festlegen
    Text festlegen
    Mausklick
    WartenAufErstellen
    Tabelle : 22. GUITree-Methoden
    Element REST-Nachrichtenfunktionen
    GUITree Überprüfen
    Klicken Sie auf Knotenelement
    ReduzierenKnotenelement
    Doppelklicken Sie auf den Knoten
    DoppelklickKnotenelement
    „GetColumnsKeyValuePair“
    GetTreeType
    GetNodeKeyByPath
    GetNodeKeyByText
    AbrufenKnotenElementText
    AusgewählteKnoten abrufen
    GetNodeItemCheckBoxState
    Hervorhebung
    IstErstellt
    Drücken SieKnotenElementSchaltfläche
    Wählen Sie Registerkarte
    SendKeys
    Fokus festlegen
    Mausklick
    Wählen SieKnotenelement aus
    Wählen SieKnoten aus
    SelectContextMenuItemById
    Wählen SieKontextMenüElementNachText
    SelectContextMenuItemByPosition
    Deaktivieren
    WartenAufErstellen
    Tabelle : 23. GUIUserArea-Methoden
    Element REST-Nachrichtenfunktionen
    GUIUserArea Hervorhebung
    IstErstellt
    Mausklick
    ScrollToNextPage
    ScrollToPreviusPage
    SendKeys
    Fokus festlegen
    Legen Sie Horizontal Scroll fest
    Legen SieVerticalScroll fest
    WartenAufErstellen