SAP ERP

Configurer l'abonnement aux événements

Si vous activez l'abonnement aux événements, vous devez configurer le SDK ABAP. Pour en savoir plus sur la configuration du SDK ABAP, consultez Présentation du SDK ABAP pour Google Cloud.

Saisissez les valeurs suivantes dans la 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.
   • Authentification Google. Si vous activez cette option, suivez la procédure décrite dans S'authentifier à l'aide de jetons Web JSON afin de 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 Créer une clé API.
2. Saisissez le nom du champ du type d'événement. Ce champ identifie le type d'événement associé à la requête d'événement entrante.

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

3. Sélectionnez Activer la connectivité privée pour la 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 aux événements.
4. Saisissez la configuration de lettres mortes. Si vous configurez les lettres mortes, 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 lettres mortes : ID du projet Google Cloud dans lequel vous avez configuré la file d'attente Pub/Sub de lettres mortes.
   2. File d'attente de lettres mortes : sujet Pub/Sub dans lequel vous souhaitez écrire les détails des événements non traités.

Exemples de configuration de connexion

Les sections suivantes présentent des exemples de valeurs pour les différents champs que vous configurez lorsque vous créez la connexion SAP ERP, ainsi que les paramètres requis pour les différents types de connexion.

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 ci-dessous. Un administrateur peut accéder à ces propriétés de connexion dans l'onglet "Connection" (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 que vous avez obtenue à partir de la propriété SystemId. Il peut s'agir de l'ID système/du R3Name du système SAP. L'ID système est une chaîne de trois caractères maximum.
• Serveur de messagerie : lorsque vous vous connectez à un système SAP qui utilise l'équilibrage de charge, vous devez spécifier le champ "Serveur de messagerie". Définissez cette propriété sur la valeur que vous avez obtenue à partir de la propriété MessageServer dans le système SAP. Ajoutez également en préfixe la valeur de la zone "SAProuter" à la valeur du champ "Serveur de messagerie".
• Groupe : définissez cette propriété sur la valeur que vous avez obtenue à partir de la propriété Group/Server. 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 ci-dessous. Un administrateur peut accéder à ces propriétés de connexion à partir du système SAP.

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

  Il s'agit du nom d'hôte du système cible. Cette valeur peut être un nom d'hôte standard, une adresse IP ou une adresse de routeur SAP.

• Numéro de 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é des communications réseau sécurisées (SNC), vous devez définir les propriétés supplémentaires suivantes. Dans le système SAP, vous pouvez accéder aux propriétés de chaîne de connexion SNC ci-dessous dans l'onglet "Network" (Réseau) de la boîte de dialogue "System Entry Properties" (Propriétés de l'entrée système).

