المدونة

تقسيم ملف منتجات freee Sales بصيغة CSV إلى دفعات من 999 سجلًا

يقبل استيراد بيانات المنتجات في freee Sales ألف صف كحد أقصى مع الترويسة. اضبط أداة التقسيم على 999 سجلًا لكل ملف، واحتفظ بالترويسة والأصفار الأولى وراجع المعاينة.

رسم يوضح تقسيم ملف CSV إلى ملف كبير وآخر صغير مع ترويسة متطابقة في كليهما.

لتقسيم ملف CSV الخاص بسجل المنتجات في freee Sales (freee販売)، افتح أداة CSV Splitter بواجهة إنجليزية واضبط Maximum data rows per output file على 999، مع تفعيل تكرار السجل الأول كترويسة في كل ملف. بهذه الطريقة يحتوي كل ملف على 999 سجلًا للمنتجات مع صف ترويسة واحد كحد أقصى، أي 1000 سجل إجمالًا.

هذا القيد لا يشمل جميع عمليات استيراد CSV في freee، بل استيراد معلومات المنتجات في freee Sales تحديدًا. تنص تعليمات الاستيراد والتصدير الرسمية على حد 1000 صف بما فيها الترويسة. لا يخضع التصدير لحد الصفوف نفسه، لذلك قد يتعذر إعادة استيراد ملف مُصدَّر كبير دفعة واحدة. جرى التحقق من هذه القاعدة في 21 نوفمبر 2026.

لا تتوفر واجهة عربية لأداة التقسيم حاليًا؛ يفتح الرابط الواجهة الإنجليزية. نورد أسماء عناصر التحكم الإنجليزية أدناه، أما عناوين الأعمدة اليابانية فهي من نموذج بيانات freee.

ضبط 999 صف بيانات والترويسة كلٍّ على حدة

احتفظ بنسخة من ملف CSV الأصلي وجهّز البيانات وفق أحدث قالب رسمي وتعريفات الحقول. لا تترجم الأداة أسماء الأعمدة ولا تحوّل القيم تلقائيًا إلى التنسيق المطلوب لدى freee.

  1. اختر الملف المحلي في CSV / TSV file to split.
  2. اختر Comma (CSV) في Delimiter، ثم افحص معاينة الملف للتأكد من سلامة الأحرف اليابانية وفواصل الأعمدة. إذا ظهر النص مشوهًا، اختر الترميز الحقيقي من Input encoding.
  3. في Split by اختر Maximum number of data rows، ثم اكتب 999 في Maximum data rows per output file.
  4. فعّل Repeat the first record as a header in each output file. لا تُحتسب الترويسة ضمن 999 سجل بيانات.
  5. إذا كان الملف UTF-8 ولا يحتاج إلى تحويل، اختر Same as input (preserve BOM) في Output encoding. يمكن اختيار UTF-8 (with BOM) عند الحاجة، لكن وجود BOM ليس شرطًا عامًا. اختر Same as input (preserve mixed line endings) في Output record separator.
  6. من Save method اختر Download one file at a time، ثم اضغط Validate and split.
  7. احفظ كل جزء بواسطة Save this CSV، ولا تضغط Confirm download and continue إلا بعد التأكد من اكتمال التنزيل. راجع الملف الأخير وملخص المخرجات أيضًا.

تتيح بعض المتصفحات حفظ الملفات الكبيرة مباشرة في مجلد. في وضع التنزيل الفردي، يؤدي الانتقال قبل الحفظ إلى فقدان رابط الجزء السابق. تجري معالجة CSV بالكامل داخل المتصفح دون رفع محتواه إلى خادم الأداة.

مثال: 1001 منتج افتراضي يُقسم إلى 999 و2

لنفترض وجود CSV يضم 1001 منتج افتراضي. يعرض المقتطف التالي أول ثلاثة سجلات فقط، وليس ملف الاستيراد الكامل. استخدم القالب الرسمي الأحدث للبيانات الفعلية.

名称,帳票・明細への表示名称,コード,販売単価
サンプル商品0001,サンプル商品0001,0001,100
サンプル商品0002,サンプル商品0002,0002,100
サンプル商品0003,サンプル商品0003,0003,100

أسماء الأعمدة اليابانية تعني الاسم، والاسم المعروض في المستندات، والرمز، وسعر البيع للوحدة. إذا تراوحت الرموز بين 0001 و1001، فستكون نتيجة تقسيم products.csv:

الملف سجلات المنتجات الإجمالي مع الترويسة الرموز
products_part_000001.csv 999 1,000 0001–0999
products_part_000002.csv 2 3 1000–1001

يجب أن يبدأ الجزء الثاني بالترويسة نفسها. إن ضبط الحد خطأً على 1000 صف بيانات سينتج 1001 سجل عند إضافة الترويسة. تحسب الأداة سجلات CSV لا أسطر النص الفعلية؛ فلا يُعدّ الانتقال إلى سطر جديد داخل خلية مقتبسة سجلًا آخر. تحقق من قبول freee لهذه القيم في معاينة الاستيراد.

التحقق من الأصفار الأولى والأعمدة الفارغة

لا تحوّل الأداة القيم إلى أرقام، لذا يبقى الرمز 0001 كما هو. لكن فتح CSV وحفظه مجددًا في برنامج جداول قد يزيل الأصفار الأولى. تعامل مع أعمدة الرموز كنص أو افحص الملف بمحرر نصوص. لا تستطيع الأداة استعادة أصفار فُقدت سابقًا.

عند الاستيراد، قد يؤدي تطابق الرمز مع منتج موجود إلى تحديثه، بينما ينشئ الرمز الجديد منتجًا جديدًا. حذف عمود يختلف عن إبقاء العمود مع قيمة فارغة. تختلف نتيجة التحديث باختلاف الحقل؛ راجع جدول الحقول الرسمي. نجاح التقسيم لا يضمن صحة أثر الاستيراد.

مراجعة معاينة freee قبل الاستيراد

في freee Sales افتح 商品一覧 (قائمة المنتجات)، ثم ・・・ → CSVインポート (استيراد CSV)، ثم プレビュー画面へ (المعاينة). راجع عدد السجلات والرموز والأسماء والقيم التي ستتغير. إذا وجدت خطأً، صحّح المصدر وأعد التقسيم، ولا تخلط الملفات القديمة بالجديدة.

المثال مبني على بيانات افتراضية، ولم يتم اختبار استيراد فعلي في freee Sales. تُقدَّم التعليمات الرسمية بشأن الأعمدة الإلزامية والأذونات والقيود، ويجب مراجعة نتائج الاستيراد لاحقًا. أداة CSV Splitter من iXam ليست منتجًا رسميًا من freee ولا تعني وجود شراكة.