الترحيل إلى .NET Standard 2.1

Doconut لديها تكاملين مميزين لـ .NET Standard. يستخدمان نفس اسم الحزمة Doconut.NETStandard، لذا حدد الجيل من الإصدار وواجهات البرمجة في التطبيق قبل تغيير الحزم أو الإعدادات أو التراخيص أو موارد المتصفح.

الإصدار هو الفاصل في الطريق

كلا الجيلين ينشران تحت معرف الحزمة نفسه. فقط الإصدار يميزهما:

رفع رقم الإصدار هو التحديث. لا توجد حزمة منفصلة للتثبيت ولا طبقة توافق — 26.8.0 هو سطح API مختلف. توقع أخطاء تجميع بعد الرفع؛ بقية هذا الدليل هي قائمة بهذه الأخطاء.

أي تكامل تستخدم؟

إذا ظهرت كلا العمودين في نفس التطبيق، اعتبر الترحيل غير مكتمل. لا تُرسل رمز مستند واحد عبر الموارد أو الوسطاء من الجيل الآخر.

تحقق من إطار العمل المضيف أولاً

هذا باب صعب، ليس تفضيلًا. الحزمة الحالية تستهدف netstandard2.1:

.NET Framework لا يمكنه الإشارة إلى مكتبة netstandard2.1. إذا كان التطبيق يعمل على .NET Framework، توقف هنا واستخدم حزمة Doconut.NETFramework بدلاً من ذلك؛ من الإصدار 26.9.0 تتطلب .NET Framework 4.7.2. كلا التطبيقين المرجعيين لهذا الإصدار يستهدفان net8.0.

قبل الترحيل

1. إنشاء فرع ونسخة احتياطية قابلة للنشر من التطبيق الحالي.
2. تسجيل إصدارات الحزمة الأساسية والإضافية بدقة.
3. جرد كل استدعاء new Viewer(...)، واستدعاء InitCache()، واستدعاء تحميل الترخيص، وتعيين UseDoconutWebFarm، ووحدة التحكم في التحويل، والسكريبت Doconut المنسوخ، وإجراء شريط الأدوات المخصص، واستدعاء رد الفعل للعارض، ونقطة النهاية لفتح المستند.
4. حافظ على ملفات .lic الحالية وأسرار النشر خارج نظام التحكم بالمصادر.
5. التقط مجموعة ممثلة من مستندات PDF، Office، الصور، CAD، البريد الإلكتروني، DICOM، القابلة للبحث، المحمية بكلمة مرور، والمُعَلَّمَة.
6. سجل مهلة الجلسة الحالية، سلوك الأمان، الخطوط، وإعدادات المنصة.

قم بترحيل بيئة واحدة قبل تغيير الإنتاج. التكامل الحالي يغيّر عمر الخدمة، توجيه الطلبات، ملكية الجلسة، تسليم موارد العميل، — إذا كنت تدير مزرعة — كيفية وصول الصفحات إلى المتصفح.

1. المساحات الاسمية: تقريبًا كل شيء تم نقله إلى الجذر

أنواع الإعداد كانت موزعة عبر أربع مساحات اسمية. الآن جميعها في Doconut.

لم تتغير أسماء الأنواع: WordConfig, PdfConfig, ExcelConfig, CssConfig, ScriptConfig, CloudUploadConfig, AzureConfig, CDNConfig, FileShareConfig والبقية لا تزال موجودة. في معظم الملفات، التعديل الكامل هو حذف سطرين using.

Doconut.Configs.Editor (BaseConfigEditor, PdfConfigEditor) تم إزالته ولا يوجد بديل له في هذه الحزمة. إذا كان تطبيقك يستخدم تلك الأنواع، خطط لهذا الجزء بشكل منفصل ولا تعتبره جزءًا من هذا الترحيل.

2. توافق الحزمة والترخيص

استبدل أو حدّث الحزمة الأساسية عمدًا؛ لا تعتمد على معرف الحزمة المتطابق لاختيار واجهة برمجة التطبيقات الجديدة. الأمر الافتراضي يثبت أحدث إصدار ثابت:

