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. Este enfoque adoita ser 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.

Vantaxes do uso de variables de ambiente:

• Proporciona novos valores de parámetro mentres importas solucións a outros ambientes.
• Almacenar a configuración das fontes de datos utilizadas en aplicacións e fluxos de lenzo. Por exemplo, os parámetros do sitio e da lista de SharePoint Online poden almacenarse como variables de entorno. Este enfoque permítelle conectarse a diferentes sitios e listas en diferentes ambientes 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 unha fonte de datos en contornos de produción, pode actualizar os valores das variables de ambiente con información para a nova fonte de datos. As aplicacións e os fluxos non requiren modificación e comezan a usar a nova fonte de datos.
• As ferramentas compatibles con SolutionPackager e DevOps permiten a integración continua e a entrega continua (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 ambiente pódense crear e modificar dentro da interface de solución moderna. Tamén se poden crear automaticamente ao conectarse a determinadas fontes de datos en aplicacións de lenzo ou con código. Tamén se poden importar a un ambiente a través de solucións. As variables de ambiente poden usarse como entradas ao crear aplicacións canvas, fluxos de Power Automate, complementos e engadir paneis de Power BI a aplicacións baseadas en modelos. Cando usa variables de ambiente, os valores derívanse a partir das variables de ambiente e pódense cambiar cando se importan solucións a outros ambientes.

Crea manualmente unha variable de ambiente nunha solución

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

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

   • Nome. O nome único xérase automaticamente a partir do Nome para mostrar, pero podes cambialo.

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

     Nota

     • Se a Fonte de datos é o tipo seleccionado, cómpre seleccionar o conector, unha conexión válida para o conector seleccionado e o tipo de parámetro . A conexión non se almacena como parte da variable de ambiente. A variable de ambiente almacena información que non está na conexión necesaria para conectar Power Apps ao servidor e á mesa axeitados. A conexión úsase só para recuperar valores de parámetros dispoñibles como os sitios de SharePoint aos que tes acceso ou as listas asociadas a un sitio.
     • Se Secret é o tipo seleccionado, é necesaria información adicional para configurar e configurar Azure Key Vault que permita 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. Utilízase un valor definido 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 quito un valor dunha variable de ambiente?

   • Valor predeterminado. 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 podería listar a súa oferta en Marketplace 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.

Power Apps pode crear automaticamente variables de ambiente

Na pestana Xeral da configuración Power Apps:

• Activa a opción Crear automaticamente variables de ambiente ao engadir fontes de datos . Agora, cando engades unha nova fonte de datos á túa aplicación, esta engade unha variable de ambiente para ti.

  

Diferentes fontes de datos

As diferentes fontes de datos permiten diferentes tipos de variables de ambiente.

Microsoft Dataverse

Power Apps conéctase nativamente con Dataverse. Non precisa unha variable de ambiente para as táboas do seu contorno actual. Cando te conectas a Dataverse, a túa aplicación busca automaticamente exactamente o mesmo nome de táboa en calquera ambiente que o portes. Sempre que a estrutura do nome da táboa sexa a mesma no ambiente de destino que no ambiente orixinal, funciona.

Se usas unha táboa externa dun entorno diferente (a través de Change Environment), entón Power Apps asume que queres referirte sempre á mesma táboa exacta. Necesitas unha variable de ambiente se precisas que esa táboa externa sexa diferente cando pasas de dev a test ou a prod. É máis sinxelo permitir que Power Apps cree automaticamente a variable de ambiente para ti. (Se engadiches previamente a táboa á túa aplicación, activa o interruptor de configuración, solta a táboa externa e engádea de novo.)

Cando engadas a táboa externa á túa aplicación, escolla a pestana Avanzado para seleccionar a variable de ambiente.

SharePoint

SharePoint só soporta conexións Microsoft Entra. Así, para SharePoint, ademais dunha conexión válida, é necesaria unha variable de ambiente separada para Site e List.

Para usar con éxito variables de ambiente con listas de SharePoint:

• O nome para mostrar e o nome lóxico de cada columna correspondente nos contornos orixe e destino deben coincidir.
• As variables de ambiente para SharePoint deben ter metadatos correspondentes. SharePoint ten identificadores internos que poden non coincidir entre os entornos destino. Por exemplo, se crea unha lista co mesmo nome e columnas nun ambiente de destino, os nomes internos non coincidirán. Os metadatos sempre coinciden se duplicas un sitio de SharePoint e o copias ao teu entorno obxectivo.

SQL Server

SQL Server soporta moitos tipos diferentes de autenticación e conexións. Usa variables de ambiente para as conexións Microsoft Entra. Requírese unha variable de ambiente separada para o servidor e a base de datos. A aplicación está ligada a nomes de táboa específicos polo que se supón que son os mesmos entre os ambientes.

Non uses variables de ambiente para conexións compartidas como a autenticación SQL básica con SQL Server. Usa referencias de conexión para información que tradicionalmente se pasa como parte da connection string. Os parámetros básicos de autenticación SQL forman parte da connection string. 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 do entorno da fonte de datos úsanse para conectores con autenticación como Microsoft Entra. Neste tipo de conexións, Power Apps só ten un usuario identificado. Power Apps non pode deducir que servizo ou táboa queres empregar a partir da conexió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 establece a propiedade de valor na táboa environmentvariablevalue .

Os valores das variables de ambiente son visibles cando se importan solucións ou cando se utilizan Pipelines para implementar. As variables de ambiente sen un valor predeterminado ou un valor solicitan un valor, pero as doutro xeito están preenchidas cunha etiqueta debaixo da área de texto que indica a orixe do valor: valor da solución, valor do contorno de destino ou valor predeterminado.

Nota

• Nalgúns casos, para valores específicos das variables de ambiente da fonte de datos, pode aparecer unha advertencia Acceso denegado se o creador da importación non ten acceso á conexión ou á fonte utilizada para a variable de ambiente. Esta é unha advertencia sen bloqueo, pero é algo que debes ter en conta dependendo de como planeas usar a variable de ambiente no ambiente de destino.
• Podes eliminar o valor da túa solución antes de exportar a solución. Isto garante que o valor existente permaneza no teu ambiente 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 quito un valor dunha variable de ambiente?

Notificacións

Aparecerá unha notificación cando as variables de ambiente non teñan ningún valor. Establece os valores para que os compoñentes dependentes das variables de ambiente non fallen.

Seguranza

A environmentvariabledefinition táboa é propiedade do usuario ou do 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 environmentvariablevalue táboa hérdase da táboa environmentvariabledefinition nai e, polo tanto, non require privilexios separados. Os privilexios para environmentvariabledefinition táboas inclúense nos roles de seguranza Environment Maker e Usuario básico de forma predeterminada. Máis información: Seguridade 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 reservados especialmente para 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.
• Power Platform As tarefas de ferramentas de compilación aínda non están dispoñibles para xestionar as variables de ambiente da fonte 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.
• 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á nunha solución xestionada, 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?

Xa sexa seleccionando Mostrar dependencias na interface da solución, mentres se crean compoñentes, ou no control de fontes e no ficheiro de solución ao ver os metadatos da aplicación ou do 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 SharePoint Online non almacena ningunha información sobre sitios, listas ou bibliotecas de documentos. Polo tanto, chamar ao conector require tanto unha conexión válida como algúns parámetros máis.

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.

Debo incluír o valor na miña solución?

Non. As variables de ambiente están destinadas a ser utilizadas por aplicacións que precisan ter valores diferentes en diferentes ambientes onde se desprega a solución. As definicións das variables de ambiente deben incluírse na súa solución, pero os valores deben proporcionarse para o ambiente de destino durante a implantación. Este comportamento fai que a definición da variable de ambiente sexa un obxecto de solución xestionada no ambiente de destino mentres que a variable de ambiente é un rexistro non xestionado.

Por que non podo eliminar un valor do meu entorno?

Se o valor se incluíu nunha solución xestionada, o único xeito de eliminar o valor é actualizar a solución no contorno de orixe para excluír o valor e, a continuación, exportar unha nova versión da solución. Esta nova versión pódese importar ao contorno mediante unha operación de actualización (non unha actualización), polo que se elimina o rexistro de valor.

E se alguén elimina un valor sen querer?

Se o sistema de dependencias non o evita, 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 aplicacións de Dynamics 365), non é necesario usar 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 95 MB. Máis información: Crear 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 non se garda a miña conexión para as variables de ambiente da fonte de datos?

As conexións só se usan para xerar a interface de usuario. Por exemplo, para recuperar nomes amigables para listas de SharePoint asociadas a un sitio. Ao editar unha variable de ambiente da fonte de datos, asegúrese de seleccionar unha conexión con acceso á fonte de datos. Se xa non tes acceso á conexión, podes introducir manualmente un valor. Por exemplo, introduce a URL do sitio de SharePoint ou o identificador único (GUID) dunha lista.

Cando 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. 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, selecciona ...>Eliminar desta solución.

   

Podo usar variables de contorno en conectores personalizados?

Si. Compatibilidade con variables de ambiente en conectores personalizados

Consulte tamén

Usa variables de ambiente da fonte de datos nas aplicacións de lenzo
Usa variables de ambiente en Power Automate fluxo de solución na nube
EnvironmentVariableDefinition táboa/referencia de entidade
Web API Exemplos
Usar variables de entorno da fonte de datos nas aplicacións Canvas
Usar variables de ambiente en fluxos de nube de solución Power Automate
Usar Azure Key Vault secrets
Soporte de variables de ambiente en conectores personalizados
Power Apps Blog: Variables de ambiente dispoñibles en previsualización!