Okta

動作

本節列出 Okta 連接器支援的動作。如要瞭解如何設定動作，請參閱「動作範例」。

ReactivateUser 動作

這項操作會重新啟用使用者。

ReactivateUser 動作的輸入參數

如需 ReactivateUser 動作的設定範例，請參閱「ActivateUser 範例」。

ActivateUser 動作

這項操作會啟用使用者。

ActivateUser 動作的輸入參數

如需 ActivateUser 動作的設定範例，請參閱「ActivateUser 範例」。

DeactivateUser 動作

這項操作會停用使用者。

DeactivateUser 動作的輸入參數

如需 DeactivateUser 動作的設定範例，請參閱「DeactivateUser 範例」。

Assignusertogroup 動作

這項操作會將使用者指派給群組。

Assignusertogroup 動作的輸入參數

如需 Assignusertogroup 動作的設定範例，請參閱「將使用者指派給群組的範例」。

UnassignUsertoRole 動作

這項操作會取消使用者所屬角色。

UnassignUsertoRole 動作的輸入參數

如需設定 UnassignUsertoRole 動作的範例，請參閱「UnassignUsertoRole 範例」。

AssignUsertoRole 動作

這項操作會將使用者指派給角色。

AssignUsertoRole 動作的輸入參數

如需 AssignUsertoRole 動作的設定範例，請參閱「AssignUsertoRole 範例」。

AssignUsertoApp 動作

這項操作會將使用者指派給應用程式。

AssignUsertoApp 動作的輸入參數

如需 AssignUsertoApp 動作的設定範例，請參閱「AssignUsertoApp 範例」。

UnassignUsertoGroup 動作

這項操作會將使用者從群組中解除指派。

UnassignUsertoGroup 動作的輸入參數

如需設定 UnassignUsertoGroup 動作的範例，請參閱「UnassignUsertoGroup 範例」。

UnassignUsertoApp 動作

這項操作會將使用者從應用程式中取消指派。

UnassignUsertoApp 動作的輸入參數

如需設定 UnassignUsertoApp 動作的範例，請參閱「UnassignUsertoApp 範例」。

Assigngrouptoapp 動作

這項動作會將群組指派給應用程式。

Assigngrouptoapp 動作的輸入參數

如需 Assigngrouptoapp 動作的設定範例，請參閱「Assigngrouptoapp 範例」。

AssignGrouptoRole 動作

這項動作會將群組指派給角色。

AssignGrouptoRole 動作的輸入參數

如需 AssignGrouptoRole 動作的設定範例，請參閱「AssignGrouptoRole 範例」。

UnassignGrouptoApp 動作

這項動作會取消指派應用程式群組。

UnassignGrouptoApp 動作的輸入參數

如需設定 UnassignGrouptoApp 動作的範例，請參閱「UnassignGrouptoApp 範例」。

UnassignGrouptoRole 動作

這項操作會將群組從角色中取消指派。

UnassignGrouptoRole 動作的輸入參數

如需設定 UnassignGrouptoRole 動作的範例，請參閱「UnassignGrouptoRole 範例」。

SuspendUser 動作

這項操作會將使用者停權。

SuspendUser 動作的輸入參數

如需 SuspendUser 動作的設定方法範例，請參閱「SuspendUser 範例」。

UnsuspendUser 動作

這項操作會解除使用者的停權狀態。

UnsuspendUser 動作的輸入參數

如需 UnsuspendUser 動作的設定範例，請參閱「UnsuspendUser 範例」。

行動號召範例

範例：重新啟用使用者

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取 ReactivateUser 動作，然後按一下「Done」。
3. 在「Connectors」任務的「Task Input」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似以下的值：

   {
       "UserId": "00ulgqf2s4Zs5Ohge5d7"
   }
   

如果動作成功，ReactivateUser 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

{ 
    "Status": "Success",
    "ActivationToken": "PKeQTJMUW9vg0wyh8czA",
    "ActivationUrl": "https://dev-99779501.okta.com/tokens/PKeQTJMUW9vg0wyh8czA/verify" 
}

