NetSuite

借助 NetSuite 连接器,您可以对 NetSuite 数据执行插入、删除、更新和读取操作。

准备工作

在使用 NetSuite 连接器之前,请先完成以下任务:

  • 在您的 Google Cloud 项目中:
    • 确保已设置网络连接。如需了解网络模式,请参阅网络连接
    • 向配置连接器的用户授予 roles/connectors.admin IAM 角色。
    • 将以下 IAM 角色授予您要用其来使用连接器的服务账号:
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor

      服务账号是一种特殊类型的 Google 账号,用于表示需要验证身份并获得授权以访问 Google API 数据的非人类用户。如果您没有服务账号,则必须创建一个服务账号。如需了解详情,请参阅创建服务账号

    • 启用以下服务:
      • secretmanager.googleapis.com (Secret Manager API)
      • connectors.googleapis.com (Connectors API)

      如需了解如何启用服务,请参阅启用服务

    如果之前没有为您的项目启用这些服务或权限,则在您配置连接器时,系统会提示您启用。

配置连接器

一个连接需专用于一个数据源。这意味着,如果您有许多数据源,则必须为每个数据源创建单独的连接。如需创建连接,请执行以下操作:

  1. Cloud 控制台 中,进入 Integration Connectors > 连接页面,然后选择或创建一个 Google Cloud 项目。

    转到“连接”页面

  2. 点击 + 新建以打开创建连接页面。
  3. 位置部分中,选择连接的位置。
    1. 区域:从下拉列表中选择一个位置。

      连接器支持的区域包括:

      如需查看所有受支持区域的列表,请参阅位置

    2. 点击下一步
  4. 连接详情部分中,完成以下操作:
    1. 连接器:从可用连接器的下拉列表中选择 Netsuite
    2. 连接器版本:从可用版本的下拉列表中选择一个连接器版本。
    3. 连接名称字段中,输入连接实例的名称。

      连接名称必须符合以下条件:

      • 连接名称可以使用字母、数字或连字符。
      • 字母必须小写。
      • 连接名称必须以字母开头,以字母或数字结尾。
      • 连接名称不能超过 49 个字符。
    4. (可选)输入连接实例的说明
    5. 您可以选择启用 Cloud Logging,然后选择日志级别。默认情况下,日志级别设置为 Error
    6. 服务账号:选择具有所需角色的服务账号。
    7. (可选)配置连接节点设置

      • 节点数下限:输入连接节点数下限。
      • 节点数上限:输入连接节点数上限。

      节点是处理事务的连接单元(或副本)。 连接处理越多事务就需要越多节点,相反,处理越少事务需要越少节点。 如需了解节点如何影响连接器价格,请参阅连接节点的价格。如果未输入任何值,则默认情况下,节点数下限设置为 2(以便提高可用性),节点数上限设置为 50。

    8. 账号 ID:您的用户名在 NetSuite 上关联的公司账号。
    9. 汇总列模式:指明应如何处理汇总列。
    10. 应用 ID:从版本 2020.1 开始,向 NetSuite 发出请求需要应用 ID。
    11. 自定义字段权限:以英文逗号分隔的自定义字段权限列表。比 IncludeCustomFieldColumns 更易于控制。
    12. Include Child Tables(包含子表):一个布尔值,用于指示是否应显示子表。
    13. 包括自定义字段列:一个布尔值,用于指示是否要包含自定义字段列。
    14. Include Custom List Tables:一个布尔值,用于指示是否要使用基于自定义列表的表格。
    15. 包括自定义记录表:一个布尔值,用于指示是否要根据自定义记录类型使用表。
    16. Include Reference Columns(包含引用列):一个英文逗号分隔列表,表示从表示记录引用的字段检索数据时要包含的列。
    17. 并发会话数量上限:连接中可用的并发会话数量上限。
    18. Net Suite 日期格式:在 NetSuite 界面中设置的首选日期格式。
    19. Net Suite 长日期格式:在 NetSuite 界面中设置的首选长日期格式。
    20. Netsuite 元数据文件夹:用于从 NetSuite 下载元数据文件的目录的路径。请进行此设置,以获得最佳性能。
    21. 将双精度数报告为小数:指示是否应将双精度数报告为小数。
    22. 请求记忆的交易:一个布尔值,表示您是否希望在从 NetSuite 检索交易时请求记忆的交易。
    23. 角色 ID:RoleId 是将用于登录 NetSuite 的角色的 InternalId。留空以使用用户的默认角色。
    24. 架构:要使用的架构类型。您可以选择以下任意一个值:
      • SuiteTalk - 适用于基于 SOAP 的连接。
      • SuiteSQL - 适用于基于 REST 的连接。
    25. Use Async Services(使用异步服务):一个布尔值,表示您是否要在插入、更新和删除时使用异步服务。
    26. 使用内部名称进行自定义:一个布尔值,用于指示您是否要使用内部名称进行自定义。
    27. 使用更新/插入:一个布尔值,表示您是否希望在使用插入操作时执行更新/插入。
    28. 用户时区偏移量:您的用户时区偏移量,如在 NetSuite 偏好设置的“首页”->“偏好设置”->“时区”下所定义。例如:EST。
    29. 行扫描深度:动态确定表的列时要扫描的行数。
    30. 使用代理:选中此复选框可为连接配置代理服务器并配置以下值:
      • 代理身份验证方案:选择要通过代理服务器进行身份验证的身份验证类型。支持以下身份验证类型:
        • 基本:基本 HTTP 身份验证。
        • 摘要:摘要 HTTP 身份验证。
      • 代理用户:用于向代理服务器进行身份验证的用户名。
      • 代理密码:用户密码的 Secret Manager 密文。
      • 代理 SSL 类型:连接到代理服务器时使用的 SSL 类型。支持以下身份验证类型:
        • 自动:默认设置。如果网址是 HTTPS 网址,则使用“隧道”选项。如果网址是 HTTP 网址,则使用“永不”选项。
        • 始终:连接始终启用 SSL。
        • 永不:连接未启用 SSL。
        • 隧道:连接通过隧道代理建立。代理服务器会打开与远程主机的连接,并且流量会流经该代理。
      • 代理服务器部分中,输入代理服务器的详细信息。
        1. 点击+ 添加目标
        2. 选择目标类型
          • 主机地址:指定目标的主机名或 IP 地址。

            如果要与后端系统建立专用连接,请执行以下操作:

    31. (可选)点击 + 添加标签,以键值对的形式向连接添加标签。
    32. 点击下一步
  5. 目标部分中,输入要连接到的远程主机(后端系统)的详细信息。
    1. 目标类型:您可以将目标详细信息指定为主机地址或服务连接。选择以下任意目标类型:
      • 主机地址:如果要指定目标的主机名或 IP 地址。
      • 服务连接:如果要为内部 IP 地址指定专用端点。使用服务连接,您可以对外部网络隐藏内部 IP 地址。您可以使用 Private Service Connect 功能在 Google Cloud 中创建服务连接。如需了解如何配置 Private Service Connect,请参阅发布托管式服务

      根据您选择的目标类型,输入主机地址或服务连接名称。

      如需输入其他目标,请点击 + 添加目标

    2. 点击下一步
  6. 身份验证部分中,输入身份验证详细信息。
    1. 选择身份验证类型,然后输入相关详细信息。

      Netsuite 连接支持以下身份验证类型:

      • 用户名和密码
      • 基于令牌的身份验证
      • OAuth 2.0 身份验证代码授权
    2. 如需了解如何配置这些身份验证类型,请参阅配置身份验证

    3. 点击下一步
  7. 查看:查看您的连接和身份验证详细信息。
  8. 点击创建

