اکسپورت و ایمپورت داده

در سازمان‌یار، گاه برای اجرای گزارش‌ها یا ویرایش داده‌ها، لازم است که داده‌ها را اکسپورت یا ایمپورت کنید. این راهنما به فرآیندهای اکسپورت و ایمپورت داده‌ها در سازمان‌یار می‌پردازد.

مهم

معمولاً در حجم‌های بالا، کاربران با خطای زمان اتمام مهلت (Time Out) یا عدم پردازش رکورد مواجه می‌شوند. این اتفاق می‌تواند در هنگام اکسپورت حجم زیاد اطلاعات یا در مواقعی که فایل ایمپورت بسیار بزرگ باشد رخ دهد. برای رفع محدودیت حجم رکوردها، ایمپورت یا اکسپورت را به صورت دسته‌ای و با حجم‌های کوچکتر انجام دهید.

اکسپورت داده از سازمان‌یار

گاهی اوقات ممکن است هنگام کار با پایگاه داده لازم باشد که داده‌ها را در یک فایل جداگانه اکسپورت کنید. این کار می‌تواند به گزارش‌گیری از فعالیت‌ها کمک کند، هرچند سازمان‌یار ابزاری دقیق و آسان برای گزارش‌گیری در هر ماژولی ارائه می‌دهد.

در سازمان‌یار مقادیر را می‌توان از هر فیلد در هر رکورد اکسپورت شوند. برای این کار، نمای لیست (|list|) را برای مواردی که نیاز به اکسپورت شدن دارند فعال کنید، سپس رکوردهایی که باید اکسپورت شوند را انتخاب کنید. برای انتخاب هر رکورد، کادر کنار رکورد مربوطه را تیک بزنید. در نهایت، روی |actions| کلیک کنید و سپس اکسپورت را انتخاب کنید.

نمایی از موارد مختلف برای انتخاب داده‌های لازم برای اکسپورت.

با کلیک بر روی اکسپورت، پنجره اکسپورت داده‌ها با چند گزینه برای داده‌های قابل اکسپورت ظاهر می‌شود:

نمای کلی گزینه‌هایی که هنگام اکسپورت داده‌ها در سازمان‌یار باید در نظر گرفته شوند.

  1. با تیک زدن گزینه می‌خواهم داده‌ها را به‌روزرسانی کنم (اکسپورت سازگار با ایمپورت)، سیستم فقط فیلدهایی را نشان می‌دهد که می‌توانند ایمپورت شوند. این در مواردی مفید است که رکوردهای موجود نیازمند به‌روزرسانی هستند. این گزینه مانند یک فیلتر عمل می‌کند و اگر فعال نباشد، فیلدهای بسیار بیشتری برای اکسپورت ارائه می‌شوند، زیرا همه فیلدها نمایش داده می‌شوند، نه فقط فیلدهایی که می‌توانند ایمپورت شوند.

  2. هنگام اکسپورت، دو فرمت .csv و .xls برای انتخاب وجود دارد. در حالت .csv، آیتم‌ها با کاما جدا می‌شوند، در حالی که .xls شامل اطلاعات مربوط به تمام کاربرگ‌ها در یک فایل، اعم از محتوا و قالب‌بندی، می‌شود.

  3. این آیتم‌ها قابل اکسپورت شدن هستند. از آیکون > (فلش چپ) برای نمایش زیرمجموعه‌های بیشتر استفاده کنید. برای پیدا کردن فیلدهای خاص از نوار جستجو استفاده کنید. برای استفاده کارآمدتر از گزینه جستجو، روی تمام آیکون‌هاید > (فلش‌های چپ) کلیک کنید تا تمام فیلدها نمایش داده شوند.

  4. کاربرد دکمه آیکون + (آیکون مثبت) افزودن فیلدها به لیست فیلدهای قابل اکسپورت ست.

  5. از ↕️ (فلش بالا و پایین) در سمت راست فیلدهای انتخاب شده می‌توان برای جابجایی فیلدها به بالا و پایین و تغییر ترتیب نمایش آنها در فایل اکسپورت شده استفاده کرد. با استفاده از آیکون ↕️ (فلش بالا و پایین) می‌توانید آنها را بکشید و رها کنید.

  6. برای حذف فیلدها از آیکون ️🗑️ (سطل زباله) استفاده می‌شود. برای حذف فیلد، روی آیکون ️🗑️ (سطل زباله) کلیک کنید.

  7. برای گزارش‌های تکراری، ذخیره پیش‌تنظیمات اکسپورت کاربردی است. همه فیلدهای مورد نیاز را انتخاب کنید و روی منوی کشویی قالب کلیک کنید. سپس، روی قالب جدید کلیک کنید و یک نام منحصر به فرد برای اکسپورتی که ایجاد کرده‌اید انتخاب کنید. روی آیکون 💾 (دیسکت) کلیک کنید تا پیکربندی ذخیره شود. دفعه بعد که نیازمند اکسپورت همان لیست هستید، قالب مرتبطی که قبلاً ذخیره شده است را از منوی کشویی انتخاب کنید.

