Skip to main content

概要

SmartHR ツールでは、SmartHR の従業員(クルー)を管理できます。ページネーション付き一覧取得、詳細取得、作成、更新、削除、招待、部署解除が可能です。

主な機能

  • SMARTHR_LIST_CREWS
    • 従業員(クルー)一覧を取得。ページネーションと在職状況でのフィルタに対応。
  • SMARTHR_GET_CREW
    • 指定した ID の従業員の詳細を取得。
  • SMARTHR_CREATE_CREW
    • 氏名・メール・性別・雇用情報などで新規従業員を作成。
  • SMARTHR_UPDATE_CREW
    • 既存の従業員を更新。指定したフィールドのみ更新されます。
  • SMARTHR_DELETE_CREW
    • ID で従業員を削除。ステータスによっては削除できない場合があります。
  • SMARTHR_INVITE_CREW
    • 従業員に招待を送信。招待者のユーザー ID が必要です。
  • SMARTHR_DELETE_CREW_DEPARTMENTS
    • 従業員のすべての部署割り当てを解除。

認証

設定手順は SmartHR 認証情報 を参照してください。 各ツールでは subdomain(SmartHR のインスタンス URL)と access_token が必要です。アクセストークンはワークスペースのシークレットに SmartHR 認証情報として保存し、ツールの config で subdomain とともに指定します。 注意: API 認証情報は厳重に管理し、公開リポジトリにコミットしないでください。

例: クルー一覧取得と1件の詳細取得

- id: list_crews
  tool: SMARTHR_LIST_CREWS
  config:
    - name: subdomain
      value: "https://example.daruma.space"
    - name: access_token
      value: "{{secrets.SMARTHR_ACCESS_TOKEN.access_token}}"
  input:
    - name: page
      value: 1
    - name: per_page
      value: 10

- id: get_crew
  tool: SMARTHR_GET_CREW
  needs: ["list_crews"]
  config:
    - name: subdomain
      value: "https://example.daruma.space"
    - name: access_token
      value: "{{secrets.SMARTHR_ACCESS_TOKEN.access_token}}"
  input:
    - name: id
      value: "{{steps.list_crews.result.result[0].id}}"