配置身份验证

根据您要使用的身份验证输入详细信息。

  • 用户名和密码

    用户名和密码身份验证。此方法仅适用于 Netsuite 2020.2 或更低版本。

    • 用户名:连接器的用户名
    • 密码:包含与连接器关联的密码的 Secret Manager Secret。
  • 基于令牌的身份验证

    适用于 Netsuite 的基于令牌的身份验证。这既适用于 SuiteTalk 架构,也适用于 SuiteQL 架构。

    • OAuth 客户端 ID:创建应用时显示的使用方密钥。
    • OAuth 客户端密钥:包含应用创建时显示的使用方密钥的 Secret Manager 密文。
    • OAuth 访问令牌:创建访问令牌时的令牌 ID。
    • OAuth 访问令牌密钥:Secret Manager Secret,其中包含创建访问令牌时的令牌密钥。
  • OAuth 2.0 - 授权代码
  • 连接授权是通过基于 Web 的用户登录流程完成的。这仅适用于 SuiteQL 方案。

    • 客户端 ID:请求访问令牌时所用的客户端 ID。
    • 范围:以英文逗号分隔的所需范围列表。
    • 客户端密钥:请求访问令牌时所用的客户端密钥。

    对于 Authorization code 身份验证类型,在创建连接后,您应执行一些额外的步骤来配置身份验证。如需了解详情,请参阅创建连接后的其他步骤

创建连接后的其他步骤

如果您选择了 OAuth 2.0 - Authorization code 作为身份验证方法,则必须在创建连接后执行以下额外步骤:

  1. “连接”页面中,找到新创建的连接。

    请注意,新连接器的状态将为需要授权

  2. 点击需要授权

    系统随即会显示修改授权窗格。

  3. 重定向 URI 值复制到您的外部应用。
  4. 验证授权详细信息。
  5. 点击 Authorize(授权)。

    如果授权成功,“连接”页面中的连接状态将设为活跃

重新授权授权代码

