2021年8月8日Garoon APIアップデート情報
API更新情報
2021年8月8日に実施するメンテナンスにおける、Garoon APIのアップデート内容は次のとおりです。
今月のGaroon API
8月版の定期メンテナンスで、経路種別が「承認(全員)」のワークフローにおける、申請の最終承認に関する不具合を修正します。
これまで経路種別が「承認(全員)」の申請において、ステータスが承認済み(APPROVEDまたはapproved)に変更されるタイミングや、最終承認日に日時が設定されるタイミングは、最終承認者のいずれか一人が承認したときでした。
定期メンテナンス以降では、これらのタイミングは最終承認者の全員が承認したときに変わります。
最終承認時に却下したとき、ステータスが却下(REJECTEDまたはrejected)に変更されるタイミングは、これまでとおり変更はありません。
ステータスが却下に変更されるタイミングは、最終承認者のいずれか一人が却下したときです。
Garoon JavaScript API
機能追加
スケジュールに関するイベントを追加しました
対象API
-
予定の登録に成功したときのイベント
-
schedule.event.create.submit.success
-
ポップアップウィンドウで予定の登録に成功したときのイベント
-
schedule.event.quick.create.submit.success
通常予定をかんたんに登録する機能 で、予定の登録が成功した後のイベントです。 -
予定を変更するときのイベント
-
schedule.event.edit.submit.success
-
ドラッグ&ドロップで予定の変更に成功したときのイベント
-
schedule.event.quick.edit.submit.success
ドラッグ&ドロップで予定の日時を変更する機能 で、予定の変更に成功した後のイベントです。
メール送信前イベントでfalseを返却すると、Garoonのエラーダイアログが表示されずにメール送信を中止できるようになりました
対象イベント
メールを送信する前のイベント
- mail.mail.send.submit
Garoon REST API
機能追加
プロキシAPI設定 を取得、登録、更新、削除できるAPIを追加しました
対象API
-
プロキシAPIの設定を取得する
-
/g/api/v1/system/api/proxies/code/{proxyCode}
[GET] -
プロキシAPIの設定を登録する
-
/g/api/v1/system/api/proxies
[POST] -
プロキシAPIの設定を更新する
-
/g/api/v1/system/api/proxies/code/{proxyCode}
[PATCH] -
プロキシAPIの設定を削除する
-
/g/api/v1/system/api/proxies/code/{proxyCode}
[DELETE]
不具合修正
ワークフローにおいて、申請の最終承認日時を条件に指定して申請データを検索したとき、ステータスが「IN_PROGRESS」の申請データが取得されてしまう現象を解消しました
対象API
申請データを取得する
- /g/api/v1/workflow/admin/requests
発生条件
- 経路種別が「承認(全員)」の申請
- 最終承認者が複数設定されている。
- 申請の最終承認日時(
rangeStartApprovedAt
とrangeEndApprovedAt
)を条件に指定して、対象APIを実行する。
修正内容
取得できる申請データは次のとおりです。
- 修正前
- 最終承認者のいずれか一人が承認した申請(「IN_PROGRESS」)
- 承認済みの申請(「APPROVED」「COMPLETED」)
- 却下された申請データ(「REJECTED」)
- 修正後
- 承認済みの申請(「APPROVED」「COMPLETED」)
- 却下された申請データ(「REJECTED」)
Garoon SOAP API
不具合修正
ワークフローにおいて、申請の最終承認日時を条件に指定して申請データを検索したとき、ステータスが「inprogress」の申請データが取得されてしまう現象を解消しました
対象API
管理者として申請情報を取得する
- WorkflowGetRequests
発生条件
- 経路種別が「承認(全員)」の申請
- 最終承認者が複数設定されている。
- 申請の最終承認日時(
@start_approval_date
と@end_approval_date
)を条件に指定して、対象APIを実行する。
修正内容
取得できる申請データは次のとおりです。
- 修正前
- 最終承認者のいずれか一人が承認した申請(「inprogress」)
- 承認済みの申請(「approved」「completed」)
- 却下された申請データ(「rejected」)
- 修正後
- 承認済みの申請(「approved」「completed」)
- 却下された申請データ(「rejected」)
製品のアップデート情報
API以外のGaroonのアップデートに関する情報は、
クラウド版Garoon更新情報
を参照してください。
8月定期メンテナンス分は後日公開されます。