diff --git a/_data/meltano/extractors/tap-salesforce/meltanolabs.yml b/_data/meltano/extractors/tap-salesforce/meltanolabs.yml index 425663e8c..72fbc5b7b 100644 --- a/_data/meltano/extractors/tap-salesforce/meltanolabs.yml +++ b/_data/meltano/extractors/tap-salesforce/meltanolabs.yml @@ -1,17 +1,23 @@ capabilities: -- properties +- about +- batch +- catalog - discover +- schema-flattening - state +- stream-maps description: Customer-relationship management & customer success platform -domain_url: https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/intro_what_is_rest_api.htm +domain_url: + https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/intro_what_is_rest_api.htm keywords: - api +- meltano_sdk label: Salesforce logo_url: /assets/logos/extractors/salesforce.png maintenance_status: active name: tap-salesforce namespace: tap_salesforce -pip_url: git+https://github.com/meltanolabs/tap-salesforce.git@v1.5.1 +pip_url: git+https://github.com/meltanolabs/tap-salesforce.git@sdk quality: silver repo: https://github.com/meltanolabs/tap-salesforce select: @@ -22,105 +28,82 @@ select: - Account.* - Opportunity.* settings: -- description: The username (or email address) used to sign in to your Salesforce - account. - label: Username - name: username - placeholder: Ex. me@my-organization.com -- description: The password used to sign in to your Salesforce account. - kind: password - label: Password - name: password - placeholder: Ex. ***************** -- description: | - #### How to get - - If you don't already have a Salesforce Security Token for your account, you can generate one through the following steps: - - 1. Sign in to your [Salesforce Account](https://login.salesforce.com/). - - 1. Go to your Account Settings (top right on the header bar) - - 1. Click `Reset My Security Token` (Under the `My Personal Information` section) - - 1. Click `Reset Security Token` - - An email with the Security Token will be sent to your email. - - > **Tip: Why is my "Reset Security Token" option missing?** - > - > If a user’s profile is configured such that there is a restriction on the IP ranges that can access Salesforce, then that user will not have the ability to access/reset their security token. - > - > In order to give access to the security token, either remove the user from the profile that contains the IP range restriction, or update the user’s profile by removing the IP range restriction. - > - > In rare cases where the user’s profile doesn’t contain IP range restriction and they still can’t access the security token reset option, edit the user’s profile and save (without making any actual changes to the profile). - - > **Tip:** When you reset your Salesforce password, your security token resets as well. If that security token is used to integrate Meltano with Salesforce, that integration will break as well. Each time you reset an account password used to connect Meltano or other applications to Salesforce, you will need to re-enter your new security token into that application. - - > **Warning:** If you have other third-party applications integrated with Salesforce and you reset your security token, that integration will break. Try to use your existing Security Token instead of resetting your existing one. Otherwise, you will need to re-enter your new security token into all the connected applications. - documentation: https://hub.meltano.com/extractors/salesforce.html#salesforce-setup +- description: Auth type for Salesforce API requires either access_token or username/password + kind: string + label: Auth + name: auth +- description: Compression format to use for batch files. + kind: options + label: Batch Config Encoding Compression + name: batch_config.encoding.compression + options: + - label: Gzip + value: gzip + - label: None + value: none +- description: Format to use for batch files. + kind: options + label: Batch Config Encoding Format + name: batch_config.encoding.format + options: + - label: Jsonl + value: jsonl +- description: Prefix to use when writing batch files. + kind: string + label: Batch Config Storage Prefix + name: batch_config.storage.prefix +- description: Root path to use when writing batch files. + kind: string + label: Batch Config Storage Root + name: batch_config.storage.root +- description: Toggle for using BULK API method + kind: boolean + label: Bulk Load + name: bulk_load + value: false +- description: Client id, used for getting access token if access token is not available kind: password - label: Security Token - name: security_token - placeholder: Ex. ***************** -- description: Salesforce client ID. See https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/intro_understanding_web_server_oauth_flow.html. label: Client ID name: client_id -- description: Salesforce client secret. See https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/intro_understanding_web_server_oauth_flow.html. +- description: Client secret, used for getting access token if access token is not + available kind: password label: Client Secret name: client_secret -- description: Salesforce refresh token. See https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/intro_understanding_web_server_oauth_flow.html. - kind: password - label: Refresh Token - name: refresh_token -- description: Determines how much historical data will be extracted. Please be aware - that the larger the time period and amount of data, the longer the initial extraction - can be expected to take. +- description: Website domain for site url, ie. , https://{domain}.salesforce.com/services/data/ + kind: string + label: Domain + name: domain +- description: Latest record date to sync kind: date_iso8601 - label: Start Date - name: start_date -- description: Use Salesforce Sandbox - kind: boolean - label: Is Sandbox - name: is_sandbox - value: false -- description: Used to switch the behavior of the tap between using Salesforce’s “REST” - and “BULK” APIs. - kind: options - label: API Type - name: api_type - options: - - label: REST - value: REST - - label: BULK - value: BULK - value: REST -- description: Select by default any new fields discovered in Salesforce objects + label: End Date + name: end_date +- description: "'True' to enable schema flattening and automatically expand nested + properties." kind: boolean - label: Select Fields By Default - name: select_fields_by_default - value: true -- description: | - Used to throttle how often STATE messages are generated when the tap is using the “REST” API. - - This is a balance between not slowing down execution due to too many STATE messages produced and how many records must be fetched again if a tap fails unexpectedly. Defaults to 1000 (generate a STATE message every 1000 records). + label: Flattening Enabled + name: flattening_enabled +- description: The max depth to flatten schemas. kind: integer - label: State Message Threshold - name: state_message_threshold - value: 1000 -- description: Maximum number of threads to use. - kind: integer - label: Maximum number of threads to use - name: max_workers - value: 8 + label: Flattening Max Depth + name: flattening_max_depth +- description: Earliest record date to sync + kind: date_iso8601 + label: Start Date + name: start_date +- description: User-defined config values to be used within map expressions. + kind: object + label: Stream Map Config + name: stream_map_config +- description: Config object for stream maps capability. For more information check + out [Stream Maps](https://sdk.meltano.com/en/latest/stream_maps.html). + kind: object + label: Stream Maps + name: stream_maps settings_group_validation: -- - username - - password - - security_token - - start_date -- - client_id +- - auth + - bulk_load + - client_id - client_secret - - refresh_token - - start_date + - domain variant: meltanolabs