Μπορείτε να ενσωματώσετε έναν προβολέα εγγράφων χωρίς πρόσθετα σε μια εφαρμογή ASP.NET Core, MVC ή WebForms χωρίς να ζητήσετε από κανέναν χρήστη να εγκαταστήσει κάτι.

Οι επιχειρήσεις που διαχειρίζονται συμβόλαια, σχέδια ή σχεδιαστικά περιουσιακά στοιχεία χρειάζονται έναν προβολέα που σέβεται τις εταιρικές πολιτικές ασφαλείας και ποτέ δεν αναγκάζει τους χρήστες να εγκαταστήσουν παλαιά πρόσθετα προγράμματος περιήγησης. Doconut παρέχει ένα SDK προβολέα εγγράφων .NET για ροές εργασίας PDF, Office, CAD, email και εικόνων μέσω του προγράμματος περιήγησης. Δεν είναι μια φιλοξενούμενη υπηρεσία που καλείτε: το εγκαθιστάτε στη δική σας εφαρμογή και εκεί γίνεται η απόδοση. Αυτή η ανάρτηση περιγράφει τις αποφάσεις ενσωμάτωσης χωρίς να βασίζεται σε κώδικα παραδείγματος ειδικό για έκδοση.

Μία διευκρίνιση πρώτα, επειδή τα δύο προϊόντα είναι εύκολο να συγχέονται. Doconut.app είναι ο δωρεάν διαδικτυακός προβολέας — ένα αρχείο, ανοιγμένο σε καρτέλα του προγράμματος περιήγησης, διαγράφεται μετά. Δεν είναι κάτι που ενσωματώνετε. Αυτό που ενσωματώνετε είναι ο Doconut Viewer, το SDK, και όλα τα παρακάτω αφορούν αυτό.

Ενσωματωμένος προβολέας εγγράφων συνδεδεμένος με ελεγχόμενο backend ASP.NET

1. Γιατί η ασφάλεια και η απόδοση χωρίς πρόσθετα είναι σημαντικές για εφαρμογές web .NET

Οι σύγχρονες επιχειρήσεις αντιμετωπίζουν κάθε έγγραφο ως πιθανή διαρροή δεδομένων. Όταν ενσωματώνετε έναν προβολέα που βασίζεται σε ActiveX, Flash ή εγγενή πελάτη, κληρονομείτε τρία ρίσκα:

Κίνδυνος	Επίπτωση στην .NET εφαρμογή σας	Πώς το Doconut App το εξαλείφει
Εξάρτηση από πρόσθετο	Οι χρήστες πρέπει να εγκαταστήσουν ή να ενεργοποιήσουν ένα πρόσθετο προγράμματος περιήγησης, οδηγώντας σε αιτήματα υποστήριξης και προβλήματα συμμόρφωσης.	Το Doconut λειτουργεί εξ ολοκλήρου σε HTML5/Canvas, απαιτώντας μηδέν πρόσθετα.
Μη κρυπτογραφημένη μετάδοση	Τα αρχεία μεταφέρονται μέσω HTTP ή αποθηκεύονται σε απλό κείμενο, παραβιάζοντας GDPR, HIPAA ή εσωτερικές πολιτικές.	Το SDK εκτελείται μέσα στην εφαρμογή σας, έτσι η μεταφορά και η αποθήκευση παραμένουν υπό την πολιτική TLS και κρυπτογράφησης που ήδη εφαρμόζετε. Το Doconut δεν προσθέτει νέο βήμα.
Ανεξέλεγκτος κύκλος ζωής	Τα αρχεία μπορεί να παραμείνουν στον διακομιστή, αυξάνοντας την έκθεση σε παραβιάσεις.	Η διατήρηση είναι δική σας να ορίσετε, επειδή τα έγγραφα δεν αφήνουν ποτέ το περιβάλλον σας. Η προσωρινή έξοδος απόδοσης γράφεται εκεί που τη ρυθμίζετε και καθαρίζεται σύμφωνα με το πρόγραμμα σας.

