SAP-Workload-Integrationen - Amazon Quick Suite
Was Sie tun könnenBevor Sie beginnenBereiten Sie die Konfiguration und Authentifizierung des SAP-Systems vorRichten Sie SAP-Integrationen einVerfügbare Operationen nach KonnektortypAbfrageparameterVerwalten Sie SAP-Workload-IntegrationenBeheben Sie Fehler bei SAP-Workload-Integrationen

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

SAP-Workload-Integrationen

Mit SAP-Workload-Integrationen können Sie Aktionen in verschiedenen SAP-Systemen ausführen. Verwalten Sie Geschäftsdaten, Inventar, Materialien und Geschäftsprozesse. Diese Integrationen unterstützen nur die Ausführung von Aktionen und erfordern die Amazon Quick Suite Pro-Stufe oder höher.

Was Sie tun können

SAP-Workload-Integrationen bieten Konnektivität auf Unternehmensebene, um Sie bei der Arbeit mit Ihren SAP-Systemen zu unterstützen.

Action-Konnektor

Führen Sie Aktionen innerhalb von SAP-Systemen aus. Erstellen, aktualisieren und verwalten Sie Geschäftsdaten, Inventaraufzeichnungen, Materialinformationen und andere Unternehmensvorgänge über SAP APIs.

Mehrere SAP-Module

Support für fünf verschiedene Integrationstypen: Stückliste, Geschäftspartner, Materiallager, Inventurdokumente und Product Master.

Bevor Sie beginnen

Bevor Sie SAP-Workload-Integrationen einrichten, stellen Sie sicher, dass Sie über Folgendes verfügen:

  • SAP-System mit den entsprechenden installierten und konfigurierten Modulen.

  • SAP-Benutzerkonto mit den erforderlichen Berechtigungen und Autorisierungen.

  • Amazon Quick Suite Author oder höher.

  • Netzwerkkonnektivität zwischen Amazon Quick Suite und Ihrem SAP-System.

Bereiten Sie die Konfiguration und Authentifizierung des SAP-Systems vor

Bevor Sie die Integration in Amazon Quick Suite einrichten, bereiten Sie Ihre SAP-Systemkonfiguration und Benutzerauthentifizierung vor. SAP-Workload-Integrationen unterstützen mehrere Authentifizierungsmethoden und erfordern eine korrekte Systemeinrichtung.

Authentifizierungsmethoden

SAP-Workload-Integrationen unterstützen zwei Authentifizierungsmethoden:

OAuth 2.0 (empfohlen)

Sichere Authentifizierungsmethode für automatisierte Workflows. Erfordert eine OAuth Konfiguration in Ihrem SAP-System.

