Lewati ke konten
AggregaAggrega
Pilih Bahasa: Bahasa Indonesia
Halaman ini diterjemahkan oleh mesin. Baca versi asli dalam bahasa Inggris.

Skema Aggrega Catalog (SchemaLibrary)

Referensi yang dihasilkan. Jangan diedit secara manual — hasilkan ulang dari JSON Schema yang dipublikasikan.

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

Kumpulan definisi JSON Schema 2020-12 yang dapat digunakan ulang, yang dapat dirujuk dengan $ref oleh konten katalog (Components, Features, dll.) melalui referensi identitas nama polos #/schemas/ (versinya disediakan oleh lockfile per Release; tidak ada host registry yang muncul dalam referensi). Tingkat 3 — opsional untuk katalog yang memerlukan penggunaan ulang skema lintas Component.

Lihat referensi penulisan SchemaLibrary untuk panduan prosa tentang penulisan entitas SchemaLibrary; halaman ini mendokumentasikan skema struktural yang dijelaskan oleh referensi tersebut.

Jenis tingkat teratas: object

Properti

PropertiJenisWajibDeskripsi
apiVersionconst “aggrega.ai/v1beta1”yaKonstanta: "aggrega.ai/v1beta1"
kindconst “SchemaLibrary”yaKonstanta: "SchemaLibrary"
metadataobjectya
specobjectyaKonten SchemaLibrary. spec.schemas wajib dan harus mendeklarasikan setidaknya satu entri; spec.templates bersifat opsional dan hanya ada jika library menggunakan helper berparameter.

Properti tambahan tidak diizinkan.

schemalibrary.metadata

PropertiJenisWajibDeskripsi
namestringyaPengenal PascalCase untuk library. Ini adalah nama dalam referensi identitas nama polos #/schemas/; versinya disediakan oleh lockfile per Release dan tidak ada host registry yang masuk ke referensi atau pengenal turunan apa pun. Pola: ^[A-Z][A-Za-z0-9]*$.
versionstringyaSemantic Versioning ketat dari library (misalnya, 1.0.0). Lockfile per Release mem-pin satu versi per library. Pola: ^(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-]+)*))?$.
descriptionstringtidakRingkasan singkat tentang cakupan pustaka.
labelsmap of stringtidakLabel yang dideklarasikan penulis. Compiler netral terhadap konten dan tidak menafsirkan nilai label: label adalah metadata buram, yang dibawa agar apa pun yang membaca library dapat mencocokkan berdasarkan label tersebut.
annotationsmap of stringtidakAnotasi yang dideklarasikan oleh penulis. Pendekatan metadata buram yang sama seperti label.

Properti tambahan tidak diizinkan.

schemalibrary.spec

Konten SchemaLibrary. spec.schemas wajib dan harus mendeklarasikan setidaknya satu entri; spec.templates bersifat opsional dan hanya ada jika library menggunakan helper berparameter.

PropertiJenisWajibDeskripsi
schemasmap of objectyaMap bernama berisi definisi skema yang dapat digunakan ulang. Konten setiap entri divalidasi oleh compiler bentuk ringkas saat parsing; validasi tingkat envelope hanya memeriksa pembungkus struktural. Kunci: pengenal PascalCase — ^[A-Z][A-Za-z0-9]*$. Kunci entri muncul dalam referensi identitas nama polos (<Library>#/schemas/<name>); batasan tingkat envelope mencegah kunci non-PascalCase menyebar melalui ekosistem katalog. Minimal 1 entri.
templatesmap of objecttidakMap bernama opsional berisi helper berparameter. Entri skema merujuk templat berdasarkan nama melalui $instantiate:; hanya substitusi skalar literal — tanpa templat Go tersemat, tanpa kondisional, tanpa perulangan. Lapisan substitusi library sengaja dibuat lebih sempit daripada evaluasi templat penuh agar penulisan tetap berada dalam bahasa skema alih-alih memperkenalkan permukaan templating terpisah. Kunci: pengenal PascalCase — ^[A-Z][A-Za-z0-9]*$. Disiplin tingkat envelope yang sama seperti kunci entri skema; nama templat dirujuk melalui $instantiate: pada saat instansiasi.

Properti tambahan tidak diizinkan.