Το αρχιτεκτονικό γεγονός που έχει σημασία είναι ότι το SDK εγκαθίσταται στο δικό σας περιβάλλον και δεν κάνει κλήσεις σε διακομιστές Doconut. Τίποτα δεν ανεβαίνει σε εμάς, έτσι δεν υπάρχει τρίτος επεξεργαστής δεδομένων να προστεθεί σε χάρτη δεδομένων και καμία πολιτική διατήρησης προμηθευτή να συμφωνήσει με τη δική σας.

2. Προετοιμασία του έργου .NET

Χρησιμοποιήστε το πακέτο, την τεκμηρίωση και τα παραδείγματα που ταιριάζουν με την έκδοση Doconut που επιλέχθηκε για το έργο. Η επίσημη σελίδα λήψης Doconut είναι το αξιόπιστο σημείο εκκίνησης.

Πριν από την ενσωμάτωση, επιβεβαιώστε το στοχευόμενο runtime .NET, καταγράψτε την έκδοση του πακέτου, κρατήστε τη ρύθμιση άδειας εκτός ελέγχου πηγαίου κώδικα και ξεκινήστε με αντιπροσωπευτικά έγγραφα. Τα ASP.NET Core, MVC και WebForms έχουν διαφορετικούς κύκλους ζωής εφαρμογών, έτσι η ρύθμισή τους δεν πρέπει να θεωρείται ίδια.

3. Δημιουργία ασφαλούς σημείου ανεβάσματος – AES‑256, SSL και αυτόματη διαγραφή

Το SDK μπορεί να διαβάσει ένα έγγραφο από φυσική διαδρομή, ροή, πίνακα bytes, βάση δεδομένων, URL, τοποθεσία ενδοδικτύου ή πάροχο cloud όπως S3, Azure Storage, Google Cloud ή Dropbox. Αυτό που δεν πρέπει ποτέ να διαβάσει είναι μια διαδρομή που επιλέγεται από το πρόγραμμα περιήγησης. Τοποθετήστε έναν έλεγχο εξουσιοδότησης μεταξύ του αιτήματος και του εγγράφου, όποια και αν είναι η πηγή. Παρακάτω φαίνεται μια κοινή μορφή για αυτό το σημείο τέλους σε ASP.NET Core· οι ίδιες ιδέες ισχύουν για MVC και WebForms.

Ροή εργασίας από την πλευρά του διακομιστή

Αποδοχή του ανεβασμένου αρχείου – Χρησιμοποιήστε το τυπικό IFormFile (ή HttpPostedFile σε WebForms) για να λάβετε το έγγραφο από τον πελάτη.
Κρυπτογράφηση του αρχείου με AES‑256 – Πριν αποθηκεύσετε το ρεύμα, κρυπτογραφήστε το χρησιμοποιώντας μια αποδεδειγμένη βιβλιοθήκη όπως System.Security.Cryptography.Aes. Αποθηκεύστε το κρυπτογραφημένο blob σε ασφαλή τοποθεσία (π.χ., Azure Blob Storage με ενεργοποιημένη κρυπτογράφηση διακομιστή, ή ένα bucket S3 με SSE‑AES256).
Δημιουργία σύντομης υπογεγραμμένης URL – Δημιουργήστε μια URL που είναι έγκυρη για λίγα λεπτά (π.χ., 5 λεπτά). Η URL πρέπει να είναι HTTPS και να περιλαμβάνει ένα κρυπτογραφικό token που το Doconut μπορεί να επικυρώσει. Οι περισσότεροι πάροχοι cloud storage προσφέρουν τη δυνατότητα “pre‑signed URL” που καλύπτει αυτήν την ανάγκη.
Επιστροφή της υπογεγραμμένης URL στον πελάτη – Στείλτε μια απάντηση JSON που περιέχει τη URL. Ο πελάτης θα παραδώσει αυτήν τη URL στον προβολέα Doconut.
Προγραμματισμός αυτόματης διαγραφής – Αφού λήξει η υπογεγραμμένη URL, μια εργασία παρασκηνίου (Hangfire, Azure Functions κ.λπ.) αφαιρεί το κρυπτογραφημένο blob, εξασφαλίζοντας ότι το αρχείο δεν παραμένει στον διακομιστή.

