🚨
よくあるエラー対応
業務アセットの同期が失敗した場合
同期実行ログ（設定 > 業務アセット > 同期実行ログ）でエラーの詳細をご確認ください。
| 状況 | 考えられる原因 | お客様による対処方法 |
|---|---|---|
| 「認証に失敗しました」のようなエラーが表示される | 連携先サービスへの認証情報（APIキー・アクセストークンなど）の期限が切れているか、無効になっている | 業務アセットの設定画面で認証情報を再設定・再認証してください |
| 「権限がありません」のようなエラーが表示される | 連携先サービス上でYESODアプリに必要な権限が付与されていない | 連携先サービスの管理画面でYESODアプリへの権限（スコープ）を確認・再付与してください |
| 「リクエスト数の制限に達しました」のようなエラーが表示される | 連携先サービスのAPI利用上限に達している | 数十分〜数時間ほど時間をおいてから、手動で同期を再実行してください |
| 「同期する項目」に設定した属性の値が取得できずエラーになる | 対象メンバーの該当属性に値が設定されていない、または属性式の記述に問題がある | 対象メンバーに該当属性の値が登録されているかご確認ください。属性式を使用している場合は、値が存在しない場合の処理（、 など）が記述されているかご確認ください |
| 連携先サービス側のエラーが発生している | 連携先サービス自体が一時的に障害を起こしている | 連携先サービスのステータスページをご確認のうえ、時間をおいて再実行してください |
| グループ属性が重複しているエラーが発生する | YESOD内に同じ属性値を持つグループが複数存在するか、連携先サービスに未連携のグループと属性値が重複している | 重複している属性値を持つグループを特定し、属性値を修正してから再度同期してください |
| 「同期する項目」に設定した属性式でエラーになる（構文エラー） | 属性式の書き方に誤りがある（括弧の対応ミス、メソッド名の誤りなど） | 業務アセット > 同期する項目の属性式をご確認ください。括弧の対応やメソッド名の綴りに誤りがないかご確認ください |
| 属性式は正しいがエラーになる（評価エラー） | 属性式で参照している値が存在しないメンバーがいる（所属組織や項目が未設定など） | 属性式に値が存在しない場合の処理（ のような記述）を追加してください |
| 接続が途切れてエラーになる | 連携先サービスとの通信が一時的に切断された | しばらく時間をおいて再実行してください。繰り返し発生する場合はサポートへお問い合わせください |
| 一部のメンバーだけ属性同期が失敗する | 特定のメンバーのデータに問題がある（属性値の形式が不正など） | 同期実行ログの「属性同期エラー」で失敗したメンバーを確認し、対象メンバーの属性値や連携先でのアカウント状態をご確認ください |
| アカウントの取り込みに失敗する | 連携先サービスからアカウント情報の取得に失敗している（認証エラー・サービス側エラーなど） | 認証情報に問題がないかご確認のうえ、手動でアカウント取り込みを再実行してください |
タスクの実行が失敗した場合
タスクの実行結果は 設定 > 業務アセット > タスク一覧 よりご確認いただけます。
| タスク種別 | 状況 | 考えられる原因 | お客様による対処方法 |
|---|---|---|---|
| アカウント作成 | 「ユーザーの作成に失敗しました。」と表示される | 対象のメンバーがYESODに存在しない、または退職済みになっている | 対象メンバーが有効な状態かご確認ください。前倒し実行を使用している場合は、タスクの実行日とメンバーの在籍期間が一致しているかご確認ください |
| アカウント作成 | 「アカウントの作成・更新に失敗しました。」と表示される | 連携先サービス側でアカウントの作成・更新に失敗している（必須項目の未設定、値の形式不正など） | 同期実行ログのエラー詳細をご確認ください。業務アセットの「同期する項目」に必須項目が設定されているかご確認ください |
| アカウント削除・無効化 | 「対象のアカウントが見つかりません」のようなエラーが表示される | YESODに対象メンバーのアカウントが登録されていない、またはアカウント情報が未取り込み | アカウント一覧でメンバーとアカウントの紐付けをご確認ください。アカウントが未登録の場合は、アカウント取り込みを実行してください |
| 権限付与 | 「割当項目が見つかりません」「アカウント情報が見つかりません」のようなエラーが表示される | 業務アセットの割当設定が変更・削除されているか、アカウントが取り込まれていない | 業務アセットの割当設定をご確認ください。アカウントが正しくインポートされているかご確認ください |
| 権限剥奪 | 同上 | 同上 | 同上 |
| パスワードリセット | 「有効なメンバーではありません」と表示される | 対象メンバーが退職済みなど、現在無効な状態になっている | 対象メンバーの在籍状況をご確認ください |
| グループ作成 | 「グループが見つかりません」と表示される | YESOD上で対象グループが削除されている | グループが存在するかご確認ください。グループが削除されている場合は、タスクをキャンセルしてグループを再作成してください |
| グループ作成 | 「割当の設定が見つかりません」のようなエラーが表示される | 業務アセットの割当設定が変更・削除されている | 業務アセットの割当設定をご確認・修正ください |
| グループ属性同期 | 一部のグループの属性更新に失敗している | グループの属性設定内容や、連携先サービス側の状態に問題がある | 同期実行ログで失敗したグループをご確認のうえ、グループの属性設定値や連携先サービスでのグループ状態をご確認ください |
| すべてのタスク共通 | 「システムエラーが発生しました。時間をおいて再度お試しください。」と表示される | システム側で一時的なエラーが発生している | しばらく時間をおいてから再実行してください。改善しない場合はサポートへお問い合わせください |
よくあるご確認事項
- 通知メールが届いた場合：業務アセットに通知先メールアドレスを設定されている場合、同期が失敗したタイミングで「○○の同期が失敗しました」という件名のメールが送信されます。メール内のリンク、またはYESODの 設定 > 業務アセット > 同期実行ログ から詳細をご確認ください。
- 一部のメンバーだけ同期が失敗する場合：同期実行ログの「属性同期エラー」に失敗したメンバーが記録されています。次回の同期が正常に完了すると、このエラーログはリセットされます。
- 上記を確認しても解決しない場合：サポートページよりお問い合わせください。その際、同期実行ログの詳細（実行日時・業務アセット名・エラーメッセージ）を合わせてご共有いただくとスムーズに対応できます。
その他、不明な点は、カスタマーサクセスにお問い合わせください。