dotnet add package Doconut.NETStandard

للحصول على ترحيل قابل لإعادة الإنتاج إلى الإصدار الذي تم تدقيقه في هذا الدليل، مرّر الإصدار كخيار منفصل:

dotnet add package Doconut.NETStandard --version 26.8.0

احتفظ بكل مكوّن إضافي من Doconut بالإصدار نفسه كما في الحزمة الأساسية — Doconut.NETStandard.Converter و Doconut.NETStandard.Dicom. التكامل الحالي يحمل التراخيص مرة واحدة أثناء AddDoconut()، باستخدام أولوية التحميل التالية:

LicenseStream > LicenseContent > LicensePath > automatic discovery

يبحث الاكتشاف التلقائي عن ملف Doconut.Viewer.lic والملفات المصاحبة Doconut.Viewer.<Capability>.lic. الاستدعاءات الثابتة السابقة Viewer.DoconutLicense(...) و Viewer.SetLicensePlugin(...) لم تعد آلية بدء تشغيل حالية، ولا قائمة List<string> لمسارات الترخيص التي كان يقبلها المُنشئ القديم لـ Viewer. انقل الترخيص إلى DoconutOptions، واحتفظ بالملفات المصاحبة معًا عند استخدام الاكتشاف التلقائي، أعد تشغيل التطبيق بعد تغيير الترخيص، وتحقق من القدرات عبر IDoconutLicenseService.

لا تفترض أن وجود ترخيص مكوّن إضافي قديم يثبت الأحقية في بناء مكوّن إضافي حالي. اختبر Viewer و Search و Annotation و Converter و DICOM بشكل منفصل باستخدام القطع المصدّقة من الإصدار.

3. بدء التشغيل والحقن الاعتمادي

في السابق كان يتم إنشاء الـ viewer لكل طلب وتم تمرير الخيارات إلى الوسيط:

// التكامل السابق — للتمييز فقط؛ لا تقم بتجميع هذا ضد SDK الحالي.
var viewer = new Viewer(_cache, _accessor);
// …
appBranch.UseDoconut(new DoconutOptions { UnSafeMode = false, ShowDoconutInfo = false });

التكامل الحالي يسجّل Doconut مرة واحدة ويتلقى Viewer من خلال الحقن الاعتمادي:

builder.Services.AddDoconut(options =>
{
    options.UnsafeMode      = false;   // ملاحظة تغيير التهجئة: UnSafeMode → UnsafeMode
    options.ShowDoconutInfo = false;
    options.LicensePath     = "Doconut.Viewer.lic";
});
builder.Services.AddDistributedMemoryCache(); // حالة الجلسة تحتاج إلى ذاكرة تخزين مؤقت (MVC/Razor Pages يضيفان واحدة بالفعل)
builder.Services.AddSession();

app.UseSession();
app.UseDoconutResources();
app.UseDoconut();

Viewer هو خدمة مؤقتة. مدير جلسة المستند وذاكرة التخزين المؤقت الخاصة به يمتلكان حالة المستند ذات العمر الأطول، وليس نسخة Viewer المحقونة المحددة.

ثلاثة أشياء يجب نقلها:

• new Viewer(cache, accessor) اختفت. احقن Doconut.Viewer في المتحكم الخاص بك، أو استخدم @inject Doconut.Viewer Viewer في عرض Razor.
• UseDoconutResources() يستبدل ربطًا يدويًا app.UseMiddleware<EmbeddedResourceMiddleware>()، ويجب أن يُنفّذ قبل فرع المستند.
• UnSafeMode → UnsafeMode. إعادة تسمية حرف واحد سيكتشفها المترجم.

عند كون UnsafeMode false يتحقق SDK من صحة رمز الجلسة مقابل الطلب الأصلي، لذا يجب أن تظل AddSession() / UseSession() في خط الأنابيب، مع استدعاء UseSession() قبل الفرع.

الأساليب التي لم تعد موجودة

