Справка:Ограничения свойств/Формат

From Wikidata
Jump to navigation Jump to search
This page is a translated version of the page Help:Property constraints portal/Format and the translation is 76% complete.
Outdated translations are marked like this.

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)
Содержит понятное для человека описание шаблона. Может указываться несколько раз на разных языках.

Примеры

1-й пример

Values for image (P18) should end with certain file extension like .jpg or .png.

property constraint
Normal rank format constraint
format as a regular expression (?i).+\.(jpg|jpeg|png|svg|tif|tiff|gif|xcf)
0 references
add reference


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
Normal rank format constraint
format as a regular expression [^:]+
syntax clarification colon is not a valid IPA character, the correct character for a length mark is ː (English)
0 references
add reference
Normal rank format constraint
format as a regular expression [^']+
syntax clarification apostrophe is not a valid IPA character, the correct character for primary stress is ˈ (English)
0 references
add reference


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.

Format “(?i).+\.(jpg|jpeg|jpe|png|svg|tif|tiff|gif|xcf|pdf|djvu|webp)|: value must be formatted using this pattern (PCRE syntax). (Help)
Exceptions are possible as rare values may exist. Exceptions can be specified using exception to constraint (P2303).
List of violations of this constraint: Database reports/Constraint violations/P18#Format, SPARQL

Списки

Lists of properties which are set format constraint.