Variables d'entorn per a una Power Platform visió general

Les variables d'entorn permeten l'escenari bàsic de gestió del cicle de vida de l'aplicació (ALM) de moure una aplicació entre Power Platform entorns. En aquest escenari, l'aplicació es manté exactament igual excepte per algunes referències clau d'aplicacions externes (com ara taules, connexions i claus) que són diferents entre l'entorn d'origen i l'entorn de destinació. L'aplicació requereix que l'estructura de les taules o connexions sigui exactament la mateixa entre l'entorn d'origen i el de destinació, amb algunes diferències. Les variables d'entorn us permeten especificar quines d'aquestes diferents referències externes s'han d'actualitzar a mesura que l'aplicació es mou entre entorns.

Les variables d'entorn emmagatzemen les claus i els valors de paràmetre, que serveixen d'entrada a diversos altres objectes de l'aplicació. Separar els paràmetres dels objectes de consum permet canviar els valors dins del mateix entorn o quan migreu solucions a altres entorns. L'alternativa és deixar els valors de paràmetre codificats de forma rígida dins dels components que els utilitzen. Aquest enfocament sovint és problemàtic; especialment quan els valors s'han de canviar durant les operacions ALM. Com que les variables d'entorn són components de la solució, podeu transportar les referències (claus) i canviar els valors quan les solucions es migren a altres entorns.

Beneficis de l'ús de les variables d'entorn:

• Proporcioneu nous valors de paràmetres mentre importeu solucions a altres entorns.
• Emmagatzema la configuració de les fonts de dades utilitzades en aplicacions i fluxos de llenç. Per exemple, SharePoint els paràmetres de llocs i llistes en línia es poden emmagatzemar com a variables d'entorn. Aquest enfocament us permet connectar-vos a diferents llocs i llistes en diferents entorns sense necessitat de modificar les aplicacions i els fluxos.
• Empaqueteu i transporteu conjuntament la personalització i la configuració i gestioneu-les en una única ubicació.
• Secrets de transport i paquet, com ara les credencials utilitzades per diferents components, per separat dels components que els utilitzen.
• Una variable d'entorn es pot utilitzar en molts components de la solució diferents, tant si són del mateix tipus de component o diferents. Per exemple, una aplicació de llenç i un flux poden utilitzar la mateixa variable d'entorn. Quan el valor de la variable d'entorn ha de canviar, només haureu de canviar un valor.
• A més, si necessiteu retirar una font de dades en entorns de producció, podeu actualitzar els valors de les variables d'entorn amb informació per a la nova font de dades. Les aplicacions i els fluxos no requereixen modificacions i comencen a utilitzar la nova font de dades.
• Amb el suport de SolutionPackager i les eines DevOps permeten la integració contínua i el lliurament continu (CI/CD).
• Les variables d'entorn es poden desempaquetar i emmagatzemar en el control d'origen. També podeu emmagatzemar diferents fitxers de valors de variables d'entorn per a la configuració separada necessària en diferents entorns. L'empaquetador de solucions pot acceptar el fitxer corresponent a l'entorn al qual s'importa la solució.

Com funcionen les variables d'entorn?

Les variables d'entorn es poden crear i modificar dins de la interfície de la solució moderna. També es poden crear automàticament quan es connecta a determinades fonts de dades en aplicacions de llenç o amb codi. També es poden importar a un entorn mitjançant solucions. Les variables d'entorn es poden utilitzar com a entrades per crear aplicacions de llenç, Power Automate fluxos, complements i afegir Power BI escriptoris digitals a aplicacions basades en models. Quan utilitzeu variables d'entorn, els valors es deriven de les variables d'entorn i es poden canviar quan s'importen solucions a altres entorns.

Crear manualment una variable d'entorn en una solució

