Salta ai contenuti
AggregaAggrega
Seleziona lingua: Italiano
Questa pagina è stata tradotta automaticamente. Leggi l’originale in inglese.

Schema del catalogo di Aggrega (SchemaLibrary)

Riferimento generato. Non modificarlo a mano — rigeneralo a partire dal JSON Schema pubblicato.

Id dello schema: https://aggrega.ai/schemas/schemalibrary-v1beta1.schema.json

Una raccolta riutilizzabile di definizioni JSON Schema 2020-12 a cui il contenuto del catalogo (Components, Features, ecc.) può fare $ref tramite il riferimento di identità per nome semplice #/schemas/ (la versione è fornita dal file di lock per Release; nessun host di registry compare nel riferimento). Livello 3 — opzionale, per i cataloghi che hanno bisogno di riusare schemi tra un Component e l’altro.

Consulta il riferimento per l’authoring della SchemaLibrary per una guida in prosa sulla scrittura delle entità SchemaLibrary; questa pagina documenta lo schema strutturale descritto da quel riferimento.

Tipo di primo livello: object

Proprietà

ProprietàTipoObbligatoriaDescrizione
apiVersionconst “aggrega.ai/v1beta1”sìCostante: "aggrega.ai/v1beta1"
kindconst “SchemaLibrary”sìCostante: "SchemaLibrary"
metadataobjectsì
specobjectsìIl contenuto della SchemaLibrary. spec.schemas è obbligatorio e deve dichiarare almeno una voce; spec.templates è opzionale ed è presente solo quando la libreria usa helper parametrizzati.

Non sono consentite proprietà aggiuntive.

schemalibrary.metadata

ProprietàTipoObbligatoriaDescrizione
namestringsìIdentificatore PascalCase della libreria. È il nome nel riferimento di identità per nome semplice #/schemas/; la versione è fornita dal file di lock per Release e nessun host di registry entra nel riferimento né in alcun identificatore derivato. Pattern: ^[A-Z][A-Za-z0-9]*$.
versionstringsìVersionamento semantico rigoroso della libreria (ad es. 1.0.0). Il file di lock per Release fissa una versione per libreria. Pattern: ^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$.
descriptionstringnoUn riepilogo conciso di ciò che la libreria copre.
labelsmappa di stringnoEtichette dichiarate dall’autore. Il compilatore è neutrale rispetto ai contenuti e non interpreta i valori delle etichette: sono metadati opachi, portati perché chiunque legga la libreria possa usarli per la corrispondenza.
annotationsmappa di stringnoAnnotazioni dichiarate dall’autore. Stessa impostazione di metadati opachi delle etichette.

Non sono consentite proprietà aggiuntive.

schemalibrary.spec

Il contenuto della SchemaLibrary. spec.schemas è obbligatorio e deve dichiarare almeno una voce; spec.templates è opzionale ed è presente solo quando la libreria usa helper parametrizzati.

ProprietàTipoObbligatoriaDescrizione
schemasmappa di objectsìMappa con nome di definizioni di schema riutilizzabili. Il contenuto di ciascuna voce viene validato dal compilatore della forma compatta in fase di analisi; la validazione a livello di involucro verifica solo l’incapsulamento strutturale. Chiavi: identificatore PascalCase — ^[A-Z][A-Za-z0-9]*$. Le chiavi delle voci compaiono nei riferimenti di identità per nome semplice (<Library>#/schemas/<name>); il vincolo a livello di involucro impedisce che chiavi non PascalCase si propaghino nell’ecosistema del catalogo. Almeno 1 voce.
templatesmappa di objectnoMappa con nome opzionale di helper parametrizzati. Le voci di schema fanno riferimento ai template per nome tramite $instantiate:; solo sostituzione letterale di scalari — nessun template Go incorporato, nessun condizionale, nessun ciclo. Il livello di sostituzione della libreria è intenzionalmente più ristretto di una valutazione completa dei template, così che l’authoring resti nel linguaggio degli schemi anziché introdurre una superficie di templating separata. Chiavi: identificatore PascalCase — ^[A-Z][A-Za-z0-9]*$. Stessa disciplina a livello di involucro delle chiavi delle voci di schema; i nomi dei template vengono referenziati tramite $instantiate: al momento dell’istanziazione.

Non sono consentite proprietà aggiuntive.