Αναζήτηση
Φυσική αναζήτηση κειμένου στη σύνθεση του Viewer
Το Doconut Viewer παρέχει κανονική Αναζήτηση χρησιμοποιώντας κείμενο που εξάγεται από το πρόγραμμα προβολής μορφής ή μια ανακατεύθυνση PDF βασισμένη σε κείμενο. Απαιτεί τη δυνατότητα άδειας Search.
Ενεργοποίηση του UI αναζήτησης
Η Αναζήτηση είναι μια μονάδα του Viewer, όχι μια αυτόνομη γραμμή εργαλείων. Η πλήρης σελίδα πρέπει να περιλαμβάνει τους πόρους του Viewer, τη γραμμή εργαλείων του Viewer, το mount του Viewer και το αρχικοποιημένο objViewer· η Ribbon Αναζήτησης στη συνέχεια τοποθετείται και συνδέεται με το ίδιο στιγμιότυπο.
Η Αναζήτηση και η σημείωση είναι ενσωματωμένα χαρακτηριστικά με άδεια, όχι πακέτα AddPlugin<T>(). Ζητήστε τους πόρους αναζήτησης από το Viewer· οι ετικέτες τους εκδίδονται μόνο όταν η άδεια παρέχει την Αναζήτηση. Οι προβολές MVC 5 δεν έχουν @inject, επομένως δημιουργήστε τις ετικέτες στον ελεγκτή και μεταβιβάστε τις μέσω ViewBag, μαζί με τη σημαία άδειας που χρειάζεται η σελίδα:
public class ViewerController : Controller
{
public ActionResult Index()
{
var viewer = Doconut.DoconutHost.Services.GetRequiredService<Viewer>();
ViewBag.ViewerCss = viewer.ReferenceCss(new CssConfig
{
IncludeViewerCss = true,
IncludeSearchCss = true
});
ViewBag.ViewerScripts = viewer.ReferenceScripts(new ScriptConfig
{
IncludeJQuery = true,
IncludeViewerScripts = true,
IncludeSearchScripts = true,
IncludeSearchBar = true
});
ViewBag.IsSearchEnabled = viewer.IsSearchEnabled;
return View();
}
}Γράψτε τις στην προβολή με @Html.Raw(ViewBag.ViewerCss) και @Html.Raw(ViewBag.ViewerScripts). Στα Web Forms, εκθέστε τις ίδιες τιμές από τον κώδικα-πίσω και γράψτε τις με <%= %>.
Η ενσωματωμένη ribbon καλεί τις ίδιες μεθόδους JavaScript που είναι διαθέσιμες σε προσαρμοσμένο UI.
Διατηρήστε τη πλήρη σύνθεση του Viewer ορατή στο markup, αρχικοποιήστε πρώτα το docViewer και στη συνέχεια συνδέστε τη licensed Ribbon:
<nav id="toolbar" aria-label="Document viewer controls">
<!-- Στοιχεία ελέγχου προβολής, συμπεριλαμβανομένου του κουμπιού που ανοίγει το Search -->
</nav>
<div id="searchBarMount"></div>
<div id="divDocViewer"><div id="div_ctlDoc"></div></div>
<script>
let searchBar = null;
let currentToken = '';
const objViewer = $('#div_ctlDoc').docViewer({
BasePath: '/',
ResPath: 'doconut-res/images'
});
@if ((bool)ViewBag.IsSearchEnabled)
{
<text>
searchBar = $('#searchBarMount').doconutSearchBar({
docId: 'ctlDoc',
getRequestParams: () => ({ token: currentToken }),
onStatus: (message) => console.log(message),
onToast: (message, type) => console.log(type, message),
onLayout: () => requestAnimationFrame(() => objViewer.Refit())
});
searchBar.attach(objViewer);
</text>
}
</script>Το if στο server-side έχει σημασία: χωρίς τη δυνατότητα Αναζήτησης, το ReferenceScripts παραλείπει το script της Ribbon, έτσι μια μη προστατευμένη κλήση doconutSearchBar(...) θα προκαλέσει εξαίρεση και θα εμποδίσει την εκκίνηση της σελίδας του viewer. Στα Web Forms, γράψτε την ίδια προστασία ως <% if (IsSearchEnabled) { %> … <% } %>.
Το στοιχείο ενσωματώνει τις ομάδες Find, Options και Results και διαχειρίζεται την αναζήτηση, τον καθαρισμό, τους μετρητές αντιστοιχίσεων και την πλοήγηση σε προηγούμενη/επόμενη αντιστοιχία. Μια γραμμή εργαλείων Viewer που ανήκει στον κεντρικό σύστημα χρειάζεται μόνο να την εναλλάσσει:
searchBar.isOpen() ? searchBar.close() : searchBar.open();Το δημόσιο API του είναι σκόπιμα μικρό:
| Μέθοδος | Σκοπός |
|---|---|
attach(objViewer) | Συνδέει τη Ribbon με τον αρχικοποιημένο viewer· απαιτείται μία φορά |
open() / close() | Εμφανίζει ή κρύβει τη Ribbon· το κλείσιμο επίσης καθαρίζει τις επισημάνσεις |
reset() | Καθαρίζει τον τρέχοντα όρο, τον αριθμό αποτελεσμάτων και τις επισημάνσεις |
isOpen() | Αναφέρει αν η Ribbon είναι ορατή |
setStatus(message) | Προωθεί ένα μήνυμα κατάστασης μέσω της ρυθμισμένης callback |
Η προαιρετική onToggle(isOpen) callback επιτρέπει στον κεντρικό σύστημα να συγχρονίσει το κουμπί Αναζήτησης, και το onLayout του επιτρέπει να αλλάζει το μέγεθος/προσαρμόζει τον viewer όταν η Ribbon αλλάζει ύψος. Για τη συνδυασμένη ακολουθία εκκίνησης Viewer, Αναζήτησης και Σημείωσης, δείτε Γρήγορη Εκκίνηση.
Αναζήτηση από JavaScript
objViewer.Search(keyword, false, function (resultCount) {
console.log('Matches:', resultCount);
});Το δεύτερο όρισμα είναι αντιστοίχιση ολόκληρης λέξης/ακριβούς. Ο αριθμός των αντιστοιχίσεων φτάνει στην κλήση επιστροφής: Search στέλνει τον εαυτό του στον διακομιστή και δεν επιστρέφει κάτι χρήσιμο, έτσι το var n = objViewer.Search(keyword, false) πάντα διαβάζει undefined — και μια σελίδα που δημιουργείται με αυτόν τον τρόπο αναφέρει «δεν βρέθηκε τίποτα» ενώ ο προβολέας επισημαίνει τις αντιστοιχίσεις. Μετά την κλήση επιστροφής:
| Μέθοδος | Αποτέλεσμα |
|---|---|
SearchMatchCount() | Συνολικές μεμονωμένες αντιστοιχίες στο έγγραφο. |
SearchSummary(false) | [pageNumber, matchCount] καταχωρήσεις χωρίς επανασχεδίαση. |
SearchSummary(true) | Ίδιο σύνοψη και ζωγραφίζει επισημάνσεις σελίδας/μικρογραφίας. |
GotoSearchMatch(index) | Πλοηγείται σε δείκτη αντιστοίχισης μηδενικής βάσης. |
DocImage.axd απαντά search=<term> και exact=true|false με XML. Χρησιμοποιήστε το widget API αντί να αναλύετε την εσωτερική αυτή απάντηση μόνοι σας.
Έλεγχος δυνατότητας αναζήτησης
Η απάντηση αρχικοποίησης αναφέρει:
X-Doconut-Can-Search: 1Μετά την αρχικοποίηση, το objViewer.CanSearch() εκθέτει το ίδιο verdict μορφής/συνεδρίας. Επιστρέφει false όταν ο διακομιστής στέλνει 0· πριν από την απάντηση, ή με παλαιότερο διακομιστή που παραλείπει την κεφαλίδα, προεπιλογή είναι true.
Τρία ανεξάρτητα πύλες δεν πρέπει να συγχέονται:
| Πύλη | Ερώτηση |
|---|---|
CanSearch() / response header | Έχει ο επιλυμένος προβολέας εγγενή διαδρομή ευρετηρίου/αναζήτησης; |
AllowSearch | Ζήτησε αυτή η διαμόρφωση μορφής εξαγωγή κειμένου όπου υπάρχει το διακόπτης; |
LicenseCapability.Search | Είναι η εφαρμογή εξουσιοδοτημένη να εκτελεί αναζήτηση και να λαμβάνει τα UI πακέτα; |
Μια μορφή μπορεί τεχνικά να είναι αναζητήσιμη ενώ η τρέχουσα άδεια αρνείται τη λειτουργία.
Ενεργοποίηση εξαγωγής ανά μορφή
var token = await viewer.OpenDocumentAsync(path, new PdfConfig
{
AllowSearch = true,
AllowCopy = true // προαιρετικό: επιτρέπει στον χρήστη να σύρει μια περιοχή και να αντιγράψει το κείμενό της
});AllowSearch και AllowCopy υπάρχουν στο PdfConfig, WordConfig, ExcelConfig και PptConfig. Οι ιδιότητες Office παραπέμπουν στα ένθετα PdfConfig. Και τα δύο προεπιλογή είναι false.
Κανονικοί προσαρμογείς εγγενούς αναζήτησης υπάρχουν για PDF, Word, Excel, PowerPoint, TXT, Visio, email, EPUB και MHT. Το XPS χρησιμοποιεί την διαδρομή PDF του από προεπιλογή. Το HTML και το Microsoft Project ωφελούνται από μια ανακατεύθυνση PDF βασισμένη σε κείμενο:
// DefaultRender = false → μετατράπηκε σε PDF βασισμένο σε κείμενο → αναζητήσιμο
var token = await viewer.OpenDocumentAsync(path, new HtmlConfig { DefaultRender = false });Για εγγενείς αποτυπωτές, το CanSearch() περιγράφει τη δυνατότητα του προβολέα· δεν εγγυάται ότι ένα συγκεκριμένο έγγραφο περιέχει χρήσιμο κείμενο. Ένα PDF του οποίου οι σελίδες είναι μόνο σαρωμένες εικόνες μπορεί ακόμη να παράγει μηδενικά εγγενή αποτελέσματα.
Κανονική συμπεριφορά αναζήτησης
Ο διακομιστής δοκιμάζει πηγές αναζήτησης με αυτή τη σειρά:
- Αποτελέσματα από τον εγγενή προβολέα της μορφής.
- Ένα προ-κατασκευασμένο ευρετήριο αναζήτησης
.srh. - Σφάλμα/κενό αποτέλεσμα όταν δεν υπάρχει πηγή αναζήτησης.
CanSearch() μπορεί να είναι αληθές για έναν αναζητήσιμο προβολέα ακόμη και όταν ένα συγκεκριμένο έγγραφο δεν έχει στρώση κειμένου και επομένως δεν επιστρέφει αντιστοιχίες.
Άδεια και συμπεριφορά UI
Μια ενεργή άδεια Temporary/Demo παρέχει Αναζήτηση κατά τη διάρκεια της ενεργής περιόδου της. Μια ελλιπής άδεια και ένα παλιό αρχείο TRIAL δεν παρέχουν δυνατότητα Αναζήτησης. Χωρίς Αναζήτηση:
ReferenceCssκαιReferenceScriptsπαραλείπουν τα πακέτα αναζήτησης.DocImage.axdαρνείται αιτήματα αναζήτησης αντί να επιστρέφει αποτελέσματα.
Διαχειριστείτε την ορατότητα προσαρμοσμένου UI από το IDoconutLicenseService.IsCapabilityGranted(LicenseCapability.Search) και χρησιμοποιήστε το CanSearch() για το ξεχωριστό verdict μορφής/συνεδρίας.
Επίλυση προβλημάτων
| Σύμπτωμα | Έλεγχος |
|---|---|
| Η γραμμή αναζήτησης λείπει | Δυνατότητα αναζήτησης και IncludeSearchCss/IncludeSearchScripts/IncludeSearchBar |
CanSearch() είναι ψευδές | Προβολέας μορφής, επιλεγμένη διαδρομή DefaultRender, και κεφαλίδα απάντησης αρχικοποίησης |
| Η αναζήτηση επιστρέφει μηδέν για ένα σαρωμένο PDF | Το έγγραφο δεν έχει στρώση κειμένου· χρησιμοποιήστε πηγή που περιέχει κείμενο ή μια προβολή PDF που διατηρεί το κείμενο |
| Η αναζήτηση λειτουργεί αλλά οι επισημάνσεις είναι μετατοπισμένες | Διαδρομή απόδοσης, ανάλυση, μετασχηματισμοί εγγράφου και εξαγόμενα κουτιά λέξεων |
Ήταν αυτή η σελίδα χρήσιμη;