نکته

دانستن شناسه خارجی فیلد مفید است. به عنوان مثال، شرکت مرتبط در رابط کاربری اکسپورت برابر با parent_id (شناسه خارجی) است. این موضوع مفید است زیرا در این صورت، تنها داده‌های اکسپورت شده، داده‌هایی هستند که باید ویرایش و دوباره وارد شوند.

ایمپورت داده به سازمان‌یار

ایمپورت داده به سازمان‌یار در زمان استقرار یا در مواقعی که نیاز به به‌روزرسانی داده‌ها به صورت عمده وجود دارد، بسیار مفید است. راهنمای زیر نحوه یمپورت داده به پایگاه داده سازمان‌یار را پوشش می‌دهد.

هشدار

ایمپورت دائمی است و قابل برگشت نیست. با این حال، می‌توان از فیلترها (تاریخ ایجاد یا آخرین ویرایش) برای شناسایی رکوردهایی که توسط فرآیند ایمپورت تغییر یا ایجاد شده‌اند استفاده کرد.

نکته

فعال کردن حالت توسعه‌دهنده تنظیمات قابل مشاهده ایمپورت را در منوی سمت راست تغییر می‌دهد. با این کار منوی پیشرفته نمایش داده می‌شود. این منوی پیشرفته شامل دو گزینه است: رهگیری تاریخچه حین ایمپورت و امکان تطبیق با زیرفیلدها.

گزینه‌های پیشرفته ایمپورت با فعال بودن حالت توسعه دهنده.

در مدل openchatter گزینه رهگیری تاریخچه حین ایمپورت موجب ایجاد اشتراک شده و در حین ایمپورت اعلان‌هایی را ارسال می‌کند، اما ایمپورت کندتر می‌شود.

اگر گزینه امکان تطبیق زیرفیلدها انتخاب شود، در حین ایمپورت، از تمام زیرمجموعه‌های فیلد برای تطبیق با فیلد اودوو استفاده می‌شود.

شروع به کار

می‌توان با استفاده از فرمت‌های اکسل (.xlsx) یا CSV (.csv)، داده‌ها را در هر شیء تجاری سازمان‌یار ایمپورت کرد که شامل این موارد می‌شود: مخاطبان، محصولات، صورت‌حساب‌های بانکی، ثبت‌های دفتر روزنامه و سفارش‌ها.

نمای شیء که داده‌ها باید به آن ایمپورت/پر شوند را باز کنید، روی آیکون :icon:`fa-cog` (چرخ دنده) کلیک کنید و ایمپورت رکوردها را انتخاب کنید.

منوی عملیات با گزینه ایمپورت رکوردها برجسته شده است.

روی :icon:`fa-download`قالب ایمپورت برای مشتریان در مرکز صفحه کلیک کنید تا یک قالب دانلود کنید و آن را با داده‌های شرکت پر کنید. چنین قالب‌هایی را می‌توان با یک کلیک ایمپورت کرد، زیرا نگاشت داده‌ها از قبل پیکربندی شده است.

برای آپلود قالب دانلود شده یا فایل خود، مراحل زیر را دنبال کنید:

  1. روی آپلود فایل داده کلیک کنید و فایل مورد نظر را انتخاب کنید.

  2. گزینه‌های فرمت‌بندی را در صورت نیاز تنظیم کنید (فقط برای فایل‌های CSV).

  3. اطمینان حاصل کنید که همه داده‌ها در ستون فایل به درستی به فیلد اودوو مناسب نگاشت شده‌اند و بدون خطا هستند.

  4. (اختیاری) روی بارگذاری فایل داده کلیک کنید تا همان فایل دوباره بارگیری شود یا فایل دیگری آپلود شود.

  5. روی تست کلیک کنید تا از معتبر بودن داده‌ها اطمینان حاصل کنید.

  6. روی ایمپورت کلیک کنید.

