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, SharePoint Os parámetros de sitios e listas en liña pódense almacenar como variables de ambiente. 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 pódense utilizar como entradas cando se crean aplicacións de lenzo, Power Automate fluxos, complementos e se engaden Power BI paneles de control ás 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. Inicie sesión en Power Apps (make.powerapps.com) e, a continuación, seleccione Solucións no panel esquerdo. Se o elemento non está no panel do panel lateral, selecciona …Máis e, a continuación, selecciona o elemento que desexes.
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 a información que non está na conexión necesaria para conectar Power Apps ao servidor e á táboa correctos. 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.

     • Se o tipo seleccionado é Segredo , é necesaria información adicional para configurar e configurar Azure Key Vault para permitir que Power Platform acceda 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 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.

Power Apps pode crear automaticamente variables de ambiente

Na pestana Xerais de Power Apps configuración:

• 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 de forma nativa a 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 utilizas unha táboa externa dun entorno diferente (a través de Cambiar o entorno), Power Apps asume que queres facer referencia sempre á mesma táboa. Necesitas unha variable de ambiente se necesitas que esa táboa externa sexa unha táboa externa diferente cando pasas de dev a proba ou a prod. O 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ó admite Microsoft Entra conexións. Polo tanto, para SharePoint, ademais dunha conexión válida, é necesaria unha variable de ambiente separada para o Sitio e a Lista.

Para usar 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 de SharePoint deben ter metadatos coincidentes. SharePoint ten identificadores internos que poden non coincidir entre os ambientes de 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 SharePoint sitio e o copias no teu contorno de destino.

SQL Server

SQL Server admite moitos tipos diferentes de autenticación e conexións. Usa variables de ambiente para Microsoft Entra conexións. 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 use variables de ambiente para conexións compartidas, como a autenticación básica de SQL con SQL Server. Use referencias de conexión para a información que tradicionalmente se pasa como parte da cadea de conexión. Todos os parámetros de autenticación SQL básicos forman parte da cadea de 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 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 se pode derivar o servizo ou a táboa coa que pretende traballar 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 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 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. Aínda que ALM require Dataverse (ou aplicacións de Dynamics 365), 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 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 SharePoint listas 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, introduza o SharePoint URL do sitio 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 nos Power Automate fluxos de solucións de nube
Referencia da táboa/entidade EnvironmentVariableDefinition
Mostras da API web
Utilizar variables de ambiente da fonte de datos en aplicacións Canvas
Utilizar variables de ambiente nos Power Automate fluxos da nube de solucións
Utilizar segredos de Azure Key Vault
Compatible con variables de ambiente nos conectores personalizados
Power Apps B;