4. وسائط البرامج وتوجيه الموارد

UseDoconut() الآن لا يأخذ أي معاملات. شكل فرع MapWhen نفسه لا يحتاج إلى تغيير — فقط الوسيط داخلها:

app.UseDoconutResources();   // BEFORE the branch

app.MapWhen(
    ctx => ctx.Request.Path.Value?.EndsWith("DocImage.axd", StringComparison.OrdinalIgnoreCase) == true,
    branch => branch.UseDoconut());

في خط الأنابيب الحالي:

1. استدعِ UseSession() قبل Doconut بينما أمان الجلسة مفعّل؛
2. استدعِ UseDoconutResources() قبل UseDoconut()؛
3. حافظ على توافق ResourcesPath، عناوين URL للموارد المُولدة، و ResPath للعميل؛
4. حافظ على توافق الفرع الذي تُخرِّطه و BasePath للعميل.

MiddlewarePath هو تكوين تم التحقق منه؛ لا ينشئ فرع ASP.NET Core بحد ذاته.

5. إنشاء المشاهد وعمره

احذف التخزين المؤقت المملوك للتطبيق لكائنات Viewer. لا يوجد شيء متبقٍ في Viewer يستحق الاحتفاظ به: لا يحمل أي حالة مستند، وتخزين الجلسة يملك كل ما يبقى بعد انتهاء الطلب. قم بحقنه في نقطة النهاية، صفحة Razor، المتحكم، أو خدمة تطبيق ذات نطاق محدد:

app.MapPost("/api/open", async (Viewer viewer) =>
{
    var token = await viewer.OpenDocumentAsync("wwwroot/files/Sample.pdf");
    return Results.Ok(new { token });
});

الرمز المميز المعاد يحدد جلسة مستند على الخادم. اعتبره اعتمادًا من نوع حامل: لا تقم بتسجيله، ولا تخزنه، ولا تضعه في التحليلات.

6. فتح وإغلاق المستندات

استبدل OpenDocument(...) المتزامن بـ OpenDocumentAsync(...):

// التكامل الحالي: يتم الحصول على Viewer من DI وفتح المستند غير متزامن.
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { AllowSearch = true });

الإصدارات الحالية تقبل مسار ملف أو تدفق، تكوين تنسيق اختياري، DocOptions اختياري، ورمز إلغاء. أغلق جلسة الخادم صراحةً عندما لا يحتاج المتصفح إليها:

viewer.CloseDocument(token);

احذف أي استدعاء لـ InitCache() والعلمية التي تحميه — لا يوجد شيء لتسخينه يدويًا. لا تعيد استخدام رمز مميز تم إنشاؤه بواسطة المكتبة السابقة بعد الانتقال: افتح كل مستند مرة أخرى عبر الواجهة البرمجية الحالية.

7. مزرعة الويب → موزعة: أكبر تغيير

UseDoconutWebFarm و WebFarmOptions لم يعودا موجودين. إذا كان تطبيقك يستدعيهما، فهذا القسم هو التحديث الخاص بك؛ إذا لم يكن كذلك، انتقل إلى الفقرة §8.

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

// التكامل السابق — استدعاء واحد، تنسيق ضمني عبر نظام الملفات.
appBranch.UseDoconutWebFarm(new WebFarmOptions
{
    Path                = Path.Combine(env.WebRootPath, "webfarm"),
    PageWaitTimeSeconds = 180,
    StartWaitFromPage   = 5,
});

نفس المهمة الآن مقسمة إلى نصفين صريحين. جانب الكتابة — العقدة التي تفتح المستند تنشر مجموعة الأصول بالكامل (الصفحات، معلومات المستند، فهرس البحث، البيانات الوصفية) في المشاركة:

var result = await _publisher.PublishAsync(          // DistributedDocumentPublisher، تم حقنه من DI
    pathToFile,
    new FileShareConfig
    {
        Location              = CloudLocation.FileShare,
        RootPath              = @"\\fileserver\doconut",   // نفس المجلد الذي تستخدمه اليوم
        UsePerTokenSubfolders = true,
    },
    config,
    documentOptions,
    new DistributedDocumentPublishOptions
    {
        CleanUpStagingDirectory = true,
        FirstPagePriority       = true,
    });