توجه

گزینه‌های فرمت‌بندی هنگام ایمپورت نوع فایل اختصاصی اکسل (یعنی .xls یا .xlsx) ظاهر نمی‌شوند.

سفارشی‌سازی قالب

قالب‌های ایمپورت در ابزار ایمپورت برای رایج‌ترین داده‌های قابل ایمپورت (مخاطبان، محصولات، صورت‌حساب‌های بانکی و غیره) ارائه می‌شوند که می‌توانید آنها را با هر نرم‌افزار صفحه گسترده‌ای (Microsoft Office, OpenOffice, Google Drive و غیره) باز کنید.

بعد از دانلود شدن قالب این مراحل را دنبال کنید:

  • ستون‌ها را اضافه، حذف و مرتب کنید تا به بهترین شیوه ممکن با ساختار داده مطابقت داشته باشد.

  • توصیه اکید می‌شود که ستون :guilabel:`شناسه خارجی` را حذف نکنید (در بخش بعدی دلیل آن را خواهید دید).

  • با کشیدن دنباله شناسه در ستون شناسه خارجی (ID)، برای هر رکورد یک شناسه منحصر به فرد تعیین کنید.

انیمیشنی از موس که ستون شناسه را به پایین می‌کشد، به طوری که هر رکورد دارای یک شناسه منحصر به فرد است.

توجه

هنگامی که ستون جدیدی اضافه می‌شود، اگر برچسب آن با هیچ فیلدی در سازمان‌یار مطابقت نداشته باشد، ممکن است سازمان‌یار نتواند آن را به طور خودکار نگاشت کند. با این حال، ستون‌های جدید را می‌توان هنگام تست ایمپورت به صورت دستی نگاشت کرد. برای یافتن فیلد مربوطه، در منوی کشویی جستجو کنید.

منوی کشویی باز شده در صفحه ایمپورت اولیه در سازمان‌یار.

سپس، در فایل ایمپورت از برچسب این فایل استفاده کنید تا از موفق بودن ایمپورت‌های آینده مطمئن شوید.

نکته

راه مفید دیگر برای یافتن نام‌های صحیح ستون‌های ایمپورت، اکسپورت یک فایل نمونه با استفاده از فیلدهایی است که باید ایمپورت شوند. به این ترتیب، اگر الگوی ایمپورت نمونه وجود نداشته باشد، نام‌ها دقیق خواهند بود.

ایمپورت از برنامه‌ای دیگر

شناسه خارجی (ID) یک شناسه منحصر به فرد برای هر ردیف است. برای تسهیل انتقال به سازمان‌یار می‌توانید از شناسه‌ای که در نرم‌افزار قبلی خود استفاده می‌کردید، استفاده کنید.

به هنگام ایمپورت تعیین شناسه اجباری نیست، ولی در موارد بسیاری کمک‌کننده است:

برای بازسازی روابط بین رکوردهای مختلف، باید از شناسه منحصر به فرد در برنامه اصلی برای نگاشت آن به ستون شناسه خارجی (ID) در سازمان‌یار استفاده کرد.

هنگامی که رکورد دیگری که به رکورد اول مرتبط است ایمپورت می‌شود، از XXX/ID (XXX/شناسه خارجی) برای شناسه منحصر به فرد اصلی استفاده کنید. این رکورد را می‌توان با استفاده از نام آن نیز پیدا کرد.

هشدار

باید توجه داشت که اگر دو (یا بیشتر) رکورد دارای شناسه خارجی یکسان باشند، تعارض رخ می‌دهد.

فیلد ناموجود برای نگاشت ستون

سازمان‌یار به طور اکتشافی سعی می‌کند بر اساس ده خط اولِ فایل‌ها، نوع فیلد را برای هر ستون در داخل فایلِ ایمپورت شده پیدا کند.

به عنوان مثال، اگر ستونی فقط شامل اعداد باشد، فقط فیلدهایی که از نوع اینتیجر باشند به عنوان گزینه قابل انتخاب ارائه می‌شوند.

