9. فضاء الأسماء data:: — البيانات الخارجية

← fix:: · الفهرس · التالي: المكتبة القياسية →

8 دوال لمطابقة محتوى ملف PDF بقوائمك وجداولك. وكل شيء يجري محليًا: لا تخرج أي بيانات.

9.1 أين توضع الملفات

تقبل المسارد ومجموعات البيانات مسارًا نسبةً إلى مجلد التنفيذ:

data::load_glossary("terms/legal.txt")
data::load_dataset("data/batches.csv")

أما جداول البحث (query_gtin وquery_medicamento وquery_postal_code) فتستعمل أسماء ملفات ثابتة وتبحث عنها بهذا الترتيب:

1. $PDFL_DATA_DIR (متغير البيئة)
2. ./dados/
3. ./
4. الملفات التعريفية المثبَّتة بـ pdfl add (pdfl_profiles/*/dados/)
5. مجلد ملف PDF المُحلَّل

PDFL_DATA_DIR=/opt/databases pdfl run profile.pdfl document.pdf

وإن لم يُعثر على شيء دلّت رسالة الخطأ على مكان وضع الملف. ولتوزيع البيانات مع الملف التعريفي استعمل pdfl pack (الفصل 11).

9.2 المسارد ومجموعات البيانات

المقارنة تتجاهل حالة الأحرف والمسافات.

terms/required.txt:

# مصطلحات يجب أن تحتويها كل وثيقة تأمين
waiting period
covered benefits
general conditions

check "Glossary and dataset" {
  terms = data::load_glossary("terms/required.txt")
  print("terms in the glossary:", terms.length)

  // أبسط الاستعمالات
  missing = data::validate_against_reference("terms/required.txt")
  assert missing.length == 0,
    "clauses missing from the policy: #{missing.join("; ")}"

  rows = data::load_dataset("data/batches.csv")
  print("columns:", rows.first().join(" | "))   // الصف الأول هو الترويسة
  print("records:", rows.length - 1)

  // null خاطئ، فيمكن كتابة التدقيق مباشرة
  batch = text::extract_from_region(1, region(400, 50, 150, 20)).trim()
  description = data::lookup_value("data/batches.csv", batch)
  assert description, "batch #{batch} is not in the approved list"
}

9.3 جداول البحث

ملفات بأسماء ثابتة يُبحث عنها بالترتيب المذكور في 9.1. وتُرجع الصف كاملًا قائمةً، أو null إن لم يوجد شيء.

dados/gtin.csv:

gtin,description,manufacturer
7891234567895,Dipyrone 500mg 20 tablets,Example Labs

check "Lookup tables" {
  // المطابقة مع الباركود المقروء على العبوة
  code = codes::decode_barcode(1)
  product = data::query_gtin(code)
  assert product, "GTIN #{code} is not in the product database"
  print("product:", product.get(2), "| manufacturer:", product.get(3))

  // بيانات الدواء عبر رقم التسجيل
  registration = text::extract_from_region(1, region(50, 780, 200, 15)).trim()
  medicine = data::query_medicamento(registration)
  assert medicine, "registration #{registration} not found"

  // الدواء الموصوف يقتضي العبارة الإلزامية
  band = medicine.get(4)
  assert band != "prescription" || text::require_text("PRESCRIPTION ONLY"),
    "prescription medicine without the mandatory text"

  // هل يوافق العنوان المطبوع الرمز البريدي؟
  assert data::validate_address("01310100", "Avenida Paulista"),
    "printed address does not match the given postal code"
}

9.4 مثال كامل

// insert_with_databases.pdfl — المطابقة ببيانات محلية
// الاستعمال: PDFL_DATA_DIR=./databases pdfl run insert_with_databases.pdfl insert.pdf
profile "insert-with-references" {

  check "Mandatory regulatory terms" tags: ["glossary"] {
    missing = data::validate_against_reference("databases/regulatory_terms.txt")
    assert missing.length == 0, "mandatory texts missing: #{missing.join("; ")}"
  }

  check "Product in the database" tags: ["data", "critical"] {
    code = codes::decode_barcode(1)
    product = data::query_gtin(code)
    assert product, "GTIN #{code} not approved"

    // الاسم المسجَّل يجب أن يظهر في المطبوع
    name = product.get(2)
    assert text::require_text(name),
      "the name '#{name}' from the database does not appear on the insert"
    print("product verified:", name)
  }

  check "Registration and band" tags: ["regulatory"] {
    registration = text::extract_from_region(1, region(50, 780, 200, 15)).trim()
    med = data::query_medicamento(registration)
    assert med, "registration #{registration} not found"
    assert med.get(4) != "prescription" || text::require_text("PRESCRIPTION ONLY"),
      "prescription band requires the prescription notice"
  }

  check "Manufacturer address" tags: ["data"] {
    assert data::validate_address("01310100", "Avenida Paulista"),
      "manufacturer address does not match the postal code"
  }
}

← fix:: · الفهرس · التالي: المكتبة القياسية →