From 3298cdc1df8db418a69f12510039df45c59b6d27 Mon Sep 17 00:00:00 2001 From: Ayush Shah Date: Tue, 17 Sep 2024 08:37:26 +0530 Subject: [PATCH 1/4] fix: Add validations in place --- .../source/database/salesforce/connection.py | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) diff --git a/ingestion/src/metadata/ingestion/source/database/salesforce/connection.py b/ingestion/src/metadata/ingestion/source/database/salesforce/connection.py index 9ead18111c42..40ec09b144e8 100644 --- a/ingestion/src/metadata/ingestion/source/database/salesforce/connection.py +++ b/ingestion/src/metadata/ingestion/source/database/salesforce/connection.py @@ -15,7 +15,6 @@ from typing import Optional from simple_salesforce.api import Salesforce -from sqlalchemy.engine import Engine from metadata.generated.schema.entity.automations.workflow import ( Workflow as AutomationWorkflow, @@ -27,14 +26,18 @@ from metadata.ingestion.ometa.ometa_api import OpenMetadata -def get_connection(connection: SalesforceConnection) -> Engine: +def get_connection(connection: SalesforceConnection): """ Create connection """ return Salesforce( username=connection.username, - password=connection.password.get_secret_value(), - security_token=connection.securityToken.get_secret_value(), + password=connection.password.get_secret_value() + if connection.password + else None, + security_token=connection.securityToken.get_secret_value() + if connection.securityToken + else None, domain=connection.salesforceDomain, version=connection.salesforceApiVersion, **connection.connectionArguments.root if connection.connectionArguments else {}, From dc655b1a6db2a091a7a6b275b9c288d169ede3e0 Mon Sep 17 00:00:00 2001 From: harshsoni2024 Date: Thu, 19 Sep 2024 13:24:44 +0530 Subject: [PATCH 2/4] add organization id in salesforce connection --- ingestion/src/metadata/examples/workflows/salesforce.yaml | 1 + .../ingestion/source/database/salesforce/connection.py | 7 +++---- .../connections/database/salesforceConnection.json | 5 +++++ 3 files changed, 9 insertions(+), 4 deletions(-) diff --git a/ingestion/src/metadata/examples/workflows/salesforce.yaml b/ingestion/src/metadata/examples/workflows/salesforce.yaml index 6822679d7976..290e208d22fe 100644 --- a/ingestion/src/metadata/examples/workflows/salesforce.yaml +++ b/ingestion/src/metadata/examples/workflows/salesforce.yaml @@ -7,6 +7,7 @@ source: username: username password: password securityToken: securityToken + organizationId: organizationId sobjectName: sobjectName # sslConfig: # caCertificate: | diff --git a/ingestion/src/metadata/ingestion/source/database/salesforce/connection.py b/ingestion/src/metadata/ingestion/source/database/salesforce/connection.py index 40ec09b144e8..1f3c80e829a1 100644 --- a/ingestion/src/metadata/ingestion/source/database/salesforce/connection.py +++ b/ingestion/src/metadata/ingestion/source/database/salesforce/connection.py @@ -32,12 +32,11 @@ def get_connection(connection: SalesforceConnection): """ return Salesforce( username=connection.username, - password=connection.password.get_secret_value() - if connection.password - else None, + password=connection.password.get_secret_value(), security_token=connection.securityToken.get_secret_value() if connection.securityToken - else None, + else "", + organizationId=connection.organizationId if connection.organizationId else "", domain=connection.salesforceDomain, version=connection.salesforceApiVersion, **connection.connectionArguments.root if connection.connectionArguments else {}, diff --git a/openmetadata-spec/src/main/resources/json/schema/entity/services/connections/database/salesforceConnection.json b/openmetadata-spec/src/main/resources/json/schema/entity/services/connections/database/salesforceConnection.json index 10ccc6c7af96..a6d119e899f1 100644 --- a/openmetadata-spec/src/main/resources/json/schema/entity/services/connections/database/salesforceConnection.json +++ b/openmetadata-spec/src/main/resources/json/schema/entity/services/connections/database/salesforceConnection.json @@ -37,6 +37,11 @@ "type": "string", "format": "password" }, + "organizationId": { + "title": "Salesforce Organization ID", + "description": "Salesforce Organization ID is the unique identifier for your Salesforce identity", + "type": "string" + }, "sobjectName": { "title": "Object Name", "description": "Salesforce Object Name.", From 4081c69d0f0346e226994de8f3fb264c2bf0760f Mon Sep 17 00:00:00 2001 From: harshsoni2024 Date: Thu, 19 Sep 2024 14:32:47 +0530 Subject: [PATCH 3/4] add org_id in docs --- .../source/database/salesforce/connection.py | 2 +- .../connectors/database/salesforce/index.md | 1 + .../connectors/database/salesforce/yaml.md | 25 +++++++++++++------ .../database/salesforceConnection.md | 1 + .../connectors/database/salesforce/index.md | 1 + .../connectors/database/salesforce/yaml.md | 25 +++++++++++++------ .../database/salesforceConnection.md | 1 + .../locales/en-US/Database/Salesforce.md | 6 +++++ 8 files changed, 45 insertions(+), 17 deletions(-) diff --git a/ingestion/src/metadata/ingestion/source/database/salesforce/connection.py b/ingestion/src/metadata/ingestion/source/database/salesforce/connection.py index 1f3c80e829a1..9cfd79e08846 100644 --- a/ingestion/src/metadata/ingestion/source/database/salesforce/connection.py +++ b/ingestion/src/metadata/ingestion/source/database/salesforce/connection.py @@ -26,7 +26,7 @@ from metadata.ingestion.ometa.ometa_api import OpenMetadata -def get_connection(connection: SalesforceConnection): +def get_connection(connection: SalesforceConnection) -> Salesforce: """ Create connection """ diff --git a/openmetadata-docs/content/v1.5.x/connectors/database/salesforce/index.md b/openmetadata-docs/content/v1.5.x/connectors/database/salesforce/index.md index cf92b0c9c6dd..f91b595a52df 100644 --- a/openmetadata-docs/content/v1.5.x/connectors/database/salesforce/index.md +++ b/openmetadata-docs/content/v1.5.x/connectors/database/salesforce/index.md @@ -49,6 +49,7 @@ These are the permissions you will require to fetch the metadata from Salesforce - **Username**: Username to connect to the Salesforce. This user should have the access as defined in requirements. - **Password**: Password to connect to Salesforce. - **Security Token**: Salesforce Security Token is required to access the metadata through APIs. You can checkout [this doc](https://help.salesforce.com/s/articleView?id=sf.user_security_token.htm&type=5) on how to get the security token. +- **Organization ID**: Salesforce Organization ID is the unique identifier for your Salesforce identity. You can check out [this doc](https://help.salesforce.com/s/articleView?id=000385215&type=1) on how to get the your Salesforce Organization ID. - **Salesforce Object Name**: Specify the Salesforce Object Name in case you want to ingest a specific object. If left blank, we will ingest all the Objects. - **Salesforce API Version**: Follow the steps mentioned [here](https://help.salesforce.com/s/articleView?id=000386929&type=1) to get the API version. Enter the numerical value in the field, For example `42.0`. - **Salesforce Domain**: When connecting to Salesforce, you can specify the domain to use for accessing the platform. The common domains include `login` and `test`, and you can also utilize Salesforce My Domain. diff --git a/openmetadata-docs/content/v1.5.x/connectors/database/salesforce/yaml.md b/openmetadata-docs/content/v1.5.x/connectors/database/salesforce/yaml.md index c2d92e08a275..7f354fc11679 100644 --- a/openmetadata-docs/content/v1.5.x/connectors/database/salesforce/yaml.md +++ b/openmetadata-docs/content/v1.5.x/connectors/database/salesforce/yaml.md @@ -83,18 +83,24 @@ This is a sample config for Salesforce: {% codeInfo srNumber=5 %} -**sobjectName**: Specify the Salesforce Object Name in case you want to ingest a specific object. If left blank, we will ingest all the Objects. +**Organization ID**: Salesforce Organization ID is the unique identifier for your Salesforce identity. You can check out [this doc](https://help.salesforce.com/s/articleView?id=000385215&type=1) on how to get the your Salesforce Organization ID. {% /codeInfo %} {% codeInfo srNumber=6 %} -**salesforceApiVersion**: Follow the steps mentioned [here](https://help.salesforce.com/s/articleView?id=000386929&type=1) to get the API version. Enter the numerical value in the field, For example `42.0`. +**sobjectName**: Specify the Salesforce Object Name in case you want to ingest a specific object. If left blank, we will ingest all the Objects. {% /codeInfo %} {% codeInfo srNumber=7 %} +**salesforceApiVersion**: Follow the steps mentioned [here](https://help.salesforce.com/s/articleView?id=000386929&type=1) to get the API version. Enter the numerical value in the field, For example `42.0`. + +{% /codeInfo %} + +{% codeInfo srNumber=8 %} + **salesforceDomain**: When connecting to Salesforce, you can specify the domain to use for accessing the platform. The common domains include `login` and `test`, and you can also utilize Salesforce My Domain. By default, the domain `login` is used for accessing Salesforce. @@ -108,13 +114,13 @@ By default, the domain `login` is used for accessing Salesforce. #### Advanced Configuration -{% codeInfo srNumber=8 %} +{% codeInfo srNumber=9 %} **Connection Options (Optional)**: Enter the details for any additional connection options that can be sent to database during the connection. These details must be added as Key-Value pairs. {% /codeInfo %} -{% codeInfo srNumber=9 %} +{% codeInfo srNumber=10 %} **Connection Arguments (Optional)**: Enter the details for any additional connection arguments such as security or protocol configs that can be sent to database during the connection. These details must be added as Key-Value pairs. @@ -144,19 +150,22 @@ source: securityToken: securityToken ``` ```yaml {% srNumber=5 %} - sobjectName: sobjectName + organizationId: organizationId ``` ```yaml {% srNumber=6 %} - salesforceApiVersion: 42.0 + sobjectName: sobjectName ``` ```yaml {% srNumber=7 %} - salesforceDomain: login + salesforceApiVersion: 42.0 ``` ```yaml {% srNumber=8 %} + salesforceDomain: login +``` +```yaml {% srNumber=9 %} # connectionOptions: # key: value ``` -```yaml {% srNumber=9 %} +```yaml {% srNumber=10 %} # connectionArguments: # key: value ``` diff --git a/openmetadata-docs/content/v1.5.x/main-concepts/metadata-standard/schemas/entity/services/connections/database/salesforceConnection.md b/openmetadata-docs/content/v1.5.x/main-concepts/metadata-standard/schemas/entity/services/connections/database/salesforceConnection.md index 804ee1574e1d..af567c1efc6a 100644 --- a/openmetadata-docs/content/v1.5.x/main-concepts/metadata-standard/schemas/entity/services/connections/database/salesforceConnection.md +++ b/openmetadata-docs/content/v1.5.x/main-concepts/metadata-standard/schemas/entity/services/connections/database/salesforceConnection.md @@ -13,6 +13,7 @@ slug: /main-concepts/metadata-standard/schemas/entity/services/connections/datab - **`username`** *(string)*: Username to connect to the Salesforce. This user should have privileges to read all the metadata in Redshift. - **`password`** *(string)*: Password to connect to the Salesforce. - **`securityToken`** *(string)*: Salesforce Security Token. +- **`organizationId`** *(string)*: Salesforce Organization ID. - **`sobjectName`** *(string)*: Salesforce Object Name. - **`databaseName`** *(string)*: Optional name to give to the database in OpenMetadata. If left blank, we will use default as the database name. - **`salesforceApiVersion`** *(string)*: API version of the Salesforce instance. Default: `42.0`. diff --git a/openmetadata-docs/content/v1.6.x-SNAPSHOT/connectors/database/salesforce/index.md b/openmetadata-docs/content/v1.6.x-SNAPSHOT/connectors/database/salesforce/index.md index cf92b0c9c6dd..f91b595a52df 100644 --- a/openmetadata-docs/content/v1.6.x-SNAPSHOT/connectors/database/salesforce/index.md +++ b/openmetadata-docs/content/v1.6.x-SNAPSHOT/connectors/database/salesforce/index.md @@ -49,6 +49,7 @@ These are the permissions you will require to fetch the metadata from Salesforce - **Username**: Username to connect to the Salesforce. This user should have the access as defined in requirements. - **Password**: Password to connect to Salesforce. - **Security Token**: Salesforce Security Token is required to access the metadata through APIs. You can checkout [this doc](https://help.salesforce.com/s/articleView?id=sf.user_security_token.htm&type=5) on how to get the security token. +- **Organization ID**: Salesforce Organization ID is the unique identifier for your Salesforce identity. You can check out [this doc](https://help.salesforce.com/s/articleView?id=000385215&type=1) on how to get the your Salesforce Organization ID. - **Salesforce Object Name**: Specify the Salesforce Object Name in case you want to ingest a specific object. If left blank, we will ingest all the Objects. - **Salesforce API Version**: Follow the steps mentioned [here](https://help.salesforce.com/s/articleView?id=000386929&type=1) to get the API version. Enter the numerical value in the field, For example `42.0`. - **Salesforce Domain**: When connecting to Salesforce, you can specify the domain to use for accessing the platform. The common domains include `login` and `test`, and you can also utilize Salesforce My Domain. diff --git a/openmetadata-docs/content/v1.6.x-SNAPSHOT/connectors/database/salesforce/yaml.md b/openmetadata-docs/content/v1.6.x-SNAPSHOT/connectors/database/salesforce/yaml.md index c2d92e08a275..7f354fc11679 100644 --- a/openmetadata-docs/content/v1.6.x-SNAPSHOT/connectors/database/salesforce/yaml.md +++ b/openmetadata-docs/content/v1.6.x-SNAPSHOT/connectors/database/salesforce/yaml.md @@ -83,18 +83,24 @@ This is a sample config for Salesforce: {% codeInfo srNumber=5 %} -**sobjectName**: Specify the Salesforce Object Name in case you want to ingest a specific object. If left blank, we will ingest all the Objects. +**Organization ID**: Salesforce Organization ID is the unique identifier for your Salesforce identity. You can check out [this doc](https://help.salesforce.com/s/articleView?id=000385215&type=1) on how to get the your Salesforce Organization ID. {% /codeInfo %} {% codeInfo srNumber=6 %} -**salesforceApiVersion**: Follow the steps mentioned [here](https://help.salesforce.com/s/articleView?id=000386929&type=1) to get the API version. Enter the numerical value in the field, For example `42.0`. +**sobjectName**: Specify the Salesforce Object Name in case you want to ingest a specific object. If left blank, we will ingest all the Objects. {% /codeInfo %} {% codeInfo srNumber=7 %} +**salesforceApiVersion**: Follow the steps mentioned [here](https://help.salesforce.com/s/articleView?id=000386929&type=1) to get the API version. Enter the numerical value in the field, For example `42.0`. + +{% /codeInfo %} + +{% codeInfo srNumber=8 %} + **salesforceDomain**: When connecting to Salesforce, you can specify the domain to use for accessing the platform. The common domains include `login` and `test`, and you can also utilize Salesforce My Domain. By default, the domain `login` is used for accessing Salesforce. @@ -108,13 +114,13 @@ By default, the domain `login` is used for accessing Salesforce. #### Advanced Configuration -{% codeInfo srNumber=8 %} +{% codeInfo srNumber=9 %} **Connection Options (Optional)**: Enter the details for any additional connection options that can be sent to database during the connection. These details must be added as Key-Value pairs. {% /codeInfo %} -{% codeInfo srNumber=9 %} +{% codeInfo srNumber=10 %} **Connection Arguments (Optional)**: Enter the details for any additional connection arguments such as security or protocol configs that can be sent to database during the connection. These details must be added as Key-Value pairs. @@ -144,19 +150,22 @@ source: securityToken: securityToken ``` ```yaml {% srNumber=5 %} - sobjectName: sobjectName + organizationId: organizationId ``` ```yaml {% srNumber=6 %} - salesforceApiVersion: 42.0 + sobjectName: sobjectName ``` ```yaml {% srNumber=7 %} - salesforceDomain: login + salesforceApiVersion: 42.0 ``` ```yaml {% srNumber=8 %} + salesforceDomain: login +``` +```yaml {% srNumber=9 %} # connectionOptions: # key: value ``` -```yaml {% srNumber=9 %} +```yaml {% srNumber=10 %} # connectionArguments: # key: value ``` diff --git a/openmetadata-docs/content/v1.6.x-SNAPSHOT/main-concepts/metadata-standard/schemas/entity/services/connections/database/salesforceConnection.md b/openmetadata-docs/content/v1.6.x-SNAPSHOT/main-concepts/metadata-standard/schemas/entity/services/connections/database/salesforceConnection.md index 804ee1574e1d..af567c1efc6a 100644 --- a/openmetadata-docs/content/v1.6.x-SNAPSHOT/main-concepts/metadata-standard/schemas/entity/services/connections/database/salesforceConnection.md +++ b/openmetadata-docs/content/v1.6.x-SNAPSHOT/main-concepts/metadata-standard/schemas/entity/services/connections/database/salesforceConnection.md @@ -13,6 +13,7 @@ slug: /main-concepts/metadata-standard/schemas/entity/services/connections/datab - **`username`** *(string)*: Username to connect to the Salesforce. This user should have privileges to read all the metadata in Redshift. - **`password`** *(string)*: Password to connect to the Salesforce. - **`securityToken`** *(string)*: Salesforce Security Token. +- **`organizationId`** *(string)*: Salesforce Organization ID. - **`sobjectName`** *(string)*: Salesforce Object Name. - **`databaseName`** *(string)*: Optional name to give to the database in OpenMetadata. If left blank, we will use default as the database name. - **`salesforceApiVersion`** *(string)*: API version of the Salesforce instance. Default: `42.0`. diff --git a/openmetadata-ui/src/main/resources/ui/public/locales/en-US/Database/Salesforce.md b/openmetadata-ui/src/main/resources/ui/public/locales/en-US/Database/Salesforce.md index 85285ff207c1..b84aa44f9743 100644 --- a/openmetadata-ui/src/main/resources/ui/public/locales/en-US/Database/Salesforce.md +++ b/openmetadata-ui/src/main/resources/ui/public/locales/en-US/Database/Salesforce.md @@ -32,6 +32,12 @@ $$section Salesforce Security Token is required to access the metadata through APIs. You can check out [this doc](https://help.salesforce.com/s/articleView?id=sf.user_security_token.htm&type=5) on how to get the security token. $$ +$$section +### Organization ID $(id="organizationId") + +Salesforce Organization ID is the unique identifier for your Salesforce identity. You can check out [this doc](https://help.salesforce.com/s/articleView?id=000385215&type=1) on how to get the your Salesforce Organization ID. +$$ + $$section ### Object Name $(id="sobjectName") From 929925763ac532ceb4e9e593da3455e305718646 Mon Sep 17 00:00:00 2001 From: harshsoni2024 Date: Fri, 20 Sep 2024 11:40:42 +0530 Subject: [PATCH 4/4] add detailed doc on org id --- .../content/v1.5.x/connectors/database/salesforce/index.md | 6 ++++++ .../content/v1.5.x/connectors/database/salesforce/yaml.md | 6 ++++++ .../connectors/database/salesforce/index.md | 6 ++++++ .../v1.6.x-SNAPSHOT/connectors/database/salesforce/yaml.md | 7 ++++++- .../ui/public/locales/en-US/Database/Salesforce.md | 4 ++++ 5 files changed, 28 insertions(+), 1 deletion(-) diff --git a/openmetadata-docs/content/v1.5.x/connectors/database/salesforce/index.md b/openmetadata-docs/content/v1.5.x/connectors/database/salesforce/index.md index f91b595a52df..1a607cb70598 100644 --- a/openmetadata-docs/content/v1.5.x/connectors/database/salesforce/index.md +++ b/openmetadata-docs/content/v1.5.x/connectors/database/salesforce/index.md @@ -50,6 +50,12 @@ These are the permissions you will require to fetch the metadata from Salesforce - **Password**: Password to connect to Salesforce. - **Security Token**: Salesforce Security Token is required to access the metadata through APIs. You can checkout [this doc](https://help.salesforce.com/s/articleView?id=sf.user_security_token.htm&type=5) on how to get the security token. - **Organization ID**: Salesforce Organization ID is the unique identifier for your Salesforce identity. You can check out [this doc](https://help.salesforce.com/s/articleView?id=000385215&type=1) on how to get the your Salesforce Organization ID. + {% note %} + **Note**: You need to provide `15` digit organization id in this section. for e.g. `00DIB000004nDEq`, which you can find by following the steps mentioned in above doc (`Salesforce dashboard->Setup->Company Profile->Company Information->Salesforce.com Organization Id`). + {% /note %} + {% note %} + **Note**: If you want to access salesforce metadata without token(only by using organization id), you will need to setup your ip in trusted ip ranges. You can go (`Salesforce dashboard->Setup->Security->Network Access->Trusted IP Ranges`) to configure this. You can check [here](https://help.salesforce.com/s/articleView?id=sf.security_networkaccess.htm&type=5) to configure your ip in trusted ip ranges. + {% /note %} - **Salesforce Object Name**: Specify the Salesforce Object Name in case you want to ingest a specific object. If left blank, we will ingest all the Objects. - **Salesforce API Version**: Follow the steps mentioned [here](https://help.salesforce.com/s/articleView?id=000386929&type=1) to get the API version. Enter the numerical value in the field, For example `42.0`. - **Salesforce Domain**: When connecting to Salesforce, you can specify the domain to use for accessing the platform. The common domains include `login` and `test`, and you can also utilize Salesforce My Domain. diff --git a/openmetadata-docs/content/v1.5.x/connectors/database/salesforce/yaml.md b/openmetadata-docs/content/v1.5.x/connectors/database/salesforce/yaml.md index 7f354fc11679..c4573a311ad5 100644 --- a/openmetadata-docs/content/v1.5.x/connectors/database/salesforce/yaml.md +++ b/openmetadata-docs/content/v1.5.x/connectors/database/salesforce/yaml.md @@ -84,6 +84,12 @@ This is a sample config for Salesforce: {% codeInfo srNumber=5 %} **Organization ID**: Salesforce Organization ID is the unique identifier for your Salesforce identity. You can check out [this doc](https://help.salesforce.com/s/articleView?id=000385215&type=1) on how to get the your Salesforce Organization ID. +{% note %} +**Note**: You need to provide `15` digit organization id in this section. for e.g. `00DIB000004nDEq`, which you can find by following the steps mentioned in above doc (`Salesforce dashboard->Setup->Company Profile->Company Information->Salesforce.com Organization Id`). +{% /note %} +{% note %} +**Note**: If you want to access salesforce metadata without token(only by using organization id), you will need to setup your ip in trusted ip ranges. You can go (`Salesforce dashboard->Setup->Security->Network Access->Trusted IP Ranges`) to configure this. You can check [here](https://help.salesforce.com/s/articleView?id=sf.security_networkaccess.htm&type=5) to configure your ip in trusted ip ranges. +{% /note %} {% /codeInfo %} diff --git a/openmetadata-docs/content/v1.6.x-SNAPSHOT/connectors/database/salesforce/index.md b/openmetadata-docs/content/v1.6.x-SNAPSHOT/connectors/database/salesforce/index.md index f91b595a52df..1a607cb70598 100644 --- a/openmetadata-docs/content/v1.6.x-SNAPSHOT/connectors/database/salesforce/index.md +++ b/openmetadata-docs/content/v1.6.x-SNAPSHOT/connectors/database/salesforce/index.md @@ -50,6 +50,12 @@ These are the permissions you will require to fetch the metadata from Salesforce - **Password**: Password to connect to Salesforce. - **Security Token**: Salesforce Security Token is required to access the metadata through APIs. You can checkout [this doc](https://help.salesforce.com/s/articleView?id=sf.user_security_token.htm&type=5) on how to get the security token. - **Organization ID**: Salesforce Organization ID is the unique identifier for your Salesforce identity. You can check out [this doc](https://help.salesforce.com/s/articleView?id=000385215&type=1) on how to get the your Salesforce Organization ID. + {% note %} + **Note**: You need to provide `15` digit organization id in this section. for e.g. `00DIB000004nDEq`, which you can find by following the steps mentioned in above doc (`Salesforce dashboard->Setup->Company Profile->Company Information->Salesforce.com Organization Id`). + {% /note %} + {% note %} + **Note**: If you want to access salesforce metadata without token(only by using organization id), you will need to setup your ip in trusted ip ranges. You can go (`Salesforce dashboard->Setup->Security->Network Access->Trusted IP Ranges`) to configure this. You can check [here](https://help.salesforce.com/s/articleView?id=sf.security_networkaccess.htm&type=5) to configure your ip in trusted ip ranges. + {% /note %} - **Salesforce Object Name**: Specify the Salesforce Object Name in case you want to ingest a specific object. If left blank, we will ingest all the Objects. - **Salesforce API Version**: Follow the steps mentioned [here](https://help.salesforce.com/s/articleView?id=000386929&type=1) to get the API version. Enter the numerical value in the field, For example `42.0`. - **Salesforce Domain**: When connecting to Salesforce, you can specify the domain to use for accessing the platform. The common domains include `login` and `test`, and you can also utilize Salesforce My Domain. diff --git a/openmetadata-docs/content/v1.6.x-SNAPSHOT/connectors/database/salesforce/yaml.md b/openmetadata-docs/content/v1.6.x-SNAPSHOT/connectors/database/salesforce/yaml.md index 7f354fc11679..a1d28389c732 100644 --- a/openmetadata-docs/content/v1.6.x-SNAPSHOT/connectors/database/salesforce/yaml.md +++ b/openmetadata-docs/content/v1.6.x-SNAPSHOT/connectors/database/salesforce/yaml.md @@ -84,7 +84,12 @@ This is a sample config for Salesforce: {% codeInfo srNumber=5 %} **Organization ID**: Salesforce Organization ID is the unique identifier for your Salesforce identity. You can check out [this doc](https://help.salesforce.com/s/articleView?id=000385215&type=1) on how to get the your Salesforce Organization ID. - +{% note %} +**Note**: You need to provide `15` digit organization id in this section. for e.g. `00DIB000004nDEq`, which you can find by following the steps mentioned in above doc (`Salesforce dashboard->Setup->Company Profile->Company Information->Salesforce.com Organization Id`). +{% /note %} +{% note %} +**Note**: If you want to access salesforce metadata without token(only by using organization id), you will need to setup your ip in trusted ip ranges. You can go (`Salesforce dashboard->Setup->Security->Network Access->Trusted IP Ranges`) to configure this. You can check [here](https://help.salesforce.com/s/articleView?id=sf.security_networkaccess.htm&type=5) to configure your ip in trusted ip ranges. +{% /note %} {% /codeInfo %} {% codeInfo srNumber=6 %} diff --git a/openmetadata-ui/src/main/resources/ui/public/locales/en-US/Database/Salesforce.md b/openmetadata-ui/src/main/resources/ui/public/locales/en-US/Database/Salesforce.md index b84aa44f9743..516b7edd9c11 100644 --- a/openmetadata-ui/src/main/resources/ui/public/locales/en-US/Database/Salesforce.md +++ b/openmetadata-ui/src/main/resources/ui/public/locales/en-US/Database/Salesforce.md @@ -36,6 +36,10 @@ $$section ### Organization ID $(id="organizationId") Salesforce Organization ID is the unique identifier for your Salesforce identity. You can check out [this doc](https://help.salesforce.com/s/articleView?id=000385215&type=1) on how to get the your Salesforce Organization ID. + +**Note**: You need to provide `15` digit organization id in this section. for e.g. `00DIB000004nDEq`, which you can find by following the steps mentioned in above doc (`Salesforce dashboard->Setup->Company Profile->Company Information->Salesforce.com Organization Id`). + +**Note**: If you want to access salesforce metadata without token(only by using organization id), you will need to setup your ip in trusted ip ranges. You can go (`Salesforce dashboard->Setup->Security->Network Access->Trusted IP Ranges`) to configure this. You can check [here](https://help.salesforce.com/s/articleView?id=sf.security_networkaccess.htm&type=5) to configure your ip in trusted ip ranges. $$ $$section