SAP SuccessFactors

實體、作業和動作

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

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

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

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

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

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

系統限制

SAP SuccessFactors 連接器每秒可處理 10 筆交易，每個節點每秒可處理 10 筆交易，並節流任何超出此限制的交易。根據預設，Integration Connectors 會為連線分配 2 個節點 (以提高可用性)。

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

動作

這個部分會列出 SuccessFactors 連線支援的所有動作。

UpsertEntity 動作

這個動作可讓您插入或更新實體的記錄。

UpsertEntity 動作的輸入參數

UpsertEntity 動作的輸出參數

這項操作會傳回狀態 200 (OK)，以及指出所有 Upsert 結果的回應主體。

如要瞭解如何設定 UpsertEntity 動作，請參閱範例。

動作範例

本節說明如何在這個連接器中執行部分動作。

範例 - 更新 PerPersonal 實體中的記錄

以下範例會更新 PerPersonal 實體中的記錄。

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

   {
   "entityType": "PerPersonal",
   "payload": {
     "personIdExternal": "109031",
     "startDate": "1800-01-01 00:00:00.0",
     "firstName": "John",
     "lastName": "Job",
     "nationality": "IND"
     }
   }

如果動作成功，連接器工作的 connectorOutputPayload 欄位會包含類似以下內容的值：

[{
  "personIdExternal": "109031",
  "startDate": "1989-12-31 23:00:00.0"
}]

範例 - 更新 PaymentInformationDetailV3 實體中的記錄

以下範例會更新 PaymentInformationDetailV3 實體中的記錄。

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

   {
     "entityType": "PaymentInformationDetailV3",
     "payload": {
       "PaymentInformationV3_effectiveStartDate": "2015-01-21 00:00:00.0",
       "PaymentInformationV3_worker": "82096",
       "externalCode": 563.0,
       "currency": "EUR"
     }
   }

如果動作成功，連接器工作的 connectorOutputPayload 欄位會包含類似下列內容的值：

[{
  "externalCode": 563.0,
  "PaymentInformationV3_effectiveStartDate": "2015-01-20 23:00:00.0",
  "PaymentInformationV3_worker": "82096"
}]

範例 - 在實體中建立記錄

下列範例會在 TodoEntryV2 實體中建立記錄。

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

   {
     "entityType": "TodoEntryV2",
     "payload": {
       "todoEntryName": "Finish Your Tasks",
       "status": 1.0,
       "categoryId": "41",
       "LinkeduserNav": {
         "__metadata": {
           "uri": "https://apisalesdemo2.successfactors.eu/odata/v2/User('613577712')",
           "type": "SFOData.User"
         }
       }
     }
   }

如果動作執行成功，連接器工作的 connectorOutputPayload 欄位會包含類似以下內容的值：

[{
  "todoEntryId": 221443.0
}] 

實體範例

範例 - 列出實體的記錄

這個範例會列出 FOCompany 實體的記錄。

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 FOCompany。
3. 選取「LIST」作業，然後按一下「完成」。
4. 在「連線器」工作的「工作輸入」部分，您可以根據需求設定 filterClause。

   舉例來說，將篩選子句設為 externalCode='5100' and startDate='1900-01-01 00:00:00'，只會列出 externalCode 為 5100 且 startDate 為 1900-01-01 00:00:00 的記錄。

範例 - 從實體取得記錄

這個範例會從 User 實體擷取記錄。

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 User。
3. 選取「GET」作業，然後按一下「完成」。
4. 在「連線器」工作的「工作輸入」部分，按一下「EntityId」，然後在「預設值」欄位中輸入 103032。

   其中 103032 是 Users 實體的主鍵。

範例 - 從實體刪除記錄

這個範例會從 FOCompany 實體刪除記錄。

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 FOCompany。
3. 選取「DELETE」作業，然後按一下「完成」。
4. 在「連線器」工作的「工作輸入」部分，按一下「entityId」，然後在「預設值」欄位中輸入 113132。

   或者，如果實體具有複合式主鍵，而非指定 entityId，則可以設定 filterClause。例如：externalCode='5100' and startDate='1900-01-01 00:00:00'。

範例 - 在實體中建立記錄

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

   {
   "externalCode": "1000",
   "startDate": "1900-01-01 00:00:00.0",
   "standardHours": 40.0,
   "status": "I",
   "currency": "EUR",
   "country": "DEU"
   }

   如果整合成功，連接器工作的 connectorOutputPayload 欄位會顯示類似下列的值：

   {
   "externalCode": "1000",
   "startDate": "1900-01-01 00:00:00.0"
   }

範例 - 在 TimeZone 實體中建立記錄

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

   {
   "effectiveStartDate": "2023-08-16 00:00:00.0",
   "externalCode": "10013",
   "effectiveStatus": "A",
   "utcDstOffset": "UTC+01:00",
   "utcOffset": "+0100"
   }

   如果整合成功，連接器工作的 connectorOutputPayload 欄位會包含類似下列內容的值：

   {
   "effectiveStartDate": "2023-08-16 00:00:00.0",
   "externalCode": "10013"
   }

範例 - 更新實體中的記錄

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

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

   {
   "description": "BestRun India"
   }

5. 在「連線器」工作的「工作輸入」部分，按一下「entityId」，然後在「預設值」欄位中輸入 103032。

   或者，如果實體具有複合式主鍵，而非指定 entityId，則可以設定 filterClause。例如：externalCode='5100' and startDate='1900-01-01 00:00:00'。

如果整合成功，連接器工作的 connectorOutputPayload 欄位會包含類似以下內容的值：

{
"externalCode": "5100",
"startDate": "1900-01-01 00:00:00.0"
}

在整合中運用 SAP SuccessFactors 連線

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

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