Vides mainīgo pārskats

Piezīme

Stājas spēkā 2020. gada novembrī:

  • Common Data Service ir pārdēvēts par Microsoft Dataverse. Papildinformācija
  • Ir atjaunināta daļa Microsoft Dataverse terminoloģijas. Piemēram, entītija tagad ir tabula un lauks tagad ir kolonna. Papildinformācija

Šis raksts drīz tiks atjaunināts, lai atspoguļotu jaunāko terminoloģiju.

Lietojumprogrammām bieži vien ir nepieciešami dažādi konfigurācijas iestatījumi vai ievades parametri, kas izvietoti dažādās vidēs. Vides mainīgie glabā parametru atslēgas un vērtības, kas pēc tam tiek ievadītas dažādos citos programmas objektos. Atdalot parametrus no patērējošajiem objektiem, varat mainīt vērtības tajā pašā vidē vai, kad migrējiet risinājumus uz citām vidēm. Šī alternatīva satur iekodētās parametru vērtības komponentos, kas tos izmanto. Bieži vien tas ir pārāk sarežģīti; īpaši, ja vērtības ir jāmaina lietojumprogrammas dzīves cikla pārvaldības (ALM) operāciju laikā. Tā kā vides mainīgie ir risinājumu komponenti, varat transportēt atsauces (atslēgas) un mainīt vērtības, kad risinājumi tiek migrēti uz citām vidēm.

Piezīme

Tagad datu avotiem ir pieejamas jaunas iespējas, un tās var vēl nebūt pieejamas jūsu reģionā.

Vides mainīgo izmantošanas priekšrocības:

  • Importējot risinājumus citās vidēs, nodrošiniet jaunas parametru vērtības.
  • Glabājiet pamatnes programmās un plūsmās izmantoto datu avotu konfigurāciju. Piemēram, SharePoint tiešsaistes vietnes un saraksta parametrus var glabāt kā vides mainīgos; tāpēc jums ļauj veidot savienojumu ar dažādām vietnēm un sarakstiem dažādās vidēs, nemodificējot programmas un plūsmas.
  • Iepakojiet un transportējiet pielāgojumus un konfigurāciju kopā un pārvaldiet tos vienā atrašanās vietā.
  • Viens vides mainīgais var tikt izmantots dažādos risinājuma komponentos — neatkarīgi no tā, vai tie ir vienāda tipa vai citādi. Piemēram, pamatnes programma un plūsma var izmantot to pašu vides mainīgo. Ja jāmaina vides mainīgā vērtība, jāmaina tikai viena vērtība.
  • Turklāt, ja vēlaties noņemt datu avotu ražošanas vidēs, varat vienkārši atjaunināt vides mainīgo vērtības ar informāciju par jaunajiem datu avots. Lietojumprogrammām un plūsmām nav nepieciešama modificēšana, un tās sāks lietot jauno datu avotu.
  • rīki SolutionPackager un DevOps nodrošina nepārtrauktu integrēšanu un nepārtrauktu piegādi (CI/CD);
  • Vides mainīgos var neiepakot, un tos var glabāt avota vadīklā. Var arī glabāt dažādus vides mainīgo vērtību failus atsevišķai konfigurācijai, kas nepieciešama dažādās vidēs. Risinājumu pakotnētājs pēc tam var pieņemt videi atbilstošo failu, kurā tiks importēts risinājums.

Kā tie darbojas?

Vides mainīgos var izveidot un modificēt modernā risinājuma interfeisā, kas tiek automātiski izveidoti, izveidojot savienojumu ar noteiktiem datu avotiem pamatnes programmās vai izmantojot kodu. Tos var arī importēt vidē, izmantojot risinājumus. Kad vides mainīgie ir pieejami vidē, tos var izmantot kā ievades datus, autorējot pamatnes programmas, Power Automate plūsmas, izstrādājot spraudņus, kā arī daudzas citas vietas, piemēram, Power BI informācijas paneļa pievienošanu modeļa vadītai programmai. Ja šāda tipa objektos tiek lietoti vides mainīgie, vērtības pēc tam ir atvasinātas no vides mainīgajiem, un tās var mainīt, importot risinājumus citās vidēs.

