Microsoft Graph connector

Starmind's Microsoft Graph connector integration is a custom connector integration into Microsoft 365 search experience

The integration leverages the Microsoft Graph connectors API to build the custom connection and helps to bring the Starmind knowledge into your organisation's Microsoft 365 environment.

This integration help users to have a central search point for information by connecting Starmind's knowledge to your existing knowledge in the Microsoft environment.

❗️

Additional cost at Microsoft end

There is additional cost from Microsoft to add items to the Microsoft 365 search. The costs are related to the amount of Starmind data indexed. For more details please check the Microsoft's purchase-of-add-on-index-quota here.

📘

Maximum 30 Graph Connections

Please make sure that your organisation has not exhausted the limit of maximum 30 Microsoft Graph Connections. Read more here.

How does this integration looks like?

It is very simple one to use from a user journey perspective. As we are integrated into Microsoft 365 search, you can directly look for content on Starmind from your regular Microsoft search bar or related entry points..

From your Sharepoint application you can simply type the search terms for which you are looking for information. In the below screenshot, the typed search term is 'Artificial intelligence' and you see in the All tab, all the related content within your Microsoft Environment. Since we connected Starmind content to the search, you will see the questions that belong from Starmind as well.

Now if you click on the 'More Starmind Questions result' or navigate to the Starmind Tab you will only see the content from Starmind. This refines the search and show you more content then what you saw in the All tab.

When you find the information you are looking for in the search results, you can simply click on it and it will redirect you to the Starmind platform where you can read more on the topics and also scroll through different answers from your colleagues.

How does this Integration Work?

We will initiate a connection to the Starmind App from the Azure tenant. Once the connection is made, we will start fetching all the content existing on your Starmind platform and start indexing it into the Azure repository. We will make sure to get the latest content and updates from Starmind and update the Azure repository on a regular basis.

Microsoft Graph Connector - Setup

Prerequisites

  • To integrate the Starmind Microsoft Graph connector with your Microsoft 365 Search, request the installation via our technical support channel providing your Starmind network domain (xyz.starmind.com) and your organization's Microsoft 365 tenant ID.
  • Starmind technical support will then get back to you with a URL to request admin consent for the Starmind Microsoft Graph connector ( an Azure enterprise application) for your Microsoft Tenant. The Starmind Microsoft Graph connector requires the following permissions to be granted.

Create a Connection and Schema


Create a vertical

You have to surface the data in Microsoft Search, which involves creating a vertical (Starmind vertical) and a result type to display the search results.

To create and enable a search vertical at the organisation level, sign in to the Microsoft 365 admin center by using the global administrator role, and do the following:

  1. Go to Settings > Search & intelligence > Customizations.
  2. Go to Vertical, and then select Add.
  3. Provide the following details:
    1. Name of the Vertical: You can choose any name you like, we recommend simply calling it 'Starmind '.
    2. Content source: The connector created with the app (we will provide you the name of the content source. Typcially it is "Starmind").
    3. Add a query: Leave Blank
    4. Filters: Leave Blank
    5. Enable the new vertical

Create a result type

To create a result type, do the following:

  1. Go to Settings > Search & intelligence > Customizations.
  2. Go to the Result type tab, and then select Add.
  3. Provide the following details:
    1. Name: Starmind
    2. Content source: The connector created with the app (we will provide you the name of the content source).
    3. Rules: none
    4. Design your layout: Paste the JSON below into your designer textbox. Change the url with your network url

Adaptive Card layout

You can also find Microsoft documentation on creating a vertical and result source here.

{
    "type": "AdaptiveCard",
    "version": "1.3",
    "body": [
        {
            "type": "ColumnSet",
            "columns": [
                {
                    "type": "Column",
                    "width": "auto",
                    "items": [
                        {
                            "type": "Image",
                            "url": "https://your_network.starmind.com/public/network-logo",
                            "horizontalAlignment": "Center",
                            "size": "Small"
                        }
                    ],
                    "horizontalAlignment": "Center"
                },
                {
                    "type": "Column",
                    "width": "stretch",
                    "items": [
                        {
                            "type": "ColumnSet",
                            "columns": [
                                {
                                    "type": "Column",
                                    "width": "auto",
                                    "items": [
                                        {
                                            "type": "TextBlock",
                                            "text": "[{title}]({url})",
                                            "weight": "Bolder",
                                            "size": "Medium",
                                            "maxLines": 3,
                                            "color": "Accent"
                                        }
                                    ],
                                    "spacing": "None"
                                }
                            ],
                            "spacing": "Small"
                        },
                        {
                            "type": "Container",
                            "items": [
                                {
                                    "type": "TextBlock",
                                    "text": "last updated {{DATE({updated})}}",
                                    "spacing": "Small",
                                    "$when": "{published!=''}"
                                }
                            ],
                            "spacing": "Small"
                        },
                        {
                            "type": "Container",
                            "items": [
                                {
                                    "type": "TextBlock",
                                    "text": "{solutionCount} answer(s)",
                                    "spacing": "Small",
                                    "$when": "{published!=''}"
                                }
                            ],
                            "spacing": "Small"
                        },
                        {
                            "type": "TextBlock",
                            "text": "{description}",
                            "maxLines": 2,
                            "spacing": "Small"
                        }
                    ],
                    "spacing": "Medium"
                }
            ]
        }
    ],
    "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
    "$data": {}
}

👍

Well done

You have successfully configured the integration at Microsoft 365 admin center.