従業員の更新

Personioインスタンス内の既存の従業員の属性を更新します。

オプション

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

空の値の受け渡し(Pass Empty Values)(Pass Empty Value?)

次のいずれかのオプションを選択します。

  • No:入力値が指定されない場合にフィールドを空の値で更新しません。

  • Yes: 入力値が指定されない場合にフィールドを空の値で更新します。

ドロップダウン

入力

データ型が日時または数値であるフィールドの入力値に関する制限事項については、既知の問題を参照してください。

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

職員(Employee)

IDまたはメール(ID or Email)

従業員またはそのメールアドレスの一意の識別子。

識別子は、Personioインスタンス内の従業員のURLから特定できます。

たとえば、URLがhttps://example.personio.de/staff/details/1234567であれば、従業員IDは1234567となります。

テキスト

属性(Attributes)

名(First Name)

従業員の名。

テキスト FALSE

姓(Last Name)

従業員の姓。

テキスト FALSE

戸籍上の性別(Gender)

記録されている従業員の性別。

テキスト FALSE

位置(Position)

社内での現在の役職。

テキスト FALSE

子会社(Subcompany)

この属性が使用される場合は、従業員が勤務する子会社。

テキスト FALSE

部門(Department)

企業内の部署またはグループ。

テキスト FALSE

オフィス(Office)

従業員が勤務する場所の地理的な場所。

テキスト FALSE

雇用日(Hire Date)

従業員の契約が有効になった日。このエントリの形式はYYYY-MM-DDです。

日時 FALSE

1週間あたり労働時間(Weekly Working Hours)

従業員が契約上合意している1週間の労働時間。

テキスト FALSE

上司のID(Supervisor ID)

従業員の上司の一意のID

テキスト FALSE

ステータス(Status)

従業員ステータス:OnboardingActiveInactiveLeave

ドロップダウン FALSE

カスタムフィールド(Custom Fields)

ユーザー定義の従業員項目。これは、Personio接続ごとに動的に生成されます。

各種

FALSE

出力

フィールド 定義 タイプ

結果(Result)

ステータスコード(Status Code)

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

  • 200ステータスコードは、リソースの更新に成功したことを示します。
  • 422エラーは、不随する情報メッセージによってリクエストが処理されなかったことを示します。
数値

既知の問題

  • データ型が日時のフィールドでは、Personioは年月日の値とタイムゾーンしか保存しません。完全な日時値の指定を試みると、日付の開始時に切り上げられます。たとえば、入力が2023-04-27T22:27:23.163Zの場合、Personioはこれを2023-04-27T00:00:00+03:00として保存します。

  • 整数値を使用するPersonioフィールドの更新を試みると、値の小数点以下は失われれます。たとえば、入力数値が23.45の場合、Personioフィールドには23のみが保存されます。

  • List Employeesアクションカードを使用するときは、Update Employeeアクションカードや直接API呼び出しを通じて従業員レコードが更新されないようにしてください。カードの実行中にソースが更新されると、一部のレコードが省略されたり、2回返されたりする場合があります。