Skip to content
28 changes: 25 additions & 3 deletions docs/getting-started/set-up-automatic-discovery.md
Original file line number Diff line number Diff line change
Expand Up @@ -487,18 +487,40 @@ Common examples for resources that can be used as a source of truth for `users`:
<details>
<summary><LogoImage logo="GitLab" /> **GitLab user (click to expand)**</summary>
```yaml showLineNumbers
- kind: user
- kind: group-with-members
selector:
query: 'true'
includeBotMembers: 'true'
includeInheritedMembers: 'true'
port:
itemsToParse: .__members
entity:
mappings:
identifier: .username
title: .username
identifier: .item.username
title: .item.name
blueprint: '"_user"'
relations:
gitlab_user: .item.username
```
</details>

<details>
<summary><LogoImage logo="AzureDevops" /> **Azure DevOps user (click to expand)**</summary>
```yaml showLineNumbers
- kind: user
selector:
query: 'true'
port:
entity:
mappings:
identifier: '.id'
title: '.user.displayName'
blueprint: '"_user"'
relations:
azure_devops_user: '.id'
```
</details>

</TabItem>

<TabItem value="Teams">
Expand Down
6 changes: 3 additions & 3 deletions docs/guides/all/map-hibob-users-to-port-accounts.md
Original file line number Diff line number Diff line change
Expand Up @@ -398,7 +398,7 @@ Follow the steps below to create the action:

Now we'll create the automations that process the HiBob users list and sends the response to the webhook for bulk ingestion and single user ingestion.

<h3> Create automation to bulk ingest HiBob users</h3>
### Bulk ingest HiBob users

This automation will trigger when the [Sync HiBob Users](#sync-hibob-users-self-service-action) action is executed.
It will then process the HiBob users list and send the response to the webhook for bulk ingestion.
Expand Down Expand Up @@ -461,7 +461,7 @@ Follow the steps below to create the automation:

5. Click `Save` to create the automation.

<h3> Create automation to process single HiBob user</h3>
### Process a single HiBob user

This automation will trigger when the [Get HiBob user by email](#get-hibob-user-by-email-self-service-action) action is executed.
It will then process the HiBob user and send the response to the webhook for single user ingestion.
Expand Down Expand Up @@ -520,7 +520,7 @@ Follow the steps below to create the automation:

5. Click `Save` to create the automation.

<h3> Create automation to sync HiBob users when a new Port user is added</h3>
### Sync HiBob users when a new Port user is added

To ensure new Port users get mapped to HiBob users automatically, we'll create an automation that triggers when a new Port user is created.
This automation will trigger the [Get HiBob user by email](#get-hibob-user-by-email-self-service-action) action to fetch details of the HiBob user by email, which will then be processed by the webhook integration.
Expand Down
7 changes: 3 additions & 4 deletions docs/guides/all/map-servicenow-users-to-port-accounts.md
Original file line number Diff line number Diff line change
Expand Up @@ -465,7 +465,7 @@ Follow the steps below to create the action:

Now we'll create the automations that process the ServiceNow users list and sends the response to the webhook for bulk ingestion and single user ingestion.

<h3> Create automation to bulk ingest ServiceNow users</h3>
### Bulk ingest ServiceNow users

This automation will trigger when the [Sync ServiceNow Users](#sync-service-now-users-self-service-action) action is executed.
It will then process the ServiceNow users list and send the response to the webhook for bulk ingestion.
Expand Down Expand Up @@ -529,7 +529,7 @@ Follow the steps below to create the automation:
5. Click `Save` to create the automation.


<h3> Create automation to process single ServiceNow user</h3>
### Process a single ServiceNow user

This automation will trigger when the [Get ServiceNow user by email](#get-service-now-user-by-email-self-service-action) action is executed.
It will then process the ServiceNow user and send the response to the webhook for single user ingestion.
Expand Down Expand Up @@ -588,8 +588,7 @@ Follow the steps below to create the automation:
6. Click `Save` to create the automation.



<h3> Create automation to sync ServiceNow users when a new Port user is added</h3>
### Sync ServiceNow users when a new Port user is added

To ensure new Port users get mapped to ServiceNow users automatically, we'll create an automation that triggers when a new Port user is created.
This automation will trigger the [Get ServiceNow user by email](#get-service-now-user-by-email-self-service-action) action to fetch details of the ServiceNow user by email and trigger the [process single ServiceNow user automation](#create-automation-to-process-single-servicenow-user) for processing.
Expand Down
6 changes: 3 additions & 3 deletions docs/guides/all/map-slack-users-to-port-accounts.md
Original file line number Diff line number Diff line change
Expand Up @@ -396,7 +396,7 @@ Follow the steps below to create the action:

Now we'll create the automations that process the Slack users list and sends the response to the webhook for bulk ingestion and single user ingestion.

<h3> Create automation to bulk ingest Slack users</h3>
### Bulk ingest Slack users

This automation will trigger when the [Sync Slack Users](#sync-slack-users-self-service-action) action is executed.
It will then process the Slack users list and send the response to the webhook for bulk ingestion.
Expand Down Expand Up @@ -460,7 +460,7 @@ Follow the steps below to create the automation:

5. Click `Save` to create the automation.

<h3> Create automation to process single Slack user</h3>
### Process a single Slack user

This automation will trigger when the [Get Slack user by email](#get-slack-user-by-email-self-service-action) action is executed.
It will then process the Slack user and send the response to the webhook for single user ingestion.
Expand Down Expand Up @@ -521,7 +521,7 @@ Follow the steps below to create the automation:
5. Click `Save` to create the automation.


<h3> Create automation to sync Slack users when a new Port user is added</h3>
### Sync Slack users when a new Port user is added

To ensure new Port users get mapped to Slack users automatically, we'll create an automation that triggers when a new Port user is created.
This automation will trigger the [Get Slack user by email](#get-slack-user-by-email-self-service-action) action to fetch details of the Slack user by email and trigger the [process single slack user automation](#create-automation-to-process-single-slack-user) for processing.
Expand Down
Loading