1. Inicieu sessió a Power Apps (make.powerapps.com) i, a continuació, a la subfinestra esquerra, seleccioneu Solucions. Si l'element no és a la subfinestra del tauler lateral, seleccioneu ... Més i seleccioneu l'element que vulgueu.
2. Obriu la solució que vulgueu o creeu-ne una de nova.
3. A la barra d'ordres, seleccioneu Crea>més i, a continuació, seleccioneu Variable d'entorn.
4. A la subfinestra dreta, completeu les columnes següents i, a continuació, seleccioneu Desa:

   • Nom de visualització. Introduïu un nom per a la variable d'entorn.

   • Nom. El nom únic es genera automàticament a partir del nom de visualització, però podeu canviar-lo.

   • Tipus de dades. Seleccioneu entre Nombre decimal, Text, JSON, Dues opcions, Font de dades o Secret.

     Nota

     • Si la font de dades és el tipus seleccionat, heu de seleccionar el connector, una connexió vàlida per al connector seleccionat i el tipus deparàmetre. La connexió no s'emmagatzema com a part de la variable d'entorn. La variable d'entorn emmagatzema informació que no està a la connexió que és necessària per connectar-se Power Apps al servidor i a la taula correctes. La connexió només s'utilitza per recuperar els valors de paràmetre disponibles com ara els llocs del SharePoint als què teniu accés o les llistes associades amb un lloc.

     • Si Secret és el tipus seleccionat, es necessita informació addicional per configurar l'Azure Key Vault per permetre Power Platform l'accés al secret.

   • Valor actual. També es coneix com el valor. Aquesta propietat és opcional i forma part de la taula de valors variables d'entorn. S'utilitza un valor definit encara que també hi hagi un valor per defecte. Suprimiu el valor de la solució si no voleu utilitzar-la a l'entorn següent. Els valors també se separen en fitxers JSON diferents dins del fitxer solution.zip exportat i es poden editar fora de línia. Més informació: Com puc suprimir un valor d'una variable d'entorn?

   • Valor per defecte. Aquesta columna forma part de la taula de definició de variables d'entorn i no és necessària. El valor per defecte s'utilitza si no hi ha cap valor actual.

     La separació del valor per defecte i el valor actual us permet subministrar la definició i el valor per defecte per separat del valor. Per exemple, un editor d'aplicacions pot incloure la seva oferta amb AppSource un valor per defecte. A continuació, opcionalment, el client pot proporcionar un valor nou. Quan l'editor de l'aplicació publica actualitzacions a l'aplicació, el valor definit pel client no se sobreescriu.

     

     Nota

     Un valor no pot existir sense una definició. La interfície només permet la creació d'un valor per definició.

Power Apps pot crear automàticament variables d'entorn

A la pestanya General de Power Apps la configuració:

• Activeu l'opció Crea automàticament variables d'entorn en afegir fonts de dades. Ara, quan afegiu una font de dades nova a l'aplicació, s'afegeix una variable d'entorn.

  

Diferents fonts de dades

Diferents fonts de dades permeten diferents tipus de variables d'entorn.

Microsoft Dataverse

Power Apps es connecta de forma nativa a Dataverse. No necessiteu una variable d'entorn per a les taules del vostre entorn actual. Quan us connecteu Dataverse, l'aplicació cerca automàticament exactament el mateix nom de taula en qualsevol entorn que la porteu. Sempre que l'estructura del nom de la taula sigui la mateixa a l'entorn de destinació que a l'entorn original, funciona.

Si utilitzeu una taula externa d'un entorn diferent (a través de Canvia l'entorn), Power Apps suposa que voleu fer referència sempre a la mateixa taula. Necessiteu una variable d'entorn si necessiteu que aquesta taula externa sigui una taula externa diferent quan passeu de dev a test o a prod. És més fàcil permetre crear Power Apps automàticament la variable d'entorn. (Si has afegit la taula a l'aplicació, activa l'interruptor de configuració, deixa anar la taula externa i torna-la a afegir).

Quan afegiu la taula externa a l'aplicació, trieu la pestanya Avançat per seleccionar la variable d'entorn.

SharePoint

SharePoint només admet Microsoft Entra connexions. Per tant, a SharePoint més d'una connexió vàlida, es requereix una variable d'entorn separada per al lloc i la llista.

Per utilitzar correctament les variables d'entorn amb SharePoint llistes:

• El nom de visualització i el nom lògic de cada columna corresponent dels entorns d'origen i de destinació han de coincidir.
• Les variables d'entorn han de SharePoint tenir metadades coincidents. SharePoint té identificadors interns que poden no coincidir entre els entorns de destinació. Per exemple, si creeu una llista amb el mateix nom i columnes en un entorn de destinació, els noms interns no coincidiran. Les metadades sempre coincideixen si dupliqueu un SharePoint lloc i el copieu al vostre entorn de destinació.

SQL Server

L'SQL Server admet molts tipus diferents d'autenticació i connexions. Utilitzeu variables d'entorn per a Microsoft Entra les connexions. Es requereix una variable d'entorn separada per al servidor i la base de dades. L'aplicació està vinculada a noms de taula específics, de manera que se suposa que són els mateixos entre entorns.

No utilitzeu variables d'entorn per a connexions compartides, com ara l'autenticació SQL bàsica amb SQL Server. Utilitzeu referències de connexió per a la informació que tradicionalment es passa com a part de la cadena de connexió. Els paràmetres bàsics d'autenticació SQL formen part de la cadena de connexió. Per exemple, el nom del servidor i la base de dades es proporcionen en crear la connexió i, per tant, sempre es deriven de la connexió.

Les variables d'entorn de la font de dades s'utilitzen per a connectors amb autenticació com Microsoft Entra. En aquest tipus de connexions, Power Apps només té un usuari identificat. Power Apps No es pot derivar amb quin servei o taula voleu treballar de la connexió.