return Content(result.Token);

جانب القراءة — أي عقدة تخدم من المشاركة:

app.MapWhen(
    ctx => ctx.Request.Path.Value?.EndsWith("DocImage.axd", StringComparison.OrdinalIgnoreCase) == true,
    branch => branch.UseDoconutCloud<FileShareCloudHandler>(options =>
    {
        options.Location          = CloudLocation.FileShare;
        options.CloudUploadConfig = /* the SAME FileShareConfig as above */;
    }, "/"));

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

يجب أن يتفق النصفان. إذا اختلف RootPath أو UsePerTokenSubfolders بين الناشر والمعالج، سيجيب العقدة الأخرى بـ 404. أنشئ التكوين في مساعد واحد واستدعِه من كلا الجانبين.

PageWaitTimeSeconds = 180 كان يعني "حجب حتى ثلاث دقائق على أمل ظهور الصفحة". الاستبدال صريح: مع FirstPagePriority = true، الصفحة الأولى يمكن خدمتها فورًا والصفحات اللاحقة تجيب HTTP 202 Accepted حتى تُكتب. المشاهد المدمج يعيد المحاولة تلقائيًا عندما يتم ضبط retryOn409. العميل الذي لا يعيد المحاولة سيظهر بلاطات مكسورة للصفحات التي لا تزال تُعرض.

التنظيم الكامل، بما في ذلك النشر الخلفي وتذاكر الوصول، موجود في النشر الموزع.

8. التحويل هو مكوّن إضافي، وهو أصغر بكثير

سجّل المكوّن الإضافي، ثم حقّن الواجهة DocumentConverter:

builder.Services.AddDoconut(o => o.AddPlugin<ConverterPlugin>());

// التكامل السابق
var converter = viewer.Converter.GetConverter();
var config    = new WordConfigConverter { TargetFormat = WordConfigConverter.EnTargetFormat.PDF };
var result    = converter.Convert(stream, SourceFormatConverter.DOCX, config);

// التكامل الحالي
var result = await _converter.ConvertAsync(stream, ".docx", ConversionTarget.Pdf, null, ct);

ما الذي يستبدله ذلك:

• SourceFormatConverter — تم إزالته. مرّر امتداد الملف كسلسلة نصية، بما في ذلك النقطة.
• أنواع *ConfigConverter الخاصة بكل عائلة (WordConfigConverter، ExcelConfigConverter، …)، كل منها يحتوي على تعداد EnTargetFormat متداخل — تم إزالته. الآن يوجد تعداد واحد ConversionTarget لكل عائلة.
• viewer.Converter.GetConverter() — تم إزالته. حقّن Doconut.DocumentConverter.

ConvertAsync تُعيد تدفقًا قابلًا للتمرير، لذا فإن return File(result, mime, name) يعمل مباشرة — نسخ MemoryStream التي كان يحتاجها الكود القديم ليست ضرورية. في العينة المرفقة، أدى ذلك إلى حذف تحويل امتداد يضم 68 حالة وعشرة وحدات تحكم متشابهة تقريبًا.

انظر إلى Converter Plugin للحصول على السطح الكامل.

9. مزودي السحابة

UseDoconutCloud أصبحت عامة. الموفر هو نوع الوسيط بدلاً من قيمة Location التي يتم التبديل بناءً عليها داخل الوسيط:

// التكامل السابق
appBranch.UseDoconutCloud(new CloudOptions { Location = CloudLocation.CDN, ... });

// التكامل الحالي
branch.UseDoconutCloud<CDNCloudHandler>(options =>
{
    options.Location          = CloudLocation.CDN;
    options.CloudUploadConfig = new CDNConfig { DoconutCdnUrl = "..." };
}, "/");

