Definisjon av variabelt bibliotek

Denne artikkelen inneholder en oversikt over definisjonsstrukturen for variable bibliotekelementer.

Definisjonsdeler

Denne tabellen viser definisjonsdelene for variabelbiblioteket.

Definisjonsdelbane type Obligatorisk Beskrivelse
variables.json Variabler (JSON) ✅ Beskriver variablene i elementet
settings.json VariableLibrarySettings (JSON) ✅ Definer brukerkontrollerte innstillinger
.platform PlatformDetails (JSON) ❌ Beskriver vanlige detaljer om elementet
valueSets\valueSetName.json Verdisett (JSON) ❌ Definer standardmalen som skal brukes ved gjengivelse av elementet

Variabler

Beskriver variablene i et variabelbibliotekelement.

Name Type: Beskrivelse
Variabler Variabel[] Variabelsamlingen.

Variabel

Beskriver en variabel.

Name Type: Obligatorisk Beskrivelse
name Streng ✅ Navnet på variabelen.
type Streng ✅ Variabeltypen.
verdi JSON ✅ Standardverdien for variabelen.
notat Streng ❌ Et notat som beskriver variabelen.

Støttede variabeltyper

Liste over støttede variabeltyper.

Name Type: Eksempel
boolsk BoolskVariabel sann, usann
DateTime DateTimeVariable "2025-01-20T15:30:00Z"
Antall NumberVariable 1.1
Heltall Heltallvariabel 1
Streng StringVariable "En streng"
ItemReference ItemReferenceVariable
{
  "workspaceId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbb",
  "itemId": "bbbbbbbb-1111-2222-3333-cccccccccccc"
}

Variables.json eksempel 

{
  "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/variableLibrary/definition/variables/1.0.0/schema.json",
  "variables": [
    {
      "name": "variable1",
      "note": "Some optional note",
      "type": "String",
      "value": "Some string value"
    },
    {
      "name": "variableWithoutNote",
      "type": "boolean",
      "value": true
    }
  ]
}

Verdisett

Beskriver et verdisett. Filnavnet må være likt navnet på verdisettet.

Name Type: Beskrivelse
name Streng Navnet på verdisettet.
beskrivelse Streng Beskrivelse av verdisettet.
variableOverrides VariableOverride Liste over overstyrte variabler.

VariableOverride

Beskriver en verdioverstyring.

Name Type: Beskrivelse
name Streng Navnet på den overstyrte variabelen.
verdi Streng Den nye variabelverdien.

valueSets/valueSet.json eksempel 

{
  "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/variableLibrary/definition/valueSet/1.0.0/schema.json",
  "name": "valueSetName",
  "variableOverrides": [
    {
      "name": "variable1",
      "value": "Some new value"
    }
  ]
}

VariableLibrarySettings

Beskriver brukerdefinerte variabelbibliotekinnstillinger.

Name Type: Beskrivelse
valueSetsOrder String[] Valgfri liste over verdisettnavn for bestilling.

settings.json eksempel 

{
  "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/variableLibrary/definition/settings/1.0.0/schema.json",
  "valueSetsOrder": [
    "valueSet1",
    "valueSet0",
    "someOtherValueSet"
  ]
}

Hensyn og begrensninger

  • ValueSetsOrder-listen kan være tom eller delvis.
  • ValueSetsOrder-listen kan ikke inneholde ugyldige navn på verdisett.
  • Når du oppdaterer et variabelbibliotekelement med en delvis eller tom verdiSetsOrder-liste, legges navn på manglende verdisett til på slutten av listen i alfabetisk rekkefølge.

Definisjonseksempel

{
"parts": [
    {
        "path": "variables.json",
        "payload": "<base64 encoded string>",
        "payloadType": "InlineBase64"
    },
    {
        "path": "valueSet/valueSet1.json",
        "payload": "<base64 encoded string>",
        "payloadType": "InlineBase64"
    },
    {
        "path": "valueSet/valueSet2.json",
        "payload": "<base64 encoded string>",
        "payloadType": "InlineBase64"
    },
    {
        "path": "settings.json",
        "payload": "<base64 encoded string>",
        "payloadType": "InlineBase64"
    },
    {
        "path": ".platform",
        "payload": "ZG90UGxhdGZvcm1CYXNlNjRTdHJpbmc=",
        "payloadType": "InlineBase64"
    }
]
}
  • Last updated on