SAP-Automatisierungsaktionen

Unsere Aktionsgruppe für die SAP-Automatisierung bietet eine Reihe von Tools, die Ihnen helfen, Ihre SAP-Workflows zu rationalisieren und zu automatisieren. Mit diesen Aktionen können Sie ganz einfach die SAP GUI-App starten, neue Sitzungen erstellen, Menüpunkte auswählen, Transaktionen starten und beenden und vieles mehr.

Mit den Aktionen der SAP-Automatisierungsgruppe können Sie einfach mit SAP-UI-Elementen interagieren, indem Sie sie anklicken, Textfelder ausfüllen und ihre Daten extrahieren. Geben Sie einfach den Attributwert der SAP-UI-Element-ID ein. Wenn Sie den ID-Wert nicht kennen, können Sie die UI-Elementauswahl für Power Automate für Desktop verwenden, um das erforderliche SAP-Element zu erfassen und seinen ID-Wert abzurufen. Wenn Sie ein SAP-UI-Element auf diese Weise erfassen, wird nur der ID-Wert des Elements wiederhergestellt und dem UI-Element-Repository des Desktop-Flows kein UI-Element hinzugefügt.

Unsere SAP-Automatisierungsaktionen können auch nahtlos mit anderen in Power Automate für Desktop verfügbaren Aktionen integriert werden, darunter der Aktionsgruppe für die UI-Automatisierung. Mit dieser Aktionsgruppe können Sie alle SAP-GUI-UI-Elemente erfassen und sie dem UI-Element-Repository des Desktop-Flows hinzufügen. Durch die Kombination unserer SAP-GUI-Automatisierungsaktionen mit der Aktionsgruppe für die UI-Automatisierung können Sie leistungsstarke RPA-Workflows erstellen, die selbst die komplexesten SAP-Prozesse automatisieren.

Anmerkung

Power Automate für Desktop unterstützt die Automatisierung mit SAP GUI der Version 750 oder höher.

SAP starten

Öffnen Sie die SAP-GUI-Anwendung und stellen Sie eine Verbindung zu einem SAP-System her.

Für den Verbindungsmodus:

• Mit der Option „Serverbeschreibung“ können Sie über den SAP-Namen oder die IP-Adresse eine Verbindung mit einem SAP-System herstellen. Hierzu benötigen Sie die notwendigen Anmeldedaten und Zugriffsberechtigungen. Die Serverbeschreibung ist ein für Menschen lesbarer Name oder eine Beschreibung des SAP-Systems.
• Mit der Option „Serververbindungszeichenfolge“ können Sie über eine Verbindungszeichenfolge eine Verbindung mit einem SAP-System herstellen. Die Serververbindungszeichenfolge enthält normalerweise den Namen oder die IP-Adresse des Servers, die Instanznummer und die System-ID. Die Serververbindungszeichenfolge hat ein spezielles Format für die Identifizierung eines SAP-Systems und das Herstellen der Verbindung.

Für mehrere Anmeldeoptionen:

• Durch Beenden dieser Anmeldeoption wird die Anmeldung der spezifischen Aktion beendet.
• Die Option „Diese Anmeldung fortsetzen und alle anderen Anmeldungen beenden“ ersetzt die vorhandene SAP-Instanz durch die spezifische Anmeldung.
• Die Option „Diese Anmeldung fortsetzen, ohne andere Anmeldungen im System zu beenden“ erstellt eine neue SAP-Sitzung.

Anmerkung

Die SAP-GUI erlaubt nicht mehr als sechs aktive Verbindungen (Sitzungen) zu einem SAP-System.

Eingabeparameter

