MS Graph Connector

Starmind's MS Graph connector integration is a custom connector integration into Microsoft 365 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 office 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.

🚧

Cost at Microsoft end

There is additional cost from Microsoft to add items to the Ms search.
For more details please check the Microsoft's purchase-of-add-on-index-quota here.

📘

Maximum 10 Graph Connections

Please make sure that your organisation has not exhausted the limit of maximum 10 Microsoft Graph Connections. Organisations are limited to a maximum of 10 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 MS search, you can directly look for content on starmind from your regular MS search bar.

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 'iframe' 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.

1210

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.

1389

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 make 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.

Setup

The following mentioned steps helps you to configure this integration at your end. You have to surface the data in the MS search which involves creating a vertical (Starmind vertical) and a result type.

Create a vertical

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 using 'Starmind Search'.
    2. Content source: The connector created with the app (we will provide you the name of the content source).
    3. Add a query: Leave Blank
    4. Filters: Leave Blank

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 Search
    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 following json into your designer textbox.
    5. In the following json code, change the url with your network url

You can also find Microsoft documentation on how to create a vertical and result source here.

{
    "type": "AdaptiveCard",
    "version": "1.3",
    "body": [
        {
            "type": "ColumnSet",
            "columns": [
                {
                    "type": "Column",
                    "width": "auto",
                    "items": [
                        {
                            "type": "Image",
                            "url": "https://staging.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} answers",
                                    "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": {}
}

👍

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

Application Configuration at Azure end.