Definition av variabelbibliotek

Den här artikeln innehåller en uppdelning av definitionsstrukturen för objekt med variabelbibliotek.

Definitionsdelar

I den här tabellen visas definitionsdelarna för variabelbiblioteket.

Definitionsdelssökväg	typ	Krävs	Beskrivning
variables.json	Variabler (JSON)	✅	Beskriver variablerna i objektet
settings.json	VariableLibrarySettings (JSON)	✅	Definiera användarkontrollerade inställningar
.platform	PlatformDetails (JSON)	❌	Beskriver vanlig information om objektet
valueSets\valueSetName.json	ValueSet (JSON)	❌	Definiera standardmallen som ska användas när objektet återges

Variabler

Beskriver variablerna i ett variabelbiblioteksobjekt.

Namn	Typ	Beskrivning
Variabler	Variabel[]	Variabelsamlingen.

Variabel

Beskriver en variabel.

Namn	Typ	Krävs	Beskrivning
namn	Sträng	✅	Namnet på variabeln.
typ	Sträng	✅	Variabeltypen.
värde	JSON	✅	Standardvärdet för variabeln.
not	Sträng	❌	En anteckning som beskriver variabeln.

Variabeltyper som stöds

Lista över variabeltyper som stöds.

Namn	Typ	Exempel
Boolean	BooleanVariable	sant, falskt
Datum och tid	DateTimeVariable	"2025-01-20T15:30:00Z"
Nummer	NumberVariable	1.1
Integer	IntegerVariable	1
Sträng	StringVariable	"Lite sträng"

Variables.json exempel

{
  "$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
    }
  ]
}

ValueSet

Beskriver en värdeuppsättning. Filnamnet måste likna värdeuppsättningens namn.

Namn	Typ	Beskrivning
namn	Sträng	Namn på värdeuppsättningen.
beskrivning	Sträng	Beskrivning av värdeuppsättningen.
variableOverrides	VariableOverride	Lista över åsidosatta variabler.

VariableOverride

Beskriver en åsidosättning av ett värde.

Namn	Typ	Beskrivning
namn	Sträng	Namnet på den åsidosatta variabeln.
värde	Sträng	Det nya variabelvärdet.

valueSets/valueSet.json exempel

{
  "$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 användardefinierade inställningar för variabelbibliotek.

Namn	Typ	Beskrivning
valueSetsOrder	Sträng[]	Valfri lista med värdeuppsättningsnamn för beställning.

settings.json exempel

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

Överväganden och begränsningar

• ValueSetsOrder-listan kan vara tom eller partiell.
• ValueSetsOrder-listan kan inte innehålla ogiltiga värdeuppsättningsnamn.
• När du uppdaterar ett variabelbiblioteksobjekt med ett partiellt eller tomt värdeOrdningslista läggs namn på saknade värdeuppsättningar till i slutet av listan i alfabetisk ordning.

Definitionsexempel

{
"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"
    }
]
}