SAP ERP

Le connecteur SAP ERP vous permet d'effectuer des opérations d'insertion, de suppression, de mise à jour et de lecture de données SAP ERP.

Éditions compatibles

Le connecteur SAP ERP peut communiquer avec les systèmes SAP R/3 à l'aide des méthodes suivantes:

• Interfaces de programmation d'application métier (BAPI)
• Appels de fonction distante (RFC)
• Tables SAP
• Requêtes SAP
• Messages IDoc

Les connexions aux éléments suivants sont acceptées:

• SAP ECC
• SAP ERP
• SAP R/3
• SAP S/4 Hana sur site
• Version de SAP JCo.

  Ce connecteur nécessite deux fichiers JCo lors de la création de la connexion : sapjco3.jar et libsapjco3.so (pour Unix). Vous pouvez télécharger la version JCo 3.1.5 sur le site des connecteurs SAP.

Si le système SAP accepte une connexion RFC et que les RFC requises sont disponibles, la connexion au système SAP fonctionne. D'autres éditions compatibles avec les connexions RFC peuvent également être compatibles.

Le contenu SAP suivant est accessible à partir du connecteur SAP ERP:

Tables SAP : les tables SAP sont exposées en tant que vues automatiquement via la propriété de connexion TableMode. Spécifiez les tables SAP que vous souhaitez utiliser à l'aide de la propriété de connexion Views, qui remplace TableMode. SAP déconseille de modifier directement les tables. Il est recommandé d'utiliser des BAPI pour modifier les données tabulaires. La modification directe des tables SAP n'est pas possible.

BAPI et RFC : les BAPI et les RFC sont exposés directement en tant que procédures stockées. Par défaut, toutes les RFC commençant par le mot clé "BAPI" sont affichées en tant que procédure stockée disponible.

IDoc : les fichiers IDoc (Intermediate Document) sont des objets SAP qui transfèrent les données des transactions commerciales d'un système à un autre sous la forme d'un message électronique. Les IDocs transfèrent des données de SAP vers des systèmes autres que SAP via des systèmes d'échange de données électroniques (EDI).

Pour en savoir plus sur ces termes, consultez le glossaire SAP.

Avant de commencer

Avant d'utiliser le connecteur SAP ERP, effectuez les tâches suivantes :

• Dans votre projet Google Cloud :
  • Attribuez le rôle IAM roles/connectors.admin à l'utilisateur qui configure le connecteur.
  • Attribuez les rôles IAM suivants au compte de service que vous souhaitez utiliser pour le connecteur :
    • roles/secretmanager.viewer
    • roles/secretmanager.secretAccessor
    • roles/storage.objectViewer

    Un compte de service est un compte Google spécial destiné à représenter un utilisateur non humain qui doit s'authentifier et obtenir les autorisations permettant d'accéder aux données des API Google. Si vous ne possédez pas de compte de service, vous devez en créer un. Pour plus d'informations, consultez la section Créer un compte de service.

  • Activez les services suivants :
    • secretmanager.googleapis.com (API Secret Manager)
    • connectors.googleapis.com (API Connectors)

    Pour savoir comment activer des services, consultez la page Activer des services.

  Si ces services ou autorisations n'ont pas encore été activés pour votre projet, vous êtes invité à les activer lors de la configuration du connecteur.

Configurer le connecteur

Pour configurer le connecteur, vous devez créer une connexion à votre source de données (système backend). Une connexion est spécifique à une source de données. Cela signifie que si vous disposez de nombreuses sources de données, vous devez créer une connexion distincte pour chacune d'elles. Pour créer une connexion, procédez comme suit :

