NetSuite

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

Avant de commencer

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

  • Dans votre projet Google Cloud :
    • Assurez-vous que la connectivité réseau est configurée. Pour en savoir plus sur les schémas de réseau, consultez Connectivité réseau.
    • 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

      Un compte de service est un type spécial de compte Google 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 en savoir plus, consultez 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 Activer des services.

    Si ces services ou autorisations n'ont pas encore été activés pour votre projet, vous êtes invité à les activer au moment de configurer le connecteur.

Configurer le connecteur

Une connexion est propre à 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 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.

      Les régions disponibles pour les connecteurs sont les suivantes :

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

    2. Cliquez sur Suivant.
  4. Dans la section Détails de connexion, procédez comme suit :
    1. Connecteur : sélectionnez Netsuite 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, indiquez le nom de l'instance de connexion.

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

      • Ils peuvent contenir des lettres, des chiffres ou des traits d'union.
      • Les lettres doivent être en minuscules.
      • Ils doivent commencer par une lettre et se terminer par une lettre ou un chiffre.
      • Ils ne peuvent pas dépasser 49 caractères.
    4. (Facultatif) Saisissez une description de l'instance de connexion.
    5. (Facultatif) Activez 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. (Facultatif) Configurez les paramètres des nœuds 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 davantage de transactions pour une connexion, vous devez disposer de plus de nœuds. À l'inverse, moins de nœuds sont nécessaires si une connexion traite moins de transactions. Pour comprendre comment les nœuds affectent la tarification de votre connecteur, consultez 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 améliorer la disponibilité) et le nombre maximal de nœuds sur 50.

    8. ID de compte : compte d'entreprise auquel votre nom d'utilisateur est associé dans NetSuite.
    9. Mode de colonne de données agrégées : indique comment traiter les colonnes de données agrégées.
    10. ID d'application : à partir de la version 2020.1, les requêtes à NetSuite nécessitent un ID d'application.
    11. Autorisations des champs personnalisés : liste des autorisations des champs personnalisés, séparées par une virgule. Permet un contrôle plus précis qu'IncludeCustomFieldColumns.
    12. Inclure les tables enfants : valeur booléenne indiquant si les tables enfants doivent être affichées.
    13. Inclure les colonnes de champs personnalisés : valeur booléenne indiquant si vous souhaitez inclure des colonnes de champs personnalisés.
    14. Inclure des tables de listes personnalisées : valeur booléenne indiquant si vous souhaitez utiliser des tables basées sur des listes personnalisées.
    15. Inclure des tables d'enregistrements personnalisés : valeur booléenne indiquant si vous souhaitez utiliser des tables basées sur des types d'enregistrements personnalisés.
    16. Inclure des colonnes de référence : liste de noms de colonnes séparés par une virgule représentant les colonnes à inclure lors de la récupération des données d'un champ représentant une référence d'enregistrement.
    17. Nombre maximal de sessions simultanées : nombre maximal de sessions simultanées disponibles pour la connexion.
    18. Format de date NetSuite : format de date préféré défini dans l'UI de NetSuite.
    19. Format de date long NetSuite : format de date long préféré défini dans l'UI de NetSuite.
    20. Dossier de métadonnées NetSuite : chemin d'accès à un répertoire pour télécharger des fichiers de métadonnées depuis NetSuite. Spécifiez-le pour optimiser les performances.
    21. Signaler les doubles en tant que décimales : indique si les doubles doivent être signalés en tant que décimales.
    22. Demander des transactions mémorisées : valeur booléenne indiquant si vous souhaitez demander des transactions mémorisées lors de la récupération des transactions depuis NetSuite.
    23. ID de rôle : le RoleId correspond à l'InternalId qui sera utilisé pour se connecter à NetSuite. Laissez ce champ vide pour utiliser le rôle par défaut de l'utilisateur.
    24. Schéma : type de schéma à utiliser. Vous pouvez sélectionner l'une des valeurs suivantes :
      • SuiteTalk : pour la connectivité basée sur SOAP.
      • SuiteSQL : pour la connectivité basée sur REST.
    25. Utiliser des services asynchrones : valeur booléenne indiquant si vous souhaitez utiliser des services asynchrones lors des opérations d'insertion, de mise à jour et de suppression.
    26. Utiliser des noms internes pour les personnalisations : valeur booléenne indiquant si vous souhaitez utiliser des noms internes pour les personnalisations.
    27. Utiliser des upserts : valeur booléenne indiquant si vous souhaitez effectuer un upsert lorsqu'une opération d'insertion est utilisée.
    28. Décalage horaire d'utilisateur : décalage horaire d'utilisateur défini dans vos préférences NetSuite sous Home > Preferences > Time Zone (Accueil > Préférences > Fuseau horaire). Exemple : EST.
    29. Profondeur d'analyse des lignes : nombre de lignes à analyser lors de la détermination dynamique des colonnes de la table.
    30. (Facultatif) Dans la section Paramètres avancés, cochez la case Utiliser un proxy pour configurer un serveur proxy pour la connexion et configurez les valeurs suivantes :
      • Schéma d'authentification du proxy : sélectionnez le type d'authentification pour l'authentification auprès du serveur proxy. Les types d'authentification suivants sont compatibles :
        • De base : authentification HTTP de base.
        • Digest : authentification HTTP Digest.
      • Utilisateur du proxy : nom d'utilisateur permettant de s'authentifier auprès du serveur proxy.
      • Mot de passe du proxy : secret Secret Manager du mot de passe de l'utilisateur.
      • Type SSL du proxy : type SSL à utiliser pour se connecter au serveur proxy. Les types d'authentification suivants sont compatibles :
        • Auto : paramètre par défaut. Dans le cas d'une URL HTTPS, l'option "Tunnel" est utilisée. Dans le cas d'une URL HTTP, l'option "Jamais" est utilisée.
        • Toujours : le protocole SSL est toujours activé pour la connexion.
        • Jamais : le protocole SSL n'est pas activé pour la connexion.
        • Tunnel : la connexion s'effectue avec un proxy de tunnelisation. Le serveur proxy ouvre une connexion à l'hôte distant et le trafic transite par le proxy.
      • Dans la section Serveur proxy, saisissez les détails du serveur proxy.
        1. Cliquez sur + Ajouter une destination.
        2. Sélectionnez un type de destination.
          • Adresse de l'hôte : spécifiez le nom d'hôte ou l'adresse IP de la destination.

            Si vous souhaitez établir une connexion privée à votre système backend, procédez comme suit :

    31. (Facultatif) Cliquez sur + Ajouter une étiquette pour ajouter une étiquette à la connexion sous la forme d'une paire clé/valeur.
    32. Cliquez sur Suivant.
  5. Dans la section Destinations, saisissez des informations sur l'hôte distant (système backend) auquel vous souhaitez vous connecter.
    1. Type de destination : vous pouvez spécifier les détails de destination sous la forme d'une adresse d'hôte ou d'un rattachement de service. Sélectionnez l'un des types de destination suivants :
      • Adresse de l'hôte : si vous souhaitez spécifier le nom d'hôte ou l'adresse IP de la destination.
      • Rattachement de service : si vous souhaitez spécifier le point de terminaison privé pour vos adresses IP internes. Le rattachement de service vous permet de masquer vos adresses IP internes dans le réseau externe. Vous pouvez créer un rattachement de service dans Google Cloud à l'aide de la fonctionnalité Private Service Connect. Pour en savoir plus sur la configuration de Private Service Connect, consultez Publier des services gérés.

      En fonction du type de destination sélectionné, saisissez l'adresse de l'hôte ou le nom du rattachement de service.

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

      • Nom d'utilisateur et mot de passe
      • Authentification par jeton
      • Attribution de code d'autorisation OAuth 2.0
    2. Pour savoir comment configurer ces types d'authentification, consultez Configurer l'authentification.

    3. Cliquez sur Suivant.
  7. Vérifier : vérifiez vos informations de connexion et d'authentification.
  8. Cliquez sur Créer.

