> For the complete documentation index, see [llms.txt](https://docs.dynalogic.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dynalogic.com/birds-document-warehouse-product-overview/setup-and-configuration/sharepoint.md).

# SharePoint

The 9A Raptor DWH SharePoint webpart allows you to integrate 9A Raptor DWH in your SharePoint site.

The install package can be requested to a 9A consultant, it contains an .sppkg file that can be uploaded to your SharePoint app catalog.

**Prerequisite**: make sure a global admin has consent to the Raptor API app registrationt. This can be done by going to <https://raptor.9altitudes.com/apigateway/swagger>, clicking 'Authorize' and authorizing for the access\_as\_a\_user scope. If no consent has been given yet, the administrator will get a popup screen to give permission on behalf of the organisation.\
![](https://1567270722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbMdBZV3cNP56k0aYYCI6%2Fuploads%2Fgit-blob-6102ec0f2eeafaff231ceb09b1b9df243965328b%2Fimage%20\(690\).png?alt=media)

**Installing the webpart:**

<figure><img src="https://1567270722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbMdBZV3cNP56k0aYYCI6%2Fuploads%2Fgit-blob-d895139c2439380fddebd9ca8f054c37b865507b%2Fsharepoint.png?alt=media" alt=""><figcaption></figcaption></figure>

Grant access to the required APIs. For customers, the 'Microsoft Graph' and 'RPTR PROD - Raptor API' permissions are sufficient.

<figure><img src="https://1567270722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbMdBZV3cNP56k0aYYCI6%2Fuploads%2Fgit-blob-619f93451816fe01e9a8227d71c09f85efe18eee%2Fsharepoint_2.png?alt=media" alt=""><figcaption></figcaption></figure>

If you receive the following error message, please check if the prerequisite mentioned above was executed:

![](https://1567270722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbMdBZV3cNP56k0aYYCI6%2Fuploads%2Fgit-blob-ffa2a49625d355a37ff0e61e16421d4a375a6222%2Fsharepoint_error.png?alt=media)

After installation, it's just a matter of adding the web part to a site/page of your choice and configuring the settings.

The Raptor widget has following functions:

* **Move the web part**: This allows the widget to be repositioned within SharePoint.
* **Edit the web part**: This makes it possible wto change the widget's settings.
* **Duplicate the webpart**: This makes it possbile to duplicate the current widget
* **Remove the webpart**: Remove the current widget.

When you click on edit web part, the setting pane opens. Here it is possible to change certain settings.

<figure><img src="https://1567270722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbMdBZV3cNP56k0aYYCI6%2Fuploads%2Fgit-blob-5ddab3af316939fb4cfdd1c52023f4529c88d3f9%2Fimage%20(386).png?alt=media" alt=""><figcaption></figcaption></figure>

![](https://1567270722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbMdBZV3cNP56k0aYYCI6%2Fuploads%2Fgit-blob-b79278f322162085c4f3b0abac1ac2f0a7fd024e%2Fsharepoint_3.png?alt=media)

**Description Field**: The description field allows you to change the description of the widget.

**Raptor Url**: This is the url to the raptor environment, for customers this should always be <https://raptor.9altitudes.com>.

**Raptor Azure AD API Client Id**: This is the app registration ID for the Raptor API. For customers this should always be 67776919-ed19-4647-aef4-f291e4e41f18.

**Tenant Id**: The tenant id can be found in the Raptor environment under "About".

**Fields**: Makes it possible to apply the search term to the fields, put a comma between two fields.This can be achieved by copying the query.

**Tags**: Makes it possible to apply the search term to the tags, put a comma between two tags. This can be achieved by copying the query. A new option is to **use tag ids from url**, you can fill url with tagIds= tagId1,tagId2 etc...

![](https://1567270722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbMdBZV3cNP56k0aYYCI6%2Fuploads%2Fgit-blob-0ec8f926c96087096d005b57781feacd30844d70%2Fsharepoint_012.jpg?alt=media)

**DocumentFilter Name**: When copying the queryn it is possible to give it a name.

**DocumentFilter**: The document filter allow you to filter on documents.

**Filterable Fields**: The filter allow you to filter on fields.

**Modes**: In compact mode, the detail panel only appears when you click on it. If this function is off, both panels are displayed below each other.

**The read-only mode**: The read only mode makes it possible to read only the document, not delete or modify them.

![](https://1567270722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbMdBZV3cNP56k0aYYCI6%2Fuploads%2Fgit-blob-c25d9997f76bfc1d0e14f7b3668a5a4cfdc2ea7d%2Fsharepoint_compact_mode.png?alt=media)

**Disabel context detach**: (1)

**Disable upload**: disable the upload button (2)

![](https://1567270722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbMdBZV3cNP56k0aYYCI6%2Fuploads%2Fgit-blob-4183336356224d6ce0a95023f7be789859a3d40d%2Fsharepoint_edit03.png?alt=media)

**Disable download**: disable the download button (4)

**Disable view**: disable or enable the view (5)

**Disable email**:disable or enable the email function (6)

**Disable copy**: disable or enable the copy link function (7)

**Disable delete**: disable or enable the delete button (3)

**Disable external source**: disable the exteral source in configuration.

**Disable Document triggers**: disable the document triggers in configurtion.

**Disable User options**: disable or enable user configuration (8)

**Disable tenant name**:Show the tenant name (9)

<figure><img src="https://1567270722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbMdBZV3cNP56k0aYYCI6%2Fuploads%2Fgit-blob-4fe40143c8ae8cd21a81444e58a8cb0cde858cd9%2Fimage%20(397).png?alt=media" alt=""><figcaption></figcaption></figure>

**Click on apply and republish the site, to see the chosen result**

<div align="left"><figure><img src="https://1567270722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbMdBZV3cNP56k0aYYCI6%2Fuploads%2Fgit-blob-826fc2833ef46014092a527a9e5cb2b8aeefa40e%2Fimage%20(362).png?alt=media" alt=""><figcaption></figcaption></figure></div>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.dynalogic.com/birds-document-warehouse-product-overview/setup-and-configuration/sharepoint.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