1. Dans la console Cloud, accédez à la page Integration Connectors > Connections (Connecteurs d'intégration > Connexions), puis sélectionnez ou créez un projet Google Cloud.

   Accéder à la page "Connexions"

2. Cliquez sur + Créer pour ouvrir la page Créer une connexion.
3. Dans la section Emplacement, choisissez l'emplacement de la connexion.
   1. Région : sélectionnez un emplacement dans la liste déroulante.

      Pour obtenir la liste de toutes les régions disponibles, consultez la page Emplacements.

   2. Cliquez sur Suivant.
4. Dans la section Détails de la connexion, procédez comme suit: <ph type="x-smartling-placeholder">
   </ph>
   1. Connecteur : sélectionnez SAP ERP dans la liste déroulante des connecteurs disponibles.
   2. Version du connecteur : sélectionnez la version du connecteur dans la liste déroulante des versions disponibles.
   3. Dans le champ Nom de connexion, saisissez un nom pour l'instance de connexion.

      Les noms de connexion doivent répondre aux critères suivants :

      • Les noms de connexion peuvent contenir des lettres, des chiffres ou des traits d'union.
      • Les lettres doivent être en minuscules.
      • Les noms de connexion doivent commencer par une lettre et se terminer par une lettre ou un chiffre.
      • Les noms de connexion ne peuvent pas dépasser 49 caractères.
      • Pour les connecteurs compatibles avec les abonnements à des événements, les noms de connexion ne peuvent pas commencer par "goog" .
   4. Saisissez éventuellement une description de la connexion.
   5. Vous pouvez également activer Cloud Logging. puis sélectionnez un niveau de journalisation. Par défaut, le niveau de journalisation est défini sur Error.
   6. Compte de service : sélectionnez un compte de service disposant des rôles requis.
   7. Pour utiliser la connexion pour souscrire des abonnements à des événements, sélectionnez Activer l'abonnement aux événements. Si vous sélectionnez cette option, les options suivantes s'affichent :
      • Activer l'abonnement à des événements avec une entité et des actions: sélectionnez cette option pour utiliser la connexion pour les opérations d'abonnement aux événements et de connecteur (entités et actions).
      • Activer uniquement l'abonnement à un événement: sélectionnez cette option pour utiliser la connexion. uniquement pour l'abonnement à un événement. Si vous sélectionnez cette option, cliquez sur Suivant, puis sur Configurer l'abonnement aux événements.
   8. Client : client qui s'authentifie auprès du système SAP.
   9. System Id (ID système) : l'ID système ou R3Name du système SAP est une chaîne de trois caractères maximum. Il est souvent utilisé dans l'équilibrage de charge des connexions.
   10. Numéro de système : numéro par lequel le système cible est défini. Utilisé lors de la définition de la propriété de connexion à l'hôte.
   11. ID du projet: ID du projet Google Cloud dans lequel se trouve le bucket GCS contenant le fichier JAR SAP JCo.
   12. Bucket: nom du bucket contenant les fichiers sapjco3.jar et libsapjco3.so
   13. ID de l'objet du fichier JAR Jaco : ID de l'objet du fichier JAR JCo.
   14. ID d'objet libsapjco3: ID de l'objet du fichier JAR libsapjco3
   15. Mode Tableau : sélectionnez la table SAP à afficher en tant que vue.
   16. ID de l'objet SNC_LIB : ID de l'objet de la bibliothèque SNC.
   17. Nom de l'environnement de sécurité personnel: nom du fichier PPE (Personal Security Environment) applicable pour le bucket. Un fichier PSE stocke la paire de clés publique et privée ainsi que les certificats X.509 dans une structure ASN.1.
   18. Groupe : nom du groupe pour la connexion. Cette valeur est généralement spécifiée lorsque votre système SAP utilise des équilibreurs de charge.
   19. Serveur de messagerie: nom du serveur de messagerie à utiliser lors de la connexion au système SAP qui utilise des équilibreurs de charge.
   20. Fonction de lecture de table : nom de la fonction à utiliser pour lire les tables. Pour plus plus d'informations, consultez la section Utiliser une fonction de lecture de table personnalisée.
   21. Schéma de connexion : sélectionnez un schéma de connexion à utiliser pour vous connecter à votre système SAP.
   22. System ID (ID système) : l'ID système ou le R3Name du système SAP. Vous pouvez saisir jusqu'à trois caractères.
   23. Code secret SNC : sélectionnez le secret Secret Manager du code secret de la bibliothèque SNC.
   24. Version du secret: sélectionnez la version du secret.
   25. SNC mode (Mode SNC) : sélectionnez cette option pour activer la fonctionnalité SNC pour l'authentification entre Integration Connectors et votre système SAP.
   26. Nom SNC: saisissez un nom pour la connexion SNC.
   27. SNC qop: sélectionnez un niveau de protection. Voici les niveaux acceptés:
       • 1 : appliquer uniquement l'authentification.
       • 2 : appliquer la protection de l'intégrité. Cela inclut également la protection de l'authentification.
       • 3 : appliquer la protection de la confidentialité. Cela inclut également la protection de l'intégrité et par authentification.
       • 8 : appliquez la protection par défaut.
       • 9 : applique la protection maximale.
   28. Nom SNC du partenaire: saisissez le nom SNC du serveur d'applications.
   29. Mode de requête : sélectionnez les tables SAP à afficher sous forme de vues.
   30. Vues à parcourir : saisissez une liste de vues à afficher, séparées par une virgule. Exemple :ViewA,ViewB,ViewC
   31. Niveau de verbosité: saisissez le niveau de verbosité pour la journalisation. Les attributs sont comprises entre 1 et 5. Plus la valeur est élevée, plus les détails seront disponibles dans les journaux.
   32. Vous pouvez également configurer les paramètres du nœud de connexion :
       • Nombre minimal de nœuds : saisissez le nombre minimal de nœuds de connexion.
       • Nombre maximal de nœuds : saisissez le nombre maximal de nœuds de connexion.

       Un nœud est une unité (ou instance répliquée) de connexion qui traite des transactions. Pour traiter plus de transactions pour une connexion, plus de nœuds sont nécessaires. À l'inverse, moins de nœuds sont nécessaires pour traiter moins de transactions. Pour comprendre comment les nœuds affectent la tarification de votre connecteur, consultez la section Tarifs des nœuds de connexion. Si vous ne saisissez aucune valeur, le nombre minimal de nœuds est défini par défaut sur 2 (pour une meilleure disponibilité) et le nombre maximal sur 50.

   Remarque : Vous ne pouvez personnaliser les valeurs du nœud de connexion que si vous êtes un client facturé à l'usage.
   33. Vous pouvez également cliquer sur + AJOUTER UN LIBELLÉ pour ajouter un libellé à la connexion sous la forme d'une paire clé/valeur.
   34. Cliquez sur Suivant.
5. Dans la section Destinations, saisissez les informations concernant l'hôte distant (système backend) auquel vous souhaitez vous connecter.
   1. Type de destination : sélectionnez un type de destination.
      • Sélectionnez Adresse hôte dans la liste pour spécifier le nom d'hôte ou l'adresse IP de la destination.
      • Si vous souhaitez établir une connexion privée à vos systèmes backend, sélectionnez Rattachement du point de terminaison dans la liste, puis sélectionnez le rattachement du point de terminaison requis dans la liste Rattachement du point de terminaison.
        Remarque:Lorsqu'une zone DNS est utilisée, vous devez spécifier l'adresse de l'hôte au format suivant: /H/dexyz06s99.altostrat.com/S/3300. Où dexyz06s99.altostrat.com est le nom DNS cible sous la zone gérée. Pour en savoir plus, consultez Créer des zones gérées.

        Pour savoir comment créer un rattachement de point de terminaison, consultez Rattachement de service PSC et Rattachement de point de terminaison. Après avoir créé le rattachement de point de terminaison, celui-ci sera visible dans la liste des Pièces jointes au point de terminaison.

      Si vous souhaitez établir une connexion publique à vos systèmes backend avec une sécurité supplémentaire, vous pouvez configurer des adresses IP sortantes statiques pour vos connexions, puis configurer vos règles de pare-feu pour n'autoriser que les adresses IP statiques spécifiques.

      Pour saisir d'autres destinations, cliquez sur + Ajouter une destination.

   2. Cliquez sur Suivant.
6. Dans la section Authentification, saisissez les informations d'authentification.
   1. Sélectionnez un type d'authentification, puis saisissez les informations appropriées.

      Les types d'authentification suivants sont compatibles avec la connexion SAP ERP :

      • Nom d'utilisateur et mot de passe

   Pour comprendre comment configurer ces types d'authentification, consultez la section Configurer l'authentification.

   2. Cliquez sur Suivant.
7. Si vous avez activé l'abonnement à l'événement, la section Détails de l'abonnement aux événements s'affiche sur la page de création de connexion. Pour comprendre comment configurer les détails de l'abonnement à un événement, consultez Configurer un abonnement à un événement.
8. Vérifiez vos informations de connexion et d'authentification.
9. Cliquez sur Créer.

Configurer l'authentification

Saisissez les détails en fonction de l'authentification que vous souhaitez utiliser.

• Nom d'utilisateur et mot de passe
  • Nom d'utilisateur : nom d'utilisateur du connecteur
  • Mot de passe: code secret Secret Manager contenant le mot de passe associé au le connecteur.

Configurer pour l'abonnement aux événements

Si vous avez activé l'abonnement à l'événement, saisissez les valeurs suivantes dans le champ Section Détails de l'abonnement aux événements:

1. Sélectionnez l'un des types d'authentification suivants pour l'écouteur d'événements.
   Remarque : Avant de configurer l'authentification, assurez-vous de disposer de l'écouteur d'événements point de terminaison, qui est disponible après la création de la connexion. Pour afficher le point de terminaison, accédez à la page Toutes les connexions, puis cliquez sur la connexion que vous souhaitez afficher. Le point de terminaison s'affiche dans la section Détails de la connexion.
   • Authentification Google Si vous activez cette option, suivez les étapes décrites dans la section S'authentifier à l'aide de jetons Web JSON pour configurer l'authentification pour le SDK ABAP. Assurez-vous également que le compte de service dispose du rôle roles/connectors.listener, dont le jeton d'accès est utilisé pour l'authentification.
   • Authentification par clé API Si vous sélectionnez cette option, vous devez avoir créé une clé API, puis l'avoir enregistrée en tant que secret Secret Manager. Pour en savoir plus, consultez la section Créer une clé API.
2. Saisissez le nom du champ de type d'événement. Ce champ identifie le type d'événement associé au demande d'événement entrante.

   {
   "event_type": "user.created",
   ...
   // other request fields
   ...
   }

3. Sélectionnez Activer la connectivité privée pour une connectivité sécurisée entre votre application backend et votre connexion. Si vous sélectionnez cette option, vous devez effectuer des étapes de configuration supplémentaires après avoir créé la connexion. Pour en savoir plus, consultez Connectivité privée pour l'abonnement à un événement.
4. Saisissez la configuration de lettres mortes. Si vous configurez une lettre morte, la connexion écrit les événements non traités dans le sujet Pub/Sub spécifié. Saisissez les informations suivantes:
   1. ID du projet de lettre morte : ID du projet Google Cloud dans lequel vous avez configuré le sujet de lettre morte Pub/Sub.
   2. Sujet de lettre morte : sujet Pub/Sub dans lequel vous souhaitez écrire les détails de l'événement non traité.

Conseil:Pour savoir comment utiliser les abonnements aux événements dans vos intégrations, consultez Déclencheur SAP ERP.

Exemples de configuration de connexion

Les sections suivantes répertorient des exemples de valeurs pour les différents lors de la création de la connexion SAP ERP, ainsi que les paramètres requis pour les différents types de connexions.

Se connecter à un système SAP distribué

Si vous vous connectez à un système SAP distribué, tel qu'un système utilisant l'équilibrage de charge, vous devez spécifier les propriétés de connexion supplémentaires suivantes. Un administrateur peut obtenir ces propriétés de connexion dans l'onglet "Connexion" de la boîte de dialogue "System Entry Properties" (Propriétés de l'entrée système) du système SAP.

