Skip to content

Latest commit

 

History

History
260 lines (160 loc) · 13.3 KB

mail.md

File metadata and controls

260 lines (160 loc) · 13.3 KB

Mail

Management of email messages has consistently been a difficult task. Ensuring emails and attachments to and from clients are saved and filed appropriately has commonly been the Achilles heel of many document management platforms.

HubOne solves this with Mail, a certified add-in to Microsoft Outlook which enables the rapid configuration, catalog and filing of emails directly to your document center. It also allows the user to assign metadata to the email before it is filed, and file in the root or subfolders beneath a client’s directory in SharePoint.

The following sections detail how to use Mail.

Getting Started

On first run, you will be presented with the Connect to Document Center popup window

ConnectWindow

Enter your SharePoint Document Center URL which will be in a format like https://<designator>.sharepoint.com/documentcenter and enter your Office 365 login details.

Once done, click the Connect button to connect to SharePoint. This will run a one-off synchronization process to retrieve your clients' list.

Once the software has run its initial synchronization each subsequent access should be faster as the software caches your list information on your own PC.

Please note: For this reason, when you add new clients to your clients' list or if you add new folders or subfolders to SharePoint you will need to click the refresh button.

The Controls

There are five controls available at the top of the application.

They are:

Icon Description
UpdateTheme Update theme
Refresh Refresh Clients & Folders
Connect Connect to Document Center
Settings Settings
Help Help

Update theme

This button ensures the colors of Mail matches your Office 365 theme.

Refresh Clients and folders

Synchronize the application with any changes to your clients' list or your folder structure in SharePoint.

Connect to Document Center

Go here to enter your Office 365 credentials and your SharePoint Document Center site address.

ConnectWindow

Settings

View your settings for OnePractice

Settings

Help

Navigate to the software help website where you can download the complete Mail documentation.

Using Mail

Mail is accessed from your email body in Outlook Desktop client or Outlook Web App (OWA) from your browser by clicking the Mail tab at the top of the email read window.

Outlook Desktop

OutlookLocation

Outlook Web App

OWALocation

Mail Main Screen

MailMainScreen

  • Email from: This shows the email sender.
  • Save to client: The client folder you wish to save the email to. The client name is automatically populated if the email address matches the primary contact in your practice management software. If Mail has not been able to match the client, which could be if the contact isn't within your practice management software, you can select the dropdown and search for the correct client. Start by typing 3 characters and a list will populate with all clients that contain those characters, allowing you to search on any part of the name. Search
  • Target folder (Next to Save to client): This indicates the location in SharePoint where the email will be saved. By default, it will be the selected client folder. If you select a subfolder, this will change accordingly.
  • Subfolders: The subfolders button allows you to view folders within the chosen client folder for selection.
  • Attachments: Options for saving attachments and renaming.
  • Save options: Click to expose various extra save options, such as renaming the email.
  • Metadata: Click to expose any metadata columns you may have added to your Documents Library in the SharePoint Document Center.

Saving Emails to Client Folders

Basic Saving

At its most basic, the application is used to save emails to client folders in SharePoint. Select the desired client target from the dropdown list and click Save to SharePoint. This will queue the email for saving and will then save directly to the root folder of the client selected in .msg file format.

To allow you to continue working immediately, the software will place the email in a queue for saving. The following message indicates this. You can now continue working.

WaitMessage

Important note: You must not delete your email immediately after saving. The queue will need to locate it in the folder you saved it from to save it to SharePoint – this can take a few seconds after you save the email. Please wait until the blue OnePractice category icon appears before deleting. It is also advised that you do not have an Outlook rule that auto-deletes your emails.

Once the email has been saved, the cloud icon will display a tick inside (as shown below). A link, Open last save location, will also appear, whereby you can you view the email within the Document Center. Should you return to this email in your inbox at a later date, even on reloading Outlook of the app, the Open last save location link will always appear so that you can quickly access it within the Document Center.

SaveLocation

Please note, if you are using Internet Explorer and are not able to open the Save Location.

  1. Go to Internet Options in your browser.
  2. Click the Security Tab.
  3. Select Trusted Sites and then click the Sites button.
  4. Add ``https://outlook.office.com``` to your trusted sites as in the image below. TrustedSites

