Variables de ambiente para Power Platform descrición xeral

As variables de ambiente permiten o escenario básico de xestión do ciclo de vida da aplicación (ALM) de mover unha aplicación entre Power Platform entornos. Neste escenario, a aplicación permanece exactamente igual, excepto por algunhas referencias clave de aplicacións externas (como táboas, conexións e claves) que son diferentes entre o ambiente de orixe e o de destino. A aplicación require que a estrutura das táboas ou conexións sexa exactamente a mesma entre o contorno de orixe e o de destino, con algunhas diferenzas. As variables de ambiente permítenche especificar cales destas diferentes referencias externas se deben actualizar a medida que a aplicación se move entre ambientes.

As variables de contorno almacenan as claves e os valores dos parámetros, que logo serven como entrada a outros obxectos da aplicación. A separación dos parámetros dos obxectos consumidores permítelle cambiar os valores dentro do mesmo contorno ou cando migra solucións a outros contornos. A alternativa é deixar valores de parámetros moi codificados dentro dos compoñentes que os usan. Isto é moitas veces problemático; especialmente cando hai que cambiar os valores durante as operacións ALM. Debido a que as variables de contorno son compoñentes da solución, pode transportar as referencias (claves) e cambiar os valores cando as solucións se migran a outros contornos.

Nota

Agora estanse a implementar novas capacidades para as fontes de datos e é posible que aínda non estean dispoñibles na súa rexión.

Vantaxes do uso de variables de ambiente:

• Proporcione novos valores de parámetros durante a importación de solucións a outros ambientes.
• Almacene a configuración das fontes de datos usadas en aplicacións de lenzo e fluxos. Por exemplo, os parámetros de sitios e listas de SharePoint Online pódense almacenar como variables de contorno; polo tanto, permítelle conectarse a diferentes sitios e listas en diferentes contornos sen necesidade de modificar as aplicacións e os fluxos.
• Empaquete e transporte a súa personalización e configuración xuntas e xestióneas nun único lugar.
• Segredos de empaquetado e transporte, como as credenciais utilizadas por diferentes compoñentes, por separado dos compoñentes que os usan.
• Pódese usar unha variable de contorno en moitos compoñentes de solución diferentes, xa sexan o mesmo tipo de compoñentes ou diferentes. Por exemplo, unha aplicación de lenzo e un fluxo poden usar a mesma variable de contorno. Cando o valor da variable de contorno debe cambiar, só precisa cambiar un valor.
• Ademais, se precisa retirar un orixe de datos en ambientes de produción, pode actualizar os valores das variables de ambiente con información para o novo orixe de datos. As aplicacións e os fluxos non requiren modificación e comezan a usar o novo orixe de datos.
• Compatible coas ferramentas Empaquetador de solucións e DevOps, o cal permite a integración e a entrega continuas (CI/CD).
• As variables de contorno pódense desempaquetar e almacenar no control de orixe. Tamén pode almacenar ficheiros de valores de variables de ambiente diferentes para a configuración separada necesaria en diferentes ambientes. Solution Packager pode entón aceptar o ficheiro correspondente ao ambiente no que se importa a solución.

Como funcionan as variables de ambiente?

As variables de contorno pódense crear e modificar dentro da interface de solución moderna, creadas automaticamente ao conectarse a certas fontes de datos en aplicacións de lenzo ou usando código. Tamén se poden importar a un ambiente a través de solucións. Unha vez que as variables de ambiente están presentes nun ambiente, pódense usar como entradas ao crear aplicacións de lenzo, Power Automate fluxos, ao desenvolver complementos e en moitos outros lugares, como engadir un Power BI panel a unha aplicación dirixida por modelos. Cando este tipo de obxectos utilizan variables de contorno, os valores son derivados das variables de contorno e pódense cambiar cando as solucións se importan a outros contornos.

Crear unha variable de ambiente nunha solución

