Deployment and Base Setup

Deployment

  1. Upload the Raytion Search Center for Microsoft Search’s solution file (spkkg) into the site app store where you want to use it

  2. After the upload, automatically the message "Do you trust Raytion Search Center for Microsoft Search" shows up.
    deployment 1

    1. Please check the "Make this solution available to all sites in the organization"

    2. Please click on "Deploy" afterwards

Approve Search Center Permissions

After the initial deployment of the search center, a global administrator can approve the permissions, which were listed during the "Do you trust Raytion Search Center for Microsoft Search" dialog.

The following lists which permissions are needed for which rendering use case

  1. Microsoft Search Graph Connector Query APIs

    1. ExternalItem.Read.All

  2. Project space cards

    1. Group.Read.All

    2. Files.Read.All

  3. User profile cards

    1. User profile information

      1. User.ReadBasic.All

      2. Contacts.Read

      3. People.Read

    2. User status

      1. Presence.Read.All

You can approve these permissions as follows:

Open the SharePoint Online administration

  1. Log in as a global admin

  2. Choose Advanced > API Settings

  3. Below pending approvals click on the respective permissions

  4. Click on approve

Please note that the SharePoint Online App model does not limit the approved permissions to just the WebPart which asked for it. Once a permission was approved, it can be used also by other WebParts in SharePoint Online.

Create a Recommended Links List

  1. Create a new SharePoint list in this site collection

  2. Make sure to have the following fields in order to fill the right managed properties afterwards:
    "Title" (default field), "Link Url" (Single Value Field, mandatory), "Keywords" (multi value field, optional)

  3. Add at least one recommended link where you fill in texts in the above-mentioned fields

  4. Wait for some time

  5. From the page settings, open Site Information > View all Site Settings

  6. Open Search Schema

  7. Click on Crawled Properties

  8. Create a new managed property called "ToolUrl". This managed property should be at least "Retrievable" and can be Queryable.

    1. Add the mapping "ows_LinkUrl" or similar

    2. Click on save

  9. Create a new managed property called ToolKeywords. This managed property should be "Searchable" and "Retrievable".

    1. Add the mapping "ows_Keywords" or similar

    2. Click on save

  10. Remove the list item which you have created in Step 3

  11. Start filling the list with a few first recommended links. These will be used for testing later.