Erforderliche Parameter:

  • Kunden-ID - OAuth SAP-Client-ID

  • Geheimer Kunde — Geheimer OAuth SAP-Client

  • Token-URL — OAuth Token-Endpunkt (z. B.https://hostname:port/sap/bc/sec/oauth2/token?sap-client=100)

  • Domain-URL — API-Endpunkt des SAP-Systems (z. B.https://hostname:port/sap/opu/odata/sap/API_BUSINESS_PARTNER)

Standardauthentifizierung

Authentifizierung mit Benutzername und Passwort für den direkten Zugriff auf das SAP-System.

Erforderliche Parameter:

  • Nutzername — Benutzername des SAP-Systems

  • Passwort - SAP-Systemkennwort

  • Domain-URL — API-Endpunkt des SAP-Systems

Anforderungen an die SAP-Systemkonfiguration

Stellen Sie vor der Verwendung von SAP-Workload-Integrationen sicher, dass Ihr SAP-System ordnungsgemäß konfiguriert ist:

OAuth 2.0-Setup

Für die OAuth 2.0-Authentifizierung:

  • Konfigurieren Sie den OAuth Autorisierungsserver mit den entsprechenden Bereichen

  • Überprüfen Sie anhand des Transaktionscodes, ob der Dienst aktiviert OAuth ist /IWFND/MAINT_SERVICE

  • Eine detaillierte OAuth 2.0-Konfiguration finden Sie in der SAP-Dokumentation: OAuth 2.0-Konfigurationshandbuch

SAP-API-Aktivierung

Stellen Sie sicher, dass die erforderlichen SAP-API-Dienste aktiv sind:

Verfügbare SAP-Workload-Integrationstypen

Wählen Sie den SAP-Integrationstyp, der Ihren Geschäftsanforderungen entspricht, und stellen Sie sicher, dass das entsprechende SAP-Modul in Ihrem System verfügbar ist.

SAP-Stückliste

Verwalten Sie Stücklistendaten, einschließlich Komponentenlisten, Mengen und Fertigungsspezifikationen.

Erforderlicher Umfang: ZAPI_BILL_OF_MATERIAL_SRV_0002

SAP-Geschäftspartner

Verarbeiten Sie Geschäftspartnerinformationen, einschließlich Kunden- und Lieferantendaten, Kontaktdaten und Beziehungsmanagement.

Erforderlicher Umfang: ZAPI_BUSINESS_PARTNER_0001

SAP-Materiallager

Greifen Sie auf Materialbestände, Lagerbewegungen und Lagerinformationen zu und verwalten Sie diese.

Erforderlicher Umfang: ZAPI_MATERIAL_STOCK_SRV_0001

Dokumente zur physischen Bestandsaufnahme von SAP

Erstellen und verwalten Sie Inventurdokumente, Bestandszählungen und Prozesse zur Bestandsabstimmung.

Erforderlicher Umfang: ZAPI_MATERIAL_STOCK_SRV_0001

SAP-Produktmaster

Pflegen Sie Produktstammdaten, einschließlich Materialspezifikationen, Klassifizierungen und Produkthierarchien.

Erforderlicher Umfang: ZAPI_PRODUCT_SRV_0001

Einrichtung der SAP-Workload-Authentifizierung

Bereiten Sie die Anmeldeinformationen für die SAP-Benutzerauthentifizierung vor und stellen Sie die richtigen Systemzugriffsberechtigungen sicher.

  • SAP-System-URL — Rufen Sie die Basis-URL oder Serveradresse für Ihr SAP-System ab.

  • Benutzeranmeldedaten — Erstellen oder identifizieren Sie ein SAP-Benutzerkonto mit den entsprechenden Berechtigungen.

  • Systemberechtigungen — Stellen Sie sicher, dass das Benutzerkonto über die erforderlichen SAP-Autorisierungen und Transaktionscodes für die spezifischen SAP-Module verfügt, die Sie integrieren möchten.

  • Netzwerkzugriff — Stellen Sie sicher, dass Ihr SAP-System von externen Verbindungen aus zugänglich ist und ob die Firewallregeln die Integration zulassen.

Richten Sie SAP-Integrationen ein

Nachdem Sie Ihre SAP-Systemkonfiguration und Ihre Anmeldeinformationen vorbereitet haben, ist der Einrichtungsprozess für alle SAP-Integrationstypen ähnlich. Wählen Sie je nach Ihren Sicherheitsanforderungen zwischen OAuth 2.0 oder Basic Authentication.

  1. Wählen Sie in der Amazon Quick Suite-Konsole Integrationen aus.

  2. Wählen Sie einen der verfügbaren SAP-Konnektoren aus:

    • SAP-Stückliste

    • SAP-Geschäftspartner

    • SAP-Materiallager

    • Dokumente zur physischen Bestandsaufnahme von SAP

    • SAP-Produktmaster

  3. Klicken Sie auf Hinzufügen (mit der Schaltfläche „+“).

  4. Geben Sie den Namen und die Beschreibung für Ihre SAP-Integration ein.

  5. Wählen Sie den Verbindungstyp für Ihre Integration.

  6. Konfigurieren Sie die Authentifizierung mit einer der unterstützten Methoden:

    1. OAuth 2.0-Konfiguration

      Geben Sie für die OAuth 2.0-Authentifizierung Folgendes an:

      • Client-ID — Ihre OAuth SAP-Client-ID

      • Kundengeheimnis — Ihr geheimer OAuth SAP-Client

      • Token-URL — OAuth Token-Endpunkt-URL

      • Domain-URL — URL des API-Endpunkts des SAP-Systems

    2. Grundlegende Authentifizierungskonfiguration

      Geben Sie für die Standardauthentifizierung Folgendes an:

      • Nutzername — Ihr SAP-System-Benutzername

      • Passwort — Ihr SAP-Systemkennwort

      • Domain-URL — URL des API-Endpunkts des SAP-Systems

  7. Wählen Sie Erstellen und fortfahren.

  8. Wählen Sie Benutzer aus, mit denen Sie die Integration teilen möchten.

  9. Klicken Sie auf Weiter.

Erwartete Ergebnisse

Nach erfolgreicher Einrichtung wird Ihre SAP-Workload-Integration in der Integrationsliste angezeigt und kann in Amazon Quick Suite-Workflows, Automatisierungen und KI-Agenten verwendet werden. Mit den konfigurierten Authentifizierungsdaten können Sie SAP-spezifische Aktionen direkt von Amazon Quick Suite aus ausführen.

Verfügbare Operationen nach Konnektortyp

Jeder SAP-Workload-Connector bietet spezifische Operationen, die auf seine Geschäftsdomäne zugeschnitten sind. Überprüfen Sie die verfügbaren Operationen für den von Ihnen ausgewählten Konnektortyp.

SAP-Stücklistenoperationen

Verfügbare Operationen für die Verwaltung von Stücklistendaten:

  • Materialstücklistenartikel abrufen — Ruft Stücklistendetails für bestimmte Materialien ab

    Vorgangs-ID: getMaterialBOMItem

    Endpunkt: GET /MaterialBOMItem

Betrieb von SAP-Geschäftspartnern

Verfügbare Operationen für die Verwaltung von Geschäftspartnerdaten:

  • Geschäftspartner abrufen — Ruft allgemeine Geschäftspartnerdaten ab

    Vorgangs-ID: getBusinessPartner

  • Geschäftspartneradressen abrufen — Ruft die Adressdaten von Geschäftspartnern ab

    Vorgangs-ID: getBusinessPartnerAddress

  • Geschäftspartnerrollen abrufen — Ruft Daten zu Geschäftspartnerrollen ab

    Vorgangs-ID: getBusinessPartnerRole

  • Geschäftspartner anhand der ID abrufen — Ruft Geschäftspartnerdaten nach Geschäftspartnernummer ab

    Vorgangs-ID: getBusinessPartnerByID

    Erforderlicher Parameter: BusinessPartner (Zeichenfolge, max. 10 Zeichen)

  • Geschäftspartnerrolle anhand der ID abrufen — Ruft mithilfe von Schlüsselfeldern Daten zur Geschäftspartnerrolle ab

    Vorgangs-ID: getBusinessPartnerRoleByID

    Erforderliche Parameter: BusinessPartner (Zeichenfolge, maximal 10 Zeichen), BusinessPartnerRole (Zeichenfolge, maximal 6 Zeichen)

Betriebsabläufe im SAP-Materiallager

Verfügbare Operationen zur Verwaltung von Materialbestandsdaten:

  • Materialbestand im Konto abrufen — Ruft Materialbestandsinformationen ab, die im Kontenmodell gebucht wurden

    Vorgangs-ID: getMaterialStockInAccount

Das physische Inventar von SAP dokumentiert die Vorgänge

Verfügbare Operationen für die Verwaltung von Inventardokumenten:

  • PhysInventory Doc Item abrufen — Liest Informationen zu Inventarartikeln

    Vorgangs-ID: getPhysInventoryDocItem

SAP-Produktmaster-Operationen

Verfügbare Operationen für die Verwaltung von Produktstammdaten:

  • Produktstammartikel abrufen — Gibt Produktstammdatensätze zurück

    Vorgangs-ID: getProductMaster

  • Betriebsdaten nach Material abrufen — Gibt Werksdaten aus dem Produktstammsatz zurück

    Vorgangs-ID: getPlantDataByMaterial

    Erforderlicher Parameter: Product (Zeichenfolge, max. 40 Zeichen)

  • Lieferplanungsdaten nach Material abrufen — Gibt Lieferplanungsdaten nach Produktnummer und Werk zurück

    Vorgangs-ID: getSupplyPlanningDataByMaterial

    Erforderliche Parameter: Product (Zeichenfolge, maximal 40 Zeichen), Plant (Zeichenfolge, maximal 4 Zeichen)

Abfrageparameter

SAP-Konnektoren unterstützen Standard-Abfrageparameter zum Filtern, Sortieren und Formatieren von API-Antworten. Verwenden Sie diese Parameter, um den Datenabruf und die Datenverarbeitung zu optimieren.

Unterstützte Abfrageparameter
# Parameter Description Typ
1 $top Beschränkt die Anzahl der zurückgegebenen Artikel Ganzzahl
2 $skip Überspringt die angegebene Anzahl von Artikeln Ganzzahl
3 $filter Filtert Ergebnisse nach bestimmten Kriterien Zeichenfolge
4 $orderby Sortiert die Ergebnisse nach bestimmten Feldern Array
5 $select Wählt bestimmte Eigenschaften aus, die zurückgegeben werden sollen Array
6 $expand Erweitert verwandte Entitäten Array
7 $inlinecount Beinhaltet die Anzahl der Artikel als Antwort Zeichenfolge

Verwalten Sie SAP-Workload-Integrationen

Nachdem Sie Ihre SAP-Workload-Integration erstellt haben, können Sie sie mit verschiedenen Optionen verwalten.

Bearbeiten Sie die Integrationseinstellungen

Gehen Sie wie folgt vor, um Ihre Einstellungen für die SAP-Workload-Integration zu ändern.

  1. Wählen Sie in der Amazon Quick Suite-Konsole Integrationen aus.

  2. Wählen Sie Ihren SAP-Workload-Integrationstyp aus dem Integrationsraster aus.

  3. Wählen Sie Ihre Integration aus der Liste aus und klicken Sie auf Bearbeiten.

  4. Ändern Sie die Integrationseinstellungen:

    • Aktualisieren Sie die Authentifizierungsdaten (Benutzername und Passwort).

    • Ändern Sie die URL oder die Verbindungseinstellungen des SAP-Systems.

    • Ändern Sie den Namen oder die Beschreibung der Integration.

  5. Wählen Sie Änderungen speichern, um Ihre Änderungen zu übernehmen.

Integration teilen

Sie können SAP-Workload-Aktionskonnektoren mit anderen Benutzern in Ihrer Organisation gemeinsam nutzen.

  1. Wählen Sie auf der Seite mit den SAP-Integrationsdetails die Option Teilen aus.

  2. Konfigurieren Sie die Optionen zum Teilen:

    • Mit bestimmten Benutzern teilen — Geben Sie Benutzernamen oder E-Mail-Adressen ein.

    • Mit der Organisation teilen — Für alle Benutzer in Ihrer Organisation verfügbar machen.

  3. Legen Sie Berechtigungsstufen für den gemeinsamen Zugriff fest.

  4. Wählen Sie Share-Integration aus, um die Freigabeeinstellungen zu übernehmen.

Integration löschen

Gehen Sie wie folgt vor, um Ihre SAP-Integration dauerhaft zu entfernen.

  1. Wählen Sie auf der Detailseite zur SAP-Workload-Integration die Option Löschen aus.

  2. Überprüfen Sie die Auswirkungen des Löschvorgangs, einschließlich aller Workflows oder Automatisierungen, die diese Integration verwenden.

  3. Geben Sie den Namen der Integration ein, um das Löschen zu bestätigen.

  4. Wählen Sie Integration löschen, um sie dauerhaft zu entfernen.

Beheben Sie Fehler bei SAP-Workload-Integrationen

Verwenden Sie diese Tipps zur Fehlerbehebung, um häufig auftretende Probleme mit der SAP-Workload-Integration zu lösen.

Probleme mit der Authentifizierung

OAuth Fehler bei der 2.0-Authentifizierung

Symptome: Fehler bei der Token-Generierung, ungültige Client-Anmeldeinformationen oder OAuth Bereichsfehler.

Auflösung

  • Stellen Sie sicher, dass die OAuth Client-ID und der geheime Client-Schlüssel korrekt sind

  • Überprüfen Sie mithilfe von Transaction, ob OAuth es in SAP richtig konfiguriert ist /IWFND/MAINT_SERVICE

  • Stellen Sie sicher, dass die erforderlichen Bereiche für Ihren SAP-Workload-Connector-Typ ordnungsgemäß konfiguriert sind

  • Stellen Sie sicher, dass das Token-URL-Format Ihrer SAP-Systemkonfiguration entspricht

Fehler bei der grundlegenden Authentifizierung

Symptome: Anmeldefehler, ungültige Anmeldeinformationen oder Fehler mit Zugriffsverweigerung.

Auflösung

  • Stellen Sie sicher, dass der SAP-Benutzername und das Passwort korrekt sind

  • Stellen Sie sicher, dass das Benutzerkonto über die erforderlichen SAP-Autorisierungen verfügt

  • Stellen Sie sicher, dass das Benutzerkonto nicht gesperrt oder abgelaufen ist

  • Stellen Sie sicher, dass auf die Domain-URL zugegriffen werden kann und sie korrekt formatiert ist

Probleme mit der SAP-Systemkonfiguration

Der API-Dienst ist nicht aktiviert

Symptome: Fehler „Dienst nicht verfügbar“, API-Endpunkt nicht gefunden oder HTTP 404-Antworten.

Auflösung

  • Stellen Sie sicher, dass der erforderliche SAP-API-Dienst in Ihrem System aktiviert ist

  • Überprüfen Sie den API-Dienststatus mithilfe von SAP-Transaktionscodes

  • Stellen Sie sicher, dass der API-Service dem von Ihnen ausgewählten SAP-Connector-Typ entspricht

  • Wenden Sie sich an Ihren SAP-Administrator, um fehlende API-Dienste zu aktivieren

Verbindungs-Timeouts

Symptome: Zeitüberschreitungen bei Anfragen, Netzwerkverbindungsfehler oder langsame Antwortzeiten.

Auflösung

  • Vergewissern Sie sich, dass Ihre SAP-System-URL korrekt und zugänglich ist

  • Stellen Sie sicher, dass die Netzwerkkonnektivität Verbindungen zum SAP-System ermöglicht

  • Stellen Sie sicher, dass die Firewallregeln den Integrationsverkehr zulassen

  • Überprüfen Sie die Leistung und Verfügbarkeit des SAP-Systems

Berechtigungs- und Autorisierungsfehler

Unzureichende SAP-Autorisierungen

Symptome: Fehler mit verweigertem Zugriff, fehlende Autorisierungsnachrichten oder Fehler bei eingeschränkten Vorgängen.

Auflösung

  • Stellen Sie sicher, dass der authentifizierte Benutzer SAP-Autorisierungen für das jeweilige Modul benötigt

  • Stellen Sie sicher, dass der Benutzer Zugriff auf die erforderlichen Transaktionscodes hat

  • Vergewissern Sie sich, dass das Benutzerkonto über die entsprechenden Rollenzuweisungen verfügt

  • Wenden Sie sich an Ihren SAP-Administrator, um fehlende Berechtigungen zu erteilen

Fehler bei den Zugriffsberechtigungen

Symptome: OAuth Bereichsfehler, unzureichende Berechtigungen für API-Operationen oder Meldungen mit eingeschränktem Zugriff.

Auflösung

  • Stellen Sie sicher, dass die OAuth Konfiguration den erforderlichen Bereich für Ihren Connectortyp umfasst

  • Stellen Sie sicher, dass die Bereichsberechtigungen im SAP-System ordnungsgemäß erteilt wurden

  • Stellen Sie sicher, dass dem OAuth Kunden die erforderlichen API-Zugriffsrechte gewährt wurden

Datenformat- und Parameterfehler

Ungültige Parameterformate

Symptome: Fehler bei der Datenüberprüfung, Meldungen mit ungültiger Feldlänge oder Ausnahmen beim Parameterformat.

Auflösung

  • Überprüfen Sie die Aktionsparameter und stellen Sie sicher, dass sie den erwarteten SAP-Datenformaten entsprechen

  • Prüfen Sie, ob die Feldlängen den SAP-Systemanforderungen entsprechen (z. B. BusinessPartner maximal 10 Zeichen)

  • Stellen Sie sicher, dass die Datentypen für das jeweilige SAP-Modul korrekt sind

  • Stellen Sie sicher, dass alle erforderlichen Felder für den Vorgang bereitgestellt werden

Fehler bei Abfrageparametern

Symptome: Abfragesyntaxfehler, nicht unterstützte Parametermeldungen oder falsch formatierte Anforderungsfehler.

Auflösung

  • Stellen Sie sicher, dass die Parameter die richtige Syntax verwenden (z. B.,$filter,$top) $skip

  • Überprüfen Sie, ob die Parameterwerte richtig formatiert sind

  • Stellen Sie sicher, dass die SAP-API die verwendeten spezifischen Parameter unterstützt

  • Die unterstützten Abfrageoptionen finden Sie in der SAP-API-Dokumentation

Probleme mit der Verfügbarkeit von SAP-Systemen

Nichtverfügbarkeit des SAP-Systems

Symptome: Fehler „Verbindung verweigert“, System reagiert nicht oder Meldungen, dass der Dienst nicht verfügbar ist.

Auflösung

  • Erkundigen Sie sich bei Ihrem SAP-Administrator über den Status und die Verfügbarkeit des SAP-Systems

  • Überprüfen Sie, ob es geplante Wartungsfenster gibt, die sich auf das System auswirken

  • Suchen Sie nach SAP-Systemwarnungen oder bekannten Problemen

  • Versuchen Sie den Vorgang erneut, nachdem Sie die Systemverfügbarkeit bestätigt haben