Updates Team and Members Blueprint examples for ADO.

docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/_azuredevops_exporter_supported_resources.mdx

@@ -3,6 +3,7 @@
 - [`project`](https://learn.microsoft.com/en-us/rest/api/azure/devops/core/projects/list?view=azure-devops-rest-7.1&tabs=HTTP#teamprojectreference)
 - [`pull-request`](https://learn.microsoft.com/en-us/rest/api/azure/devops/git/pull-requests/get-pull-requests?view=azure-devops-rest-7.1&tabs=HTTP#gitpullrequest)
 - [`pipeline`](https://learn.microsoft.com/en-us/rest/api/azure/devops/pipelines/pipelines/list?view=azure-devops-rest-7.2#pipeline)
+- [`user`](https://learn.microsoft.com/en-us/rest/api/azure/devops/memberentitlementmanagement/user-entitlements/list?view=azure-devops-rest-4.1&tabs=HTTP)
 - [`team`](https://learn.microsoft.com/en-us/rest/api/azure/devops/core/teams/get-all-teams?view=azure-devops-rest-7.1&tabs=HTTP#webapiteam)
 - [`member`](https://learn.microsoft.com/en-us/rest/api/azure/devops/core/teams/get-team-members-with-extended-properties?view=azure-devops-rest-7.1&tabs=HTTP#teammember)
 - [`work-item`](https://learn.microsoft.com/en-us/rest/api/azure/devops/wit/wiql/query-by-wiql?view=azure-devops-rest-7.1&tabs=HTTP)

docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/example-users-and-teams/_azuredevops_exporter_example_team_blueprint.mdx

@@ -0,0 +1,46 @@
+<details>
+<summary>Team blueprint</summary>
+
+```json showLineNumbers
+{
+  "identifier": "azureDevopsTeam",
+  "title": "Azure Devops Team",
+  "icon": "AzureDevops",
+  "schema": {
+    "properties": {
+      "url": {
+        "icon": "Link",
+        "title": "URL",
+        "type": "string",
+        "format": "url"
+      },
+      "description": {
+        "title": "Description",
+        "type": "string",
+        "icon": "DefaultProperty"
+      }
+    },
+    "required": []
+  },
+  "mirrorProperties": {},
+  "calculationProperties": {},
+  "aggregationProperties": {},
+  "relations": {
+    "project": {
+      "title": "Project",
+      "target": "project",
+      "required": true,
+      "many": false
+    },
+    "members": {
+      "title": "Members",
+      "description": "The ADO users belonging to this team",
+      "target": "azureDevopsUser",
+      "required": false,
+      "many": true
+    }
+  }
+}
+```
+
+</details>

docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/example-users-and-teams/_azuredevops_exporter_example_teams_port_app_config.mdx

@@ -0,0 +1,52 @@
+<details>
+
+<summary> Integration mapping </summary>
+
+```yaml showLineNumbers
+resources:
+  - kind: user
+    selector:
+      query: 'true'
+    port:
+      entity:
+        mappings:
+          identifier: .user.mailAddress
+          title: .user.displayName
+          blueprint: '"azureDevopsUser"'
+          properties:
+            url: .user.url
+  - kind: project
+    selector:
+      query: 'true'
+      defaultTeam: 'true'
+    port:
+      entity:
+        mappings:
+          identifier: '.id | gsub(" "; "")'
+          blueprint: '"project"'
+          title: .name
+          properties:
+            state: .state
+            revision: .revision
+            visibility: .visibility
+            defaultTeam: .defaultTeam.name
+            link: .url | gsub("_apis/projects/"; "")
+  - kind: team
+    selector:
+      query: 'true'
+      includeMembers: 'true'
+    port:
+      entity:
+        mappings:
+          identifier: .id
+          title: .name
+          blueprint: '"azureDevopsTeam"'
+          properties:
+            url: .url
+            description: .description
+          relations:
+            project: .projectId | gsub(" "; "")
+            members: .__members | map(.identity.uniqueName)
+```
+
+</details>

docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/example-users-and-teams/_azuredevops_exporter_example_user_blueprint.mdx

@@ -0,0 +1,27 @@
+<details>
+<summary>User blueprint</summary>
+
+```json showLineNumbers
+{
+  "identifier": "azureDevopsUser",
+  "title": "Azure Devops User",
+  "icon": "AzureDevops",
+  "schema": {
+    "properties": {
+      "url": {
+        "icon": "Link",
+        "title": "URL",
+        "type": "string",
+        "format": "url"
+      }
+    },
+    "required": []
+  },
+  "mirrorProperties": {},
+  "calculationProperties": {},
+  "aggregationProperties": {},
+  "relations": {}
+}
+```
+
+</details>

docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/examples.md

@@ -10,7 +10,7 @@ import AzureDevopsResources from './\_azuredevops_exporter_supported_resources.m
 import PipelineBlueprint from './example-pipeline/\_azuredevops_exporter_example_pipeline_blueprint.mdx'
 import PortPipelineAppConfig from './example-pipeline/\_azuredevops_exporter_example_pipeline_port_app_config.mdx'
 
-import TeamsBlueprint from './example-teams/\_azuredevops_exporter_example_team_blueprint.mdx'
+import TeamsBlueprintDeprecated from './example-teams/\_azuredevops_exporter_example_team_blueprint.mdx'
 import MembersBlueprint from './example-teams/\_azuredevops_exporter_example_member_blueprint.mdx'
 import PortTeamsAppConfig from './example-teams/\_azuredevops_exporter_example_teams_port_app_config.mdx'
 
@@ -28,6 +28,11 @@ import PortReleaseAppConfig from './example-release/\_azuredevops_exporter_examp
 import ColumnBlueprint from './example-columns/\_azuredevops_exporter_example_column_blueprint.mdx'
 import PortColumnAppConfig from './example-columns/\_azuredevops_exporter_example_column_port_app_config.mdx'
 
+import PortUsersAndTeamsAppConfig from './example-users-and-teams/\_azuredevops_exporter_example_teams_port_app_config.mdx'
+import UsersBlueprint from './example-users-and-teams/\_azuredevops_exporter_example_user_blueprint.mdx'
+import TeamsBlueprint from './example-users-and-teams/\_azuredevops_exporter_example_team_blueprint.mdx'
+
+
 
 # Examples
 
@@ -90,19 +95,44 @@ In the following example you will ingest your Azure Devops pipelines to Port, yo
 
 After creating the blueprints and saving the integration configuration, you will see new entities in Port.
 
+## Mapping users and teams
+
+The following example blueprints and integration configurations demonstrate how to ingest Azure Devops users and teams into Port:
+
+<ProjectBlueprint/>
+
+<UsersBlueprint/>
 
-## Mapping teams and members
+<TeamsBlueprint/>
+
+<PortUsersAndTeamsAppConfig/>
+
+:::tip Learn more
+- Refer to the [setup](azure-devops.md#setup) section to learn more about the integration configuration setup process.
+- Port leverages the [JQ JSON processor](https://stedolan.github.io/jq/manual/) to map and transform Azure Devops objects to Port entities.
+- Click [Here](https://learn.microsoft.com/en-us/rest/api/azure/devops/core/teams/get%20all%20teams?view=azure-devops-rest-7.1#team) for the Azure Devops team object structure.
+- Click [Here](https://learn.microsoft.com/en-us/rest/api/azure/devops/memberentitlementmanagement/user-entitlements/list?view=azure-devops-rest-4.1&tabs=HTTP) for the Azure Devops User object structure.
+
+:::
+
+After creating the blueprints and saving the integration configuration, you will see new entities in Port matching your teams alongside their members.
+
+## Mapping teams and members (Deprecated)
+
+:::caution Deprecation notice
+This section is deprecated and will be removed in a future version. Please refer to the [Mapping users and teams](#mapping-users-and-teams) section for the current implementation.
+:::
 
 In the following example you will ingest your Azure Devops teams and their members to Port, you may use the following Port blueprint definitions and integration configuration:
 
 <ProjectBlueprint/>
 
 <RepositoryBlueprint/>
 
-<TeamsBlueprint/>
-
 <MembersBlueprint/>
 
+<TeamsBlueprintDeprecated/>
+
 <PortTeamsAppConfig/>
 
 :::tip To Learn more