Install Graph Search plugin

Note This feature requires an additional plug-in. Please contact your Sales Contact to verify if a plug-in is purchased.

Prerequisites

 

Creating a Graph Search App and app configuration

In order to use Microsoft Graph Search, an app will be need to be created to allow access to the people search call of the Microsoft Graph Api.

Prerequisites

  • Your company must have Azure

  • The user account that creates the app must be present in the Azure AD directory of your company and have the rights to create apps (this is possible by default unless limited by an admin)

Guide

  1. Go to https://apps.dev.microsoft.com/ and login with a work account. This requires that your company has Azure. Any account present in your Azure will do (so it does not need to be an admin).

  2. You will end up on the application registration portal. If not, go to this url: https://apps.dev.microsoft.com/#/appList. Choose add an app at Converged Applications.

  3. This will take you to the register app screen, choose a name for your app, then choose create.

  4. You will now see app settings screen. You will also see a message to which Azure AD Tenant the app belongs. Check that this is the correct Azure environment. You will also the see the application id, which we will use in the admin consent url and in the attendant to access the app. The app is at this point also added to your application list under converged applications. Clicking on the app there will take you to the same settings screen.

  5. Go to platform and choose Add Platform. Choose Native Application. This will mark your app useable as a native application. The data generated afterwords can be left alone, we do not need to alter any of this.

  6. Under Graph Permissions we need to add one delegated permission. Delegated permissions are meant for apps that require the user to login themselves. By default User.Read is already set, you can remove this setting since we will use a higher level permission of this. The permission you need is People.Read

  7. The last thing that we need to do is to add to the app is the homepage url. This works as the return url in the app. This does not have to be an existing url, the default is http://localhost. The return url in the attendant will have to match the url you set here.

 

Installation & folders

The installation folder is default set to “C:\Program Files (x86)\Anywhere365 Attendant\” but can be changed on installation. All the plugins will be installed in the folder called plugins, if this is not present when you install a plugin it will be created.

The default installation location should be: “C:\Program Files (x86)\Anywhere365 Attendant\plugins\Wsp.Anywhere365.GraphSearch”. After installation this folder will be present.

 

Settings in the attendant

When opening the attendant click on the bottom right circle to open the settings tab. Then click on plugins in the right bar. Then select the Graph Search Plugin to open the settings page where you can configure the settings for the Graph Search Plugin.

There are three settings in the attendant that are configurable,. If you stick to the default settings there is only one setting that is required, the clientid.

Client Id: The client id of the Graph Search app.

Authority Url: The authority url is MS’ authority url that is required to make connection to the app. By default this is already set to https://login.microsoftonline.com/common/. You can change the common with the name of your azure tenant if you wish to limit app access to only those present in your azure ad.

Return Url: The return url is specified in the settings of your app. See the create app document for further information. The return url is only a formality and does not have to exist, but does need to match the url specified in the setting of your app. By default this is set to http://localhost.

Apart from the settings there is also a login button.

Login User: Logs off and on a user. This is only required if you wish to log in with a different user or if a mistake occurred when you logged into the app. The app will also pop up when you save the settings, so you do not need to use this button under normal circumstances.

When you are done with setting the settings either press the save or cancel option to save / cancel your settings. Attempting to leave the settings tab will also prompt the save / cancellation option

Assuming a client id has been filled in, the Graph Search App you created will pop up with the request that you log into it. Put in your user account and password and the Graph Search plugin will work. If you have both a school / work and personal account under this user it will ask you to make a choice which one should be used. This should be the school / work account. If this is the first time you log into the app it will also ask you to allow the required permissions to run the Graph Search App.

Accept these permissions. Like said before, should there be a reason you cannot log in the app, make the necessary changes and login via the login button on the settings page. Below is a screen of the app. Microsoft alters how the app screen looks from time to time, so if the screen looks different do not be alarmed.

 

Graph Search Plugin

We will now go into detail about the look and possibilities of the plugin. On the top toolbar of the attendant, above the calendar, click on the first icon to toggle the graph search on and off, assuming you are logged in

The Graph Search plugin is meant for searching for contacts in the graph api on the right side of the attendant.