AdaptSuite Outlook Add-In

The AdaptSuite Outlook Add-In (AOA) is designed specifically for users who manage candidate/contact relationships and vacancy activities. It allows the user to view a candidate or contact profile, notes, scheduled tasks and journal in Adapt from Outlook by simply selecting an email. The user can also run selective workflows such as tagging emails, logging calls and submitting candidates for vacancies.

You do not have to be logged in to AdaptSuite to use AOA. However, certain actions taken in AOA (performing workflows, opening records) will require you to log in to complete the action.

For information on installing the Outlook Add-in, click here.

Launching AdaptSuite Outlook Add-In

  1. Once installed, the AOA launches automatically the next time you start Outlook. You can tell AOA is running as there will be an Adapt ribbon added to Outlook. Note: to use AdaptSuite independent of AOA, login to AdaptSuite prior to launching Outlook.

  2. If AOA does not activate when opening Outlook 2010, 2013 or 2016, you may need to manually start the add-in.

    1. Go to File > Options > Add-Ins.

    2. Select the Go button next to Manage: COM Add-ins, make sure the Adapt Outlook Add-in is checked and click OK.

    3. Return to the Add-ins screen and click Add-in Options. Make sure the information is correct and click OK.

    4. If the Adapt Add-in Panel displays but not the Adapt tab, close out of Outlook and then restart Outlook.

  3. If the AOA still does not launch see the Download the AdaptSuite Outlook Add-In topic. This topic will give you setup and troubleshooting information.

 

Navigating the AOA

The AOA has three distinct areas where actions can be performed:

Each of these areas is explained below.

 

The Adapt Add-In Panel

 

 

Docking the Adapt Add-In Panel

The Adapt Add-In panel can be located (docked) in several areas of Outlook.  To change the location of the panel, click the title bar of the panel and drag it to the centre of the screen. The dock points that it can be moved to will highlight on the screen.  Drop the cursor in one of the dock points to dock it to that part of Outlook.

 

 

Minimizing / Resizing the Adapt Add-In Panel

The Adapt Add-In panel can be minimized or resized by clicking the chevron  to collapse and reopen the pane. Grabbing the borders of the Adapt Add-In panel allows you to change the width and height of it.

 

Using the Adapt Add-In Panel

Whenever an email is selected (highlighted) in the Outlook Explorer that is associated with an email address that matches a Candidate or Contact record in AdaptSuite, the Adapt Add-In panel displays the person's name in the Header and whether they are a Candidate or Contact.

 

 

If the email address is associated with more than one record in AdaptSuite, arrows will appear to the right of the heading. Clicking on the arrows cycle between the records.

 

 

Underneath the heading is the Detail area. This shows information on the Candidate's or Contact's record within AdaptSuite.

 

 

The tabs at the top of the data table select the various pages of content for that record.  If you increase the width of the Adapt Add-in panel you will see more of the tabs. If you dock the Adapt Add-in panel vertically, clicking on the right arrows on the tab bar lists all available tabs. Clicking on a tab displays the information for that tab. The tabs are:

 

The buttons above the Details area perform selected operations:

 - will open the currently displayed record in AdaptSuite.  If you are not logged into AdaptSuite it will take you through the login process and then show you the record. Note: To use AdaptSuite independent of AOA, login to AdaptSuite prior to launching Outlook.

 - will tag the selected email(s) in Outlook to the Journal of the record currently displayed in the Adapt Add-In panel. Note: You can also tag an email by using the Ribbon or a right-click (see below for more details).

 - displays a menu listing workflows that can be run against the record currently displayed in the Adapt Add-In panel.  Clicking one of the items on the menu will activate AdaptSuite; take you to the record currently displayed in the Adapt Add-In panel and open the associated work flow. Available workflows:

 - collates all attachments in an email and presents a window where you can attach them to the Document Library of the AdaptSuite record. See below for more information.

- launches the Twitter social media connector page. You can search for Twitter accounts that match the selected record in the Adapt Add-In panel. If the AdaptSuite record is populated with a social media profile, you can link to that page. See below for more details.

 - launches the Facebook social media connector page. You can search for Facebook accounts that match the selected record in the Adapt Add-In panel. If the AdaptSuite record is populated with a social media profile, you can link to that page. See below for more details.

 

The Ribbon

 

The following options are on the Ribbon:

 

Right-Clicking

