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)
如要瞭解如何啟用服務,請參閱「啟用服務」。
如果專案先前未啟用這些服務或權限,系統會在設定連結器時提示您啟用。
設定連接器
連線專屬於資料來源。也就是說,如果您有多個資料來源,則必須為每個資料來源建立個別的連線。如要建立連線,請按照下列步驟操作:
- 在 Cloud 控制台中,前往「Integration Connectors」>「Connections」頁面,然後選取或建立 Google Cloud 專案。
- 按一下「+ 建立新項目」開啟「建立連線」頁面。
- 在「位置」部分中,選擇連線位置。
- 區域:從下拉式清單中選取位置。
連接器支援的地區包括:
如需所有支援的地區清單,請參閱「位置」一文。
- 點選「下一步」。
- 區域:從下拉式清單中選取位置。
- 在「連線詳細資料」部分,完成下列步驟:
- 連接器:從可用連接器的下拉式清單中選取「Netsuite」。
- 連接器版本:從可用版本的下拉式清單中選取連接器版本。
- 在「連線名稱」欄位中,輸入連線執行個體的名稱。
連線名稱必須符合下列條件:
- 連線名稱可使用英文字母、數字或連字號。
- 字母必須為小寫。
- 連線名稱開頭須為英文字母,結尾則須為英文字母或數字。
- 連結名稱不得超過 49 個字元。
- 視需要輸入連線執行個體的「Description」(說明)。
- 或者,可啟用 Cloud Logging,然後選取記錄層級。記錄層級預設為
Error
。 - 服務帳戶:選取具備必要角色的服務帳戶。
- 視需要設定「連線節點設定」:
- 節點數量下限:輸入連線節點數量下限。
- 節點數量上限:輸入連線節點數量上限。
節點是用來處理交易的連線單位 (或備用資源)。連線處理的交易量越多,就需要越多節點;反之,處理的交易量越少,需要的節點就越少。如要瞭解節點對連接器定價的影響,請參閱「 連線節點定價」。如未輸入任何值,系統預設會將節點下限設為 2 (提高可用性),節點上限則設為 50。
- 帳戶 ID:使用者名稱在 NetSuite 中關聯的公司帳戶。
- 匯總資料欄模式:指出匯總資料欄的處理方式。
- 應用程式 ID:自 2020.1 版起,對 NetSuite 的要求必須包含應用程式 ID。
- 自訂欄位權限:以半形逗號分隔的自訂欄位權限清單。與 IncludeCustomFieldColumns 相比,可提供更多控制選項。
- 包含子項資料表:布林值,指出是否應顯示子項資料表。
- Include Custom Field Columns:布林值,指出是否要納入自訂欄位資料欄。
- Include Custom List Tables:布林值,指出是否要使用以自訂清單為準的表格。
- 包含自訂記錄表格:布林值,指出是否要使用以自訂記錄類型為基礎的表格。
- 包含參照資料欄:以逗號分隔的清單,代表從記錄參照欄位擷取資料時要納入的資料欄。
- 並行工作階段數量上限:連線可使用的並行工作階段數量上限。
- NetSuite 日期格式:在 NetSuite UI 中設定的偏好日期格式。
- NetSuite 長日期格式:在 NetSuite 使用者介面中設定的偏好長日期格式。
- Netsuite Metadata Folder:從 NetSuite 下載中繼資料檔案的目錄路徑。建議您設定這個值,以獲得最佳成效。
- 將 Double 回報為 Decimal:指出是否應將 Double 回報為 Decimal。
- 要求記憶交易:布林值,指出從 NetSuite 擷取交易時,是否要要求記憶交易。
- 角色 ID:RoleId 是用來登入 NetSuite 的角色 InternalId。如要使用者的預設角色,請留空。
-
結構定義:要使用的結構定義類型。你可以選取下列任一值:
- SuiteTalk - 適用於以 SOAP 為基礎的連線。
- SuiteSQL - 適用於以 REST 為基礎的連線。
- 使用非同步服務:布林值,指出您是否要在插入、更新及刪除時使用非同步服務。
- 使用自訂項目的內部名稱:布林值,指出是否要使用自訂項目的內部名稱。
- 使用 Upsert:布林值,指出使用插入作業時是否要執行 upsert。
- 使用者時區偏移:使用者時區偏移,定義於 NetSuite 偏好設定的「首頁」-->「偏好設定」-->「時區」。例如:美國東部標準時間。
- 資料列掃描深度:動態決定表格的資料欄時,要掃描的資料列數量。
- (選用) 在「進階設定」部分,選取「使用 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 伺服器的詳細資料。
- (選用) 按一下「+ 新增標籤」,以鍵/值組合的形式為連線新增標籤。
- 點選「下一步」。
- 在「目的地」部分,輸入要連線的遠端主機 (後端系統) 詳細資料。
- 目的地類型:您可以將目的地詳細資料指定為主機位址或服務附件。選取下列任一目的地類型:
- 主機位址:如要指定目的地的主機名稱或 IP 位址。
- 服務連結:如要為內部 IP 位址指定私人端點,請選取這個選項。服務連結可讓您對外部網路隱藏內部 IP 位址。您可以使用 Private Service Connect 功能,在 Google Cloud 中建立服務連結。如要瞭解如何設定 Private Service Connect,請參閱「發布代管服務」。
根據您選取的目的地類型,輸入主機地址或服務連結名稱。
如要輸入其他目的地,請按一下「+新增目的地」。
- 點選「下一步」。
- 目的地類型:您可以將目的地詳細資料指定為主機位址或服務附件。選取下列任一目的地類型:
-
在「Authentication」(驗證) 部分中,輸入驗證詳細資料。
- 選取「驗證類型」並輸入相關詳細資料。
Netsuite 連線支援下列驗證類型:
- 使用者名稱和密碼
- 權杖式驗證
- OAuth 2.0 授權碼授權
- 點選「下一步」。
如要瞭解如何設定這些驗證類型,請參閱「設定驗證」。
- 選取「驗證類型」並輸入相關詳細資料。
- 檢查:檢查連線和驗證詳細資料。
- 點選「建立」。
設定驗證機制
根據要使用的驗證方式輸入詳細資料。
-
使用者名稱和密碼
使用者名稱和密碼驗證。這僅適用於 NetSuite 2020.2 或更舊版本。
- 使用者名稱:連接器的使用者名稱
- 密碼:Secret Manager 密鑰,內含與連接器相關聯的密碼。
-
以權杖為基礎的驗證
Netsuite 的權杖式驗證。這可用於
SuiteTalk
和SuiteQL
配置。- OAuth 用戶端 ID:建立應用程式時顯示的消費者金鑰。
- OAuth 用戶端密鑰:Secret Manager 密鑰,內含建立應用程式時顯示的消費者密鑰。
- OAuth 存取權杖:建立存取權杖時的權杖 ID。
- OAuth 存取權杖密鑰:Secret Manager 密鑰,內含建立存取權杖時的權杖密鑰。
- OAuth 2.0 - 授權碼
- 用戶端 ID:用於要求存取權杖的用戶端 ID。
- 範圍:以半形逗號分隔的必要範圍清單。
- 用戶端密鑰:用於要求存取權杖的用戶端密鑰。
連線授權是透過網頁版使用者登入流程完成。這項設定僅適用於 SuiteQL
結構。
如果是 Authorization code
驗證類型,建立連線後,您應執行幾個額外步驟來設定驗證。詳情請參閱建立連結後需執行的額外步驟。
建立連結後需執行的其他步驟
如果您選取 OAuth 2.0 - Authorization code
進行驗證,建立連線後必須執行下列額外步驟:
- 在「連線」頁面中,找出新建立的連線。
請注意,新連接器的「狀態」會顯示「需要授權」。
- 按一下「需要授權」。
系統隨即會顯示「編輯授權」窗格。
- 將「重新導向 URI」值複製到外部應用程式。
- 驗證授權詳細資料。
- 按一下「Authorize」。
授權成功後,「連線」頁面的連線狀態會設為「有效」。
重新授權授權碼
如果您使用 Authorization code
驗證類型,且已在後端 NetSuite 應用程式中進行任何設定變更,則必須重新授權 NetSuite 連線。如要重新授權連結,請按照下列步驟操作:
- 在「連線」頁面中,按一下所需連線。
系統隨即會開啟連線詳細資料頁面。
- 按一下「編輯」即可編輯連結詳細資料。
- 在「驗證」部分中,確認「OAuth 2.0 - 授權碼」詳細資料。
視需要進行必要變更。
- 按一下 [儲存]。系統會將您帶往連線詳細資料頁面。
- 在「驗證」部分中,按一下「編輯授權」。系統會顯示「Authorize」(授權) 窗格。
- 按一下「Authorize」。
如果授權成功,「連線」頁面的連線狀態會設為「有效」。
設定 NetSuite
如要產生用戶端 ID、用戶端密鑰、權杖 ID 和權杖密鑰,請按照下列步驟操作:
- 在 NetSuite 中建立新的整合。
- 提供整合詳細資料 (例如名稱),並啟用權杖式驗證。
- 指定回呼網址,例如
https:cloud.google.com/connectors/oauth?e=ApplicationIntegrationConnectorPaginatedFieldsLaunch%3A%3AApplicationIntegrationConnectorPaginatedFieldsEnabled&project=PROJECT_NAME
。 - 提交整合項目後,您會收到用戶端 ID 和用戶端密鑰。儲存這些詳細資料。
- 設定整合使用者記錄。
- 如要建立權杖和密鑰,請前往首頁,選取「管理存取權杖」,然後按一下「新增我的存取權杖」。您將使用這些詳細資料,在 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>`;"
範例 - 列出所有貸項憑單
- 在「
Configure connector task
」對話方塊中,按一下Entities
。 - 從
Entity
清單中選取CreditMemo
。 - 選取「
List
」作業,然後按一下「完成」。 - (選用) 在「連結器」工作的「工作輸入」部分,您可以指定篩選子句,篩選結果集。請一律在單引號 (') 內指定篩選子句值。
範例 - 取得 CreditMemo 記錄
- 在「
Configure connector task
」對話方塊中,按一下Entities
。 - 從
Entity
清單中選取「CreditMemo」。 - 選取「
GET
」作業,然後按一下「完成」。 - 將實體 ID 設為 1083723,也就是要傳遞的鍵。如要設定實體 ID,請在「資料對應」的「資料對應器」部分,按一下「開啟資料對應編輯器」,然後在「輸入值」欄位中輸入
1083723
,並選擇 EntityId 做為本機變數。直接傳遞實體 ID。如果存在複合鍵,傳遞實體 ID 可能會擲回錯誤。在這種情況下,請使用篩選子句指定 ID。
範例 - 建立 PurchaseOrder 記錄
- 在「
Configure connector task
」對話方塊中,按一下Entities
。 - 從
Entity
清單中選取 PurchaseOrder。 - 選取「
Create
」作業,然後按一下「完成」。 - 在「資料對應」工作的「資料對應器」部分,按一下
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 記錄
- 在「
Configure connector task
」對話方塊中,按一下Entities
。 - 從
Entity
清單中選取 ReturnAuthorization。 - 選取「
Create
」作業,然後按一下「完成」。 - 在「資料對應」工作的「資料對應器」部分,按一下
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 記錄
- 在「
Configure connector task
」對話方塊中,按一下Entities
。 - 從
Entity
清單中選取 SalesOrder。 - 選取「
Create
」作業,然後按一下「完成」。 - 在「資料對應」工作的「資料對應器」部分,按一下
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 記錄
- 在「
Configure connector task
」對話方塊中,按一下Entities
。 - 從
Entity
清單中選取 CreditMemo_itemList。 - 選取「
Create
」作業,然後按一下「完成」。 - 在「資料對應」工作的「資料對應器」部分,按一下
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" }
範例 - 建立顧客記錄
- 在「
Configure connector task
」對話方塊中,按一下Entities
。 - 從
Entity
清單中選取「顧客」。 - 選取「
Create
」作業,然後按一下「完成」。 - 在「資料對應」工作的「資料對應器」部分,按一下
Open Data Mapping Editor
,然後在Input Value
欄位中輸入類似下列的值,並選擇 EntityId/ConnectorInputPayload 做為本機變數。{ "CompanyName": "Bcone8", "Email": "222larabrown@gmail.com" }
如果整合成功,
Customer
工作connectorOutputPayload
回應參數的值會類似於下列內容:{ "InternalId": "4767" }
範例 - 建立 Invoice_itemList 記錄
- 在「
Configure connector task
」對話方塊中,按一下Entities
。 - 從
Entity
清單中選取 Invoice_itemList。 - 選取「
Create
」作業,然後按一下「完成」。 - 在「資料對應」工作的「資料對應器」部分,按一下
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 記錄
- 在「
Configure connector task
」對話方塊中,按一下Entities
。 - 從
Entity
清單中選取 CustomerPayment。 - 選取「
Create
」作業,然後按一下「完成」。 - 在「資料對應」工作的「資料對應器」部分,按一下
Open Data Mapping Editor
,然後在Input Value
欄位中輸入類似下列的值,並選擇 EntityId/ConnectorInputPayload 做為本機變數。{ "Customer_InternalId": "1714", "Payment": 9999.0 }
如果整合成功,
CustomerPayment
工作connectorOutputPayload
回應參數的值會類似於下列內容:{ "InternalId": "1090749" }
範例 - 建立 PurchaseOrder_itemList 記錄
- 在「
Configure connector task
」對話方塊中,按一下Entities
。 - 從
Entity
清單中選取 PurchaseOrder_itemList。 - 選取「
Create
」作業,然後按一下「完成」。 - 在「資料對應」工作的「資料對應器」部分,按一下
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 記錄
- 在「
Configure connector task
」對話方塊中,按一下Entities
。 - 從
Entity
清單中選取 SalesOrder_itemList。 - 選取「
Create
」作業,然後按一下「完成」。 - 在「資料對應」工作的「資料對應器」部分,按一下
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" }
範例 - 建立供應商記錄
- 在「
Configure connector task
」對話方塊中,按一下Entities
。 - 從
Entity
清單中選取「供應商」。 - 選取「
Create
」作業,然後按一下「完成」。 - 在「資料對應」工作的「資料對應器」部分,按一下
Open Data Mapping Editor
,然後在Input Value
欄位中輸入類似下列的值,並選擇 EntityId/ConnectorInputPayload 做為本機變數。{ "CompanyName": "Deloitte", "LegalName": "AU Vendor" }
如果整合成功,
Vendor
工作connectorOutputPayload
回應參數的值會類似於下列內容:{ "InternalId": "5067" }
範例 - 建立 VendorBill_itemList 記錄
- 在「
Configure connector task
」對話方塊中,按一下Entities
。 - 從
Entity
清單中選取 VendorBill_itemList。 - 選取「
Create
」作業,然後按一下「完成」。 - 在「資料對應」工作的「資料對應器」部分,按一下
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 記錄
- 在「
Configure connector task
」對話方塊中,按一下Entities
。 - 從
Entity
清單中選取 VendorCredit_itemList。 - 選取「
Create
」作業,然後按一下「完成」。 - 在「資料對應」工作的「資料對應器」部分,按一下
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 記錄
- 在「
Configure connector task
」對話方塊中,按一下Entities
。 - 從
Entity
清單中選取 VendorPayment_applyList。 - 選取「
Create
」作業,然後按一下「完成」。 - 在「資料對應」工作的「資料對應器」部分,按一下
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 記錄
- 在「
Configure connector task
」對話方塊中,按一下Entities
。 - 從
Entity
清單中選取「CreditMemo」。 - 選取「
Create
」作業,然後按一下「完成」。 - 在「資料對應」工作的「資料對應器」部分,按一下
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" }
範例 - 建立應付憑據記錄
- 在「
Configure connector task
」對話方塊中,按一下Entities
。 - 從
Entity
清單中選取「月結單」。 - 選取「
Create
」作業,然後按一下「完成」。 - 在「資料對應」工作的「資料對應器」部分,按一下
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 記錄
- 在「
Configure connector task
」對話方塊中,按一下Entities
。 - 從
Entity
清單中選取 ItemFulfillment。 - 選取「
Create
」作業,然後按一下「完成」。 - 在「資料對應」工作的「資料對應器」部分,按一下
Open Data Mapping Editor
,然後在Input Value
欄位中輸入類似下列的值,並選擇 EntityId/ConnectorInputPayload 做為本機變數。{ "CreatedFrom_InternalId": "411", "ShipStatus": "_picked" }
如果整合成功,
ItemFulfillment
工作connectorOutputPayload
回應參數的值會類似於下列內容:{ "InternalId": "412" }
範例 - 建立 JournalEntry 記錄
- 在「
Configure connector task
」對話方塊中,按一下Entities
。 - 從
Entity
清單中選取 JournalEntry。 - 選取「
Create
」作業,然後按一下「完成」。 - 在「資料對應」工作的「資料對應器」部分,按一下
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 記錄
- 在「
Configure connector task
」對話方塊中,按一下Entities
。 - 從
Entity
清單中選取 PurchaseOrder。 - 選取「
Create
」作業,然後按一下「完成」。 - 在「資料對應」工作的「資料對應器」部分,按一下
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 記錄
- 在「
Configure connector task
」對話方塊中,按一下Entities
。 - 從
Entity
清單中選取「VendorBill」。 - 選取「
Create
」作業,然後按一下「完成」。 - 在「資料對應」工作的「資料對應器」部分,按一下
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 記錄
- 在「
Configure connector task
」對話方塊中,按一下Entities
。 - 從
Entity
清單中選取「VendorCredit」。 - 選取「
Create
」作業,然後按一下「完成」。 - 在「資料對應」工作的「資料對應器」部分,按一下
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 記錄
- 在「
Configure connector task
」對話方塊中,按一下Entities
。 - 從
Entity
清單中選取「VendorPayment」。 - 選取「
Create
」作業,然後按一下「完成」。 - 在「資料對應」工作的「資料對應器」部分,按一下
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 記錄
- 在「
Configure connector task
」對話方塊中,按一下Entities
。 - 從
Entity
清單中選取 TRANSFERORDER。 - 選取「
Create
」作業,然後按一下「完成」。 - 在「資料對應」工作的「資料對應器」部分,按一下
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 記錄
- 在「
Configure connector task
」對話方塊中,按一下Entities
。 - 從
Entity
清單中選取「CashSale」。 - 選取「
Create
」作業,然後按一下「完成」。 - 在「資料對應」工作的「資料對應器」部分,按一下
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 記錄
- 在「
Configure connector task
」對話方塊中,按一下Entities
。 - 從
Entity
清單中選取「PaycheckJournal」。 - 選取「
Create
」作業,然後按一下「完成」。 - 在「資料對應」工作的「資料對應器」部分,按一下
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 記錄
- 在「
Configure connector task
」對話方塊中,按一下Entities
。 - 從
Entity
清單中選取 InventoryAdjustment。 - 選取「
Create
」作業,然後按一下「完成」。 - 在「資料對應」工作的「資料對應器」部分,按一下
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 記錄
- 在「
Configure connector task
」對話方塊中,按一下Entities
。 - 從
Entity
清單中選取「CashRefund」。 - 選取「
Create
」作業,然後按一下「完成」。 - 在「資料對應」工作的「資料對應器」部分,按一下
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 記錄
- 在「
Configure connector task
」對話方塊中,按一下Entities
。 - 從
Entity
清單中選取「CreditMemo」。 - 選取「
Update
」作業,然後按一下「完成」。 - 在「資料對應」工作的「資料對應器」部分中,按一下
Open Data Mapping Editor
,然後在Input Value
欄位中輸入類似下列的值,並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。{ "Email2": "222larabrown@gmail.com" }
- 在資料對應工具中,將實體 ID 設為 CreditMemo 的實體。如要設定實體 ID,請按一下
Open Data Mapping Editor
,然後在Input Value
欄位中輸入類似下列的值,並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。或者,您也可以設定 filterClause 為
1090651
,而非指定 entityId。執行這個範例後,連接器工作
connectorOutputPayload
輸出變數會傳回類似下列內容的回應:{ "InternalId": "1090651" }
範例 - 更新顧客記錄
- 在「
Configure connector task
」對話方塊中,按一下Entities
。 - 從
Entity
清單中選取「顧客」。 - 選取「
Update
」作業,然後按一下「完成」。 - 在「資料對應」工作的「資料對應器」部分中,按一下
Open Data Mapping Editor
,然後在Input Value
欄位中輸入類似下列的值,並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。{ "Email": "222larabrown@gmail.com" }
- 在資料對應工具中,將實體 ID 設為「客戶」實體。如要設定實體 ID,請按一下
Open Data Mapping Editor
,然後在Input Value
欄位中輸入類似下列的值,並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。或者,您也可以設定 filterClause 為
4767
,而非指定 entityId。執行這個範例後,連接器工作
connectorOutputPayload
輸出變數會傳回類似下列內容的回應:{ "InternalId": "4767" }
範例 - 更新月結單記錄
- 在「
Configure connector task
」對話方塊中,按一下Entities
。 - 從
Entity
清單中選取「月結單」。 - 選取「
Update
」作業,然後按一下「完成」。 - 在「資料對應」工作的「資料對應器」部分中,按一下
Open Data Mapping Editor
,然後在Input Value
欄位中輸入類似下列的值,並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。{ "Email2": "222larabrown@gmail.com" }
- 在資料對應工具中,將實體 ID 設為發票實體。如要設定實體 ID,請按一下
Open Data Mapping Editor
,然後在Input Value
欄位中輸入類似下列的值,並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。或者,您也可以設定 filterClause 為
1083927
,而非指定 entityId。執行這個範例後,連接器工作
connectorOutputPayload
輸出變數會傳回類似下列內容的回應:{ "InternalId": "1083927" }
範例 - 更新 CustomerPayment 記錄
- 在「
Configure connector task
」對話方塊中,按一下Entities
。 - 從
Entity
清單中選取 CustomerPayment。 - 選取「
Update
」作業,然後按一下「完成」。 - 在「資料對應」工作的「資料對應器」部分中,按一下
Open Data Mapping Editor
,然後在Input Value
欄位中輸入類似下列的值,並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。{ "Customer_InternalId": "1714", "Payment": 7.77777777E8 }
- 在資料對應工具中,將實體 ID 設為 CustomerPayment 的實體。如要設定實體 ID,請按一下
Open Data Mapping Editor
,然後在Input Value
欄位中輸入類似下列的值,並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。或者,您也可以設定 filterClause 為
1090749
,而非指定 entityId。執行這個範例後,連接器工作
connectorOutputPayload
輸出變數會傳回類似下列內容的回應:{ "InternalId": "1090749" }
範例 - 更新 PurchaseOrder 記錄
- 在「
Configure connector task
」對話方塊中,按一下Entities
。 - 從
Entity
清單中選取 PurchaseOrder。 - 選取「
Update
」作業,然後按一下「完成」。 - 在「資料對應」工作的「資料對應器」部分中,按一下
Open Data Mapping Editor
,然後在Input Value
欄位中輸入類似下列的值,並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。{ "Message": "Aspirin Updated" }
- 在資料對應工具中,將實體 ID 設為 PurchaseOrder 的實體。如要設定實體 ID,請按一下
Open Data Mapping Editor
,然後在Input Value
欄位中輸入類似下列的值,並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。或者,您也可以設定 filterClause 為
1000
,而非指定 entityId。執行這個範例後,連接器工作
connectorOutputPayload
輸出變數會傳回類似下列內容的回應:{ "InternalId": "1000" }
範例 - 更新 SalesOrder 記錄
- 在「
Configure connector task
」對話方塊中,按一下Entities
。 - 從
Entity
清單中選取 PurchaseOrder。 - 選取「
Update
」作業,然後按一下「完成」。 - 在「資料對應」工作的「資料對應器」部分中,按一下
Open Data Mapping Editor
,然後在Input Value
欄位中輸入類似下列的值,並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。{ "Email": "222larabrown@gmail.com", "Entity_InternalId": "1709", "Item_InternalId": "945" }
- 在資料對應工具中,將實體 ID 設為 SalesOrder 的實體。如要設定實體 ID,請按一下
Open Data Mapping Editor
,然後在Input Value
欄位中輸入類似下列的值,並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。或者,您也可以設定 filterClause 為
1086949
,而非指定 entityId。執行這個範例後,連接器工作
connectorOutputPayload
輸出變數會傳回類似下列內容的回應:{ "InternalId": "1086949" }
範例 - 更新供應商記錄
- 在「
Configure connector task
」對話方塊中,按一下Entities
。 - 從
Entity
清單中選取「供應商」。 - 選取「
Update
」作業,然後按一下「完成」。 - 在「資料對應」工作的「資料對應器」部分中,按一下
Open Data Mapping Editor
,然後在Input Value
欄位中輸入類似下列的值,並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。{ "CompanyName": "Deloitte_Updated" }
- 在資料對應工具中,將實體 ID 設為供應商的實體。如要設定實體 ID,請按一下
Open Data Mapping Editor
,然後在Input Value
欄位中輸入類似下列的值,並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。或者,您也可以設定 filterClause 為
4567
,而非指定 entityId。執行這個範例後,連接器工作
connectorOutputPayload
輸出變數會傳回類似下列內容的回應:{ "InternalId": "4567" }
範例 - 更新 VendorBill 記錄
- 在「
Configure connector task
」對話方塊中,按一下Entities
。 - 從
Entity
清單中選取「VendorBill」。 - 選取「
Update
」作業,然後按一下「完成」。 - 在「資料對應」工作的「資料對應器」部分中,按一下
Open Data Mapping Editor
,然後在Input Value
欄位中輸入類似下列的值,並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。{ "Memo": "Memo_Jan 11" }
- 在資料對應工具中,將實體 ID 設為 VendorBill 的實體。如要設定實體 ID,請按一下
Open Data Mapping Editor
,然後在Input Value
欄位中輸入類似下列的值,並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。或者,您也可以設定 filterClause 為
3339
,而非指定 entityId。執行這個範例後,連接器工作
connectorOutputPayload
輸出變數會傳回類似下列內容的回應:{ "InternalId": "3339" }
範例 - 更新 VendorCredit 記錄
- 在「
Configure connector task
」對話方塊中,按一下Entities
。 - 從
Entity
清單中選取「VendorCredit」。 - 選取「
Update
」作業,然後按一下「完成」。 - 在「資料對應」工作的「資料對應器」部分中,按一下
Open Data Mapping Editor
,然後在Input Value
欄位中輸入類似下列的值,並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。{ "Memo": "16253" }
- 在資料對應工具中,將實體 ID 設為 VendorCredit 的實體。如要設定實體 ID,請按一下
Open Data Mapping Editor
,然後在Input Value
欄位中輸入類似下列的值,並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。或者,您也可以設定 filterClause 為
1091549
,而非指定 entityId。執行這個範例後,連接器工作
connectorOutputPayload
輸出變數會傳回類似下列內容的回應:{ "InternalId": "1091549" }
範例 - 更新 VendorPayment 記錄
- 在「
Configure connector task
」對話方塊中,按一下Entities
。 - 從
Entity
清單中選取「VendorPayment」。 - 選取「
Update
」作業,然後按一下「完成」。 - 在「資料對應」工作的「資料對應器」部分中,按一下
Open Data Mapping Editor
,然後在Input Value
欄位中輸入類似下列的值,並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。{ "Memo": "Jan8" }
- 在資料對應工具中,將實體 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 |