Справка:Ограничения свойств/Формат
This is the documentation page for a particular constraint type. See Help:Property constraints portal for a general overview of property constraints. |
format constraint (Q21502404) указывает, что значения свойства должны соответствовать определенному шаблону.
Например, значения для GNIS Feature ID (P590) всегда должны быть числом, не превышающим восьми цифр, и без нуля в начале: [1-9][0-9]{0,7}
.
Шаблон - это регулярное выражение, но с различными разновидностями: KrBot, который формирует отчёты об отклонениях, использует PCRE; WikibaseQualityConstraints extension, который поддерживает Special:ConstraintReport и гаджет, использует Сервис запросов SPARQL, который в настоящее время использует java.util.regex, но может измениться на XQuery 1.0 / XPath 2.0 регулярные выражения, указанные в SPARQL, если BlazeGraph реализует их поддержку. Разновидности, в основном, но не полностью, совместимы. Для совместимости с обоими движками ограничений, придерживайтесь общего подкласса разновидностей.
Если никакая constraint scope (P4680) не определена, то это нарушение должно проверяться везде.
Возможные действия
На нарушение этого ограничения можно реагировать одним из следующих способов:
- Наиболее вероятная причина - это то, что значение было каким-то образом неверно сформировано. Часто исправление является простым: добавьте отсутствующий префикс или удалите тот, который должен быть неявным, добавьте пунктуацию (e. g. добавить дефисы в ISBN), исправить капитализацию и т.д.
- Возможно, значение является верным, но относится не к этому свойству, и поэтому должно быть перемещено в заявление для другого свойства (например, ISBN-13 (P212) в ISBN-10 (P957)).
- Возможно, что идентификатор расширил свой диапазон, и регулярное выражение должно быть адаптировано (например, идентификатор теперь использует до 15 цифр, а не 10, как когда он был впервые определен).
- Возможно, что элемент является редким, но обоснованным исключением из ограничения, и нет необходимости что-либо делать.
Параметры
Это ограничение имеет один обязательный и один необязательный параметр:
- format as a regular expression (P1793)
- Содержит формат (шаблон). Должны содержать только одно значение (no value Help или unknown value Help не допускается), которое должно быть правильным регулярным выражением.
- syntax clarification (P2916)
- Содержит понятное для человека описание шаблона. Может указываться несколько раз на разных языках.
Внимание: format as a regular expression (P1793) часто используется как утверждение высшего уровня для свойства, но его применение не формирует ограничение: чтобы задать формат ограничение, property constraint (P2302)format constraint (Q21502404) утверждение должно использоваться с квалификатором format as a regular expression (P1793) |
Примеры
1-й пример
Values for image (P18) should end with certain file extension like .jpg
or .png
.
property constraint |
| ||||||||||||
add value |
2-й пример
Using syntax clarification (P2916) parameter for explaining the regular expression in human-readable text. For example, value of IPA transcription (P898) doesn't contain : (colon) or ' (apostrophe). Correct character is ː (length) or ˈ (stress). This regular expression is difficult to understand without explanation.
property constraint |
| |||||||||||||||||||||||||||
add value |
Шаблон
When the constraint is set to the property, the following template is automatically displayed in the property talk page. The template is created by Module:Constraints using Template:Constraint, invoked from Template:Property documentation. Translations are defined at Module:i18n/constraints.
(?i).+\.(jpg|jpeg|jpe|png|svg|tif|tiff|gif|xcf|pdf|djvu|webp)|
”: value must be formatted using this pattern (PCRE syntax). (Help)List of violations of this constraint: Database reports/Constraint violations/P18#Format, SPARQL
Списки
Lists of properties which are set format constraint.
- Category:Properties with format constraints
- SPARQL query - click the execute button at the linked page to see the query result.