Configurer l'authentification

Saisissez les informations en fonction de l'authentification que vous souhaitez utiliser.

  • Nom d'utilisateur et mot de passe

    Authentification par nom d'utilisateur et mot de passe. Cette option n'est valable que pour NetSuite version 2020.2 ou antérieure.

    • Nom d'utilisateur : nom d'utilisateur pour le connecteur
    • Mot de passe : secret Secret Manager contenant le mot de passe associé au connecteur
  • Authentification par jeton

    Authentification par jeton pour NetSuite. Cette méthode peut être utilisée pour les schémas SuiteTalk et SuiteQL.

    • ID client OAuth : clé client affichée lors de la création de l'application.
    • Code secret du client OAuth : secret Secret Manager contenant le secret du client affiché lors de la création de l'application.
    • Jeton d'accès OAuth : ID du jeton au moment de sa création.
    • Secret du jeton d'accès OAuth : secret Secret Manager contenant le secret du jeton au moment de la création du jeton d'accès.
  • Code d'autorisation OAuth 2.0
  • L'autorisation de la connexion s'effectue via un flux de connexion utilisateur Web. Cette méthode n'est valide que pour le schéma SuiteQL.

    • ID client : ID client utilisé pour demander des jetons d'accès.
    • Niveaux d'accès : liste des niveaux d'accès requis, séparés par une virgule.
    • Code secret du client : code secret du client utilisé pour demander des jetons d'accès.

    Pour le type d'authentification Authorization code, après avoir créé la connexion, vous devez effectuer quelques étapes supplémentaires pour configurer l'authentification. Pour en savoir plus, consultez Étapes supplémentaires après la création de la connexion.

Étapes supplémentaires après la création de la connexion

Si vous avez sélectionné OAuth 2.0 - Authorization code pour l'authentification, vous devez effectuer les étapes supplémentaires ci-dessous après avoir créé la connexion :

  1. Sur la page Connexions, recherchez la connexion que vous venez de créer.

    Notez que l'état du nouveau connecteur sera Autorisation requise.

  2. Cliquez sur Autorisation requise.

    Le volet Modifier l'autorisation s'affiche.

  3. Copiez la valeur de l'URI de redirection dans votre application externe.
  4. Vérifiez les détails de l'autorisation.
  5. Cliquez sur Autoriser.

    Si l'autorisation aboutit, l'état de la connexion est défini sur Active sur la page Connexions.

Accorder une nouvelle autorisation pour le code d'autorisation

Si vous utilisez le type d'authentification Authorization code et que vous avez modifié la configuration de votre application NetSuite backend, vous devez autoriser à nouveau votre connexion NetSuite. Pour autoriser à nouveau une connexion, procédez comme suit :

  1. Sur la page Connexions, cliquez sur la connexion requise.

    La page des détails de la connexion s'ouvre.

  2. Cliquez sur Modifier pour modifier les détails de la connexion.
  3. Dans la section Authentification, vérifiez les détails du code d'autorisation OAuth 2.0.

    Apportez des modifications, si besoin.

  4. Cliquez sur Enregistrer. La page des détails de la connexion s'affiche.
  5. Dans la section Authentification, cliquez sur Modifier l'autorisation. Le volet Autoriser s'affiche.
  6. Cliquez sur Autoriser.

    Si l'autorisation aboutit, l'état de la connexion est défini sur Active sur la page Connexions.

Configurer NetSuite