با اینکه این رفتار در اکثر موارد مفید است، ممکن است در برخی موارد با خطا مواجه شود یا ستون به فیلدی نگاشت شود که به طور پیش‌فرض پیشنهاد نشده است.

اگر این اتفاق رخ داد، گزینه نمایش فیلدهای رابطه‌دار (پیشرفته) را بررسی کنید، سپس لیست کاملی از فیلدها برای هر ستون در دسترس خواهد بود.

جستجوی فیلد برای تطابق با ستون مالیات.

تغییر فرمت ایمپورت داده

توجه

سازمان‌یار می‌تواند به طور خودکار تشخیص دهد که آیا یک ستون تاریخ است یا نه و سعی می‌کند فرمت تاریخ را از مجموعه‌ای از رایج‌ترین فرمت‌های تاریخ حدس بزند. در حالی که این فرآیند می‌تواند برای بسیاری از فرمت‌های تاریخ درست کار کند، ولی برخی از فرمت‌های تاریخ قابل تشخیص نیستند. این فرآیند می‌تواند به دلیل وارونگی مکان قرارگیری روز و ماه باعث ایجاد سردرگمی نیز شود. حدس زدن اینکه کدام قسمت از فرمت تاریخ مربوط به روز و کدام قسمت مربوط به ماه است، در تاریخی مانند 01-03-2016 دشوار است.

هنگام ایمپورت فایلِ CSV, سازمان‌یار گزینه‌هایِ فرمت‌بندی را ارائه می‌دهد.

برای مشاهده فرمت تاریخی که سازمان‌یار از فایل پیدا کرده است، فرمت تاریخ را که با کلیک بر روی گزینه‌ها در زیر انتخاب‌کننده فایل نمایش داده می‌شود، بررسی کنید. اگر این فرمت نادرست است، آن را با استفاده از ISO 8601 برای تعریف فرمت، به فرمت دلخواه تغییر دهید.

مهم

ISO 8601 یک استاندارد بین‌المللی است که تبادل و ارتباط داده‌های مربوط به تاریخ و زمان را در سطح جهانی پوشش می‌دهد. به عنوان مثال، اگر فرمت تاریخ باید به صورت YYYY-MM-DD باشد، برای 24 جولای 1981، تاریخ باید به صورت 1981-07-24 نوشته شود.

نکته

هنگام ایمپورت فایل‌های اکسل (.xls, .xlsx)، برای ذخیره تاریخ‌ها از سلول‌های تاریخ استفاده کنید. این کار فرمت‌های تاریخ محلی را برای نمایش حفظ می‌کند، صرف نظر از نحوه فرمت‌بندی تاریخ در سازمان‌یار. هنگام ایمپورت فایل CSV، از بخش فرمت‌بندی برای انتخاب ستون‌های فرمت تاریخ استفاده کنید.

ایمپورت اعداد با علامت اختصاری واحد پول

سازمان‌یار به طور کامل از اعداد با پرانتز برای نشان دادن علائم منفی و همچنین اعداد با علائم واحد پولی مربوط به آنها پشتیبانی می‌کند. سازمان‌یار همچنین به طور خودکار تشخیص می‌دهد که از کدام جداکننده هزارگان و اعشاری استفاده می‌شود. اگر از نماد ارزی استفاده شود که سازمان‌یار آن را نمی‌شناسد، ممکن است متن به شکل عدد شناخته نشود و فرایند ایمپورت با مشکل مواجه شود.

توجه

هنگام بارگیری فایل CSV, منوی فرمت‌بندی در ستون سمت راست ظاهر می‌شود. در زیر این گزینه‌ها، می‌توان جداکننده هزارگان را تغییر داد.

نمونه‌هایی از اعداد پشتیبانی شده (با استفاده از مثال "سی و دو هزار"):

  • 32.000,00

  • 32000,00

  • 32,000.00

  • -32000.00

  • (32000.00)

  • $ 32.000,00

  • (32000.00 €)

مثالی که کار نخواهد کرد:

  • ABC 32.000,00

  • $ (32.000,00)

مهم

() (پرانتز) در اطراف عدد نشان می‌دهد که عدد یک مقدار منفی است. ضروری است که نماد واحد پول داخل پرانتز قرار داده شود تا سازمان‌یار آن را به عنوان یک مقدار ارز منفی تشخیص دهد.

