List Employees（従業員の一覧表示）
Personioインスタンス内の従業員を一覧表示します。
オプション
| フィールド | 定義 | タイプ | 必須 |
|---|---|---|---|
| 結果セット |
検索結果を表示するために次のオプションのいずれかを選択します。
|
ドロップダウン | TRUE |
多数のレコードを返す方法については、「ヘルパーフローでのストリーム一致オプションの設定」を参照してください。
入力
| フィールド | 定義 | タイプ | 必須 |
|---|---|---|---|
| Streaming（ストリーミング） | |||
| Flow（フロー） |
このフィールドは、［Result Set（結果セット）］オプションで［Stream Records（レコードのストリーミング）］を選択した場合に表示されます。 ［Choose Flow（フローの選択）］をクリックして検索結果のストリーミング先となるヘルパーフローを選択し、［Choose（選択）］をクリックして確定します。 オプションとして、［Click or drop here to create（クリックまたはここにドロップして作成）］の下の空のフィールドをクリックし、データをヘルパーフローに渡すカスタム拡張可能フィールドを追加します。これらのフィールドは、キーと値のペアとして追加され、ヘルパーフロー内の［State（状態）］出力オブジェクトからアクセスできます。 ヘルパーフローは、Record（レコード）という入力オブジェクトを指定する必要があります。 ストリーミングされるレコードを取得するには、ストリーミングヘルパーフロー内のHelper Flowカードの入力フィールドが、渡されるRecord（レコード）オブジェクト内のRecord（レコード）サブオブジェクトを参照する必要があります。Record（レコード）サブオブジェクトには従業員情報が含まれます。 渡される状態入力値を取得するには、渡されるオブジェクト内のState（状態）サブオブジェクトを参照します。 |
フロー | TRUE |
| Record limit（レコード制限） |
このフィールドは、［Result Set（結果セット）］オプションで［Stream Records（レコードのストリーミング）］を選択した場合に表示されます。 ストリーミングするレコードの数を指定します。
|
数値 | FALSE |
出力
結果は、カードの［Options（オプション）］セクションで［Result Set（結果セット）］として何を選択したかによって変わります。
| フィールド | 定義 | タイプ |
|---|---|---|
| Result（結果） | ||
| Employee（従業員） | オブジェクトのリスト | |
| ID | 従業員の一意のID | テキスト |
| First Name（名） | 従業員の名 | テキスト |
| Last Name（姓） | 従業員の姓 | テキスト |
| Email（メール） |
従業員のメールアドレス。 これは、インポート時の従業員データの割り当てに使用される一意の識別子として事前に定義されます。 |
テキスト |
| Gender（性別） | 従業員の性別 | テキスト |
| Status（ステータス） | 従業員のステータス：Onboarding（オンボーディング）、Active（アクティブ）、Inactive（非アクティブ）、Leave（休職中） | テキスト |
| Position（役職） | 社内での現在の役職 | テキスト |
| Supervisor（上司） |
従業員の上司
|
オブジェクト |
| Employment Type（雇用形態） | 従業員が内部で雇用されているか、外部で雇用されているかを示します | テキスト |
| Weekly Hours（1週間あたり労働時間） | 従業員が契約上合意している1週間の労働時間。この値は従業員の給与にリンクされます。 | テキスト |
| Hire Date（雇用日） | 労働契約が有効になった日付 | 日時 |
| Contract End Date（契約終了日） | 有期労働契約が終了する日付 | 日時 |
| Termination Date（終了日） | 雇用が終了する日付。この日付を超えると、従業員のステータスは自動的にInactive（非アクティブ）に設定されます | 日時 |
| Termination Type（終了タイプ） | 雇用終了の種別 | テキスト |
| Termination Reason（終了理由） | 終了の理由 | テキスト |
| Probation Period End Date（試用期間終了日） | 試用期間の終了日 | 日時 |
| Created At（作成日時） | 従業員レコードの作成日 | 日時 |
| Last Modified（最終変更） | 従業員レコードが最後に更新された日付 | 日時 |
| Subcompany（子会社） |
子会社がセットアップされている場合に、従業員が勤務する子会社
|
オブジェクト |
| Office（オフィス） |
従業員が勤務するオフィス
|
オブジェクト |
| Department（部署） |
従業員が勤務する部署
|
オブジェクト |
| Cost Center（コストセンター） |
関連するコストセンター。複数のコストセンターを選択し、それぞれに異なる請求割合を割り当てることができます。
|
オブジェクトのリスト |
| Public Holidays（祝祭日） |
従業員の祝祭日
|
オブジェクト |
| Absence Entitlements（欠勤資格） |
従業員の欠勤資格
|
オブジェクトのリスト |
| Work Schedule（勤務スケジュール） |
従業員の勤務スケジュール
|
オブジェクト |
| Fixed Salary（固定給） |
従業員の固定給
|
オブジェクト |
| Salary Interval（給与間隔） | 給与の支払い間隔 | テキスト |
| Hourly Salary（時給） |
従業員の時給
|
オブジェクト |
| Vacation Day Balance（残り休暇日数） | 利用できる休暇日数 | 数値 |
| Last Day of Work（勤務終了日） | 雇用の最終日 | 日時 |
| Profile Picture（プロフィール画像） | 従業員のプロフィール画像のURL | テキスト |
| Team（チーム） |
従業員のチーム
|
オブジェクト |
| Custom Fields（従業員カスタム項目） | ユーザー定義の従業員項目。接続ごとに動的に生成されます。 | 各種 |
| Result（結果） | ||
| Records Streamed（ストリーミングされたレコード） |
［Result Set（結果セット）］オプションが［Stream Records（レコードのストリーミング）］ に設定されている場合に表示されます。 ストリーミングフロー内でストリーミングされたレコードの数。 |
数値 |
既知の問題
List Employeesアクションカードを使用するときは、Update Employeeアクションカードや直接API呼び出しを通じて従業員レコードが更新されないようにしてください。カードの実行中にソースが更新されると、一部のレコードが省略されたり、2回返されたりする場合があります。
また、パフォーマンス向上のために、API資格情報の作成中に指定する［Readable employee attributes（読み取り可能な従業員属性）］の数は制限してください。