Προηγούμενη ενσωμάτωση

Χρησιμοποιήστε αυτήν την ενότητα όταν μια υπάρχουσα εφαρμογή .NET Standard κατασκευάζει ακόμη Viewer χειροκίνητα, περνά επιλογές στο middleware, συντονίζει ένα web farm μέσω κοινόχρηστου φακέλου, ή αντιγράφει τα σενάρια 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

και δηλώνουν callbacks του viewer ως καθολικές μεταβλητές με όνομα το αναγνωριστικό του container, όπως ctlDoc_OnViewerReady().

Η τρέχουσα ενσωμάτωση αναγνωρίζεται αντίθετα από AddDoconut(), UseDoconutResources(), UseDoconut() χωρίς ορίσματα, ένα ενσωματωμένο Viewer, OpenDocumentAsync(), και το εξομαλυνμένο χώρο ονομάτων Doconut.

Ανοίξτε το διατηρημένο εγχειρίδιο

Το μεταφρασμένο ιστορικό εγχειρίδιο παραμένει στο Legacy .NET Standard setup. Η διεύθυνσή του δεν έχει ανακατευθυνθεί ή αντικατασταθεί, επειδή περιγράφει μια πραγματική γενιά ενσωμάτωσης που οι υπάρχουσες εφαρμογές εξακολουθούν να χρησιμοποιούν.

Μην συνδυάζετε αποσπάσματα από αυτό το εγχειρίδιο με την τρέχουσα τεκμηρίωση AddDoconut(). Κατασκευή Viewer, δρομολόγηση middleware, άδειες, πόροι, μετατροπή, web-farm συντονισμός και ιδιοκτησία συνεδρίας είναι όλα διαφορετικά.

Σχεδιάστε μια μετάβαση

Χρησιμοποιήστε Migrate to .NET Standard 2.1 για την επαληθευμένη αντιστοίχιση από το χειροκίνητο κατασκευή και συγχρονισμένο άνοιγμα εγγράφων σε DI, τρέχον middleware, ασύγχρονες συνεδρίες, παραγόμενους πόρους, κατανεμημένη δημοσίευση και plugins με έλεγχο δυνατοτήτων.

Δύο πράγματα απαιτούν προσοχή πριν ξεκινήσετε:

• Το πλαίσιο φιλοξενίας. netstandard2.1 απαιτεί .NET Core 3.0 ή νεότερο. Ένα .NET Framework host δεν μπορεί καθόλου να καταναλώσει το τρέχον πακέτο.
• Οι αλλαγές στην πλευρά του πελάτη. Δύο από αυτές αποτυγχάνουν σιωπηρά — ο διακομιστής συνεχίζει να λειτουργεί και το κονσόλα του προγράμματος περιήγησης παραμένει κενή. Καλύπτονται στον οδηγό μετάβασης.

Διατηρήστε την προηγούμενη ανάπτυξη αμετάβλητη μέχρι η τρέχουσα εφαρμογή περάσει το έγγραφό της, άδεια, Search, Annotation, Converter, DICOM, ασφάλεια και δοκιμές επαναφοράς.