변수 라이브러리 정의

2025-04-10

이 문서에서는 변수 라이브러리 항목에 대한 정의 구조의 분석을 제공합니다.

정의 부분

이 표에는 변수 라이브러리 정의 부분이 나열됩니다.

정의 파트 경로	유형	필수	설명
`variables.json`	변수(JSON)	✅	항목의 변수에 대해 설명합니다.
`settings.json`	VariableLibrarySettings(JSON)	✅	사용자 제어 설정 정의
`.platform`	PlatformDetails(JSON)	❌	항목의 일반적인 세부 정보를 설명합니다.
`valueSets\valueSetName.json`	ValueSet(JSON)	❌	항목을 렌더링할 때 사용할 기본 템플릿 정의

변수

변수 라이브러리 항목의 변수에 대해 설명합니다.

이름	유형	설명
변수	Variable[]	변수 컬렉션입니다.

변수

변수를 설명합니다.

이름	유형	필수	설명
이름	문자열	✅	변수의 이름입니다.
유형	문자열	✅	변수 형식입니다.
가치	JSON (자바스크립트 객체 표기법)	✅	변수의 기본값입니다.
메모	문자열	❌	변수를 설명하는 참고 사항입니다.

지원되는 변수 형식

지원되는 변수 형식 목록입니다.

이름	유형	예시
불리언 (Boolean)	BooleanVariable	true, false
날짜와 시간	DateTimeVariable	"2025-01-20T15:30:00Z"
숫자	NumberVariable	1.1
정수	IntegerVariable	1
문자열	StringVariable	"일부 문자열"
ItemReference	ItemReferenceVariable	{ "workspaceId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbbbb", "itemId": "bbbbbbbb-1111-2222-3333-cccccccccccc" }

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

값 집합에 대해 설명합니다. 파일 이름은 값 집합 이름과 유사해야 합니다.

이름	유형	설명
이름	문자열	값 집합의 이름입니다.
설명	문자열	값 집합에 대한 설명입니다.
variableOverrides	VariableOverride	재정의된 변수 목록입니다.

VariableOverride

값 재정의에 대해 설명합니다.

이름	유형	설명
이름	문자열	재정의된 변수의 이름입니다.
가치	문자열	새 변수 값입니다.

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

사용자 정의 변수 라이브러리 설정을 설명합니다.

이름	유형	설명
valueSetsOrder	String[]	순서 지정을 위한 값 집합 이름의 선택적 목록입니다.

settings.json 예제

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

고려 사항 및 제한 사항

ValueSetsOrder 목록은 비어 있거나 부분적일 수 있습니다.
ValueSetsOrder 목록에 잘못된 값 집합 이름을 포함할 수 없습니다.
부분 또는 빈 valueSetsOrder 목록으로 변수 라이브러리 항목을 업데이트하는 경우 누락된 값 집합 이름이 사전순으로 목록 끝에 추가됩니다.

정의 예제

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