1. Inicie sesión en Power Apps (make.powerapps.com) e, a continuación, no panel esquerdo, seleccione Solucións. Se o elemento non está no panel lateral, seleccione …Máis e, a seguir, seleccione o elemento que desexe.
2. Abra a solución que desexe ou cree unha nova.
3. Na barra de comandos, seleccione Novo > Máis e seleccione Variable de ambiente.
4. No panel dereito, complete as seguintes columnas e seleccione Gardar:

   • Nome para mostrar Introduza un nome para a variable do ambiente.

   • Nome. O nome único xérase automaticamente desde Nome para mostrar, pero pode cambialo.

   • Tipo de datos. Seleccione entre Número decimal, Texto, JSON, Dúas opcións, Orixe de datos ou Secreto.

     Nota

     • Se orixe de datos é o tipo seleccionado, tamén terá que seleccionar o conector, unha conexión válida para o conector seleccionado e o tipo de parámetro. Non obstante, a conexión non se almacena como parte da variable de ambiente. A conexión só se usa para recuperar valores de parámetros dispoñibles, como os sitios SharePoint aos que ten acceso ou as listas asociadas a un sitio. Para certos parámetros como listas SharePoint, tamén terá que seleccionar unha variable de contorno da orixe de datos principal como o sitio de SharePoint. Unha vez gardados, estes estarán relacionados na base de datos.
     • Se Segredo é o tipo seleccionado, é necesaria información adicional para configurar Azure Key Vault para permitir a Power Platform acceder ao segredo.

   • Valor actual. Tamén coñecido como o valor. Esta propiedade é opcional e forma parte da táboa de valores das variables de contorno. Cando un valor está presente, utilízase, aínda que tamén estea presente un valor predeterminado. Elimine o valor da súa solución se non quere usalo no seguinte ambiente. Os valores tamén están separados en ficheiros JSON separados dentro do ficheiro solution.zip exportado e pódense editar sen conexión. Máis información: Como elimino un valor dunha variable de contorno?

   • Valor predefinido. Esta columna forma parte da táboa de definición de variables de ambiente e non é necesaria. O valor predeterminado úsase se non hai ningún valor actual.

     A separación do valor predeterminado e do valor actual permítelle atender a definición e o valor predeterminado por separado do valor. Por exemplo, un editor de aplicacións pode incluír a súa oferta en AppSource cun valor predeterminado. A continuación, opcionalmente, o cliente pode proporcionar un novo valor. Cando o editor da aplicación publica actualizacións da aplicación, o valor establecido polo cliente non se sobrescribe.

     

     Nota

     Non pode existir un valor sen definición. A interface só permite crear un valor por definición.

Introduza novos valores mentres importa solucións

A moderna interface de importación de solucións inclúe a posibilidade de introducir valores para variables de contorno. Isto define a propiedade do valor na táboa environmentvariablevalue.

A partir dunha actualización o 7 de decembro de 2023, todos os valores das variables de ambiente están visibles ao importar solucións (ou cando se usa Pipelines para implementar). As variables de ambiente sen un valor ou valor predeterminado solicitaráselles un valor, pero as doutro xeito enchéranse previamente cunha etiqueta debaixo da área de texto que indica a orixe do valor: valor da solución, valor do entorno de destino ou valor predeterminado.

Nota

• Nalgúns casos, para valores específicos da variable de ambiente orixe de datos, pode aparecer un aviso de Acceso denegado se o creador da importación non ten acceso á conexión ou á fonte utilizada para a variable de ambiente. . Este é un aviso que non bloquea, pero é algo que debes ter en conta dependendo de como planeas usar a variable de ambiente no ambiente de destino.
• Pode eliminar o valor da súa solución antes de exportala. Isto garante que o valor existente permanecerá no seu contorno de desenvolvemento, pero non se exportará na solución. Este enfoque permite proporcionar un novo valor ao importar a solución a outros contornos. Máis información: Como elimino un valor dunha variable de contorno?

Notificacións

Aparecerá unha notificación cando as variables de ambiente non teñan ningún valor. Este é un recordatorio para establecer os valores para que os compoñentes dependentes das variables do contorno non fallen.

Seguranza

