Freigeben über

Variablenbibliotheksdefinition

Dieser Artikel enthält eine Aufschlüsselung der Definitionsstruktur für Variablenbibliothekselemente.

Definitionsteile

In dieser Tabelle sind die Komponenten der Variablenbibliothekdefinition aufgeführt.

Definitionsteilpfad type Erforderlich BESCHREIBUNG
variables.json Variablen (JSON) ✅ Beschreibt die Variablen im Element.
settings.json VariableLibrarySettings (JSON) ✅ Definieren von benutzergesteuerten Einstellungen
.platform PlatformDetails (JSON) ❌ Beschreibt allgemeine Details des Elements.
valueSets\valueSetName.json ValueSet (JSON) ❌ Definieren der Standardvorlage, die beim Rendern des Elements verwendet werden soll

Variablen

Beschreibt die Variablen in einem Variablenbibliothekselement.

Name Typ BESCHREIBUNG
variablen Variable[] Die Variablenauflistung.

Variable

Beschreibt eine Variable.

Name Typ Erforderlich BESCHREIBUNG
Name Schnur ✅ Der Name der Variablen.
type Schnur ✅ Der Variabletyp.
Wert JSON ✅ Der Standardwert der Variablen.
Anmerkung Schnur ❌ Eine Notiz, die die Variable beschreibt.

Unterstützte Variablentypen

Liste der unterstützten Variablentypen.

Name Typ Beispiel
Boolescher Typ (Boolean) BooleanVariable true, false
Datum/Uhrzeit DateTimeVariable "2025-01-20T15:30:00Z"
Nummer NumberVariable 1.1
Ganze Zahl IntegerVariable 1
Schnur StringVariable "Einige Zeichenfolgen"

beispiel für 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

Beschreibt einen Wertsatz. Der Dateiname muss dem Wertsatznamen ähneln.

Name Typ BESCHREIBUNG
Name Schnur Name des Wertsatzes.
Beschreibung Schnur Beschreibung des Wertsatzes.
variableOverrides VariableOverride Liste der Außerkraftsetzungsvariablen.

VariableOverride

Beschreibt eine Außerkraftsetzung eines Werts.

Name Typ BESCHREIBUNG
Name Schnur Name der Außerkraftsetzungsvariablen.
Wert Schnur Der neue Variablenwert.

valueSets/valueSet.json Beispiel 

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

Beschreibt benutzerdefinierte Variablenbibliothekseinstellungen.

Name Typ BESCHREIBUNG
valueSetsOrder String[] Optionale Liste von Wertsatznamen für die Sortierung.

beispiel für settings.json 

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

Überlegungen und Einschränkungen

  • ValueSetsOrder-Liste kann leer oder teilweise sein.
  • Die ValueSetsOrder-Liste darf keine ungültigen Wertsatznamen enthalten.
  • Beim Aktualisieren eines Variablenbibliothekselements mit einer teilweisen oder leeren ValueSetsOrder-Liste werden fehlende Wertsatznamen am Ende der Liste in alphabetischer Reihenfolge hinzugefügt.

Definitionsbeispiel

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