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」>「Connections」頁面,然後選取或建立 Google Cloud 專案。

    前往「連線」頁面

  2. 按一下「+ 建立新項目」開啟「建立連線」頁面。
  3. 在「位置」部分中,選擇連線位置。
    1. 區域:從下拉式清單中選取位置。

      連接器支援的地區包括:

      如需所有支援的地區清單,請參閱「位置」一文。

    2. 點選「下一步」
  4. 在「連線詳細資料」部分,完成下列步驟:
    1. 連接器:從可用連接器的下拉式清單中選取「Netsuite」
    2. 連接器版本:從可用版本的下拉式清單中選取連接器版本。
    3. 在「連線名稱」欄位中,輸入連線執行個體的名稱。

      連線名稱必須符合下列條件:

      • 連線名稱可使用英文字母、數字或連字號。
      • 字母必須為小寫。
      • 連線名稱開頭須為英文字母,結尾則須為英文字母或數字。
      • 連結名稱不得超過 49 個字元。
    4. 視需要輸入連線執行個體的「Description」(說明)
    5. 或者,可啟用 Cloud Logging,然後選取記錄層級。記錄層級預設為 Error
    6. 服務帳戶:選取具備必要角色的服務帳戶。
    7. 視需要設定「連線節點設定」

      • 節點數量下限:輸入連線節點數量下限。
      • 節點數量上限:輸入連線節點數量上限。

      節點是用來處理交易的連線單位 (或備用資源)。連線處理的交易量越多,就需要越多節點;反之,處理的交易量越少,需要的節點就越少。如要瞭解節點對連接器定價的影響,請參閱「 連線節點定價」。如未輸入任何值,系統預設會將節點下限設為 2 (提高可用性),節點上限則設為 50。

    8. 帳戶 ID:使用者名稱在 NetSuite 中關聯的公司帳戶。
    9. 匯總資料欄模式:指出匯總資料欄的處理方式。
    10. 應用程式 ID:自 2020.1 版起,對 NetSuite 的要求必須包含應用程式 ID。
    11. 自訂欄位權限:以半形逗號分隔的自訂欄位權限清單。與 IncludeCustomFieldColumns 相比,可提供更多控制選項。
    12. 包含子項資料表:布林值,指出是否應顯示子項資料表。
    13. Include Custom Field Columns:布林值,指出是否要納入自訂欄位資料欄。
    14. Include Custom List Tables:布林值,指出是否要使用以自訂清單為準的表格。
    15. 包含自訂記錄表格:布林值,指出是否要使用以自訂記錄類型為基礎的表格。
    16. 包含參照資料欄:以逗號分隔的清單,代表從記錄參照欄位擷取資料時要納入的資料欄。
    17. 並行工作階段數量上限:連線可使用的並行工作階段數量上限。
    18. NetSuite 日期格式:在 NetSuite UI 中設定的偏好日期格式。
    19. NetSuite 長日期格式:在 NetSuite 使用者介面中設定的偏好長日期格式。
    20. Netsuite Metadata Folder:從 NetSuite 下載中繼資料檔案的目錄路徑。建議您設定這個值,以獲得最佳成效。
    21. 將 Double 回報為 Decimal:指出是否應將 Double 回報為 Decimal。
    22. 要求記憶交易:布林值,指出從 NetSuite 擷取交易時,是否要要求記憶交易。
    23. 角色 ID:RoleId 是用來登入 NetSuite 的角色 InternalId。如要使用者的預設角色,請留空。
    24. 結構定義:要使用的結構定義類型。你可以選取下列任一值:
      • SuiteTalk - 適用於以 SOAP 為基礎的連線。
      • SuiteSQL - 適用於以 REST 為基礎的連線。
    25. 使用非同步服務:布林值,指出您是否要在插入、更新及刪除時使用非同步服務。
    26. 使用自訂項目的內部名稱:布林值,指出是否要使用自訂項目的內部名稱。
    27. 使用 Upsert:布林值,指出使用插入作業時是否要執行 upsert。
    28. 使用者時區偏移:使用者時區偏移,定義於 NetSuite 偏好設定的「首頁」-->「偏好設定」-->「時區」。例如:美國東部標準時間。
    29. 資料列掃描深度:動態決定表格的資料欄時,要掃描的資料列數量。
    30. (選用) 在「進階設定」部分,選取「使用 Proxy」核取方塊,為連線設定 Proxy 伺服器,並設定下列值:
      • Proxy 驗證機制:選取與 Proxy 伺服器進行驗證的驗證類型。系統支援下列驗證類型:
        • 基本:基本 HTTP 驗證。
        • 摘要:摘要 HTTP 驗證。
      • Proxy 使用者:用於向 Proxy 伺服器驗證的使用者名稱。
      • Proxy Password:使用者的密碼 Secret Manager 密鑰。
      • Proxy SSL Type:連線至 Proxy 伺服器時要使用的 SSL 類型。系統支援下列驗證類型:
        • 自動:預設設定。如果網址是 HTTPS 網址,則會使用「通道」選項。如果網址是 HTTP 網址,系統會使用「永不」選項。
        • 一律:連線一律啟用 SSL。
        • 從未:連線未啟用 SSL。
        • 通道:連線是透過通道 Proxy 建立。Proxy 伺服器會開啟與遠端主機的連線,流量則會透過 Proxy 來回傳輸。
      • 在「Proxy 伺服器」部分中,輸入 Proxy 伺服器的詳細資料。
        1. 按一下「+ 新增目的地」
        2. 選取「目的地類型」
          • 主機位址:指定目的地的主機名稱或 IP 位址。

            如要與後端系統建立私人連線,請按照下列步驟操作:

    31. (選用) 按一下「+ 新增標籤」,以鍵/值組合的形式為連線新增標籤。
    32. 點選「下一步」
  5. 在「目的地」部分,輸入要連線的遠端主機 (後端系統) 詳細資料。
    1. 目的地類型:您可以將目的地詳細資料指定為主機位址或服務附件。選取下列任一目的地類型:
      • 主機位址:如要指定目的地的主機名稱或 IP 位址。
      • 服務連結:如要為內部 IP 位址指定私人端點,請選取這個選項。服務連結可讓您對外部網路隱藏內部 IP 位址。您可以使用 Private Service Connect 功能,在 Google Cloud 中建立服務連結。如要瞭解如何設定 Private Service Connect,請參閱「發布代管服務」。

      根據您選取的目的地類型,輸入主機地址或服務連結名稱。

      如要輸入其他目的地,請按一下「+新增目的地」

    2. 點選「下一步」
  6. 在「Authentication」(驗證) 部分中,輸入驗證詳細資料。
    1. 選取「驗證類型」並輸入相關詳細資料。

      Netsuite 連線支援下列驗證類型:

      • 使用者名稱和密碼
      • 權杖式驗證
      • OAuth 2.0 授權碼授權
    2. 如要瞭解如何設定這些驗證類型,請參閱「設定驗證」。

    3. 點選「下一步」
  7. 檢查:檢查連線和驗證詳細資料。
  8. 點選「建立」

