Bantuan:Portal pewatas atribut
Pewatas atribut adalah kaidah untuk atribut yang menspesifikasi bagaimana suatu atribut semestinya digunakan. Model Wikidata sebetulnya sangat luwes: tidak ada yang menghalangimu untuk menambahkan Universe (Q1) sebagai head of government (P6). Namun, pewatas pada atribut dapat memberitahukan bahwa head of government (P6) biasanya adalah orang.
Pewatas adalah petunjuk, bukan pembatas yang baku, dan dimaksudkan untuk membantu atau memandu penyunting. Ada juga pengecualian, semisal, kota Talkeetna (Q668224) memilih kucing Stubbs (Q7627362) sebagai walikota.
Beberapa tipe pewatas, untuk saat ini one-of constraint dan allowed qualifiers constraint, juga digunakan untuk memberikan saran yang lebih baik ketika menyunting pernyataan.
Note: Technically a property constraint is a statement (on a property) of a particular constraint type, specified via property constraint (P2302). So strictly speaking constraint and constraint type refer to two different things, for the sake of brevity this page however sometimes refers to constraint types simply as constraints.
Tipe pewatas populer
Datatype-independent constraints
Constraints to restrict where a property may be added
- property scope constraint
- Atribut ini seharusnya hanya digunakan untuk jangkauan tertentu (nilai utama dari sebuah pernyataan, dalam referensi, sebagai penjelas).
- allowed-entity-types constraint
- Atribut ini hanya dapat digunakan untuk jenis entitas tertentu. Misal: Wikidata property example (P1855) (atribut-atribut).
- subject type constraint
- Butir dengan atribut ini seharusnya memiliki tipe tertentu. Contoh: Butir dengan date of birth (P569) seharusnya instance of (P31) human (Q5) atau animal (Q729).
- conflicts-with constraint
- Butir dengan atribut ini tidak boleh memiliki atribut atau pernyataan tertentu. Contoh: sex or gender (P21) berkonflik dengan author (P50) yang akhirnya berkonflik dengan instance of (P31)Q5{{{3}}}.
- item-requires-statement constraint
- Butir dengan atribut ini harus memiliki pernyataan tertentu lainnya. Misal, Butir dengan killed by (P157) harus memiliki place of death (P20), date of death (P570), dan manner of death (P1196)homicide (Q149086).
- contemporary constraint
- Butir dengan atribut ini dan nilai untuk atribut ini tidak boleh ada pada waktu yang bersamaan. Contoh: mother (P25), country of citizenship (P27).
- label in language constraint
- Butir yang menggunakan atribut ini seharusnya juga punya label dalam bahasa tertentu. Contohnya, butir dengan Vietnamese middle name (P8500) seharusnya memiliki label berbahasa Vietnam.
- description in language constraint
- Items using this property should also have a description in a certain language.
- lexeme requires language constraint
- Atribut ini seharusnya digunakan di leksem dengan bahasa tertentu. Contohnya, %1 seharusnya digunakan di leksem Catalan (Q7026).
- lexeme requires lexical category constraint
- …
- lexeme-value-requires-lexical-category constraint
- …
Constraints regarding the number of values
- single-value constraint
- Butir seharusnya memiliki tidak lebih dari satu pernyataan dengan atribut ini. Biasanya digunakan untuk penanda, tetapi juga oleh atribut lainnya: contohnya, orang-orang biasanya hanya memiliki satu place of birth (P19) dan place of death (P20).
- single-best-value constraint
- Butir seharusnya memiliki satu pernyataan "terbaik" dengan atribut ini. Biasanya digunakan untuk atribut yang dapat berubah seiring waktu: contohnya, kota dan negara biasanya memiliki satu head of government (P6) terkini.
- multi-value constraint
- Butir seharusnya memiliki lebih dari satu pernyataan dengan atribut ini (atau tidak sama sekali). Jarang digunakan, tetapi terdapat contoh seperti cast member (P161), has tense (P3103) dan has grammatical mood (P3161).
- distinct-values constraint
- disebut juga nilai unik dan nilai berbeda. Tidak ada dua butir yang memiliki nilai sama untuk atribut ini; setiap nilai butir seharusnya berbeda-beda bagi semua pernyataan untuk properti ini di seluruh Wikidata. Hampir semua atribut penanda memiliki pewatas ini, karena sebuah penanda (ISBN, freebase ID, …) seharusnya menandai suatu entitas secara unik. Contoh lainnya adalah flag (P163) dan anthem (P85).
Constraints regarding qualifiers
- allowed qualifiers constraint
- Pernyataan untuk atribut ini seharusnya tidak memiliki penjelas selain yang didaftarkan. Contoh: continent (P30) dengan penjelas start time (P580) dan end time (P582), dan Freebase ID (P646) tanpa penjelas sama sekali.
- required qualifier constraint
- Pernyataan untuk atribut ini harus memiliki semua penjelas dari daftar tertentu. Misal: stock exchange (P414) dengan ticker symbol (P249) dan start time (P580).
Constraints regarding references
- citation-needed constraint
- Pernyataan untuk atribut ini harus memiliki paling sedikit satu rujukan. Contoh: atribut-atribut yang mungkin disengketakan.
Datatype-specific constraints
Constraints for datatype item/entity
- value-type constraint
- Nilai untuk atribut ini seharusnya memiliki tipe tertentu. Contoh: Butir dengan mother (P25) seharusnya instance of (P31) human (Q5) atau animal (Q729).
- one-of constraint
- Nilai untuk atribut ini seharusnya salah satu dari butir yang diberikan. Contoh: driving side (P1622) seharusnya left (Q13196750) atau right (Q14565199).
- none-of constraint
- Nilai untuk atribut ini seharusnya bukanlah salah satu dari butir-butir yang diberikan. Contoh: instance of (P31) seharusnya bukan woman (Q467).
- value-requires-statement constraint
- disebut juga target membutuhkan pernyataan. Nilai untuk atribut ini seharusnya juga memiliki kalimat tertentu lainnya. Sebagai contoh, nilai screenwriter (P58) seharusnya memiliki sex or gender (P21) dan occupation (P106)screenwriter (Q28389).
- symmetric constraint
- Pernyataan yang menggunakan atribut ini seharusnya selalu ada secara dua arah.
- inverse constraint
- Pernyataan dengan atribut ini harus memiliki pernyataan balikan. Misal: father (P22)/mother (P25) dengan child (P40).
- complex constraint value label
- Values for this property have to have a label in a specific language that matches a specific format.
Constraints for Quantity
- integer constraint
- Nilai untuk atribut ini harus bilangan bulat tanpa angka desimal.
- allowed units constraint
- Nilai untuk pernyataan ini seharusnya hanya menggunakan satuan tertentu (atau tidak memakai satuan). Contoh: term length of office (P2097) (satuan: year (Q577)), population (P1082) (tanpa satuan).
- no-bounds constraint
- Nilai untuk properti ini sebaiknya tidak menggunakan batas atas dan bawah. Ini diterapkan di kebanyakan atribut-atribut non-fisik dengan tipe data quantity, di mana konsep ketidakpastian tidak didefinisikan.
- range constraint
- Nilai untuk atribut ini seharusnya berada di dalam interval tertentu. Contoh: flattening (P1102) selalu bernilai di antara 0 dan 1, dan UTC date of spacecraft launch (P619) seharusnya tidak sebelum .
- difference-within-range constraint
- dikenal juga sebagai selisih dalam rentang. Selisih antara nilai dalam atribut ini dengan atribut lainnya harus dalam rentang nilai tertentu. Sebagai contoh, selisih antara date of birth (P569) dan date of death (P570) semestinya ada di antara 0 dan 150 tahun.
Constraints for Time
- range constraint
- Values for this property should be within a certain range or interval. Examples: flattening (P1102) is always between 0 and 1, and UTC date of spacecraft launch (P619) should not be before .
- difference-within-range constraint
- aka. difference within range. The difference between values for this property and for another property should be within a certain range or interval. For example, the difference between date of birth (P569) and date of death (P570) should be between 0 and 150 years.
Constraints for string-based datatypes
The constraint types listed in this section can be used for properties that have a string-based datatype.
- format constraint
- Nilai untuk atribut ini harus menggunakan format tertentu. Seringkali digunakan sebagai penanda (panjang n angka, diawali huruf tertentu, terdiri atas angka, dst.).
Constraints for Commons links
- Commons link constraint
- Nilai untuk pernyataan ini haruslah pranala ke Wikimedia Commons yang sah. Misal : image (P18) (ruangnama Berkas), Commons category (P373) (ruangnama Kategori).
Jenis pewatas terurut alfabet
Beberapa pewatas memilki templat mereka sendiri yang sudah didefinisikan dan didaftarkan di Help:Property constraints/list of constraints.
Panduan penggunaan
Laporan pewatas ditampilkan kepada semua pengguna masuk log ketika mreka mengunjungi suatu halaman entitas.
Anda bisa juga memeriksa semua pewatas bagi suatu butir di Special:ConstraintReport. Halaman ini disediakan oleh WikibaseQualityConstraints (juga disebut "ekstensi pewatas"). Sebuah bot juga mememilihara laporan pelanggaran pewatas; lihat ringkasan pelanggaran di Wikidata di Wikidata:Database reports/Constraint violations.
Butir berjenis pewatas
Terdapat sebuah butir untuk setiap jenis pewatas, misalnya subject type constraint (Q21503250).
Pernyataan pewatas di atribut
Pewatas untuk suatu properti ditetapkan sebagai pernyataan di property, menggunakan property constraint (P2302) dan butir jenis pewatas. Sebagai contoh: sibling (P3373)property constraint (P2302)symmetric constraint (Q21510862). Pernyataan yang usang diabaikan, jadi mengubah peringkat pernyataan pewatas menjadi "deprecated" adalah cara yang mudah untuk mematikan sementara suatu pewatas tanpa sepenuhnya menghapusnya.
Parameter pewatas
Banyak pewatas yang dapat dikonfigurasi: salah satu dari memiliki daftar nilai yang dibolehkan, tipe memiliki tipe, dll. Pengaturan yang mengonfigurasi pewatas disebut parameter.
Parameter pewatas ditetapkan sebagai penjelas dalam pernyataan. Sebagai contoh:
relation (P2309)
class (P2308)
Terdapat beberapa parameter umum yang bisa ditambahkan ke pernyataan pewatas apapun:
- constraint status (P2316): Dengan nilai mandatory constraint (Q21502408), parameter ini dapat digunakan untuk menandai sebuah pewatas sebagai mandatory (wajib). Pelanggaran pewatas wajib dianggap lebih parah dari pelanggaran pewatas non-wajib.
- exception to constraint (P2303)
- Daftar pengecualian yang diketahui terhadap pewatas. Pada butir yang terdaftar dalam parameter ini, pewatas tidak diwajibkan
- group by (P2304)
- Berisi atribut yang nilainya merupakan dasar pengelompokan pelanggaran pewatas. Artinya, ketika laporan basis data mendaftarkan pelanggaran untuk suatu pewatas (untuk semua butir), butir-butir yang melanggar dikelompokkan berdasarkan nilai yang mereka miliki di atribut yang diberikan di parameter group by (P2304). (Ekstensi pewatas tidak menggunakan parameter ini.)
- constraint scope (P4680)
- Menetapkan pewatas berlaku di bagian mana dari pertanyaan, menggunakan tiga nilai istimewa constraint checked on main value (Q46466787), constraint checked on qualifiers (Q46466783) dan constraint checked on references (Q46466805). Gunakan kombinasi dari nilai-nilai tersebut untuk menetapkan di mana pewatas harus diperiksa.Jika parameternya tidak disebutkan, cakupan standarnya bergantung pada tipe pewatas. (Perhatikan bahwa laporan basis data hanya mencantumkan pelanggaran di nilai utama pernyataan.)
- constraint clarification (P6607)
- Memberikan penjelasan sederhana mengenai tujuan pewatas digunakan dan apa yang sebaiknya dilakukan untuk memenuhi pewatas.
Kapan pewatas tidak diperiksa
Setiap pewatas bisa mencantumkan pengecualian dalam parameter pewatasnya (lihat di atas); di pernyataan apa pun di butir yang dikecualikan, pewatas tersebut tidak akan diperiksa. (Belum ada mekanisme untuk menetapkan tipe entitas lain sebagai pengecualian, atau untuk menuliskan mengecualian dengan cara lain.)
Di atribut seperti Wikidata property example (P1855), Wikidata property example for properties (P2271), dll., sebagaimana didefinisikan di wgWBQualityConstraintsPropertiesWithViolatingQualifiers
, semua pemeriksaan pewatas di penjelas dilewatkan. Untuk atribut-atribut tersebut, penjelas punya makna yang berbeda dari biasanya: mereka lebih mirip dengan pernyataan utama daripada penjelas pernyataan tersebut, jadi tidak masuk akal untuk memeriksa pewatas di penjelas tersebut.
WikibaseQualityConstraints hanya menggunakan pernyataan pewatas normal-rank dan preferred-rank dan mengabaikan pernyataan deprecated-rank, jadi menetapkan rank menjadi deceprated (usang) bisa digunakan untuk "menyembunyikannya" dari WikibaseQualityConstraints. (KrBot menggunakan semua pernyataan pewatas apa pun rank-nya.)
Pewatas buatan sendiri
Dengan sedikit pengetahuan tentang SPARQL seseorang dapat membuat pewatas yang sangat kompleks untuk atribut tertentu, melebihi dari pewatas yang disebut di atas. Informasi lebih lanjut tersedia di Template:Complex constraint. Lihat juga daftar atribut dengan pewatas kompleks.
Lihat pula
- Wikidata:Curious Facts - alat yang menampilkan pelanggaran pewatas secara acak