Saving to Subfolders

If the chosen client target has subfolders under its root directory, by clicking on the subfolder icon (as shown below), the list of available folders will appear in its place.

SavingToSubfolders

From here, you can choose to save to a subfolder by selecting a folder from the list.

SavingToSubfolders2

The selected folder will appear in the Target Folder box.

SavingToSubfolders3

To navigate back up to the top, click the up-arrow icon as shown below.

SavingToSubfolders4

Saving Attachments

If your email has attachments and you wish to save them separately to the client folder as well, open the Attachments panel and select the Save attachments checkbox. All non-embedded attachments (an embedded attachment is e.g. your company logo embedded in the email body) will be saved to your target folder as individual files. If you don’t save the attachments individually, the saved email item (.msg) will still contain the files if you open the email in Outlook.

SavingAttachments

Save Attachments Only

After you've opened the Attachments panel and selected Save attachments, you must then select the Save attachments only? checkbox.

SavingAttachmentsOnly

Saving Selected Attachments

If you don't want to save all attachments, you can simply untick the checkbox next to the attachment/s you do not wish to save.

SavingAttachmentsSelected

Why would I save attachments as separate files outside the email? There are many reasons, one could be that you wish to forward a particular file separately and create a new email through the Mail Templates software or if you wish to edit the attached file.

Renaming Attachments

Sometimes a client may send you attachments with obscure naming. This may be something that they recognize or was generated by their scanner. In these cases, you may wish to rename the attachments before saving to the document center to avoid losing the document due to it's unfamiliar naming.

  1. Open the Attachments panel and click Save attachments.
  2. Each attachment will be listed below with their current name inside the text box.
  3. You can simply delete and enter your own naming.
  4. Deselect the check box next to an attachment you don't wish to save.

RenamingAttachments

Add Sender as a contact

This features is currently deprecated and does not function

Renaming an email file

If you wish to change the name of the email being saved to your client’s folder, open the Save options section and enter a new name in the Rename File textbox. If this is blank, the email will be saved using the subject line as name.

RenamaMail

Categorising emails in Outlook

Mail will add a category "OnePractice" to each email it saves to SharePoint. This will appear as a blue box next to the email in your email client software.

EmailCategory

Why is my blue category not appearing when I save emails?

If for any reason your category is not appearing you can make sure it has been correctly enabled by following these simple steps:

Outlook Desktop Client

  1. Select Categorize from the menu ribbon and then click All Categories

    Categories

  2. Make sure you have an OnePractice category assigned a light blue color. If not add your own and assign it a blue color. If you have previously assigned blue to another category, we recommend changing to another color to avoid confusion. The OnePractice Mail category must be set to blue and should not be changed.

Outlook Web Access

  1. Select Categories and then Manage categories CateogoriesOWA
  2. Make sure you have an OnePractice category assigned a blue color. If not add it yourself and assign a blue color.

My OnePractice Category has been set to white

If you have a valid OnePractice category but you cannot see it - you could have possibly assigned white to the category by mistake. Locate the OnePractice category as in the steps above and re-assign a blue color.

My mail configuration is set to use conversations

Please note, if you are viewing an email Conversation in which multiple emails are grouped together under a single parent email, the OnePractice blue icon will only show up against the parent email if ALL children emails have been saved via Mail and have thus been categorized. If not, only the children that have been saved will be categorized as blue and the parent will remain without this category.

Turning off Conversations in Outlook Desktop

Select the View Tab and uncheck Show as Conversations

NoConversations

Turning off Conversations in Outlook Web Access

Select the folder you want to turn off conversations for and then click Filter > Show as > Messages

NoCoversationsOWA

Metadata and Mail

For a detailed description of how to add metadata fields to your Document Center please see our Metadata Guide.

Mail allows you to add custom metadata to your document before you save it into SharePoint. This data can be used to more accurately define a document, facilitate easier categorization or grouping, increase searchability and append other useful information.

Examples of metadata could include:

  • Period End e.g. June 2021
  • Assignment e.g. a choice between Tax/GST/Super/Correspondence

Metadata

Start using Metadata

  1. Add metadata columns as described in the Metadata Guide.

  2. Remember to click the Refresh button in Mail to load your new columns after you have added them.