従業員を取得
このピースでできること
- SmartHRの従業員一覧を取得します。
- 社員番号・部署・役職などの条件で絞り込んで、SmartHRの従業員情報を検索できます。
SmartHR の接続方法
以下の2つを入力して接続します。
サブドメイン
SmartHR の URL のサブドメインを入力します。
例: URL が の場合、サブドメインは example です。
アクセストークン
- SmartHR 管理画面にログインします
- 「設定」→「外部システム連携」→「アクセストークン」 を開きます
- 「トークンを発行する」 をクリックします
- 利用する機能に応じてアクセス権限を設定します
- 従業員の取得・登録・更新を使用する場合は、従業員の参照・更新 と 部署・役職・雇用形態・事業所・給与支給形態の参照 を許可してください
- 発行されたアクセストークンをコピーし、接続画面の 「アクセストークン」 欄に貼り付けます
サンドボックス環境（任意）
テスト・検証用のサンドボックス環境を使用する場合はチェックを入れてください。本番環境では不要です。
ピースの設定項目
1. 社員番号（任意）
- SmartHR上の従業員を社員番号で絞り込みたい場合に指定します。
- 一致する社員番号の従業員のみが取得対象になります。
[設定例]
2. 部署（任意）
- SmartHRの部署で絞り込みたい場合に指定します。
- 接続情報（サブドメイン・アクセストークン）をもとに、SmartHR APIから部署の候補が表示されます。
[設定例]
3. 役職（任意）
- SmartHRの役職で絞り込みたい場合に指定します。
- 接続情報（サブドメイン・アクセストークン）をもとに、SmartHR APIから役職の候補が表示されます。
[設定例]
4. 並び順（任意）
- 取得結果の並び順（ソート順）を指定します。
- 例のように のように先頭に を付けると降順になります。
[設定例]