عدم نمایش درست جدول پیش‌نمایش ایمپورت

به طور پیش‌فرض، پیش‌نمایش ایمپورت از ویرگول به عنوان جداکننده فیلدها و علامت نقل قول به عنوان جداکننده متن استفاده می‌کند. اگر فایل CSV شما این تنظیمات را ندارد، گزینه‌های فرمت‌بندی را (که بعد از انتخاب فایل CSV در زیر نوار ایمپورت CSV نمایش داده می‌شود) تغییر دهید.

مهم

اگر فایل CSV (مقادیر جدا شده با کاما) از کاراکتر تب به عنوان جداکننده استفاده کند، سازمان‌یار جداسازی‌ها را تشخیص نمی‌دهد. باید گزینه‌های فرمت فایل را در برنامه صفحه گسترده اصلاح کنید. به بخش تغییر فرمت فایل زیر مراجعه کنید.

تغییر فرمت فایل CSV در برنامه صفحه گسترده

هنگام ویرایش و ذخیره فایل‌های CSV در برنامه‌های صفحه گسترده، تنظیمات منطقه‌ای کامپیوتر برای جداکننده و علامت محدود کننده اعمال می‌شود. تسهیل‌گستر استفاده از OpenOffice یا LibreOffice را پیشنهاد می‌کند، زیرا هر دو برنامه امکان اصلاح هر سه گزینه را فراهم می‌کنند (در برنامه LibreOffice، از مسیر Save As ◄ Edit filter settings ◄ Save استفاده کنید).

مایکروسافت اکسل می‌تواند هنگام ذخیره، رمزگذاری را تغییر دهد (Save As ◄ Tools ◄ Encoding).

تفاوت شناسه پایگاه داده و شناسه خارجی

برخی از فیلدها، رابطه‌ای با یک شیء دیگر تعریف می‌کنند. برای مثال، کشور یک مخاطب، پیوندی به یک رکورد از شیء «کشور» است. هنگام ایمپورت چنین فیلدهایی، سازمان‌یار باید دوباره پیوندها را بین رکوردهای مختلف ایجاد کند. برای کمک به ایمپورت این فیلدها، سازمان‌یار سه مکانیزم ارائه می‌دهد.

مهم

فقط باید یک مکانیسم برای هر فیلدی که در حال ایمپورت است استفاده شود.

برای مثال، برای ارجاع به کشور مخاطب، سازمان‌یار سه فیلد را برای ایمپورت پیشنهاد می‌کند:

  • کشور: نام یا کد کشور

  • شناسه کشور/پایگاه داده: شناسه منحصر به فرد در سازمان‌یار برای رکورد، که توسط ستون ID PostgreSQL تعریف می‌شود.

  • کشور/شناسه خارجی: شناسه این رکورد که در برنامه دیگری (یا فایل .XML که آن را ایمپورت کرده است) ارجاع داده شده است.

برای مثال، برای کشور ایران، از این سه روش برای ایمپورت استفاده کنید:

  • کشور: Iran

  • کشور/شناسه پایگاه داده: 98

  • کشور/شناسه خارجی: base.ir

با توجه به نیاز شرکت، از یکی از این سه روش برای ارجاع به رکوردها در روابط استفاده کنید. در اینجا مثالی از زمانی که هر کدام باید استفاده شوند، با توجه به نیاز، آورده شده است:

  • کشور: این ساده‌ترین روش برای زمانی است که داده‌ها از فایل‌های CSV که به صورت دستی ایجاد شده‌اند، می‌آیند.

  • کشور/شناسه پایگاه داده: این روش باید به ندرت استفاده شود. این روش بیشتر توسط توسعه‌دهندگان استفاده می‌شود زیرا مزیت اصلی آن این است که هرگز تضادی ایجاد نمی‌کند (ممکن است چندین رکورد با نام یکسان وجود داشته باشد، اما همه همیشه یک شناسه پایگاه داده منحصر به فرد دارند)

  • کشور/شناسه خارجی: هنگام ایمپورت داده‌ها از یک برنامه شخص ثالث از شناسه خارجی استفاده کنید.

