From 4c09135b840445b8723c78e89ad959f7603345b7 Mon Sep 17 00:00:00 2001 From: Ivo Oskamp Date: Sun, 8 Feb 2026 16:19:34 +0100 Subject: [PATCH] Fix: Clarify single Save Settings button used twice in workflow Corrected Mail Import Setup documentation to accurately reflect UI: Step 2.3: "Save Settings (Again)" instead of "Save Final Configuration" - Clarified there is only ONE "Save settings" button on the page - Same button is clicked TWICE: once after credentials, once after folders - Added warning callout: "Same Button, Two Steps" - Emphasized this is the same button from Step 2.1, not a separate button Future Improvement note updated: - Specifically mentions clicking same button twice is not obvious - Suggests possible solutions: separate sections with distinct save buttons, or visual feedback about which step user is on This accurately reflects the current UI where a single "Save settings" button serves double duty, which will be improved in a future version for clarity. Co-Authored-By: Claude Sonnet 4.5 --- .../documentation/mail-import/setup.html | 17 +++++++++++------ docs/changelog-claude.md | 2 +- 2 files changed, 12 insertions(+), 7 deletions(-) diff --git a/containers/backupchecks/src/templates/documentation/mail-import/setup.html b/containers/backupchecks/src/templates/documentation/mail-import/setup.html index 4608943..3112705 100644 --- a/containers/backupchecks/src/templates/documentation/mail-import/setup.html +++ b/containers/backupchecks/src/templates/documentation/mail-import/setup.html @@ -285,15 +285,20 @@
📝 Future Improvement:
- The current UI requires saving credentials separately before folder browsing is available. A UI improvement is planned to make this workflow clearer, possibly combining these steps or providing better visual feedback about the required order. + The current UI requires clicking the same "Save settings" button twice: once to save credentials (which enables folder browsing), and again to save folder paths. This is not immediately obvious to users. A UI improvement is planned to make this workflow clearer - possibly splitting it into separate sections with distinct save buttons, or providing visual feedback about which step you're on.
-

2.3 Save Final Configuration

+

2.3 Save Settings (Again)

After configuring the folder paths:

    -
  1. Click Save settings at the bottom of the page again
    2. +
  2. Click the Save settings button at the bottom of the page again +
      +
    • This is the same "Save settings" button you clicked in Step 2.1
      • +
    • It now saves both credentials and folder paths together
      • +
    +
  3. BackupChecks will validate the complete configuration (credentials + folders)
  4. If successful, you'll see a confirmation message
  5. If there's an error, verify: @@ -305,9 +310,9 @@
-
- 💡 Two Save Steps:
- You'll save settings twice: first after entering credentials (Step 2.1), then again after selecting folders (Step 2.3). This ensures credentials are available for the folder browser to connect to your mailbox. +
+ ⚠️ Same Button, Two Steps:
+ There is only one "Save settings" button on this page. You must click it twice: first after entering credentials (Step 2.1) to enable folder browsing, then again after selecting folders (Step 2.3) to save the complete configuration. This workflow will be improved in a future version to make it clearer.

Step 3: Test the Configuration

diff --git a/docs/changelog-claude.md b/docs/changelog-claude.md index d486540..2e2cbe7 100644 --- a/docs/changelog-claude.md +++ b/docs/changelog-claude.md @@ -6,7 +6,7 @@ This file documents all changes made to this project via Claude Code. ### Added - Completed Mail & Import documentation section (4 pages): - - **Mail Import Setup**: Microsoft Graph API configuration with enhanced security (Azure AD app registration, start with Mail.Read only, Application Access Policy to restrict access to one mailbox via Exchange PowerShell, add Mail.ReadWrite after testing), two-step folder configuration workflow (save credentials first, then use automatic folder browser popup - no manual path entry), test configuration, troubleshooting (authentication errors, folder not found, no emails imported), advanced configuration (email retention, multiple mailboxes), comprehensive security best practices including principle of least privilege, note about planned UI improvement for clearer workflow + - **Mail Import Setup**: Microsoft Graph API configuration with enhanced security (Azure AD app registration, start with Mail.Read only, Application Access Policy to restrict access to one mailbox via Exchange PowerShell, add Mail.ReadWrite after testing), two-step save workflow clarification (same "Save settings" button clicked twice - once for credentials to enable folder browsing, then again for complete configuration), automatic folder browser popup (no manual path entry), test configuration, troubleshooting (authentication errors, folder not found, no emails imported), advanced configuration (email retention, multiple mailboxes), comprehensive security best practices including principle of least privilege, note about planned UI improvement to make two-step save workflow more obvious - **Inbox Management**: Inbox overview and workflow, table columns explanation, viewing email details (metadata, body iframe, parsed objects), approving emails (customer selection, job name), what happens after approval, re-parsing emails (single and bulk), deleting emails (single and bulk delete, soft delete behavior), downloading .eml files, common workflows (new customer setup, troubleshooting unparsed emails, cleaning spam), best practices - **Mail Parsing**: Parsing overview and workflow (retrieval, preprocessing, parser selection, matching, parsing, storage), parsers (viewing available parsers, parser information), match criteria (sender, subject, body match), supported backup software (Veeam, Synology, NAKIVO, Boxafe, Panel3, QNAP, Syncovery, 3CX, RDrive, NTFS Auditing), parser execution order, enabling/disabling parsers, re-parsing emails, parsing workflow example, troubleshooting parsing issues, parser limitations, best practices - **Auto-Import Configuration**: Auto-import overview and features, enabling auto-import, import interval configuration (5/15/30/60 minutes), batch size explanation, how auto-import works (timer, check settings, authenticate, fetch, parse, auto-approve, move, log, persist, wait), auto-approval logic and conditions, when auto-approval fails, manual import (triggering, batch size 1-50), import settings summary table, monitoring import activity (audit log, inbox page, jobs/daily jobs), troubleshooting (auto-import not running, emails not auto-approved, import errors), best practices, advanced configuration (disabling temporarily, EML retention, high-volume environments)