אינטגרציה קודמת

השתמשו בחלק זה כאשר יישום .NET Standard קיים עדיין בונה את Viewer באופן ידני, מעביר אפשרויות למידלוור, מתאם חווה אינטרנטית דרך תיקייה משותפת, או מעתיק את סקריפטי הצופה לתוך היישום. ארכיטקטורה זו נשארת מתועדת עבור לקוחות שטרם עברו למערכת החדשה.

גרסת החבילה מזהה את הדור

מזהה החבילה לבדו אינו מספיק. שני הדורות מתפרסמים בשם Doconut.NETStandard:

בדקו את הגרסה בקובץ הפרויקט, בקובץ הנעילה, או ב‑.nupkg המוטמן לפני שבוחרים מדריך. הפנייה לחבילה שמציינת רק Doconut.NETStandard אינה מספקת מידע על ה‑API שהקוד נכתב כנגדו.

זיהוי האינטגרציה הקודמת

היישום משתמש באינטגרציה הקודמת כאשר הוא מכיל אחת או יותר מהחתימות הבאות:

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 הישנה. כתובתו לא הופנתה או הוחלפה, מכיוון שהוא מתאר דור אינטגרציה אמיתי שיישומים קיימים עדיין משתמשים בו.

אל תשלבו קטעי קוד מהמדריך הזה עם התיעוד של AddDoconut() הנוכחי. בניית הצופה, ניתוב המידלוור, רישיונות, משאבים, המרה, תיאום חוות אינטרנט, ובעלות סשן הם כולם שונים.

תכנון מיגרציה

השתמשו ב-מיגרציה ל‑.NET Standard 2.1 למיפוי המאומת מבנייה ידנית ופתיחת מסמכים סינכרונית ל‑DI, המידלוור הנוכחי, סשנים אסינכרוניים, משאבים שנוצרו, פרסום מבוזר, ותוספים מבוססי יכולות.

שתי נקודות דורשות תשומת לב לפני שמתחילים:

• מסגרת המארח. netstandard2.1 דורשת .NET Core 3.0 או מאוחר יותר. מארח .NET Framework אינו יכול לצרוך את החבילה הנוכחית כלל.
• השינויים בצד הלקוח. שניים מהם נכשלים בשקט — השרת ממשיך לפעול וקונסול הדפדפן נשאר ריק. הם מכוסים במדריך המיגרציה.

שמרו על הפריסה הקודמת שלמה עד שהיישום הנוכחי יעבור את מבחני המסמך, הרישיון, חיפוש, אנוטציה, ממיר, DICOM, אבטחה, ובדיקות החזרה.