هنگام استفاده از شناسه‌های خارجی، فایل‌های CSV را با ستون شناسه خارجی (شناسه) که شناسه خارجی هر رکورد ایمپورت شده را تعریف می‌کند، ایمپورت کنید. سپس، می‌توان با ستون‌هایی مانند Field/External ID به آن رکورد ارجاع داد. دو فایل CSV زیر مثالی برای محصولات و دسته‌های آنها ارائه می‌دهند.

ایمپورت فیلدهای رابطه‌دار

یک شیء سازمان‌یار همیشه به بسیاری از اشیاء دیگر مرتبط است (به عنوان مثال، یک محصول به دسته‌بندی محصول، ویژگی‌ها، فروشندگان و غیره مرتبط است). برای ایمپورت این روابط، ابتدا باید رکوردهای شیء مرتبط از فهرست منوی خودشان ایمپورت شوند.

این کار را می‌توان با استفاده از نام رکورد مرتبط یا شناسه آن، بسته به شرایط، انجام داد. زمانی که دو رکورد نام یکسانی دارند، از شناسه استفاده می‌شود. در چنین مواردی / ID را در انتهای عنوان ستون اضافه کنید (به عنوان مثال برای ویژگی‌های محصول: ویژگی‌های محصول / ویژگی / ID).

گزینه‌های مربوط به تطبیق چندگانه در فیلدها

به عنوان مثال، اگر دو دسته‌بندی محصول با نام زیرمجموعه قابل فروش وجود داشته باشد (مانند محصولات متفرقه/قابل فروش و محصولات دیگر/قابل فروش)، تأیید متوقف می‌شود، اما همچنان ممکن است داده‌ها ایمپورت شوند. با این حال، سازمان‌یار توصیه می‌کند که ایمپورت انجام نشود، زیرا همه آنها به اولین دسته قابل فروش در لیست دسته محصول (محصولات متفرقه/قابل فروش) مرتبط می‌شوند. در مقابل، سازمان‌یار توصیه می‌کند مقادیر تکراری یا سلسله مراتب دسته‌بندی محصول را اصلاح کنید.

با این حال، اگر شرکت مایل به تغییر پیکربندی دسته‌های محصول نیست، سازمان‌یار استفاده از شناسه خارجی را برای فیلد دسته توصیه می‌کند.

ایمپورت فیلدهای many2many رابطه‌دار

برچسب‌ها باید با ویرگول و بدون فاصله از هم جدا شوند. به عنوان مثال، اگر یک مشتری باید به هر دو برچسب تولید کننده و خرده فروش مرتبط شود، باید تولید کننده، خرده فروش در همان ستون فایل CSV وارد شود.

ایمپورت روابط one2many یک به چند

اگر شرکتی می‌خواهد یک سفارش فروش با چند سطر سفارش را ایمپورت کند، باید یک ردیف در فایل CSV برای هر سطر سفارش رزرو شود. اولین سطر سفارش در همان ردیف به عنوان اطلاعات مرتبط با سفارش ایمپورت می‌شود. هر سطر دیگر به یک ردیف دیگر نیاز دارد که هیچ اطلاعاتی در فیلدهای مربوط به سفارش نداشته باشد.

به عنوان مثال، در اینجا یک فایل CSV که بر اساس داده‌های دمو می‌توان آن را ایمپورت کرد، آورده شده است:

فایل CSV زیر نحوه ایمپورت سفارش‌ها خرید را به همراه سطرهای مربوطه نشان می‌دهد:

فایل CSV زیر نحوه ایمپورت مشتریان و اطلاعات تماس آنها را نشان می‌دهد:

ایمپورت فایل‌های تصویری

برای ایمپورت فایل‌های تصویر همراه با فایل CSV یا اکسل آپلود شده، مراحل زیر را دنبال کنید:

  1. نام فایل‌های تصویر را به ستون مربوطه تصویر در فایل داده اضافه کنید.

  2. فایل داده را آپلود کنید یا با کلیک روی بارگذاری فایل داده آن را دوباره بارگیری کنید.

  3. در بخش فایل‌ها برای ایمپورت روی آپلود فایل‌ها کلیک کنید.

  4. فایل‌های تصویر مربوطه را انتخاب کنید. تعداد فایل‌های انتخاب شده در کنار دکمه نمایش داده می‌شود.

  5. روی تست کلیک کنید تا از معتبر بودن همه داده‌ها اطمینان حاصل کنید.

  6. روی ایمپورت کلیک کنید. در فرآیند ایمپورت، سازمان‌یار یک بررسی فایل انجام می‌دهد تا به طور خودکار تصاویر آپلود شده را به فایل داده وارد شده پیوند دهد. اگر تطبیقی وجود نداشته باشد، فایل داده بدون هیچ تصویری ایمپورت می‌شود.