設定驗證機制

根據要使用的驗證方式輸入詳細資料。

  • 使用者名稱和密碼

    使用者名稱和密碼驗證。這僅適用於 NetSuite 2020.2 或更舊版本。

    • 使用者名稱:連接器的使用者名稱
    • 密碼:Secret Manager 密鑰,內含與連接器相關聯的密碼。
  • 以權杖為基礎的驗證

    Netsuite 的權杖式驗證。這可用於 SuiteTalkSuiteQL 配置。

    • OAuth 用戶端 ID:建立應用程式時顯示的消費者金鑰。
    • OAuth 用戶端密鑰:Secret Manager 密鑰,內含建立應用程式時顯示的消費者密鑰。
    • OAuth 存取權杖:建立存取權杖時的權杖 ID。
    • OAuth 存取權杖密鑰:Secret Manager 密鑰,內含建立存取權杖時的權杖密鑰。
  • OAuth 2.0 - 授權碼
  • 連線授權是透過網頁版使用者登入流程完成。這項設定僅適用於 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 筆交易, 每個節點每秒可處理 1 筆交易, 超過此限制的交易都會遭到節流。根據預設,Integration Connectors 會為連線分配 2 個節點 (以提高可用性)。

如要瞭解 Integration Connectors 適用的限制,請參閱「限制」一文。

在整合中建立 NetSuite 連線

建立連線後,Apigee Integration 和 Application Integration 都會提供該連線。您可以在整合中透過「連線器」工作使用連線。

  • 如要瞭解如何在 Apigee Integration 中建立及使用「連線器」工作,請參閱「連線器工作」。
  • 如要瞭解如何在 Application Integration 中建立及使用「連線器」工作,請參閱「連線器工作」。

實體作業範例

本節列出 NetSuite 連接器支援的實體作業,並說明如何在這個連接器中執行部分實體作業

實體 支援的作業
CreditMemo LIST、GET、CREATE、UPDATE
客戶 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
供應商 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
InventoryItem 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 設為 CreditMemo 的實體。如要設定實體 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 使用者名稱在 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 UI 中設定的偏好日期格式。
net_suite_long_date_format STRING 在 NetSuite UI 中設定的偏好長日期格式。
netsuite_metadata_folder STRING 從 NetSuite 下載中繼資料檔案的目錄路徑。建議您設定這個值,以獲得最佳成效。
report_doubles_as_decimal BOOLEAN 指出是否應將倍數回報為十進位。
request_memorized_transactions BOOLEAN 布林值,指出從 NetSuite 擷取交易時,是否要要求系統記住交易。
role_id STRING RoleId 是用來登入 NetSuite 的角色 InternalId。如要使用者的預設角色,請留空。
結構定義 STRING 要使用的結構定義類型。
use_async_services BOOLEAN 布林值,指出您是否要在插入、更新及刪除時使用非同步服務。
use_internal_names_for_customizations BOOLEAN 布林值,指出是否要使用自訂項目的內部名稱。
use_upserts BOOLEAN 布林值,指出是否要在使用插入作業時執行 upsert。
user_timezone_offset STRING 使用者時區偏移量,如 NetSuite 偏好設定 (依序點選「首頁」-->「偏好設定」-->「時區」) 中所定義。例如:美國東部標準時間。
row_scan_depth STRING 動態決定資料表欄時要掃描的列數。
詳細程度 STRING 連線的詳細程度,範圍為 1 到 5。詳細程度越高,記錄的通訊詳細資料就越多 (要求、回應和 SSL 憑證)。
proxy_enabled BOOLEAN 選取這個核取方塊,即可為連線設定 Proxy 伺服器。
proxy_auth_scheme ENUM 用於向 ProxyServer Proxy 驗證的驗證類型。支援的值包括:BASIC、DIGEST、NONE
proxy_user STRING 用於向 ProxyServer Proxy 驗證的使用者名稱。
proxy_password SECRET 用於向 ProxyServer 代理程式驗證的密碼。
proxy_ssltype ENUM 連線至 ProxyServer Proxy 時要使用的 SSL 類型,支援的值包括:AUTO、ALWAYS、NEVER、TUNNEL

向 Google Cloud 社群尋求協助

如要發布問題及討論這個連接器,請前往 Cloud 論壇的 Google Cloud 社群。

後續步驟