Definizione della libreria di variabili

Questo articolo fornisce una suddivisione della struttura di definizione per gli elementi della libreria di variabili.

Parti di definizione

Questa tabella elenca le parti di definizione della libreria di variabili.

Percorso della parte di definizione	tipo	Obbligatorio	Descrizione
variables.json	Variabili (JSON)	✅	Descrive le variabili nell'elemento
settings.json	VariableLibrarySettings (JSON)	✅	Definire le impostazioni controllate dall'utente
.platform	PlatformDetails (JSON)	❌	Descrive i dettagli comuni dell'elemento
valueSets\valueSetName.json	ValueSet (JSON)	❌	Definire il modello predefinito da usare durante il rendering dell'elemento

Variabili

Vengono descritte le variabili in un elemento libreria di variabili.

Nome	TIPO	Descrizione
Variabili	Variabile[]	Raccolta di variabili.

Variabile

Descrive una variabile.

Nome	TIPO	Obbligatorio	Descrizione
nome	Stringa	✅	Nome della variabile.
tipo	Stringa	✅	Tipo di variabile.
valore	JSON (JavaScript Object Notation)	✅	Valore predefinito della variabile.
nota	Stringa	❌	Nota che descrive la variabile.

Tipi di variabili supportati

Elenco dei tipi di variabili supportati.

Nome	TIPO	Esempio
Booleano	BooleanVariable	vero, falso
Data e ora	DateTimeVariable	"2025-01-20T15:30:00Z"
Numero	NumberVariable	1.1
Integer	IntegerVariable	1
Stringa	StringVariable	"Alcune stringhe"

esempio di 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

Descrive un set di valori. Il nome del file deve essere simile al nome del set di valori.

Nome	TIPO	Descrizione
nome	Stringa	Nome del set di valori.
descrizione	Stringa	Descrizione del valore impostato.
variableOverrides	VariableOverride	Elenco di variabili sottoposte a override.

VariableOverride

Descrive un override del valore.

Nome	TIPO	Descrizione
nome	Stringa	Nome della variabile sottoposta a override.
valore	Stringa	Nuovo valore della variabile.

esempio di valueSets/valueSet.json

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

Vengono descritte le impostazioni della libreria di variabili definite dall'utente.

Nome	TIPO	Descrizione
valueSetsOrder	String[]	Elenco facoltativo dei nomi dei set di valori per l'ordinamento.

esempio di settings.json

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

Considerazioni e limitazioni

• L'elenco ValueSetsOrder può essere vuoto o parziale.
• L'elenco ValueSetsOrder non può includere nomi di set di valori non validi.
• Quando si aggiorna un elemento della libreria di variabili con un elenco valueSetsOrder parziale o vuoto, i nomi dei set di valori mancanti vengono aggiunti alla fine dell'elenco in ordine alfabetico.

Esempio di definizione

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