• ID système: spécifiez la valeur obtenue à partir de la propriété SystemId. L'ID système correspond à l'ID système/R3Name du système SAP. L'ID système est une chaîne de trois caractères au maximum.
• Message Server : définissez cette propriété sur la valeur que vous avez obtenue à partir de la propriété MessageServer. Si une valeur est spécifiée dans la zone SAProuter, ajoutez la valeur dans la zone SAProuter à la valeur de la propriété de chaîne de connexion MessageServer. La propriété MessageServer doit être spécifiée lorsque vous vous connectez à un système SAP à l'aide de l'équilibrage de charge.
• Groupe : définissez cette propriété sur la valeur que vous avez obtenue à partir de la propriété "Groupe/Serveur". La propriété "Group" spécifie le groupe de connexion utilisé. La valeur par défaut est PUBLIC.

Se connecter à un serveur d'applications personnalisé

Si vous vous connectez à un système SAP avec un serveur d'applications dédié ou un serveur d'applications personnalisé, vous devez spécifier les propriétés de connexion supplémentaires suivantes. Un administrateur peut obtenir ces propriétés de connexion à partir du système SAP.

• ID système : spécifiez la valeur obtenue à partir de la propriété SystemId. Il s'agit de l'ID système ou R3Name du système SAP. L'ID système est une chaîne de trois caractères maximum.
• Hôte: indiquez la valeur obtenue auprès du serveur d'applications.

  Il spécifie le nom d'hôte du système cible. Cette valeur peut être un nom d'hôte, une adresse IP ou une adresse de routeur SAP.

• Numéro système : spécifiez la valeur que vous avez obtenue à partir de la propriété SystemNumber.

  La propriété SystemNumber définit le système cible.

Configurer des connexions réseau sécurisées

