https://bukvica.org/w/index.php?action=history&feed=atom&title=%D0%9C%D0%BE%D0%B4%D1%83%D0%BB%D1%8C%3AWDBase%2FdocМодуль:WDBase/doc - История изменений2026-04-21T01:10:00ZИстория изменений этой страницы в викиMediaWiki 1.43.8https://bukvica.org/w/index.php?title=%D0%9C%D0%BE%D0%B4%D1%83%D0%BB%D1%8C:WDBase/doc&diff=238771&oldid=prevKaraby: 1 версия импортирована2025-07-27T15:38:25Z<p>1 версия импортирована</p>
<table style="background-color: #fff; color: #202122;" data-mw="interface">
<col class="diff-marker" />
<col class="diff-content" />
<col class="diff-marker" />
<col class="diff-content" />
<tr class="diff-title" lang="ru">
<td colspan="2" style="background-color: #fff; color: #202122; text-align: center;">← Предыдущая версия</td>
<td colspan="2" style="background-color: #fff; color: #202122; text-align: center;">Версия от 15:38, 27 июля 2025</td>
</tr><tr><td colspan="4" class="diff-notice" lang="ru"><div class="mw-diff-empty">(нет различий)</div>
</td></tr>
<!-- diff cache key wiki:diff:1.41:old-238770:rev-238771 -->
</table>Karabyhttps://bukvica.org/w/index.php?title=%D0%9C%D0%BE%D0%B4%D1%83%D0%BB%D1%8C:WDBase/doc&diff=238770&oldid=prevБуквица>D6194c-1cc: /* План разработки */ Реализовано2023-07-29T11:23:25Z<p><span class="autocomment">План разработки: </span> Реализовано</p>
<p><b>Новая страница</b></p><div>Модуль-библиотека с базовыми функциями для работы с Викиданными. Содержит функции для получения утверждений, фильтрации, получения значений утверждений, приведения утверждений к текстовому виду.<br />
<br />
Модуль используется другим, более высокоуровневым модулем-библиотекой [[Модуль:WDCommon]]. на модуле WDBase основаны модули [[Модуль:WDBackend]] и [[Модуль:WDFormat]].<br />
<br />
== Функции ==<br />
В функциях используются понятия '''значения''' (''value'') и '''текстового''' представления (''text''). Значение может быть текстом, таблицей с датой или идентификатором элемента Викиданных. Текстовое представление предполагает преобразование значения в текстовый вид, которы уже можно использовать для отображения.<br />
<br />
Получаемые из Викиданных данные представлены в специальном сериализованном формате. В этом формате есть понятия '''утверждения''' (''statement'') и '''снека''' (''snak''). Утверждения — это значения для заданного свойства с дополнительными уточняющими данными и источниками. Снеки — часть утверждений, у которых есть только значение. Каждое утверждение может иметь в себе основной снек и квалификаторы. Данные в квалификаторах представлены только лишь снеками.<br />
<br />
Работа с элементом Викиданных:<br />
* '''statements''' — получить массив утверждений для указанного свойства.<br />
* '''statementsByProperties''' — получить массив утверждений для указанных свойств, скомбинировав их (учитываются порядковые номера, указанные через квалификаторы).<br />
* '''value''' — получить значение свойства элемента Викиданных (берётся первое утверждение).<br />
* '''text''' — получить текстовое представление свойства элемента Викиданных (берётся первое утверждение).<br />
* '''wikilink''' — получить викиссылку на статью по элементу Викиданных.<br />
* '''resolveParent''' — получить основной элемент Викиданных (издание, на котором основано текущее издание).<br />
* '''instanceOf''' — проверить является ли элемент Викиданных частным случаем одной из указанных сущностей.<br />
* '''valueByQualifier''' — получить значение утверждения, которому соответствует квалификатор с указанным свойством и значением.<br />
<br />
Работа с утверждениями:<br />
* '''valueByStatement''' — получить значение из утверждения.<br />
* '''textByStatement''' — привести утверждение к текстовому виду.<br />
* '''dataByStatement''' — получить таблицу с данными в удобном для использования формате из утверждения.<br />
* '''statementQualifier''' — получить снек квалификатора по идентификатору свойства.<br />
* '''tryFilterStatementsByLang''' — попытаться отфильтровать утверждения по языку. Если заданного языка не найдено, возвращает все утверждения. Если передан аргумент ''forceLang'', то не возвращает утверждений, если по указанному языку они не найдены.<br />
* '''filterStatementsByUnit''' — отфильтровать утверждения по QID единицы измерения.<br />
<br />
Работа со снеками:<br />
* '''valueBySnak''' — получить значение из снека.<br />
* '''dataBySnak''' — получить таблицу с данными в удобном для использования формате из снека.<br />
* '''tryFilterSnaksByLang''' — попытаться отфильтровать снеки по языку. Если заданного языка не найдено, возвращает все снеки.<br />
<br />
Работа с типами:<br />
* '''dateFromDatavalue''' — получить таблицу с распарсенной датой из данных снека.<br />
* '''dateToStr''' — преобразовать таблицу с датой в строку.<br />
<br />
== Внесение изменений ==<br />
При исправлении ошибки, пожалуйста, сначала добавьте '''тест''', который будет проваливаться из-за обнаруженной '''ошибки''', и только затем вносите исправление. При внесении исправления проверьте, чтобы все тесты проходили. Вносить исправление можно только, если оно не ломает другие тесты.<br />
<br />
Добавление нового функционала рекомендуется делать у себя в '''песочнице''', скопировав в неё модуль. В правке копирования необходимо указать тот факт, что делается копирование, и сделать ссылку на оригинальный модуль в виде викитекста. При добавлении нового функционала сначала желательно добавить тест на этот функционал, затем добавить сам функционал, убедившись, что все тесты при этом проходят.<br />
<br />
== Тесты ==<br />
{{См. также|{{replace|{{FULLPAGENAME}}|/doc|}}/testcases}}<br />
{{#invoke:{{replace|{{PAGENAME}}|/doc|}}/testcases|run|displayMode=table}}<br />
<br />
== План разработки ==<br />
{{To-do<br />
| содержание =<br />
}}<br />
<br />
<includeonly>[[Категория:Модули:Викиданные]]</includeonly></div>Буквица>D6194c-1cc