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 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 Author oder höher.
+ Netzwerkkonnektivität zwischen Amazon Quick und Ihrem SAP-System.
## Bereiten Sie die Konfiguration und Authentifizierung des SAP-Systems vor
Bevor Sie die Integration in Amazon Quick 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](https://help.sap.com/docs/ABAP_PLATFORM_NEW/fd0fc52fd22b45f29d274a7f8236e768/cdb122d5b0784c77bf1bcce17f730e74.html)
#### SAP-API-Aktivierung
Stellen Sie sicher, dass die erforderlichen SAP-API-Dienste aktiv sind:
+ Aktivieren Sie den spezifischen API-Service für den von Ihnen ausgewählten SAP-Konnektor
+ Überprüfen Sie den API-Servicestatus in Ihrem SAP-System
+ Informationen zur API-Aktivierung finden Sie in der [SAP-Dokumentation: Leitfaden zur Aktivierung des SAP-API-Dienstes](https://help.sap.com/doc/saphelp_nw75/7.5.5/en-US/1b/023c1cad774eeb8b85b25c86d94f87/frameset.htm)
### 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-Konsole **Integrationen** aus.
1. 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**
1. Klicken Sie auf **Hinzufügen** (mit der Schaltfläche „\$1“).
1. Geben Sie den Namen und die Beschreibung für Ihre SAP-Integration ein.
1. Wählen Sie den Verbindungstyp für Ihre Integration.
1. 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
1. **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
1. Wählen Sie **Erstellen und fortfahren**.
1. Wählen Sie Benutzer aus, mit denen Sie die Integration teilen möchten.
1. Klicken Sie auf **Weiter**.
### Erwartete Ergebnisse
Nach erfolgreicher Einrichtung wird Ihre SAP-Workload-Integration in der Integrationsliste angezeigt und kann in Amazon Quick-Workflows, Automatisierungen und KI-Agenten verwendet werden. Mit den konfigurierten Authentifizierungsdaten können Sie SAP-spezifische Aktionen direkt von Amazon Quick 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**
| \$1 | Parameter | Description | Typ |
| --- | --- | --- | --- |
| 1 | \$1top | Beschränkt die Anzahl der zurückgegebenen Artikel | Ganzzahl |
| 2 | \$1skip | Überspringt die angegebene Anzahl von Artikeln | Ganzzahl |
| 3 | \$1filter | Filtert Ergebnisse nach bestimmten Kriterien | Zeichenfolge |
| 4 | \$1orderby | Sortiert die Ergebnisse nach bestimmten Feldern | Array |
| 5 | \$1select | Wählt bestimmte Eigenschaften aus, die zurückgegeben werden sollen | Array |
| 6 | \$1expand | Erweitert verwandte Entitäten | Array |
| 7 | \$1inlinecount | 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-Konsole **Integrationen** aus.
1. Wählen Sie Ihren SAP-Workload-Integrationstyp aus dem Integrationsraster aus.
1. Wählen Sie Ihre Integration aus der Liste aus und klicken Sie auf **Bearbeiten**.
1. Ä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.
1. 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.
1. 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.
1. Legen Sie Berechtigungsstufen für den gemeinsamen Zugriff fest.
1. 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.
1. Überprüfen Sie die Auswirkungen des Löschvorgangs, einschließlich aller Workflows oder Automatisierungen, die diese Integration verwenden.
1. Geben Sie den Namen der Integration ein, um das Löschen zu bestätigen.
1. 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 bei 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