Si l'administrateur a configuré la communication réseau sécurisée (SNC, Secure Network Communication), vous devez définir les propriétés supplémentaires suivantes. Dans le système SAP, vous pouvez obtenir les propriétés de chaîne de connexion SNC suivantes dans l'onglet "Network" (Réseau) de la boîte de dialogue "System Entry Properties" (Propriétés de l'entrée système).

• Mode SNC: si l'option "Activer des connexions réseau sécurisées" est cochée dans SAP, définissez la propriété de connexion "SNC Mode" sur "True". Sinon, définissez la propriété de connexion en mode SNC sur "False".

  La propriété de connexion SNCMode est une valeur booléenne qui détermine si vous utilisez SNC. La valeur par défaut est "false".

• SNC PartnerName : SNC PartnerName spécifie le nom SNC du serveur d'application. Par exemple : p:CN=IDS, OU=IT, O=CSW, C=DE
• Nom SNC: facultatif. La propriété SNCName spécifie le nom de la connexion SNC. Définissez cette propriété pour vous assurer que le nom SNC correct est utilisé pour la connexion.
• SNC Qop: définissez cette propriété sur l'option sélectionnée dans la section "Paramètres du réseau sécurisé". Par exemple, si l'option "Intégrité" est sélectionnée, définissez la propriété SNCQop sur 3.

  La propriété SNCQop spécifie le niveau (ou la qualité) de protection des données. Si cette propriété n'est pas spécifiée, l'entier -1 est défini pour cette propriété. Les valeurs valides sont 1, 2, 3, 8 ou 9, qui correspondent aux niveaux de protection.

• ID de l'objet SNC_Lib : définissez cette propriété sur le chemin d'accès et le nom de fichier de votre bibliothèque SNC. Spécifiez le chemin d'accès complet à la bibliothèque de sécurité que vous utilisez, par exemple C:\Secude\secude.xll..

Type de connexion ApplicationServer

Pour la connectivité du serveur d'applications, Private Service Connect et l'équilibreur de charge doivent être configurés avec l'adresse IP du système SAP et le port 33XX dans le groupe de points de terminaison du réseau (NEG) et la vérification de l'état. Où XX correspond au numéro du système ou de l'instance du système SAP utilisé. Le tableau suivant présente des exemples de valeurs de configuration pour le type de connexion ApplicationServer. Reportez-vous à l'interface de création de connexion dans la console pour connaître les champs obligatoires et facultatifs.

Nom du champ	Exemple de valeur
Région	us-central1
Connecteur	SAP ERP
Version du connecteur	1
Nom du connecteur	saperp-applicationserver-conn
Description	N/A
Compte de service	[e-mail]
Client	800
Numéro du système	00
ID du projet	xxxx-gcp-project
Bucket	sap-erp-bucket
ID de l'objet Jco Jar	sapjco3.jar
ID de l'objet libsapjco3	libsapjco3.so
Mode Tableau	TransparentApplication/TransparentCustomer/TransparentSystem/Pooled/Cluster/None
Lire la fonction table	Z_CUSTOM_READ_TABLE
Système de connexion	ApplicationServer
ID du système	SA1
Mode de requête	N/A
Vues consultables	N/A
Niveau de verbosité	5
Nombre minimal de nœuds	2
Nombre maximal de nœuds	50
Adresse de l'hôte	10.30.X.XX ou la chaîne de routeur d'un système SAP externe.
Authentification	Mot de passe utilisateur
Nom d'utilisateur	12345
Mot de passe	xyz@12345
versions	1

Type de connexion GroupServer

Pour l'équilibrage de charge ou la connectivité du serveur de groupe, Private Service Connect et l'équilibreur de charge doivent être configurés avec l'adresse IP et le port 33XX du système SAP dans le groupe de points de terminaison du réseau (NEG) et la vérification de l'état. Où XX correspond au numéro du système ou de l'instance du système SAP utilisé. Le tableau suivant répertorie des exemples de valeurs de configuration pour le type de connexion GroupServer. Consultez la l'interface de création de connexion de la console pour connaître les champs obligatoires et facultatifs.

Nom du champ	Exemple de valeur
Région	us-central1
Connecteur	SAP ERP
Version du connecteur	1
Nom du connecteur	saperp-GroupServer-conn
Description	N/A
Compte de service	[e-mail]
Client	800
Numéro du système	00
ID du projet	xxxx-gcp-project
Bucket	sap-erp-bucket
ID de l'objet Jco Jar	sapjco3.jar
ID de l'objet libsapjco3	libsapjco3.so
Mode Tableau	TransparentApplication/TransparentCustomer/TransparentSystem/Pooled/Cluster/None
Groupe	PUBLIC
Serveur de messages	10.30.X.XX
Lire la fonction table	Z_CUSTOM_READ_TABLE
Système de connexion	GroupServer
ID système	SA1
Mode de requête	N/A
Vues consultables	N/A
Niveau de verbosité	5
Nombre minimal de nœuds	2
Nombre maximal de nœuds	50
Adresse de l'hôte	10.30.X.XX ou chaîne de routeur du système SAP externe.
Authentification	Mot de passe utilisateur
Nom d'utilisateur	12345
Mot de passe	xyz@12345
versions	1

Type de connexion du certificat X509

Pour les communications réseau sécurisées (SNC, Secure Network Communications) avec la connectivité X509, Private Service Connect et l'équilibreur de charge doivent être configurés avec l'adresse IP du système SAP et le port 48XX dans le groupe de points de terminaison du réseau (NEG) et la vérification de l'état. XX correspond au numéro de système ou d'instance du système SAP utilisé. Le tableau suivant présente des exemples de valeurs de configuration pour le type de connexion X509 certificate. Consultez la l'interface de création de connexion de la console pour connaître les champs obligatoires et facultatifs.

Nom du champ	Exemple de valeur
Région	us-central1
Connecteur	SAP ERP
Version du connecteur	1
Nom du connecteur	saperp-X509Certificate-conn
Description	N/A
Compte de service	[e-mail]
Client	800
Numéro du système	00
ID du projet	xxxx-gcp-project
Bucket	sap-erp-bucket
ID de l'objet Jco Jar	sapjco3.jar
ID de l'objet libsapjco3	libsapjco3.so
Mode Tableau	TransparentApplication/TransparentCustomer/TransparentSystem/Pooled/Cluster/None
ID de l'objet SNC_LIB	libsapcrypto.so
Nom PSE pour créer le fichier cred_v2	EHP8_GCP_SA1.pse
Lire la fonction table	Z_CUSTOM_READ_TABLE
Système de connexion	ApplicationServer
ID du système	SA1
Code secret SNC	xyz@gcp
Mode SNC	Valeur booléenne indiquant si vous utilisez SNC. Définissez cette valeur sur "true" pour utiliser SNC.
Nom du SNC	p:CN=EHP8_GCP_SA1, OU=IT, O=CSW, C=DE
SNC Qop	3
Nom du partenaire SNC	p:CN=SA1, OU=I0020070395, OU=SAP Web AS, O=SAP Trust Community, C=DE
Mode de requête	N/A
Vues consultables	N/A
Niveau de verbosité	5
Nombre minimal de nœuds	2
Nombre maximal de nœuds	50
Adresse de l'hôte	10.30.X.XX ou chaîne de routeur du système SAP externe.
Authentification	Authentification basée sur X509Certificate
X509Certificate	Le certificat X509 peut être spécifié à l'aide d'un chemin d'accès à un fichier contenant un certificat X509 au format PEM. Un blob PEM commençant par "-----BEGIN ..." ou un blob PEM sans le préfixe "-----BEGIN ..." en-tête.
versions	1

Limites du système

Le connecteur SAP ERP peut traiter sept transactions par seconde et par nœud, et limite les transactions au-delà de cette limite. Par défaut, les connecteurs d'intégration allouent deux nœuds (pour une meilleure disponibilité) à une connexion.

Pour en savoir plus sur les limites applicables à Integration Connectors, consultez la section Limites.

Remarque:Le nombre de nœuds Integration Connectors effectue l'autoscaling de manière dynamique. en fonction de votre utilisation. Toutefois, si vous souhaitez réserver de la capacité pour des volumes importants sans en attente de l'autoscaling, vous pouvez ajuster la valeur minimale du nombre de nœuds pour une connexion. Plus sont nécessaires pour traiter davantage de transactions pour une connexion. À l'inverse, moins de nœuds sont nécessaires si une connexion traite moins de transactions. Pour configurer le nœud, procédez comme suit : , procédez comme suit:

• Si vous êtes un client facturé à l'usage, configurez la valeur minimale et maximale des nœuds sur la page de modification de la connexion.
• Si vous êtes abonné, contactez l'assistance.

Le nombre maximal de transactions qu'un nœud peut gérer dépend de divers facteurs. Par conséquent, avant d'ajuster le nombre minimal de nœuds pour améliorer le débit, nous vous recommandons de vérifier si vos systèmes backend sont configurés de manière optimale pour gérer le trafic requis.

Utiliser la connexion SAP ERP dans une intégration

Une fois la connexion créée, elle devient disponible à la fois Apigee Integration et Application Integration. Vous pouvez utiliser la connexion lors d'une intégration via la tâche "Connecteurs".

• Pour savoir comment créer et utiliser la tâche "Connecteurs" dans Apigee Integration, consultez la section Tâche Connecteurs.
• Pour savoir comment créer et utiliser la tâche Connecteurs dans Application Integration, consultez la section Tâche Connecteurs.

Entités, opérations et actions

Tous les connecteurs Integration Connectors fournissent une couche d'abstraction pour les objets de l'application connectée. Vous ne pouvez accéder aux objets d'une application que via cette abstraction. L'abstraction vous est présentée en tant qu'entités, opérations et actions.

Remarque : Vous pouvez afficher les entités, les opérations et les actions d'un connecteur dans la tâche Connecteurs.

• Entité : une entité peut être considérée comme un objet ou un ensemble de propriétés dans l'application ou le service connecté. La définition d'une entité diffère d'un connecteur à l'autre. Par exemple, dans un connecteur de base de données, les tables sont les entités, dans un connecteur de serveur de fichiers, les dossiers sont les entités et, dans un connecteur de système de messagerie, les files d'attente sont les entités.

  Toutefois, il est possible qu'un connecteur ne soit pas compatible ou ne possède aucune entité. Dans ce cas, la liste Entities est vide.

• Opération : une opération est l'activité que vous pouvez effectuer sur une entité. Vous pouvez effectuer l'une des opérations suivantes sur une entité :
  • Liste
  • Obtenir
  • Créer
  • Mettre à jour
  • Supprimer

  La sélection d'une entité dans la liste disponible génère une liste d'opérations disponibles pour l'entité. Pour obtenir une description détaillée des opérations, consultez les opérations d'entité de la tâche de connecteur. Toutefois, si un connecteur n'accepte aucune des opérations d'entité, ne sont pas répertoriées dans la liste Operations.

• Action : une action est une fonction de première classe mise à la disposition de l'intégration via l'interface du connecteur. Une action vous permet de modifier une ou plusieurs entités, et varie d'un connecteur à l'autre. Normalement, une action comporte des paramètres d'entrée et une sortie . Toutefois, il est possible qu'un connecteur ne prenne en charge aucune action, auquel cas la liste Actions est vide.

Remarque : Toutes les entités et les actions seront associées à un schéma. Par exemple, un schéma d'action contient les détails des paramètres tels que les noms des paramètres et le type de données correspondant. Le schéma (métadonnées) des entités et des actions est récupéré par la connexion au moment de l'exécution à partir de votre backend. Si des mises à jour sont apportées au schéma, elles ne seront pas automatiquement répercutées dans vos connexions existantes. Vous devez actualiser manuellement le schéma. Pour actualiser le schéma d'une connexion, ouvrez la page Détails de la connexion de la connexion, puis cliquez sur Actualiser le schéma de connexion.

Actions

Cette section fournit des informations sur les RFC et liste les actions compatibles avec le connecteur. Pour comprendre comment configurer consultez la section Exemples d'actions.

Utiliser des RFC

Cette section fournit des informations sur les documents RFC requis et leur utilisation.

RFC requises

Si l'une des RFC requises n'est pas disponible, certaines ou toutes les fonctionnalités risquent de ne pas fonctionner. T-Code SE37 permet d'afficher les modules de fonction disponibles dans SAP.

Le connecteur SAP ERP utilise les documents RFC suivants.

• DDIF_FIELDINFO_GET
• RFC_GET_FUNCTION_INTERFACE
• RFC_GET_STRUCTURE_DEFINITION
• RFC_GET_SYSTEM_INFO
• RFC_GET_UNICODE_STRUCTURE
• RFC_READ_TABLE
• SLDAG_CHECK_FOR_UNICODE

Lire de grandes quantités de données

Cette section décrit l'approche à suivre pour lire de grandes données à partir de votre backend SAP.

Le connecteur SAP ERP utilise la fonction SAP RFC_READ_TABLE pour obtenir des données à partir de tables SAP. et cette fonction a une taille fixe de 512 octets. Il peut tamponner pour chaque ligne de données. Vous ne pouvez donc pas sélectionner plus de colonnes que la quantité qui tiendrait dans ce tampon. Si vous sélectionnez plus de 512 octets, l'exception DATA_BUFFER_EXCEEDED se produit lors de l'exécution de votre intégration. Cela signifie que vous avez dépassé la taille de tampon maximale autorisée par ligne et que vous devez sélectionner moins de colonnes.

Pour résoudre ce problème, vous pouvez inclure le code d'un Custom RFC_READ_TABLE, qui est semblable à SAP RFC_READ_TABLE, mais avec un tampon plus important pour résoudre le problème DATA_BUFFER_EXCEEDED.

Utiliser une fonction de lecture de table personnalisée

Le connecteur accepte un Custom RFC_READ_TABLE semblable à celui SAP RFC_READ_TABLE, mais avec un tampon plus important cela peut résoudre le problème DATA_BUFFER_EXCEEDED.

Créer une table RFC_READ_TABLE personnalisée dans votre backend SAP

Suivez la procédure ci-dessous pour utiliser l'exemple de RFC_READ_TABLE personnalisée.

1. Utilisez la fonction RFC_READ_TABLE comme modèle pour la nouvelle fonction : sélectionnez le code de transaction SE37 et le groupe de fonctions SDTX, puis copiez RFC_READ_TABLE dans un nouveau groupe de fonctions ou dans votre groupe de fonctions de travail. Dans cet exemple, RFC_READ_TABLE est copié dans Z_CUSTOM_RFC_TABLE.
2. Dans l'onglet Attributes (Attributs) de la page SAP, sélectionnez Remote Enabled Module (Module activé à distance).
3. Dans l'onglet Tables, définissez le paramètre DATA sur CHAR8000 (vous devrez peut-être effectuer un clic droit, puis cliquer sur Affichage -> Modifier).
4. Dans l'onglet Source Code (Code source), saisissez le code RFC de lecture de table personnalisé. Pour référence, consultez l'exemple Z_CUSTOM_RFC_TABLE_function.txt.
5. Cliquez sur Enregistrer.
6. Définissez les importations, les tables et les exceptions comme indiqué dans le tableau de lecture personnalisé fourni.
7. Activez le module de fonction.

Remarque:Une fois les étapes ci-dessus effectuées, définissez ReadTableFunction dans la chaîne de connexion. sur Z_CUSTOM_RFC_TABLE, ou le nom du module de fonction créé lors des étapes ci-dessus.

Tableau de lecture personnalisé pour ABAP 7.52

Si vous utilisez ABAP 7.52 ou une version ultérieure, consultez l'exemple Z_CUSTOM_RFC_TABLE_function_ABAP752.txt. L'exemple de fonction est conçu pour la version 7.52 d'ABAP et les versions ultérieures. Elle est semblable à la fonction Z_CUSTOM_RFC_TABLE, mais elle exploite les nouveaux mots clés disponibles dans ABAP 7.52 pour effectuer la pagination dans la base de données plutôt que dans le script ABAP lui-même. Cela rend la pagination beaucoup plus efficace, et améliore les performances lorsque vous travaillez avec de grandes tables. Nous vous recommandons d'utiliser Z_CUSTOM_RFC_TABLE_752 RFC si possible.

Accès à la fonction RFC_READ_TABLE

Cette section fournit des informations sur le rôle à attribuer à un utilisateur SAP pour accéder à la fonction RFC_READ_TABLE. Il s'agit d'un module de fonction compatible avec la télécommande qui permet un accès en lecture générique à des tables arbitraires.

Pour que les tables soient répertoriées sous "Entities" (Entités) lors de la configuration de la tâche des connecteurs SAP ERP, vous devez utiliser la fonction RFC_READ_TABLE dans le niveau de connexion SAP ERP et être autorisé à accéder à la fonction R/3 RFC_READ_TABLE

Ajout de l'autorisation S_TABU_DIS pour l'activité 03 (affichage) et l'authentification groupe "SC" pour la fonction RFC_READ_TABLE.

Voici quelques-unes des limites techniques de la table RFC_READ_TABLE:

• Seules les tables contenant des types de données simples peuvent être lues. Les champs STRING ou XSTRING ne sont pas compatibles.
• L'épaisseur de ligne maximale est de 512 caractères.
• Le nombre d'enregistrements renvoyés est limité par des seuils de mémoire.

Remarque : Les résultats de toutes les actions seront disponibles sous forme de réponse JSON dans le paramètre de réponse connectorOutputPayload de la tâche Connectors après avoir exécuté votre intégration.

Action BAPI_MATERIAL_SAVEDATA

Cette action vous permet d'effectuer des tâches spécifiques. Par exemple, vous pouvez l'utiliser pour créer ou modifier des données de base de données de matières dans SAP ERP.

Paramètres d'entrée de l'action BAPI_MATERIAL_SAVEDATA

Nom du paramètre	Type de données	Obligatoire	Description
HEADDATA	Chaîne	Oui	Paramètre d'entrée HEADDATA.
CLIENTDATA	Chaîne	Oui	Paramètre d'entrée CLIENTDATA.
CLIENTDATAX	Chaîne	Oui	Le paramètre d'entrée CLIENTDATAX.
MATERIALDESCRIPTION	Chaîne	Oui	Le tableau MATERIALDESCRIPTION.

Paramètres de sortie de l'action BAPI_MATERIAL_SAVEDATA

Cette action renvoie l'état 200 (OK) si elle aboutit.

Pour savoir comment configurer l'action BAPI_MATERIAL_SAVEDATA, consultez la section Exemples d'actions.

Action ZFM_GCP_MULTIDATA_TAB

Cette action permet aux utilisateurs d'effectuer des tâches spécifiques. Par exemple, vous pouvez créer des données multitypes de données dans SAP ERP.

Paramètres d'entrée de l'action ZFM_GCP_MULTIDATA_TAB

Nom du paramètre	Type de données	Obligatoire	Description
ReturnTables	Chaîne	Oui	Liste séparée par des virgules qui spécifie les tables du module de fonction à afficher. Si ce paramètre n'est pas spécifié, toutes les tables renvoyées sont affichées.
T_TABLE	Chaîne	Oui	La table T_TABLE.
IM_INPUT_1	Chaîne	Oui	Le paramètre d'entrée IM_INPUT_1.
IM_INPUT_2	Chaîne	Oui	Le paramètre d'entrée IM_INPUT_2.

Paramètres de sortie de l'action ZFM_GCP_MULTIDATA_TAB

Cette action renvoie l'état 200 (OK) si elle a abouti.

Par exemple, pour configurer l'action ZFM_GCP_MULTIDATA_TAB, consultez les exemples d'actions.

Action PushIDoc

Cette action vous permet d'effectuer des tâches spécifiques. Par exemple, vous pouvez transférer des données de SAP vers un système externe.

Paramètres d'entrée de l'action PushIDoc

Nom du paramètre	Type de données	Obligatoire	Description
FileType	Chaîne	Oui	Type de fichier.Les valeurs autorisées sont XML et IDoc.
Mode	Chaîne	Oui	Mode de transfert. Les valeurs autorisées sont "Sync" (Synchronisation) et "ASync" (Asynchrone).
Contenu	Chaîne	Oui	Contenu du fichier.

Paramètres de sortie de l'action PushIDoc

Cette action renvoie l'état 200 (OK) si elle aboutit.

Pour savoir comment configurer l'action PushIDoc, consultez la section Exemples d'actions.

Action ExecuteCustomQuery

Cette action vous permet d'exécuter une requête personnalisée.

Pour créer une requête enregistrée, procédez comme suit :

1. Suivez les instructions détaillées pour ajouter une tâche de connecteurs.
2. Lorsque vous configurez la tâche de connecteur, sélectionnez Actions dans le type d'action à effectuer.
3. Dans la liste Action, sélectionnez Exécuter une requête personnalisée, puis cliquez sur OK.

   

4. Développez la section Entrée de la tâche, puis procédez comme suit :
   1. Dans le champ Délai d'inactivité après, saisissez le nombre de secondes d'attente jusqu'à l'exécution de la requête.

      Valeur par défaut : 180 secondes.

   2. Dans le champ Nombre maximal de lignes, saisissez le nombre maximal de lignes à renvoyer à partir de la base de données.

      Valeur par défaut : 25

   3. Pour mettre à jour la requête personnalisée, cliquez sur Modifier le script personnalisé. La boîte de dialogue Éditeur de script s'affiche.

      

   4. Dans la boîte de dialogue Éditeur de script, saisissez la requête SQL, puis cliquez sur Enregistrer.

      Vous pouvez utiliser un point d'interrogation (?) dans une instruction SQL pour représenter un seul paramètre devant être spécifié dans la liste des paramètres de requête. Par exemple, la requête SQL suivante sélectionne toutes les lignes de la table Employees correspondant aux valeurs spécifiées pour la colonne LastName :

      SELECT * FROM Employees where LastName=?

      Remarque : Les instructions LMD (langage de manipulation de données) et LDD (langage de définition de données) sont acceptées.
   5. Si vous avez utilisé des points d'interrogation dans votre requête SQL, vous devez ajouter le paramètre en cliquant sur + Ajouter un nom de paramètre pour chaque point d'interrogation. Lors de l'exécution de l'intégration, ces paramètres remplacent les points d'interrogation (?) de la requête SQL de manière séquentielle. Par exemple, si vous avez ajouté trois points d'interrogation (?), vous devez ajouter trois paramètres dans l'ordre.

      

      Pour ajouter des paramètres de requête, procédez comme suit :

      1. Dans la liste Type, sélectionnez le type de données du paramètre.
      2. Dans le champ Valeur, saisissez la valeur du paramètre.
      3. Pour ajouter plusieurs paramètres, cliquez sur + Ajouter un paramètre de requête.

En cas d'exécution réussie, cette action renvoie l'état 200 (OK) avec un corps de réponse contenant les résultats de la requête.

Exemples d'actions

Exemple : Créer un enregistrement

Cet exemple crée un enregistrement de matière à l'aide de l'action BAPI_MATERIAL_SAVEDATA.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action BAPI_MATERIAL_SAVEDATA, puis cliquez sur OK.
3. Dans la section Task Input (Entrée de la tâche) de la tâche Connectors (Connecteurs), cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

   {
   "HEADDATA": "{\"MATERIAL\":\"000000000000009001\",\"IND_SECTOR\":\"M\",\"MATL_TYPE\":\"HALB\",\"BASIC_VIEW\":\"X\"}",
   "CLIENTDATA" : "{\"MATL_GROUP\":\"00107\",\"BASE_UOM\":\"KG\"}",
   "CLIENTDATAX" : "{\"MATL_GROUP\":\"X\",\"BASE_UOM\":\"X\"}",
   "MATERIALDESCRIPTION" : "{\"LANGU\":\"E\",\"MATL_DESC\":\"Classification Google\"}"
   }

Si l'action aboutit, la Réponse connectorOutputPayload de la tâche BAPI_MATERIAL_SAVEDATA aura une valeur semblable à celle-ci:

[{
"RETURN_TYPE": "S",
"RETURN_ID": "MM",
"RETURN_NUMBER": 356,
"RETURN_MESSAGE": "The material 9001 has been created or extended",
"RETURN_LOG_NO": "",
"RETURN_LOG_MSG_NO": 0,
"RETURN_MESSAGE_V1": "9001",
"RETURN_FIELD": "",
"RETURN_SYSTEM": "T90CLNT090",
"RESULT_TABLE": null
}]

Exemple – Mettre à jour un enregistrement

Cet exemple met à jour un enregistrement de matière à l'aide de l'action BAPI_MATERIAL_SAVEDATA.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action BAPI_MATERIAL_SAVEDATA, puis cliquez sur OK.
3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

   {
   "HEADDATA": "{\"MATERIAL\":\"000000000000009000\",\"IND_SECTOR\":\"A\",\"MATL_TYPE\":\"FHMI\",\"BASIC_VIEW\":\"X\"}",
   "CLIENTDATA": "{\"MATL_GROUP\":\"013\",\"BASE_UOM\":\"ST\"}",
   "CLIENTDATAX": "{\"MATL_GROUP\":\"X\",\"BASE_UOM\":\"X\"}",
   "MATERIALDESCRIPTION": "{\"LANGU\":\"E\",\"MATL_DESC\":\"Classification Googlecloud\"}"
   }

Si l'action aboutit, la Réponse connectorOutputPayload de la tâche BAPI_MATERIAL_SAVEDATA aura une valeur semblable à celle-ci:

[{
"RETURN_TYPE": "S",
"RETURN_ID": "MM",
"RETURN_NUMBER": 356,
"RETURN_MESSAGE": "The material 9000 has been created or extended",
"RETURN_LOG_NO": "",
"RETURN_LOG_MSG_NO": 0,
"RETURN_MESSAGE_V1": "9000",
"RETURN_PARAMETER": "",
"RETURN_ROW": 0,
"RETURN_FIELD": "",
"RETURN_SYSTEM": "T90CLNT090",
"RESULT_TABLE": null
}]

Exemple : Supprimer un enregistrement

Cet exemple supprime un enregistrement de matière à l'aide de l'action BAPI_MATERIAL_SAVEDATA.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action BAPI_MATERIAL_SAVEDATA, puis cliquez sur OK.
3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

   {
   "HEADDATA": "{\"MATERIAL\":\"000000000000009000\",\"BASIC_VIEW\":\"X\"}",
   "CLIENTDATA": "{\"DEL_FLAG\":\"X\"}",
   "CLIENTDATAX": "{\"DEL_FLAG\":\"X\"}"
   }

Si l'action aboutit, la Réponse connectorOutputPayload de la tâche BAPI_MATERIAL_SAVEDATA aura une valeur semblable à celle-ci:

[{
"RETURN_TYPE": "S",
"RETURN_ID": "MM",
"RETURN_NUMBER": 356,
"RETURN_LOG_NO": "",
"RETURN_LOG_MSG_NO": 0,
"RETURN_MESSAGE_V1": "9000",
"RETURN_PARAMETER": "",
"RETURN_ROW": 0,
"RETURN_FIELD": "",
"RETURN_SYSTEM": "T90CLNT090",
"RESULT_TABLE": null
}]

Exemple : Créer des données multitypes

Cet exemple crée des données de type multidonnées à l'aide de l'action ZFM_GCP_MULTIDATA_TAB.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action ZFM_GCP_MULTIDATA_TAB, puis cliquez sur OK.
3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

   {
   "T_TABLE": "{\"ZACCP\":\"111\",\"ZCHAR\":\"CHARACTER1\",\"ZCLNT\":\"100\",\"ZCUKY\":\"INR\",\"ZCURR\": 200,\"ZDATS\": \"20231213\",\"ZINT1\": 45,\"ZINT2\":54,\"ZDEC\": 0.12,\"ZFLTP\": 1234,\"ZLANG\":\"E\",\"ZNUMC\":\"110\",\"ZPREC\": 3,\"ZQUAN\": 188.0,\"ZRAW\":\"01010008010101050401\",\"ZTIMS\": \"103056\",\"ZUNIT\":\"11\",\"ZINT4P\": 45,\"ZINT4\": 54,\"ZLRAW\":\"0101000801010105040100030101010300040000\"}",
   "IM_INPUT_1": "{\"ZACCP\":\"222\",\"ZCHAR\":\"CHARACTER1\",\"ZCLNT\":\"100\",\"ZCUKY\":\"INR\",\"ZCURR\": 200,\"ZDATS\": \"20231213\",\"ZINT1\": 45,\"ZINT2\":54,\"ZDEC\": 0.12,\"ZFLTP\": 1234,\"ZLANG\":\"E\",\"ZNUMC\":\"110\",\"ZPREC\": 3,\"ZQUAN\": 188.0,\"ZRAW\":\"01010008010101050401\",\"ZTIMS\": \"103056\",\"ZUNIT\":\"11\",\"ZINT4P\": 45,\"ZINT4\": 54,\"ZLRAW\":\"0101000801010105040100030101010300040000\"}",
   "IM_INPUT_2": "{\"ZSTRING\": \"HI Google\",\"ZSSTRING\": \"HI Google How are you\"}"
   }

Si l'action réussit, le paramètre de réponse connectorOutputPayload de la tâche ZFM_GCP_MULTIDATA_TAB aura une valeur semblable à celle-ci :

[{
"EX_OUTPUT_1_ZACCP": 222,
"EX_OUTPUT_1_ZCHAR": "CHARACTER1",
"EX_OUTPUT_1_ZCLNT": "100",
"EX_OUTPUT_1_ZCUKY": "INR",
"EX_OUTPUT_1_ZCURR": 200,
"EX_OUTPUT_1_ZDATS": "2023-12-13",
"EX_OUTPUT_1_ZRAW": "01010008010101050401",
"EX_OUTPUT_1_ZTIMS": "10:30:56",
"EX_OUTPUT_1_ZUNIT": "11",
"EX_OUTPUT_1_ZINT4P": 45,
"EX_OUTPUT_1_ZINT4": 54,
"EX_OUTPUT_1_ZLRAW": "0101000801010105040100030101010300040000\u0000",
"EX_OUTPUT_2_ZSTRING": null,
"EX_OUTPUT_2_ZSSTRING": null,
"RESULT_TABLE": null,
"T_TABLE_ZACCP": null,
"T_TABLE_ZCHAR": null,
"T_TABLE_ZCLNT": null,
"T_TABLE_ZQUAN": null,
"T_TABLE_ZRAW": null,
"T_TABLE_ZTIMS": null,
"T_TABLE_ZUNIT": null
},{
"EX_OUTPUT_1_ZACCP": null,
"EX_OUTPUT_1_ZCHAR": null,
"EX_OUTPUT_1_ZCLNT": null,
"EX_OUTPUT_1_ZCUKY": null,
"EX_OUTPUT_1_ZRAW": null,
"T_TABLE_ZLANG": null,
"T_TABLE_ZNUMC": null,
"T_TABLE_ZPREC": null,
"T_TABLE_ZQUAN": null,
"T_TABLE_ZRAW": null,
"T_TABLE_ZTIMS": null,
"T_TABLE_ZUNIT": null
},{
"EX_OUTPUT_1_ZACCP": null,
"EX_OUTPUT_1_ZCHAR": null,
"EX_OUTPUT_1_ZCLNT": null,
"EX_OUTPUT_1_ZCUKY": null,
"EX_OUTPUT_1_ZCURR": null,
"EX_OUTPUT_1_ZDATS": null,
"EX_OUTPUT_1_ZDEC": null,
"EX_OUTPUT_1_ZQUAN": null,
"T_TABLE_ZNUMC": 110,
"T_TABLE_ZPREC": 3,
"T_TABLE_ZQUAN": 188,
"T_TABLE_ZRAW": "01010008010101050401",
"T_TABLE_ZTIMS": "10:30:56",
"T_TABLE_ZUNIT": "11"
}]

Exemple – Transférer un IDoc

Cet exemple envoie un IDoc vers l'ERP SAP.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action PushIDoc, puis cliquez sur OK.
3. Dans la section Task Input (Entrée de la tâche) de la tâche Connectors (Connecteurs), cliquez sur connectorInputPayload, puis saisissez une valeur semblable à celle-ci dans la section Champ Default Value:

   {
   "Content": "\n\n\n EDI_DC40\n 800\n 0000000008604824\n 740\n 53\n 2\n \n MATMAS05\n MATMAS\n ZLS_QA23\n LS\n ZLS_QA23\n SAPSA1\n LS\n SA1CLNT800\n 20230218\n 232556\n\n\n 005\n 000000000000000012\n 20170328\n 42039\n 20170727\n 42039\n KLVC\n FERT\n M\n 02\n BG\n 000\n 002\n 0.000\n 0.000\n KGM\n 0.000\n 0001\n 0.000\n 0.000\n 0.000\n 0.000\n 0.000\n",
   "FileType": "XML",
   "Mode": "ASync"
   }

. Si l'action réussit, le paramètre de réponse connectorOutputPayload de la tâche PushIDoc aura une valeur semblable à celle-ci :

[{
"Result": "Success",
"Message": "Push IDoc success"
}]

Exemples d'opérations sur les entités

Cette section explique comment effectuer certaines opérations d'entité dans ce connecteur.

Exemple : Répertorier tous les enregistrements

Cet exemple liste tous les enregistrements de l'entité T001.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez T001 dans la liste Entity.
3. Sélectionnez l'opération List, puis cliquez sur OK.
4. Dans la section Task Input (Entrée dans la tâche) de la tâche Connectors (Connecteurs), vous pouvez éventuellement filtrer votre ensemble de résultats en spécifiant une clause de filtre. Spécifiez toujours la valeur de la clause de filtre entre guillemets simples (').

Exemple : Obtenir un enregistrement à partir d'une entité

Cet exemple récupère un enregistrement avec l'ID spécifié à partir de l'entité T001.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez T001 dans la liste Entity.
3. Sélectionnez l'opération Get, puis cliquez sur OK.
4. Dans la section Task Input (Entrée de la tâche) de la tâche Connectors (Connecteurs), cliquez sur EntityId, puis saisissez 0001 dans le champ Default Value (Valeur par défaut).

   Ici, 0001 est un ID d'enregistrement unique dans l'entité T001.

Utiliser Terraform pour créer des connexions

Vous pouvez utiliser l'outil Terraform ressource pour créer une connexion.

Pour savoir comment appliquer ou supprimer une configuration Terraform, consultez la page Commandes Terraform de base.

Pour afficher un exemple de modèle Terraform pour la création de connexions, consultez cet exemple de modèle.

Lorsque vous créez cette connexion à l'aide de Terraform, vous devez définir les variables suivantes dans votre fichier de configuration Terraform :

Nom du paramètre	Type de données	Requis	Description
Client	STRING	Vrai	Le client s'authentifie auprès du système SAP.
groupe	STRING	Faux	Groupe d’ouverture de session utilisé. En règle générale, il ne doit être spécifié que lors de la connexion à un système SAP utilisant l'équilibrage de charge.
message_server	STRING	Faux	Le serveur de messagerie doit être spécifié lors de la connexion à un système SAP qui utilise l'équilibrage de charge.
read_table_function	STRING	Faux	Fonction à utiliser pour lire les données d'une table.
connection_scheme	ENUM	Faux	Indique si vous vous connectez à un système SAP avec un serveur de messages (GroupServer) ou sans (ApplicationServer). Les valeurs acceptées sont : ApplicationServer, GroupServer
system_id	STRING	Faux	L'ID système ou R3Name du système SAP est une chaîne de trois caractères maximum. Il est souvent utilisé dans l'équilibrage de charge des connexions.
system_number	STRING	Vrai	Numéro par lequel le système cible est défini. Utilisé lors de la définition de la propriété de connexion de l'hôte.
project_id	STRING	Vrai	ID du projet Google Cloud dans lequel se trouve le bucket Cloud Storage contenant le fichier JCo de SAP JCo.
bucket	STRING	Vrai	Nom du bucket contenant les fichiers sapjco3.jar et libsapjco3.so
sapjco3_jar	STRING	Vrai	ID de l'objet pour sapjco3.jar
libsapjco3_so	STRING	Vrai	ID de l'objet pour libsapjco3.so
snc_lib	STRING	Faux	L'ID d'objet de la bibliothèque SNC
snc_mode	VALEUR BOOLÉENNE	Faux	Valeur booléenne déterminant si vous utilisez SNC. Définissez ce paramètre sur "true" pour utiliser SNC.
snc_name	STRING	Faux	Saisissez le nom de votre connexion SNC (facultatif).
snc_qop	ENUM	Faux	Qualité de la protection de votre connexion SNC.Les valeurs acceptées sont 1, 2, 3, 8 ou 9, ce qui correspond aux niveaux de protection suivants: 1 Appliquer uniquement l'authentification. 2 Appliquer la protection de l'intégrité (authentification). 3 Appliquez une protection de la confidentialité (intégrité et authentification). 8 Appliquez la protection par défaut. 9 Appliquez la protection maximale. Les valeurs acceptées sont les suivantes : 1, 2, 3, 8 et 9.
snc_partner_name	STRING	Faux	Nom SNC du serveur d'application. Ce champ est obligatoire pour utiliser SNC.
query_mode	ENUM	Faux	Détermine les tables SAP qui seront affichées en tant que vues, le cas échéant. Valeurs acceptées : "Global", "Local", "All" (Tout) et "None" (Aucun)
table_mode	ENUM	Faux	Détermine quelles tables SAP seront affichées sous forme de vues, le cas échéant. Les valeurs acceptées sont: TransparentApplication, TransparentCustomer, TransparentSystem, Pooled, Cluster, All, None
verbosité	STRING	Faux	Niveau de verbosité de la connexion (varie de 1 à 5). Un niveau de verbosité plus élevé consigne tous les détails de la communication (certificats de requête,de réponse et SSL).

Résoudre les problèmes de configuration SAP sur site

Si votre système SAP est sur site, vous devez créer un équilibreur de charge proxy avec NEG hybride.

1. Créez un tunnel IpSec entre le système sur site et Google Cloud avec les sous-réseaux autorisés.
2. Autoriser le sous-réseau d'équilibrage de charge et le sous-réseau proxy dans les pare-feu sur site.
3. Ajoutez tous les ports requis, tels que 33XX pour la connexion au serveur d'applications, 36XX pour la connexion au serveur de messages/au serveur de charge balancée et 48XX pour la connexion SNC-X509. XX correspond au numéro de système ou d'instance du système SAP. Ajoutez l'adresse IP requise pour le pare-feu dans la liste d'autorisation d'entrée du projet Google Cloud, par exemple l'adresse IP et le port du LB, ainsi que l'adresse IP et le port du système SAP.
4. Configurez un équilibreur de charge réseau proxy interne régional à l'aide de NEG hybride. Pour en savoir plus, consultez Équilibreur de charge réseau proxy interne régional avec connectivité NEG hybride.

Si vous rencontrez une erreur semblable à la suivante après avoir configuré la connectivité réseau,utilisez la solution ci-dessous pour ajouter l'adresse IP du rattachement de point de terminaison à la liste d'autorisation.

Initialization of destination SAP--1910584855 failed: Connect from SAP gateway to RFC server failed
connection parameters: TYPE=A DESTINATION=SAP--1910584855 ASHOST=10.128.0.43 SYSNR=00 PCS=1 
LOCATION    SAP-Gateway on host DELVM05S15.bcone.com / sapgw00
ERROR       timeout during allocate
TIME        Wed Apr  3 17:24:40 2024
RELEASE     754
COMPONENT   SAP-Gateway
VERSION     2
RC          242
MODULE      D:/depot/bas/754_REL/src/krn/si/gw/gwr3cpic.c
LINE        2208
DETAIL      no connect of TP sapdp00 from host 10.128.0.43 after 20 sec

COUNTER     2

Solution de contournement : ajoutez l'adresse IP de l'attachement du point de terminaison réseau du connecteur que vous avez créé dans Google Cloud dans gw/alternative_hostnames au niveau du profil SAP.

Glossaire SAP

SAP:le terme SAP est un terme générique qui désigne toutes les éditions SAP compatibles. Il s'agit généralement de la version 6 ou ultérieure de SAP ECC. Pour que le connecteur SAP ERP fonctionne, vous devez vous connecter à une édition de SAP compatible avec le SDK RFC.

Module de fonction : type de programme ou de fonction dans SAP qui peut être utilisé pour exécuter presque n'importe quelle opération. Ces modules peuvent être testés et écrits dans SAP via le TCode SE37.

RFC : un appel de fonction à distance (RFC, Remote Function Call) est un appel à un RFM/FM donné qui peut être exécuté par des applications externes. Cela inclut l'utilisation de bibliothèques distribuées par SAP qui sont installées sur le serveur SAP et peuvent également être téléchargées sur sap.com. Les RFM spécifiques peuvent être conservées ou non lors des mises à niveau de SAP. Il existe des RFM standards fournis par SAP. Ils peuvent donc présenter des différences ou ne pas exister avec les anciennes éditions. Les RFM personnalisés peuvent être (et sont souvent) créés pour prendre en charge les intégrations et doivent être gérés par le client SAP. Par convention, les RFM personnalisées commencent par la lettre Z.

BAPI:une API Business (BAPI) est une méthode API d'un objet métier. Un stagiaire est un module de fonction SAP compatible avec RFC qui permet d'accéder aux opérations de localisation des entreprises. Par exemple, il existe environ 60 BAPI liés uniquement à l'objet "Customer". En pratique, seuls quelques-uns sont généralement utilisés.

Table SAP : table qui stocke des données dans SAP. Ils sont différents des objets commerciaux. Par exemple, il n'existe pas de table "Bon de commande" dans SAP. À la place, de nombreuses tables incluent des données de bons de commande, telles que EBAN, EBKN, EINA, EKPO, etc. Par convention, les tables personnalisées commencent par la lettre Z.

Requêtes SAP:une requête SAP est un objet enregistré dans SAP qui détaille les informations à récupérer dans une ou plusieurs tables. Ils sont généralement utilisés pour créer des rapports.

Obtenir de l'aide auprès de la communauté Google Cloud

Vous pouvez publier vos questions et discuter de ce connecteur sur les forums Cloud de la communauté Google Cloud.

Étape suivante

• Découvrez comment suspendre et réactiver une connexion.
• Découvrez comment surveiller l'utilisation des connecteurs.
• Découvrez comment afficher les journaux du connecteur.