Usar variables de entorno en conectores personalizados de solución
Las aplicaciones a menudo requieren diferentes ajustes de configuración o parámetros de entrada cuando se implementan en diferentes entornos. Las variables de entorno almacenan las claves y los valores de los parámetros, que pueden servir como entrada para otros diversos objetos de la aplicación. También puede utilizar variables de entorno en los conectores personalizados de solución para actualizar las propiedades clave de conector personalizadas, como Host, Base URL, Client ID, Client Secret, Login Url y Refresh Url. Para un tutorial detallado, puede leer este blog.
Usar una variable de entorno en un conector personalizado
Cuando se crea o actualiza un conector personalizado, los valores de las variables de entorno se utilizarán para crear el conector personalizado. El conector personalizado utiliza el valor de las variables de entorno durante el tiempo de guardado. Cuando se actualiza una variable de entorno, los conectores personalizados deben volver a guardarse para usar el valor de la variable de entorno actualizado.
Inicie sesión en Power Apps o Power Automate.
Seleccione una solución en la lista.
o bien
Si necesita crear un nuevo conector personalizado en una solución, vaya a Crear conectores personalizados en soluciones.
De la lista, seleccione la solución recién creada o existente.
Seleccione Variable de entorno.
Seleccione Nuevo > Más > Variable de entorno.
Introduzca el nombre de la variable de entorno, que contiene el prefijo de id. del editor. (No use el nombre del campo Nombre para mostrar.)
El siguiente ejemplo usa Dirección URL del sitio de SharePoint. Puede crear otros valores de variables de entorno para otras configuraciones como Id. de cliente de OAuth, Recurso y otras.
Las variables de entorno pueden utilizar la siguiente sintaxis en los campos de conectores personalizados:
@environmentVariables("environmentVariableName")Ejemplo
@environmentVariables("cr49f_SharePointSiteURL_7weem")
(Opcional) Para utilizar los valores de las variables de entorno en los campos Host y URL base, haga lo siguiente:
Seleccione Nuevo > Automatización > Conector personalizado.
En la pestaña General, introduzca la sintaxis de la variable de entorno para hacer referencia a una variable de entorno.
(Opcional) Para utilizar los valores de las variables de entorno en cualquiera de los campos en la pestaña Seguridad, haga lo siguiente:
Seleccione Nuevo > Automatización > Conector personalizado.
En la pestaña Seguridad, introduzca la sintaxis de la variable de entorno para hacer referencia a una variable de entorno.
Para obtener más información, vaya a Especificar el tipo de autenticación.
Las variables de entorno con el tipo de datos Secreto ahora se pueden usar en conectores personalizados. Debe configurar Azure Key Vault mediante los pasos descritos aquí. En la UI de configuración de seguridad, el valor está enmascarado. Deberá usar la siguiente sintaxis:
@environmentVariables("environmentVariableName")Importante
Una variable de entorno creada para Secreto de cliente con el tipo de datos Text no es segura. Estos valores no están cifrados. La recomendación es usar Azure Key Vault.
- (Opcional) En la pestaña Definición, agregue las acciones, los desencadenadores o las directivas necesarias. Actualmente, las variables de entorno no se admiten en acciones, desencadenadores o directivas.
Usar nuevos valores para las variables de entorno al importar soluciones
Si desea utilizar nuevos valores para las variables de entorno al importar soluciones, puede eliminar el valor de su solución antes de exportar la solución. Esto garantiza que el valor existente permanecerá en su entorno de desarrollo, pero no se exportará en la solución. Este enfoque permite proporcionar un nuevo valor al importar la solución a otros entornos.
Para usar los nuevos valores para las variables de entorno
Exporte la solución. Este paso es donde eliminará el valor, como se menciona en el párrafo anterior.
Importe la solución a un entorno nuevo.
No se le solicitarán nuevos valores durante la importación de la solución si las variables de entorno ya tienen un valor predeterminado o cualquier valor está presente. Esto sucede cuando los valores forman parte de su solución o ya están presentes en el entorno de destino.
Para obtener más información, vaya a ¿Cómo elimino un valor de una variable de entorno?.
Proporcionar comentarios
Agradecemos enormemente los comentarios sobre problemas con nuestra plataforma de conectores o nuevas ideas de características. Para enviar comentarios, vaya a Enviar problemas u obtener ayuda con los conectores y seleccione el tipo de comentario.