Shopify

實體、作業和動作

所有整合連接器都會為所連應用程式的物件提供抽象層。您只能透過這個抽象化程序存取應用程式的物件。抽象化會以實體、作業和動作的形式呈現。

• 實體： 實體可以視為已連結應用程式或服務中的物件，或是屬性集合。實體的定義因連接器而異。舉例來說，在資料庫連接器中，資料表是實體；在檔案伺服器連接器中，資料夾是實體；在訊息系統連接器中，佇列是實體。

  不過，連接器可能不支援或沒有任何實體，在這種情況下，Entities 清單會是空白。

• 作業： 作業是指您可以在實體上執行的活動。您可以對實體執行下列任一操作：
  • 列出
  • 取得
  • 建立
  • 更新
  • 刪除

  從可用清單中選取實體，系統會產生該實體可用的作業清單。如需作業的詳細說明，請參閱 Connectors 工作的實體作業。 不過，如果連接器不支援任何實體作業，系統就不會在 Operations 清單中列出這些不支援的作業。

• 動作： 動作是透過連接器介面提供給整合的第一類函式。動作可讓您變更一或多個實體，且因連接器而異。一般來說，動作會有一些輸入參數和輸出參數。不過，連接器可能不支援任何動作，此時 Actions 清單會是空白。

實體作業範例

範例 - 列出所有產品

這個範例會列出 Products 實體中的所有記錄。

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Products。
3. 選取「List」作業，然後按一下「完成」。

範例 - 取得顧客詳細資料

這個範例會從 Customers 實體取得指定客戶的詳細資料。

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Customers。
3. 選取「Get」作業，然後按一下「完成」。
4. 輸入要擷取詳細資料的客戶實體 ID。

   在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下「entityId」，然後在「Default Value」(預設值) 欄位中輸入 365009521884E12。

範例 - 刪除訂單記錄

這個範例會從 Order 實體中刪除指定訂單。

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Order。
3. 選取「Delete」作業，然後按一下「完成」。
4. 輸入要刪除的訂單實體 ID。

   在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下「entityId」，然後在「Default Value」(預設值) 欄位中輸入 475009571483E15。

範例 - 新增客戶

這個範例會將指定客戶新增至 Customer 實體。

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Customer。
3. 選取「Create」作業，然後按一下「完成」。
4. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
   "FirstName": "Test",
   "LastName": "Customer5"
   }

   執行這個範例後，連接器工作 connectorOutputPayload 輸出變數中會傳回類似下列內容的回應：

   {
   "Id": 6448083206296
   }

範例 - 在 DiscountCode 中建立記錄

這個範例會在 DiscountCode 實體中建立新記錄。

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 DiscountCode。
3. 選取「Create」作業，然後按一下「完成」。
4. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 部分中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
   "PriceRuleId": 1.394097291568E12,
   "Code": "FREESHIP2025798"
   }

   執行這個範例後，連接器工作 connectorOutputPayload 輸出變數會傳回類似下列內容的回應：

   {
   "Id": 1.97836790828E13,
   "PriceRuleId": null
   }

範例 - 在 Pricerule 中建立記錄

這個範例會在 Pricerule 實體中建立新記錄。

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Pricerule。
3. 選取「Create」作業，然後按一下「完成」。
4. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
   "Id": 7.13459564696E11,
   "AllocationMethod": "each",
   "CustomerSelection": "all",
   "TargetType": "line_item",
   "UsageLimit": 100.0,
   "Title": "DP_PriceRule"
   }

   執行這個範例後，連接器工作 connectorOutputPayload 輸出變數會傳回類似下列內容的回應：

   {
   "Id": 197836790834,
   "PriceRuleId": null
   }

範例 - 在 ProductVariant 中建立記錄

這個範例會在 ProductVariant 實體中建立新記錄。

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 ProductVariant。
3. 選取「Create」作業，然後按一下「完成」。
4. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
   "Id": 1070325065,
   "ProductId": 7652181016728,
   "ImageId": null,
   "Price": 1,
   "CompareAtPrice": null,
   "Title": "Yellow",
   "Barcode": null,
   "FulfillmentService": "manual",
   "InventoryManagement": "shopify",
   "InventoryPolicy": "deny",
   "InventoryQuantity": 1070325069,
   "Option1": "Yellow",
   "Option2": null,
   "Option3": null,
   "Position": 5,
   "Sku": "",
   "Taxable": true
   }

   執行這個範例後，連接器工作 connectorOutputPayload 輸出變數會傳回類似下列內容的回應：

   {
   "Id": 42711984373912
   }

範例 - 更新顧客詳細資料

這個範例會更新 Customer 實體中指定客戶的詳細資料。

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Customer。
3. 選取「Update」作業，然後按一下「完成」。
4. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
   "FirstName": "Test",
   "LastName": "Customer2"
   }

5. 輸入要刪除的客戶實體 ID。

   在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下「entityId」，然後在「Default Value」(預設值) 欄位中輸入 648400653532。

   或者，您也可以將 filterClause 設為 648400653532，而非指定 entityId。

   執行這個範例後，連接器工作 connectorOutputPayload 輸出變數會傳回類似下列內容的回應：

   {
   "Id": 648400653532
   }

範例 - 更新 ProductVariant 中的記錄

這個範例會更新 ProductVariant 實體中的記錄。

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 ProductVariant。
3. 選取「Update」作業，然後按一下「完成」。
4. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
   "ProductId": 7.652181016728E12,
   "ImageId": null,
   "Price": 200.0,
   "CompareAtPrice": null,
   "Title": "Yellow Updated",
   "Barcode": null,
   "FulfillmentService": "manual",
   "InventoryManagement": "shopify",
   "InventoryQuantity": 1.070325069E9,
   "Option1": "Yellow new",
   "Option2": null,
   "Option3": null,
   "Position": 5.0,
   "Sku": "",
   "Taxable": true
   }

5. 指定要更新的記錄實體 ID。

   如要設定實體 ID，請按一下 entityId，然後在「Default Value」(預設值) 欄位中輸入 34601602744472。

   執行這個範例後，連接器工作 connectorOutputPayload 輸出變數會傳回類似下列內容的回應：

   {
   "Id": 2484258073471
   }