Intégrations de charge de travail SAP - Amazon Quick Suite
Actions possiblesAvant de commencerPréparation de la configuration et de l'authentification du système SAPConfiguration des intégrations SAPOpérations disponibles par type de connecteurParamètres Query (Requête)Gérez les intégrations de charge de travail SAPRésoudre les problèmes liés aux intégrations de charge de travail SAP

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 Suite 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 matérielles 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 Suite Author ou version ultérieure.

  • Connectivité réseau entre Amazon Quick Suite 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 Suite, 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

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

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 Suite, choisissez Integrations.

  2. 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

  3. Cliquez sur Ajouter (plus le bouton « + »).

  4. Renseignez le nom et la description de votre intégration SAP.

  5. Choisissez le type de connexion pour votre intégration.

  6. 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

    2. 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

  7. Sélectionnez Créer et continuer.

  8. Choisissez les utilisateurs avec lesquels partager l'intégration.

  9. 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 d'Amazon Quick Suite. Vous pouvez effectuer des actions spécifiques à SAP directement depuis Amazon Quick Suite à 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
# Paramètre Description Type
1 $top Limite le nombre d'articles retournés entier
2 $skip Ignore le nombre d'éléments spécifié entier
3 $filter Filtre les résultats en fonction de critères spécifiques chaîne
4 $orderby Résultats des commandes par champs spécifiés array
5 $select Sélectionne les propriétés spécifiques à renvoyer array
6 $expand Développe les entités associées array
7 $inlinecount Inclut 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 Suite, choisissez Integrations.

  2. Choisissez le type d'intégration de votre charge de travail SAP dans la grille d'intégration.

  3. Sélectionnez votre intégration dans la liste et choisissez Modifier.

  4. 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.

  5. Choisissez Enregistrer les modifications pour appliquer vos modifications.

Partage 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.

  2. 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.

  3. Définissez les niveaux d'autorisation pour l'accès partagé.

  4. 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.

  2. Vérifiez l'impact de la suppression, y compris les flux de travail ou les automatisations utilisant cette intégration.

  3. Entrez le nom de l'intégration pour confirmer la suppression.

  4. 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