範例：啟用使用者

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取 ActivateUser 動作，然後按一下「Done」。
3. 在「Connectors」任務的「Task Input」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似以下的值：

   {
       "UserId": "00ulgqf2s4Zs5Ohge5d7"
   }
   
   

如果動作成功，ActivateUser 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

{ 
  "Status": "Success",
    "activationurl": null,
    "activationtoken": null
}

範例：停用使用者

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取 DeactivateUser 動作，然後按一下「Done」。
3. 在「Connectors」任務的「Task Input」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似以下的值：

   {
       "UserId": "00ulgqf2s4Zs5Ohge5d7"
   }
   

如果動作成功，DeactivateUser 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

{ 
 "Status": "Success",
"activationurl": null,
"activationtoken": null 
} 

範例：將使用者指派給群組

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取 Assignusertogroup 動作，然後按一下「Done」。
3. 在「Connectors」任務的「Task Input」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似以下的值：

   {
       "UserId": "00ulgqf2s4Zs5Ohge5d7",
       "GroupId": "7463874b834938475d"
   }
   

如果動作成功，Assignusertogroup 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

{
 "Status": "Success",
}

範例：取消指派使用者角色

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取 UnassignUsertoRole 動作，然後按一下「Done」。
3. 在「Connectors」任務的「Task Input」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似以下的值：

   {
       "UserId": "00ukxucmpl25SNLP65d7",
       "RoleAssignmentId": "irblawnjpom1bLBcJ5d7"
   }
   

如果動作成功，UnassignUsertoRole 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

{
 "Status": "Success",
}

範例：將使用者指派給角色

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取 AssignUsertoRole 動作，然後按一下「Done」。
3. 在「Connectors」任務的「Task Input」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似以下的值：

   {
   "UserId": "00ukxucmpl25SNLP65d7",
   "RoleId": "cr0l2n9ay0pCCxLgG5d7",
   "ResourceSet": "iaml81kep6zefR4Oq5d7",
   "Type": "CUSTOM"
   }
   

如果動作成功，AssignUsertoRole 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

{
 "Status": "Success",
    "Id": "irblawfe99RsUfILD5d7",
    "Label": "UserCreatorByabhishkePostman",
    "Type": "CUSTOM", 
    "Created": "2024-11-21 07:33:05.0",
    "LastUpdated": "2024-11-21 07:33:05.0",
    "AssignmentStatus": "ACTIVE",
    "AssignmentType": "USER",
    "resource-set": "iaml81kep6zefR4Oq5d7",
    "role": "cr0l2n9ay0pCCxLgG5d7",
    "_links_role_href": "https://dev-99779501-admin.okta.com/api/v1/iam/roles/cr0l2n9ay0pCCxLgG5d7",
    "_links_resource-set_href": "https://dev-99779501.okta.com/api/v1/iam/resource-sets/iaml81kep6zefR4Oq5d7",
    "_links_permissions_href": "https://dev-99779501-admin.okta.com/api/v1/iam/roles/cr0l2n9ay0pCCxLgG5d7/permissions",
    "_links_member_href": "https://dev-99779501.okta.com/api/v1/iam/resource-sets/iaml81kep6zefR4Oq5d7/bindings/cr0l2n9ay0pCCxLgG5d7/members/irblawfe99RsUfILD5d7",
    "_links_assignee_href": "https://dev-99779501.okta.com/api/v1/users/00ukxucmpl25SNLP65d7"

}

範例：將使用者指派給應用程式

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取 AssignUsertoApp 動作，然後按一下「Done」。
3. 在「Connectors」任務的「Task Input」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似以下的值：

   {
       "UserId": "00ukxucmpl25SNLP65d7",
       "AppId": "0oakn3j0bfGPR1Esk5d7"
   }
   

如果動作成功，AssignUsertoApp 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

