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. Això 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.

Nota

Ara s'estan implementant noves capacitats per a les fonts de dades i pot ser que encara no estiguin disponibles a la vostra regió.

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

• Proporcioneu valors de paràmetres nous en importar solucions a altres entorns.
• Emmagatzemeu la configuració de les fonts de dades utilitzades a les aplicacions de llenç i els fluxos. Per exemple, els paràmetres de lloc i llista del SharePoint Online es poden emmagatzemar com a variables d'entorn; per tant, 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.
• La compatibilitat amb les eines del SolutionPackager i el DevOps permet 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ó actual, creada automàticament en connectar-se a certes fonts de dades en aplicacions de llenç o mitjançant codi. També es poden importar a un entorn mitjançant solucions. Un cop les variables d'entorn estan presents en un entorn, es poden utilitzar com a entrades per crear aplicacions de llenç, Power Automate fluxos, quan es desenvolupen complements i molts altres llocs, com ara afegir un Power BI escriptori digital a una aplicació basada en models. Quan aquests tipus d'objectes utilitzen variables d'entorn, els valors es deriven de les variables d'entorn i es poden canviar quan s'importen les solucions a altres entorns.

Crear una variable d'entorn en una solució

1. Inicieu la sessió al Power Apps (make.powerapps.com) i seleccioneu Solucions a la subfinestra esquerra. Si l'element no és a la subfinestra lateral, seleccioneu …Més i, a continuació, seleccioneu l'element que vulgueu.
2. Obriu la solució que vulgueu o creeu-ne una de nova.
3. A la barra d'ordres, seleccioneu Nou > Més i després 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 Font de dades és el tipus seleccionat, també haureu de seleccionar el connector, una connexió vàlida per al connector seleccionat i el tipus de paràmetre. Tanmateix, la connexió no s'emmagatzema com a part de la variable d'entorn. 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. Per a alguns paràmetres, com ara les llistes del SharePoint, també haureu de seleccionar una variable d'entorn de la font de dades principal, com ara el lloc del SharePoint. Un cop desats, es relacionaran a la base de dades.
     • Si Secret és el tipus seleccionat, es necessita informació addicional per configurar Azure Key Vault per permetre al Power Platform accedir 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. Quan hi ha un valor, s'utilitza, fins i tot si també hi ha 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 se suprimeix 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ó.

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 de valor de la taula environmentvariablevalue.

A partir d'una actualització del 7 de desembre de 2023, tots 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 o valor per defecte se'ls demanarà un valor, però les que d'altra manera s'omplen prèviament amb una etiqueta sota l'àrea de text que indica l'origen del valor: valor de la solució, valor de l'entorn de destinació o valor per defecte.

Nota

• En alguns casos, per a valors específics de variables d'entorn de font de dades, pot aparèixer un advertiment d'accés denegat si el creador importador no té accés a la connexió o a la font utilitzada per a la variable d'entorn. Aquest és un advertiment de no bloqueig, però cal tenir en compte en funció de com tingueu previst utilitzar la variable d'entorn a l'entorn de destinació.
• Podeu suprimir el valor de la solució abans d'exportar la solució. D'aquesta manera, el valor existent es mantindrà a l'entorn de desenvolupament, però no s'exportarà a la solució. Aquest mètode permet proporcionar un valor nou en importar la solució a altres entorns. Més informació: Com se suprimeix un valor d'una variable d'entorn?

Notificacions

Es mostra una notificació quan les variables d'entorn no tenen cap valor. Això és un recordatori per definir els valors per tal que els components que depenen de les variables d'entorn no donin error.

Seguretat

La taula environmentvariabledefinition és propietat de l'usuari o 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 taula environmentvariablevalue s'hereta de la taula principal environmentvariabledefinition i, per tant, no necessita privilegis diferents. Els privilegis de les taules environmentvariabledefinition s'inclouen per defecte a les funcions de seguretat del Creador de l'entorn i l'Usuari bàsic. Més informació: Seguretat al 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.
• Les tasques Power Platform Build Tools encara no estan disponibles per gestionar variables d'entorn de 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.
• 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 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?

Seleccionant Mostra les dependències a la interfície de la solució, mentre es creen els components, o bé 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, trucar al connector requereix una connexió vàlida i alguns paràmetres addicionals.

Les variables d'entorn de font de dades es poden utilitzar amb connexions compartides, com ara SQL Server amb l'autenticació SQL?

Normalment no. Les connexions compartides amb l'SQL Server emmagatzemen els paràmetres necessaris per connectar les dades amb la 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 que depenen de l'autenticació basada en l'usuari, com ara Microsoft Entra ID perquè els paràmetres no es poden derivar de la connexió. Per a aquestes raons, l'autenticació amb l'SQL Server, que és una connexió compartida, no utilitzarà les variables d'entorn de la font de dades.

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.

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. Si bé l'ALM necessita el Dataverse (o el Dynamics 365 for Customer Engagement), l'ús de connectors prèmium no és necessari. 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è s'assigna automàticament un valor de connexió diferent del que vull assignar automàticament en importar?

En alguns casos en què 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 disponibles per a la variable d'entorn. 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 ... > Suprimeix 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 de taula/entitat EnvironmentVariableDefinition
Mostres de l'API web
Utilitzar variables d'entorn de la font de dades a les aplicacions del llenç
Utilitzar variables d'entorn als Power Automate fluxos de núvol de la solució
Utilitzar secrets de l'Azure Key Vault
Suport de variables d'entorn en connectors personalitzats
Bloc del Power Apps: variables d'entorn disponibles a la versió preliminar

Nota

Ens podeu dir quines són les vostres preferències d'idioma per a la documentació? Responeu una breu enquesta. (tingueu en compte que l'idioma de l'enquesta és l'anglès)

Trigareu uns set minuts a completar l'enquesta. No es recopilen dades personals (declaració de privadesa).