Skip to content

Release 2.14.0: Multiple Mailbox Support

Choose a tag to compare

@callzhang callzhang released this 08 Sep 08:11
· 56 commits to master since this release

Multiple Mailbox Support

  • Multiple Mailbox Selection: Enhanced mailbox parameter to support selecting multiple mailboxes simultaneously
  • ALL Mailboxes Option: Empty mailbox selection now defaults to searching ALL available mailboxes
  • Multi-Selection UI: Updated mailbox parameter to use multiOptions for better user experience
  • Mailbox Path in Output: Email results now include the source mailbox path for better tracking and organization

Enhanced Operations

  • EmailGetList Operation: Now iterates through multiple mailboxes and aggregates results with proper limit handling
  • EmailGetSingle Operation: Can search for specific UID across multiple mailboxes until found
  • Improved Error Handling: Graceful fallbacks when individual mailboxes fail to open or search
  • Better Logging: Enhanced logging to show which mailboxes are being searched and results per mailbox

Technical Improvements

  • New Functions: Added getMailboxPathsFromNodeParameter() and getAllMailboxes() for multi-mailbox support
  • Enhanced Validation: Added ParameterValidator.validateMailboxes() method for multi-mailbox validation
  • Dynamic Loading: Updated mailbox parameter to use loadOptionsMethod for dynamic mailbox list loading
  • Performance Optimization: Efficient iteration through mailboxes with early termination on limit reached

Breaking Changes

  • Mailbox Parameter: Changed from single selection to multi-selection (multiOptions)
  • Default Behavior: Empty mailbox selection now searches ALL mailboxes instead of defaulting to INBOX
  • Output Format: Email results now include mailboxPath field indicating the source mailbox

Migration Guide

  • Existing Workflows: Update mailbox selection to explicitly choose INBOX if you want the previous single-mailbox behavior
  • New Workflows: Leave mailbox selection empty to search all mailboxes, or select specific mailboxes as needed
  • Output Processing: Update any downstream nodes that process email results to handle the new mailboxPath field