Vides mainīga izveidošana risinājumā

  1. Pierakstieties Power Apps platformā un kreisajā rūtī atlasiet Risinājumi.
  2. Atveriet risinājumu vai izveidojiet jaunu.
  3. Komandjoslā atlasiet vienumu Jauns un pēc tam atlasiet Vides mainīgais.
  4. Labajā rūtī aizpildiet tālāk norādītās kolonnas un pēc tam atlasiet vienumu Saglabāt:
    • Parādāmais nosaukums. Ievadiet vides mainīgā nosaukumu.

    • Nosaukums. Unikālais nosaukums tiek automātiski ģenerēts no Parādāmā vārda, bet to var mainīt.

    • Datu tips. Atlasiet no Decimāldaļskaitļa, Teksta, JSON, Divas opcijas vai Datu avots.

      Piezīme

      Ja Datu avots ir atlasītais tips, jāatlasa arī savienotājs, derīgs atlasītā savienotāja savienojums un parametra tips. Noteiktiem parametriem, piemēram, SharePoint sarakstiem, ir jāatlasa arī primārās vides datu avots piemēram, SharePoint vietne. Pēc saglabāšanas tie būs saistīti datu bāzē.

    • Pašreizējā vērtība. To sauc arī par vērtību. Šis rekvizīts nav obligāts, un tas ir vides mainīgā tabulas vērtības daļa. Ja šī vērtība ir tajā, tā tiks izmantota arī tad, ja tajā ir noklusējuma vērtība. Noņemiet vērtību no risinājuma, ja nevēlaties to izmantot nākamajā vidē. Šīs vērtības ir arī sadalītas atsevišķos JSON failos eksportētajā solution.zip failā, un tās var rediģēt bezsaistē. Papildinformācija: Kā noņēmt vides mainīgā vērtību?

    • Noklusējuma vērtība. Šī kolonna ir daļa no vides mainīgo definīciju tabulas, un tā nav obligāta. Noklusējuma vērtība tiek lietota, ja tajā nav pašreizējās vērtības.

      Ja tiek mainīta noklusējuma vērtība un pašreizējā vērtība, varat definēt definīciju un noklusējuma vērtību atsevišķi no vērtības. Piemēram, lietojumprogrammas izstrādātājs var uzskaitīt savu piedāvājumu AppSource ar noklusējuma vērtību. Pēc tam klients var norādīt jaunu vērtību. Kad lietojumprogrammas izstrādātājs publicē lietojumprogrammas atjauninājumus, klienta iestatītā vērtība netiks pārrakstīta.

      Jauns vides mainīgais.

      Piezīme

      Vērtība nevar pastāvēt bez definīcijas. Interfeisā vienai definīcijai var izveidot vienu vērtību.

Izmantot datu avota vides mainīgos pamatnes programmās

Izmantot iepriekš esošos datu avota vides mainīgos

Vides mainīgos var atkārtoti lietot citās programmās un pat dažādos resursos, piemēram, mākoņplūsmās. Iespējams, vēlēsities tās vispirms izveidot risinājumā un vēlāk tās izmantot, autorējot pamatnes programmas un mākoņplūsmas.

  1. Veiciet iepriekš minētās darbības, lai risinājumā izveidotu vides mainīgo.
  2. Rediģējiet vai izveidojiet pamatnes programmu no risinājuma.
  3. Pievienot jaunu datu avotu SharePoint online.
  4. Atlasiet cilni Papildu. Tiks parādīts filtrētais vides mainīgo saraksts, kuriem varat piekļūt un kuri atbilst iestatāmajiem parametriem. Piemēram, atlasot SharePoint vietni, tiek parādīts visu datu avota vides mainīgo saraksts, izmantojot Savienotāju = SharePoint un Parametra tipu = Vietne. Tā arī notiek, atlasot SharePoint sarakstus katrai vietnei.
  5. Atlasiet vēlamos vides mainīgos un pēc tam atlasiet vienumu Savienot.

Svarīgi

Ja ir atlasīts vides mainīgais no cita risinājuma, pastāv atkarība no risinājuma, kurā iekļauts vides mainīgais. Tāpēc pārliecinieties, vai:

  • Pirms eksportēšanas savam risinājumam pievienojiet vides mainīgo.
  • Pirms pašreizējā risinājuma importēšanas pārliecinieties, vai risinājums, kurā ir iekļauts vides mainīgais, tiek importēts mērķa vidē.

Automātiska vides mainīgo izveide datu avotu pievienošanas laikā