توجه

  • اگر قالب محصول دارای ستون تصویر با تمام فیلدهای پر شده باشد،بخش فایل‌ها برای ایمپورت فعال می‌شود.

  • نام فایل‌های تصویر در فایل داده باید با فایل‌های تصویر آپلود شده مطابقت داشته باشد.

  • هنگام ایمپورت تعداد زیادی تصویر، می‌توانید حداکثر اندازه هر دسته را به مگابایت مشخص کنید و یک تأخیر تنظیم کنید تا از اضافه بار سیستم جلوگیری شود. برای این کار، حالت توسعه‌دهنده را فعال کنید و فیلدهای حداکثر اندازه هر دسته و تأخیر پس از هر دسته را در بخش فایل‌ها برای ایمپورت وارد کنید. به طور پیش‌فرض، تأخیر با محدودیت تماس RPC/API تعریف شده در سیاست استفاده قابل قبول Odoo Cloud مطابقت دارد.

ایمپورت چندباره رکوردها

اگر فایل ایمپورت شامل یکی از ستون‌های شناسه خارجی یا شناسه پایگاه داده باشد، رکوردهایی که قبلاً ایمپورت شده‌اند به جای ایجاد شدن، ویرایش می‌شوند. این ویژگی بسیار مفید است و به کاربران اجازه می‌دهد تا چندین بار فایل CSV را با اعمال تغییرات ایمپورت کنند.

سازمان‌یار به طور خودکار ایجاد یا ویرایش رکورد را با توجه به جدید بودن یا نبودن تشخیص می‌دهد.

این ویژگی به شرکت اجازه می‌دهد تا از ابزار Import/Export در سازمان‌یار برای ویرایش دسته‌ای از رکوردها در برنامه صفحه گسترده استفاده کند.

عدم وجود مقدار برای فیلد

اگر همه فیلدها در فایل CSV تنظیم نشده باشند، سازمان‌یار برای هر فیلد تعریف نشده، مقدار پیش‌فرض را اختصاص می‌دهد. اما اگر فیلدها با مقادیر خالی در فایل CSV تعریف تنظیم شده باشند، سازمان‌یار به جای اختصاص دادن مقدار پیش‌فرض، مقدار خالی را در فیلد اعمال می‌کند.

اکسپورت/ایمپورت جدول‌های مختلف از برنامه SQL در سازمان‌یار

اگر داده‌ها باید از جداول مختلف ایمپورت شوند، باید روابط بین رکوردهای متعلق به جداول مختلف دوباره ایجاد شوند. به عنوان مثال، اگر شرکت‌ها و افراد در حال ایمپورت باشند، باید پیوند هر مخاطب و شرکتی که در آن کار می‌کند دوباره ایجاد شود.

برای مدیریت روابط بین جداول، از امکانات شناسه خارجی استفاده کنید. شناسه خارجی یک رکورد، شناسه منحصر به فرد آن رکورد در برنامه دیگر است. شناسه خارجی باید در بین تمام رکوردهای تمام اشیاء منحصر به فرد باشد. یک روش خوب این است که پیشوند این شناسه خارجی را بر اساس نام برنامه یا جدول قرار دهید. (مانند، company_1, person_1 - به جای 1)

به عنوان مثال، فرض کنید یک پایگاه داده SQL با دو جدول وجود دارد که باید ایمپورت شوند: شرکت‌ها و افراد. هر شخص به یک شرکت تعلق دارد، بنابراین باید پیوند بین شخص و شرکتی که برای آن کار می‌کند دوباره ایجاد شود.

این مثال را با نمونه‌ای از یک پایگاه داده PostgreSQL آزمایش کنید.

ابتدا، همه شرکت‌ها و شناسه خارجی آنها را صادر کنید. در PSQL، دستور زیر را بنویسید:

> copy (select 'company_'||id as "External ID",company_name as "Name",'True' as "Is a Company" from companies) TO '/tmp/company.csv' with CSV HEADER;