{
    "Status": "Success",
    "Id": "00ukxucmpl25SNLP65d7",
    "Created": "2024-11-21 07:08:40.0",
    "LastUpdated": "2024-11-21 07:08:45.0",
    "Scope": "USER",
    "AssignmentStatus": "ACTIVE",
    "externalid": null, 
    "statuschanged": "2024-11-21T07:08:40.000Z",
    "passwordchanged": null,
    "syncstate": "DISABLED",
    "credentials_username": "baklavainthebalkans@gmail.com",
    "profile_street_address": null,
    "profile_country": null, 
    "profile_website": null,
    "profile_zoneinfo": "America/Los_Angeles",
    "profile_birthdate": null,
    "profile_gender": null,
    "profile_formatted": null,
    "profile_profile": null,
    "profile_locality": null,
    "profile_given_name": "Baklavainthe",
    "profile_middle_name": null,
    le_phone_number": null,
    "profile_region": null,
    "profile_postal_code": null,
    "profile_family_name": "Balkans",
    "profile_email": "baklavainthebalkans@gmail.com",
    "_links_app_href": "https://dev-99779501.okta.com/api/v1/apps/0oakn3j0bfGPR1Esk5d7", 
    "_links_user_href": "https://dev-99779501.okta.com/api/v1/users/00ukxucmpl25SNLP65d7"

}

範例：從群組中取消指派使用者

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取 UnassignUsertoGroup 動作，然後按一下「Done」。
3. 在「Connectors」任務的「Task Input」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似以下的值：

   {
       "UserId": "00ukxucmpl25SNLP65d7",
       "GroupId": "0oakn3j0bfGPR1Esk5d7"
   }
   

如果動作成功，UnassignUsertoGroup 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

{
"Status": "Success"
}

範例：為應用程式取消指派使用者

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取 UnassignUsertoApp 動作，然後按一下「Done」。
3. 在「Connectors」任務的「Task Input」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似以下的值：

   {
       "UserId": "00ukxucmpl25SNLP65d7",
       "AppId": "0oakn3j0bfGPR1Esk5d7"
   }
   
   

如果動作成功，UnassignUsertoApp 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

 
{
"Status": "Success"
}

範例：將群組指派給應用程式

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取 Assigngrouptoapp 動作，然後按一下「Done」。
3. 在「Connectors」任務的「Task Input」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似以下的值：

   {
      "GroupId": "00gl5wovm8GuLr8vg5d7",
       "AppId": "0oakn3j0bfGPR1Esk5d7"
   }
   

如果動作成功，Assigngrouptoapp 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

{
"Status": "Success",
"Id": "00gl5wovm8GuLr8vg5d7",
"LastUpdated": "2024-11-21 08:42:53.0",
"Priority": 0,
"_links_app_href": "https://dev-99779501.okta.com/api/v1/apps/0oakn3j0bfGPR1Esk5d7",
"_links_self_href": "https://dev-99779501.okta.com/api/v1/apps/0oakn3j0bfGPR1Esk5d7/groups/00gl5wovm8GuLr8vg5d7", "_links_group_href": "https://dev-99779501.okta.com/api/v1/groups/00gl5wovm8GuLr8vg5d7"
}

範例：將群組指派給角色

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取 AssignGrouptoRole 動作，然後按一下「Done」。
3. 在「Connectors」任務的「Task Input」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似以下的值：

   {
   "GroupId": "00gl9xqojqXq0TJgS5d7",
   "RoleId": "cr0l5tqddvkDtcfPl5d7",
   "Type": "CUSTOM", "ResourceSet": "iaml81kep6zefR4Oq5d7"
   }
   

如果動作成功，AssignGrouptoRole 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

{
"Status": "Success",
"Id": "irbla1k8uy8XxDDFF5d7",
"Label": "ReadAdmin_Altostrat",
"Type": "CUSTOM",
"Created": "2024-11-20 12:28:33.0",
"LastUpdated": "2024-11-20 12:28:33.0",
"AssignmentStatus": "ACTIVE",
"AssignmentType": "GROUP",
"resource-set": "iaml81kep6zefR4Oq5d7",
"role": "cr0l5tqddvkDtcfPl5d7",
"_links_role_href": "https://dev-99779501-admin.okta.com/api/v1/iam/roles/cr0l5tqddvkDtcfPl5d7",
"_links_resource-set_href": "https://dev-99779501.okta.com/api/v1/iam/resource-sets/iaml81kep6zefR4Oq5d7", "_links_permissions_href": "https://dev-99779501-admin.okta.com/api/v1/iam/roles/cr0l5tqddvkDtcfPl5d7/permissions", "_links_member_href": "https://dev-99779501.okta.com/api/v1/iam/resource-sets/iaml81kep6zefR4Oq5d7/bindings/cr0l5tqddvkDtcfPl5d7/members/irbla1k8uy8XxDDFF5d7", "_links_assignee_href": "https://dev-99779501.okta.com/api/v1/groups/00gl9xqojqXq0TJgS5d7"
}

