AIに聞くお問い合わせ
AIに聞くお問い合わせ
workrun ヘルプサイト/アイデンティティ一覧を取得する

アイデンティティ一覧を取得する

このピースでできること

  • マネーフォワード Admina の組織に登録されたアイデンティティ（従業員・メンバー情報）を一覧で取得します。
  • 在籍ステータス・従業員種別・部署・会社・勤務地・アラート種別などの条件で絞り込んで取得できます。
  • カーソルを使ったページネーションで大量データを分割取得できます。
  • デバイス・アカウントなどの関連データを同時に展開して取得することもできます。

マネーフォワード Admina の接続方法

workrun とマネーフォワード Admina を接続するには、Admina の API キー と 組織 ID が必要です。

ステップ 1：API キーと組織 ID を取得する

  1. Admina 管理画面にログインします。
  1. 設定 > APIキー一覧 を開きます。
  1. 「新規発行」 ボタンをクリックして API キーを発行します。
      • API キーは発行直後の 1 回のみ 表示されます。必ずコピーして安全な場所に保管してください。
  1. 同じページに表示される 組織 ID（数値）もコピーしておきます。

ステップ 2：workrun に接続を追加する

  1. workrun でマネーフォワード Admina のアクションをフローに追加します。
  1. 「接続を選択」の横にある 「＋ 新しい接続」 をクリックします。
  1. 「API キー」 フィールドに、ステップ 1 でコピーした API キーを貼り付けます。
  1. 「組織 ID」 フィールドに、ステップ 1 でコピーした組織 ID を貼り付けます。
  1. 「保存」 をクリックして接続を完了します。

ピースの設定項目

1. 取得件数（任意）

  • 1回のリクエストで取得する最大件数を数値で入力します。最大200まで指定できます。省略した場合はデフォルト件数が返されます。

2. 次ページ取得用カーソル（任意）

  • 前回の取得結果に含まれる の値を入力すると、次のページのデータを取得できます。初回取得時は不要です。

3. キーワード（任意）

  • 名前・メールアドレス・部署名などで前方一致検索します。

4. 管理タイプ（任意）

  • 絞り込む管理タイプを複数選択できます。選択肢：社内ID / 外部ID / システムID / 不明ID / 未管理ID

5. 従業員種別（任意）

  • 絞り込む従業員種別を複数選択できます。選択肢：役員 / 正社員 / 契約社員 / 派遣従業員 / パート従業員 / 出向従業員 / 契約従業員 / コラボレーター / グループアドレス / 共用アドレス / テストアドレス / その他 / 不明 / 未管理

6. 在籍ステータス（任意）

  • 絞り込む在籍ステータスを複数選択できます。選択肢：就業中 / 休職中 / 下書き / 入社前 / 退職済 / 未監視 / アーカイブ

7. 会社（任意）

  • 絞り込む会社をドロップダウンから複数選択できます。接続先の Admina 組織に登録された会社一覧が表示されます。

8. 部署（任意）

  • 絞り込む部署をドロップダウンから複数選択できます。接続先の Admina 組織に登録された部署一覧が表示されます。

9. 勤務地（任意）

  • 絞り込む勤務地をドロップダウンから複数選択できます。接続先の Admina 組織に登録された勤務地一覧が表示されます。

10. アラート種別（任意）

  • 絞り込むアラート種別を複数選択できます。選択肢：退職者アカウント / 休眠アカウント / 休職者アカウント / 不明なアカウント / 公開ファイル

11. 展開する関連データ（任意）

  • 取得結果に含めたい関連データを複数選択できます。選択肢：デバイス / アカウント / カスタムフィールド定義 / 関連アイデンティティ

12. マネージャー ID（任意）

  • 特定のマネージャーが紐付いたアイデンティティのみ絞り込む場合に、マネージャーのアイデンティティ ID を入力します。ID は「アイデンティティ一覧を取得する」アクションの結果に含まれる で確認できます。

13. サービス ID（任意）

  • Admina に登録された特定の SaaS サービスの ID で絞り込みます。

14. 従業員マスタ連携の有無（任意）

  • 従業員マスタとの連携があるアイデンティティのみ絞り込む場合に選択します。選択肢：はい / いいえ

15. デバイス割り当ての有無（任意）

  • デバイスが割り当てられているアイデンティティのみ絞り込む場合に選択します。選択肢：はい / いいえ

16. SaaS アカウントの有無（任意）

  • SaaS アカウントが紐付いているアイデンティティのみ絞り込む場合に選択します。選択肢：はい / いいえ

17. 契約開始日の範囲（開始）（任意）

  • 契約開始日の範囲絞り込みの開始日を指定します。終了日（契約開始日の範囲（終了））と両方入力した場合のみ有効になります。例：2024-07-05

18. 契約開始日の範囲（終了）（任意）

  • 契約開始日の範囲絞り込みの終了日を指定します。開始日（契約開始日の範囲（開始））と両方入力した場合のみ有効になります。例：2024-07-05

19. 契約終了日の範囲（開始）（任意）

  • 契約終了日の範囲絞り込みの開始日を指定します。終了日と両方入力した場合のみ有効になります。例：2024-07-05

20. 契約終了日の範囲（終了）（任意）

  • 契約終了日の範囲絞り込みの終了日を指定します。開始日と両方入力した場合のみ有効になります。例：2024-07-05

21. 作成日の範囲（開始）（任意）

  • アイデンティティの作成日の範囲絞り込みの開始日を指定します。終了日と両方入力した場合のみ有効になります。例：2024-07-05

22. 作成日の範囲（終了）（任意）

  • アイデンティティの作成日の範囲絞り込みの終了日を指定します。開始日と両方入力した場合のみ有効になります。例：2024-07-05

23. 更新日の範囲（開始）（任意）

  • アイデンティティの更新日の範囲絞り込みの開始日を指定します。終了日と両方入力した場合のみ有効になります。例：2024-07-05

24. 更新日の範囲（終了）（任意）

  • アイデンティティの更新日の範囲絞り込みの終了日を指定します。開始日と両方入力した場合のみ有効になります。例：2024-07-05

25. 並び替えフィールド（任意）

  • 取得結果の並び替えに使うフィールドを選択します。選択肢：名前 / 種別 / ステータス / 会社 / 部署 / 勤務地 / サービス数 / デバイス数 / コスト（USD）/ コスト（JPY）/ 従業員ID / 契約開始日 / 契約終了日 / 休止開始日 / 休止終了日 / 作成日 / 更新日 / 役職

26. 並び順（任意）

  • 並び替えの昇順・降順を選択します。選択肢：昇順 / 降順