1.2 Словарь данных

Словарь данных определяет состав структур данных, а также их значение, тип данных, длину, формат и разрешенные значения элементов данных, из которых состоят эти структуры. Серийные средства моделирования данных часто включают компонент-словарь данных. Во многих случаях словарь данных лучше хранить как отдельный артефакт, не внедряя его в спецификацию требований к ПО. Это повышает возможности повторного использования в других проектах.

Словарь данных (data dictionary) представляет собой набор подробной информации об используемых в приложении сущностях данных. Сбор информации о составе, типах данных, разрешенных значениях и т. п. в виде единого ресурса, служащего для определения критериев проверки данных, помогает разработчикам правильно писать программы и избавляет от проблем с интеграцией. Словарь данных является дополнением к словарю терминов проекта, который определяет термины предметной области или бизнес-термины приложения, сокращения и акронимы. Рекомендуется поддерживать словарь данных и словарь терминов отдельно.

Во время анализа требований информация словаря данных представляет элементы и структуры данных предметной области. Эта информация попадает в дизайн в форме схем баз данных, таблиц и атрибутов, что в конечном итоге определяет имена переменных в программах. Время, потраченное на создание словаря данных, будет более чем компенсировано временем, которые вы сэкономите, избежав ошибок по причине того, что участники проекта по-разному понимают ключевые данные. Если вы регулярно обновляете словарь данных, он останется ценным средством и при обслуживании системы, и при разработке схожих систем. В противном случае он может вводить в заблуждение, предоставляя устаревшую информацию, и члены команды перестают доверять ему. Ведение словаря данных — серьезный вклад в повышение качества. Определения данных часто повторно используются в других приложениях, особенно в одном семействе продуктов. Использование единообразных определений данных в компании снижает вероятность возникновения ошибок интеграции и интерфейса. По возможности используйте существующие стандартные определения данных из хранилища корпоративных знаний, используя менее масштабный набор определений в проекте для восполнения пробелов.

По сравнению с определениями данных, разбросанными в различных местах функциональных требований, отдельный словарь данных облегчает поиск необходимой информации, а также помогает избежать ненужных повторов и несогласованности. Однажды мне пришлось рецензировать спецификации вариантов использования, определяющие элементы данных, вместе составлявших определенные структуры данных. К несчастью, эти элементы были разными в местах, где они присутствовали. Такая непоследовательность вынуждает разработчика или тестировщика выяснять, какие из определений верны и есть ли вообще верные определения. Обеспечение целостности реплицируемых структур данных по мере их изменения также непростая задача. Эти проблемы решаются путем сбора и консолидации такой информации с тем, чтобы имелся только один экземпляр каждого определения, которым могут пользоваться все заинтересованные лица.

Структура Структура данных (или запись) содержит несколько элементов данных. Столбец «Структура или тип данных» в словаре данных — место, где перечисляются элементы, из которых состоит структура, а элементы отделяются знаком «плюс» (+). Структуры могут содержать другие структуры. Каждый элемент данных в структуре должен быть определен в словаре данных. Если элемент в структуре данных необязателен (значение, которое не должно предоставляться пользователем или системой), заключите его в скобки.

Повторяющаяся группа Если в структуре данных содержится несколько экземпляров элемента данных, заключите этот элемент в фигурные скобки. Покажите допустимое количество возможных повторов в формате минимум:максимум перед открывающей скобкой.