範例：從應用程式中取消指派群組

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取 UnassignGrouptoApp 動作，然後按一下「Done」。
3. 在「Connectors」任務的「Task Input」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似以下的值：

   {
    "GroupId": "00gl5wovm8GuLr8vg5d7",
    "AppId": "0oakn3j0bfGPR1Esk5d7" 
   }
   

如果動作成功，UnassignGrouptoApp 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

{
"Status": "Success"
}

範例：取消指派角色的群組

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取 UnassignGrouptoRole 動作，然後按一下「Done」。
3. 在「Connectors」任務的「Task Input」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似以下的值：

   {
   "GroupId": "00gl5wovm8GuLr8vg5d7",
   "RoleAssignmentId": "irbl94sbyit77SGpg5d7"
   }
   

如果動作成功，UnassignGrouptoRole 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

{
"Status": "Success"
}

範例：將使用者停權

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取 SuspendUser 動作，然後按一下「Done」。
3. 在「Connectors」任務的「Task Input」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似以下的值：

   {
   "UserId": "00ulkdsubxO6W6LgJ5d7" 
   }
   

如果動作成功，SuspendUser 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

{
"Status": "Success"
}

範例：取消使用者停權

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取 UnsuspendUser 動作，然後按一下「Done」。
3. 在「Connectors」任務的「Task Input」部分，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似以下的值：

   {
   "UserId": "00ulkdsubxO6W6LgJ5d7" 
   }
   

如果動作成功，UnsuspendUser 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

{
"Status": "Success"
}

實體操作範例

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

範例：列出所有使用者

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取「使用者」。
3. 選取 List 作業，然後按一下「Done」。
4. 在「Connector」工作中的「Task Input」部分，您可以根據需求設定「filterClause」。