Šī opcija sniedz vienkāršību un nodrošina, ka vides mainīgie vienmēr tiks izmantoti datu avotiem, piemēram, SharePoint Online režīmā. Tomēr daži klienti dod priekšroku savu shēmas nosaukumu nosaukumā, tādēļ tie ir jāveido, izmantojot risinājumus.

  1. Rediģējiet vai izveidojiet pamatnes programmu no risinājuma.
  2. Atlasiet Fails > Iestatījumi > Papildu iestatījumi un iespējojiet iestatījumu, lai, Pievienojot datu avotus, automātiski izveidotu vides mainīgos.
  3. Pievienot Jaunu datu avotu SharePoint online.
  4. Atlasiet SharePoint vietni, vienu vai vairākus sarakstus un pēc tam atlasiet Savienot.

    Piezīme

    Lai novērstu vides mainīgo dublikātu izveidi, identificējot dublikātus, jums tiks piedāvāts izmantot esošo vides mainīgo. Ja ir nepieciešama dublikāta izveide, varat notīrīt opciju lietot esošo vides mainīgo.

  5. Atlasiet vienumu Saglabāt.

Piezīme

Iepriekš esošas pamatnes lietojumprogrammas automātiski neizmantos datu avota mainīgos. Noņemiet datu avotu no programmas un pievienojiet tās atpakaļ, izmantojot iepriekš minētās darbības, lai jauninātu šīs programmas un lietotu vides mainīgos.

Vides mainīgo izmantošana risinājumu Power Automate mākoņplūsmās

Vides mainīgos var izmantot risinājumu mākoņplūsmās, jo tie ir pieejami dinamiskā satura atlasītāju. Visus vides mainīgo tipus var izmantot aktivizēšanas un darbībās. Lai izmantotu vides mainīgo risinājuma mākoņplūsmā:

  1. Rediģējiet vai izveidojiet mākoņplūsmu risinājumā.

  2. Darbībā vai aktivizētājā nosakiet parametru, ko vēlaties izmantot vides mainīgajam:

    a. Ja parametram nepieciešama vienkārša vērtība, piemēram, virkne vai skaitlis, ievadiet parametru.

    b. Ja parametrs ir uzmeklēšana, ritiniet līdz uzmeklēšanas apakšdaļai un atlasiet vienumu Ievadīt pielāgotu vērtību. Vides mainīgie, kuriem jums ir piekļuve, ir uzskaitīti dinamiskā satura atlasītāja sarakstā ar citu dinamisko saturu. Atlasiet vides mainīgo, ko pievienot mākoņplūsmas aktivizēšanai vai darbībai.

  3. Atlasiet nepieciešamo vides mainīgo.

Jaunu vērtību ievade, importējot risinājumus

Mūsdienīgā risinājumu importēšanas interfeisā ir iekļauta iespēja ievadīt vides mainīgajiem paredzētas vērtības. Šādi tiek iestatīts lauka rekvizīts environmentvariablevalue tabulā.

Piezīme

Pirms risinājuma eksportēšanas varat izņemt vērtību no risinājuma. Šādi tiek nodrošināts, ka esošā vērtība paliks jūsu izstrādes vidē, bet netiks eksportēta risinājumā. Šāda pieeja ļauj sniegt jaunu vērtību, kamēr risinājums tiek importēts citās vidēs. Risinājumu importēšanas laikā jums netiks parādītas jaunas vērtības, ja vides mainīgajiem jau ir noklusējuma vērtība vai vērtība; vai tās ir risinājuma daļa vai tās jau ir pieejamas mērķa vidē. Papildinformācija: Kā noņēmt vides mainīgā vērtību?

Notifikācijas

Ja vides mainīgo vērtības nav norādītas, tiek rādīts paziņojums. Atgādinām, ka jāiestata vērtības, lai no vides mainīgajiem atkarīgie komponenti izdotos.

Drošība

Tabula environmentvariabledefinition pieder lietotājam vai darba grupai. Izveidojot lietojumprogrammu, kurā tiek lietoti vides mainīgie, pārliecinieties, vai šai tabulai tiek piešķirts atbilstošs privilēģijas līmenis. Atļauja uz tabulu environmentvariablevalueir mantota no environmentvariabledefinition primārās tabulas, tādēļ nav nepieciešamas atsevišķas privilēģijas. Papildinformācija: Drošība pakalpojumā Dataverse

