العربية

ترجمة بالذكاء الاصطناعي. لم يراجعها المجتمع بعد. اقرأ بالإنجليزية

المدوّنة · 15 سبتمبر 2023 · Steve Simpson · التكامل

خطوات Salesforce Bulk API: استيراد البيانات عند رصيف التحميل

مقدمة:

في هذه المقالة سنستكشف Salesforce Bulk API، وهي أداة قوية مصممة لاستيراد مجموعات البيانات الكبيرة إلى Salesforce بكفاءة. فعلى عكس REST API التي تحدّك بـ 200 سجل في كل استدعاء، تتيح Bulk API إدراج ملايين السجلات عبر عملية مبسّطة.

القسم 1: فهم عملية Bulk API

تعمل Salesforce Bulk API عبر عملية من خمس خطوات لاستيراد أحجام كبيرة من البيانات بسلاسة:

مخطط: عميل خارجي يحمّل 1,000,000 سجل عبر REST API بمعدل 200 سجل في كل استدعاء يحتاج إلى 5,000 استدعاء API مخطط: خطوات Bulk API الخمس بين عميل خارجي وSalesforce: فتح مهمة، ورفع الملفات، وبدء المعالجة، والتحقق من الحالة، وتنزيل النجاحات والإخفاقات

  1. فتح المهمة (الخطوة 1): ابدأ العملية بفتح مهمة (job)، فتحصل على معرّف مهمة فريد (job ID). هذه الخطوة تشبه استلام تذكرة تمنحك حق الدخول إلى رصيف التحميل.
  2. رفع الملفات (الخطوة 2): بمعرّف المهمة يمكنك البدء في رفع ملفات البيانات بصيغة CSV. يمكن أن يحتوي كل ملف على ما يصل إلى 10,000 سجل، مع مراعاة حدود الحجم. ويمكنك رفع عدة ملفات تحت معرّف المهمة نفسه.
  3. بدء المعالجة (الخطوة 3): بعد اكتمال الرفع، أبلغ Salesforce أن تبدأ معالجة البيانات بالضغط على «الزر الأزرق الكبير» المجازي. عندها تبدأ Salesforce معالجة الملفات المرفوعة.
  4. التحقق من حالة المهمة (الخطوة 4): أثناء المعالجة، يمكنك الاستعلام عن حالة المهمة باستخدام معرّف المهمة. تتيح لك هذه الخطوة متابعة تقدّم استيراد البيانات.
  5. تنزيل النتائج (الخطوة 5): بعد اكتمال المعالجة، يمكنك تنزيل النتائج. ولديك خيار تنزيل السجلات الناجحة، التي تتضمن معرّفات Salesforce للسجلات المُدرجة أو المحدّثة حديثًا، أو السجلات الفاشلة التي تقدّم تفاصيل عن الأخطاء التي وقعت.

القسم 2: عرض Bulk API عمليًا باستخدام Postman

لتوضيح عملية Bulk API، سنستخدم Postman للتعامل مع بيئة sandbox في Salesforce:

  1. المصادقة: ابدأ بالمصادقة لتحصل على رمز وصول (access token).
  2. إنشاء مهمة جديدة: ابدأ مهمة جديدة بإرسال طلب لإنشاء مهمة. سيعطيك هذا الإجراء معرّف مهمة.
  3. رفع البيانات: ضع معرّف المهمة في عنوان URL وارفع بياناتك. في هذا المثال سننشئ حسابًا جديدًا اسمه “Bart Buildings”.
  4. بدء المعالجة: أبلغ Salesforce أن تبدأ المعالجة بإرسال طلب يحمل معرّف المهمة والحالة “Upload Complete”.
  5. التحقق من حالة المهمة: تابع تقدّم المهمة بالتحقق من حالتها باستخدام معرّف المهمة. وعندما تكتمل المهمة، يمكنك الانتقال إلى الخطوة التالية.
  6. تنزيل السجلات الناجحة: استرجع معرّف Salesforce للسجلات المنشأة حديثًا بتنزيل السجلات الناجحة باستخدام معرّف المهمة.

لقطة شاشة من Postman، الخطوة 1: طلب POST ينشئ مهمة إدخال (ingest job) في Bulk API، مع معرّف المهمة الجديدة في الاستجابة لقطة شاشة من Postman، الخطوة 2: طلب PUT يرفع بيانات CSV إلى المهمة، ويعيد 201 Created لقطة شاشة من Postman، الخطوة 3: طلب PATCH يضبط حالة المهمة على UploadComplete لبدء المعالجة لقطة شاشة من Postman، الخطوة 4: طلب GET يتحقق من حالة المهمة، ويُظهر JobComplete لقطة شاشة من Postman، الخطوة 5: طلب GET ينزّل النتائج الناجحة بصيغة CSV، مع معرّف السجل الجديد

القسم 3: الخلاصة

تقدّم Salesforce Bulk API طريقة فعّالة لاستيراد مجموعات بيانات كبيرة إلى Salesforce بأقل عدد من استدعاءات API. فعبر عملية بسيطة من خمس خطوات، يمكنك إدراج ملايين السجلات أو تحديثها أو حتى حذفها بكفاءة. وسواء كنت تتعامل مع سجل واحد أو مع الملايين، توفر Bulk API حلًا سريعًا وموثوقًا لاحتياجاتك في استيراد البيانات.

تابعنا

شكرًا لانضمامك إلينا في استكشاف Salesforce Bulk API. تابعنا لمزيد من المحتوى المفيد حول الاستفادة من ميزات Salesforce القوية!

انضم إلى www.SteveTechArc.com وإلى قناة @SteveTechArc (opens in a new tab) على YouTube. اشترك وعمّق فهمك لـ Salesforce وكيف يمكنك دمجها مع أنظمة أخرى.

نساعد في تغيير العالم بمشاركة معلومات التكامل مع زملائنا المعماريين ومع من هم في رحلتهم نحو أن يصبحوا معماريين!

نص مكتوب بمساعدة الذكاء الاصطناعي

STA 1.7