A táboa environmentvariabledefinition é propiedade do usuario ou equipo. Cando cree unha aplicación que use variables de contorno, asegúrese de asignar aos usuarios o nivel de privilexio adecuado para esta táboa. O permiso para a táboa environmentvariablevalue é herdado da táboa environmentvariabledefinition principal; polo tanto, non require privilexios separados. Os privilexios para táboas de environmentvariabledefinition inclúense nos roles de seguranza Environment Maker e Basic User de forma predeterminada. Máis información: Seguranza en Dataverse.

Atribución de nomes

Asegúrese de que os nomes das variables de ambiente sexan únicos para que se poidan referenciar con precisión. Os nomes de visualización das variables de ambiente duplicados dificultan a súa diferenciación e uso. Asegúrese de que os nomes das variables de ambiente sexan únicos para que se poidan referenciar con precisión. Os nomes $authentication e $connection son parámetros especialmente reservados para os fluxos e deben evitarse. O gardado de fluxo está bloqueado se se usan variables de ambiente con eses nomes. Se se utiliza unha variable de ambiente nun fluxo e se cambia o nome de visualización da variable de ambiente, o deseñador mostra os tokens de nome de visualización antigo e novo para axudar coa identificación. Cando actualice o fluxo, recomendámoslle que elimine a referencia da variable de ambiente e que a engada de novo.

Limitacións actuais

• A validación dos valores das variables de contorno ocorre dentro das interfaces de usuario e dentro dos compoñentes que as usan, pero non dentro de Dataverse. Polo tanto, asegúrese de establecer os valores axeitados se se están a modificar mediante código.
• As tarefas de Power Platform Build Tools aínda non están dispoñibles para xestionar as variables de contorno da orixe de datos. Non obstante, isto non bloquea o seu uso dentro das ferramentas proporcionadas por Microsoft e nos sistemas de control de orixe.
• A interacción con variables de ambiente mediante código personalizado require unha chamada á API para obter os valores; non hai unha caché exposta para usar código que non sexa de Microsoft.
• Para utilizar correctamente as variables de ambiente con SharePoint listas, o nome para mostrar e o nome lóxico de cada columna correspondente nos contornos orixe e destino deben coincidir.
• As variables de ambiente están limitadas a un máximo de 2.000 caracteres.

Preguntas máis frecuentes

Por que non podo ver o valor da miña variable de ambiente?

Se a variable de ambiente está nun solución administrada, non poderás ver o valor a menos que mire dentro da Solución predeterminada. Este comportamento é por deseño, xa que o valor da variable de ambiente é unha personalización non xestionada.

Como podo ver onde se utilizan as variables de contorno?

Ou seleccionando Mostrar dependencias na interface da solución, durante a creación de compoñentes, ou no control de orixe e no ficheiro da solución, vendo a aplicación ou os metadatos de fluxo.

Son as variables de contorno da orixe de datos o mesmo que as conexións?

Non. Aínda que están relacionados, unha conexión representa unha credencial ou autenticación necesaria para interactuar co conector. As variables de contorno da orixe de datos almacenan os parámetros requiridos por unha ou máis accións no conector e estes parámetros adoitan variar dependendo da acción. Por exemplo, unha conexión de SharePoint Online non almacena ningunha información sobre sitios, listas nin bibliotecas de documentos. Polo tanto, chamar ao conector require tanto unha conexión válida como algúns parámetros adicionais.

As variables de contorno da orixe de datos pódense usar con conexións compartidas como SQL Server con autenticación SQL?

Xeralmente non. As conexións compartidas con SQL Server almacenan os parámetros necesarios para conectarse aos datos dentro da conexión. Por exemplo, o nome do servidor e da base de datos fornécese ao crear a conexión e, polo tanto, sempre se derivan da conexión.

As variables de ambiente orixe de datos úsanse para conectores que dependen da autenticación baseada no usuario, como o Microsoft Entra ID porque os parámetros non se poden derivar da conexión. Por estes motivos, a autenticación con SQL Server, que é unha conexión compartida, non utilizará variables de contorno da orixe de datos.

