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

Schema del catalogo di Aggrega (MappingLibrary)

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

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

Una raccolta riutilizzabile di frammenti di template Go che Recipes e FeatureRecipes consumano al momento del rendering tramite valuesMapping: { $import: ... }. Livello 3 — opzionale, per i cataloghi che hanno bisogno di riusare mappature tra una Recipe e l’altra. Una sola modalità di authoring: solo template Go.

Consulta il riferimento per l’authoring della MappingLibrary per una guida in prosa sulla scrittura delle entità MappingLibrary; 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 “MappingLibrary”sìCostante: "MappingLibrary"
metadataobjectsì
specobjectsìIl contenuto della MappingLibrary. spec.mappings è obbligatorio e deve dichiarare almeno una voce. spec porta additionalProperties: false — a livello di involucro non sono accettate modalità di authoring parallele. L’impostazione a modalità di authoring unica mantiene uniforme il rendering della Recipe (template Go ovunque) ed evita di costringere gli autori a cambiare modello di valutazione a metà rendering quando consumano frammenti importati.

Non sono consentite proprietà aggiuntive.

mappinglibrary.metadata

ProprietàTipoObbligatoriaDescrizione
namestringsìIdentificatore PascalCase della libreria. È il nome nel riferimento di identità per nome semplice #/mappings/; 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). Un consumatore può indicarlo come soglia minima di versione :<version> opzionale in un riferimento per nome semplice (:#/mappings/); il file di lock per Release detiene la versione risolta. 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.

mappinglibrary.spec

Il contenuto della MappingLibrary. spec.mappings è obbligatorio e deve dichiarare almeno una voce. spec porta additionalProperties: false — a livello di involucro non sono accettate modalità di authoring parallele. L’impostazione a modalità di authoring unica mantiene uniforme il rendering della Recipe (template Go ovunque) ed evita di costringere gli autori a cambiare modello di valutazione a metà rendering quando consumano frammenti importati.

ProprietàTipoObbligatoriaDescrizione
mappingsmappa di stringsìMappa con nome di frammenti di template Go riutilizzabili. Il corpo di ciascuna voce è opaco per la validazione dell’involucro — la semantica del contenuto è gestita dal parser dei template Go al momento del consumo. Chiavi: identificatore PascalCase. Le chiavi delle voci compaiono negli URL di riferimento canonici (#/mappings/<name>); il vincolo a livello di involucro impedisce che chiavi non PascalCase si propaghino nell’ecosistema del catalogo. Pattern: ^[A-Z][A-Za-z0-9]*$. Almeno 1 voce.

Non sono consentite proprietà aggiuntive.