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

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

مهم

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

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

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

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

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

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

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

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

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

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

  4. دکمه آیکون (انتخاب فیلد) برای افزودن فیلدها به لیست فیلدها برای برون‌بری وجود دارد.

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

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

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

نکته

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

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

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

هشدار

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

نکته

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

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

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

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

شروع به کار

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

نمای شیءای که داده‌ها باید در آن درون‌ریزی/درج شوند را باز کنید، روی آیکون (اقدام) کلیک کنید و در منوی کشویی (درون‌ریزی رکوردها) را انتخاب کنید.

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

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

برای بارگذاری قالب دانلود شده یا یک فایل موجود، مراحل بعدی را دنبال کنید:

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

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

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

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

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

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

توجه

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

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

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

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

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

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

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

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

توجه

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

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

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

نکته

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

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

شناسه خارجی (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 برای هر سطر سفارش رزرو شود. اولین سطر سفارش در همان ردیف به عنوان اطلاعات مرتبط با سفارش ایمپورت می‌شود. هر سطر دیگر به یک ردیف دیگر نیاز دارد که هیچ اطلاعاتی در فیلدهای مربوط به سفارش نداشته باشد.

Example

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

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

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

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

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

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

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

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

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

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

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

توجه

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

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

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

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

اگر فایل ایمپورت شامل یکی از ستون‌های شناسه خارجی یا شناسه پایگاه داده باشد، رکوردهایی که قبلاً ایمپورت شده‌اند به جای ایجاد شدن، ویرایش می‌شوند. این ویژگی بسیار مفید است و به کاربران اجازه می‌دهد تا چندین بار فایل 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 را در پایگاه داده اصلی به اشتراک می‌گذاشتند) جلوگیری شود.

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

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

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

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

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

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

توجه

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

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

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

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

خطر

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