From 1affa25295a3b904266c4e62c592276470497e84 Mon Sep 17 00:00:00 2001 From: shariff-6 Date: Fri, 3 Jan 2025 15:52:22 +0300 Subject: [PATCH 1/6] docs: add Jira Team integration examples and documentation Added documentation for Jira Teams integration including: - Team blueprint example - Integration configuration - API response example - Entity structure in Port --- .../_jira_exporter_example_team_blueprint.mdx | 43 +++++++++++++++++++ ...ra_exporter_example_team_configuration.mdx | 18 ++++++++ .../examples/_jira_team_example_entity.mdx | 21 +++++++++ .../examples/_jira_team_example_response.mdx | 16 +++++++ .../project-management/jira/jira.md | 36 +++++++++++++++- 5 files changed, 133 insertions(+), 1 deletion(-) create mode 100644 docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/examples/_jira_exporter_example_team_blueprint.mdx create mode 100644 docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/examples/_jira_exporter_example_team_configuration.mdx create mode 100644 docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/examples/_jira_team_example_entity.mdx create mode 100644 docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/examples/_jira_team_example_response.mdx diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/examples/_jira_exporter_example_team_blueprint.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/examples/_jira_exporter_example_team_blueprint.mdx new file mode 100644 index 000000000..a31e00335 --- /dev/null +++ b/docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/examples/_jira_exporter_example_team_blueprint.mdx @@ -0,0 +1,43 @@ +```json showLineNumbers +{ +"identifier": "jiraTeam", +"title": "Jira Team", +"icon": "Users", +"description": "A team within the organization", +"schema": { + "properties": { + "organizationId": { + "title": "Organization ID", + "type": "string", + "description": "Unique identifier for the parent organization" + }, + "teamType": { + "title": "Team Type", + "type": "string", + "description": "Type of team (e.g., MEMBER_INVITE, OPEN)", + "enum": [ + "MEMBER_INVITE", + "OPEN" + ] + }, + "description": { + "title": "Description", + "type": "string", + "description": "Team description" + } + } +}, +"relations": { + "members": { + "target": "jiraUser", + "title": "Users", + "description": "The Jira users belonging to this team", + "required": false, + "many": true + } +}, +"mirrorProperties": {}, +"calculationProperties": {}, +"aggregationProperties": {} +} +``` \ No newline at end of file diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/examples/_jira_exporter_example_team_configuration.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/examples/_jira_exporter_example_team_configuration.mdx new file mode 100644 index 000000000..2c641e210 --- /dev/null +++ b/docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/examples/_jira_exporter_example_team_configuration.mdx @@ -0,0 +1,18 @@ +```json showLineNumbers +- kind: team + selector: + query: "true" + includeMembers: true + port: + entity: + mappings: + identifier: .teamId + title: .displayName + blueprint: '"jiraTeam"' + properties: + organizationId: .organizationId + teamType: .teamType + description: .description + relations: + members: if .__members != null then .__members | map(.accountId) else [] end +``` \ No newline at end of file diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/examples/_jira_team_example_entity.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/examples/_jira_team_example_entity.mdx new file mode 100644 index 000000000..19251a634 --- /dev/null +++ b/docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/examples/_jira_team_example_entity.mdx @@ -0,0 +1,21 @@ +```json showLineNumbers +{ + "identifier": "T-PA", + "title": "Port-AI", + "icon": "Users", + "properties": { + "organizationId": "10000", + "teamType": "OPEN", + "description": "Port-AI" + }, + "relations": { + "members": [ + "U-PA", + "U-PA-2" + ] + }, + "mirrorProperties": {}, + "calculationProperties": {}, + "aggregationProperties": {} +} +``` \ No newline at end of file diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/examples/_jira_team_example_response.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/examples/_jira_team_example_response.mdx new file mode 100644 index 000000000..0cd6f8297 --- /dev/null +++ b/docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/examples/_jira_team_example_response.mdx @@ -0,0 +1,16 @@ +```json showLineNumbers +{ + "description": "Port-AI", + "displayName": "AI", + "organizationId": "10000", + "teamId": "T-PA", + "teamType": "OPEN" +}, +{ + "description": "Port-AI", + "displayName": "AI-2", + "organizationId": "10000", + "teamId": "T-PA-2", + "teamType": "OPEN" +} +``` \ No newline at end of file diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/jira.md b/docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/jira.md index 7e02e459a..9ff8e81d7 100644 --- a/docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/jira.md +++ b/docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/jira.md @@ -18,7 +18,10 @@ import JiraUserEntity from "/docs/build-your-software-catalog/sync-data-to-catal import JiraIssueEntity from "/docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/examples/_jira_issue_example_entity.mdx" import JiraIssueExampleBlueprint from "/docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/examples/_jira_example_issue_blueprint.mdx" import JiraIssueExampleConfiguration from "/docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/examples/\_jira_example_issue_configuration.mdx" - +import JiraTeamBlueprint from "/docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/examples/_jira_exporter_example_team_blueprint.mdx" +import JiraTeamConfiguration from "/docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/examples/\_jira_exporter_example_team_configuration.mdx" +import JiraTeamExampleResponse from "/docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/examples/_jira_team_example_response.mdx" +import JiraTeamEntity from "/docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/examples/_jira_team_example_entity.mdx" # Jira @@ -42,6 +45,7 @@ It is possible to reference any field that appears in the API responses linked b - [`Project`](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-projects/#api-rest-api-3-project-search-get) - [`User`](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-users/#api-group-users) +- [`Team`](https://developer.atlassian.com/platform/teams/rest/v1/api-group-teams-public-api/#api-group-teams-public-api) - [`Issue`](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-search/#api-rest-api-3-search-get) @@ -564,6 +568,22 @@ resources: +### Team + +
+Team blueprint + + + +
+ +
+Integration configuration + + + +
+ ### Issue
@@ -624,6 +644,13 @@ Here is an example of the payload structure from Jira:
+
+ Team response data + + + +
+
Issue response data @@ -843,6 +870,13 @@ The combination of the sample payload and the Ocean configuration generates the
+
+ Team entity in Port + + + +
+
Issue entity in Port From c1ca55dd2e037f0e6538df73a897d4090f55cbad Mon Sep 17 00:00:00 2001 From: shariff-6 Date: Fri, 17 Jan 2025 00:21:18 +0300 Subject: [PATCH 2/6] Adds atlassian organisation id --- .../jira/_jira_one_time_docker_parameters.mdx | 1 + .../sync-data-to-catalog/project-management/jira/jira.md | 2 ++ 2 files changed, 3 insertions(+) diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/_jira_one_time_docker_parameters.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/_jira_one_time_docker_parameters.mdx index 8c60fc905..ed0c2bea9 100644 --- a/docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/_jira_one_time_docker_parameters.mdx +++ b/docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/_jira_one_time_docker_parameters.mdx @@ -3,6 +3,7 @@ | `OCEAN__INTEGRATION__CONFIG__JIRA_HOST` | The URL of your Jira | https://example.atlassian.net | ✅ | | `OCEAN__INTEGRATION__CONFIG__ATLASSIAN_USER_EMAIL` | The email of the user used to query Jira | user@example.com | ✅ | | `OCEAN__INTEGRATION__CONFIG__ATLASSIAN_USER_TOKEN` | [Jira API token](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/) generated by the user | | ✅ | +| `OCEAN__INTEGRATION__CONFIG__ATLASSIAN_ORGANIZATION_ID` | To sync teams and team members your Atlassian Organization ID is required | [How to find your Atlassian Organization ID](https://confluence.atlassian.com/jirakb/what-it-is-the-organization-id-and-where-to-find-it-1207189876.html) | ✅ | | `OCEAN__PORT__CLIENT_ID` | Your Port client ([How to get the credentials](https://docs.port.io/build-your-software-catalog/custom-integration/api/#find-your-port-credentials)) id | | ✅ | | `OCEAN__PORT__CLIENT_SECRET` | Your Port client ([How to get the credentials](https://docs.port.io/build-your-software-catalog/custom-integration/api/#find-your-port-credentials)) secret | | ✅ | | `OCEAN__PORT__BASE_URL` | Your Port API URL - `https://api.getport.io` for EU, `https://api.us.getport.io` for US | | ✅ | diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/jira.md b/docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/jira.md index 3877cae73..f12d88f05 100644 --- a/docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/jira.md +++ b/docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/jira.md @@ -183,6 +183,7 @@ This table summarizes the available parameters for the installation. | `port.baseUrl` | Your Port API URL - `https://api.getport.io` for EU, `https://api.us.getport.io` for US | | ✅ | | `integration.secrets.atlassianUserEmail` | The email of the user used to query Jira | user@example.com | ✅ | | `integration.secrets.atlassianUserToken` | [Jira API token](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/) generated by the user | | ✅ | +| `integration.config.atlassianOrganizationId` | Your Atlassian Organization ID. Required for syncing teams | [How to find your Atlassian Organization ID](https://confluence.atlassian.com/jirakb/what-it-is-the-organization-id-and-where-to-find-it-1207189876.html) | ❌ | | `integration.config.jiraHost` | The URL of your Jira | https://example.atlassian.net | ✅ | | `integration.config.appHost` | The host of the Port Ocean app. Used to set up the integration endpoint as the target for webhooks created in Jira | https://my-ocean-integration.com | ✅ | | `integration.eventListener.type` | The event listener type. Read more about [event listeners](https://ocean.getport.io/framework/features/event-listener) | | ✅ | @@ -217,6 +218,7 @@ Make sure to configure the following [Github Secrets](https://docs.github.com/en | `config -> jira_host` | The URL of your Jira | https://example.atlassian.net | ✅ | | `config -> atlassian_user_email` | The email of the user used to query Jira | user@example.com | ✅ | | `config -> atlassian_user_token` | [Jira API token](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/) generated by the user | | ✅ | +| `config -> atlassian_organization_id` | To sync teams and team members your Atlassian Organization ID is required | [How to find your Atlassian Organization ID](https://confluence.atlassian.com/jirakb/what-it-is-the-organization-id-and-where-to-find-it-1207189876.html) | ❌ | | `initialize_port_resources` | Default true, When set to true the integration will create default blueprints and the port App config Mapping. Read more about [initializePortResources](https://ocean.getport.io/develop-an-integration/integration-configuration/#initializeportresources---initialize-port-resources) | | ❌ | | `send_raw_data_examples` | Enable sending raw data examples from the third party API to port for testing and managing the integration mapping. Default is true | | ❌ | | `identifier` | The identifier of the integration that will be installed | | ❌ | From 84ebc611604eb7f6255d4d1a92c75f80999b277e Mon Sep 17 00:00:00 2001 From: shariff-6 Date: Fri, 17 Jan 2025 00:23:42 +0300 Subject: [PATCH 3/6] PR fix --- .../project-management/jira/jira.md | 18 ++++++++++++++++-- 1 file changed, 16 insertions(+), 2 deletions(-) diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/jira.md b/docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/jira.md index f12d88f05..3d720ee91 100644 --- a/docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/jira.md +++ b/docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/jira.md @@ -1017,7 +1017,14 @@ Here is an example of the payload structure from Jira:
- Issue response data +Team response data (Click to expand) + + + +
+ +
+Issue response data (Click to expand) ```json showLineNumbers { @@ -1236,7 +1243,14 @@ The combination of the sample payload and the Ocean configuration generates the
- Issue entity in Port +Team entity in Port + + + +
+ +
+Issue entity in Port (Click to expand) From 4533d846b6be74846f7dd71ebca42f75d8faf387 Mon Sep 17 00:00:00 2001 From: shariff-6 Date: Fri, 17 Jan 2025 00:27:01 +0300 Subject: [PATCH 4/6] Improves description --- .../sync-data-to-catalog/project-management/jira/jira.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/jira.md b/docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/jira.md index 3d720ee91..548445542 100644 --- a/docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/jira.md +++ b/docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/jira.md @@ -183,7 +183,7 @@ This table summarizes the available parameters for the installation. | `port.baseUrl` | Your Port API URL - `https://api.getport.io` for EU, `https://api.us.getport.io` for US | | ✅ | | `integration.secrets.atlassianUserEmail` | The email of the user used to query Jira | user@example.com | ✅ | | `integration.secrets.atlassianUserToken` | [Jira API token](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/) generated by the user | | ✅ | -| `integration.config.atlassianOrganizationId` | Your Atlassian Organization ID. Required for syncing teams | [How to find your Atlassian Organization ID](https://confluence.atlassian.com/jirakb/what-it-is-the-organization-id-and-where-to-find-it-1207189876.html) | ❌ | +| `integration.config.atlassianOrganizationId` | To sync teams and team members your Atlassian Organization ID is required | [How to find your Atlassian Organization ID](https://confluence.atlassian.com/jirakb/what-it-is-the-organization-id-and-where-to-find-it-1207189876.html) | ❌ | | `integration.config.jiraHost` | The URL of your Jira | https://example.atlassian.net | ✅ | | `integration.config.appHost` | The host of the Port Ocean app. Used to set up the integration endpoint as the target for webhooks created in Jira | https://my-ocean-integration.com | ✅ | | `integration.eventListener.type` | The event listener type. Read more about [event listeners](https://ocean.getport.io/framework/features/event-listener) | | ✅ | From b9fa5ed17bd702cdb43b1cedea0f094f4a743f48 Mon Sep 17 00:00:00 2001 From: shariff-6 Date: Fri, 17 Jan 2025 14:36:02 +0300 Subject: [PATCH 5/6] Correct docs where param is not required --- .../jira/_jira_one_time_docker_parameters.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/_jira_one_time_docker_parameters.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/_jira_one_time_docker_parameters.mdx index ed0c2bea9..920c768ea 100644 --- a/docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/_jira_one_time_docker_parameters.mdx +++ b/docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/_jira_one_time_docker_parameters.mdx @@ -3,7 +3,7 @@ | `OCEAN__INTEGRATION__CONFIG__JIRA_HOST` | The URL of your Jira | https://example.atlassian.net | ✅ | | `OCEAN__INTEGRATION__CONFIG__ATLASSIAN_USER_EMAIL` | The email of the user used to query Jira | user@example.com | ✅ | | `OCEAN__INTEGRATION__CONFIG__ATLASSIAN_USER_TOKEN` | [Jira API token](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/) generated by the user | | ✅ | -| `OCEAN__INTEGRATION__CONFIG__ATLASSIAN_ORGANIZATION_ID` | To sync teams and team members your Atlassian Organization ID is required | [How to find your Atlassian Organization ID](https://confluence.atlassian.com/jirakb/what-it-is-the-organization-id-and-where-to-find-it-1207189876.html) | ✅ | +| `OCEAN__INTEGRATION__CONFIG__ATLASSIAN_ORGANIZATION_ID` | To sync teams and team members your Atlassian Organization ID is required | [How to find your Atlassian Organization ID](https://confluence.atlassian.com/jirakb/what-it-is-the-organization-id-and-where-to-find-it-1207189876.html) | ❌ | | `OCEAN__PORT__CLIENT_ID` | Your Port client ([How to get the credentials](https://docs.port.io/build-your-software-catalog/custom-integration/api/#find-your-port-credentials)) id | | ✅ | | `OCEAN__PORT__CLIENT_SECRET` | Your Port client ([How to get the credentials](https://docs.port.io/build-your-software-catalog/custom-integration/api/#find-your-port-credentials)) secret | | ✅ | | `OCEAN__PORT__BASE_URL` | Your Port API URL - `https://api.getport.io` for EU, `https://api.us.getport.io` for US | | ✅ | From c78ce51fb546bd939b446ba638d2ac1645498e01 Mon Sep 17 00:00:00 2001 From: shariff-6 Date: Fri, 17 Jan 2025 19:57:14 +0300 Subject: [PATCH 6/6] Improves description --- .../jira/_jira_one_time_docker_parameters.mdx | 2 +- .../sync-data-to-catalog/project-management/jira/jira.md | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/_jira_one_time_docker_parameters.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/_jira_one_time_docker_parameters.mdx index 920c768ea..043dba97d 100644 --- a/docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/_jira_one_time_docker_parameters.mdx +++ b/docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/_jira_one_time_docker_parameters.mdx @@ -3,7 +3,7 @@ | `OCEAN__INTEGRATION__CONFIG__JIRA_HOST` | The URL of your Jira | https://example.atlassian.net | ✅ | | `OCEAN__INTEGRATION__CONFIG__ATLASSIAN_USER_EMAIL` | The email of the user used to query Jira | user@example.com | ✅ | | `OCEAN__INTEGRATION__CONFIG__ATLASSIAN_USER_TOKEN` | [Jira API token](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/) generated by the user | | ✅ | -| `OCEAN__INTEGRATION__CONFIG__ATLASSIAN_ORGANIZATION_ID` | To sync teams and team members your Atlassian Organization ID is required | [How to find your Atlassian Organization ID](https://confluence.atlassian.com/jirakb/what-it-is-the-organization-id-and-where-to-find-it-1207189876.html) | ❌ | +| `OCEAN__INTEGRATION__CONFIG__ATLASSIAN_ORGANIZATION_ID` | Your Atlassian Organization ID is required to sync teams and team members. [Follow the Atlassian documentation](https://confluence.atlassian.com/jirakb/what-it-is-the-organization-id-and-where-to-find-it-1207189876.html) on how to find your Organization ID | | ❌ | | `OCEAN__PORT__CLIENT_ID` | Your Port client ([How to get the credentials](https://docs.port.io/build-your-software-catalog/custom-integration/api/#find-your-port-credentials)) id | | ✅ | | `OCEAN__PORT__CLIENT_SECRET` | Your Port client ([How to get the credentials](https://docs.port.io/build-your-software-catalog/custom-integration/api/#find-your-port-credentials)) secret | | ✅ | | `OCEAN__PORT__BASE_URL` | Your Port API URL - `https://api.getport.io` for EU, `https://api.us.getport.io` for US | | ✅ | diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/jira.md b/docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/jira.md index 548445542..4ec0e38a0 100644 --- a/docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/jira.md +++ b/docs/build-your-software-catalog/sync-data-to-catalog/project-management/jira/jira.md @@ -183,7 +183,7 @@ This table summarizes the available parameters for the installation. | `port.baseUrl` | Your Port API URL - `https://api.getport.io` for EU, `https://api.us.getport.io` for US | | ✅ | | `integration.secrets.atlassianUserEmail` | The email of the user used to query Jira | user@example.com | ✅ | | `integration.secrets.atlassianUserToken` | [Jira API token](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/) generated by the user | | ✅ | -| `integration.config.atlassianOrganizationId` | To sync teams and team members your Atlassian Organization ID is required | [How to find your Atlassian Organization ID](https://confluence.atlassian.com/jirakb/what-it-is-the-organization-id-and-where-to-find-it-1207189876.html) | ❌ | +| `integration.config.atlassianOrganizationId` | Your Atlassian Organization ID is required to sync teams and team members. [Follow the Atlassian documentation](https://confluence.atlassian.com/jirakb/what-it-is-the-organization-id-and-where-to-find-it-1207189876.html) on how to find your Organization ID | | ❌ | | `integration.config.jiraHost` | The URL of your Jira | https://example.atlassian.net | ✅ | | `integration.config.appHost` | The host of the Port Ocean app. Used to set up the integration endpoint as the target for webhooks created in Jira | https://my-ocean-integration.com | ✅ | | `integration.eventListener.type` | The event listener type. Read more about [event listeners](https://ocean.getport.io/framework/features/event-listener) | | ✅ | @@ -218,7 +218,7 @@ Make sure to configure the following [Github Secrets](https://docs.github.com/en | `config -> jira_host` | The URL of your Jira | https://example.atlassian.net | ✅ | | `config -> atlassian_user_email` | The email of the user used to query Jira | user@example.com | ✅ | | `config -> atlassian_user_token` | [Jira API token](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/) generated by the user | | ✅ | -| `config -> atlassian_organization_id` | To sync teams and team members your Atlassian Organization ID is required | [How to find your Atlassian Organization ID](https://confluence.atlassian.com/jirakb/what-it-is-the-organization-id-and-where-to-find-it-1207189876.html) | ❌ | +| `config -> atlassian_organization_id` |Your Atlassian Organization ID is required to sync teams and team members. [Follow the Atlassian documentation](https://confluence.atlassian.com/jirakb/what-it-is-the-organization-id-and-where-to-find-it-1207189876.html) on how to find your Organization ID | | ❌ | | `initialize_port_resources` | Default true, When set to true the integration will create default blueprints and the port App config Mapping. Read more about [initializePortResources](https://ocean.getport.io/develop-an-integration/integration-configuration/#initializeportresources---initialize-port-resources) | | ❌ | | `send_raw_data_examples` | Enable sending raw data examples from the third party API to port for testing and managing the integration mapping. Default is true | | ❌ | | `identifier` | The identifier of the integration that will be installed | | ❌ |