> 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/users.md).

# Users

The user tab allows following actions:

* List all the (non-system) users in the system
* Add a new user
* Assign / revoke roles for a user
* (un-) Link the user to external systems
* Disable a user.

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

## Concepts

Next to standard users, there are also:

**System users** are not displayed in this list. These are users who cannot directly login on the stand alone user interface, but can interact with Document Warehouse using the API.

A system user can be used by an integrating application to access Document Warehouse through the API.

**Non-editable users:** are created and managed by a user sync. Currently we only offer a user sync for D365-FO users. When users are synced this way, the user-sync job can and will update the details for that user. And as a result the fields like “First Name”, “Last Name”, “Email”, … will be greyed out.

## Searching for user

To search for a user, click on the “magnifying icon” at the top of the list. This will add two text boxes in the table just below the header where a name, or email can be entered.

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

## Counters

At the top left of the user table there are two counters available. One lists the number of ‘active’ (normal) users, and the other the total number of users in the system. (including system users)

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

## Disable a user

First select the user, then check if the “Status” slider is disabled or not. If it is, the user was created using a D365-FO sync job, and you have to remove/disable the user in the D365-FO environment. Else the user was manually created, and can be manually disabled.

Note: we do not remove users, because we always need the reference so we can show information about i.e.: the uploader of a document. A disabled user will not be able to login to the UI, or get any data from the API gateway.

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

## Add or remove a user from an external system

Removing a user from an external system is as simple as clicking on the “bin” icon next to the external systems name. Note that if this is the “D365-FO” system, and the user is automatically synced with the sync job, the user will automatically be reassigned to this group the next time the job is executed.

Adding a user is just as simple; except with one caveat: you cannot define the users “external id” when you do it from the user editor page. In this case the default value will be used which is the users email address.

Should the user be known to the external system under another ID, then you have to manage this under the “External Systems” tab.

{% hint style="info" %}
What is an external system?

*This is any other component that automatically log in users when showing the UI, or can ask questions to the API gateway of Document Warehouse.*
{% endhint %}

## Adding users

**Add users to 9A Raptor DWH & Link with external system**

1. Open 9A Raptor DWH as a user with administrator privileges: [https://raptor.adultimagroup.com](https://raptor.adultimagroup.com/)
2. Go to ‘Configuration’

   <figure><img src="https://1567270722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbMdBZV3cNP56k0aYYCI6%2Fuploads%2Fgit-blob-4fac7f4ed7051de8804530a2e6940eff1788f8a5%2Fta_how_to_add_users_new3%201.png?alt=media" alt=""><figcaption></figcaption></figure>
3. Fill in user e-mail, first and last name. Confirm by choosing ‘Save’.

   <figure><img src="https://1567270722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbMdBZV3cNP56k0aYYCI6%2Fuploads%2Fgit-blob-65f9bb2da9ab6142710441c103821cebedadce57%2Fta_how_to_add_users_3%202.png?alt=media" alt=""><figcaption></figcaption></figure>
4. A default role will be added automatically to the new user (you can add or change this afterwards)

   <figure><img src="https://1567270722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbMdBZV3cNP56k0aYYCI6%2Fuploads%2Fgit-blob-d9c68fa047651b573fd2a4f19b247d52c1632746%2Fta_how_to_add_users_3%203.png?alt=media" alt=""><figcaption></figcaption></figure>
5. Make sure to link the user to at least one external system (for example D365FO as ERP or CRM) if you want the user to be able to access 9A Raptor DWH directly from within that system.

##


---

# 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/users.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.