如果您使用的是 Authorization code 身份验证类型,并且在后端 NetSuite 应用中进行了任何配置更改,则必须重新授权 NetSuite 连接。如需重新授权关联,请执行以下步骤:

  1. “连接”页面中,点击所需的连接。

    系统随即会打开连接详情页面。

  2. 点击修改以修改关联详情。
  3. 身份验证部分中,验证 OAuth 2.0 - 授权代码详细信息。

    根据需要进行必要的更改。

  4. 点击保存。您随即会进入连接详情页面。
  5. 点击身份验证部分中的修改授权。系统随即会显示 Authorize(授权)窗格。
  6. 点击 Authorize(授权)。

    如果授权成功,“连接”页面中的连接状态将设为活跃

配置 NetSuite

如需生成客户端 ID、客户端密钥、令牌 ID 和令牌密钥,请执行以下操作:

  1. 在 Netsuite 中创建新的集成。
  2. 提供集成详细信息(例如名称),并启用基于令牌的身份验证。
  3. 指定回调网址,例如 https:cloud.google.com/connectors/oauth?e=ApplicationIntegrationConnectorPaginatedFieldsLaunch%3A%3AApplicationIntegrationConnectorPaginatedFieldsEnabled&project=PROJECT_NAME
  4. 提交集成后,您将收到客户端 ID 和客户端密钥。保存这些详细信息。
  5. 设置集成用户记录
  6. 如需创建令牌和密钥,请前往首页,选择管理访问令牌,然后点击创建我的访问令牌。您将使用这些详细信息在 Google Cloud中创建基于令牌的身份验证。

如需了解如何设置 Postman,请参阅导入 Postman 集合

系统限制

Netsuite 连接器每个节点每秒可处理 1 笔交易,并会对超出此限制的所有交易进行节流。默认情况下,集成连接器会为连接分配 2 个节点(以提高可用性)。

如需了解适用于集成连接器的限制,请参阅限制

在集成中使用 NetSuite 连接

创建连接后,该连接将在 Apigee Integration 和 Application Integration 中可用。您可以通过连接器任务在集成中使用该连接。

  • 如需了解如何在 Apigee Integration 中创建和使用连接器任务,请参阅连接器任务
  • 如需了解如何在 Application Integration 中创建和使用连接器任务,请参阅连接器任务

实体操作示例

本部分列出了 Netsuite 连接器支持的实体操作,并介绍了如何在此连接器中执行一些实体操作

实体 支持的操作
CreditMemo LIST、GET、CREATE、UPDATE
客户 LIST、GET、CREATE、UPDATE
CustomerPayment LIST、GET、CREATE、UPDATE
商品履单 LIST、GET、CREATE
JournalEntry LIST、GET、CREATE
PurchaseOrder LIST、GET、CREATE、UPDATE
ReturnAuthorization LIST、GET、CREATE
SalesOrder LIST、GET、CREATE、UPDATE
供应商 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
员工 LIST、GET
估算 LIST、GET
文件 LIST、GET
InventoryAdjustment LIST、GET、CREATE
产品目录项 LIST、GET
ItemReceipt LIST、GET
机会 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
分箱 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 创建
Invoice_itemList 创建
PurchaseOrder_itemList 创建
SalesOrder_itemList 创建
VendorBill_itemList 创建
VendorCredit_itemList 创建
VendorPayment_applyList 创建

