درس ۱ — چرا یک فهرست، نه فیلدهای بیشتر
هر مرجع اماراتی که با آن سروکار دارید شمارهای به شما میدهد، و این شمارهها در جاهای مختلف فرود میآیند. یکی روی رکورد شرکت، یکی روی یک تنظیم مالیاتی، یکی روی فرم یک کارمند، و یکی در ایمیلی از ترخیصکار گمرکی و هیچجای دیگر. هیچچیز در پایگاه داده به شما نمیگوید کدام کدام است، چه کسی آن را صادر کرده، یا مقداری که میبینید همان مقدار جاری است یا نه. راهحل بدیهی این است که آنقدر فیلد اضافه کنید تا هر شماره جعبهای داشته باشد. همین راهحل است که بیسروصدا دو نسخه از یک شماره میسازد.
مدل ذهنی: یک فهرست، و پشت آن یک دفتر ثبت کوچک. شناسههای امارات اودون (odoone_uae_identifiers) خانهٔ تعیینشده برای هر شناسهای است که یک مرجع امارات صادر میکند — شمارهٔ ثبت مالیاتی، GIBAN، شناسهٔ کارگاه (Establishment ID)، شمارهٔ ثبت گمرکی، شمارههای سند مرتبط با کارت هویت اماراتی و موارد دیگر. هیچیک از این دادهها را جابهجا نمیکند. در عوض یک فهرست مستندشده از شناسههای موجود اضافه میکند و یک دفتر ثبت مقادیر کوچک برای معدود شناسههایی که هنوز فیلد مخصوص خود را ندارند: شمارهٔ ثبت مالیات شرکتی، GIBANهای هر نوع مالیات، و کد گمرکی.
مسیر کلیک. به برنامهها بروید، Odoone UAE Identifiers را جستوجو کنید و نصب (Install) را بزنید — نام فنی آن odoone_uae_identifiers است. یا UAE Identifiers را در تنظیمات › UAE (Settings › UAE) تیک بزنید، که همان کار را از صفحهای انجام میدهد که دورهٔ 1.1 وقتش را آنجا میگذارد. نصب، odoone_l10n_ae و mail را خودکار همراه میآورد، پس چیزی پیش از آن لازم نیست نصب شود.
نصب هیچچیزی را که پیشتر وارد کردهاید تغییر نمیدهد. نصب هیچ مقداری را که از پیش روی یک فیلد موجود ذخیره شده تغییر نمیدهد. فهرست فقط مستند میکند که آن مقادیر کجا زندگی میکنند. همین یک جمله دلیل امن بودن این ماژول روی پایگاه دادهای است که سالهاست کار میکند: این یک لایهٔ مرجع روی دادههایی است که از پیش دارید، نه انتقال آنها.
پل منابع انسانی خودش را نصب میکند. شناسههای امارات اودون — پل منابع انسانی (odoone_uae_identifiers_hr) بهمحض حضور همزمان odoone_uae_identifiers و hr خودکار نصب میشود و هیچکدام را به پایگاه دادهای که به آنها نیاز ندارد تحمیل نمیکند. ماژول پایه را جایی نصب کنید که منابع انسانی ندارد و پل نصبنشده میماند؛ بعداً hr را نصب کنید و پل خودش میآید. درس ۵ تماماً دربارهٔ چیزی است که این پل اضافه میکند، و کمتر از آن اضافه میکند که بیشتر مردم انتظار دارند — آگاهانه.
مثال عملی. Marina Ridge Trading LLC ماژول را سهشنبه صبح نصب میکند و مدیر مالی منتظر است چیزی جابهجا شود. هیچچیز جابهجا نمیشود. شمارهٔ ثبت مالیاتی دقیقاً همانجاست که بود، روی همان فیلدی که همیشه آن را نگه میداشت. چیز تازه یک منوی فهرست زیر پیکربندی حسابداری است و، روی فرم شرکت، گروه UAE Registrations & Identifiers با یک فهرست درونخطی خالی — خالی چون هنوز هیچ مقدار دفتر ثبتی وارد نشده، نه چون نصب شکست خورده است.
حالت خطا. «گروه UAE Registrations & Identifiers از فرم شرکت غایب است.» کشور مالیاتی شرکت امارات نیست، پس کل زبانهٔ UAE Company Setting و همراه آن این گروه پنهان است. این همان بررسیای است که دورهٔ 1.1 با آن آغاز میشود، و ارزش دارد پیش از آنکه نتیجه بگیرید چیزی در این ماژول خراب است انجام شود.