опис сутностей
Навіть хороших імен, що вказують користувачеві, яку інформацію варто очікувати від сутності, зазвичай недостатньо. Кожна сутність має потребу в ясному, точному і повному описі або визначенні, щоб бути однозначно інтерпретується в рамках корпорації. Опис суті має пояснювати сенс сутності та її значення для корпорації.
Хоча опис, визначення та призначення часто використовуються як синоніми, термін опис краще, оскільки він спонукає нас описувати сутності в термінах, зрозумілих для користувача.
Опис суті має пояснювати її сенс, а не те, як буде використовуватися інформація цієї сутності. Ви повинні збирати опису сутностей під час ідентифікації сутностей. Будьте обережні при включенні інформації про використання: подібна інформація повинна використовуватися тільки в якості прикладу або для пояснення. Спосіб використання інформації змінюється більш часто, ніж інформація сама по собі, тому інформація про використання непостійна.
Опис суті має бути ясним, точним, повним і несуперечливим. Воно повинно бути сформульовано без залучення технічних термінів, зрозуміло будь-кому, хто хоча б трохи знайомий з описуваної концепцією. Переконайтеся, що опис сформульовано в термінах бізнесу, і включає пояснення значимості суті.
У табл. П2 міститься приклади поганих описів сутності ПЕРСОНА.
Описи сутностей з поясненнями
Клієнт або співробітник.
Хороший опис включає визначення сутності і її значення для корпорації.
Включає ім'я, дату народження і т.п. для персони.
Просте перерахування атрибутів суті не несе додаткової інформації про те, що собою являє сутність і чому вона важлива для корпорації.
Інформація про клієнтів і співробітників.
Клієнт і співробітник є прикладами ролей, в яких може виступати ПЕРСОНА. Використання одних лише прикладів не пояснює, що сутність собою являє і чому вона важлива для корпорації.
Сутність містить символи і числові дані, витягнуті з POS (Point Of Sale - торговий термінал), що зберігаються з використанням стандартного стиснення і упакованих десяткових чисел.
Даний штучний приклад покликаний проілюструвати, що технічні описи та абревіатури насилу розуміються бізнес-користувачами.