Ισοδύναμα MVC / WebForms

MVC – Τοποθετήστε την ίδια λογική μέσα σε μια κανονική ενέργεια ελεγκτή και επιστρέψτε JsonResult.
WebForms – Υλοποιήστε έναν χειριστή .ashx ή μια μέθοδο σελίδας που ακολουθεί τα ίδια βήματα: λήψη Request.Files[0], κρυπτογράφηση, δημιουργία pre‑signed URL και εγγραφή της απάντησης JSON.

Η μόνη διαφορά είναι η σύνταξη δρομολόγησης· η ροή ασφαλείας παραμένει ίδια.

4. Απόδοση του εγγράφου μέσω του εγκατεστημένου SDK

Διατηρήστε την πρόσβαση στο έγγραφο στον διακομιστή και επιβάλετε εξουσιοδότηση πριν επεξεργαστείτε ένα αρχείο ή ρεύμα. Η ακριβής ακολουθία απόδοσης και εκκίνησης UI είναι εξαρτημένη από την έκδοση· ακολουθήστε την επίσημη τεκμηρίωση που συνοδεύει την εγκατεστημένη έκδοση αντί να αντιγράψετε ένα μη επαληθευμένο παγκόσμιο JavaScript API.

Γιατί αυτό λειτουργεί για κάθε εκδοχή .NET

ASP.NET Core Razor – Η εκκίνηση βρίσκεται στην ίδια προβολή που φιλοξενεί τη φόρμα ανεβάσματος, οπότε υπάρχει μόνο μία σελίδα για να ληφθεί υπόψη.
MVC – Χρησιμοποιήστε @section Scripts για να ενσωματώσετε το ίδιο απόσπασμα· ο ελεγκτής επιστρέφει JSON που μπορεί να καταναλώσει το $.ajax του MVC.
WebForms – Καταχωρίστε το script με ClientScript.RegisterStartupScript μετά το τέλος του ανεβάσματος, στη συνέχεια καλέστε launchViewer με τον ίδιο τρόπο.

Η απόδοση γίνεται στον διακομιστή σας, και αυτό είναι το σημείο: ο φυλλομετρητής λαμβάνει τις αποδομένες σελίδες αντί για το πηγαίο έγγραφο, γι’ αυτό ένα DWG ή ένα PSD ανοίγει σε μηχάνημα που δεν διαθέτει ούτε AutoCAD ούτε Photoshop. Προσαρμόστε το μέγεθος του διακομιστή ανάλογα — ένα σαρωμένο PDF 300 σελίδων απαιτεί πραγματική εργασία, και τώρα είναι η υποδομή σας που το εκτελεί.

5. Προσαρμογή του προβολέα ώστε να ταιριάζει με το portal σας

Οι επιχειρήσεις συνήθως χρειάζονται τον προβολέα να μοιάζει με μέρος του προϊόντος στο οποίο ενσωματώνεται, αντί για ένα παράθυρο σε κάποιον άλλο. Η εμφάνιση του προβολέα και το σύνολο των ελέγχων που εκθέτει είναι ρυθμιζόμενα, και οι διαθέσιμες επιλογές εξαρτώνται από την έκδοση που εγκαταστήσατε.

