トラブルシューティング
起動や取込で問題が発生した場合の対処方法をまとめます。ここに記載のない症状については サポート・FAQ もご確認ください。
起動関連
アプリが起動しない / 白い画面のまま
- 原因候補: Microsoft Edge WebView2 Runtime が不足。
- 対処: Microsoft 公式サイトから WebView2 Runtime（Evergreen Bootstrapper）を導入。Windows 11 は通常プリインストール済み。
起動直後に「利用規約・免責事項」画面が毎回表示される
- 原因候補: ユーザーデータフォルダの書き込み権限不足、または規約改訂。
- 対処: 規約改訂時は再同意が必要です（改訂版の公開履歴あり）。それ以外の場合は
%LocalAppData%\SumikkoLab\DmarcAnalysisAssistantの書き込み権限を確認。
レポート取込関連
「取込」を押しても 0 件と表示される
- 原因候補: フォルダ内に DMARC 集約レポート（XML / ZIP / GZ）が存在しない。別種のメールを誤指定。
- 対処: ZIP / GZ 添付ファイルをフォルダに保存し直して再試行。ファイル名に
dmarcまたはruaを含む場合が多い。
取込時に「XML 解析エラー」
- 原因候補: レポートの破損、文字コード不整合、非標準スキーマ。
- 対処: 対象ファイルを除外して再取込。該当ファイルのプロバイダ・ファイル名を控えてサポートまでご連絡ください。
取込に極端に時間がかかる
- 原因候補: フォルダ内のファイル数が数千件規模、または大容量 ZIP。
- 対処: 月別にサブフォルダへ分割して取り込む。バックグラウンドスキャンは 1 回の取込に閉じているため、フォルダを分けると段階的に進められます。
バウンス突合関連
「バウンス」ラベルが 1 件もつかない
- 原因候補: バウンスフォルダが未指定、またはバウンスメールの件名が非標準。
- 対処: バウンスフォルダを明示的に指定。ISP によっては多言語件名の場合があり、未対応の可能性あり。
Microsoft 365 連携関連
サインインに失敗する
- 原因候補: テナントの条件付きアクセスでブロック、Mail.Read 権限の同意がまだ、ネットワーク未接続。
- 対処: 管理者にアプリの同意可否を確認。個人アカウントでも動作しますが、組織アカウントでは管理者同意が必要な場合があります。
サインインは通るがメールが取れない
- 原因候補: Mail.Read が付与されていない、対象フォルダが空。
- 対処: 別クライアントでメールの存在を確認。権限スコープは Mail.Read（読み取り専用）のみ使用します。
CSV エクスポート関連
Excel で開くと文字化け
- 原因候補: Excel の既定エンコーディング。
- 対処: 本ツールの CSV は UTF-8 BOM 付きで出力します。Excel 365 は通常そのまま読めます。古い Excel では「データの取得 > テキスト」で UTF-8 を指定してください。
データ保存先とリセット
本ツールはユーザーデータを %LocalAppData%\SumikkoLab\DmarcAnalysisAssistant 配下に保存します。完全リセットが必要な場合はアプリ終了後にこのフォルダを削除してください。Microsoft 365 の認証トークンはメモリ上のみで、ディスクには保存されません。
それでも解決しない場合
- サポート・FAQ で該当する質問を検索
- サポート（support@sumikkolab.com）へメールで連絡
Troubleshooting
Common issues and how to resolve them. If your issue is not listed here, see Support & FAQ.
Launch issues
The app does not start / stays on a blank screen
- Likely cause: Microsoft Edge WebView2 Runtime is missing.
- Fix: Install the WebView2 Runtime (Evergreen Bootstrapper) from Microsoft's official site. It is typically pre-installed on Windows 11.
The Terms of Use screen appears on every launch
- Likely cause: Lack of write permission to user data folder, or a terms revision.
- Fix: Re-consent is required after a terms revision (version history is published). Otherwise, check write permission on
%LocalAppData%\SumikkoLab\DmarcAnalysisAssistant.
Report import issues
Import returns 0 rows
- Likely cause: The folder contains no DMARC aggregate reports (XML / ZIP / GZ), or the wrong folder was selected.
- Fix: Save ZIP / GZ attachments into the folder and retry. Filenames commonly contain
dmarcorrua.
"XML parse error" during import
- Likely cause: Corrupted report, encoding mismatch, or nonstandard schema.
- Fix: Move the offending file aside and retry. Please report the provider and filename to support.
Import is extremely slow
- Likely cause: Thousands of files in one folder, or very large ZIPs.
- Fix: Split by month into subfolders. Scanning is scoped to a single import run, so splitting folders lets you progress incrementally.
Bounce correlation
No entry is labeled "Bounce"
- Likely cause: Bounce folder not specified, or bounce subjects are nonstandard.
- Fix: Specify the bounce folder explicitly. Some ISPs use localized subject lines that may be unsupported.
Microsoft 365 integration
Sign-in fails
- Likely cause: Conditional access policy, Mail.Read not consented, or no network.
- Fix: Ask your admin whether app consent is permitted. Personal accounts work as well; organizational accounts may require admin consent.
Sign-in succeeds but no mail is retrieved
- Likely cause: Mail.Read not granted, or the target folder is empty.
- Fix: Verify the messages exist via another client. This tool only uses the Mail.Read scope (read-only).
CSV export
Garbled characters in Excel
- Likely cause: Excel default encoding.
- Fix: Our CSV is UTF-8 with BOM. Excel 365 reads it as-is. In older Excel, use "Get Data > From Text" and specify UTF-8.
Data location and reset
User data is stored under %LocalAppData%\SumikkoLab\DmarcAnalysisAssistant. For a full reset, close the app and delete this folder. Microsoft 365 authentication tokens are held in memory only and never persisted.
Still stuck?
- Search Support & FAQ
- Email support at support@sumikkolab.com