This article refers to the Barracuda Message Archiver firmware 5.2 or higher, and Barracuda Archive Search for Outlook version 5.2 or higher. Barracuda Archive Search for Outlook supports Outlook versions 2010, 2013, 2016, and 2019.
Verify the Archive Search for Outlook version (available for download on the USERS > Client Downloads page in the Barracuda Message Archiver web interface) is the same major revision as the Barracuda Message Archiver firmware for proper functionality.
Watch this video for a short walkthrough of Archive Search for Outlook:
Search Archived Items
To search archived items, click the Search Archive () icon to open the Barracuda Message Archiver Search dialog box:
- Look for drop-down menu – Select the type of item you wish to search for; select Any type of Item, Appointments, Contacts, Messages, Notes, Social Media, or Tasks
- In drop-down list – Select the search location:
- All data – Search everywhere in the selected item type
- Specific folders – Click Specific folders, or click Browse to select one or more folders across all of your Archive stores in which to search; click OK to save your selections
- Search for – Enter the search criteria; use logic operators and keyword search to further refine your search
- In drop-down list – Select the search location:
- Entire message
- Subject or body
- Subject only
- Body only
- Keyword expression
Build search queries using AND, OR, NOT, and -term.
When including more than one logic operator in a query, the order in which these terms are placed is important. For example,
- Add the first term "A", and then add term "and B"; the query searches as: (A AND B)
- Add a term "OR C"; the query searches as: ((A AND B) OR C)
- Add a term "AND D"; the query searches as: (((A AND B) OR C) AND D)
- Add a term "NOT E", the query searches as: ((((A AND B) OR C) AND D) NOT E)
Typically, you first build a population of results by using "OR" or "NOT", and then subtract items from that population by using "AND".
To force a different order of operations, place parentheses yourself using Keyword expression.
When you enter a logic operator or a keyword expression in the Search for field, the rest of your search criteria is AND'd with the query. For example, if you enter "A AND -B" you can still specify a recipient in the Sent To field.
Table 1. Commonly Used search_field Keyword Expression Values.
|to||Search is limited to the To and Cc fields of each message||Text|
|from||Search is limited to the From field of each message||Text|
|domain||Search is limited to the domain names in the From, To, and Cc fields of each message||Domain|
|subject||Search is limited to the Subject line of each message||Text|
|body||Searches are performed in the Body of each message as well as in the contents of any message attachments||Text|
|attachment||Search is limited to the contents of message attachments||Text|
|all||Searches all fields and all data contained in each message||Text|
|stored_size||The actual message size on disk||Integer number|
|size||The raw size of the message||Integer number|
|header_date||The date header from the mail||Text|
|header_barracuda_envelope_rcpt_pretty_name||The envelope recipient's pretty name||Text|
|header_barracuda_envelope_rcpt_user||The envelope recipient||Text|
|header_bcc||The Bcc: header||Text|
|header_to||The To: header||Text|
|header_in_reply_to||The In reply to: header||Text|
|header_barracuda_envelope_rcpt_domain||The domain of the envelope recipient||Text|
|header_from||The From: header||Text|
|header_barracuda_envelope_rcpt_message_mode||Inbound / Outbound / Internal||Text|
|header_barracuda_envelope_rcpt_addr||Email address of envelope recipient||Text|
|header_subject||Subject of the email||Text|
|header_message_id||The message ID header||Text|
|object_type||Type of entry (calendar, mail, etc.)||Text|
|body_excerpt||The body of the email||Text|
|attachment_name||The attachment name||Text|
|attachment_mimetype||The attachment MIME type||Text|
|attachment_extension||The attachment's extension||Text|
You may specify other search_field values as long as the correct name for the field is used. Consult Barracuda Networks Technical Support if you are unsure of the exact syntax.
The phrase can only contain a single item. However, that one item can be any one of the items described in Table 2.
Table 2. Phrase Values.
|Text-based string||A single string or phrase of text, to be matched exactly as entered. Valid formats are: a single word (with no whitespace) or a single double-quoted sequence of words (separated by spaces).|
|Integer number-based string|
A single integer string in bytes to be matched exactly to an index attribute as entered. Valid formats are: a single number (with no whitespace). To find a range, use a Compound Search String.
Single Wildcarded string
|Wildcards are characters in search strings that can match arbitrary characters in a search. They can only be used as part of a single word, and are not allowed as the first character of a search word. They are also not allowed in any double-quoted string containing multiple words (that is, spaces). Wildcards are not allowed as part of a phrase, or any search string that is comprised of more than one word, regardless of the use of double quotes.|
|Domain-based string (for to and from search_field only)|
The domain part, or everything after the at-sign (@), of an email.
|Compound search strings|
A combination of two or more strings in any of the above formats (Text-based, Multi-Text, Wildcard, or Domain as applicable to the fields being searched) or with other Compound search strings, each separated by the keywords AND, OR or NOT. Surround logical groupings with parentheses as needed to determine order of operations. You can also use the Google syntax -term to exclude content.
Table 3. Sample Keyword Expressions.
|to:chrislee||All messages that have "chrislee" in the To or Cc fields.|
|to:firstname.lastname@example.org||All messages containing "email@example.com" anywhere in the To field.|
|subject:"Barracuda Message Archiver"||All messages that contain the exact phrase "Barracuda Message Archiver" anywhere in the Subject line.|
|domain:(barracuda.com OR barracudanetworks.com)||All messages that were sent to or from any user in either the "barracuda.com" or "barracudanetworks.com" domain.|
|header_barracuda_envelope_rcpt_domain:sub.mycompany.com||All messages sent to any user in the @sub.mycompany.com domain.|
Table 4. Sample Proximity Syntax.
For the keyword proximity syntax form, each keyword must be in a single Text-based string. Enter the keyword proximity syntax as search_field:"keyword keyword"~NumericValue, where search_field is the part of the email to search through.
|subject:"release Barracuda"~4||All messages containing "release" and "Barracuda" in the Subject field within four words of each other.|
|to:"Zac Britt"~4||All messages containing "Zac" and "Britt" anywhere in the To field within four words of each other.|
Table 5. Sample Fuzzy Search Syntax.
Fuzzy search allows you to find words that are similar to a specified search term. For the fuzzy search syntax, enter a single keyword followed by the tilde (~). For the fuzzy search syntax form, the keyword must be in a single Text-based string.
|roam~||All messages containing words similar to roam, for example, foam, roams.|
The available search criteria differs based on the selected searched item type.
Table 6. Search Criteria.
|Search Item Type||Criteria||Description|
Any Type of Item
|Search for||List of keywords on which to search. If multiple keywords are entered, only items with all of the specified keywords are returned. If keywords are enclosed in double quotes (" "), then only items that contain all of the keywords exactly as specified appear in search results.|
|In||The part of the item in which to search for the specified keywords. Options vary based on the selected item.|
|Organized By||Appointment creator. Only those items organized by the specified user(s) are searched. Enter user names or email addresses, or click From to select users from an address book.|
|Appointment recipient(s). Only those items that were sent to the specified user(s) are searched. Enter user names or email addresses, or click From to select users from an address book.|
|Date||Date restrictions on the item. Search through only those appointments that were scheduled after and/or before the specified date(s).|
|Message recipient(s). Only those messages sent to or copied to the specified user(s) are searched. Enter user names or email addresses, or click Email to select users from an address book.|
|From||Message sender(s). Only those messages that were sent from the specified user(s) are searched. You can enter user names or email addresses, or click From to select users from an address book.|
|Sent To||Message recipient(s). Only those messages that were sent to or copied to the specified user(s) are searched. Enter user names or email addresses, or click Sent To to select users from an address book.|
|Date||Date restrictions on the item. Only those messages that were sent for after and/or before the specified date(s) are included in the search.|
|Status||Only tasks matching the selected status are searched for the specified text.|
|Due||Date restrictions on the tasks. Only those tasks due after and/or before the specified date(s) are included in the search.|
Table 7. Wildcards.
|? (single question mark)||Specifies a single alphanumeric character. Question marks can be appended to search for a specific number of characters, for example, a???a returns five letter words that starts and ends with "a" or "A".|
|Specifies zero or more alphanumeric characters. For example, pl* returns "plane", "planning", etc.|
Advanced Search Criteria
Click the Advanced tab in the Barracuda Message Archiver Search dialog box to specify additional search criteria based on attachments and tags, and save your search criteria.
Table 8. Advanced Search Criteria.
|Attachments||Number of attachments required in the messages in which to search. Options are Any, One or more, or None.|
|Attachment Name||Name of the attachment for which to search. Only messages containing an attachment with the specified name are returned.|
Tag(s) on which to search. Wildcards are NOT accepted in this field.
Run a search based on a previously saved search.
All messages that match the specified criteria are returned in the search window. Double-click an item to open it in Outlook, or right-click to select an action to perform on the selected item, as described in Table 9.
Table 9. Available Actions.
|Open||Open the selected item in the standard Outlook view; double-click an item to perform the same action. Once an item is opened, it can be treated as any other non-archived item, including replying to and forwarding.|
Reply to All
|Creates a Reply or Reply All to the selected item in the exact same manner as Outlook.|
|Creates a Forward of the selected item in the exact same manner as Outlook.|
|Forward as Attachment||Creates a Forward as an attachment of the selected item in the exact same manner as Outlook.|
|Save As||Save the item to your local system as a .eml file.|
|Copy to Folder|
Opens the Select Folder dialog box in Outlook from which you can select a folder to which to copy the selected item(s). Use Ctrl- or Shift-click to select and copy multiple messages in the returned search window to a folder. Select from your existing folders, or create a new folder for the selected item(s).
Archive Search for Outlook includes an option to immediately archive a selected item(s) to the Barracuda Message Archiver. Additionally, if the Automatically stub attachments when archiving option is turned on, and you click the Archive Attachments () icon:
- A copy of the complete selected item(s) is stored on the Barracuda Message Archiver
- On your mail server, any message attachments that are in the body of an original message(s) are replaced with references to the archived attachment on the Barracuda Message Archiver
This process is known as "attachment stubbing" and helps to reduce the size of both your personal inbox and mail server storage.
To archive a message,
- Select the desired item(s) in Outlook, and click the Archive Attachments () icon; a progress window displays while the item(s) are archived.
- Once the item(s) are successfully archived, any message attachments display as hyperlinks in the Outlook message preview. Click on a hyperlink to view the attachment.
- Double-click the archived message to open it in the message view; attachments display with icons as they normally would in Outlook.
- When you click the attachment hyperlink or double-click the archived message, the attachment is retrieved form the Barracuda Message Archiver, allowing you to view or save it in the same manner as an attachment in any other message.
Apply a Category to Archived Items
If enabled by your administrator, a category is applied to all mail archived from the Archive Search for Outlook. For example, before archival, an item displays similar to:
After the item is stubbed with a category, in this example Archived, it appears similar to:
Restore Stubbed Content to Microsoft Exchange
To restore stubbed content to your Microsoft Exchange Server, click the Restore () icon in the Outlook toolbar. When clicked, the selected stub content is restored to the Exchange Server and persists on the Server until the next stubbing job runs.