Right-clicking on an email in the Outlook Explorer displays Outlook's context-sensitive menu. When AOA is installed and working, this menu has an Adapt option on it. By hovering over the Adapt option, a flyout menu displays the following options:

 

Tagging Emails

The AOA allows you to tag emails into Adapt either manually or automatically. Tagging options are set up in Outlook's Add-in Options page. You can set any of the three options below for received and sent email.

 

 

You can take the following actions on the Tag Email dialog:

 

If you have selected Automatically tag, the process is the same as for Prompt to tag except that there is no user intervention. Any entity that exists in the AdaptSuite system whose email matches one of the recipients of the email will have that email tagged to their Journal.

 

You can also manually tag an email (or multiple emails) by selecting the emails in the Outlook Explorer and either 1) right-clicking on one of the emails and selecting Adapt > Tagging and then one of two options or 2) clicking on the Tagging option in the Ribbon. Whether you select to Tag Selected Emails or Tag Unread Emails, the following screen displays:

 

 

The left panel displays the subject of the select email(s). The right panel displays senders and recipients of the selected email(s). You can choose which emails you want to tag and which records you want to tag it to by placing a check in the box beside the email subject or record name. A check beside the subject means that this email will be tagged. A check beside a record name means that record will receive the tagged email. You can also use the Select All and Deselect All buttons to quickly select/deselect records. When you are satisfied with your selections, click OK.

 

You can quickly determine which emails have been tagged by adding the user-defined column "Tagged" to the Outlook Explorer. If the email has been tagged, the word "Yes" will appear in the column. If the AOA attempted to tag an email and could not find any associated record in AdaptSuite, the words "No matches" will display in the column.

 

If you attempt to tag an email that has already been tagged, the AOA will display a warning message, but allow you to tag it again, if needed.

 

Tagging Documents

The document tagging workflow will take email attachments and import them into the document library of the selected AdaptSuite record.

  1. Select an email to load the candidate or contact in the Adapt Add-In panel; then select the document icon ().

  2. The Document Collator opens on the right side of the screen.

  3. Select the Doc Class, or Document Category, for each document listed (by clicking in the Doc Class column) and click to complete the workflow.

 

 

  1. Once the document is successfully tagged to the document segment of the record selected, a user notification displays in the lower right corner of the screen.

  2. The documents are then accessible in the record’s documents segment.

 

 

Create Candidate from Email

When an email has a resume attached that resume can be downloaded and imported into AdaptSuite via Resume Import.

  1. Select an email with a resume attached from the email application.

  2. Either right-click on the email, locate and hover over Adapt in the menu, select Create Candidate and then select the document name OR click Create Candidate from the Adapt Ribbon.

  3. The resume will download from the email application into the Resume Import segment and automatically parse.

  4. Follow the Resume Import workflow steps to complete the candidate create process.

 

Social Media Connector

The AOA acts as a bridge between AdaptSuite and social media sites (Twitter, Facebook). It allows you, from within the AOA, to select social media profiles and save them in the AdaptSuite record. It also allows you to browse data from the social media sites and select the various profiles that are correct for the current record displayed in the AOA.

  1. Select an email to load the candidate or contact in the Adapt Add-In panel; then select the social media icon: (Twitter) or (Facebook). At this point, two options display in a pop-up menu: Search and Link. If you want to search for the Twitter or Facebook profile, click Search. If you want to view an existing profile, click Link (only available if the Candidate or Contact already has Twitter or Facebook profile information in their AdaptSuite record).

  2. The associated Social Media Connector landing page opens.

  3. The Candidate's or Contact's name displays. If you want to search for their profile, click Search. If the email already has a profile link, a message displays alerting you to that fact. To access the profile, click Go. The profile displays.

 

Adapt Add-In Settings

You can access Adapt Add-in Settings in two ways:

The Settings window is divided into three areas:

 

Server Settings

 

Tagging Options

To select tagging options, click the Tagging options button.

 

Social media connectors

You have two options in this section. Click P to set proxy login details, if needed. Click Social media options to authorize and configure the Adapt Outlook Add-In with various social media sites.

 

If you select P, the AdaptSuite Outlook Add-in prompts you for your User Name, Password and Domain. This is only needed if you are using a proxy login.

 

If you select Social media options, AdaptSuite prompts for your Twitter and Facebook Account information to authorize AOA's use with those social media websites.