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

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

Έγγραφα που περνούν από μια υπηρεσία απόδοσης .NET σε ενσωματωμένο προβολέα χωρίς πρόσθετα

Τι σημαίνει “Χωρίς Πρόσθετα”

Ένας προβολέας χωρίς πρόσθετα δεν ζητά από τον τελικό χρήστη να εγκαταστήσει τεχνολογίες όπως ActiveX, Flash, Silverlight ή μια προσαρμοσμένη επέκταση προγράμματος περιήγησης πριν ανοίξει ένα έγγραφο.

Αυτό μειώνει πολλές πηγές τριβής:

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

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

Γιατί η Απόδοση Εγγράφων από την Πλευρά του Διακομιστή Βοηθά

Τα επιχειρηματικά έγγραφα είναι πιο πολύπλοκα από το συνηθισμένο περιεχόμενο ιστού. Αρχεία Office, σχέδια CAD, μηνύματα email και εικόνες υψηλής ανάλυσης απαιτούν επεξεργασία που καταλαβαίνει τη μορφή τους.

Ένα στοιχείο .NET στην πλευρά του διακομιστή μπορεί να διαχειριστεί αυτήν την επεξεργασία ενώ η εφαρμογή ιστού παρουσιάζει την προκύπτουσα εμπειρία προβολής. Αυτό αποτρέπει το αίτημα σε κάθε χρήστη να εγκαταστήσει το αρχικό λογισμικό δημιουργίας.

Το Doconut έχει σχεδιαστεί για αυτόν τον ρόλο. Η τρέχουσα τεκμηρίωση του προϊόντος περιγράφει υποστήριξη τύπων εγγράφων όπως PDF, έγγραφα Office, σχέδια CAD, αρχεία email και εικόνες. Επικυρώστε τις ακριβείς μορφές και δυνατότητες που απαιτούνται από την εφαρμογή σας στη σελίδα Σελίδα Προβολέα Doconut.

Σχεδιάστε τη Ροή Εργασίας Προβολής

Ένα ασφαλές αίτημα εγγράφου συνήθως ακολουθεί τα παρακάτω βήματα:

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

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

Χρησιμοποιήστε Τα Πρότυπα Όρια Ασφαλείας του ASP.NET

Η σελίδα προβολής πρέπει να προστατεύεται όπως κάθε άλλος ευαίσθητος πόρος.

Οι τυπικοί μηχανισμοί .NET μπορούν να περιλαμβάνουν:

Middleware ελέγχου ταυτότητας
Το χαρακτηριστικό [Authorize]
Πολιτικές εξουσιοδότησης και claims
Εξουσιοδότηση βάσει πόρων
Ενσωμάτωση εξαρτήσεων για υπηρεσίες αποθήκευσης και προβολής
Δομημένη καταγραφή με φιλτράρισμα ευαίσθητων δεδομένων

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

Κρατήστε την Πρόσβαση στο SDK Πίσω από Μία Υπηρεσία Εφαρμογής

Αποφύγετε τη διάδοση κλήσεων προβολέα σε όλο το σύστημα ελεγκτών και σελίδων. Μία αφιερωμένη υπηρεσία εφαρμογής μπορεί να:

Εντοπίσει εξουσιοδοτημένα αναγνωριστικά εγγράφων
Ανοίξει ένα ελεγχόμενο Stream
Εφαρμόσει ρυθμίσεις για την εγκατεστημένη έκδοση SDK
Απελευθερώσει πόρους αρχείου και ροής
Μετατρέψει τεχνικές αποτυχίες σε ασφαλή σφάλματα εφαρμογής
Καταγράψει χρόνους εκτέλεσης και εξαγνισμένα διαγνωστικά

Αυτό το όριο κάνει την εφαρμογή πιο εύκολη στη δοκιμή και μειώνει τον αντίκτυπο μελλοντικών αναβαθμίσεων SDK.

Χρησιμοποιήστε τους επίσημους πόρους λήψης και τεκμηρίωσης Doconut για την εγκατάσταση πακέτων και οδηγίες API ανά έκδοση.