Introduïu valors nous mentre importeu solucions

La interfície d'importació de solucions moderna inclou la capacitat d'introduir valors per a les variables d'entorn. Això defineix la propietat value a la environmentvariablevalue taula.

Els valors de les variables d'entorn són visibles quan s'importen solucions o quan s'utilitza Pipelines per implementar. Les variables d'entorn sense un valor per defecte o una sol·licitud de valor per a un valor, però d'altra manera s'emplenen prèviament amb una etiqueta a sota de l'àrea de text que indica l'origen del valor: valor de la solució, valor de l'entorn de destinació o valor per defecte.

Notificacions

Es mostra una notificació quan les variables d'entorn no tenen cap valor. Definiu els valors perquè els components que depenen de les variables d'entorn no fallin.

Seguretat

La environmentvariabledefinition taula és propietat de l'usuari o de l'equip. Quan creeu una aplicació que utilitzi variables d'entorn, assegureu-vos d'assignar als usuaris el nivell de privilegi adequat a aquesta taula. El permís per a la environmentvariablevalue taula s'hereta de la taula principal environmentvariabledefinition i, per tant, no requereix privilegis separats. Els privilegis de environmentvariabledefinition les taules s'inclouen a les funcions de seguretat Creador d'entorns i Usuari bàsic per defecte. Més informació: Seguretat a Dataverse.

Nomenar

Assegureu-vos que els noms de les variables d'entorn siguin únics per poder fer-hi referència amb precisió. Els noms de visualització de les variables d'entorn duplicades fan que les variables d'entorn resultin difícils de diferenciar i utilitzar. Assegureu-vos que els noms de les variables d'entorn siguin únics per poder fer-hi referència amb precisió. Els noms $authentication i $connection són paràmetres especialment reservats per als fluxos i s'han d'evitar. El desament del flux es bloqueja si s'utilitzen variables d'entorn amb aquests noms. Si s'utilitza una variable d'entorn en un flux i es canvia el nom de visualització de la variable d'entorn, el dissenyador mostra els testimonis de nom de visualització antics i nous per ajudar a la identificació. Quan actualitzeu el flux, us recomanem que suprimiu la referència de la variable d'entorn i la torneu a afegir.

Limitacions actuals

• La validació dels valors de variables d'entorn es produeix dins de les interfícies d'usuari i dins dels components que les utilitzen, però no dins del Dataverse. Per tant, assegureu-vos que es defineixin valors correctes si es modifica mitjançant codi.
• Power Platform Les tasques de les eines de compilació encara no estan disponibles per administrar les variables d'entorn de la font de dades. No obstant, això no en bloqueja l'ús dins de les eines proporcionades per Microsoft i dins dels sistemes de control d'origen.
• Interactuar amb variables d'entorn mitjançant codi personalitzat requereix una crida a l'API per obtenir els valors; no hi ha cap memòria cau exposada per a codi que no sigui de Microsoft per utilitzar.
• Les variables d'entorn estan limitades a un màxim de 2.000 caràcters.

Preguntes freqüents

Per què no puc veure el valor de la meva variable d'entorn?

Si la variable d'entorn es troba en una solució administrada, no podreu veure el valor tret que mireu dins de la solució per defecte. Aquest comportament és dissenyat, ja que el valor de la variable d'entorn és una personalització no administrada.

Com puc veure on s'utilitzen variables d'entorn?

Ja sigui seleccionant Mostra les dependències a la interfície de la solució, durant la creació de components, o al control d'origen i al fitxer de la solució, visualitzant les metadades de l'aplicació o del flux.

Les variables d'entorn de font de dades són el mateix que les connexions?

No. Tot i que estan relacionats, una connexió representa una credencial o autenticació necessària per interactuar amb el connector. Les variables d'entorn de font de dades emmagatzemen paràmetres que requereixen una o diverses accions al connector i aquests paràmetres varien sovint en funció de l'acció. Per exemple, una connexió del SharePoint Online no emmagatzema cap informació sobre llocs, llistes o biblioteques de documents. Per tant, cridar el connector requereix una connexió vàlida i alguns paràmetres més.

El meu pipeline ALM automatitzat pot utilitzar diferents fitxers de valors per a diferents entorns?

Sí. L'empaquetador de solucions accepta el nom del fitxer com a paràmetre d'entrada per tal que el pipeline empaqueti un fitxer de valors diferent a la solució en funció del tipus d'entorn en què s'executi.

He d'incloure el valor a la meva solució?

