Gainsight PX Environment Settings
IMPORTANT - Articles Impacted due to PX November 2022 Release
Due to the PX November 2022 release, this article has been impacted. Images and playable GIFs in this article will soon be updated to reflect the latest changes.
For more information about the latest UI changes, click here.
An application can have multiple subscriptions. You can use the Environment settings in PX to differentiate subscriptions by their usage type. You can use these settings while creating new Products in your subscription. You can also configure all of your existing products with one of the environment settings.
You may be using various environments for your application. You can associate the Staging PX product with your staging application, QA product with your QA application, and so on. Once you complete this process, you can test how an engagement looks on your staging application and then push it to your production application for customers to view it. Similarly, you can test other features in multiple environments before pushing them to your production environment.
Environment Setting Options
Gainsight PX provides you with four types of environment settings:
- Production: This type of tenant contains real-time data and is generally being used by your customers.
- Stage: Staging tenant is a clone of the production tenant. This type of tenant can be used to test new features before releasing them to production, as well as to test engagements before publishing them to production environments.
- QA: This type of tenant is generally used by Quality Assurance teams to test new features or issues. Once everything passes QA, data can be pushed to the Staging org.
- Integration: This type of tenant is generally used by developers while building new features or modifying existing features. Once development is completed, data can be pushed to QA type tenants for testing.
Nature of Product Key for Production and Non-Production Environments
The production and non production environments can be differentiated by the format of their product keys. A Production environment has a product key in the format XXXXXXXXXX-X. All the non-production environments have product keys in the format XXXXXXXXXX-X-X.
Apart from selecting an environment for your product, you can also select which environments must be enabled by default in new engagements. This setting can be configured from the Enable by default in new engagements check box (see the impact of the environment in engagements for more information).
In the above image, the Stage subscription is enabled by default when a new engagement is created.
This section explains how to configure Products with Environments in Gainsight PX.
To configure Products:
- Navigate to Administration > Products.
- Select the product for which you wish to configure the Environment setting.
- Select the required environment from the Environment drop-down menu.
- (Optional) Select the Enable by default in new engagements check box.
- (Applicable only if the above step is executed) Click Save.
Note: Once the product tag key is generated, you must copy it and paste into your web-app.
Impact of Environment Settings in PX Modules
Environment Settings impact all areas of PX, since this setting works at the Product level. In most areas, you now have an option to filter data based on the available environments. This section explains how the Environment Settings impact various PX modules.
In User management when you add new users, you have a new check box called Production Launcher. If you select this check box for a user, they can launch engagements in the Production environments. For existing users, if the Manager check box is selected, the Production Launcher check box is also selected automatically.
In Engagements, you can now select the environment for which you wish to launch your engagement. This option is available in the Launch section of the engagement.
IMPORTANT: It is mandatory to select at least one of the environment types before launching the engagement.
Note: If you have selected an Environment and launched the engagement, and wish to add more environments, you can do so without pausing the engagement.
The Engagement List view now has an additional filter that allows you to filter engagements based on the environments for which they are launched (or will be launched). You can select multiple environments in this filter.
The list view also has a new column called Environment. This column displays the initials of the environment type (P for Production, S for Sandbox, etc.) for which the engagement is being used.
Knowledge Center Bot
In the KC Bot, you can now select the environment for which you wish to launch the Bot. Initially, you can test the bot in a Staging org, and then move it to the Production org. The Launch section of the Bot allows you to select the environment for which the Bot must be launched.
- It is mandatory to select at least one environment type, before launching the bot.
- Consider that there are two engagements whose trigger method is set to KC Bot. The engagements is meant to be launched on Production and Sandbox, as shown in the following image.
Both the above engagements now appear in KC Bot since the trigger method is set to KC Bot.
If you select the Add check box for the Staging engagement, the staging engagement is added to the Bot. Now, if you go ahead and launch the Bot for the Production environment, your staging engagement can be viewed on production, via the KC Bot.
Filter Audience based on the environments.
Filter Accounts based on the environments.
Filter the Analytics section to view data for the required environments.
View Dashboards for a specific environment.
When you create a new Dashboard, you can now select the environment to which the Dashboard belongs to.
Configure Default Product, Channel and Environment
Admins and users can set the default Product, Channel and Environment values for their product/subscription. This eliminates the need to manually select the values each time you login to Gainsight PX.
To use this feature, from the Product, Channel or Environment drop-down, select the Set as default option by clicking on the three-vertical dot icon. To remove the default, select Remove Default option using the three-vertical dot icon.
Note: The default options that you set are auto-selected on the pages when you perform an action such as Creating an Engagement.