Δημιουργήστε Έναν Χρήσιμο Φιλοξενητή Προβολέα

Το κοντέινερ προβολέα που ανήκει στην εφαρμογή πρέπει να διαθέτει αρκετό χώρο για πραγματικά έγγραφα. Αποφύγετε στενά καρτέλες και σταθερά πλάτη επιφάνειας εργασίας.

.viewer-workspace {
  display: grid;
  grid-template-rows: auto minmax(0, 1fr);
  width: 100%;
  min-height: 36rem;
  height: calc(100dvh - 4rem);
}

.viewer-host {
  min-width: 0;
  min-height: 0;
  overflow: hidden;
}

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

Η σελίδα πρέπει επίσης να παρέχει:

Κατάσταση φόρτωσης που είναι σαφής
Μήνυμα ασφαλούς σφάλματος
Ορατό τίτλο εγγράφου
Δρόμο επιστροφής στη γονική ροή εργασίας
Προσβάσιμους ελέγχους εφαρμογής
Αρκετό χώρο για ευρείες λογιστικά φύλλα και λεπτομερή σχέδια

Επικυρώστε Τα Έγγραφα Πριν Από Την Απόδοση

Αν οι χρήστες ανεβάζουν αρχεία, ελέγξτε:

Μέγεθος αρχείου
Επέκταση και υπογραφή αρχείου
Υποστηριζόμενη μορφή
Απαιτήσεις κωδικού ή κρυπτογράφησης
Επιχειρηματικούς περιορισμούς
Όνομα αποθήκευσης που δημιουργείται από τον διακομιστή

Μην δημιουργείτε διαδρομές διακομιστή απευθείας από το αρχικό όνομα αρχείου. Αποθηκεύστε ένα ασφαλές αναγνωριστικό εφαρμογής και επιλύστε το μέσω εξουσιοδοτημένης υπηρεσίας στην πλευρά του διακομιστή.

Προετοιμάστε Τον Windows Server

Η συμπεριφορά απόδοσης μπορεί να εξαρτάται από το περιβάλλον του διακομιστή. Επιβεβαιώστε:

Υποστηριζόμενες εκδόσεις Windows και .NET
Απαιτούμενες γραμματοσειρές
Τοποθεσία προσωρινής αποθήκευσης και δικαιώματα
Διαθέσιμο CPU, μνήμη και χωρητικότητα δίσκου
Μέγιστο μέγεθος εγγράφου και ταυτόχρονες συνεδρίες
Ρυθμίσεις άδειας χρήσης
Διαδικασίες καθαρισμού

Δοκιμάστε αντιπροσωπευτικά έγγραφα πελατών σε περιβάλλον που ταιριάζει με την παραγωγή.

Λίστα Ελέγχου Ασφαλείας και Ιδιωτικότητας

Πριν την κυκλοφορία:

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

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

Δοκιμάστε Πέρα Από Το Χαρούμενο Σενάριο

Η βιβλιοθήκη δοκιμών σας πρέπει να περιλαμβάνει:

Πολυσέλιδα PDF
Μεγάλα λογιστικά φύλλα
Λεπτομερή σχέδια CAD
Παρουσιάσεις με ασυνήθιστες γραμματοσειρές
Αρχεία email με συνημμένα
Μεγάλες εικόνες
Κατεστραμμένα και μη υποστηριζόμενα αρχεία
Μη εξουσιοδοτημένα αιτήματα
Ταυτόχρονες συνεδρίες προβολής
Διακοπές αιτημάτων και επανεκκινήσεις εφαρμογής

Βεβαιωθείτε ότι οι αποτυχίες δεν αποκαλύπτουν διαδρομές διακομιστή, στοίβες εντολών ή URLs αποθήκευσης.

Πού Τοποθετείται Το Doconut

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

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

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

Συμπέρασμα

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

Για εφαρμογές ASP.NET και .NET σε Windows, το Doconut μπορεί να παρέχει το επίπεδο προβολής εγγράφων ενώ η ομάδα σας διατηρεί τον έλεγχο της εφαρμογής και του κύκλου ζωής των εγγράφων.