Definice knihovny proměnných

Tento článek obsahuje rozpis struktury definic pro položky knihovny proměnných.

Části definice

Tato tabulka uvádí části definice knihovny proměnných.

Cesta k části definice	typ	Povinné	Popis
variables.json	Proměnné (JSON)	✅	Popisuje proměnné v položce.
settings.json	VariableLibrarySettings (JSON)	✅	Definování nastavení řízených uživatelem
.platform	PlatformDetails (JSON)	❌	Popisuje běžné podrobnosti o položce.
valueSets\valueSetName.json	ValueSet (JSON)	❌	Definování výchozí šablony, která se má použít při vykreslování položky

Proměnné

Popisuje proměnné v položce knihovny proměnných.

Název	Typ	Popis
proměnné	Proměnná[]	Kolekce proměnných.

Proměnná

Popisuje proměnnou.

Název	Typ	Povinné	Popis
název	Řetězec	✅	Název proměnné.
typ	Řetězec	✅	Typ proměnné.
hodnota	JSON	✅	Výchozí hodnota proměnné.
poznámka	Řetězec	❌	Poznámka popisující proměnnou.

Podporované typy proměnných

Seznam podporovaných typů proměnných

Název	Typ	Příklad
logický	Logická hodnotaVariable	pravda, nepravda
Datum a čas	DateTimeVariable	"2025-01-20T15:30:00Z"
Číslo	NumberVariable	1.1
Integer	IntegerVariable	1
Řetězec	StringVariable	"Nějaký řetězec"
ItemReference	ItemReferenceVariable	{   "workspaceId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbbbbbb",   "itemId": "bbbbbbbb-1111-2222-3333-cccccccccc" }

příklad 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
    }
  ]
}

HodnotaSet

Popisuje sadu hodnot. Název souboru musí být podobný názvu sady hodnot.

Název	Typ	Popis
název	Řetězec	Název sady hodnot.
popis	Řetězec	Popis sady hodnot
variableOverrides	VariableOverride	Seznam přepsaných proměnných

VariableOverride

Popisuje přepsání hodnoty.

Název	Typ	Popis
název	Řetězec	Název přepsáné proměnné.
hodnota	Řetězec	Nová hodnota proměnné.

valueSets/valueSet.json example

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

Popisuje uživatelsky definované nastavení knihovny proměnných.

Název	Typ	Popis
valueSetsOrder	Řetězec[]	Volitelný seznam názvů množiny hodnot pro řazení

příklad settings.json

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

Úvahy a omezení

• Seznam ValueSetsOrder může být prázdný nebo částečný.
• Seznam ValueSetsOrder nemůže obsahovat neplatné názvy sad hodnot.
• Při aktualizaci položky knihovny proměnných s částečným nebo prázdným seznamem valueSetsOrder se na konec seznamu v abecedním pořadí přidají chybějící názvy sad hodnot.

Příklad definice

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