テーマ
トラブルシューティング
サインイン、権限、モデルの表示、API連携で問題が発生した場合の確認手順を説明します。発生している問題を順番に切り分けるページです。
対象読者
すべての利用者
知っておくこと
自分で解決できないときは、管理者へ連絡してください。サインイン、権限、モデルの公開状態で起きることが多い問題から順に確認します。入力エラーと API 連携は、そのあとの手順で扱います。
- 認証・テナント — サインイン、テナント選択
- 権限 — メニュー・操作の可否
- ワークフロー状態 — モデルの公開、プロセスの進行
手順
サインインできない
- テナントID が正しいか確認します(招待メール・社内案内)。
- パスワードを忘れた場合は、サインインの「パスワードを忘れた場合はこちら」に従います。
- メール確認が求められている場合は、登録メールの確認リンクを開きます(メールアドレスの確認)。
- 認証方式(Google でのサインインなど)がテナント設定と一致しているか確認します。
- 解決しない場合は、システム管理者にアカウント状態(無効化されていないか)の確認を依頼します。
画面・メニューが表示されない
- 画面右上で 正しいテナント が選ばれているか確認します。
- テナント未選択の場合は、テナントの選択・切り替え または アカウントコンソール からテナントを選びます。
- 特定メニューだけがない場合は、メニューと権限 の表と照合し、必要な権限を管理者に依頼します。
- 権限一覧で、付与されている権限を確認します。
操作ボタンが表示されない・押せない
- 「自分のワーク」の 「今対応できる」 に対象プロセスがあるか確認します(「今対応できる」にないプロセスでは、自分の操作順ではないためボタンは表示されません)。
- 「対応できるノードがありません」と表示される場合、別の担当者の対応待ちです。
- メニューは開けるが 編集・公開・削除 が使えない場合は、ロールに「書き込み」または「管理」があるか確認します(権限モデル)。
- プロセスの操作ボタンが出ない場合は、ワークフローエンジンの「実行」、そのノードのアクションポリシー、項目の表示と編集ならデータアクセスポリシーの順に確認します。
モデルが業務側に表示されない
- 管理者に、モデルが 公開済み か確認してもらいます(モデルの公開)。
- 公開済みでも、業務利用者に 開始ノードのアクションポリシー がなければ一覧に出ません。ポリシー設定を確認します。
- 業務利用者が 正しいテナント にサインインしているか確認します。
- 管理者は 公開中の定義を確認する で業務側の定義を確認できます。
エラー通知が表示されて処理が失敗する
- 入力内容の必須項目・形式を見直します。
- 「自分のワーク」から対象プロセスを開き、現在の状態と操作履歴を確認します。提出や承認が履歴に記録されている場合は、同じ操作を再実行しないでください。
- 操作が記録されていないことを確認できた場合だけ、入力内容を確認して再実行します。
- 成功したか判断できない場合は再実行せず、画面名、発生時刻、表示されたメッセージを記録して、ワークフロー管理者またはサポート問い合わせへ連絡します。
API連携でエラーが発生する
- HTTPステータスを確認します。401の場合は、認証用の Bearer トークンが期限切れまたは失効していないかと、
x-tenant-idを確認します。確認項目はAPI認証を参照してください。 - 400の場合は、必須項目、値の形式、条件式などの入力内容を確認します。
- 403の場合は、開発者ツールの API 画面(
/development/apis)で Operation ID を検索し、必要なシステム実行ポリシーを確認します。確認項目は認可の仕組みとAPI上の挙動を参照してください。 - 404の場合は、テナントID、モデルID、プロセスID、APIパスを確認します。
- 409などの競合の場合は、現在のプロセス状態と操作履歴を確認し、同じ更新を直ちに再実行しません。
/engineの403では、現在ノードのアクションポリシーと、リクエストで変更した項目のデータアクセスポリシーも確認します。/engineは、プロセスの開始、保存、提出、承認、却下、取り戻しを行うAPIです。- 業務利用者向けアプリから
/modelsや/processesを呼んでいる場合は、目的に合う/my/modelsや/my/processesへ切り替えます。 - ブラウザだけで失敗する場合は、接続元URL設定に呼び出し元のオリジンが登録されているか確認します。
@acomo/clientでTypeErrorが発生する場合は、既知の制限に該当するか確認します。- 500やタイムアウトの場合は、結果を確認するまで更新操作を再実行しません。
認証と認可の詳細はAPI認証と認可の仕組みとAPI上の挙動を参照してください。更新系APIがタイムアウトした場合は、対象データと操作履歴を確認するまで再実行しないでください。
うまくいかないとき
上記をすべて試しても解決しない場合は、次の情報を添えてシステム管理者またはワークフロー管理者、もしくはサポートへ連絡してください。
- 利用しているテナント名とテナントID
- 発生した画面・操作
- 表示されたエラーメッセージ(そのままコピー)
- 発生日時