您必須使用單引號 (') 括住篩選器子句的值。您可以使用篩選子句，根據資料欄篩選記錄。

範例 - 取得使用者

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Users。
3. 選取 Get 作業，然後按一下「Done」。
4. 將實體 ID 設為「20001」，這是要傳遞的鍵。如要設定實體 ID，請在「資料對應」的「資料對應」專區中，按一下「開啟資料對應編輯器」，然後在「輸入值」欄位中輸入 "20001"，並選擇「EntityId」做為「Local」變數。

您必須直接傳遞實體 ID，例如「20001」。此處的「20001」是傳遞的唯一主鍵值

在傳遞實體 ID 會擲回錯誤的查詢中，您必須使用篩選器子句，因為會出現兩個複合鍵，例如 id='20001'

範例：刪除使用者

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Users。
3. 選取 Delete 作業，然後按一下「Done」。
4. 將實體 ID 設為「00ul7l5fdyTdHDfSj5d7」，這是要傳遞的鍵。如要設定實體 ID，請在「資料對應」的「資料對應」部分，按一下「開啟資料對應編輯器」，然後在「輸入值」欄位中輸入 "20001"，並選擇「EntityId」做為「Local」變數。

   如果實體有兩個複合式商家或主鍵，而非指定 entityId，您也可以將 filterClause 設為 id='00ul7l5fdyTdHDfSj5d7'。

範例：建立使用者

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Users。
3. 選取 Create 運算，然後按一下「Done」。
4. 在「資料對應」任務的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload 做為本機變數。

   { "ProfileFirstName": "Test",
       "ProfileLastName": "Test User",
       "ProfileEmail": "Test@gmail.com",
       "ProfileLogin": "Test11@example.com"
   }
   

   如果整合成功，Vendor 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

   {
       "Id": "00ula502hjbwWYsO25d7"
   }
   

範例：建立群組

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Groups。
3. 選取 Create 運算，然後按一下「Done」。
4. 在「資料對應」任務的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload 做為本機變數。

   {
       "ProfileDescription": "Googlecloud group",
       "ProfileName": "Goolecloud created grp\n"
   }
   

   如果整合成功，APBill 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

   {
       "Id": "00gl7lb5gniIAOMwA5d7"
   }
   

範例：建立應用程式

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Apps。
3. 選取 Create 運算，然後按一下「Done」。
4. 在「資料對應」任務的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload 做為本機變數。

   { "Label": "Googlecloud generated app",
       "SignOnMode": "AUTO_LOGIN",
       "AutoSubmitToolbar": false,
       "Settings": "{\"signOn\":{\"redirectUrl\":\"https://www.example.com\",\"loginUrl\":\"https://www.example.com\"}}"
   }
   

   這個範例會建立 Vendtype。如果整合成功，Vendtype 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

   {
       "Id": "0oal9vwooxEXXpdjS5d7"
   }
   

範例：建立角色

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Roles。
3. 選取 Create 運算，然後按一下「Done」。
4. 在「資料對應」任務的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload 做為本機變數。

   { "Label": "new role2", 
       "Description": "GABA Role1",
       "Permissions": "\"okta.users.read\", \"okta.groups.read\"" 
   }
   

   如果整合成功，Customer 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

   {
       "Id": "cr0l824rbiTvtJDoi5d7"
   }
   

範例：更新使用者

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Users。
3. 選取 Update 運算，然後按一下「Done」。
4. 在「資料對應」任務的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為「Local」變數。

   {
       "ProfileFirstName": "ShubhGillL" 
   }
   

5. 將資料對應工具中的實體 ID 設為 Users 實體。如要設定實體 ID，請按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。

   您可以將 filterClause 設為 20044，而非指定 entityId。

   執行這個範例時，會傳回類似以下的回應，並顯示在連接器工作項的 connectorOutputPayload 輸出變數中：

   {
       "Id": "00ul7u8cyobt8SGRK5d7" 
   }
   

範例：更新群組

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Groups。
3. 選取 Update 運算，然後按一下「Done」。
4. 在「資料對應」任務的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為「Local」變數。

   {
       "ProfileName": "Updated Googlecloud group"
   }
   

5. 將 Data Mapper 中的實體 ID 設為群組實體。如要設定實體 ID，請按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。

   您可以將 filterClause 設為 1371，而非指定 entityId。

   執行這個範例時，會傳回類似以下的回應，並顯示在連接器工作項的 connectorOutputPayload 輸出變數中：

   {
       "Id": "00gl92veg4VSQQb5A5d7"
   }
   

範例：更新應用程式

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Apps。
3. 選取 Update 運算，然後按一下「Done」。
4. 在「資料對應」任務的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為「Local」變數。

   {
       "Label": "Googlecloud updated label"
   }
   

5. 將 Data Mapper 中的實體 ID 設為應用程式的實體。如要設定實體 ID，請按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。

   您可以將 filterClause 設為 Customerid='10100'\n，而非指定 entityId。

   執行這個範例時，會傳回類似以下的回應，並顯示在連接器工作項的 connectorOutputPayload 輸出變數中：

   {
       "Id": "0oal9vwooxEXXpdjS5d7"
   }
   

範例：更新角色

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Roles。
3. 選取 Update 運算，然後按一下「Done」。
4. 在「資料對應」任務的「資料對應器」部分，按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為「Local」變數。

   {
       "Label": "Googlecloud updated label"
   }
   

5. 將 Data Mapper 中的實體 ID 設為角色實體。如要設定實體 ID，請按一下 Open Data Mapping Editor，然後在 Input Value 欄位中輸入類似下列的值，並選擇 EntityId/ConnectorInputPayload/FilterClause 做為本機變數。

   您可以將 filterClause 設為 1，而非指定 entityId。

   執行這個範例時，會傳回類似以下的回應，並顯示在連接器工作項的 connectorOutputPayload 輸出變數中：

   {
       "Id": "cr0l7dqeatRuIrn5x5d7"
   }