این دستور، فایل CSV زیر را ایجاد می‌کند:

External ID,Name,Is a Company
company_1,Bigees,True
company_2,Organi,True
company_3,Boum,True

برای ایجاد فایل CSV برای افراد مرتبط با شرکت‌ها، از دستور SQL زیر در PSQL استفاده کنید:

> copy (select 'person_'||id as "External ID",person_name as "Name",'False' as "Is a Company",'company_'||company_id as "Related Company/External ID" from persons) TO '/tmp/person.csv' with CSV

که باعث تولید فایل CSV زیر می‌شود:

External ID,Name,Is a Company,Related Company/External ID
person_1,Fabien,False,company_1
person_2,Laurence,False,company_1
person_3,Eric,False,company_2
person_4,Ramsy,False,company_3

در این فایل، فابین و لارنس برای شرکت Bigees (company_1) کار می‌کنند و اریک برای شرکت Organi کار می‌کند. رابطه بین افراد و شرکت‌ها با استفاده از شناسه خارجی شرکت‌ها انجام می‌شود. شناسه خارجی با نام جدول پیشوند می‌شود تا از تضاد شناسه بین افراد و شرکت‌ها (person_1 و company_1 که شناسه 1 را در پایگاه داده اصلی به اشتراک می‌گذاشتند) جلوگیری شود.

دو فایل تولید شده آماده هستند تا بدون هیچ گونه تغییری در سازمان‌یار ایمپورت شوند. پس از ایمپورت این دو فایل, چهار مخاطب و سه شرکت وجود دارد (دو مخاطب اول به شرکت اول مرتبط هستند). به خاطر داشته باشید که ابتدا شرکت‌ها و سپس افراد را ایمپورت کنید.

به‌روزرسانی داده‌ها در سازمان‌یار

داده‌های موجود را می‌توان به صورت عمده از طریق ایمپورت داده به‌روزرسانی کرد، به شرطی که شناسه خارجی ثابت باقی بماند.

آماده‌سازی اکسپورت داده

برای به‌روزرسانی داده‌ها از طریق ایمپورت، ابتدا به داده‌هایی که باید به‌روزرسانی شوند بروید و |list| را برای فعال‌سازی نمای لیست انتخاب کنید. در سمت راست لیست، کادر انتخاب را برای هر رکوردی که باید به‌روزرسانی شود تیک بزنید. سپس، روی |actions| کلیک کنید و از منوی کشویی :icon:`fa-upload` اکسپورت را انتخاب کنید.

در پنجره اکسپورت داده که ظاهر می‌شود، گزینه می‌خواهم داده‌ها را به‌روزرسانی کنم (اکسپورت سازگار با واردات) را تیک بزنید. این کار به طور خودکار شناسه خارجی را در اکسپورت شامل می‌کند. علاوه بر این، لیست فیلدها برای اکسپورت را به فقط فیلدهایی که قابل ایمپورت هستند محدود می‌کند.

توجه

فیلد شناسه خارجی در لیست فیلدها برای اکسپورت ظاهر نمی‌شود مگر اینکه به صورت دستی اضافه شود، اما همچنان در اگسپورت گنجانده می‌شود. ولی اگر گزیه می‌خواهم داده‌ها را به‌روزرسانی کنم (اکسپورت سازگار با واردات) تیک خورده باشد، در اکسپورت گنجانده می‌شود.

فیلدهای مورد نیاز برای قرار دادن در اکسپورت را با استفاده از گزینه‌ها در پنجره پاپ‌آپ انتخاب کنید، سپس روی اکسپورت کلیک کنید.

ایمپورت داده‌های به‌روزرسانی شده

پس از اکسپورت، تغییرات لازم را در فایل داده اعمال کنید. هنگامی که فایل آماده شد، می‌توان آن را با دنبال کردن فرآیندی مشابه ایمپورت عادی داده، ایمپورت کرد.

خطر

هنگام به‌روزرسانی داده‌ها، بسیار مهم است که شناسه خارجی ثابت باقی بماند، زیرا این روشی است که سیستم یک رکورد را شناسایی می‌کند. اگر شناسه تغییر کند یا حذف شود، سیستم ممکن است به جای به‌روزرسانی رکورد موجود، یک رکورد تکراری اضافه کند.