Pour générer un ID client, un code secret de client, un ID de jeton et un secret de jeton, procédez comme suit :

  1. Créez une intégration dans NetSuite.
  2. Fournissez des informations sur l'intégration, telles que son nom, et activez l'authentification par jeton.
  3. Spécifiez une URL de rappel, telle que https:cloud.google.com/connectors/oauth?e=ApplicationIntegrationConnectorPaginatedFieldsLaunch%3A%3AApplicationIntegrationConnectorPaginatedFieldsEnabled&project=PROJECT_NAME.
  4. Une fois l'intégration envoyée, vous recevrez un ID client et un code secret de client. Enregistrez ces informations.
  5. Configurez un enregistrement utilisateur d'intégration.
  6. Pour créer un jeton et un secret, accédez à la page d'accueil, sélectionnez Manage Access Tokens (Gérer les jetons d'accès), puis cliquez sur New My Access Token (Nouveau jeton d'accès). Vous utiliserez ces informations pour créer une authentification par jeton dans Google Cloud.

Pour savoir comment configurer Postman et importer la collection Postman, consultez cette page.

Limites du système

Le connecteur Netsuite peut traiter une transaction par seconde et par nœud, et limite les transactions au-delà de ce seuil. Par défaut, Integration Connectors alloue deux nœuds (pour améliorer la disponibilité) à une connexion.

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

Utiliser la connexion Netsuite dans une intégration

Une fois la connexion créée, elle devient disponible dans Apigee Integration et Application Integration. Vous pouvez utiliser la connexion dans une intégration au moyen de la tâche "Connecteurs".

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

Exemples d'opérations d'entité

Cette section présente les opérations d'entité compatibles avec le connecteur NetSuite et explique comment en effectuer certaines.

Entité Opérations compatibles
CreditMemo LIST, GET, CREATE, UPDATE
Customer LIST, GET, CREATE, UPDATE
CustomerPayment LIST, GET, CREATE, UPDATE
ItemFulfillment LIST, GET, CREATE
JournalEntry LIST, GET, CREATE
PurchaseOrder LIST, GET, CREATE, UPDATE
ReturnAuthorization LIST, GET, CREATE
SalesOrder LIST, GET, CREATE, UPDATE
Vendor LIST, GET, CREATE, UPDATE
VendorBill LIST, GET, CREATE, UPDATE
VendorCredit LIST, GET, CREATE, UPDATE
VendorPayment LIST, GET, CREATE, UPDATE
CashRefund LIST, GET, CREATE
CashSale LIST, GET, CREATE
CustomerDeposit LIST, GET
CustomerRefund LIST, GET
Employee LIST, GET
Estimate LIST, GET
File LIST, GET
InventoryAdjustment LIST, GET, CREATE
InventoryItem LIST, GET
ItemReceipt LIST, GET
Opportunity LIST, GET
PaycheckJournal LIST, GET, CREATE
SupportCase LIST, GET
SupportCaseIssue LIST, GET
TransferOrder LIST, GET, CREATE
VendorReturnAuthorization LIST, GET
WorkOrder LIST, GET
AssemblyItem LIST, GET
Bin LIST, GET
CustomerCategory LIST, GET
ItemGroup LIST, GET
KitItem LIST, GET
LotNumberedAssemblyItem LIST, GET
LotNumberedInventoryItem LIST, GET
NonInventoryPurchaseItem LIST, GET
NonInventoryResaleItem LIST, GET
NonInventorySaleItem LIST, GET
OtherChargePurchaseItem LIST, GET
OtherChargeResaleItem LIST, GET
OtherChargeSaleItem LIST, GET
SerializedAssemblyItem LIST, GET
SerializedInventoryItem LIST, GET
ServicePurchaseItem LIST, GET
ServiceResaleItem LIST, GET
ServiceSaleItem LIST, GET
CreditMemo_itemList CREATE
Invoice_itemList CREATE
PurchaseOrder_itemList CREATE
SalesOrder_itemList CREATE
VendorBill_itemList CREATE
VendorCredit_itemList CREATE
VendorPayment_applyList CREATE

Lorsque vous effectuez une opération d'insertion dans NetSuite, si tous les champs et données nécessaires ne sont pas spécifiés, l'API sur laquelle l'entité est alignée rejette la requête. Cela génère une exception. L'exception peut varier en fonction de l'entité utilisée dans l'opération d'insertion. Vous devez fournir les éléments de ligne NetSuite dans la requête pour insérer des données. Vous pouvez spécifier l'élément de ligne via le champ ItemListAggregate, disponible dans tous les tables parentes. Voici le format du champ ItemListAggregate :

    "`<ItemList>`\n" +
              "  <Row>\n" +
                      "    <ItemList_Item_InternalId>656</ItemList_Item_InternalId>\n" +
                      "    <ItemList_Item_Name>Iphone 15Pro</ItemList_Item_Name>\n" +
                      "    <ItemList_Line>1</ItemList_Line>\n" +
                      "    <ItemList_Description>Canon PowerShot Camera Test</ItemList_Description>\n" +
                      "    <ItemList_Amount>8500.0</ItemList_Amount>\n" +
                      "    <ItemList_Quantity>17.0</ItemList_Quantity>\n" +
                      "    <ItemList_Price_InternalId>1</ItemList_Price_InternalId>\n" +
                      "    <ItemList_Price_Name>List Price</ItemList_Price_Name>\n" +
                      "    <ItemList_Rate>500.00</ItemList_Rate>\n" +
                      "    <ItemList_Location_InternalId>1</ItemList_Location_InternalId>\n" +
                      "    <ItemList_Location_Name>02: NewYork</ItemList_Location_Name>\n" +
                      "    <ItemList_TaxCode_InternalId>-7</ItemList_TaxCode_InternalId>\n" +
                      "    <ItemList_TaxCode_Name>-Not Taxable-</ItemList_TaxCode_Name>\n" +
                      "    <ItemList_ShipGroup>1</ItemList_ShipGroup>\n" +
                      "    <ItemList_ItemIsFulfilled>false</ItemList_ItemIsFulfilled>\n" +
                      "    <CustomFieldListAggregate>\n" +
                      "      <CustomField InternalId=\"4779\" Type=\"platformCore:StringCustomFieldRef\" ScriptId=\"custcol121\">\n" +
                      "        <Value>1</Value>\n" +
                      "      </CustomField>\n" +
                      "    </CustomFieldListAggregate>\n" +
                      "  </Row>\n" +
                      "  <Row>\n" +
                      "    <ItemList_Item_InternalId>656</ItemList_Item_InternalId>\n" +
                      "    <ItemList_Item_Name>Iphone 15Pro</ItemList_Item_Name>\n" +
                      "    <ItemList_Line>4</ItemList_Line>\n" +
                      "    <ItemList_Description>Canon PowerShot Camera Test</ItemList_Description>\n" +
                      "    <ItemList_Amount>8500.0</ItemList_Amount>\n" +
                      "    <ItemList_Quantity>17.0</ItemList_Quantity>\n" +
                      "    <ItemList_Price_InternalId>1</ItemList_Price_InternalId>\n" +
                      "    <ItemList_Price_Name>List Price</ItemList_Price_Name>\n" +
                      "    <ItemList_Rate>500.00</ItemList_Rate>\n" +
                      "    <ItemList_Location_InternalId>2</ItemList_Location_InternalId>\n" +
                      "    <ItemList_Location_Name>01: California</ItemList_Location_Name>\n" +
                      "    <ItemList_TaxCode_InternalId>-7</ItemList_TaxCode_InternalId>\n" +
                      "    <ItemList_TaxCode_Name>-Not Taxable-</ItemList_TaxCode_Name>\n" +
                      "    <ItemList_ShipGroup>1</ItemList_ShipGroup>\n" +
                      "    <ItemList_ItemIsFulfilled>false</ItemList_ItemIsFulfilled>\n" +
                      "    <CustomFieldListAggregate>\n" +
                      "      <CustomField InternalId=\"4776\" Type=\"platformCore:StringCustomFieldRef\" ScriptId=\"custcol121\">\n" +
                      "        <Value>4</Value>\n" +
                      "      </CustomField>\n" +
                      "    </CustomFieldListAggregate>\n" +
                      "  </Row>\n" +
     "`</ItemList>`;"
  

Exemple : Lister toutes les notes de crédit

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez CreditMemo 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 : Obtenir un enregistrement CreditMemo

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "CreditMemo" dans la liste Entity.
  3. Sélectionnez l'opération GET, puis cliquez sur OK.
  4. Définissez l'ID d'entité sur 1083723, qui est la clé à transmettre. Pour définir l'ID d'entité, dans la section Data Mapper de la tâche Mappage de données, cliquez sur Ouvrir l'éditeur de mappage de données, puis saisissez 1083723 dans le champ Valeur d'entrée et choisissez "EntityId" comme variable locale.

    Transmettez directement l'ID d'entité. La transmission d'un ID d'entité peut générer une erreur si des clés composites existent. Dans ce cas, utilisez la clause de filtre pour spécifier l'ID.

Exemple : Créer un enregistrement PurchaseOrder

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "SalesOrder" dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload" comme variable locale.
    {
              "Entity_InternalId": "2041",
              "Location_InternalId": "6",
              " + "<ItemList>\n" +
                  "  <Row>\n" +
                      "    <ItemList_Item_InternalId>979</ItemList_Item_InternalId>\n" +
                      "    <ItemList_Line>2</ItemList_Line>\n" +
                      "    <ItemList_Amount>66500.0</ItemList_Amount>\n" +
                      "  </Row>\n" +
                      "  <Row>\n" +
                      "    <ItemList_Item_InternalId>979</ItemList_Item_InternalId>\n" +
                      "    <ItemList_Line>3</ItemList_Line>\n" +
                      "    <ItemList_Amount>16500.0</ItemList_Amount>\n" +
                      "  </Row>\n" +
                      "</ItemList>" + ",
              "Email": "222larabrown@gmail.com"
          }

    Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche PurchaseOrder a une valeur semblable à celle-ci :

     {
        "InternalId": "1093053"
      } 
      

Exemple : Créer un enregistrement ReturnAuthorization

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "ReturnAuthorization" dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload" comme variable locale.
    {
              "Entity_InternalId": "1709",
              "Status": "Approved",
              " + "<ItemList>\n" +
                  "  <Row>\n" +
                      "    <ItemList_Item_InternalId>945</ItemList_Item_InternalId>\n" +
                      "    <ItemList_Line>2</ItemList_Line>\n" +
                      "    <ItemList_Amount>2500.0</ItemList_Amount>\n" +
                      "  </Row>\n" +
                      "  <Row>\n" +
                      "    <ItemList_Item_InternalId>945</ItemList_Item_InternalId>\n" +
                      "    <ItemList_Line>3</ItemList_Line>\n" +
                      "    <ItemList_Amount>16500.0</ItemList_Amount>\n" +
                      "  </Row>\n" +
                      "</ItemList>" + "
          }

    Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche ReturnAuthorization a une valeur semblable à celle-ci :

     {
        "InternalId": "1093053"
      } 
      

Exemple : Créer un enregistrement SalesOrder

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "SalesOrder" dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload" comme variable locale.
    {
              " + "<ItemList>\n" +
                  "  <Row>\n" +
                      "    <ItemList_Item_InternalId>945</ItemList_Item_InternalId>\n" +
                      "    <ItemList_Line>1</ItemList_Line>\n" +
                      "    <ItemList_Amount>9990900.0</ItemList_Amount>\n" +
                      "  </Row>\n" +
                      "  <Row>\n" +
                      "    <ItemList_Item_InternalId>945</ItemList_Item_InternalId>\n" +
                      "    <ItemList_Amount>99900.0</ItemList_Amount>\n" +
                      "  </Row>\n" +
                      "</ItemList>" + ",
              "Entity_InternalId": "1709"
          }

    Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche SalesOrder a une valeur semblable à celle-ci :

     {
        "InternalId": "1093053"
      } 
      

Exemple : Créer un enregistrement CreditMemo_itemList

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "CreditMemo_itemList" dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload" comme variable locale.
    {
        "ItemList_Item_InternalId": "945",
        "Entity_InternalId": "1709",
        "Location_InternalId": "5",
        "ItemList_Amount": 7777777.0,
        "ItemList_Description": "Created"
      }
      

    Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche CreditMemo_itemList a une valeur semblable à celle-ci :

     {
        "InternalId": "1093053",
        "ListId": "1"
      }
      

Exemple : Créer un enregistrement Customer

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "Customer" dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload" comme variable locale.
     {
        "CompanyName": "Bcone8",
        "Email": "222larabrown@gmail.com"
      }
      

    Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche Customer a une valeur semblable à celle-ci :

    {
        "InternalId": "4767"
      } 
      

Exemple : Créer un enregistrement Invoice_itemList

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "Invoice_itemList" dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload" comme variable locale.
     {
        "ItemList_Item_InternalId": "945",
        "Entity_InternalId": "1709",
        "ItemList_Amount": 945.0,
        "Item": "InvoiceItem"
      }
      

    Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche Invoice_itemList a une valeur semblable à celle-ci :

     {
        "InternalId": "1093052",
        "ListId": "1"
      } 
      

Exemple : Créer un enregistrement CustomerPayment

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "CustomerPayment" dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload" comme variable locale.
     {
        "Customer_InternalId": "1714",
        "Payment": 9999.0
      } 
      

    Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche CustomerPayment a une valeur semblable à celle-ci :

     {
        "InternalId": "1090749"
      } 
      

Exemple : Créer un enregistrement PurchaseOrder_itemList

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "PurchaseOrder_itemList" dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload" comme variable locale.
     {
        "Entity_InternalId": "2041",
        "Location_InternalId": "6",
        "ItemList_Description": "Created on Jan 11",
        "ItemList_Item_InternalId": "979"
      } 
      

    Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche PurchaseOrder_itemList a une valeur semblable à celle-ci :

     {
        "InternalId": "1093151",
        "ListId": "1"
      }  
      

Exemple : Créer un enregistrement SalesOrder_itemList

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "SalesOrder_itemList" dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload" comme variable locale.
     {
        "Email": "222larabrown@gmail.com",
        "Entity_InternalId": "1709",
        "ItemList_Item_InternalId": "945",
        "ItemList_Amount": 1000.0
      }
      

    Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche SalesOrder_itemList a une valeur semblable à celle-ci :

      {
        "InternalId": "1093351",
        "ListId": "1"
      }  
      

Exemple : Créer un enregistrement Vendor

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "Vendor" dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload" comme variable locale.
     {
        "CompanyName": "Deloitte",
        "LegalName": "AU Vendor"
      } 
      

    Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche Vendor a une valeur semblable à celle-ci :

     {
        "InternalId": "5067"
      }  
      

Exemple : Créer un enregistrement VendorBill_itemList

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "VendorBill_itemList" dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload" comme variable locale.
     {
        "Entity_InternalId": "2041",
        "ItemList_Item_InternalId": "1374",
        "ItemList_Amount": 700.0
      } 
      

    Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche VendorBill_itemList a une valeur semblable à celle-ci :

     {
        "InternalId": "5067"
      }  
      

Exemple : Créer un enregistrement VendorCredit_itemList

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "VendorCredit_itemList" dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload" comme variable locale.
     {
        "Entity_InternalId": "2041",
        "Location_InternalId": "6",
        "ItemList_Item_InternalId": "992",
        "ItemList_Description": "Created on Jan 12"
      }
      

    Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche VendorCredit_itemList a une valeur semblable à celle-ci :

     {
        "InternalId": "1093353",
        "ListId": "1"
      }  
      

Exemple : Créer un enregistrement VendorPayment_applyList

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "VendorPayment_applyList" dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload" comme variable locale.
     {
        "ApplyList_Doc": 3339.0,
        "ApplyList_Apply": true,
        "Entity_InternalId": "1471"
      }
      

    Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche VendorPayment_applyList a une valeur semblable à celle-ci :

     {
        "InternalId": "1093756",
        "ListId": "1"
      }   
      

Exemple : Créer un enregistrement CreditMemo

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "CreditMemo" dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload" comme variable locale.
    {
              "ItemListAggregate": " + "<ItemList>\n" +
                     "  <Row>\n" +
                     "    <ItemList_Item_InternalId>6</ItemList_Item_InternalId>\n" +
                     "    <ItemList_Line>2</ItemList_Line>\n" +
                     "    <ItemList_Amount>8800.0</ItemList_Amount>\n" +
                     "  </Row>\n" +
                     "  <Row>\n" +
                     "    <ItemList_Item_InternalId>6</ItemList_Item_InternalId>\n" +
                     "    <ItemList_Line>3</ItemList_Line>\n" +
                     "    <ItemList_Amount>9900.0</ItemList_Amount>\n" +
                     "  </Row>\n" +
                     "</ItemList>" + ",
              "Entity_InternalId": "11",
              "Email": "222larabrown@gmail.com"
          }

    Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche CreditMemo a une valeur semblable à celle-ci :

    {
        "InternalId": "106"
      }
      

Exemple : Créer un enregistrement Invoice

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "Invoice" dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload" comme variable locale.
    {
              "ItemListAggregate": " + "<ItemList>\n" +
                  "  <Row>\n" +
                      "    <ItemList_Item_InternalId>6</ItemList_Item_InternalId>\n" +
                      "    <ItemList_Line>1</ItemList_Line>\n" +
                      "    <ItemList_Amount>7998500.0</ItemList_Amount>\n" +
                      "  </Row>\n" +
                      "  <Row>\n" +
                      "    <ItemList_Item_InternalId>6</ItemList_Item_InternalId>\n" +
                      "    <ItemList_Line>2</ItemList_Line>\n" +
                      "    <ItemList_Amount>6500.0</ItemList_Amount>\n" +
                      "  </Row>\n" +
                      "</ItemList>" + ",
              "Memo": "May9"
          }

    Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche Invoice a une valeur semblable à celle-ci :

    {
        "InternalId": "206"
      }
      

Exemple : Créer un enregistrement ItemFulfillment

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "ItemFulfillment" dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload" comme variable locale.
    {
        "CreatedFrom_InternalId": "411",
        "ShipStatus": "_picked"
      } 
      

    Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche ItemFulfillment a une valeur semblable à celle-ci :

    {
        "InternalId": "412"
      }
      

Exemple : Créer un enregistrement JournalEntry

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "JournalEntry" dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload" comme variable locale.
    {
              "Subsidiary_InternalId": "1",
              "Memo": "Journal Entry created on April 2",
              "LineListAggregate":" + "<LineList>\n" +
                  "  <Row>\n" +
                      "    <LineList_Account_InternalId>1</LineList_Account_InternalId>\n" +
                      "    <LineList_Line>1</LineList_Line>\n" +
                      "    <LineList_credit>500.0</LineList_credit>\n" +
                      "  </Row>\n" +
                      "  <Row>\n" +
                      "    <LineList_Account_InternalId>1</LineList_Account_InternalId>\n" +
                      "    <LineList_Line>1</LineList_Line>\n" +
                      "    <LineList_debit>500.00</LineList_debit>\n" +
                      "  </Row>\n" +
                      "</LineList>" + "
          }

    Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche JournalEntry a une valeur semblable à celle-ci :

    {
        "InternalId": "612"
      }
      

Exemple : Créer un enregistrement PurchaseOrder

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "SalesOrder" dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload" comme variable locale.
    {
              "Entity_InternalId": "2041",
              "Location_InternalId": "6",
              " + "<ItemList>\n" +
                  "  <Row>\n" +
                      "    <ItemList_Item_InternalId>979</ItemList_Item_InternalId>\n" +
                      "    <ItemList_Line>2</ItemList_Line>\n" +
                      "    <ItemList_Amount>66500.0</ItemList_Amount>\n" +
                      "  </Row>\n" +
                      "  <Row>\n" +
                      "    <ItemList_Item_InternalId>979</ItemList_Item_InternalId>\n" +
                      "    <ItemList_Line>3</ItemList_Line>\n" +
                      "    <ItemList_Amount>16500.0</ItemList_Amount>\n" +
                      "  </Row>\n" +
                      "</ItemList>" + ",
              "Email": "222larabrown@gmail.com"
          }

    Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche PurchaseOrder a une valeur semblable à celle-ci :

    {
        "InternalId": "1116228"
      }
      

Exemple : Créer un enregistrement VendorBill

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "VendorBill" dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload" comme variable locale.
      {"Entity_InternalId": "12",
      " + "<ItemList>\n" +
                  "  <Row>\n" +
                          "    <ItemList_Item_InternalId>7</ItemList_Item_InternalId>\n" +
                          "    <ItemList_Line>1</ItemList_Line>\n" +
                          "    <ItemList_Amount>77700.0</ItemList_Amount>\n" + +
                          "  </Row>\n" +
                          "  <Row>\n" +
                          "    <ItemList_Item_InternalId>7</ItemList_Item_InternalId>\n" +
                          "    <ItemList_Line>2</ItemList_Line>\n" +
                          "    <ItemList_Amount>888888</ItemList_Amount>\n" + +
                          "  </Row>\n" +
                          "</ItemList>;" + "}

    Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche VendorBill a une valeur semblable à celle-ci :

    {
        "InternalId": "816"
      }
      

Exemple : Créer un enregistrement VendorCredit

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "VendorCredit" dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload" comme variable locale.
    {"Entity_InternalId": "12",
      " + "<ItemList>\n" +
                  "  <Row>\n" +
                          "    <ItemList_Item_InternalId>7</ItemList_Item_InternalId>\n" +
                          "    <ItemList_Line>1</ItemList_Line>\n" +
                          "    <ItemList_Amount>77700.0</ItemList_Amount>\n" +
                          "  </Row>\n" +
                          "  <Row>\n" +
                          "    <ItemList_Item_InternalId>7</ItemList_Item_InternalId>\n" +
                          "    <ItemList_Line>2</ItemList_Line>\n" +
                          "    <ItemList_Amount>888888</ItemList_Amount>\n" +
                          "  </Row>\n" +
                          "</ItemList>;" + "}

    Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche VendorCredit a une valeur semblable à celle-ci :

    {
        "InternalId": "818"
      }
      

Exemple : Créer un enregistrement VendorPayment

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "VendorPayment" dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload" comme variable locale.
    {
        "Entity_InternalId": "12",
        "ApplyList_Apply": true,
        "ApplyList_Doc": 714.0
      }       
      

    Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche VendorPayment a une valeur semblable à celle-ci :

    {
        "InternalId": "1025",
        "ListId": "1"
      } 
      

Exemple : Créer un enregistrement TransferOrder

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "TransferOrder" dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload" comme variable locale.
    {
      "Location_InternalId": "1",
      "TransferLocation_InternalId": "3",
      "ItemListAggregate": 
       " + "<ItemList>\n" +
                  "  <Row>\n" +
                  "    <ItemList_Item_InternalId>8</ItemList_Item_InternalId>\n" +
                  "    <ItemList_Line>1</ItemList_Line>\n" +
                  "    <ItemList_Amount>77700.0</ItemList_Amount>\n" +
                  "  </Row>\n" +
                  "  <Row>\n" +
                  "    <ItemList_Item_InternalId>8</ItemList_Item_InternalId>\n" +
                  "    <ItemList_Line>2</ItemList_Line>\n" +
                  "    <ItemList_Amount>888888</ItemList_Amount>\n" +
                  "  </Row>\n" +
                  "</ItemList>;"
      }
      

    Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche TRANSFERORDER a une valeur semblable à celle-ci :

    {
      "InternalId": "1337"
      } 
      

Exemple : Créer un enregistrement CashSale

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "CashSale" dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload" comme variable locale.
    {
      "Entity_InternalId": "10",
      "Location_InternalId": "3",
      "ItemListAggregate": 
       "<ItemList>\n" +
                  "  <Row>\n" +
                  "    <ItemList_Item_InternalId>8</ItemList_Item_InternalId>\n" +
                  "    <ItemList_Line>1</ItemList_Line>\n" +
                  "    <ItemList_Amount>77700.0</ItemList_Amount>\n" +
                  "  </Row>\n" +
                  "  <Row>\n" +
                  "    <ItemList_Item_InternalId>8</ItemList_Item_InternalId>\n" +
                  "    <ItemList_Line>2</ItemList_Line>\n" +
                  "    <ItemList_Amount>888888</ItemList_Amount>\n" +
                  "  </Row>\n" +
                  "</ItemList>;"
      }
      

    Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche CashSale a une valeur semblable à celle-ci :

    {
      "InternalId": "1234"
      } 
      

Exemple : Créer un enregistrement PaycheckJournal

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "PaycheckJournal" dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload" comme variable locale.
    {
      "Employee_InternalId": "8",
      "Account_InternalId": "314",
      "EarningListAggregate":  
       "<EarningList>\n" +
                  "  <Row>\n" +
                  "    <EarningList_PayrollItem_InternalId>2</EarningList_PayrollItem_InternalId>\n" +
                  "    <EarningList_Amount>1998</EarningList_Amount>\n" +
                  "  </Row>\n" +
                  "</EarningList>;"
      }
      

    Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche PaycheckJournal a une valeur semblable à celle-ci :

    {
      "InternalId": "1746"
      } 
      

Exemple : Créer un enregistrement InventoryAdjustment

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "InventoryAdjustment" dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload" comme variable locale.
    {
      "Account_InternalId": "1",
      "AdjLocation_InternalId": "1",
      "Location_InternalId": "3",
      "InventoryListAggregate": 
       "<InventoryList>\n" +
                  "  <Row>\n" +
                  "    <InventoryList_Item_InternalId>8</InventoryList_Item_InternalId>\n" +
                  "    <InventoryList_Line>1</InventoryList_Line>\n" +
                  "    <InventoryList_Location_InternalId>1</InventoryList_Location_InternalId>\n" +
                  "    <InventoryList_AdjustQtyBy>100</InventoryList_AdjustQtyBy>\n" +
                  "  </Row>\n" +
                  "</InventoryList>;"
      }
      

    Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche InventoryAdjustment a une valeur semblable à celle-ci :

    {
      "InternalId": "1640"
      } 
      

Exemple : Créer un enregistrement CashRefund

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "CashRefund" dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload" comme variable locale.
    {
      "Entity_InternalId": "10",
      "Location_InternalId": "3",
      "ItemListAggregate": 
       "<ItemList>\n" +
                  "  <Row>\n" +
                  "    <ItemList_Item_InternalId>8</ItemList_Item_InternalId>\n" +
                  "    <ItemList_Line>1</ItemList_Line>\n" +
                  "    <ItemList_Amount>799.0</ItemList_Amount>\n" +
                  "  </Row>\n" +
                  "  <Row>\n" +
                  "    <ItemList_Item_InternalId>8</ItemList_Item_InternalId>\n" +
                  "    <ItemList_Line>2</ItemList_Line>\n" +
                  "    <ItemList_Amount>666</ItemList_Amount>\n" +
                  "  </Row>\n" +
                  "</ItemList>;"
      }
      

    Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche CashRefund a une valeur semblable à celle-ci :

    {
      "InternalId": "1232"
      } 
      

Exemple : Mettre à jour un enregistrement CreditMemo

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "CreditMemo" dans la liste Entity.
  3. Sélectionnez l'opération Update, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.
    {
        "Email2": "222larabrown@gmail.com"
      } 
      
  5. Définissez l'ID d'entité dans Data Mapper sur l'entité CreditMemo. Pour définir l'ID d'entité, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.

    Sinon, au lieu de spécifier l'entityId, vous pouvez définir la filterClause sur 1090651.

    L'exécution de cet exemple renvoie une réponse semblable à la suivante dans la variable de sortie connectorOutputPayload de la tâche "Connecteurs" :

     {
        "InternalId": "1090651"
      } 
      

Exemple : Mettre à jour un enregistrement Customer

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "Customer" dans la liste Entity.
  3. Sélectionnez l'opération Update, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.
     {
        "Email": "222larabrown@gmail.com"
      } 
      
  5. Définissez l'ID d'entité dans Data Mapper sur l'entité Customer. Pour définir l'ID d'entité, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.

    Sinon, au lieu de spécifier l'entityId, vous pouvez définir la filterClause sur 4767.

    L'exécution de cet exemple renvoie une réponse semblable à la suivante dans la variable de sortie connectorOutputPayload de la tâche "Connecteurs" :

     {
        "InternalId": "4767"
      } 
      

Exemple : Mettre à jour un enregistrement Invoice

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "Invoice" dans la liste Entity.
  3. Sélectionnez l'opération Update, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.
      {
        "Email2": "222larabrown@gmail.com"
      } 
      
  5. Définissez l'ID d'entité dans Data Mapper sur l'entité Invoice. Pour définir l'ID d'entité, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.

    Sinon, au lieu de spécifier l'entityId, vous pouvez définir la filterClause sur 1083927.

    L'exécution de cet exemple renvoie une réponse semblable à la suivante dans la variable de sortie connectorOutputPayload de la tâche "Connecteurs" :

     {
        "InternalId": "1083927"
      } 
      

Exemple : Mettre à jour un enregistrement CustomerPayment

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "CustomerPayment" dans la liste Entity.
  3. Sélectionnez l'opération Update, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.
     {
        "Customer_InternalId": "1714",
        "Payment": 7.77777777E8
      } 
      
  5. Définissez l'ID d'entité dans Data Mapper sur l'entité CustomerPayment. Pour définir l'ID d'entité, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.

    Sinon, au lieu de spécifier l'entityId, vous pouvez définir la filterClause sur 1090749.

    L'exécution de cet exemple renvoie une réponse semblable à la suivante dans la variable de sortie connectorOutputPayload de la tâche "Connecteurs" :

     {
        "InternalId": "1090749"
      } 
      

Exemple : Mettre à jour un enregistrement PurchaseOrder

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "SalesOrder" dans la liste Entity.
  3. Sélectionnez l'opération Update, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.
     {
        "Message": "Aspirin Updated"
      } 
      
  5. Définissez l'ID d'entité dans Data Mapper sur l'entité PurchaseOrder. Pour définir l'ID d'entité, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.

    Sinon, au lieu de spécifier l'entityId, vous pouvez définir la filterClause sur 1000.

    L'exécution de cet exemple renvoie une réponse semblable à la suivante dans la variable de sortie connectorOutputPayload de la tâche "Connecteurs" :

     {
        "InternalId": "1000"
      } 
      

Exemple : Mettre à jour un enregistrement SalesOrder

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "SalesOrder" dans la liste Entity.
  3. Sélectionnez l'opération Update, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.
     {
        "Email": "222larabrown@gmail.com",
        "Entity_InternalId": "1709",
        "Item_InternalId": "945"
      }
      
  5. Définissez l'ID d'entité dans Data Mapper sur l'entité SalesOrder. Pour définir l'ID d'entité, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.

    Sinon, au lieu de spécifier l'entityId, vous pouvez définir la filterClause sur 1086949.

    L'exécution de cet exemple renvoie une réponse semblable à la suivante dans la variable de sortie connectorOutputPayload de la tâche "Connecteurs" :

     {
        "InternalId": "1086949"
      } 
      

Exemple : Mettre à jour un enregistrement Vendor

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "Vendor" dans la liste Entity.
  3. Sélectionnez l'opération Update, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.
     {
        "CompanyName": "Deloitte_Updated"
      } 
      
  5. Définissez l'ID d'entité dans Data Mapper sur l'entité Vendor. Pour définir l'ID d'entité, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.

    Sinon, au lieu de spécifier l'entityId, vous pouvez définir la filterClause sur 4567.

    L'exécution de cet exemple renvoie une réponse semblable à la suivante dans la variable de sortie connectorOutputPayload de la tâche "Connecteurs" :

     {
        "InternalId": "4567"
      } 
      

Exemple : Mettre à jour un enregistrement VendorBill

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "VendorBill" dans la liste Entity.
  3. Sélectionnez l'opération Update, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.
      {
        "Memo": "Memo_Jan 11"
      } 
      
  5. Définissez l'ID d'entité dans Data Mapper sur l'entité VendorBill. Pour définir l'ID d'entité, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.

    Sinon, au lieu de spécifier l'entityId, vous pouvez définir la filterClause sur 3339.

    L'exécution de cet exemple renvoie une réponse semblable à la suivante dans la variable de sortie connectorOutputPayload de la tâche "Connecteurs" :

     {
        "InternalId": "3339"
      } 
      

Exemple : Mettre à jour un enregistrement VendorCredit

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "VendorCredit" dans la liste Entity.
  3. Sélectionnez l'opération Update, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.
     {
        "Memo": "16253"
      } 
      
  5. Définissez l'ID d'entité dans Data Mapper sur l'entité VendorCredit. Pour définir l'ID d'entité, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.

    Sinon, au lieu de spécifier l'entityId, vous pouvez définir la filterClause sur 1091549.

    L'exécution de cet exemple renvoie une réponse semblable à la suivante dans la variable de sortie connectorOutputPayload de la tâche "Connecteurs" :

     {
        "InternalId": "1091549"
      } 
      

Exemple : Mettre à jour un enregistrement VendorPayment

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "VendorPayment" dans la liste Entity.
  3. Sélectionnez l'opération Update, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.
      {
        "Memo": "Jan8"
      } 
      
  5. Définissez l'ID d'entité dans Data Mapper sur l'entité VendorPayment. Pour définir l'ID d'entité, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et choisissez "EntityId/ConnectorInputPayload/FilterClause" comme variable locale.

    Sinon, au lieu de spécifier l'entityId, vous pouvez définir la filterClause sur 1082627.

    L'exécution de cet exemple renvoie une réponse semblable à la suivante dans la variable de sortie connectorOutputPayload de la tâche "Connecteurs" :

     {
        "InternalId": "1082627"
      } 
      

Créer des connexions à l'aide de Terraform

Vous pouvez utiliser la ressource Terraform pour créer une connexion.

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

Pour afficher un exemple de modèle Terraform permettant de créer une connexion, consultez 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 Obligatoire Description
account_id CHAÎNE Oui Compte d'entreprise auquel votre nom d'utilisateur est associé dans NetSuite.
aggregate_column_mode CHAÎNE Non Indique comment traiter les colonnes de données agrégées.
application_id CHAÎNE Non À partir de la version 2020.1, les requêtes envoyées à NetSuite nécessitent un ID d'application.
custom_field_permissions CHAÎNE Non Liste d'autorisations de champs personnalisés séparées par une virgule. Permet un contrôle plus précis qu'IncludeCustomFieldColumns.
include_child_tables BOOLÉEN Non Valeur booléenne indiquant si les tables enfants doivent être affichées.
include_custom_field_columns BOOLÉEN Non Valeur booléenne indiquant si vous souhaitez inclure des colonnes de champs personnalisés.
include_custom_list_tables BOOLÉEN Non Valeur booléenne indiquant si vous souhaitez utiliser des tables basées sur des listes personnalisées.
include_custom_record_tables BOOLÉEN Non Valeur booléenne indiquant si vous souhaitez utiliser des tables basées sur des types d'enregistrements personnalisés.
include_reference_columns CHAÎNE Non Liste de noms de colonnes séparés par une virgule représentant les colonnes à inclure lors de la récupération des données d'un champ représentant une référence d'enregistrement.
maximum_concurrent_sessions ENTIER Non Nombre maximal de sessions simultanées disponibles pour la connexion.
net_suite_date_format CHAÎNE Non Format de date préféré défini dans l'UI de NetSuite.
net_suite_long_date_format CHAÎNE Non Format de date long préféré défini dans l'UI de NetSuite.
netsuite_metadata_folder CHAÎNE Non Chemin d'accès à un répertoire pour télécharger des fichiers de métadonnées depuis NetSuite. Spécifiez-le pour optimiser les performances.
report_doubles_as_decimal BOOLÉEN Non Indique si les doubles doivent être signalés en tant que décimales.
request_memorized_transactions BOOLÉEN Non Valeur booléenne indiquant si vous souhaitez demander des transactions mémorisées lors de la récupération de transactions depuis NetSuite.
role_id CHAÎNE Non Le RoleId correspond à l'InternalId qui sera utilisé pour se connecter à NetSuite. Laissez ce champ vide pour utiliser le rôle par défaut de l'utilisateur.
schema CHAÎNE Oui Type de schéma à utiliser.
use_async_services BOOLÉEN Non Valeur booléenne indiquant si vous souhaitez utiliser des services asynchrones lors des opérations d'insertion, de mise à jour et de suppression.
use_internal_names_for_customizations BOOLÉEN Non Valeur booléenne indiquant si vous souhaitez utiliser des noms internes pour les personnalisations.
use_upserts BOOLÉEN Non Valeur booléenne indiquant si vous souhaitez effectuer un upsert lorsqu'une opération d'insertion est utilisée.
user_timezone_offset CHAÎNE Non Décalage horaire d'utilisateur défini dans vos préférences NetSuite sous Home > Preferences > Time Zone (Accueil > Préférences > Fuseau horaire). Exemple : EST.
row_scan_depth CHAÎNE Non Nombre de lignes à analyser lors de la détermination dynamique des colonnes de la table.
verbosity CHAÎNE Non Niveau de verbosité de la connexion, compris entre 1 et 5. Un niveau de verbosité plus élevé consigne tous les détails de la communication (requête, réponse et certificats SSL).
proxy_enabled BOOLEAN False Cochez cette case afin de configurer un serveur proxy pour la connexion.
proxy_auth_scheme ENUM False Type d'authentification à utiliser pour s'authentifier auprès du proxy ProxyServer. Valeurs acceptées : BASIC, DIGEST et NONE.
proxy_user STRING False Nom d'utilisateur permettant de s'authentifier auprès du proxy ProxyServer.
proxy_password SECRET False Mot de passe à utiliser pour s'authentifier auprès du proxy ProxyServer.
proxy_ssltype ENUM False Type SSL à utiliser pour se connecter au proxy ProxyServer. Valeurs acceptées : AUTO, ALWAYS, NEVER et TUNNEL.

Demander de l'aide à la communauté Google Cloud

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

Étapes suivantes