Pašreizējie ierobežojumi

  • Patlaban SharePoint Online versija datu avotu atbalsta tikai vides mainīgajiem, kuru tips ir "datu avots" pamatnes programmās. Tomēr Dataverse savienotājs drīz tiks atjaunināts, lai noteiktu, kad nepieciešama savienojamība ar Dataverse vidēm, nevis tikai esošo vidi. Citus vides mainīgos var izmantot pamatnes programmās, izgūstot tos tāpat kā datus, izmantojot Dataverse savienojumu.
  • Ja izmantojat vides mainīgos, lai glabātu SharePoint datu avota parametrus pamatnes programmās, pārliecinieties, vai izmantojat Parādāmo nosaukumu (loģiskā nosaukuma vai ID vietā), izmantojot kolonnu tipus "Uzmeklēšana" vai "Persona vai grupa".
  • Vides mainīgo izmantošana aktivizēšanas ietvaros Power Automate pašlaik tiek atbalstīta tikai ierobežotai savienotāju kopai. Atbalstītie pievienojumaktivizētāji ir SharePoint, Dataverse un SQL server.
  • Ja vides mainīgo vērtības tiek mainītas tieši vidē, nevis ar ALM operāciju, piemēram, risinājumu importēšanu, plūsmas turpinās lietot iepriekšējo vērtību, līdz plūsma tiek saglabāta vai izslēgta un ieslēgta no jauna.
  • Vides mainīgo vērtību validēšana notiek lietotāja interfeisos un to komponentos, bet ne programmā Dataverse. Tāpēc pārliecinieties, vai pareizās vērtības tiek iestatītas, ja tās tiek modificētas, izmantojot kodu.
  • Power Platform Būvēšanas rīku uzdevumi vēl nav pieejami datu avota vides mainīgo pārvaldībai. Tomēr tas nebloķē to izmantošanu Microsoft nodrošinātos rīkos un avota kontroles sistēmās.
  • Mijiedarbojoties ar vides mainīgajiem, izmantojot pielāgotu kodu, ir nepieciešams API izsaukums, lai ienestu vērtības; lai izmantotu šos līdzekļus, trešās puses kodam nav pieejama kešatmiņa.
  • Rediģējot mākoņplūsmu, vides mainīgie tiek rādīti dinamiskā satura atlasītāja sadaļā Parametri, bet tuvākajā laikā tie tiks rādīti zem Vides mainīgo galvenes.
  • Rediģējot mākoņplūsmu, dinamiskā satura atlasītājā rādītie vides mainīgie tiek nefiltrēti, bet turpmāk tie tiks filtrēti pēc datu tipa.
  • Rediģējot mākoņplūsmu, ja vides mainīgais tiek pievienots citā pārlūka cilnē, plūsmas ir atkārtoti jāatver plūsmu noformētājā, lai atsvaidzinātu dinamisko satura atlasītāju.
  • Rediģējot mākoņplūsmu, varētu parādīties vides mainīgais $authentication , kas nav definēts vidē.

Bieži uzdotie jautājumi

Kā varu skatīt, kur tiek izmantoti vides mainīgie?

Vai nu atlasot opciju Rādīt atkarības risinājuma interfeisā, kamēr autorējat komponentus, vai avota vadīklā un risinājuma failā, skatot lietojumprogrammu vai plūsmas metadatus.

Vai datu avots vides mainīgie ir vienādi ar savienojumiem?

Nē. Lai gan tie ir saistīti. Savienojums ir akreditācijas dati vai autentifikācija, kas nepieciešama, lai mijiedarbotos ar savienotāju. Datu avota vides mainīgajos tiek glabāti parametri, kas nepieciešami vienai vai vairākām darbībām savienotājā, un šie parametri bieži vien mainās atkarībā no darbības. Piemēram, SharePoint Online savienojums nesaglabā informāciju par vietnēm, sarakstiem vai dokumentu bibliotēkām. Tāpēc savienojuma izsaukšanai ir nepieciešams gan derīgs savienojums, gan daži papildu parametri.

Vai datu avots vides mainīgos var izmantot koplietojamiem savienojumiem, piemēram, SQL Server ar SQL autentifikāciju?

