Managing all your Salesforce organizations gets easier with the Salesforce App. The Salesforce App installation is linked to a Salesforce Org but provides the ability to add multiple organizations from the same interface.
The Environment Hub page enables you to configure new Salesforce organizations and also manage existing Salesforce organizations with a centralized interface.
Connecting to a Salesforce Organization
The Salesforce organization you are connecting to must have the API feature enabled. This feature is enabled by default for Performance, Unlimited, Enterprise, and Developer Editions. Some Professional Edition organizations may also have the API feature enabled.
When connecting to a Salesforce org, enable the following Profile settings on the Salesforce User Account to use the associated feature:
|Adding Environment||API Enabled (Required)|
|Data Template||View All Data (Recommended)|
View All Data (Recommended)
Query All Files (Recommended)Author Apex or Modify Metadata (Recommended)
|Data Copy (Sandbox Seeding)||
Modify All Data (Recommended)
Edit Read-Only Fields (Recommended)
Marketing User (Recommended for Campaigns)
Knowledge User (Recommended for Articles)
Customize Application (Required)
Note: If you refresh a Sandbox, re-authenticate the environment from the Environment Hub. For more information, see Remove Organization Association. Any existing references to these Sandboxes within the Data Templates are removed and you need to re-select the environment in the Data Template details page.
Adding a Salesforce Environment
- On the Salesforce App console, click Environment Hub.
- Click New. The Add Salesforce Environment window appears.
- Enter the Organization Name.
Note: This appears as a Name on the Environment Hub table. The organization name can be the same as your environment or can be an alias. This name must be unique within your account.
4. Select the environment from the Environment dropdown list.
|Salesforce Environment Type||Environment Setting|
|Sandboxes - Developer (Dev), Developer Pro (Dev Pro), Partial Copy (Partial), Full||Sandbox|
|Trialforce / Partner Developer Edition||Production|
5. Select a group from the Group dropdown list.
Note: Groups are used to categorize environments, such as Production, QA, or Development. You can either create a new group or use an existing group. Click Add Group to configure an additional group for the organization.
6. Click Connect to add your Salesforce org using OAuth 2.0.
For more information about OAuth 2.0, see Using OAuth 2.0.
Managing Salesforce Organizations
You can manage the following tasks for your configured Salesforce organizations from the Environment Hub page:
|Refresh Objects Metadata||Ensures the selected organization’s metadata is up-to-date with the latest changes.|
|Refresh Validations||Ensures the selected organization’s data is up-to-date with the latest state of validations.|
|Disable Validations||Disables validations for the selected organization.|
Displays a page with the selected organization’s details. The Details page helps you manage linked Salesforce organizations to:
For more information, see Managing Salesforce Organizations.
You can view dashboards, apply validations, and view tasks related to an organization.
- On the Salesforce App console, click Environment Hub.
2. Click Detail corresponding to a Salesforce organization listing.
The Details page is divided into the following:
This section enables you to:
Refresh Validations - Ensures the selected organization’s data is up-to-date with the latest state of validations.
Org Describe Refresh - Performs a refresh to get the latest state of your Salesforce organization with the latest updates.
Disable Validations - Disables validations for the organization.
Delete Organization - Deletes the organization.
View Details - Displays details about the organization, such as:
- Sandbox Type - Displays the type of sandbox.
- Group - Specifies the organization’s group name. Groups are used to categorize environments, such as Production, QA, or Development.
- Instance URL - Specifies the instance URL for the organization.
- Describe Cache Updated At - Specifies when the describe cache was last updated.
- Validation Cache Updated At - Specifies when the validation cache was last updated.
- Is Disabled - Specifies if the organization is currently disabled.
Storage and API Dashboards
The Details page displays the following dashboards.
|Data Storage||Displays an overview of the total data storage and consumed data storage.|
|File Storage||Displays an overview of the total file storage and consumed file storage.|
Displays the total API usage limit and the consumed API statistics.
The Salesforce App consumes APIs while performing the data backups, data restore, and data copy of your Salesforce organizations. As a Salesforce App administrator, ensure that you are aware of the API usage limit set for your organization by Salesforce.
The first backup utilizes maximum APIs. The subsequent backups are incremental and minimal APIs are consumed.
To stay updated with these statistics, refresh these dashboards using the icon.
To update these statistics for all your Salesforce organizations, click Update Org Limits from the Environment Hub page.
You can manage validations for any of the configured Salesforce organizations from the Details page.
Select the Validation Type from the dropdown list. A table displays the applied validations.
For more information, see Validations.
The Related Tasks tab from the Details page displays the list of associated tasks for the selected organization.
For more information, see Managing Tasks.
The Describe tab from the Details page enables you to search for objects within your Salesforce organization. Also, you can identify creatable or updateable objects within your Salesforce organization.
- Search for an object name in the search box.
- Select Creatable or Updateable to filter the records.
Run SOQL Query
Search for specific information within Salesforce data from an organization using the Salesforce Object Query Language (SOQL). The Run SOQL Query tab enables you to search for data using SOQL queries.
SOQL queries are similar to SELECT statements, wherein you can filter a data set within the organization and perform analysis using the query result.
Enter a SOQL query in the input field and click Execute SOQL. This renders a SOQL Result window with the filtered data set.
Using OAuth 2.0
The OAuth 2.0 authentication and authorization framework uses a Refresh Token to re-authenticate the application with your Salesforce org. Salesforce only allows a maximum of 5 refresh tokens per connected app that can be issued at any point in time. If you request an additional security token after the 5th token is issued, the oldest security token will be invalidated. This is not ideal for scheduled jobs.
OAuth 2.0 doesn’t require security tokens. However, it requires acceptance of the following OAuth scope:
- Access your basic information
- Access and manage your data
- Provide access to your data via the Web
- Access and manage your Chatter data
- Provide access to custom applications
- Allow access to your unique identifier
- Access custom permissions
- Access and manage your Wave data
- Access and manage your Eclair data
- Perform requests on your behalf at any time
For additional information, see Create a Connected App.