Variables de entorno

Completado

Cuando crea flujos de nube de Power Automate, es habitual tener valores que se especifican en los pasos del flujo que son específicos de un entorno en el que se está implementando el flujo. Por ejemplo, las acciones de flujo pueden hacer referencia al nombre del documento, la URL del servicio externo o la dirección de correo electrónico para notificaciones, que puede variar entre los entornos, como desarrollo, prueba y producción.

Las variables de entorno permiten una definición y configuración independientes de esos valores desde la definición del flujo de nube. A continuación, la variable de entorno puede tener un valor diferente en cada entorno donde se implementa el flujo de nube. Otros recursos de Microsoft Power Platform, como Power Apps o conectores personalizados, también pueden usar variables de entorno. Una vez que se han definido los valores de las variables de entorno, los flujos de nube pueden reemplazar el contenido codificado por valores de variables de entorno, de un modo similar a cómo se utiliza otro contenido dinámico.

Las variables de entorno constan de dos partes: definición y valor actual. La definición define el tipo de datos de una variable y puede contener un valor predeterminado. La segunda parte es un valor actual que se puede proporcionar de manera opcional en cada entorno para anular el valor predeterminado. Cuando una solución que contiene una definición de variable de entorno se importa a otro entorno, si aún no se ha establecido un valor actual, la importación solicitará el valor.

Puede crear variables de entorno en una solución seleccionando + Nuevo > Más > Variable de entorno. En la siguiente imagen se muestra un ejemplo de cómo crear una variable Error Notification Email.

Captura de pantalla de la creación de una nueva variable de entorno

A medida que completa los campos Nombre para mostrar y Nombre, recuerde que el nombre debe aclarar el propósito y ser único. Por ejemplo, si nombra la variable de ejemplo Correo electrónico, sería demasiado genérico. Puede cambiar el Nombre para mostrar, que es visto por los usuarios, después de la creación. El Nombre, que se usa internamente y cuando se accede mediante programación a la variable, no se puede cambiar para ayudar a evitar que se rompa algo que esté consumiendo el valor de la variable. El Tipo de datos determina qué tipo de valores se pueden almacenar y tampoco se puede cambiar después de la creación. Los tipos de datos de Origen de datos y Secreto son únicos y se describirán más adelante en este módulo.

Después de haber elegido un Tipo de datos, puede configurar un valor predeterminado. No se requiere un valor predeterminado, pero resulta útil si tiene uno. Por ejemplo, si tiene una variable Expiration Days, es posible que tenga un valor predeterminado de 28 días, pero podría anularse por un valor actual en cualquier entorno. En la siguiente captura de pantalla se muestra el proceso de proporcionar un valor predeterminado para la variable.

Captura de pantalla del valor predeterminado de una variable de entorno]

También puede proporcionar un valor actual para el entorno. Por ejemplo, en desarrollo, se puede usar el alias DevTeam.

Captura de pantalla del valor actual de una variable de entorno]

Si establece un valor actual, asegúrese de abrir la variable para editarla de nuevo y luego elimine el valor actual de la solución después de que se haya creado la variable. Si no completa esta acción, el componente Valor actual del entorno de desarrollo se incluirá en las exportaciones de la solución. Como resultado, el entorno de desarrollo Valor actual se utilizará en cualquier otro entorno, como prueba y producción. Para eliminarlo de la solución pero mantenerlo configurado solo para el entorno de desarrollo, seleccione Quitar de esta solución.

Captura de pantalla de la eliminación del valor actual de una solución

Variables de entorno del origen de datos

El Tipo de datos de Origen de datos está diseñado para almacenar la configuración de cómo apuntar una conexión a un origen de datos específico. Después de seleccionar Origen de datos como el Tipo de datos, deberá elegir un conector compatible con este tipo de configuración. Actualmente solo se admite SharePoint. Por ejemplo, si se selecciona SharePoint, tendrá que elegir un Tipo de parámetro de Sitio o Lista. Deberá configurar una variable de entorno de origen de datos Sitio antes de poder configurar una variable de entorno Lista. En la siguiente captura de pantalla se muestra un ejemplo de crear una variable de origen de datos Sitio.

Captura de pantalla de la configuración de una variable de entorno de origen de datos

Variable de entorno secretas

El Tipo de datos de Secreto está diseñado para hacer referencia a secretos que se almacenan en Microsoft Azure Key Vault. Este tipo de variable requiere otra configuración. Para obtener más información, consulte Usar secretos de Azure Key Vault. Las variables de entorno de secreto ayudan a evitar que la información confidencial se exponga accidentalmente a los usuarios o en el historial de ejecución del flujo.

Usar variables de entorno

En el flujo de nube de su solución, puede reemplazar los valores codificados haciendo referencia a las variables de entorno. Una vez que haya definido las variables en un entorno, las variables de entorno disponibles se podrán seleccionar desde el panel Contenido dinámico. En la siguiente captura de pantalla se muestra un ejemplo del uso de la variable Error Notification Email que definió previamente.

Captura de pantalla de una variable de entorno en un paso de acción para reemplazar un valor codificado

También puede usar la expresión de parámetros para obtener el valor. Por ejemplo, parameters('contoso_ErrorNotificationEmail') recuperaría el mismo valor.