No. Les variables d'entorn estan pensades per ser utilitzades per aplicacions que necessiten tenir valors diferents en diferents entorns on es desplega la solució. Les definicions de variables d'entorn s'han d'incloure a la solució, però els valors s'han de proporcionar per a l'entorn de destinació durant la implementació. Aquest comportament fa que la definició de la variable d'entorn sigui un objecte de solució administrada a l'entorn de destinació, mentre que la variable d'entorn és un registre no administrat.

Per què no puc suprimir un valor del meu entorn?

Si el valor s'ha inclòs en una solució administrada, l'única manera de suprimir-lo és actualitzar la solució a l'entorn d'origen per excloure el valor i, a continuació, exportar una nova versió de la solució. Aquesta nova versió es pot importar a l'entorn mitjançant una operació d'actualització (no una actualització), donant lloc a la supressió del registre de valor.

I si algú suprimeix un valor sense voler?

Si el sistema de dependències encara no ho ha impedit, el temps d'execució utilitza l'últim valor conegut com a alternativa.

Si es canvia un valor, quan s'utilitza el valor nou a les aplicacions de llenç i els fluxos de núvol?

Pot trigar fins a una hora a publicar completament les variables d'entorn actualitzades perquè el valor s'envia a les aplicacions i flueix de manera asíncrona.

Calen llicències prèmium?

No. Tot i que ALM requereix Dataverse (o aplicacions del Dynamics 365), no cal utilitzar connectors premium. L'única excepció és si utilitzeu el connector del Dataverse per interactuar amb variables d'entorn com ho faríeu amb altres registres de dades, com ara comptes o contactes. Anteriorment, aquesta era l'única manera d'utilitzar variables d'entorn a les aplicacions de llenç i els fluxos.

Hi ha un límit en el nombre de variables d'entorn que puc tenir?

No. Tanmateix, la mida màxima d'una solució és de 95 MB. Més informació: Crear una solució

Els noms de visualització i les descripcions de les variables d'entorn es poden localitzar?

Sí.

He d'utilitzar variables d'entorn en comptes d'emmagatzemar dades de configuració a les taules personalitzades?

Sí si les dades de configuració no són relacionals. Les variables d'entorn s'han d'utilitzar per als parells clau:valor i quan el valor probablement ha de ser diferent en altres entorns. Altres eines, com ara la utilitat de migració de configuració, són més adequades per a la migració de dades de configuració relacionals emmagatzemades a les taules personalitzades. A diferència d'altres dades de configuració, les variables d'entorn es migren dins de les solucions i, per tant, són molt més senzilles d'administrar i donen més rendiment a l'hora d'importar.

Per què no es desa la meva connexió per a les variables d'entorn de la font de dades?

Les connexions només s'utilitzen per generar la interfície d'usuari. Per exemple, per recuperar noms descriptius per SharePoint a llistes associades a un lloc web. Quan editeu una variable d'entorn de la font de dades, assegureu-vos de seleccionar una connexió amb accés a la font de dades. Si ja no teniu accés a la connexió, podeu introduir manualment un valor. Per exemple, introduïu l'adreça URL del lloc o l'identificador únic (GUID) d'una SharePoint llista.

Quan hi ha diverses connexions disponibles per a una única variable d'entorn (tipus font de dades), hi ha una implementació per disseny per seleccionar la primera connexió de la llista de connexions. Com que normalment només hi ha una connexió associada amb una variable d'entorn, això no és una cosa que normalment s'hagi de validar. A més, amb els canvis recents en la visibilitat del valor de la variable d'entorn, això és més fàcil de validar en la importació.

Com se suprimeix un valor d'una variable d'entorn?

Potser voldreu suprimir el valor d'una variable d'entorn de la solució abans d'exportar la solució. Aleshores, el valor existent roman a l'entorn de desenvolupament, però no s'exporta a la solució. Aquest mètode permet proporcionar un valor nou en importar la solució a un altre entorn.

Per treure el valor, seguiu aquests passos:

1. A la solució on està situada la variable d'entorn, seleccioneu la variable d'entorn per visualitzar les propietats.

2. A Valor actual, seleccioneu ...>Traieu-lo d'aquesta solució.

   

Puc utilitzar variables d'entorn en connectors personalitzats?

Sí. Suport de variables d'entorn en connectors personalitzats

Consulteu també

Utilitzar variables d'entorn de la font de dades a les aplicacions de llenç
Utilitzar variables d'entorn als Power Automate fluxos de núvol de la solució
Referència d'entitat/taula EnvironmentVariableDefinition
Mostres d'API web
Utilitzeu variables d'entorn de la font de dades a les aplicacions Canvas
Utilitzeu variables d'entorn en Power Automate fluxos de núvol de solucions
Utilitzeu secrets d'Azure Key Vault
Suport de variables d'entorn disponibles a l'entorn de connectors personalitzats
Power Apps B de visualització prèvia de l'entorn!