فئات التكوين لم تتغير باستثناء مساحة الاسم (Doconut.Configs.Cloud → Doconut.Clouds): AzureConfig، AmazonConfig، GoogleCloudConfig، DropBoxConfig، RedisConfig، CDNConfig، FTPConfig، بالإضافة إلى FileShareConfig الجديد. المعالجات تُسمى <Provider>CloudHandler.

معالج CDN هو للقراءة فقط — فهو يقدم ما هو موجود بالفعل على CDN؛ ولا يقوم بالرفع.

10. كائنات التكوين التي تغيرت أسماؤها

DocOptions يضيف أيضًا IsSecured.

واجهة برمجة التطبيقات الحالية تفصل القضايا بشكل أكثر صرامة من السابقة، لذا تحقق من أن كل إعداد موجود في الكائن الذي يملكه الآن:

لا تُستمر في استخدام DocOptions.ImageResolution كتحكم في العرض. فهو مهمل؛ اضبط BaseConfig.ImageResolution في تكوين الصيغة المحددة. راجع جميع الإعدادات الافتراضية بدلاً من افتراض أن التكوين السابق له نفس السلوك.

11. عارض الجانب العميل — تغييران يفشلان بصمت

كلاهما يترك الخادم يعمل بشكل كامل. مستندك يُعرض، والصفحة تبدو صحيحة، ولا يظهر شيء في وحدة تحكم المتصفح. اقرأ هذا القسم حتى لو نجح تجميع C# من أول محاولة.

ردود نداء العارض أصبحت خيارات الآن، وليس دوالًا عامة

العارض السابق كان يستدعي المعالجات الخاصة بك بالاسم، مستخرجًا اسم الدالة العامة من معرف الحاوية. كان تعريف function ctlDoc_OnViewerReady() في صفحة تحتوي على <div id="div_ctlDoc"> كافيًا. العارض الحالي يأخذ ردود نداء صريحة في كائن الخيارات ولم يعد يبحث عن تلك الدوال العامة:

objctlDoc = $("#div_ctlDoc").docViewer({
    // ... خياراتك الحالية ...
    onViewerBusy:     ctlDoc_OnViewerBusy,      // كان يُعثر عليه بالاسم
    onViewerReady:    ctlDoc_OnViewerReady,     // كان يُعثر عليه بالاسم
    onCopy:           ctlDoc_Copy,              // كان ctlDoc_Copy(text)
    onAutoLoadStatus: ctlDoc_AutoLoadStatus     // كان ctlDoc_AutoLoadStatus(page)
});

لماذا هذا سيء: كان الاستدعاء القديم محاطًا بـ catch فارغ، مما ابتلع كل شيء. الآن لا تُنفّذ دوالك أبداً ولا يُبلغ عن أي خطأ. العَرَض الشائع هو مؤشر تحميل مستمر لا يتوقف — لأن الدالة التي كانت تخفيه هي ctlDoc_OnViewerReady. المستند خلفه سليم.

قائمة الخيارات الكاملة هي onPageLoading، onPageLoaded، onThumbnailClicked، onPageClicked، onDoubleClick، onViewerBusy، onViewerReady، onViewerError، onCopy، onAnnSaved، onAnnSaveError، onAnnLoaded، onAnnClosed، onAutoLoadStatus، onThumbsShown، و onError. لا يوجد رد نداء للنقر على الروابط: معالجة الروابط مدمجة وتُدار بواسطة showHyperlinks.

يجب أن يشير ResPath إلى بادئة المورد

ResPath: '',                      // قبل — الموارد كانت تأتي من جذر التطبيق
ResPath: 'doconut-res/images',    // الآن — البادئة التي يركّبها UseDoconutResources()

إذا قمت بتغيير البادئة عبر DoconutOptions.ResourcesPath، استخدم تلك القيمة بدلاً من ذلك.

12. شريط أدوات العارض، البحث، والتعليقات التوضيحية

لا تقم بترحيل السكريبتات القديمة واحدةً تلو الأخرى. التطبيقات المرجعية الحالية تُنشئ حزمة صفحة كاملة واحدة:

1. إصدار CSS للعارض وCSS المرخص للبحث/التعليقات التوضيحية باستخدام ReferenceCss؛
2. عرض شريط أدوات العارض المملوك للتطبيق؛
3. عرض searchBarMount، annBarMount، والتركيب المطلوب للعارض؛
4. إصدار سكريبتات العارض والوحدات المرخصة باستخدام ReferenceScripts؛
5. تحميل سكريبت المساعد الخاص بشريط أدوات التطبيق؛
6. تهيئة كائن objViewer واحد؛
7. تهيئة أشرطة البحث والتعليقات التوضيحية المرخصة؛
8. استدعاء attach(objViewer) على كل شريط؛
9. فتح المستند واستدعاء objViewer.View(token).

البحث والتعليقات التوضيحية هما وحدتان مرفقتان بنفس العارض، وليسا شريطين أدوات مستقلين. شريط الأدوات الرئيسي يخص تطبيق المضيف؛ أشرطة البحث والتعليقات التوضيحية مدمجة، وتُقيد بالقدرات.

احذف الملفات المنسوخة يدويًا مثل documentLinks.js و docViewer.UI.js فقط بعد أن تعمل الصفحة الحالية مع الموارد الصادرة عن ReferenceCss و ReferenceScripts.

13. تسجيل الإضافات

طرق الترخيص الثابتة للإضافات لا تسجل الإضافات الحالية. قم بتثبيت وتسجيل كل حزمة مُصدرة صراحةً:

builder.Services.AddDoconut(options =>
{
    options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>();
    options.AddPlugin<Doconut.Plugins.Dicom.DicomPlugin>();
});

AddDoconut() يتحقق من قدرات الإضافات المسجلة عند بدء التشغيل. Converter و DICOM هما الإضافات الصادرة لـ .NET Standard. البحث والتعليقات التوضيحية العادية هي ميزات مرخصة مدمجة، ليست حزم AddPlugin<TPlugin>().

14. أمان الجلسة والوثيقة

التكامل الحالي يربط المستندات برموز غير شفافة وجلسات مخزنة مؤقتًا. مع الإعداد الافتراضي UnsafeMode = false، يضيف UseDoconut() أمان وصول المستند ويجب على المضيف تكوين جلسة ASP.NET:

builder.Services.AddDistributedMemoryCache(); // حالة الجلسة تحتاج إلى ذاكرة مخبأة (MVC/Razor Pages يضيفان واحدة بالفعل)
builder.Services.AddSession();
app.UseSession();

احتفظ بـ DocOptions.IsSecured = true ما لم يتطلب تصميم مُراجَع خلاف ذلك. لا تستخدم أبداً UnsafeMode = true كاختصار للترحيل على عقدة واحدة. اختبر الطلبات بدون رمز، رمز غير صالح، رمز منتهي الصلاحية، ورمز من جلسة متصفح مختلفة.

في بيئة موزعة قد يصل طلب الصفحة إلى عقدة لم تشهد الطلب الأول، وبالتالي سيتسبب فحص الجلسة في رفضه. هذه هي الحالة الوحيدة التي يكون فيها UnsafeMode = true صحيحًا — ويجب أن يُقترن بتذاكر وصول موقعة عبر AddDoconutDistributedDocumentSecurity، وليس منفردًا. راجع النشر الموزع.

ملاحظة حول التسمية

في جميع الأطر، الصنف هو Viewer. إذا وجدت DocumentViewer في مقتطفات قديمة أو مقالات من طرف ثالث، فهذا النوع لم يكن موجودًا أبدًا في مجموعة تطوير البرمجيات (SDK).

15. ترتيب العمل المقترح