Argument	Optional	Akzeptiert	Standardwert	Beschreibung
Verbindungsmodus	NICHT ZUTREFFEND	Serverbeschreibung und Serververbindungszeichenfolge	Serverbeschreibung	Legen Sie fest, wie eine Verbindung mit dem SAP GUI-Server hergestellt wird.
Anmeldemodus	NICHT ZUTREFFEND	Manuelle Anmeldung und einmaliges Anmelden (SSO)	Manuelle Anmeldung	Geben Sie an, wie Sie sich beim SAP GUI-Server anmelden. Melden Sie sich entweder durch manuelle Eingabe Ihres Benutzernamens und Kennworts oder durch einmaliges Anmelden (SSO) beim Server an.
Serverbeschreibung	Ja	Textwert		Gibt den SAP-Systemnamen oder die IP-Adresse für die Verbindung an.
Connection string	Ja	Textwert		Gibt die Verbindungszeichenfolge für den SAP-GUI-Server an. Die Verbindungszeichenfolge ist eine eindeutige Kennung, die den Namen des Servers, die Systemnummer und andere Verbindungsdetails angibt.
Client-ID	Nein	Textwert		Gibt die SAP-Clientnummer für die Verbindung an.
Username	Nein	Textwert		Gibt die SAP-Benutzer-ID für die Anmeldung an.
Password	Ja	Textwert		Gibt das SAP-Benutzer-Kenntwort für die Anmeldung an.
Language	Nein	Textwert		Legt die SAP-Anmeldesprache für die Benutzeroberfläche fest.
Mehrere Anmeldeoptionen	Nein	Beenden Sie diese Anmeldung, setzen Sie diese Anmeldung fort und beenden Sie alle anderen Anmeldungen. Setzen Sie diese Anmeldung fort, ohne andere Anmeldungen im System zu beenden	Anmeldung beenden	Mehrere Anmeldeoptionen legen fest, wie sich das SAP-System verhält, wenn Benutzende versuchen, sich anzumelden, wenn sie bereits angemeldet sind.

Erzeugte Variablen

Argument	Type	Beschreibung
SAPInstance	SAP-Instanz	Die SAP-Instanz, die mit SAP-Automatisierungsaktionen verwendet werden soll. Die SAP-Instanz bezieht sich auf das spezifische SAP-Fenster.
CurrentSAPLoginTerminated	Boolescher Wert	Ob die SAP-Anmeldung, die mit der bestimmten Aktion durchgeführt wird, beendet wird oder nicht.
OtherSAPLoginTerminated	Boolescher Wert	Ob die anderen SAP-Anmeldungen beendet werden oder nicht.

Ausnahmen

Ausnahme	Beschreibung
Die SAP-GUI-Anmeldeaktion schlägt fehl	Zeigt ein Problem bei der Anmeldung bei einem SAP-GUI-System an.

Attach

Fügen Sie die ausgeführte SAP GUI-Anwendung an eine SAP-Instanz an.

Eingabeparameter

Argument	Optional	Akzeptiert	Standardwert	Eigenschaft
Anfügemodus	Nr.	Vordergrund oder zuletzt aktiviert, Fenstertitel	Fenstertitel	Gibt den Modus zum Anfügen der SAP-Instanz an ein Fenster an. Wenn die Option „Vordergrund oder zuletzt aktiviert“ ausgewählt ist, wird die SAP-Instanz an die SAP-Sitzung im Vordergrund angefügt. Wenn sich keine SAP-Sitzung im Vordergrund befindet, wird sie an die zuletzt gestartete SAP-Sitzung angefügt, die noch nicht geschlossen ist.
Fenstertitel	Ja	Text		Gibt den Titel des SAP-Fensters an, an das die Instanz angefügt ist. Der Fenstertitel kann aus der Dropdownliste der vorhandenen SAP-Sitzungen ausgewählt oder manuell eingegeben werden.

Erzeugte Variablen

Argument	typ	Eigenschaft
SAPInstance	SAP-Instanz	Die SAP-Instanz, die mit SAP-Automatisierungsaktionen verwendet werden soll. Die SAP-Instanz bezieht sich auf das spezifische SAP-Fenster.

Ausnahmen

Ausnahme	Eigenschaft
Fehler beim Anfügen an SAP	Dies weist auf ein Problem beim Anfügen an eine SAP-Instanz hin.

Neue SAP-Sitzung erstellen

Erstellt eine neue SAP-Sitzung auf der Grundlage derselben SAP-Instanz.

Anmerkung

Die SAP-GUI erlaubt nicht mehr als sechs aktive Verbindungen (Sitzungen) zu einem SAP-System.

Eingabeparameter

Argument	Optional	Akzeptiert	Standardwert	Beschreibung
SAPInstance	Nein	SAP-Instanz	Wählen Sie Variable aus, in der sich die SAP-Instanz befindet, mit der Sie arbeiten möchten. Diese Variable sollte in einer vorherigen SAP-Anmeldeaktion definiert werden.

Erzeugte Variablen

Argument	Type	Beschreibung
SAPInstance	SAP-Instanz	Die SAP-Instanz, die mit SAP-Automatisierungsaktionen verwendet werden soll. Die SAP-Instanz bezieht sich auf das spezifische SAP-Fenster.

Ausnahmen

Ausnahme	Beschreibung
Die Aktion „Neue SAP-Sitzung erstellen“ schlägt fehl	Weist auf ein Problem beim Erstellen einer neuen SAP-Sitzung hin.

SAP-Menüoption auswählen