Pode a miña canle de ALM automatizada usar ficheiros de valores diferentes para ambientes diferentes?

Si. O empaquetador de solucións acepta o nome do ficheiro como parámetros de entrada para que a súa canle poida empaquetar un ficheiro de valores diferentes na solución en función do tipo de ambiente no que se execute.

E se alguén elimina un valor sen querer?

Se o sistema de dependencias non o prevén, o tempo de execución usa o último valor coñecido como alternativa.

Se se cambia un valor, cando se utiliza o novo valor nas aplicacións de lenzo e nos fluxos de nube?

Pode levar ata unha hora publicar completamente as variables de ambiente actualizadas porque o valor envíase ás aplicacións e flúe de forma asíncrona.

Precísanse licenzas premium?

Non. Mentres que ALM require Dataverse (ou Dynamics 365 for Customer Engagement), non é necesario o uso de conectores premium. A única advertencia é se está a usar o conector de Dataverse para interactuar con variables de contorno como faría con outros rexistros de datos como contas ou contactos. Anteriormente esta era a única forma de usar variables de contorno en aplicacións de lenzo e fluxos.

Hai un límite no número de variables de contorno que podo ter?

Non. Non obstante, o tamaño máximo dunha solución é de 120 MB. Máis información: Crea unha solución

Pódense localizar nomes e descricións de variables de contorno?

Si.

Debo usar variables de contorno en lugar de almacenar datos de configuración en táboas personalizadas?

Si, se os seus datos de configuración non teñen relación. As variables de contorno deben usarse para os pares clave: valor e cando o valor probablemente sexa diferente noutros contornos. Outras ferramentas como a utilidade de migración de configuración son máis axeitadas para a migración de datos de configuración relacional almacenados dentro de táboas personalizadas. A diferenza doutros datos de configuración, as variables de contorno migran dentro das solucións e, polo tanto, son moito máis sinxelas de administrar e máis eficientes de importar.

Por que se asigna automaticamente un valor de conexión diferente ao que quero ao importar?

Nalgúns casos nos que hai varias conexións dispoñibles para unha única variable de ambiente (tipo fonte de datos), hai unha implementación de deseño para seleccionar a primeira conexión na lista de conexións dispoñibles para a variable de ambiente. Debido a que normalmente só hai unha conexión asociada a unha variable de ambiente, isto non é algo que normalmente deba ser validado. Ademais, cos cambios recentes na visibilidade do valor da variable de ambiente, isto é máis fácil de validar ao importar.

Como elimino un valor dunha variable de contorno?

É posible que queira eliminar o valor dunha variable de contorno da súa solución antes de exportar a solución. Entón, o valor existente permanece no teu ambiente de desenvolvemento, pero non se exporta na solución. Este enfoque permite proporcionar un novo valor ao importar a solución a outro ambiente.

Para eliminar o valor, siga estes pasos:

1. Na solución onde se atopa a variable de contorno, seleccione a variable de contorno para mostrar as propiedades.

2. En Valor actual, seleccione ... > Eliminar desta solución.

   

Podo usar variables de contorno en conectores personalizados?

Si. Compatibilidade da variable de contorno en conectores personalizados

Consulte tamén

Usa as variables de ambiente orixe de datos nas aplicacións de lenzo
Usa variables de ambiente en Power Automate fluxos de nube de solución
Referencia da táboa ou entidade EnvironmentVariableDefinition
Exemplos de API web
Usa as variables de ambiente orixe de datos nas aplicacións Canvas
Usa variables de ambiente en Power Automate fluxos de nube de solución
Use segredos de Azure Key Vault
Compatibilidade da variable de contorno en conectores personalizados
Blog de Power Apps: variables de ambiente dispoñibles na versión preliminar.

Nota

Pode indicarnos as súas preferencias para o idioma da documentación? Realice unha enquisa breve. (teña en conta que esa enquisa está en inglés)

Esta enquisa durará sete minutos aproximadamente. Non se recompilarán datos persoais (declaración de privacidade).