申請が承認されたら（トリガー）
このピースでできることジョブカン経費精算・ワークフロー の接続方法ステップ 1：API トークンを取得するステップ 2：workrun に接続を追加するピースの設定項目1. フォーム（任意）取得できる情報出力例（抜粋）
このピースでできること
- ジョブカン経費精算・ワークフローで申請書が最終承認（完了）されたときに、自動でフローを開始します。
- フォームを指定して特定の申請フォームのみを対象にすることもできます。
ジョブカン経費精算・ワークフロー の接続方法
workrun と ジョブカン経費精算・ワークフロー を接続するには、ジョブカン経費精算・ワークフロー の API トークン が必要です。
ステップ 1：API トークンを取得する
- ジョブカン経費精算・ワークフローの管理画面にログインします。
- 画面上部のメニューから 「会社情報設定」 を開きます。
- 「共通ID連携・API管理」 をクリックします。
- API トークンの発行ボタンをクリックし、トークンを発行します。
- 発行された API トークン をコピーしておきます。
ステップ 2：workrun に接続を追加する
- workrun で ジョブカン経費精算・ワークフロー のアクションまたはトリガーをフローに追加します。
- 「接続を選択」の横にある 「＋ 新しい接続」 をクリックします。
- 「API Key」 フィールドに、ステップ 1 でコピーした API トークンを貼り付けます。
- 「保存」 をクリックして接続を完了します。
ピースの設定項目
1. フォーム（任意）
- トリガー対象にするフォームを選択します。指定しない場合はすべてのフォームの申請が対象になります。接続設定後にフォームの一覧が表示されます。
取得できる情報
最終承認されて完了した申請の一覧情報を、申請1件ずつ取得できます。
| 実際のキー | 内容・条件 |
|---|---|
| / / | 申請ID・識別番号・申請タイトル。 |
| / / / | 申請の状態・フォームID・フォーム名・フォーム種別。対象状態はcompletedです。 |
| / / | 申請者コード・姓・名。 |
| / / | 申請者の所属グループ名・コード・役職。 |
| / | 申請日時・最終承認日時。 |
| / / | 合計金額・支払期限・支払日。申請の種別や内容によって空や未提供になる場合があります。 |
| / / / | グループ・プロジェクトの名前やコード。提供される場合に利用できます。 |
- 申請一覧APIの各申請をそのまま返します。外側の の階層は出力に含めません。申請詳細や添付ファイルを追加取得する処理はありません。
- フォームを指定した場合はそのフォームの申請を対象にします。未指定の場合はフォームを限定しません。
- APIへ完了状態と承認日時の条件を指定し、前回確認した時刻より が新しい申請を返します。一度の取得は最大3ページの範囲です。
- テストも承認日時の条件を指定して取得するため、過去の完了申請があっても結果が空になる場合があります。
- を後続の申請詳細取得に、・・ を承認完了の通知に利用できます。
出力例（抜粋）
キーの使い方を示す架空例です。実際の値や全項目を示すものではありません。