Wählen Sie in der Fenstersymbolleiste ein SAP-Menüelement aus. Geben Sie den Namen des Elements manuell in den entsprechenden Eingabeparameter ein, und zwar in derselben Sprache, in der der SAP-GUI-Bildschirm angezeigt wird.

Eingabeparameter

Argument	Optional	Akzeptiert	Standardwert	Beschreibung
SAPInstance	Nein	SAP-Instanz	Wählen Sie Variable aus, in der sich die SAP-Instanz befindet, mit der Sie arbeiten möchten. Diese Variable sollte in einer vorherigen SAP-Anmeldeaktion definiert werden.
Menüoptionsname	Nein	Textwert		Der Name des Menüelements in der Symbolleiste, das ausgewählt werden soll, beispielsweise „Speichern“. Geben Sie den Namen des Menüelements ein, wie er in der SAP-Installation des Computers angezeigt wird.

Erzeugte Variablen

Diese Aktion erzeugt keine Variablen.

Ausnahmen

Ausnahme	Beschreibung
Die Aktion „SAP-Menüelement auswählen“ schlägt fehl	Weist auf ein Problem bei der Auswahl eines Menüelements hin.

SAP-Verbindung schließen

Schließen Sie die SAP-Verbindung der ausgewählten SAP-Instanz. Beachten Sie, dass alle mit der spezifischen Verbindung verbundenen Instanzen beendet werden.

Eingabeparameter

Argument	Optional	Akzeptiert	Standardwert	Beschreibung
SAPInstance	Nein	SAP-Instanz	Wählen Sie Variable aus, in der sich die SAP-Instanz befindet, mit der Sie arbeiten möchten. Diese Variable sollte in einer vorherigen SAP-Anmeldeaktion definiert werden.

Erzeugte Variablen

Diese Aktion erzeugt keine Variablen.

Ausnahmen

Ausnahme	Beschreibung
Die Aktion „SAP-Sitzung schließen“ schlägt fehl	Weist auf ein Problem beim Schließen einer SAP-Sitzung hin.

SAP-Transaktion starten

Öffnet einen bestimmten Transaktionscode in einer vorhandenen Sitzung.

Eingabeparameter

Argument	Optional	Akzeptiert	Standardwert	Beschreibung
SAPInstance	Nein	SAP-Instanz	Wählen Sie Variable aus, in der sich die SAP-Instanz befindet, mit der Sie arbeiten möchten. Diese Variable sollte in einer vorherigen SAP-Anmeldeaktion definiert werden.
Transaktionscode	Nein	Textwert		Der Transaktionscode, den Sie ausführen möchten.

Erzeugte Variablen

Diese Aktion erzeugt keine Variablen.

Ausnahmen

Ausnahme	Beschreibung
Die Aktion „SAP-Transaktion starten“ schlägt fehl	Weist auf ein Problem beim Starten einer SAP-Transaktion hin.

SAP-Transaktion beenden

Schließt die SAP-Transaktion in einer bestimmten SAP-Instanz und kehrt zum SAP Easy Access-Menü zurück. Die jeweilige SAP-Sitzung erfordert, dass vorher eine SAP-Transaktion gestartet werden.

Eingabeparameter

Argument	Optional	Akzeptiert	Standardwert	Beschreibung
SAPInstance	Nein	SAP-Instanz	Wählen Sie Variable aus, in der sich die SAP-Instanz befindet, mit der Sie arbeiten möchten. Diese Variable sollte in einer vorherigen SAP-Anmeldeaktion definiert werden.

Erzeugte Variablen

Diese Aktion erzeugt keine Variablen.

Ausnahmen

Ausnahme	Beschreibung
Die Aktion „SAP-Transaktion beenden“ schlägt fehl	Weist auf ein Problem beim Beenden einer SAP-Transaktion hin.

Auf SAP-Benutzeroberflächenelement klicken

Interagiert durch eine Klickaktion auf ein beliebiges UI-Element eines SAP-Fensters.

Eingabeparameter