Πάρτε τα ονόματα των επιλογών από την τεκμηρίωση που συνοδεύει την έκδοσή σας αντί από μια ανάρτηση σε blog. Οι επιφάνειες διαμόρφωσης του προβολέα είναι ακριβώς το είδος των πραγμάτων που μετονομάζονται μεταξύ εκδόσεων, και ένα απόσπασμα αντιγραμμένο από άρθρο δύο εκδόσεων παλιό αποτυγχάνει με τρόπο που μοιάζει με πρόβλημα αδειοδότησης.

Η απόφαση που αξίζει να ληφθεί πριν ανοίξετε την τεκμηρίωση είναι ποιοι έλεγχοι πρέπει να βλέπει κάθε ρόλος. Το αν ένας χρήστης μπορεί να εκτυπώσει, να κατεβάσει ή μόνο να περιηγηθεί σε ένα έγγραφο είναι ερώτηση δικαιωμάτων που η εφαρμογή σας ήδη γνωρίζει. Διαμορφώστε τον προβολέα βάσει αυτής της απάντησης, αντί να εκθέτετε κάθε έλεγχο και να ελπίζετε ότι κανείς δεν θα κάνει κλικ.

6. Απόδοση και κλιμακωσιμότητα – διατηρήστε την εμπειρία γρήγορη

Η ενσωμάτωση ενός προβολέα σε portal υψηλής κίνησης δημιουργεί δύο πρακτικά ζητήματα: χρόνος φόρτωσης και συγχρονική απόδοση. Η εφαρμογή Doconut αντιμετωπίζει και τα δύο αμέσως, αλλά μπορείτε να ενισχύσετε το περιθώριο απόδοσης με μερικές .NET‑συγκεκριμένες τεχνικές.

Πρόβλημα	Τι πρέπει να κάνετε
Καθυστέρηση πρώτης σελίδας	Η αυτόματη φόρτωση σελίδας επιτρέπει στον αναγνώστη να δει τη σελίδα 1 ενώ το υπόλοιπο ετοιμάζεται. Ενεργοποιήστε τη συμπίεση στατικών αρχείων (`app.UseResponseCompression()`) και κάντε cache τα περιουσιακά στοιχεία του πελάτη.
Επαναλαμβανόμενες προβολές ενός αρχείου	Ένα συχνά ανοιγόμενο έγγραφο μπορεί να αποδοθεί μία φορά και να σερβιριστεί από την προσωρινή μνήμη αντί να επαναδημοσιεύεται σε κάθε αίτημα. Η FAQ καλύπτει την επιλογή `.DCN` για ακριβώς αυτό.
Κόστος απόδοσης	Η απόδοση είναι εργασία του διακομιστή. Η μείωση της ανάλυσης εικόνας όπου η πιστότητα δεν είναι κρίσιμη είναι η μεγαλύτερη μονοπρόσωπη ράβδος, και είναι αλλαγή ρύθμισης παρά αλλαγή κώδικα.
Συγχρονικότητα	Εξετάστε τις ρυθμίσεις timeout και AutoClose υπό φορτίο, και διαβάστε τα παραδείγματα web farm πριν υποθέσετε ότι ένας κόμβος αρκεί. Περιορίστε τον ρυθμό (rate‑limit) του endpoint ανεβάσματος.

Μετρήστε με τα δικά σας έγγραφα. Ένα PDF 5 MB κειμενικού τύπου και ένα σκαναρισμένο PDF 5 MB της ίδιας αναφοράς συμπεριφέρονται εντελώς διαφορετικά, και μόνο ένα από αυτά εμφανίζεται σε ένα συνθετικό benchmark.

Σημαντικά Σημεία

