ملف البيان

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

وتوفر الأقسام التالية معلومات إضافية حول ملفات البيان.

معامل مجموعة خيارات البيان

يتم دعم إنشاء ملف البيان في بعض عناصر التحكم في مجموعة المعالجة المرتبطة باستخراج المنتج الأساسي فقط. تتضمن عناصر التحكم في مجموعة المعالجة هذه معلمة مجموعة معالجة خيار البيان التي تتحكم فيما إذا كان يجب إنشاء ملف بيان أم لا عند إتمام عملية مجموعة المعالجة بنجاح. يمكنك استخدام بوابة الاستعلام عن التحكم في مجموعة المعالجة للبحث عن كل عناصر التحكم في مجموعة المعالجة التي تدعم هذا الخيار.

معلومات ملف البيان

يتم توفير محتوى ملف البيان بتنسيق JSON ويتضمن المعلومات التالية:
  • إصدار هيكل تفاصيل البيان.

  • رمز التحكم في مجموعة المعالجة ورقم التشغيل ورقم إعادة التشغيل الذي يحدد تشغيل مجموعة المعالجة الذي ينتج عنه الملفات

  • إجمالي عدد الملفات التي تم تكوينها بواسطة تشغيل مجموعة المعالجة.

  • إجمالي عدد السجلات التي تمت معالجتها بواسطة تشغيل مجموعة المعالجة.

  • الطابع الزمني لإنشاء البيان بتنسيق المنظمة الدولية للمعايرة (ISO).

  • رقم تشغيل مجموعة المعالجة المكتمل مسبقًا، إن وجد.

  • ملف البيان الناتج عن تشغيل مجموعة المعالجة المكتمل مسبقًا، إن وجد. يمكن استخدام ذلك لضمان معالجة الملفات بترتيب مناسب والمساعدة في اكتشاف الحالات المحتملة لعدم وجود الملفات.

  • قائمة الملفات التي تم إنشاؤها بواسطة تشغيل مجموعة المعالجة والتي تتضمن التفاصيل التالية لكل ملف: اسم الملف وحجمه بالبايت وقيمة شفرة هاش SHA-256 لمحتوى الملف.

تم تكوين اسم ملف البيان كما يلي:
[batch control]_[batch run number]_[batch rerun number]_manifest.json

فيما يلي مثال لهيكل ملف البيان.

{
  "version": 1,
  "batchCode": "HD-PDE",
  "batchRunNumber": 106,
  "batchRerunNumber": 0,
  "totalFiles": 3,
  "recordsProcessed": 10,
  "timeStamp": "2020-05-02T16:55:43.000353Z",
  "previousBatchRunNumber":"105"
  "previousManifestFileName":"HD-PDE_105_0_manifest.json",
  "fileDetails": [
    {
      "fileName": "SOME_FILE_NAME_001.json.gz",
      "fileSize": 1543,
      "hashAlgorithm": "SHA-256",
      "hashValue": "ff7d4e466f93cadc4a18ab009080916baff631e03b728e2f2684c4a4f92ccbe1"
    },
    {
      "fileName": "SOME_FILE_NAME_002.json.gz",
      "fileSize": 1182,
      "hashAlgorithm": "SHA-256",
      "hashValue": "78869e7ce971f28a70f5b35693a05726ba66109fecf492edb60291a62ae1ba9f"
    },
    {
      "fileName": "SOME_FILE_NAME_003.json.gz",
      "fileSize": 1182,
      "hashAlgorithm": "SHA-256",
      "hashValue": "78869e7ce971f28a70f5b35693a05726ba66109fecf492edb60291a62ae1ba9f"
    }
  ]
}{

التحقق من ملف البيان

يمكن استخدام خدمة الويب "التحقق من ملف البيان" بواسطة نظام خارجي للتحقق من عدم تلف ملف البيان الذي استلمه لتشغيل مجموعة معالجة محدد أو العبث به. تُرجع الخدمة اسم ملف البيان وقيمة شفرة هاش لمحتوياتها لتشغيل مجموعة المعالجة المطلوب، مما يسمح للمستدعي بمقارنة تفاصيل الملف الخاصة به بالقيم المرتجعة.