Værdisæt i variabelbiblioteker

Værdisæt i et variabelbibliotek giver alternative sæt af værdier for de definerede variable, der understøtter scenarier som miljøspecifikke konfigurationer (for eksempel udvikling, test, produktion), A/B-test eller datakildeskift inden for samme arbejdsområde.

Hvert værdisæt oprettes som en samling af pegere til standardvariablens værdi, som kan overskrives efter behov. Kun ét værdisæt kan være aktivt ad gangen for et givent arbejdsområde, og brugere kan nemt skifte det aktive sæt via UI eller API.

Værdisæt er unikt navngivne inden for biblioteket og kan omdøbes, omarrangeres (kun via git eller opdateringen med definitions-API'en) eller slettes (med sikkerhedsforanstaltninger for at forhindre sletning af det aktive sæt uden omfordeling). Systemet sporer ændringer og håndhæver størrelsesgrænser for at sikre ydeevne, og enhver ændring af værdisæt valideres før gemning. Denne struktur muliggør robust konfigurationsstyring, så udviklere kan automatisere implementeringer og opretholde konsistens på tværs af flere miljøer og faser.

Struktur og implementering af værdisæt

Variabelbibliotekets definition er struktureret til at understøtte flere værdisæt. I elementets skema (dets JSON-definition) er alle variabler og deres standardværdier listet i en primær sektion (ofte kaldet "Default values"-filen i Git). Hvert ekstra værdisæt gemmes som en separat enhed (eller fil), der kun indeholder de variabler, der adskiller sig fra standarden. Med andre ord, hvis en variabels værdi i et givet værdisæt er den samme som standardværdien, gentages den ikke eksplicit i definitionen af det værdisæt.

• Standardværdisæt: Altid præsenteret og indeholder hver variabels baseline-værdi (sammen med metadata som navn og type). Standardværdifilen opregner alle variabler med deres standard (primære) værdier.

• Alternativt værdisæt: For hvert ekstra værdisæt (for eksempel et "Test" eller "Prod" værdisæt) oplister definitionen kun de variable, hvor værdien tilsidesætter standardværdien. Hvis en variabel ikke er opført i en bestemt værdimængdefil, bruger den implicit standardværdien for det sæt.

Eksempel: Hvis du har en variabel ConnectionString med standardværdien "dev-server", og du opretter et "Production"-værdisæt, der overskriver dette til "prod-server", vil standarddefinitionen have ConnectionString = "dev-server", og filen i "Production"-værdisættet vil indeholde ConnectionString = "prod-server" (og intet for variabler, der forbliver uændrede). Denne tilgang holder værdisætdefinitionerne slanke og fremhæver kun forskellene.

Versionskontrolrepræsentation

I Fabrics Git-integration oversættes ovenstående skema til flere filer under Variable Library-mappen. Designet er hvert værdisæt serialiseret til sin egen JSON-fil (opkaldt efter værdisættet), der indeholder dets overrides, adskilt fra standardværdifilen. For eksempel kan et VL-element "MyVars" have:

MyVars_Default.json – alle variables standardværdier. MyVars_Prod.json – kun variabler med forskellige værdier for "Prod"-stadiet. MyVars_Test.json – kun variabler med forskellige værdier for "Test"-stadiet.

Denne klare adskillelse betyder, at du kan spore ændringer i hvert miljøs konfiguration uafhængigt i versionsstyringen.

Vigtigt er det, at valget af aktive værdisæt ikke er en del af disse definitionsfiler – det gemmes som item state (en arbejdsområde-indstilling), så udrulning eller import af elementet ikke overskriver hvilket værdisæt, der aktuelt er aktivt i et givent arbejdsområde. (Mere om aktive værdisæt nedenfor.)

Skema og datatyper

Værdisæt introducerer ikke nye datatyper; de indeholder værdier af samme type defineret af hver variabel. Itemdefinitionen registrerer hver variabels navn, type, standardværdi og valgfri note. Komplekse variabeltyper som Item reference har strukturerede skemaer (lagring af ID'er), men disse værdier repræsenteres i hvert værdisæt ved hjælp af en konsistent JSON-struktur (for eksempel gemmer en item reference workspace ID + item ID for det pågældende trins element). Alle værdisætfiler følger samme skemastruktur som standarden: i bund og grund en kortlægning af variabelnavne til sættets værdier (kun inklusive dem, der afviger fra standarden).

Navngivningskonventioner for værdisæt

Navnet på en værdi, der sættes i et variabelbibliotek, skal følge disse konventioner:

• Er ikke tom
• Har ikke foranstillede eller bageste mellemrum
• Starter med et bogstav eller et understregningstegn
• Kan indeholde bogstaver, tal, understregningstegn og bindestreger
• Ikke længere end 256 tegn

Når en variabel har en defineret værdi, vises en samtykkedialogboks, hvis du forsøger at ændre dens type. Dialogboksen advarer dig om, at alle variabelværdierne nulstilles, og at denne ændring kan være en ubegrænsende ændring på forbrugervaresiden.

Overvejelser og begrænsninger

Begrænsninger for alternative værdisæt

• Alternative værdisæt i et variabelbibliotek vises i den rækkefølge, du tilføjede dem i. I øjeblikket kan du ikke ændre rækkefølgen af dem i brugergrænsefladen. Hvis du vil ændre rækkefølgen, skal du redigere JSON-filen direkte.
• Navnet på hvert værdisæt skal være entydigt i et variabelbibliotek.
• Variabelnavne skal være entydige i et variabelbibliotek. Du kan have to variabler med samme navn i et arbejdsområde, hvis de er i forskellige elementer.
• Der er altid én (og kun én) aktiv værdi angivet i et variabelbibliotek ad gangen. Du kan ikke slette et værdisæt, mens det er aktivt. Hvis du vil slette den, skal du først konfigurere en anden værdi, der er indstillet til at være aktiv. Du kan have en anden aktiv værdi angivet for hver fase i en udrulningspipeline.