1. تأكد من أن إطار العمل المضيف يمكنه استهلاك netstandard2.1. إذا لم يستطع، توقف.
2. قم بترقية الحزمة إلى 26.8.0 ثم ابنِ المشروع. عالج أخطاء التجميع — معظمها أسطر using في الفقرة §1.
3. انقل بدء التشغيل إلى AddDoconut() واستدعاءات الطبقة الوسطية إلى ترتيبها الجديد (§3, §4).
4. حقن Viewer حيث كنت تُنشئه، اجعل OpenDocument غير متزامن، واحذف InitCache() (§5, §6).
5. إذا كنت تستخدم بيئة الويب الموزعة، نفّذ §7 — الجزء الوحيد الذي يتطلب إعادة تصميم وليس مجرد إعادة تسمية.
6. إذا كنت تُحوّل المستندات، نفّذ §8.
7. نفّذ §11 — التغييرات على جانب العميل. هي التي لن تُعلن عن نفسها.
8. افتح مستندًا حقيقيًا في المتصفح، وراقب المؤشر المتحرك. بناء أخضر لا يثبت شيئًا هنا: الترخيص، تسجيل الإضافات، مسار المورد، واستدعاءات العارض جميعها تفشل فقط أثناء التشغيل. بالنسبة لبيئة موزعة، تحقق من أن مستندًا نُشر من عقدة واحدة يُقدَّم من عقدة أخرى.

اختبار الترحيل

على الأقل، تحقق من:

• بدء تشغيل التطبيق مع ترخيص الإنتاج وكل المكوّن الإضافي المسجّل؛
• ملفات CSS/السكريبتات الخاصة بالمُشاهد وجميع طلبات صور الصفحات تحت المسارات المختارة؛
• فتح المستند، التنقل، التكبير، المصغرات، الطباعة، والإغلاق الصريح؛
• البحث في مستند يحتوي على نص وحالة عدم إمكانية البحث في ملف يحتوي على صور فقط؛
• تحميل التعليقات التوضيحية، الحفظ، التصدير، وتقييد القدرة؛
• اكتشاف هدف المحول، الإخراج، التحميل، وحالة العلامة المائية؛
• صفحات DICOM، الإطارات، والرسوم المتحركة؛ البيانات الوصفية التقنية غير متوفرة في هذه الحزمة؛
• المستندات المحمية بكلمة مرور، الخطوط المخصّصة، النص غير اللاتيني، والمهلات المكوّنة؛
• رفض الرموز عبر الجلسات وسلوك الجلسة المنتهية؛
• في حالة مجموعة خوادم: نشر على عقدة واحدة، طلب صفحة متأخرة من أخرى، وتأكيد أن المُشاهد يعيد المحاولة عند استجابة 202 بدلاً من عرض قطع مكسورة؛
• الهواتف المحمولة، الوضع الداكن، ومسار الوكيل العكسي للإنتاج.

خطة الاسترجاع

احتفظ بقطعة النشر السابقة، الحزم المطابقة، ملفات الترخيص، والموارد المتصفح المنسوخة معًا. عملية استرجاع آمنة تقوم بتبديل جيل التطبيق بالكامل؛ ولا تمزج خادمًا من الجيل السابق مع السكريبتات الحالية، أو خادمًا حاليًا مع مواقع استدعاء new Viewer(...).

قبل التحويل، وثّق:

• فتحة النشر أو القطعة المستخدمة للاسترجاع؛
• تأثير التخزين المشترك، إن وجد — القطع التي نشرت بواسطة 26.8.0 لا تُستهلك من قبل طبقة الوسط السابقة لمجموعة الويب؛
• كيفية إبطال جلسات المستند النشطة؛
• فحص الصحة ووثيقة الاختبار السريعة المستخدمة لتحديد الاسترجاع؛
• من يمكنه استعادة مجموعة الحزم السابقة والإعدادات.

الوثائق القديمة

الدليل السابق المترجم لا يزال متاحًا على إعداد .NET Standard القديم. يشرح بوابة التكامل السابقة نفس إشارات التعريف ويربط مرة أخرى إلى دليل الترحيل هذا.

احتفظ بالرابط التاريخي في الإشارات المرجعية وتذاكر الدعم طالما أن تثبيتات netstandard2.0 لا تزال موجودة. فهو يوثّق جيلًا مختلفًا ولا يتم توجيهه إلى واجهة برمجة التطبيقات الحالية.