🌊 Ocean 🌊 is an innovative solution developed by Port to seamlessly integrate various third-party systems with our developer portal product, empowering engineers to effortlessly prioritize key features and streamline the integration process.
What -
This PR addresses a few bugs and improvements in the Azure DevOps (ADO) integration related to the default mappings for service and work-item entities, handling of project data, and logging enhancements.
Why -
The original default mapping for services caused errors when repository names contained special characters like parentheses. The error prevented the repositories from being imported into Port.
The work-item mapping had an issue where the relation to the project was incorrectly based on System.TeamProject, which referenced the project name instead of the internal project identifier
It was necessary to update the mapping so that full project data, not just the project ID, is passed to the work-item entities
Additionally, to aid in debugging and monitoring, general logs should be displayed when the integration is querying the work items.
How -
The mapping for services was updated to removing additional special characters that could cause the repository name to fail.
The work-item mapping was updated to reference the __projectId, extracting the correct internal project identifier, ensuring accurate associations in Port.
The integration was improved to pass full project data to work-item entities instead of just the project ID
Added general logging to the integration to display information when querying work items, which will help in tracking the integration's activity and diagnosing issues.
Type of change
Please leave one option from the following and delete the rest:
[x] Bug fix (non-breaking change which fixes an issue)
All tests should be run against the port production environment(using a testing org).
Core testing checklist
[ ] Integration able to create all default resources from scratch
[ ] Resync finishes successfully
[ ] Resync able to create entities
[ ] Resync able to update entities
[ ] Resync able to detect and delete entities
[ ] Scheduled resync able to abort existing resync and start a new one
[ ] Tested with at least 2 integrations from scratch
[ ] Tested with Kafka and Polling event listeners
[ ] Tested deletion of entities that don't pass the selector
Integration testing checklist
[x] Integration able to create all default resources from scratch
[x] Resync able to create entities
[x] Resync able to update entities
[x] Resync able to detect and delete entities
[x] Resync finishes successfully
[ ] If new resource kind is added or updated in the integration, add example raw data, mapping and expected result to the examples folder in the integration directory.
[ ] If resource kind is updated, run the integration with the example data and check if the expected result is achieved
[ ] If new resource kind is added or updated, validate that live-events for that resource are working as expected
Description
What - This PR addresses a few bugs and improvements in the Azure DevOps (ADO) integration related to the default mappings for service and work-item entities, handling of project data, and logging enhancements.
Why -
System.TeamProject, which referenced the project name instead of the internal project identifierAdditionally, to aid in debugging and monitoring, general logs should be displayed when the integration is querying the work items.
How -
__projectId, extracting the correct internal project identifier, ensuring accurate associations in Port.Type of change
Please leave one option from the following and delete the rest:
All tests should be run against the port production environment(using a testing org).
Core testing checklist
Integration testing checklist
examplesfolder in the integration directory.Preflight checklist
Screenshots
Include screenshots from your environment showing how the resources of the integration will look.
API Documentation
Provide links to the API documentation used for this integration.