• SNCMode : si la case à cocher "Activate Secure Network Connections" (Activer les connexions réseau sécurisées) est activée dans SAP, définissez la propriété de connexion SNCMode sur "true". Sinon, définissez la propriété de connexion SNCMode 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 : le nom SNC du partenaire spécifie le nom SNC du serveur d'applications. Par exemple : p:CN=IDS, OU=IT, O=CSW, C=DE
• SNCName : 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 approprié est utilisé pour la connexion.
• SNCQop : définissez cette propriété sur l'option sélectionnée dans la section "Secure Network Settings" (Paramètres du réseau sécurisé). Par exemple, si l'option "Integrity" (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, elle sera définie sur l'entier -1. 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 de système ou d'instance du système SAP utilisé. Le tableau suivant fournit des exemples de valeurs de configuration pour le type de connexion ApplicationServer. Consultez l'interface de création de connexion dans la console pour connaître les champs obligatoires et facultatifs.

Type de connexion avec un serveur de messagerie (serveur de groupe)

• Private Service Connect et l'équilibreur de charge doivent être configurés avec l'adresse IP du système SAP sur les ports 33XX et 36XX dans le groupe de points de terminaison du réseau (NEG) et la vérification d'état. Où XX correspond au numéro de système ou d'instance du système SAP utilisé.
• Vous devez créer une zone DNS sur Cloud DNS et mapper le rattachement de point de terminaison du serveur d'applications, qui est configuré sur le port 33XX avec le nom d'hôte du système SAP.
• Vous ne pouvez vous connecter à un système SAP avec un serveur de messagerie (serveur de groupe) que si le serveur de messagerie renvoie l'adresse du nom de domaine complet (FQDN) du serveur d'applications. Vous ne pouvez pas vous connecter à un système SAP avec un serveur de messagerie (serveur de groupe) si le serveur de messagerie renvoie l'adresse IP.
• Le serveur de messagerie doit répondre avec le DNS des serveurs d'applications auxquels l'application doit se connecter lorsqu'elle le demande.
• Le DNS des serveurs d'applications doit être unique et ne doit pas être utilisé par un autre système SAP.
• Dans l'application SAP, les adresses IP de rattachement de point de terminaison pour les serveurs d'applications et les serveurs de messages doivent être conservées sous les paramètres gw/alternative_hostnames.
  1. Accédez au code de transaction RZ10 et saisissez le paramètre "gw/alternative_hostname" dans le profil d'instance.
  2. Définissez le paramètre ms/lg\_with\_hostname sur 1 pour configurer les versions antérieures à 7.53 du serveur de messagerie SAP afin de renvoyer des noms d'hôte. Les versions 7.53 et ultérieures renvoient les noms d'hôte par défaut.
  3. Redémarrez l'application SAP pour que les paramètres prennent effet.

Le tableau suivant fournit des exemples de valeurs de configuration pour le type de connexion Group Server :

Type de connexion avec certificat X509

Pour les communications réseau sécurisées (SNC) avec 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 d'état. Où XX correspond au numéro de système ou d'instance du système SAP utilisé. Le tableau suivant fournit des exemples de valeurs de configuration pour le type de connexion X509 certificate. Consultez l'interface de création de connexion dans la console pour connaître les champs obligatoires et facultatifs.

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 par le biais de cette abstraction. L'abstraction vous est présentée en tant qu'entités, opérations et actions.

• 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és. 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, alors que dans un connecteur de serveur de fichiers, ce sont les dossiers, et dans un connecteur de système de messagerie, ce sont les files d'attente.

  Toutefois, il est possible qu'un connecteur n'accepte 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é. Voici les opérations possibles :
  • List
  • Get
  • Create
  • Update
  • Delete

  Lorsque vous sélectionnez une entité dans la liste proposée, cela 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 "Connecteurs". Cependant, si un connecteur n'accepte pas l'une des opérations d'entité, cette opération non compatible ne figure pas dans la liste Operations.

• Action : une action est une fonction de première classe mise à la disposition de l'intégration par le biais de 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 un paramètre de sortie. Toutefois, il est possible qu'un connecteur n'accepte aucune action, auquel cas la liste Actions est vide.

Actions

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

Utiliser des RFC

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

RFC requis

Si l'un des RFC requis n'est pas disponible, certaines fonctionnalités peuvent ne pas fonctionner. Le code de transaction SE37 permet d'afficher les modules de fonction disponibles dans SAP.

Les RFC suivants sont utilisés par le connecteur SAP ERP.

• 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 la procédure à suivre pour lire de grandes quantités de 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. Cette fonction a une taille fixe de 512 octets. Il peut effectuer une mise en mémoire tampon pour chaque ligne de données. Par conséquent, la quantité des colonnes sélectionnées ne doit pas dépasser la capacité de 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 indique que vous avez dépassé la taille de mémoire tampon maximale autorisée par ligne et que vous devez sélectionner moins de colonnes.

Pour résoudre le problème DATA_BUFFER_EXCEEDED, vous pouvez inclure le code d'une Custom RFC_READ_TABLE, semblable à SAP RFC_READ_TABLE, mais avec un tampon plus grand.

Utiliser une fonction de lecture de table personnalisée

Le connecteur est compatible avec une Custom RFC_READ_TABLE semblable à SAP RFC_READ_TABLE, mais avec un tampon plus grand pour éviter le problème DATA_BUFFER_EXCEEDED.

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

Suivez la procédure ci-dessous pour utiliser l'exemple de fonction 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ée dans Z_CUSTOM_RFC_TABLE.
2. Dans l'onglet Attributes (Attributs) de la page SAP, sélectionnez Remote Enabled Module (Module compatible avec le contrôle à 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 Display > Change (Affichage > Modifier).
4. Dans l'onglet Source Code (Code source), saisissez le code du RFC pour la lecture de table personnalisée. Pour référence, consultez l'exemple Z_CUSTOM_RFC_TABLE_function.txt.
5. Cliquez sur Save (Enregistrer).
6. Définissez les importations, les tables et les exceptions comme indiqué dans la lecture de table personnalisée fournie.
7. Activez le module de fonction.

Lecture de table personnalisée pour ABAP 7.52

Si vous utilisez ABAP 7.52 ou une version ultérieure, reportez-vous à l'exemple Z_CUSTOM_RFC_TABLE_function_ABAP752.txt. L'exemple de fonction est conçu pour ABAP 7.52 et 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. La pagination est ainsi beaucoup plus efficace et les performances sont améliorées lorsque vous travaillez avec de grandes tables. Nous vous recommandons d'utiliser Z_CUSTOM_RFC_TABLE_752 RFC dans la mesure du possible.

Accéder à 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. Cette fonction est un module de fonction à distance qui permet un accès en lecture générique à des tables arbitraires.

Pour que les tables soient listées sous "Entités" lors de la configuration de la tâche "Connecteurs SAP ERP", vous devez utiliser la fonction RFC_READ_TABLE au niveau de la connexion SAP ERP et être autorisé à accéder à la fonction R/3 RFC_READ_TABLE.

Ajoutez l'autorisation S_TABU_DIS pour l'activité 03 (affichage) et du groupe d'autorisation "SC" pour la fonction RFC_READ_TABLE.

Voici quelques-unes des limites techniques de RFC_READ_TABLE :

• Seules les tables avec des types de données simples peuvent être lues. Les champs STRING et XSTRING ne sont pas pris en charge.
• La largeur maximale d'une ligne est de 512 caractères.
• Le nombre d'enregistrements renvoyés est limité par les seuils de mémoire.

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 d'articles dans SAP ERP.

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

Paramètres de sortie de l'action BAPI_MATERIAL_SAVEDATA

Si cette action aboutit, elle renvoie l'état 200 (OK).

Pour savoir comment configurer l'action BAPI_MATERIAL_SAVEDATA, consultez 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 de plusieurs types dans SAP ERP.

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

Paramètres de sortie de l'action ZFM_GCP_MULTIDATA_TAB

Si cette action aboutit, elle renvoie l'état 200 (OK).

Pour savoir comment configurer l'action ZFM_GCP_MULTIDATA_TAB, consultez 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

Paramètres de sortie de l'action PushIDoc

Si cette action aboutit, elle renvoie l'état 200 (OK).

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

Action ExecuteCustomQuery

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

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

1. Suivez les instructions détaillées pour ajouter une tâche "Connecteurs".
2. Lorsque vous configurez la tâche "Connecteurs", 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'ouvre.

      

   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=?

   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 de séquence.

      

      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.

Si cette action aboutit, elle 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 d'article à 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\":\"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, le paramètre de réponse connectorOutputPayload de la tâche BAPI_MATERIAL_SAVEDATA aura une valeur semblable à la suivante :

[{
"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 d'article à 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, le paramètre de réponse connectorOutputPayload de la tâche BAPI_MATERIAL_SAVEDATA aura une valeur semblable à la suivante :

[{
"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 d'article à 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, le paramètre de réponse connectorOutputPayload de la tâche BAPI_MATERIAL_SAVEDATA aura une valeur semblable à la suivante :

[{
"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 de type multidonnées

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 aboutit, le paramètre de réponse connectorOutputPayload de la tâche ZFM_GCP_MULTIDATA_TAB aura une valeur semblable à la suivante :

[{
"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 à SAP ERP.

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 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 :

   {
   "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 aboutit, le paramètre de réponse connectorOutputPayload de la tâche PushIDoc aura une valeur semblable à la suivante :

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

Exemples d'opérations d'entité

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

Exemple : Lister 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. (Facultatif) Dans la section Entrée de la tâche de la tâche Connecteurs, vous pouvez filtrer votre ensemble de résultats en spécifiant une clause de filtre. Indiquez toujours la valeur de la clause de filtre entre guillemets simples (').

Exemple : Récupérer un enregistrement à partir d'une entité

Cet exemple récupère un enregistrement ayant 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 Entrée de la tâche de la tâche Connecteurs, cliquez sur EntityId, puis saisissez 0001 dans le champ Valeur par défaut.

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