Welcome to the Akvelon Global Preview User Manual. With this guide you can learn how to install, configure, and use Akvelon Global Preview for Microsoft Dynamics CRM.
Global Preview for Microsoft CRM is a custom module which includes two features:
Email Preview provides the ability to:
Preview Pane provides the ability to:
Whether you are using Microsoft Dynamics CRM in your production, development, or test environment, you always need licenses.
Each organization requires its own license for Global Preview. In a typical setup you have one single organization and only need one license. The license contains the organization name and you can only install the license on the organization with the specified name.
If you use multiple organizations, each organization requires a separate Global Preview license. However, you only need licenses for the organizations using Global Preview. If you have a single CRM server with four organizations and you want to use Global Preview in two of them, then you need two licenses.
Each organization license (except the trial one) contains a restricted number of client user licenses (CAL). Each user of an organization that uses Global Preview must have a valid license. If an organization has 100 users and 50 users have permissions to perform searches using Global Preview (see the Global Preview Users Permissions section), you need at least 50 Global Preview licenses, otherwise you will receive a license validation error.
When adding new users to CRM, be sure to verify that Global Preview also has corresponding licenses for those new users.
To request Global Preview licenses please contact email@example.com.
To upgrade Global Preview you need to completely remove your current version of Global Preview:
NOTE: Before upgrading your CRM 2011 UR11 and older to a newer version (CRM 2011 UR12 and newer or CRM 2013) - you should update your current version of Global Preview to 1.0.3. Please see detailed instruction here.
To upgrade you need to completely remove your current version of Global Preview (see Uninstall Global Preview section) and import new version of Global Preview (see Installation section below). To upgrade from previous versions of Global Preview, download new version from avocado.software site and install it (NO NEED TO REMOVE previous version). During installation, select the Maintain customizations (recommended), and check the Activate any processes and enable SDK messages... (see Global Preview Installation section for more details).
Contact firstname.lastname@example.org for more details and if you need assistance with upgrading Global Preview.
To set up Akvelon Global Preview on Microsoft Dynamics CRM, follow these steps:
Activate Global Preview separately for each organization.
Before activation, make sure that pop-ups are not blocked by your internet browser for your CRM site.
To activate Global Preview for an organization, go to Settings → Global Preview Settings and click the About button at the upper right corner (see Figure 4).
You will see the End User License Agreement, please read and accept it using the checkbox, then click the Activate button. Input your Global Preview license into the open license window and click the Update license button (see Figure 5).
After you click OK, a message indicating that Global Preview is activated will appear. Now you can use Global Preview.
If you need to update license data (e.g. to input commercial license instead of trial, update number of users, prolong your commercial license or enable search in attachment contents feature) go to Settings → Global Preview Settings and click the About button at the upper right-hand corner. Then click the Update license button, put the new license data into the license textbox (see Figure 6) and click the Update license button.
This chapter describes how to configure Global Preview roles, entities, attributes to search by, and attributes to display, within results.
To allow users to work with Global Preview, you must assign them special permissions:
After you assign a role, click the OK button (see Figure 7).
For example, you purchased 10 Global Preview licenses, and you have 2 users with the Akvelon Global Preview Administrators role, and 4 users with the Akvelon Global Preview Users role – only 4 licenses are being used in this case. 6 licenses are available for additional Global Preview users.
You can select entities to display the Preview Pane according to your business needs.
To switch on/off Preview Pane for entities do the following (see Figure 9):
Changes will be applied for all Global Preview users.
You can select entity attributes and how many of them to display in the Preview Pane.
To change/hide attributes to display do the following (see Figure 10):
Email Indexing provides ability to improve searching performance in the Dynamics CRM emails description. Searching performance becomes much better.
To enable the Email Indexing feature, please follow these steps:
Go to CRM Settings → Global Search Settings → click the E-mail Indexing button (see Figure 11).
E-mail Indexing configuration window will be opened (see Figure 12). When Initialization process is completed, you’ll see the Index status window: Number of emails in the Dynamics CRM Database, Number of indexed emails and email indexing progress status. Also the Enable E-mail Index… button will appear after the Initialization process.
Click the Enable E-mail Index… button to start full e-mail indexing process (please read notes above before starting email indexing, see Figure 13).
Then click the Start indexing button (see Figure 14).
In the appeared dialog box click OK button to start email indexing process or click Cancel to prevent this action (see Figure 15).
You can see the current indexing status in the Email indexing window (see Figure 15). We don’t recommend to close the window during indexing progress – it speeds up indexing process. If you close the window, email indexing process will stop, but indexing will resume in background periodically, so all new email messages will be indexed automatically. Also you can open the Email indexing window at any time and start indexing again manually.
If E-mail Indexing process was successfully completed, Indexing status will change to Completed. Also you can see number of indexed emails in your Dynamics CRM Database (see Figure 17).
Now you can add Description in the Attributes to search by tab for the E-mail Messages entity (please see Adding/Removing Entities to Search section).
Disabling E-mail Index. To disable E-mail Indexing, go to CRM Settings → Global Search Settings and click the E-mail Indexing button at the top menu. The E-mail Index window will open. Click the Disable E-mail Index… button. Click OK in appeared dialog to start disabling process.
Removing E-mail Index. To completely remove indexed data from the system, remove Global Search from your Dynamics CRM system (see Uninstall Global Search section).
Area Picker allows a user to select the area to place Email Preview in default and custom apps. To do that, go to Settings → Global Preview Settings → click the Area Picker button (see Figure 18).
NOTE: After installation of the Global Preview version with Area Picker, please wait for about 15 minutes in order for the Area Picker to start working properly.
How to work with the Area Picker:
To uninstall Global Preview, please follow these steps:
To use Email Preview, go to Site Map OR Workplace and click on the Email Preview icon (see Figure 25).
The Email Preview window includes the following areas:
This displays the list of emails created in the system. When an email is selected in the list, its body is displayed in the Preview pane. The pane’s header includes information about email properties (subject, to, cc, status, date of creation, priority) and a list of files attached. To open an attachment, just click on it.
Email Preview displays 50 emails per page by default. If there are more than 50 emails, Email Preview will spread the emails out on separate pages. To navigate through them, click on the page links provided (see Figure 26).
Users can change the number of emails displayed; to do that just click on the Show dropdown list at the bottom and select any of three options: 30, 50, or 100 emails per page.
By default Email Preview sorts emails by relevance, with the most relevant emails listed on top. To sort by a different condition, select a sorting condition by clicking on the Arrange By button and then select a sort order by clicking on the button to the right.
You can sort emails by one of the following conditions: From, To, Subject, Regarding, Scheduled Start, Scheduled End, Created On, Actual Start, Actual End, Priority, Status.
Email Preview allows users to narrow the number of emails in the List of Emails using filters.
The following filters are available (see Figure 27):
|Date||Allows users to view emails created within a specified date range.|
|View||Depending on the option selected, allows users to work with all emails (“All Items” option) or emails created by the current user only (“My Items” option).|
|Status||Allows users to view only emails with the specified status.|
For example, if you want to view emails which you created today and have not sent yet, select Date = “Today”, View = ”My Items”, Status = ”Draft”. Emails which match the filters will be displayed in the List of Emails.
NOTE: Filters can be used together with search.
The Tool Bar allows you to perform the following actions:
|Select Print to print your email. Information about email properties (subject, to, cc, status, date of creation, priority) and a list of files attached will be included into the printout.|
|Forward||Select Forward to send an existing email to another recipient(s). The text of the previous email(s) and all attachments will be automatically included.|
|Reply||Select Reply to send a response email to the person who sent you the email. The text of the previous email(s) and all attachments will be automatically included.|
|Reply All||Select Reply All to send a response email to the person who sent you the email and also to everyone else who received the same email that you did. The text of the previous email(s) and all attachments will be automatically included.|
|Create New Email||Select Create New Email to create a new email. In cases where the user doesn’t have sufficient rights to create new emails, this button will be hidden.|
|Delete Email||Select Delete Email to delete an email. In cases where the user doesn’t have sufficient rights to delete emails, this button will be hidden.|
|Collaborate||Press this button to perform standard actions that can be performed on entities in CRM. They are described in the table below. In cases where the user doesn’t have sufficient rights to perform all these actions, this button will be hidden.|
|Save View Preferences||Press this button to save current Filtering and Sorting configuration (see Arranging Emails for more details). Next time you open Email Preview window – saved configuration will be opened.|
|Refresh||Select Refresh to reload the list of emails.|
The Collaborate functionality includes the following actions:
|Connect||Select Connect to link an email to any other entity that exists in CRM: account, contact, opportunity, etc.|
|Add to Queue||Select this to add an email to the queue.|
|Assign||Select Assign to change the owner of the email. The original user loses ownership of the email but automatically shares it with the new owner.|
|Share||Select Share to share an email with other CRM users or teams. When you share email with another user or team, you set which permissions that user/team will receive.|
|Set Regarding||Select this to fill in the Regarding field in an email.|
|Copy a Link||Select this to copy a link that will open the email in the clipboard.|
In cases the user doesn’t have sufficient rights to execute all these actions, the corresponding buttons will be hidden.
Email Preview enables users to search for emails. Search is performed by Subject, Body, and Regarding fields. Email Preview performs case-insensitive searches using the word-beginning search principle.
For example, if you type hand in the search text box you can find emails that contain Hand, handicraft, HANDY.
Emails that match the search query will appear in the List of Emails. The first email in the list will be displayed in the Preview Pane by default. The matching text found in the emails will be highlighted in yellow (see Figure 28).
If filters were applied, only emails which match those filters will be shown.
For example, if you search for old and the Date filter is set to Today, only today’s emails with old in the Subject , Body, or Regarding field will be shown. Yesterday’s emails with old won’t be displayed.
To clear the results of the search, erase the text in the search text box and press Clear or hit Enter.
If several words are entered into the search text box, Email Preview will find all emails which contain both of those words in their Subject, Body, or Regarding fields.
For example, if you type Jack London into the search text box, search will find emails which have both Jack and London in their Subject , Body, or Regarding fields.
Search will find emails which have:
Preview Pane allows you to see the content and attributes of the selected entity.
Preview Pane is available in views and forms:
Preview Pane is also available for custom entities. You can add custom entities for preview via Global Preview Settings (see Switching Preview Pane On/Off for Entities section for more details).
The Preview Pane window contains two tabs:
General Tab consists of three areas:
Entity attributes are displayed in the header and the footer. By default, there are four attributes in the header and four in the footer (see Figure 32).
The attributes shown can also be changed or switched off – select hidden in the Global Preview Settings area (for detailed information, see the Configuring Entity Attributes section).
The Description area contains entity description information: text, links, pictures, etc. It also may contain formatted text or an HTML page. The description area can also be hidden (see Figure 33).
Users can tweak the Preview Pane Window size. To resize the Preview Pane Window, just drag the top border of the preview pane up or down.
NOTE: If you changed the entity by adding or editing notes, updating email attachments etc., press the Refresh button in order to update the Preview Pane (see Figure 34).
|Buttons Reply to, Reply All, Forward, New email are not working in the Email Preview.||Verify that you added your CRM web site to exceptions of your browser popup blocker. Visit you browser support web-site to get more information:|
|In Internet Explorer 11 doesn’t show license status and it is not possible to activate or update the license.||Add your CRM web-site to Compatibility view exception, following this instruction.|
|Preview Pane doesn’t appear for a selected entity or appears with errors; when you click on buttons in Settings, they don’t work or errors appear.||Verify you cleared the cache in Outlook and IE, see the Upgrading from previous version section.|
|Preview Pane doesn’t appear for a selected entity.||Verify that this entity is selected in Global Preview Settings, see the Switching Preview Pane On/Off for Entities section.|
|Preview Pane appears, but some fields are not displayed – there is empty space in their places.||That may happen if the “Hide” check box is checked for those fields, see the Configuring Entity Attributes section.|
|You configured your Global Preview Settings one way, but after a while your settings changed – and you didn’t change anything.||That may happen if the “Hide” check box is checked for those fields, see the Configuring Entity Attributes section.|
|You configured your Global Preview Settings one way, but after a while your settings changed – and you didn’t change anything.||That may happen if another user pressed the “Save as default” button and his/her configurations were applied to all users.|
|Preview Pane is not displayed inside a custom entity form.||You should deactivate and re-activate Global Preview to make it “recognize” this new custom entity and show the Preview Pane for it.|
|You selected multiple rows in the view, but Preview Pane is not displayed for them.||Preview Pane is displayed for the first entity in the list of selected. Verify that the first entity is selected in Global Preview Settings, see the Switching Preview Pane On/Off for Entities section.|
|You updated an Attachment or Note, but Preview Pane displays the old information.||Press the refresh button to update Preview Pane.|
|Preview Pane doesn’t appear when you click on an entity, and when you click on the Email Preview link, you see this error message:||Verify you’ve assigned Global Preview roles to this user, see Global Preview Users Permissions section|
|You can work with Email Preview, but can’t view Preview Pane. When click Global Preview Settings link, you get “Insufficient privileges.” error.||Verify Global Preview roles have organization level privileges for Akvelon Mail Organization Settings and Akvelon Mail User Settings entities. See Global Preview Users Permissions section.|
If you have any questions, experience problems, or have feedback – please feel free to contact us: email@example.com.
The Akvelon team encourages and appreciates leaving feedback about Akvelon Global Search at the App Source website.