Skip to content

Commit 1232be1

Browse files
committed
Revised for style, grammar, spelling, and created proc
1 parent 0d59a65 commit 1232be1

File tree

1 file changed

+19
-14
lines changed

1 file changed

+19
-14
lines changed

powerapps-docs/maker/common-data-service/EnvironmentVariables.md

Lines changed: 19 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ Keywords: environment variables, variables, model-driven app, configuration data
55
author: caburk
66
ms.author: caburk
77
manager: kvivek
8-
ms.date: 10/22/2019
8+
ms.date: 02/10/2020
99
ms.service: powerapps
1010
ms.topic: article
1111
search.audienceType:
@@ -35,19 +35,23 @@ Benefits of using environment variables:
3535
> - This is a preview feature.
3636
> - [!INCLUDE[cc_preview_features_definition](../../includes/cc-preview-features-definition.md)]
3737
38-
## How they work?
39-
Environment variables can be created and managed through the modern solution interface or by [using code](https://docs.microsoft.com/powerapps/developer/common-data-service/work-with-data-cds). A separate JSON file is created within your solution package for the values, which can also be managed in source control and modified in a build pipeline. Export to and import from Excel is supported. After creating environment variables, you can use them as inputs within plug-ins, flows, and other components.
38+
## How do they work?
39+
Environment variables can be created and managed through the modern solution interface or by [using code](https://docs.microsoft.com/powerapps/developer/common-data-service/work-with-data-cds). A separate JSON file is created within your solution package for the values, which can also be managed in source control and modified in a build pipeline. Export to and import from Excel is supported. After creating environment variables, you can use them as inputs within plug-ins, flows, and other components.
4040

41-
## Default value
42-
This field is part of the environment variable definition entity and is not required. Set a default value for the production environments or when the values don't need to be changed for different environments.
41+
### Create an environment variable in Power Apps
42+
1. Sign in to Power Apps, and then on the left panes select **Solutions**.
43+
2. On the command bar, select **New** and then select **Environment variable**.
44+
3. On the left pane, complete the following fields, and then select **Save**:
45+
- **Display name**. Enter a name for the environment variable.
46+
- **Name**. The unique name is automatically generated from the **Display name**, but you can change it.
47+
- **Data Type**. Select from **Decimal number**, **Text**, **JSON**, or a **Two option** field.
48+
- **Default Value**. This field is part of the environment variable definition entity and is not required. Set a default value for the production environments or when the values don't need to be changed for different environments.
49+
- **Current Value**. Also known as the override value. This field is optional and is a part of the environment variable value entity. Set the value when you'd like to override the default value in your current environment. Remove the value from your solution if you don't want to use it in the next environment. The values are also separated into a separate JSON file within the solution.zip file that is exported.
4350

44-
## Value
45-
Also known as the current value or the override value, this field is optional and is a part of the environment variable value entity. Set the value when you'd like to override the default value in your current environment. Remove the value from your solution if you don't want to use it in the next environment. The values are also separated into a separate JSON file within the solution.zip file that is exported.
51+
Separation of default value and current value allows you to service the definition and the default value separately from the current value. It also allows us to extend the functionality in the future to support multiple values scoped to a specific run time context.
4652

47-
>[!NOTE]
48-
> A value can't exist without a definition. The interface only allows creation of one value per definition.
49-
50-
Separatation of default value and current value allows you to service the definition and the default value separately from the current value. It also allows us to extend the functionality in the future to support multiple values scoped to a specific run time context.
53+
>[!NOTE]
54+
> A value can't exist without a definition. The interface only allows creation of one value per definition.
5155
5256
## Notifications
5357
A notification is displayed when the environment variables do not have any values. This is a reminder to set the values so that components dependent on variables do not fail. It also allows partners to ship variables without values and the customer is prompted to input the values.
@@ -56,17 +60,18 @@ A notification is displayed when the environment variables do not have any value
5660
> We recommend partners build their own interfaces requiring the customers to provide the values. Notifications help prevent failures if this step is skipped. 
5761
5862
## Security
59-
Both the environmentvariabledefinition and environmentvariablevalue entities are [user or team owned](https://docs.microsoft.com/powerapps/maker/common-data-service/types-of-entities). When creating an application that uses Environment variables, be sure to assign users the appropriate level of permission. More information: [Security in Common Data Service](https://docs.microsoft.com/power-platform/admin/wp-security).
63+
Both the environmentvariabledefinition and environmentvariablevalue entities are [user or team owned](https://docs.microsoft.com/powerapps/maker/common-data-service/types-of-entities). When creating an application that uses environment variables, be sure to assign users the appropriate level of permission. More information: [Security in Common Data Service](https://docs.microsoft.com/power-platform/admin/wp-security).
6064

6165
## Current limitations
6266
- Caching. Plugins will need to run a query to fetch the values.
63-
- Canvas apps and flows can consume Environment variables just like entity record data. In the future we plan to build additional actions into canvas app and flow designers. This will simplify authoring and provide better visibility into environment variables being used by a specific app or flow.
64-
- Azure Key Vault integration for secret management. Currently Environment variables should not be used to store secure data such as passwords and keys.
67+
- Canvas apps and flows can consume environment variables just like entity record data. <!-- In the future we plan to build additional actions into canvas app and flow designers. This will simplify authoring and provide better visibility into environment variables being used by a specific app or flow. -->
68+
- Azure Key Vault integration for secret management. Currently environment variables should'nt be used to store secure data such as passwords and keys.
6569
- Data types are validated in the modern solution interface only, but not currently on the server during the preview.
6670
- Dependencies are not enforced for certain component types.
6771
- If using Excel to import environment variables, be sure to pre-pend the publisher prefix to the SchemaName.
6872

6973
### See also
74+
[Power Apps Blog: Environment variables available in preview!](https://powerapps.microsoft.com/blog/environment-variables-available-in-preview/)
7075
[Use plug-ins to extend business processes](https://docs.microsoft.com/powerapps/developer/common-data-service/plug-ins) </BR>
7176
[Web API samples](https://docs.microsoft.com/powerapps/developer/common-data-service/webapi/web-api-samples) </BR>
7277
[Create Canvas app from scratch using Common Data Service.](https://docs.microsoft.com/powerapps/maker/canvas-apps/data-platform-create-app-scratch) </BR>

0 commit comments

Comments
 (0)