在 NetSuite 中执行插入操作时,如果未指定所有必要字段和数据,与实体对应的 API 会拒绝请求。这会导致异常。异常可能会因插入操作中使用的实体而异。您必须在查询中提供 NetSuite 订单项,才能成功插入数据。您可以通过所有父级表中提供的 ItemListAggregate 字段指定订单项。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>`;"
  

示例 - 列出所有贷记通知单

  1. Configure connector task 对话框中,点击 Entities
  2. Entity 列表中选择 CreditMemo
  3. 选择 List 操作,然后点击完成
  4. 您还可以在连接器任务的任务输入部分中,通过指定过滤条件子句来过滤结果集。 请务必使用英文单引号 (') 指定过滤条件子句值。

示例 - 获取 CreditMemo 记录

  1. Configure connector task 对话框中,点击 Entities
  2. Entity 列表中选择“CreditMemo”。
  3. 选择 GET 操作,然后点击完成
  4. 将实体 ID 设置为 1083723,即要传递的键。如需设置实体 ID,请在数据映射数据映射器部分,点击打开数据映射编辑器,然后在输入值字段中输入 1083723,并选择 EntityId 作为本地变量。

    直接传递实体 ID。如果存在复合键,传递实体 ID 可能会抛出错误。在这种情况下,请使用过滤条件子句指定 ID。

示例 - 创建 PurchaseOrder 记录

  1. Configure connector task 对话框中,点击 Entities
  2. Entity 列表中选择 PurchaseOrder。
  3. 选择 Create 操作,然后点击完成
  4. 数据映射任务的数据映射器部分,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为本地变量。
    {
              "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"
          }

    如果集成成功,PurchaseOrder 任务的 connectorOutputPayload 响应参数的值将类似于以下内容:

     {
        "InternalId": "1093053"
      } 
      

示例 - 创建 ReturnAuthorization 记录

  1. Configure connector task 对话框中,点击 Entities
  2. Entity 列表中选择 ReturnAuthorization。
  3. 选择 Create 操作,然后点击完成
  4. 数据映射任务的数据映射器部分,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为本地变量。
    {
              "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>" + "
          }

    如果集成成功,ReturnAuthorization 任务的 connectorOutputPayload 响应参数的值将类似于以下内容:

     {
        "InternalId": "1093053"
      } 
      

示例 - 创建 SalesOrder 记录

  1. Configure connector task 对话框中,点击 Entities
  2. Entity 列表中选择 SalesOrder。
  3. 选择 Create 操作,然后点击完成
  4. 数据映射任务的数据映射器部分,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为本地变量。
    {
              " + "<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"
          }

    如果集成成功,SalesOrder 任务的 connectorOutputPayload 响应参数的值将类似于以下内容:

     {
        "InternalId": "1093053"
      } 
      

示例 - 创建 CreditMemo_itemList 记录

  1. Configure connector task 对话框中,点击 Entities
  2. Entity 列表中选择 CreditMemo_itemList。
  3. 选择 Create 操作,然后点击完成
  4. 数据映射任务的数据映射器部分,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为本地变量。
    {
        "ItemList_Item_InternalId": "945",
        "Entity_InternalId": "1709",
        "Location_InternalId": "5",
        "ItemList_Amount": 7777777.0,
        "ItemList_Description": "Created"
      }
      

    如果集成成功,CreditMemo_itemList 任务的 connectorOutputPayload 响应参数的值将类似于以下内容:

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

示例 - 创建“客户”记录

  1. Configure connector task 对话框中,点击 Entities
  2. Entity 列表中选择“客户”。
  3. 选择 Create 操作,然后点击完成
  4. 数据映射任务的数据映射器部分,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为本地变量。
     {
        "CompanyName": "Bcone8",
        "Email": "222larabrown@gmail.com"
      }
      

    如果集成成功,Customer 任务的 connectorOutputPayload 响应参数的值将类似于以下内容:

    {
        "InternalId": "4767"
      } 
      

示例 - 创建 Invoice_itemList 记录

  1. Configure connector task 对话框中,点击 Entities
  2. Entity 列表中选择 Invoice_itemList。
  3. 选择 Create 操作,然后点击完成
  4. 数据映射任务的数据映射器部分,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为本地变量。
     {
        "ItemList_Item_InternalId": "945",
        "Entity_InternalId": "1709",
        "ItemList_Amount": 945.0,
        "Item": "InvoiceItem"
      }
      

    如果集成成功,Invoice_itemList 任务的 connectorOutputPayload 响应参数的值将类似于以下内容:

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

示例 - 创建 CustomerPayment 记录

  1. Configure connector task 对话框中,点击 Entities
  2. Entity 列表中选择 CustomerPayment。
  3. 选择 Create 操作,然后点击完成
  4. 数据映射任务的数据映射器部分,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为本地变量。
     {
        "Customer_InternalId": "1714",
        "Payment": 9999.0
      } 
      

    如果集成成功,CustomerPayment 任务的 connectorOutputPayload 响应参数的值将类似于以下内容:

     {
        "InternalId": "1090749"
      } 
      

示例 - 创建 PurchaseOrder_itemList 记录

  1. Configure connector task 对话框中,点击 Entities
  2. Entity 列表中选择 PurchaseOrder_itemList。
  3. 选择 Create 操作,然后点击完成
  4. 数据映射任务的数据映射器部分,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为本地变量。
     {
        "Entity_InternalId": "2041",
        "Location_InternalId": "6",
        "ItemList_Description": "Created on Jan 11",
        "ItemList_Item_InternalId": "979"
      } 
      

    如果集成成功,PurchaseOrder_itemList 任务的 connectorOutputPayload 响应参数的值将类似于以下内容:

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

示例 - 创建 SalesOrder_itemList 记录

  1. Configure connector task 对话框中,点击 Entities
  2. Entity 列表中选择 SalesOrder_itemList。
  3. 选择 Create 操作,然后点击完成
  4. 数据映射任务的数据映射器部分,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为本地变量。
     {
        "Email": "222larabrown@gmail.com",
        "Entity_InternalId": "1709",
        "ItemList_Item_InternalId": "945",
        "ItemList_Amount": 1000.0
      }
      

    如果集成成功,SalesOrder_itemList 任务的 connectorOutputPayload 响应参数的值将类似于以下内容:

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

示例 - 创建供应商记录

  1. Configure connector task 对话框中,点击 Entities
  2. Entity 列表中选择“供应商”。
  3. 选择 Create 操作,然后点击完成
  4. 数据映射任务的数据映射器部分,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为本地变量。
     {
        "CompanyName": "Deloitte",
        "LegalName": "AU Vendor"
      } 
      

    如果集成成功,Vendor 任务的 connectorOutputPayload 响应参数的值将类似于以下内容:

     {
        "InternalId": "5067"
      }  
      

示例 - 创建 VendorBill_itemList 记录

  1. Configure connector task 对话框中,点击 Entities
  2. Entity 列表中选择 VendorBill_itemList。
  3. 选择 Create 操作,然后点击完成
  4. 数据映射任务的数据映射器部分,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为本地变量。
     {
        "Entity_InternalId": "2041",
        "ItemList_Item_InternalId": "1374",
        "ItemList_Amount": 700.0
      } 
      

    如果集成成功,VendorBill_itemList 任务的 connectorOutputPayload 响应参数的值将类似于以下内容:

     {
        "InternalId": "5067"
      }  
      

示例 - 创建 VendorCredit_itemList 记录

  1. Configure connector task 对话框中,点击 Entities
  2. Entity 列表中选择 VendorCredit_itemList。
  3. 选择 Create 操作,然后点击完成
  4. 数据映射任务的数据映射器部分,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为本地变量。
     {
        "Entity_InternalId": "2041",
        "Location_InternalId": "6",
        "ItemList_Item_InternalId": "992",
        "ItemList_Description": "Created on Jan 12"
      }
      

    如果集成成功,VendorCredit_itemList 任务的 connectorOutputPayload 响应参数的值将类似于以下内容:

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

示例 - 创建 VendorPayment_applyList 记录

  1. Configure connector task 对话框中,点击 Entities
  2. Entity 列表中选择 VendorPayment_applyList。
  3. 选择 Create 操作,然后点击完成
  4. 数据映射任务的数据映射器部分,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为本地变量。
     {
        "ApplyList_Doc": 3339.0,
        "ApplyList_Apply": true,
        "Entity_InternalId": "1471"
      }
      

    如果集成成功,VendorPayment_applyList 任务的 connectorOutputPayload 响应参数的值将类似于以下内容:

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

示例 - 创建 CreditMemo 记录

  1. Configure connector task 对话框中,点击 Entities
  2. Entity 列表中选择“CreditMemo”。
  3. 选择 Create 操作,然后点击完成
  4. 数据映射任务的数据映射器部分,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为本地变量。
    {
              "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"
          }

    如果集成成功,CreditMemo 任务的 connectorOutputPayload 响应参数的值将类似于以下内容:

    {
        "InternalId": "106"
      }
      

示例 - 创建账单记录

  1. Configure connector task 对话框中,点击 Entities
  2. Entity 列表中选择“账单”。
  3. 选择 Create 操作,然后点击完成
  4. 数据映射任务的数据映射器部分,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为本地变量。
    {
              "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"
          }

    如果集成成功,Invoice 任务的 connectorOutputPayload 响应参数的值将类似于以下内容:

    {
        "InternalId": "206"
      }
      

示例 - 创建 ItemFulfillment 记录

  1. Configure connector task 对话框中,点击 Entities
  2. Entity 列表中选择“ItemFulfillment”。
  3. 选择 Create 操作,然后点击完成
  4. 数据映射任务的数据映射器部分,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为本地变量。
    {
        "CreatedFrom_InternalId": "411",
        "ShipStatus": "_picked"
      } 
      

    如果集成成功,ItemFulfillment 任务的 connectorOutputPayload 响应参数的值将类似于以下内容:

    {
        "InternalId": "412"
      }
      

示例 - 创建 JournalEntry 记录

  1. Configure connector task 对话框中,点击 Entities
  2. Entity 列表中选择 JournalEntry。
  3. 选择 Create 操作,然后点击完成
  4. 数据映射任务的数据映射器部分,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为本地变量。
    {
              "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>" + "
          }

    如果集成成功,JournalEntry 任务的 connectorOutputPayload 响应参数的值将类似于以下内容:

    {
        "InternalId": "612"
      }
      

示例 - 创建 PurchaseOrder 记录

  1. Configure connector task 对话框中,点击 Entities
  2. Entity 列表中选择 PurchaseOrder。
  3. 选择 Create 操作,然后点击完成
  4. 数据映射任务的数据映射器部分,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为本地变量。
    {
              "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"
          }

    如果集成成功,PurchaseOrder 任务的 connectorOutputPayload 响应参数的值将类似于以下内容:

    {
        "InternalId": "1116228"
      }
      

示例 - 创建 VendorBill 记录

  1. Configure connector task 对话框中,点击 Entities
  2. Entity 列表中选择 VendorBill。
  3. 选择 Create 操作,然后点击完成
  4. 数据映射任务的数据映射器部分,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为本地变量。
      {"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>;" + "}

    如果集成成功,VendorBill 任务的 connectorOutputPayload 响应参数的值将类似于以下内容:

    {
        "InternalId": "816"
      }
      

示例 - 创建 VendorCredit 记录

  1. Configure connector task 对话框中,点击 Entities
  2. Entity 列表中选择 VendorCredit。
  3. 选择 Create 操作,然后点击完成
  4. 数据映射任务的数据映射器部分,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为本地变量。
    {"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>;" + "}

    如果集成成功,VendorCredit 任务的 connectorOutputPayload 响应参数的值将类似于以下内容:

    {
        "InternalId": "818"
      }
      

示例 - 创建 VendorPayment 记录

  1. Configure connector task 对话框中,点击 Entities
  2. Entity 列表中选择 VendorPayment。
  3. 选择 Create 操作,然后点击完成
  4. 数据映射任务的数据映射器部分,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为本地变量。
    {
        "Entity_InternalId": "12",
        "ApplyList_Apply": true,
        "ApplyList_Doc": 714.0
      }       
      

    如果集成成功,VendorPayment 任务的 connectorOutputPayload 响应参数的值将类似于以下内容:

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

示例 - 创建 TRANSFERORDER 记录

  1. Configure connector task 对话框中,点击 Entities
  2. Entity 列表中选择 TRANSFERORDER。
  3. 选择 Create 操作,然后点击完成
  4. 数据映射任务的数据映射器部分,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为本地变量。
    {
      "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>;"
      }
      

    如果集成成功,TRANSFERORDER 任务的 connectorOutputPayload 响应参数的值将类似于以下内容:

    {
      "InternalId": "1337"
      } 
      

示例 - 创建 CashSale 记录

  1. Configure connector task 对话框中,点击 Entities
  2. Entity 列表中选择“CashSale”。
  3. 选择 Create 操作,然后点击完成
  4. 数据映射任务的数据映射器部分,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为本地变量。
    {
      "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>;"
      }
      

    如果集成成功,CashSale 任务的 connectorOutputPayload 响应参数的值将类似于以下内容:

    {
      "InternalId": "1234"
      } 
      

示例 - 创建 PaycheckJournal 记录

  1. Configure connector task 对话框中,点击 Entities
  2. Entity 列表中选择“PaycheckJournal”。
  3. 选择 Create 操作,然后点击完成
  4. 数据映射任务的数据映射器部分,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为本地变量。
    {
      "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>;"
      }
      

    如果集成成功,PaycheckJournal 任务的 connectorOutputPayload 响应参数的值将类似于以下内容:

    {
      "InternalId": "1746"
      } 
      

示例 - 创建 InventoryAdjustment 记录

  1. Configure connector task 对话框中,点击 Entities
  2. Entity 列表中选择 InventoryAdjustment。
  3. 选择 Create 操作,然后点击完成
  4. 数据映射任务的数据映射器部分,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为本地变量。
    {
      "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>;"
      }
      

    如果集成成功,InventoryAdjustment 任务的 connectorOutputPayload 响应参数的值将类似于以下内容:

    {
      "InternalId": "1640"
      } 
      

示例 - 创建 CashRefund 记录

  1. Configure connector task 对话框中,点击 Entities
  2. Entity 列表中选择 CashRefund。
  3. 选择 Create 操作,然后点击完成
  4. 数据映射任务的数据映射器部分,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload 作为本地变量。
    {
      "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>;"
      }
      

    如果集成成功,CashRefund 任务的 connectorOutputPayload 响应参数的值将类似于以下内容:

    {
      "InternalId": "1232"
      } 
      

示例 - 更新 CreditMemo 记录

  1. Configure connector task 对话框中,点击 Entities
  2. Entity 列表中选择“CreditMemo”。
  3. 选择 Update 操作,然后点击完成
  4. 数据映射任务的数据映射器部分,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload/FilterClause 作为“本地变量”。
    {
        "Email2": "222larabrown@gmail.com"
      } 
      
  5. 将数据映射器中的实体 ID 设置为贷记通知单的实体。如需设置实体 ID,请点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload/FilterClause 作为本地变量。

    或者,您也可以将 filterClause 设置为 1090651,而不是指定 entityId

    运行此示例会在连接器任务的 connectorOutputPayload 输出变量中返回类似于以下内容的响应:

     {
        "InternalId": "1090651"
      } 
      

示例 - 更新“客户”记录

  1. Configure connector task 对话框中,点击 Entities
  2. Entity 列表中选择“客户”。
  3. 选择 Update 操作,然后点击完成
  4. 数据映射任务的数据映射器部分,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload/FilterClause 作为“本地变量”。
     {
        "Email": "222larabrown@gmail.com"
      } 
      
  5. 将数据映射器中的实体 ID 设置为客户的实体。如需设置实体 ID,请点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload/FilterClause 作为本地变量。

    或者,您也可以将 filterClause 设置为 4767,而不是指定 entityId

    运行此示例会在连接器任务的 connectorOutputPayload 输出变量中返回类似于以下内容的响应:

     {
        "InternalId": "4767"
      } 
      

示例 - 更新账单记录

  1. Configure connector task 对话框中,点击 Entities
  2. Entity 列表中选择“账单”。
  3. 选择 Update 操作,然后点击完成
  4. 数据映射任务的数据映射器部分,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload/FilterClause 作为“本地变量”。
      {
        "Email2": "222larabrown@gmail.com"
      } 
      
  5. 将数据映射器中的实体 ID 设置为账单的实体。如需设置实体 ID,请点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload/FilterClause 作为本地变量。

    或者,您也可以将 filterClause 设置为 1083927,而不是指定 entityId

    运行此示例会在连接器任务的 connectorOutputPayload 输出变量中返回类似于以下内容的响应:

     {
        "InternalId": "1083927"
      } 
      

示例 - 更新 CustomerPayment 记录

  1. Configure connector task 对话框中,点击 Entities
  2. Entity 列表中选择 CustomerPayment。
  3. 选择 Update 操作,然后点击完成
  4. 数据映射任务的数据映射器部分,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload/FilterClause 作为“本地变量”。
     {
        "Customer_InternalId": "1714",
        "Payment": 7.77777777E8
      } 
      
  5. 将数据映射器中的实体 ID 设置为 CustomerPayment 的实体。如需设置实体 ID,请点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload/FilterClause 作为本地变量。

    或者,您也可以将 filterClause 设置为 1090749,而不是指定 entityId

    运行此示例会在连接器任务的 connectorOutputPayload 输出变量中返回类似于以下内容的响应:

     {
        "InternalId": "1090749"
      } 
      

示例 - 更新 PurchaseOrder 记录

  1. Configure connector task 对话框中,点击 Entities
  2. Entity 列表中选择 PurchaseOrder。
  3. 选择 Update 操作,然后点击完成
  4. 数据映射任务的数据映射器部分,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload/FilterClause 作为“本地变量”。
     {
        "Message": "Aspirin Updated"
      } 
      
  5. 将数据映射器中的实体 ID 设置为 PurchaseOrder 的实体。如需设置实体 ID,请点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload/FilterClause 作为本地变量。

    或者,您也可以将 filterClause 设置为 1000,而不是指定 entityId

    运行此示例会在连接器任务的 connectorOutputPayload 输出变量中返回类似于以下内容的响应:

     {
        "InternalId": "1000"
      } 
      

示例 - 更新 SalesOrder 记录

  1. Configure connector task 对话框中,点击 Entities
  2. Entity 列表中选择 PurchaseOrder。
  3. 选择 Update 操作,然后点击完成
  4. 数据映射任务的数据映射器部分,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload/FilterClause 作为“本地变量”。
     {
        "Email": "222larabrown@gmail.com",
        "Entity_InternalId": "1709",
        "Item_InternalId": "945"
      }
      
  5. 将数据映射器中的实体 ID 设置为 SalesOrder 的实体。如需设置实体 ID,请点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload/FilterClause 作为本地变量。

    或者,您也可以将 filterClause 设置为 1086949,而不是指定 entityId

    运行此示例会在连接器任务的 connectorOutputPayload 输出变量中返回类似于以下内容的响应:

     {
        "InternalId": "1086949"
      } 
      

示例 - 更新供应商记录

  1. Configure connector task 对话框中,点击 Entities
  2. Entity 列表中选择“供应商”。
  3. 选择 Update 操作,然后点击完成
  4. 数据映射任务的数据映射器部分,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload/FilterClause 作为“本地变量”。
     {
        "CompanyName": "Deloitte_Updated"
      } 
      
  5. 将数据映射器中的实体 ID 设置为供应商的实体。如需设置实体 ID,请点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload/FilterClause 作为本地变量。

    或者,您也可以将 filterClause 设置为 4567,而不是指定 entityId

    运行此示例会在连接器任务的 connectorOutputPayload 输出变量中返回类似于以下内容的响应:

     {
        "InternalId": "4567"
      } 
      

示例 - 更新 VendorBill 记录

  1. Configure connector task 对话框中,点击 Entities
  2. Entity 列表中选择 VendorBill。
  3. 选择 Update 操作,然后点击完成
  4. 数据映射任务的数据映射器部分,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload/FilterClause 作为“本地变量”。
      {
        "Memo": "Memo_Jan 11"
      } 
      
  5. 将数据映射器中的实体 ID 设置为 VendorBill 的实体。如需设置实体 ID,请点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload/FilterClause 作为本地变量。

    或者,您也可以将 filterClause 设置为 3339,而不是指定 entityId

    运行此示例会在连接器任务的 connectorOutputPayload 输出变量中返回类似于以下内容的响应:

     {
        "InternalId": "3339"
      } 
      

示例 - 更新 VendorCredit 记录

  1. Configure connector task 对话框中,点击 Entities
  2. Entity 列表中选择 VendorCredit。
  3. 选择 Update 操作,然后点击完成
  4. 数据映射任务的数据映射器部分,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload/FilterClause 作为“本地变量”。
     {
        "Memo": "16253"
      } 
      
  5. 将数据映射器中的实体 ID 设置为 VendorCredit 的实体。如需设置实体 ID,请点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload/FilterClause 作为本地变量。

    或者,您也可以将 filterClause 设置为 1091549,而不是指定 entityId

    运行此示例会在连接器任务的 connectorOutputPayload 输出变量中返回类似于以下内容的响应:

     {
        "InternalId": "1091549"
      } 
      

示例 - 更新 VendorPayment 记录

  1. Configure connector task 对话框中,点击 Entities
  2. Entity 列表中选择 VendorPayment。
  3. 选择 Update 操作,然后点击完成
  4. 数据映射任务的数据映射器部分,点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload/FilterClause 作为“本地变量”。
      {
        "Memo": "Jan8"
      } 
      
  5. 将数据映射器中的实体 ID 设置为 VendorPayment 的实体。如需设置实体 ID,请点击 Open Data Mapping Editor,然后在 Input Value 字段中输入类似于以下内容的值,并选择 EntityId/ConnectorInputPayload/FilterClause 作为本地变量。

    或者,您也可以将 filterClause 设置为 1082627,而不是指定 entityId

    运行此示例会在连接器任务的 connectorOutputPayload 输出变量中返回类似于以下内容的响应:

     {
        "InternalId": "1082627"
      } 
      

使用 Terraform 创建连接

您可以使用 Terraform 资源创建新的连接。

如需了解如何应用或移除 Terraform 配置,请参阅基本 Terraform 命令

如需查看用于创建连接的 Terraform 模板示例,请参阅模板示例

使用 Terraform 创建此连接时,您必须在 Terraform 配置文件中设置以下变量:

参数名称 数据类型 必需 说明
account_id STRING True 您的用户名在 NetSuite 上关联的公司账号。
aggregate_column_mode STRING 错误 指明应如何处理汇总列。
application_id STRING 错误 从版本 2020.1 开始,向 NetSuite 发出的请求需要提供应用 ID。
custom_field_permissions STRING 错误 以英文逗号分隔的自定义字段权限列表。比 IncludeCustomFieldColumns 更易于控制。
include_child_tables BOOLEAN 错误 一个布尔值,指示是否应显示子表。
include_custom_field_columns BOOLEAN 错误 一个布尔值,用于指示是否要添加自定义字段列。
include_custom_list_tables BOOLEAN 错误 一个布尔值,指示您是否希望使用基于自定义列表的表格。
include_custom_record_tables BOOLEAN 错误 一个布尔值,指示您是否希望根据自定义记录类型使用表格。
include_reference_columns STRING 错误 一个英文逗号分隔列表,表示从表示记录引用的字段检索数据时要包含的列。
maximum_concurrent_sessions INTEGER 错误 可在连接中使用的并发会话数量上限。
net_suite_date_format STRING 错误 在 NetSuite 界面中设置的首选日期格式。
net_suite_long_date_format STRING 错误 在 NetSuite 界面中设置的首选长日期格式。
netsuite_metadata_folder STRING 错误 用于从 NetSuite 下载元数据文件的目录的路径。请进行此设置,以获得最佳性能。
report_doubles_as_decimal BOOLEAN 错误 指明是否应将双精度数报告为小数。
request_memorized_transactions BOOLEAN 错误 一个布尔值,指示您是否希望在从 NetSuite 检索交易时请求记忆的交易。
role_id STRING 错误 RoleId 是将用于登录 NetSuite 的角色的 InternalId。留空以使用用户的默认角色。
架构 STRING True 要使用的架构类型。
use_async_services BOOLEAN 错误 一个布尔值,用于指明您是否要在插入、更新和删除时使用异步服务。
use_internal_names_for_customizations BOOLEAN 错误 一个布尔值,用于指明您是否想使用内部名称进行自定义。
use_upserts BOOLEAN 错误 一个布尔值,表示您是否希望在使用插入操作时执行更新/插入操作。
user_timezone_offset STRING 错误 您的用户时区偏移,如在 NetSuite 偏好设置的“首页”->“偏好设置”->“时区”下所定义。例如:EST.
row_scan_depth STRING 错误 在动态确定表的列时要扫描的行数。
详细程度 STRING 错误 连接的详细程度级别,介于 1 到 5 之间。详细级别越高,系统会记录的通信详细信息(请求、响应和 SSL 证书)就越多。
proxy_enabled BOOLEAN 错误 选中此复选框可为连接配置代理服务器。
proxy_auth_scheme ENUM 错误 用于向 ProxyServer 代理进行身份验证的身份验证类型。支持的值包括:BASIC、DIGEST、NONE
proxy_user STRING 错误 用于向 ProxyServer 代理进行身份验证的用户名。
proxy_password SECRET 错误 用于向 ProxyServer 代理进行身份验证的密码。
proxy_ssltype ENUM 错误 连接到 ProxyServer 代理时使用的 SSL 类型。支持的值包括:AUTO、ALWAYS、NEVER、TUNNEL

向 Google Cloud 社区寻求帮助

您可以在 Google Cloud 社区的 Cloud 论坛中发布您的问题以及讨论此连接器。

后续步骤