From fd312d68a5a29804435c08d0e98f265f1b0213c0 Mon Sep 17 00:00:00 2001 From: Habib Nuhu Date: Tue, 23 Sep 2025 08:53:05 +0100 Subject: [PATCH 01/11] feat(ADO): Added docs for Iteration kind --- ...uredevops_exporter_supported_resources.mdx | 1 + .../git/azure-devops/azure-devops.md | 67 +++++++++++++++++ ...s_exporter_example_iteration_blueprint.mdx | 73 +++++++++++++++++++ ...rter_example_iteration_port_app_config.mdx | 42 +++++++++++ .../git/azure-devops/examples.md | 24 ++++++ 5 files changed, 207 insertions(+) create mode 100644 docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/example-iteration/_azuredevops_exporter_example_iteration_blueprint.mdx create mode 100644 docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/example-iteration/_azuredevops_exporter_example_iteration_port_app_config.mdx diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/_azuredevops_exporter_supported_resources.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/_azuredevops_exporter_supported_resources.mdx index d56685fd84..e99ac787e0 100644 --- a/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/_azuredevops_exporter_supported_resources.mdx +++ b/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/_azuredevops_exporter_supported_resources.mdx @@ -6,6 +6,7 @@ - [`build`](https://learn.microsoft.com/en-us/rest/api/azure/devops/build/builds/list?view=azure-devops-rest-7.1&tabs=HTTP#build) - [`pipeline-stage`](https://learn.microsoft.com/en-us/rest/api/azure/devops/pipelines/runs/list-stages?view=azure-devops-rest-7.1&tabs=HTTP#stage) - [`pipeline-run`](https://learn.microsoft.com/en-us/rest/api/azure/devops/pipelines/runs/list?view=azure-devops-rest-7.1&tabs=HTTP#run) +- [`iteration`](https://learn.microsoft.com/en-us/rest/api/azure/devops/work/iterations/list?view=azure-devops-rest-7.1&tabs=HTTP#teamsettingsiteration) - [`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) diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/azure-devops.md b/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/azure-devops.md index 4abf5ef4d4..9188f1c5f2 100644 --- a/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/azure-devops.md +++ b/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/azure-devops.md @@ -221,6 +221,22 @@ resources: pipelineName: .pipeline.name relations: project: .__project.id | gsub(" "; "") +- kind: iteration + selector: + query: 'true' + port: + entity: + mappings: + identifier: .id | gsub(" "; "") + title: .name + blueprint: '"iteration"' + properties: + name: .name + path: .path + iterationKind: .__iterationKind + timeFrame: .attributes.timeFrame + relations: + project: .__project.id | gsub(" "; "") ``` @@ -1006,6 +1022,32 @@ Here is an example of the payload structure from Azure DevOps: +
+ Iteration response data + +```json showLineNumbers +{ + "id": "Sprint 1", + "name": "Sprint 1", + "path": "\\Port Integration\\Sprint 1", + "attributes": { + "startDate": "2023-11-01T00:00:00.000Z", + "finishDate": "2023-11-15T00:00:00.000Z", + "timeFrame": "past" + }, + "__project": { + "id": "fd029361-7854-4cdd-8ace-bb033fca399c", + "name": "Port Integration" + }, + "__iterationKind": "sprint" +} +``` + +
+ + + + ### Mapping Result The combination of the sample payload and the Ocean configuration generates the following Port entity: @@ -1201,6 +1243,31 @@ The combination of the sample payload and the Ocean configuration generates the +
+ Iteration entity in Port + +```json showLineNumbers +{ + "identifier": "Sprint 1", + "title": "Sprint 1", + "blueprint": "iteration", + "properties": { + "name": "Sprint 1", + "path": "\\Port Integration\\Sprint 1", + "iterationKind": "sprint", + "timeFrame": "past" + }, + "relations": { + "project": "fd029361-7854-4cdd-8ace-bb033fca399c" + } +} +``` + +
+ + + + ## Relevant Guides For relevant guides and examples, see the [guides section](https://docs.port.io/guides?tags=AzureDevops). diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/example-iteration/_azuredevops_exporter_example_iteration_blueprint.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/example-iteration/_azuredevops_exporter_example_iteration_blueprint.mdx new file mode 100644 index 0000000000..b99bcc91b5 --- /dev/null +++ b/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/example-iteration/_azuredevops_exporter_example_iteration_blueprint.mdx @@ -0,0 +1,73 @@ +
+Iteration blueprint + +```json showLineNumbers +{ + "identifier": "iteration", + "title": "Iteration", + "icon": "AzureDevops", + "schema": { + "properties": { + "name": { + "title": "Name", + "type": "string", + "icon": "Calendar", + "description": "The name of the iteration" + }, + "path": { + "title": "Path", + "type": "string", + "icon": "AzureDevops", + "description": "The hierarchical path of the iteration" + }, + "iterationKind": { + "title": "Iteration Kind", + "type": "string", + "icon": "AzureDevops", + "description": "The classified type of iteration (sprint, release, milestone, epic, iteration)" + }, + "startDate": { + "title": "Start Date", + "type": "string", + "format": "date-time", + "icon": "Calendar", + "description": "The start date of the iteration" + }, + "finishDate": { + "title": "Finish Date", + "type": "string", + "format": "date-time", + "icon": "Calendar", + "description": "The finish date of the iteration" + }, + "timeFrame": { + "title": "Time Frame", + "type": "string", + "icon": "Clock", + "description": "The time frame of the iteration (past, current, future)" + }, + "link": { + "title": "Link", + "type": "string", + "format": "url", + "icon": "AzureDevops", + "description": "Link to the iteration in Azure DevOps" + } + }, + "required": [] + }, + "mirrorProperties": {}, + "calculationProperties": {}, + "aggregationProperties": {}, + "relations": { + "project": { + "title": "Project", + "target": "azureDevopsProject", + "required": true, + "many": false + } + } +} +``` + +
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/example-iteration/_azuredevops_exporter_example_iteration_port_app_config.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/example-iteration/_azuredevops_exporter_example_iteration_port_app_config.mdx new file mode 100644 index 0000000000..970605c58d --- /dev/null +++ b/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/example-iteration/_azuredevops_exporter_example_iteration_port_app_config.mdx @@ -0,0 +1,42 @@ +
+ +Integration mapping + +```yaml showLineNumbers +resources: + - kind: project + selector: + query: 'true' + defaultTeam: 'false' + 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: iteration + selector: + query: 'true' + port: + entity: + mappings: + identifier: .id | gsub(" "; "") + title: .name + blueprint: '"iteration"' + properties: + name: .name + path: .path + iterationKind: .__iterationKind + timeFrame: .attributes.timeFrame + relations: + project: .__project.id | gsub(" "; "") + +``` + +
diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/examples.md b/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/examples.md index 8a71a4c0b7..640391d411 100644 --- a/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/examples.md +++ b/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/examples.md @@ -44,6 +44,9 @@ import PortPipelineStageAppConfig from './example-pipeline-stage/\_azuredevops_e import PipelineRunBlueprint from './example-pipeline-run/\_azuredevops_exporter_example_pipeline_run_blueprint.mdx' import PortPipelineRunAppConfig from './example-pipeline-run/\_azuredevops_exporter_example_pipeline_run_port_app_config.mdx' +import IterationBlueprint from './example-iteration/\_azuredevops_exporter_example_iteration_blueprint.mdx' +import PortIterationAppConfig from './example-iteration/\_azuredevops_exporter_example_iteration_port_app_config.mdx' + # Examples @@ -175,6 +178,27 @@ You can use the following Port blueprint definitions and integration configurati After creating the blueprints and saving the integration configuration, you will see new entities in Port matching your pipeline runs. +## Mapping iterations + +The following example demonstrates how to ingest your Azure DevOps iterations (sprints, releases, milestones) to Port. +You can use the following Port blueprint definitions and integration configuration: + + + + + + + +:::tip To Learn more + +- Refer to the [setup](azure-devops.md#setup) section to learn more about the integration configuration setup process. +- We leverage [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/work/iterations/list?view=azure-devops-rest-7.1&tabs=HTTP#teamsettingsiteration) for the Azure DevOps iteration object structure. + +::: + +After creating the blueprints and saving the integration configuration, you will see new entities in Port matching your iterations. + ## Mapping users and teams :::caution Azure DevOps Server limitation From 8f3e05e2a4c8e87ed3535bc3a900ac4a59aa06b7 Mon Sep 17 00:00:00 2001 From: Habib Nuhu Date: Tue, 23 Sep 2025 14:29:17 +0100 Subject: [PATCH 02/11] fix: removed iteration_kind from blueprint and mapping --- .../sync-data-to-catalog/git/azure-devops/azure-devops.md | 1 - .../_azuredevops_exporter_example_iteration_port_app_config.mdx | 1 - 2 files changed, 2 deletions(-) diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/azure-devops.md b/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/azure-devops.md index 9188f1c5f2..a02c47f2c9 100644 --- a/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/azure-devops.md +++ b/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/azure-devops.md @@ -233,7 +233,6 @@ resources: properties: name: .name path: .path - iterationKind: .__iterationKind timeFrame: .attributes.timeFrame relations: project: .__project.id | gsub(" "; "") diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/example-iteration/_azuredevops_exporter_example_iteration_port_app_config.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/example-iteration/_azuredevops_exporter_example_iteration_port_app_config.mdx index 970605c58d..a0a7c3dfe0 100644 --- a/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/example-iteration/_azuredevops_exporter_example_iteration_port_app_config.mdx +++ b/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/example-iteration/_azuredevops_exporter_example_iteration_port_app_config.mdx @@ -32,7 +32,6 @@ resources: properties: name: .name path: .path - iterationKind: .__iterationKind timeFrame: .attributes.timeFrame relations: project: .__project.id | gsub(" "; "") From bd9f93d6b74abb1e75245b0d7867b37c0d47334c Mon Sep 17 00:00:00 2001 From: Habib Nuhu Date: Thu, 25 Sep 2025 08:29:07 +0100 Subject: [PATCH 03/11] fix: clean up --- .../git/azure-devops/azure-devops.md | 4 +--- ...zuredevops_exporter_example_iteration_blueprint.mdx | 10 ++-------- 2 files changed, 3 insertions(+), 11 deletions(-) diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/azure-devops.md b/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/azure-devops.md index a02c47f2c9..71ee671c35 100644 --- a/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/azure-devops.md +++ b/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/azure-devops.md @@ -1037,8 +1037,7 @@ Here is an example of the payload structure from Azure DevOps: "__project": { "id": "fd029361-7854-4cdd-8ace-bb033fca399c", "name": "Port Integration" - }, - "__iterationKind": "sprint" + } } ``` @@ -1253,7 +1252,6 @@ The combination of the sample payload and the Ocean configuration generates the "properties": { "name": "Sprint 1", "path": "\\Port Integration\\Sprint 1", - "iterationKind": "sprint", "timeFrame": "past" }, "relations": { diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/example-iteration/_azuredevops_exporter_example_iteration_blueprint.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/example-iteration/_azuredevops_exporter_example_iteration_blueprint.mdx index b99bcc91b5..c607d56f37 100644 --- a/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/example-iteration/_azuredevops_exporter_example_iteration_blueprint.mdx +++ b/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/example-iteration/_azuredevops_exporter_example_iteration_blueprint.mdx @@ -20,24 +20,18 @@ "icon": "AzureDevops", "description": "The hierarchical path of the iteration" }, - "iterationKind": { - "title": "Iteration Kind", - "type": "string", - "icon": "AzureDevops", - "description": "The classified type of iteration (sprint, release, milestone, epic, iteration)" - }, "startDate": { "title": "Start Date", "type": "string", "format": "date-time", - "icon": "Calendar", + "icon": "AzureDevops", "description": "The start date of the iteration" }, "finishDate": { "title": "Finish Date", "type": "string", "format": "date-time", - "icon": "Calendar", + "icon": "AzureDevops", "description": "The finish date of the iteration" }, "timeFrame": { From 1a975dc946a0b76e902ead8056b89df6c305dacc Mon Sep 17 00:00:00 2001 From: Habib Nuhu Date: Thu, 25 Sep 2025 12:59:39 +0100 Subject: [PATCH 04/11] fix: removed build, pipeline runs , stages and iterations from default mappings --- .../git/azure-devops/azure-devops.md | 73 ------------------- 1 file changed, 73 deletions(-) diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/azure-devops.md b/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/azure-devops.md index 71ee671c35..3f230b1189 100644 --- a/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/azure-devops.md +++ b/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/azure-devops.md @@ -163,79 +163,6 @@ resources: value: '[.reviewers[].uniqueName]' azure_devops_reviewers: '[.reviewers[].id]' azure_devops_creator: .createdBy.id -- kind: build - selector: - query: "true" - port: - entity: - mappings: - identifier: .__project.id + "-" + (.id | tostring) | gsub(" "; "") - title: .buildNumber - blueprint: '"build"' - properties: - status: .status - result: .result - queueTime: .queueTime - startTime: .startTime - finishTime: .finishTime - definitionName: .definition.name - requestedFor: .requestedFor.displayName - link: ._links.web.href - relations: - project: .__project.id | gsub(" "; "") -- kind: pipeline-stage - selector: - query: 'true' - port: - entity: - mappings: - identifier: >- - .__project.id + "-" + (.__buildId | tostring) + "-" + (.id | - tostring) | gsub(" "; "") - title: .name - blueprint: '"pipeline-stage"' - properties: - state: .state - result: .result - startTime: .startTime - finishTime: .finishTime - stageType: .type - relations: - project: .__project.id | gsub(" "; "") - build: (.__project.id + "-" + (.__buildId | tostring)) | gsub(" "; "") -- kind: pipeline-run - selector: - query: 'true' - port: - entity: - mappings: - identifier: >- - .__project.id + "-" + (.__pipeline.id | tostring) + "-" + (.id | - tostring) | gsub(" "; "") - blueprint: '"pipeline-run"' - properties: - state: .state - result: .result - createdDate: .createdDate - finishedDate: .finishedDate - pipelineName: .pipeline.name - relations: - project: .__project.id | gsub(" "; "") -- kind: iteration - selector: - query: 'true' - port: - entity: - mappings: - identifier: .id | gsub(" "; "") - title: .name - blueprint: '"iteration"' - properties: - name: .name - path: .path - timeFrame: .attributes.timeFrame - relations: - project: .__project.id | gsub(" "; "") ``` From 4106f7a29e6de30656e88ce9246fec199f78f95d Mon Sep 17 00:00:00 2001 From: Habib Nuhu Date: Thu, 25 Sep 2025 12:59:54 +0100 Subject: [PATCH 05/11] fix: updated mapping to include missing fields --- .../_azuredevops_exporter_example_iteration_blueprint.mdx | 5 +---- ...zuredevops_exporter_example_iteration_port_app_config.mdx | 3 +++ 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/example-iteration/_azuredevops_exporter_example_iteration_blueprint.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/example-iteration/_azuredevops_exporter_example_iteration_blueprint.mdx index c607d56f37..681a65505f 100644 --- a/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/example-iteration/_azuredevops_exporter_example_iteration_blueprint.mdx +++ b/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/example-iteration/_azuredevops_exporter_example_iteration_blueprint.mdx @@ -11,7 +11,7 @@ "name": { "title": "Name", "type": "string", - "icon": "Calendar", + "icon": "AzureDevops", "description": "The name of the iteration" }, "path": { @@ -23,14 +23,12 @@ "startDate": { "title": "Start Date", "type": "string", - "format": "date-time", "icon": "AzureDevops", "description": "The start date of the iteration" }, "finishDate": { "title": "Finish Date", "type": "string", - "format": "date-time", "icon": "AzureDevops", "description": "The finish date of the iteration" }, @@ -43,7 +41,6 @@ "link": { "title": "Link", "type": "string", - "format": "url", "icon": "AzureDevops", "description": "Link to the iteration in Azure DevOps" } diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/example-iteration/_azuredevops_exporter_example_iteration_port_app_config.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/example-iteration/_azuredevops_exporter_example_iteration_port_app_config.mdx index a0a7c3dfe0..8b2c9f3f93 100644 --- a/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/example-iteration/_azuredevops_exporter_example_iteration_port_app_config.mdx +++ b/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/example-iteration/_azuredevops_exporter_example_iteration_port_app_config.mdx @@ -32,7 +32,10 @@ resources: properties: name: .name path: .path + startDate: (.attributes.startDate // 0) + finishDate: (.attributes.finishDate // 0) timeFrame: .attributes.timeFrame + link: .url relations: project: .__project.id | gsub(" "; "") From 7ee37a9411e339755417672c24b4be7832f06786 Mon Sep 17 00:00:00 2001 From: Habib Nuhu <32038237+dev-habib-nuhu@users.noreply.github.com> Date: Wed, 8 Oct 2025 10:45:07 +0100 Subject: [PATCH 06/11] Update docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/azure-devops.md Co-authored-by: sivanel97 --- .../sync-data-to-catalog/git/azure-devops/azure-devops.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/azure-devops.md b/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/azure-devops.md index 3f230b1189..672f9345d6 100644 --- a/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/azure-devops.md +++ b/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/azure-devops.md @@ -949,7 +949,7 @@ Here is an example of the payload structure from Azure DevOps:
- Iteration response data +Iteration response data (click to expand) ```json showLineNumbers { From 5ab9022cb955ba3f9d70096d29fb1195a02dc3e0 Mon Sep 17 00:00:00 2001 From: Habib Nuhu <32038237+dev-habib-nuhu@users.noreply.github.com> Date: Wed, 8 Oct 2025 10:45:18 +0100 Subject: [PATCH 07/11] Update docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/example-iteration/_azuredevops_exporter_example_iteration_blueprint.mdx Co-authored-by: sivanel97 --- .../_azuredevops_exporter_example_iteration_blueprint.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/example-iteration/_azuredevops_exporter_example_iteration_blueprint.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/example-iteration/_azuredevops_exporter_example_iteration_blueprint.mdx index 681a65505f..1684526e9d 100644 --- a/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/example-iteration/_azuredevops_exporter_example_iteration_blueprint.mdx +++ b/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/example-iteration/_azuredevops_exporter_example_iteration_blueprint.mdx @@ -1,5 +1,5 @@
-Iteration blueprint +Iteration blueprint (click to expand) ```json showLineNumbers { From 3de7cdb14b21c8ecec62fa1304f9cf7f7fb9e51e Mon Sep 17 00:00:00 2001 From: Habib Nuhu <32038237+dev-habib-nuhu@users.noreply.github.com> Date: Wed, 8 Oct 2025 10:45:27 +0100 Subject: [PATCH 08/11] Update docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/example-iteration/_azuredevops_exporter_example_iteration_port_app_config.mdx Co-authored-by: sivanel97 --- ..._azuredevops_exporter_example_iteration_port_app_config.mdx | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/example-iteration/_azuredevops_exporter_example_iteration_port_app_config.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/example-iteration/_azuredevops_exporter_example_iteration_port_app_config.mdx index 8b2c9f3f93..a3477fa2a4 100644 --- a/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/example-iteration/_azuredevops_exporter_example_iteration_port_app_config.mdx +++ b/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/example-iteration/_azuredevops_exporter_example_iteration_port_app_config.mdx @@ -1,6 +1,5 @@
- -Integration mapping +Integration mapping (click to expand) ```yaml showLineNumbers resources: From fca132389cbcd70a8f0b37c9906183ad7403a9ad Mon Sep 17 00:00:00 2001 From: Habib Nuhu <32038237+dev-habib-nuhu@users.noreply.github.com> Date: Wed, 8 Oct 2025 10:46:01 +0100 Subject: [PATCH 09/11] Update docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/examples.md Co-authored-by: sivanel97 --- .../sync-data-to-catalog/git/azure-devops/examples.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/examples.md b/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/examples.md index 640391d411..0001b821ae 100644 --- a/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/examples.md +++ b/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/examples.md @@ -193,7 +193,7 @@ You can use the following Port blueprint definitions and integration configurati - Refer to the [setup](azure-devops.md#setup) section to learn more about the integration configuration setup process. - We leverage [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/work/iterations/list?view=azure-devops-rest-7.1&tabs=HTTP#teamsettingsiteration) for the Azure DevOps iteration object structure. +- Click [here](https://learn.microsoft.com/en-us/rest/api/azure/devops/work/iterations/list?view=azure-devops-rest-7.1&tabs=HTTP#teamsettingsiteration) for the Azure DevOps iteration object structure. ::: From 4ff3d5518e8dd95724aafde2077710e7b7e40a40 Mon Sep 17 00:00:00 2001 From: Habib Nuhu Date: Wed, 8 Oct 2025 11:55:10 +0100 Subject: [PATCH 10/11] fix: closing yaml string --- .../sync-data-to-catalog/git/azure-devops/azure-devops.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/azure-devops.md b/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/azure-devops.md index 31f55071d5..9b3a5550fd 100644 --- a/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/azure-devops.md +++ b/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/azure-devops.md @@ -275,6 +275,7 @@ resources: finishTime: .finishTime relations: environment: .environment.id | tostring +```
From 7b442c0b02d9cda5e2443e57b3a236a212d242f6 Mon Sep 17 00:00:00 2001 From: sivanel97 Date: Wed, 8 Oct 2025 14:22:43 +0300 Subject: [PATCH 11/11] Apply suggestion from @sivanel97 --- .../sync-data-to-catalog/git/azure-devops/examples.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/examples.md b/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/examples.md index cfff74a57d..0657ad30fa 100644 --- a/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/examples.md +++ b/docs/build-your-software-catalog/sync-data-to-catalog/git/azure-devops/examples.md @@ -262,8 +262,7 @@ The following example demonstrates how to ingest Azure DevOps test runs to Port. -- Click [Here](https://learn.microsoft.com/en-us/rest/api/azure/devops/test/runs/list?view=azure-devops-rest-7.1&tabs=HTTP#testrun) for the Azure DevOps test-run object structure. -::: +Click [here](https://learn.microsoft.com/en-us/rest/api/azure/devops/test/runs/list?view=azure-devops-rest-7.1&tabs=HTTP#testrun) for the Azure DevOps test-run object structure. After creating the blueprints and saving the integration configuration, you will see new entities in Port matching your test runs.