Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # Intégrations de charge de travail SAP Grâce aux intégrations de charge de travail SAP, vous pouvez effectuer des actions au sein de différents systèmes SAP. Gérez les données commerciales, les stocks, les matériaux et les processus commerciaux. Ces intégrations prennent uniquement en charge l'exécution d'actions et nécessitent le niveau Amazon Quick Pro ou supérieur. ## Actions possibles Les intégrations de charge de travail SAP fournissent une connectivité au niveau de l'entreprise pour vous aider à travailler avec vos systèmes SAP. **Connecteur Action** Effectuez des actions au sein des systèmes SAP. Créez, mettez à jour et gérez les données commerciales, les dossiers d'inventaire, les informations sur les matériaux et les autres opérations de l'entreprise via SAP APIs. **Plusieurs modules SAP** Support pour cinq types d'intégration différents : nomenclature, partenaire commercial, stock de matériel, documents d'inventaire physique et Product Master. ## Avant de commencer Avant de configurer les intégrations de charge de travail SAP, assurez-vous de disposer des éléments suivants : + Système SAP avec les modules appropriés installés et configurés. + Compte utilisateur SAP avec les autorisations et autorisations nécessaires. + Amazon Quick Author ou version ultérieure. + Connectivité réseau entre Amazon Quick et votre système SAP. ## Préparation de la configuration et de l'authentification du système SAP Avant de configurer l'intégration dans Amazon Quick, préparez la configuration de votre système SAP et l'authentification des utilisateurs. Les intégrations de charge de travail SAP prennent en charge plusieurs méthodes d'authentification et nécessitent une configuration système appropriée. ### Méthodes d’authentification Les intégrations de charge de travail SAP prennent en charge deux méthodes d'authentification : **OAuth 2.0 (recommandé)** Méthode d'authentification sécurisée pour les flux de travail automatisés. Nécessite une OAuth configuration dans votre système SAP. **Paramètres requis :** + **ID client - ID** OAuth client SAP + **Secret du client - Secret** OAuth du client SAP + **URL du jeton** : point de terminaison du OAuth jeton (par exemple,`https://hostname:port/sap/bc/sec/oauth2/token?sap-client=100`) + **URL du domaine :** point de terminaison de l'API du système SAP (par exemple,`https://hostname:port/sap/opu/odata/sap/API_BUSINESS_PARTNER`) **Authentification de base** Authentification par nom d'utilisateur et mot de passe pour un accès direct au système SAP. **Paramètres requis :** + **Nom d'utilisateur : nom** d'utilisateur du système SAP + **Mot de passe : mot** de passe du système SAP + **URL du domaine** - Point de terminaison de l'API du système SAP ### Configuration requise pour le système SAP Avant d'utiliser les intégrations de charge de travail SAP, assurez-vous que votre système SAP est correctement configuré : #### OAuth Configuration 2.0 Pour l'authentification OAuth 2.0 : + Configurer le serveur OAuth d'autorisation avec les étendues appropriées + OAuth La vérification est activée pour le service à l'aide du code de transaction `/IWFND/MAINT_SERVICE` + Reportez-vous à la documentation SAP pour une configuration OAuth 2.0 détaillée : [Guide de configuration OAuth 2.0](https://help.sap.com/docs/ABAP_PLATFORM_NEW/fd0fc52fd22b45f29d274a7f8236e768/cdb122d5b0784c77bf1bcce17f730e74.html) #### Activation de l'API SAP Assurez-vous que les services d'API SAP requis sont actifs : + Activez le service d'API spécifique pour le connecteur SAP que vous avez choisi + Vérifiez l'état du service API dans votre système SAP + Reportez-vous à la documentation SAP pour l'activation des API : [Guide d'activation du service d'API SAP](https://help.sap.com/doc/saphelp_nw75/7.5.5/en-US/1b/023c1cad774eeb8b85b25c86d94f87/frameset.htm) ### Types d'intégration de charge de travail SAP disponibles Choisissez le type d'intégration SAP qui correspond aux besoins de votre entreprise et assurez-vous que le module SAP correspondant est disponible dans votre système. **Nomenclature SAP** Gérez les données de nomenclature, y compris les listes de composants, les quantités et les spécifications de fabrication. **Champ d'application requis :** `ZAPI_BILL_OF_MATERIAL_SRV_0002` **Partenaire commercial SAP** Gérez les informations des partenaires commerciaux, y compris les données des clients et des fournisseurs, les coordonnées et la gestion des relations. **Champ d'application requis :** `ZAPI_BUSINESS_PARTNER_0001` **Stock de matériel SAP** Accédez aux niveaux de stocks de matériaux, aux mouvements d'inventaire et aux informations sur les entrepôts et gérez-les. **Champ d'application requis :** `ZAPI_MATERIAL_STOCK_SRV_0001` **Documents d'inventaire physique SAP** Créez et gérez les documents d'inventaire physique, les dénombrements de stocks et les processus de rapprochement des stocks. **Champ d'application requis :** `ZAPI_MATERIAL_STOCK_SRV_0001` **Maître de produit SAP** Gérez les données de base des produits, y compris les spécifications des matériaux, les classifications et les hiérarchies des produits. **Champ d'application requis :** `ZAPI_PRODUCT_SRV_0001` ### Configuration de l'authentification de charge de travail SAP Préparez les informations d'authentification des utilisateurs SAP et assurez-vous que les autorisations d'accès au système sont correctes. + **URL du système SAP** : obtenez l'URL de base ou l'adresse du serveur de votre système SAP. + **Informations d'identification de l'utilisateur** : créez ou identifiez un compte utilisateur SAP doté des autorisations appropriées. + **Autorisations système** : assurez-vous que le compte utilisateur possède les autorisations SAP et les codes de transaction nécessaires pour les modules SAP spécifiques que vous prévoyez d'intégrer. + **Accès au réseau** : vérifiez que votre système SAP est accessible depuis des connexions externes et que les règles de pare-feu autorisent l'intégration. ## Configuration des intégrations SAP Après avoir préparé la configuration de votre système SAP et vos informations d'authentification, le processus de configuration est similaire pour tous les types d'intégration SAP. Choisissez entre l'authentification OAuth 2.0 ou l'authentification de base en fonction de vos exigences de sécurité. 1. Dans la console Amazon Quick, choisissez **Integrations.** 1. Sélectionnez l'un des connecteurs SAP disponibles : + **Nomenclature SAP** + **Partenaire commercial SAP** + **Stock de matériel SAP** + **Documents d'inventaire physique SAP** + **Maître de produit SAP** 1. Cliquez sur **Ajouter** (plus le bouton « \$1 »). 1. Renseignez le nom et la description de votre intégration SAP. 1. Choisissez le type de connexion pour votre intégration. 1. Configurez l'authentification à l'aide de l'une des méthodes prises en charge : 1. **OAuth Configuration 2.0** Pour l'authentification OAuth 2.0, fournissez : + **ID client** : votre identifiant OAuth client SAP + **Secret du client - Le secret** de votre OAuth client SAP + **URL du jeton : URL** du point de terminaison du OAuth jet + **URL du domaine : URL** du point de terminaison de l'API du système SAP 1. **Configuration de base de l'authentification** Pour l'authentification de base, fournissez : + **Nom d'utilisateur : nom** d'utilisateur de votre système SAP + **Mot de passe** : le mot de passe de votre système SAP + **URL du domaine : URL** du point de terminaison de l'API du système SAP 1. Sélectionnez **Créer et continuer**. 1. Choisissez les utilisateurs avec lesquels partager l'intégration. 1. Cliquez sur **Suivant**. ### Résultats attendus Une fois la configuration réussie, votre intégration de charge de travail SAP apparaît dans la liste des intégrations et peut être utilisée dans les flux de travail, les automatisations et les agents d'intelligence artificielle Amazon Quick. Vous pouvez effectuer des actions spécifiques à SAP directement depuis Amazon Quick à l'aide des informations d'authentification configurées. ## Opérations disponibles par type de connecteur Chaque connecteur de charge de travail SAP fournit des opérations spécifiques adaptées à son domaine d'activité. Passez en revue les opérations disponibles pour le type de connecteur que vous avez choisi. ### Opérations liées à la nomenclature SAP Opérations disponibles pour gérer les données de nomenclature : + **Get Material BOM Item** - Récupère les détails de la nomenclature des matériaux spécifiés **ID de l'opération :** `getMaterialBOMItem` **Point final :** `GET /MaterialBOMItem` ### Opérations des partenaires commerciaux SAP Opérations disponibles pour gérer les données des partenaires commerciaux : + **Get Business Partner** - Récupère les données générales du partenaire commercial **ID de l'opération :** `getBusinessPartner` + **Obtenir les adresses des partenaires commerciaux** - Récupère les données des adresses des partenaires commerciaux **ID de l'opération :** `getBusinessPartnerAddress` + **Obtenir les rôles des partenaires commerciaux** - Récupère les données relatives aux rôles des partenaires commerciaux **ID de l'opération :** `getBusinessPartnerRole` + **Obtenir le partenaire commercial par identifiant** - Récupère les données du partenaire commercial par numéro de partenaire commercial **ID de l'opération :** `getBusinessPartnerByID` **Paramètre obligatoire :** `BusinessPartner` (chaîne, 10 caractères maximum) + **Obtenir le rôle du partenaire commercial par identifiant** - Récupère les données du rôle du partenaire commercial à l'aide de champs clés **ID de l'opération :** `getBusinessPartnerRoleByID` **Paramètres obligatoires :** `BusinessPartner` (chaîne, 10 caractères maximum), `BusinessPartnerRole` (chaîne, 6 caractères maximum) ### Opérations relatives aux stocks de matériaux SAP Opérations disponibles pour gérer les données relatives aux stocks de matériaux : + **Obtenir le stock de matériel dans le compte** - Récupère les informations sur le stock de matériel publiées dans le modèle de compte **ID de l'opération :** `getMaterialStockInAccount` ### Opérations relatives aux documents d'inventaire physique SAP Opérations disponibles pour gérer les documents d'inventaire physique : + **Get PhysInventory Doc Item** - Lit les informations sur les articles de l'inventaire physique **ID de l'opération :** `getPhysInventoryDocItem` ### Opérations SAP Product Master Opérations disponibles pour gérer les données de base des produits : + **Obtenir l'article principal du produit** - Renvoie les dossiers principaux du produit **ID de l'opération :** `getProductMaster` + **Obtenir les données de l'usine par matériau** - Renvoie les données de l'usine dans le dossier principal du produit **ID de l'opération :** `getPlantDataByMaterial` **Paramètre obligatoire :** `Product` (chaîne, 40 caractères maximum) + **Obtenir les données de planification des approvisionnements par matériau** - Renvoie les données de planification des approvisionnements par numéro de produit et par usine **ID de l'opération :** `getSupplyPlanningDataByMaterial` **Paramètres obligatoires :** `Product` (chaîne, 40 caractères maximum), `Plant` (chaîne, 4 caractères maximum) ## Paramètres Query (Requête) Les connecteurs SAP prennent en charge les paramètres de requête standard pour filtrer, trier et formater les réponses des API. Utilisez ces paramètres pour optimiser la récupération et le traitement des données. **Paramètres de requête pris en charge** | \$1 | Paramètre | Description | Type | | --- | --- | --- | --- | | 1 | \$1top | Limite le nombre d'articles retournés | entier | | 2 | \$1skip | Ignore le nombre d'éléments spécifié | entier | | 3 | \$1filter | Filtre les résultats en fonction de critères spécifiques | chaîne | | 4 | \$1orderby | Résultats des commandes par champs spécifiés | array | | 5 | \$1select | Sélectionne les propriétés spécifiques à renvoyer | array | | 6 | \$1expand | Développe les entités associées | array | | 7 | \$1inlinecount | Comprend le nombre d'éléments en réponse | chaîne | ## Gérez les intégrations de charge de travail SAP Après avoir créé votre intégration de charge de travail SAP, vous pouvez la gérer à l'aide de plusieurs options. ### Modifier les paramètres d'intégration Suivez ces étapes pour modifier les paramètres d'intégration de votre charge de travail SAP. 1. Dans la console Amazon Quick, choisissez **Integrations.** 1. Choisissez le type d'intégration de votre charge de travail SAP dans la grille d'intégration. 1. Sélectionnez votre intégration dans la liste et choisissez **Modifier**. 1. Modifiez les paramètres d'intégration : + Mettez à jour les informations d'authentification (nom d'utilisateur et mot de passe). + Modifiez l'URL du système SAP ou les paramètres de connexion. + Modifiez le nom ou la description de l'intégration. 1. Choisissez **Enregistrer les modifications** pour appliquer vos modifications. ### Partager l'intégration Vous pouvez partager les connecteurs d'action SAP Workload avec d'autres utilisateurs de votre organisation. 1. Sur la page des détails de l'intégration SAP, choisissez **Partager**. 1. Configurez les options de partage : + **Partager avec des utilisateurs spécifiques** : entrez des noms d'utilisateur ou des adresses e-mail. + **Partager avec l'organisation** : mettez cette option à la disposition de tous les utilisateurs de votre organisation. 1. Définissez les niveaux d'autorisation pour l'accès partagé. 1. Choisissez **Partager l'intégration** pour appliquer les paramètres de partage. ### Supprimer l'intégration Suivez ces étapes pour supprimer définitivement votre intégration SAP. 1. Sur la page des détails de l'intégration de la charge de travail SAP, choisissez **Supprimer**. 1. Vérifiez l'impact de la suppression, y compris les flux de travail ou les automatisations utilisant cette intégration. 1. Entrez le nom de l'intégration pour confirmer la suppression. 1. Choisissez **Supprimer l'intégration** pour la supprimer définitivement. ## Résoudre les problèmes liés aux intégrations de charge de travail SAP Utilisez ces conseils de dépannage pour résoudre les problèmes courants d'intégration des charges de travail SAP. ### Problèmes d’authentification OAuth Défaillances d'authentification 2.0 **Symptômes :** échec de la génération du jeton, informations d'identification client non valides ou erreurs de OAuth portée. **Résolution :** + Vérifiez que l'ID OAuth client et le secret du client sont corrects + Vérifiez qu'il OAuth est correctement configuré dans SAP à l'aide de la transaction `/IWFND/MAINT_SERVICE` + Assurez-vous que les étendues requises sont correctement configurées pour votre type de connecteur de charge de travail SAP + Vérifiez que le format de l'URL du jeton correspond à la configuration de votre système SAP Défaillances d'authentification de base **Symptômes :** échecs de connexion, informations d'identification non valides ou erreurs de refus d'accès. **Résolution :** + Vérifiez que le nom d'utilisateur et le mot de passe SAP sont corrects + Vérifiez que le compte utilisateur dispose des autorisations SAP nécessaires + Assurez-vous que le compte utilisateur n'est pas verrouillé ou n'a pas expiré + Vérifiez que l'URL du domaine est accessible et correctement formatée ### Problèmes de configuration du système SAP Le service API n'est pas activé **Symptômes :** erreurs d'indisponibilité du service, point de terminaison d'API introuvable ou réponses HTTP 404. **Résolution :** + Vérifiez que le service d'API SAP requis est activé dans votre système + Vérifiez l'état du service API à l'aide des codes de transaction SAP + Assurez-vous que le service d'API correspond au type de connecteur SAP que vous avez choisi + Contactez votre administrateur SAP pour activer les services d'API manquants Délai d’expiration de connexion **Symptômes :** délais d'expiration des demandes, erreurs de connectivité réseau ou temps de réponse lents. **Résolution :** + Vérifiez que l'URL de votre système SAP est correcte et accessible + Vérifiez que la connectivité réseau autorise les connexions au système SAP + Assurez-vous que les règles du pare-feu autorisent le trafic d'intégration + Vérifiez les performances et la disponibilité du système SAP ### Erreurs d'autorisation et d'autorisation Autorisations SAP insuffisantes **Symptômes :** erreurs de refus d'accès, messages d'autorisation manquants ou échecs d'opérations restreintes. **Résolution :** + Assurez-vous que l'utilisateur authentifié dispose des autorisations SAP requises pour le module spécifique + Vérifiez que l'utilisateur a accès aux codes de transaction nécessaires + Vérifiez que le compte utilisateur dispose des attributions de rôles appropriées + Contactez votre administrateur SAP pour accorder les autorisations manquantes Erreurs d'autorisation liées à l'étendue **Symptômes :** erreurs de OAuth portée, autorisations insuffisantes pour les opérations d'API ou messages d'accès restreint. **Résolution :** + Vérifiez que la OAuth configuration inclut l'étendue requise pour votre type de connecteur + Vérifiez que les autorisations d'étendue sont correctement accordées dans le système SAP + Assurez-vous que le OAuth client dispose des droits d'accès à l'API nécessaires ### Formatage des données et erreurs de paramètres Formats de paramètres non valides **Symptômes :** erreurs de validation des données, messages de longueur de champ non valides ou exceptions de format de paramètre. **Résolution :** + Vérifiez les paramètres d'action et assurez-vous qu'ils correspondent aux formats de données SAP attendus + Vérifiez que la longueur des champs correspond aux exigences du système SAP (par exemple, 10 caractères BusinessPartner maximum) + Vérifiez que les types de données sont corrects pour le module SAP spécifique + Assurez-vous que tous les champs obligatoires sont fournis pour l'opération Erreurs de paramètres de requête **Symptômes :** erreurs de syntaxe de requête, messages de paramètres non pris en charge ou erreurs de demande mal formées. **Résolution :** + Vérifiez que les paramètres utilisent une syntaxe correcte (par exemple`$filter`,`$top`,,`$skip`) + Vérifiez que les valeurs des paramètres sont correctement formatées + Assurez-vous que l'API SAP prend en charge les paramètres spécifiques utilisés + Reportez-vous à la documentation de l'API SAP pour connaître les options de requête prises en charge ### Problèmes de disponibilité du système SAP Indisponibilité du système SAP **Symptômes :** erreur de refus de connexion, absence de réponse du système ou messages d'indisponibilité du service. **Résolution :** + Vérifiez l'état et la disponibilité du système SAP auprès de votre administrateur SAP + Vérifiez si des fenêtres de maintenance planifiées affectent le système + Vérifiez les alertes du système SAP ou les problèmes connus + Réessayez l'opération après avoir confirmé la disponibilité du système