Definicja biblioteki zmiennych

Ten artykuł zawiera podział struktury definicji dla elementów biblioteki zmiennych.

Części definicji

W tej tabeli wymieniono części definicji biblioteki zmiennych.

Ścieżka części definicji	rodzaj	Wymagane	Opis
variables.json	Zmienne (JSON)	✅	Opisuje zmienne w elemencie
settings.json	VariableLibrarySettings (JSON)	✅	Definiowanie ustawień kontrolowanych przez użytkownika
.platform	PlatformDetails (JSON)	❌	Opisuje typowe szczegóły elementu
valueSets\valueSetName.json	ValueSet (JSON)	❌	Definiowanie szablonu domyślnego do użycia podczas renderowania elementu

Zmienne

Opisuje zmienne w elemencie Biblioteka zmiennych.

Nazwa	Typ	Opis
Zmiennych	Zmienna[]	Kolekcja zmiennych.

Zmienna

Opisuje zmienną.

Nazwa	Typ	Wymagane	Opis
nazwa	Sznurek	✅	Nazwa zmiennej.
rodzaj	Sznurek	✅	Typ zmiennej.
wartość	JSON (JavaScript Object Notation)	✅	Wartość domyślna zmiennej.
nuta	Sznurek	❌	Notatka opisująca zmienną.

Obsługiwane typy zmiennych

Lista obsługiwanych typów zmiennych.

Nazwa	Typ	Przykład
Boolean	Wartość logicznaVariable	prawda, fałsz
Data i Czas	DateTimeVariable	"2025-01-20T15:30:00Z"
Liczba	Liczba zmienna	1.1
Integer	Liczba całkowita, zmienna	1
Sznurek	StringVariable	"Jakiś ciąg"
ItemReference	ItemReferenceVariable	{   "workspaceId": "aaaaaaa-0000-1111-2222-bbbbbbbb",   "itemId": "bbbbbb-1111-2222-3333-cccccccccc" }

przykład Variables.json

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

Opisuje zestaw wartości. Nazwa pliku musi być podobna do nazwy zestawu wartości.

Nazwa	Typ	Opis
nazwa	Sznurek	Nazwa zestawu wartości.
opis	Sznurek	Opis zestawu wartości.
zmiennePrzesłonięcia	ZmiennaPrzesłoń	Lista przesłonięć zmiennych.

ZmiennaPrzesłoń

Opisuje przesłonięcia wartości.

Nazwa	Typ	Opis
nazwa	Sznurek	Nazwa przesłoniętej zmiennej.
wartość	Sznurek	Nowa wartość zmiennej.

valueSets/valueSet.json przykład

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

Opisuje ustawienia biblioteki zmiennych zdefiniowanych przez użytkownika.

Nazwa	Typ	Opis
valueSetsOrder	String[]	Opcjonalna lista nazw zestawów wartości do porządkowania.

przykład settings.json

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

Zagadnienia i ograniczenia

• Lista ValueSetsOrder może być pusta lub częściowa.
• Lista ValueSetsOrder nie może zawierać nieprawidłowych nazw zestawów wartości.
• Podczas aktualizowania elementu biblioteki zmiennych z częściową lub pustą wartościąSetsOrder brakujące nazwy zestawów wartości są dodawane na końcu listy w kolejności alfabetycznej.

Przykład definicji

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