Parasti nē. Koplietojamie savienojumi, piemēram, SQL Server ar SQL autentificēšanu, glabā parametrus, kas nepieciešami, lai izveidotu savienojumu ar datiem savienojuma ietvaros. Piemēram, veidojot savienojumu, tiek nodrošināts servera un datu bāzes nosaukums, tādēļ tie vienmēr ir atvasināti no savienojuma.

Datu avota vides mainīgie tiek izmantoti savienotājiem, kas izmanto lietotāja autentificēšanu, piemēram, Azure Active Directory, jo parametrus nevar atvasināt no savienojuma. Šo iemeslu dēļ SQL Server ar SQL autentifikāciju, kas ir koplietojams savienojums, neizmantos datu avots vides mainīgos, bet SQL Server ar Azure Active Directory (AAD) autentifikāciju, kas ir personisks savienojums, izmantos.

Vai mans automatizētais ALM konveijers dažādās vidēs var izmantot dažādas vērtības failus?

Jā. Risinājumu pakotnētājs pieņem faila nosaukumu kā ievades parametrus, lai jūsu konveijers atkarībā no vides tipa, ar kuru tas izpilda, var ievietot risinājumā atšķirīgu vērtību failu.

Ko darīt, ja kāds nejauši dzēš kādu vērtību?

Ja sistēma, kas ir atkarīga no atkarības, vēl neļaus, izpildlaiks izmantos pēdējo zināmo vērtību kā atkāpšanās vērtību.

Ja kāda vērtība tiek mainīta, kad jaunā vērtība tiek izmantota pamatnes programmās un mākoņplūsmās?

Pamatnes programmām nākamās sesijas laikā tiks izmantota jaunā vērtība. Piemēram, slēdzot programmu un pēc tam atkal to spēlējot.

Izmantojot mākoņplūsmu, plūsmas pašlaik ir jāatspējo un no jauna jāaktivizē, lai varētu izmantot atjaunināto vērtību.

Vai ir nepieciešamas licences?

Nē. Lai gan ALM ir nepieciešams Dataverse (vai Dynamics 365 for Customer Engagement), nav jāizmanto Premium savienotāji. Šis ir tas, ja izmantojat Dataverse savienotāju, lai mijiedarbotos ar vides mainīgajiem kā ar citiem datu ierakstiem, piemēram, uzņēmumiem vai kontaktpersonām. Iepriekš tas bija vienīgais veids, kā izmantot vides mainīgos pamatnes programmās un plūsmās.

Vai pastāv vides mainīgo skaita ierobežojums, kas man var būt?

Nē. Taču risinājuma maksimālais lielums ir 29 MB.

Vai vides mainīgo parādāmos nosaukumus un aprakstus var lokalizēt?

Jā.

Vai konfigurācijas datu glabāšanas vietā pielāgotās tabulās ir jāizmanto vides mainīgie?

Jā, ja konfigurācijas dati nav saistīti. Galvenos vides mainīgos vajadzētu izmantot: vērtību pāriem un gadījumos, kad vērtībai, visticamāk, ir nepieciešama atšķirīga citās vidēs. Citi rīki, piemēram, konfigurācijas migrācijas utilīta, ir labāk piemēroti attiecību konfigurācijas datu migrācijai, kas tiek glabāti pielāgotās tabulās. Atšķirībā no citiem konfigurācijas datiem vides mainīgie tiek migrēti risinājumos, tādēļ daudz vienkāršāk pārvaldīt un importēt vairāk izpildītāju.

Kā noņemt vides mainīgā vērtību?

Jūs varat vēlēties noņemt vides mainīgā vērtību no risinājuma pirms tā eksportēšanas. Esošā vērtība paliks jūsu izstrādes vidē, bet tā netiks eksportēta risinājumā. Šī metode ļauj nodrošināt jaunu vērtību, importējot risinājumu citā vidē.

Lai noņemtu vērtību, rīkojieties šādi:

  1. Risinājumā, kurā atrodas vides mainīgais, atlasiet vides mainīgo, kas atainos rekvizītus.
  2. Sadaļā Esošā vērtība atlasiet ... > Noņemt no šī risinājuma. Noņemt vērtību no vides mainīgā

Skatiet arī

Power Apps Emuārs: priekšskatījumā pieejamie vides mainīgie!
EnvironmentVariableDefinition tabula/entītijas atsauce
Tīmekļa API paraugi

Pamatnes programmas izveide, izmantojot pakalpojumu Dataverse
Plūsmas izveide, izmantojot pakalpojumu Dataverse