ユーザーの更新

Greenhouse内のユーザーの基本情報を編集します。

オプション

フィールド 定義 タイプ 必須

更新条件（Update By）

ユーザーレコードを識別する1つのオプションを選択します。3つのオプションがあります。

  • User ID： GreenhouseユーザーID

  • Email：Greenhouseに保存されているユーザーのメールアドレス

  • Employee ID：ユーザーの社員ID（利用可能な場合）

ユーザーのアカウントに割り当てられたすべてのメールアドレスは、アクションのルックアップに利用できます。ただし、メールアドレスを複数のユーザーアカウントに含めることはできません。

 ドロップダウン 正

空の値の受け渡し？（Pass Empty Values?）

フィールドの更新をスキップする代わりに、リモートシステムに空の値を渡すかどうかを示します。

  • Yes：カードの入力フィールドが空白の場合、またはnull値が指定されている場合、その空のフィールドが更新に含まれます。これにより、リモートシステム上にあるそのフィールドの既存の値が消去されます。
  • No：カードの入力フィールドが空白の場合、またはnull値が指定されている場合、リモートシステム上のそのフィールドには何も送信されません。リモートシステム上の既存の値は変更されません。
 ドロップダウン 正

入力

フィールド 定義 タイプ 必須

～に代わって（On Behalf Of）

ユーザーID（User ID）

このリクエストを発行するユーザーのID。

監査目的では必須。

 数値 正

ユーザー（User）

ユーザー（User）セクションには、更新者（Update By）オプションの選択内容に基づいて、次のフィールドのいずれか1つが表示されます。

ID

ユーザーの一意識別子。 数値 正

メールアドレス（Email）

このユーザーに関連付けられた任意のメールアドレス。

 テキスト 正

社員ID（Employee ID）

ユーザーの一意の外部ID。 テキスト 正

アップデート（Update）

名（First Name）

ユーザーの名。

選択した場合、このフィールドは空白にできません。

 テキスト FALSE

姓（Last Name）

ユーザーの姓。

選択した場合、このフィールドは空白にできません。

 テキスト FALSE

社員ID（Employee ID）

ユーザーの一意の外部ID。 テキスト FALSE

事業所ID（Office IDs）

ユーザーの新しい事務所。

このオプションを選択するときは、外部事務所ID（External Office IDs）を空白にする必要があります。

空の値を渡す？（Pass Empty Values?）がYesに設定されている場合、空白の配列はこのユーザーのすべての事務所を削除します。

 数値のリスト FALSE

外部事務所ID（External Office IDs）

これは、事務所ID（Office IDs）の代わりに使用できます。各数値は、外部システム内の事務所のIDを表します。

このオプションを選択するときは、事務所ID（Office IDs）を空白にする必要があります。

 数値のリスト FALSE

部門ID（Department IDs）

ユーザーの新しい部門の名前。

このオプションを選択するときは、外部部門ID（External Department IDs）を空白にする必要があります。

空の値を渡す？（Pass Empty Values?）がYesに設定されている場合、空白の配列はこのユーザーのすべての部門を削除します。

 数値のリスト FALSE

外部部門ID（External Department IDs）

これは、部門ID（Department IDs）の代わりに使用できます。各数値は、外部システム内の部門のIDを表します。

このオプションを選択するときは、部門ID（Department IDs）を空白にする必要があります。

 数値のリスト FALSE

カスタムフィールド（Custom Fields）

このユーザーを更新するためのすべてのカスタムフィールドが含まれるカスタムフィールドオブジェクトのリスト。

 オブジェクトのリスト FALSE

出力

フィールド 定義 タイプ

レスポンス（Response ）

ステータスコード（Status Code）

操作の結果。コネクターは、カードによって実行されたアクションの成否を示すHTTPステータスコードを返します。例：

  • 201 Createdステータスコードは、アクションが成功し、新しいリソースが作成されたことを示します。
  • 403 Forbiddenエラーは、必要な権限が不足していたためにHTTPリクエストが処理されなかったことを示します。

発生する可能性があるステータスコードの完全なリストについては、HTTPステータスコードを参照してください。

 数値

関連項目

Greenhouseコネクター

Okta Workflowsの要素について

Greenhouse Harvest API