Το Doconut Viewer είναι ένα SDK .NET χωρίς πρόσθετα που λειτουργεί με ASP.NET Core, MVC και WebForms. Οι χρήστες σας δεν εγκαθιστούν τίποτα.
Εγκαθίσταται στο δικό σας περιβάλλον και δεν κάνει κλήσεις στους διακομιστές Doconut, έτσι τα έγγραφα παραμένουν εντός του ορίου που ήδη ελέγχετε.
Η ασφάλεια μεταφοράς, η κρυπτογράφηση κατά την αποθήκευση και η διατήρηση είναι δικές σας επιλογές, επειδή το αρχείο δεν αφήνει ποτέ την υποδομή σας. Το Doconut δεν γίνεται επεξεργαστής στον χάρτη δεδομένων σας.
Ο κατάλογος του SDK περιλαμβάνει 75 επεκτάσεις αρχείων σε 18 οικογένειες — PDF, Office, CAD, Visio, Project, email, eBook και εικόνες, με DICOM μέσω του δικού του πρόσθετου.
Η απόδοση γίνεται στον διακομιστή. Αυτό είναι που επιτρέπει σε ένα πρόγραμμα περιήγησης να ανοίξει ένα DWG, και είναι επίσης το στοιχείο για το οποίο πρέπει να κλιμακώσετε.
Τα στοιχεία ελέγχου που βλέπει ένας χρήστης — εκτύπωση, λήψη ή μόνο σελιδοποίηση — πρέπει να ακολουθούν τα δικαιώματα που ήδη διαθέτει η εφαρμογή σας.
Πάρτε τα ονόματα των επιλογών διαμόρφωσης από την τεκμηρίωση για την εγκατεστημένη έκδοση, ποτέ από ένα άρθρο.

Συχνές Ερωτήσεις

Q1: Εγκαθιστώ κάτι στον διακομιστή;
Α: Ναι. Το Doconut Viewer είναι ένα SDK .NET που εγκαθιστάτε στην εφαρμογή σας — ξεκινήστε από τη σελίδα λήψης και χρησιμοποιήστε το πακέτο και την τεκμηρίωση για την έκδοση που επιλέξατε. Δεν υπάρχει φιλοξενούμενο σημείο λήψης για κλήση και τίποτα δεν παρέχεται από CDN του Doconut.

Q2: Ποιος διαγράφει το αρχείο μετά την προβολή;
Α: Εσείς. Επειδή το έγγραφο και οποιαδήποτε προσωρινή έξοδος απόδοση ζουν στο περιβάλλον σας, η διατήρηση είναι μια ρύθμιση στην εφαρμογή σας και όχι υπόσχεση από προμηθευτή. Αποφασίστε πού γράφονται τα προσωρινά αρχεία και τι τα αφαιρεί, πριν μεταβείτε στην παραγωγή.

Q3: Μπορούν οι χρήστες να εκτυπώσουν το έγγραφο;
Α: Η εκτύπωση είναι δυνατότητα του προβολέα και μπορεί να χορηγηθεί ή να αποτραπεί ανά χρήστη. Σημειώστε ότι η ελεγχόμενη εκτύπωση είναι μέρος του προβολέα — δεν είναι ένα από τα τέσσερα αδειοδοτημένα πρόσθετα, που είναι Annotation, Converter, DICOM και Search.

Q4: Μπορεί να μετατρέψει ένα έγγραφο σε άλλη μορφή;
Α: Αυτό είναι το πρόσθετο Converter, αδειοδοτημένο ξεχωριστά. Η προβολή και η μετατροπή είναι διαφορετικά προϊόντα εδώ, και αξίζει να είστε σαφείς ποιο από τα δύο χρειάζεται πραγματικά η ροή εργασίας.

Έτοιμοι να ενσωματώσετε έναν προβολέα εγγράφων χωρίς πρόσθετα στην εφαρμογή .NET σας; Ξεκινήστε από τη σελίδα λήψης Doconut — η δοκιμαστική άδεια είναι δωρεάν. Και αν αυτό που χρειάζεστε πραγματικά είναι να ανοίξετε ένα αρχείο σήμερα, το Doconut.app το κάνει σε μια καρτέλα του προγράμματος περιήγησης και το διαγράφει μετά.