Skip to content

Commit

Permalink
Updates extractors tap-salesforce (SDK based - meltanolabs)
Browse files Browse the repository at this point in the history
  • Loading branch information
pnadolny13 committed Sep 8, 2023
1 parent 368839c commit 531de94
Showing 1 changed file with 76 additions and 93 deletions.
169 changes: 76 additions & 93 deletions _data/meltano/extractors/tap-salesforce/meltanolabs.yml
Original file line number Diff line number Diff line change
@@ -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:
Expand All @@ -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. [email protected]
- 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

0 comments on commit 531de94

Please sign in to comment.