HotXLS Component: VBA payload and external link preservation في Delphi

أنشئ وحرر وافحص واحسب وصدّر مصنفات Excel مباشرة من كود Delphi أو C++Builder. HotXLS مكتبة جداول Object Pascal أصلية مع المصدر لسير عمل XLS وXLSX، ومناسبة لأدوات سطح المكتب والمهام الدفعية وأنظمة التقارير وتوليد المستندات على الخادم دون أتمتة Microsoft Excel.

هذه المقالة موجّهة إلى teams editing workbook content while preserving macro payloads and link relationships they do not own. وهي تتعامل مع VBA payload and external link preservation كجزء من هندسة المستندات في بيئة الإنتاج، لا كاستدعاء سريع لمكوّن.

الخطر العملي هو أن a workbook can save successfully while silently dropping VBA projects, changing link targets, or refreshing data connections against policy. لذلك يحتاج المسار إلى عقد واضح وتشخيص قابل للملاحظة وملفات اختبار واقعية.

قرارات البنية

Identify protected workbook assets before editing. whether macro-enabled workbooks are accepted, preserved, blocked, or converted / external link inventory, update policy, trusted domains, and refresh behavior

whether macro-enabled workbooks are accepted, preserved, blocked, or converted
external link inventory, update policy, trusted domains, and refresh behavior
which workbook edits are allowed without rewriting protected payloads
security warning, operator review, and audit-report requirements

مسار التنفيذ

Preserve opaque payloads unless policy says otherwise. The order below keeps the workflow reviewable for Delphi and C++Builder teams.

inventory VBA projects, external links, data connections, and defined names before editing
load worksheet data changes without executing or refreshing external content
preserve opaque payloads where policy allows and mark blocked content clearly
save in a format that supports the required payloads
compare pre-save and post-save inventories before delivery

أدلة التحقق

Preservation evidence for governed workbooks. Keep these fields with the output or support record.

macro presence, VBA project preservation status, and macro-enabled format decision
external link targets, trusted or blocked status, and refresh policy
payload inventory before and after save
operator decision for workbooks with governed content

Preservation is not execution

Preserving VBA payloads and external links means keeping workbook structures intact while clearly avoiding automatic trust or execution. The application should inventory what exists and decide what is allowed to change.

ملاحظات تنفيذ للإنتاج

اجعل موضوع «HotXLS Component: VBA payload and external link preservation في Delphi» عقد خدمة واضحا حول استدعاءات HotXLS، مع فصل التحقق من الإدخال وكتابة المصنف وفحص الخرج وأدلة الدعم

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

حالات فشل يجب اختبارها

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

مثال Delphi تفصيلي

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

procedure UpdateLinkedWorkbookWithoutBreakingMacros(const InputFile, OutputFile: string; const Update: TWorkbookUpdate);
var
  Wb: TXLSXWorkbook;
  BeforeState: TMacroLinkInventory;
  AfterState: TMacroLinkInventory;
begin
  RequireFileExists(InputFile);
  Wb := TXLSXWorkbook.Create;
  try
    Wb.Open(InputFile);
    BeforeState := CaptureMacroAndLinkInventory(Wb);
    AssertAllowedExternalLinks(BeforeState, Update.AllowedLinkHosts);

    SetNamedValue(Wb, 'RefreshDate', Update.RefreshDate);
    FillNamedTable(Wb, 'DataRefreshRows', Update.Rows);
    Wb.Calculate;

    if Wb.SaveAs(OutputFile) <> 1 then
      RaiseWorkbookSaveError(OutputFile);

    AfterState := InspectMacroAndLinkInventory(OutputFile);
    AssertMacroModulesPreserved(BeforeState, AfterState);
    AssertExternalLinksPolicy(AfterState, Update.AllowedLinkHosts);
    WriteMacroLinkAudit(OutputFile, BeforeState, AfterState);
  finally
    Wb.Free;
  end;
end;

قائمة فحص الإنتاج

Run the workflow on an empty workbook, a normal customer workbook, and a worst-case workbook
Open the output with the target spreadsheet application or downstream importer
Log product version, template version, profile, row count, output path, elapsed time, and warning count
Keep passwords, temporary files, customer data, and support bundles under explicit retention rules
Add regression workbooks when a customer file exposes a new edge case

Product documentation

HotXLS Component