申請一覧を取得する

このピースでできること

  • バクラク申請・経費精算の申請を一覧で取得します。
  • ステータスやフォームID、申請日時・承認日時の範囲でフィルタリングして取得できます。
  • 最大100件まで取得でき、並び替えやページング(offset)にも対応しています。

バクラク申請・経費精算 の接続方法

workrun と バクラク申請・経費精算 を接続するには、バクラク申請・経費精算 の API キー が必要です。

ステップ 1:API キーを取得する

  1. バクラク共通管理の「管理者」権限のアカウントでバクラクにログインします。
  1. バクラク共通管理の 設定 > API管理 を開きます。
  1. 「APIキーの新規作成」 ボタンを押し、申請・経費精算の申請の読み込み・書き込みスコープを許可したAPIキーを発行します。
  1. 発行されたAPIキーをコピーしておきます。

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

  1. workrun で バクラク申請・経費精算 のアクションをフローに追加します。
  1. 「接続を選択」の横にある 「+ 新しい接続」 をクリックします。
  1. 「API Key」 フィールドに、ステップ 1 でコピーしたAPIキーを貼り付けます。
  1. 「保存」 をクリックして接続を完了します。

ピースの設定項目

1. ステータス(任意)

  • 取得する申請のステータスを絞り込みたい場合に選択します。選択しない場合はすべてのステータスの申請が取得されます。
  • 選択肢: 進行中(IN_PROGRESS)、承認済(APPROVED)、却下(REJECTED)、差し戻し(REMANDED)、取り消し(CANCELED)、承認後取消(CANCELED_AFTER_APPROVED)

2. フォームID(任意)

  • 特定のフォームの申請のみ取得したい場合に入力します。完全一致で検索されます。
  • フォームIDは「設定 > フォーム一覧」から任意のフォームの編集ボタンをクリックし、表示されたURLの末尾で確認できます。
  • 例:

3. 申請日時の下限(任意)

  • この日時以降に申請されたものを取得します。RFC 3339形式で入力します。

4. 申請日時の上限(任意)

  • この日時以前に申請されたものを取得します。RFC 3339形式で入力します。

5. 承認日時の下限(任意)

  • この日時以降に承認された申請を取得します。RFC 3339形式で入力します。

6. 承認日時の上限(任意)

  • この日時以前に承認された申請を取得します。RFC 3339形式で入力します。

7. 並び替え項目(任意)

  • 取得する申請の並び順の基準を選択します。選択しない場合は申請日時で並び替えられます。
  • 選択肢: 申請日時(OPENED_AT)、承認日時(APPROVED_AT)

8. 並び順(任意)

  • 昇順(ASC)または降順(DESC)を選択します。

9. 取得件数の上限(任意)

  • 最大100件まで指定できます。指定しない場合は25件取得します。

10. 取得開始位置(任意)

  • 取得を開始する位置(オフセット)を指定します。指定しない場合は0件目から取得します。ページングを行う際に使用します。