التكامل السابق

استخدم هذا القسم عندما لا يزال تطبيق .NET Standard موجودًا يُنشئ Viewer يدويًا، يمرّر الخيارات إلى الطبقة الوسيطة، ينسق مزرعة ويب عبر مجلد مشترك، أو ينسخ سكريبتات المشاهد إلى التطبيق. لا يزال هذا الهيكل موثّقًا للعملاء الذين لم يترقوا.

إصدار الحزمة يحدد الجيل

معرّف الحزمة وحده ليس كافيًا. كلا الجيلين يُنشران كـ Doconut.NETStandard:

تحقق من الإصدار في ملف المشروع، ملف القفل، أو ملف .nupkg المخزن مؤقتًا قبل أن تختار دليلًا يدويًا. إشارة الحزمة التي تقول فقط Doconut.NETStandard لا تخبرك بأي شيء عن واجهة برمجة التطبيقات التي كُتب الكود ضدها.

تحديد التكامل السابق

يُعد التطبيق يستخدم التكامل السابق عندما يحتوي على واحد أو أكثر من هذه التوقيعات:

var viewer = new Viewer(_cache, _accessor);
var viewer = new Viewer(_cache, _accessor, licenseFilePath);

var token = viewer.OpenDocument(path, config, documentOptions);
viewer.InitCache();

appBranch.UseDoconut(new DoconutOptions { UnSafeMode = false, ShowDoconutInfo = false });

appBranch.UseDoconutWebFarm(new WebFarmOptions { Path = sharedFolder });

Viewer.DoconutLicense(licenseStream);
Viewer.SetLicensePlugin(pluginLicenseStream);

var converter = viewer.Converter.GetConverter();

كتلة using الخاصة به هي إشارة موثوقة أخرى — كانت أنواع التكوين موزعة عبر عدة مساحات أسماء:

using Doconut.Configs;
using Doconut.Configs.View;
using Doconut.Configs.Cloud;
using Doconut.Models;

الصفحات السابقة عادةً ما تُحمِّل نسخًا مُدارة من التطبيق للملفات التالية:

docViewer.js
documentLinks.js
docViewer.UI.js

وتعلن ردود نداء المشاهد كمتغيّرات عمومية مسماة بعد معرف الحاوية، مثل ctlDoc_OnViewerReady().

يُعرّف التكامل الحالي بدلاً من ذلك بـ AddDoconut()، UseDoconutResources()، UseDoconut() بدون معاملات، Viewer مُحقن، OpenDocumentAsync()، ومساحة الاسم المسطحة Doconut.

فتح الدليل المحفوظ

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

لا تقم بدمج المقاطع من ذلك الدليل مع وثائق AddDoconut() الحالية. إنشاء المشاهد، توجيه الطبقة الوسيطة، التراخيص، الموارد، التحويل، تنسيق مزرعة الويب، وملكية الجلسة جميعها مختلفة.

التخطيط للترحيل

استخدم الترحيل إلى .NET Standard 2.1 للحصول على الخريطة المؤكدة من الإنشاء اليدوي وفتح المستند المتزامن إلى DI، الطبقة الوسيطة الحالية، الجلسات غير المتزامنة، الموارد المولدة، النشر الموزع، والإضافات المقيدة بالقدرات.

هناك أمران يستحقان الانتباه قبل البدء:

• إطار العمل المضيف. يتطلب netstandard2.1 .NET Core 3.0 أو أحدث. لا يمكن لمضيف .NET Framework استهلاك الحزمة الحالية على الإطلاق.
• التغييرات على جانب العميل. اثنان منها يفشلان بصمت — يظل الخادم يعمل وتبقى وحدة تحكم المتصفح فارغة. يتم تغطيتهما في دليل الترحيل.

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