Argument	Optional	Akzeptiert	Standardwert	Beschreibung
SAPInstance	Nein	SAP-Instanz		Wählen Sie Variable aus, in der sich die SAP-Instanz befindet, mit der Sie arbeiten möchten. Diese Variable sollte in einer vorherigen SAP-Anmeldeaktion definiert werden.
Elementtyp	Nein	Grundlegendes SAP-Element, Kontrollkästchen, Beschriftung, Dropdownliste	Grundlegendes SAP-Element	Wählen Sie den SAP-Elementtyp aus, mit dem Sie interagieren müssen. Die Option „Auf SAP-Element klicken“ führt eine Klickaktion auf einem beliebigen SAP-Element aus, beispielsweise auf Schaltflächen, Optionsfeldern, Registerkarten, Textfeldern oder Strukturen.
SAP-Element-ID	Nein	Numeric		Die ID des SAP-Elementwerts. Dieser Parameter bestimmt, mit welchem UI-Element in SAP die Aktion interagiert. Sie können die folgende Schaltfläche verwenden, um das SAP-UI-Element auf dem SAP-Bildschirm anzuzeigen, oder den Wert manuell einzugeben.
SAP-Kontrollkästchenstatus festlegen auf	Ja	Aktiviert, Deaktiviert	Überprüft	Gibt an, ob das Kontrollkästchen aktiviert oder deaktiviert wird.
SAP-Element-ID	Nein	Numeric		Die ID des SAP-Elementwerts. Dieser Parameter bestimmt, mit welchem UI-Element in SAP die Aktion interagiert. Sie können die folgende Schaltfläche verwenden, um das SAP-UI-Element auf dem SAP-Bildschirm anzuzeigen, oder den Wert manuell einzugeben.
SAP-Beschriftungsvorgang	Ja	Erweitern, Reduzieren, Auswählen	Aufklappen	Gibt an, ob die SAP-Beschriftung erweitert oder reduziert werden soll.
Dropdownoptionswert	Ja	Textwert		Gibt an, dass die Dropdownoption ausgewählt ist.

Erzeugte Variablen

Diese Aktion erzeugt keine Variablen.

Ausnahmen

Ausnahme	Eigenschaft
Fehler beim Klicken auf SAP-GUI-Element	Gibt an, dass der Mausklick fehlgeschlagen ist.

Details von SAP-Benutzeroberflächenelement abrufen

Ruft den Attributwert eines SAP-UI-Elements in einem SAP-Fenster ab.

Eingabeparameter

Argument	Optional	Akzeptiert	Standardwert	Beschreibung
SAPInstance	Nein	SAP-Instanz		Wählen Sie Variable aus, in der sich die SAP-Instanz befindet, mit der Sie arbeiten möchten. Diese Variable sollte in einer vorherigen SAP-Anmeldeaktion definiert werden.
SAP-Element-ID	Nein	Numeric		Die ID des SAP-Elementwerts. Dieser Parameter bestimmt, mit welchem UI-Element in SAP die Aktion interagiert. Sie können die folgende Schaltfläche verwenden, um das SAP-UI-Element auf dem SAP-Bildschirm anzuzeigen, oder den Wert manuell einzugeben.
Attributename	Nein	Textwert	Eigener Text	Das Attribut, dessen Wert abgerufen wird.

Erzeugte Variablen

Argument	typ	Eigenschaft
AttributeValue	Textwert	Der Attributwert des SAP-Benutzeroberflächenelements.

Ausnahmen

Ausnahme	Eigenschaft
Fehler beim Abrufen von SAP-Elementdetail	Weist auf ein Problem beim Abrufen des UI-Elementattributs hin.

SAP-Textfeld in Element ausfüllen

Füllt ein Textfeld in einem SAP-Fenster mit dem angegebenen Text aus.

Eingabeparameter

Argument	Optional	Akzeptiert	Standardwert	Beschreibung
SAPInstance	Nein	SAP-Instanz		Wählen Sie Variable aus, in der sich die SAP-Instanz befindet, mit der Sie arbeiten möchten. Diese Variable sollte in einer vorherigen SAP-Anmeldeaktion definiert werden.
SAP-Element-ID	Nein	Numeric		Die ID des SAP-Elementwerts. Dieser Parameter bestimmt, mit welchem UI-Element in SAP die Aktion interagiert. Sie können die folgende Schaltfläche verwenden, um das SAP-UI-Element auf dem SAP-Bildschirm anzuzeigen, oder den Wert manuell einzugeben.
Auszufüllender Text	Nein	Direkte verschlüsselte Eingabe oder Textwert		Der in das SAP-Textfeld einzugebende Text
Wenn das Feld nicht leer ist	Ja	Text ersetzen, Text anhängen	Text ersetzen	Geben Sie an, ob vorhandener Inhalt ersetzt oder angehängt werden soll.

Erzeugte Variablen

Diese Aktion erzeugt keine Variablen.

Ausnahmen

Ausnahme	Eigenschaft
Fehler beim Auffüllen von SAP-Textfeldwert	Gibt ein Problem beim Ausfüllen des angegebenen SAP-Textfelds an.