توضیح پایگاهداده
توضیح پایگاهداده به اوبا میگوید دادههای این اتصال در چه کسبوکاری تولید شدهاند و قرار است برای پاسخ به چه پرسشهایی استفاده شوند. هدف، نوشتن معرفی تبلیغاتی شرکت نیست؛ میخواهید فاصلهٔ میان زبان روزمرهٔ همکاران و معنای واقعی اطلاعات را کم کنید. وقتی در شرکت میگویید «فروش قطعی»، این اصطلاح باید به تعریف مشخصی اشاره کند تا دستیار آن را با سفارش ثبتشده یا وجه دریافتشده اشتباه نگیرد.
این متن را فردی بنویسد یا بازبینی کند که هم فرایند کار را میشناسد و هم میداند داده چگونه ثبت میشود. مسئول فروش ممکن است تعریف شاخص را بداند و مسئول سامانه بداند کدام تاریخ یا وضعیت آن را نشان میدهد. همکاری این دو نفر از حدس زدن معنا بر پایهٔ نام جدولها مفیدتر است. برای تغییر توضیح اتصال، دسترسی مدیریت اتصالهای پایگاهداده لازم است.
تفاوت زمینهٔ کسبوکار با ساختار داده
Section titled “تفاوت زمینهٔ کسبوکار با ساختار داده”توضیح اتصال، تصویر کلی را میسازد: موضوع داده، بخشهای سازمان، دامنهٔ تاریخی، تعریف معیارهای مشترک و محدودیتهای شناختهشده. اسناد ساختار داده جای توضیح دقیق جدول، ستون، رابطه و کدهاست. در توضیح کلی میتوانید بنویسید «درآمد خالص پس از مرجوعی محاسبه میشود»؛ در سند جدول مشخص میکنید مبلغ مرجوعی کجا ثبت شده و چگونه با سفارش ارتباط دارد.
این تفکیک کمک میکند متن قابل نگهداری بماند. اگر تمام ستونها را در معرفی اتصال تکرار کنید، با تغییر ساختار مجبور میشوید چند متن را همزمان اصلاح کنید. اصل مشترک را اینجا بنویسید و جزئیات فنی را در سند مربوط نگه دارید. هر دو باید با یکدیگر سازگار باشند؛ دو تعریف متفاوت برای فروش خالص، حتی اگر هر کدام روان نوشته شده باشند، ابهام ایجاد میکند.
پیش از نوشتن چه اطلاعاتی جمع کنید
Section titled “پیش از نوشتن چه اطلاعاتی جمع کنید”ابتدا مشخص کنید این اتصال دادهٔ عملیاتی است یا نسخهای برای تحلیل. نسخهٔ تحلیلی ممکن است با تأخیر بهروز شود یا فقط برخی شعبهها را داشته باشد. زمان آخرین بهروزرسانی، آغاز پوشش معتبر و دورههای ناقص را از مسئول داده بپرسید. «از سال ۱۴۰۲ تاکنون» وقتی دقیق است که دورهٔ جاری واقعاً پوشش داده شده باشد؛ در غیر این صورت پایان پوشش را صریح بنویسید.
سپس دربارهٔ واحد پول، واحد مقدار، تقویم و معنای تاریخها توافق کنید. تاریخ ثبت سفارش با تاریخ ارسال یا دریافت پول یکسان نیست. اگر مبلغها به ریال هستند ولی مدیران به تومان صحبت میکنند، این تفاوت را توضیح دهید. اصطلاحهای محلی مانند مشتری فعال، سفارش باز و کالای برگشتی را با شرط قابل بررسی تعریف کنید، نه با عباراتی مانند «مشتری خوب» یا «فروش واقعی».
تولید و ذخیرهٔ توضیح
Section titled “تولید و ذخیرهٔ توضیح”از صفحهٔ اتصالها، اتصال موردنظر را باز کنید و امکان تولید خودکار توضیح را انتخاب کنید. خروجی تولیدشده یک پیشنهاد برای متن است؛ اطلاعاتی که از ساختار و داده دیده میشود نمیتواند همهٔ قواعد داخلی شرکت را اثبات کند. پیشنویس را بخوانید، جملههای نامطمئن را اصلاح کنید و دانش کسبوکار را اضافه کنید. تولید خودکار بهتنهایی به معنای ذخیره شدن توضیح نهایی نیست؛ متن انتخابشده را در اتصال ذخیره کنید.
پیش از تولید دوباره، از توضیح دستی خود نسخهای نگه دارید. خروجی تازه ممکن است در فرم جای متن فعلی را بگیرد و شما برای مقایسه به نسخهٔ قبلی نیاز داشته باشید. لازم نیست پیشنهاد جدید را کامل بپذیرید؛ میتوانید فقط بخش مفید آن را به متن خود اضافه کنید. پس از ذخیره، اتصال را دوباره باز کنید و مطمئن شوید همان تعریف نهایی دیده میشود.
یک نمونهٔ کامل و قابل استفاده
Section titled “یک نمونهٔ کامل و قابل استفاده”فرض کنید شرکت پخش فرضی شما سفارش و مرجوعی دو شعبه را ثبت میکند. متن مناسب میتواند چنین باشد: «این اتصال شامل سفارشهای فروش، اقلام سفارش، مشتریان و مرجوعی شعبههای تهران و البرز است. مبالغ ثبتشده به ریال هستند. فروش قطعی، مبلغ سفارش ارسالشده پس از کسر تخفیف و مرجوعی است؛ سفارش لغوشده در این معیار حساب نمیشود. تاریخ گزارش فروش، تاریخ ارسال سفارش است و دریافت وجه در گزارش وصول بررسی میشود.»
پاراگراف دوم محدودیت را روشن میکند: «پوشش معتبر داده از ابتدای سال ۱۴۰۳ آغاز میشود. اطلاعات روز جاری پس از انتقال شبانه کامل میشود؛ بنابراین گزارش امروز ممکن است ناقص باشد. دادهٔ شعبهٔ البرز در نخستین ماه راهاندازی کامل نیست. مشتری فعال در گزارش فروش، مشتریای است که در بازهٔ مشخصشده دستکم یک سفارش ارسالشده داشته باشد.» این نمونه فرضی است؛ تعریف آن را بدون تأیید در شرکت خود استفاده نکنید.
با چنین متنی، درخواست «فروش ماه گذشته» هنوز به بررسی بازه نیاز دارد. ماه گذشته یعنی ماه تقویمی قبل از زمان درخواست، نه آخرین ماهی که در داده وجود دارد. اگر داده تا خرداد موجود است ولی اکنون شهریور است، باید نبود پوشش مرداد روشن شود. برای تحلیل آخرین دورهٔ موجود، همان را در سؤال بنویسید و تاریخ آغاز و پایان را بخواهید.
کیفیت توضیح را با پرسش کنترل کنید
Section titled “کیفیت توضیح را با پرسش کنترل کنید”بعد از ذخیره، یک سؤال محدود بپرسید: «فروش قطعی شعبهٔ تهران در فروردین ۱۴۰۴ را با واحد مبلغ و تعریف وضعیتهای لحاظشده نشان دهید.» پاسخ را با گزارش مرجع همان دوره مقایسه کنید. اگر اختلاف دیدید، ابتدا بازه، تاریخ مبنا، حذف لغوشدهها و تبدیل واحد را بررسی کنید. وجود توضیح خوب احتمال سوءبرداشت را کم میکند، اما درست بودن هر پاسخ را تضمین نمیکند.
رمز، کلید دسترسی، اطلاعات ورود یا فهرست اطلاعات شخصی را در توضیح ننویسید. این متن محل تعریف داده است و محدود کردن دسترسی را انجام نمیدهد. اگر بخشی از داده نباید خوانده شود، مجوز منبع را محدود کنید. هنگام تغییر فرایند فروش، واحدها یا پوشش زمانی نیز متن را بازبینی کنید. قدم بعد، تکمیل اسناد ساختار و اجرای یک سؤال دقیق است.