Ricerca

Il Doconut Viewer fornisce la Ricerca normale utilizzando il testo estratto dal visualizzatore di formato o da un reindirizzamento PDF basato su testo. Richiede la capacità di licenza Search.

Abilita l'interfaccia di ricerca

La Ricerca è un modulo del Viewer, non una barra degli strumenti autonoma. L'intera pagina deve includere le risorse del Viewer, la barra degli strumenti del Viewer, il mount del Viewer e l'objViewer inizializzato; il Ribbon di Ricerca viene quindi montato e collegato alla stessa istanza.

La Ricerca e l'annotazione sono funzionalità con licenza integrate, non pacchetti AddPlugin<T>(). Richiedi le risorse di ricerca dal Viewer iniettato; i loro tag vengono emessi solo quando la licenza concede la Ricerca.

@Html.Raw(Viewer.ReferenceCss(new CssConfig
{
    IncludeViewerCss = true,
    IncludeSearchCss = true
}))

@Html.Raw(Viewer.ReferenceScripts(new ScriptConfig
{
    IncludeJQuery = true,
    IncludeViewerScripts = true,
    IncludeSearchScripts = true,
    IncludeSearchBar = true
}))

Il ribbon incorporato chiama gli stessi metodi JavaScript disponibili per un'interfaccia personalizzata.

Mantieni la composizione completa del Viewer visibile nel markup, inizializza docViewer per primo, quindi collega il Ribbon con licenza:

<nav id="toolbar" aria-label="Document viewer controls">
    <!-- Controlli del visualizzatore, incluso il pulsante che apre la Ricerca -->
</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: 'doconut',
        ResPath: 'doconut-res/images'
    });

    @if (Viewer.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>

Il componente inietta i gruppi Trova, Opzioni e Risultati e gestisce la ricerca, la cancellazione, i conteggi delle corrispondenze e la navigazione tra corrispondenze precedenti/successive. Una barra degli strumenti del Viewer di proprietà dell'host deve solo attivarla:

searchBar.isOpen() ? searchBar.close() : searchBar.open();

La sua API pubblica è intenzionalmente piccola:

Il callback opzionale onToggle(isOpen) consente all'host di sincronizzare il suo pulsante di Ricerca, e onLayout gli permette di ridimensionare/riadattare il visualizzatore quando l'altezza del Ribbon cambia. Per la sequenza di avvio combinata di Viewer, Ricerca e Annotazione, vedere Avvio rapido.

Ricerca da JavaScript

objViewer.Search(keyword, false, function (resultCount) {
    console.log('Matches:', resultCount);
});

Il secondo argomento indica la corrispondenza parola intera/esatta. Dopo il callback:

Il percorso middleware utilizza search=<term> e exact=true|false e restituisce XML. Usa l'API del widget anziché analizzare manualmente quella risposta interna.

Verifica la capacità di ricerca

La risposta di inizializzazione riporta:

X-Doconut-Can-Search: 1

Dopo l'inizializzazione, objViewer.CanSearch() espone lo stesso verdetto formato/sessione. Restituisce false quando il server invia 0; prima della risposta, o con un server più vecchio che omette l'intestazione, il valore predefinito è true.

Tre porte indipendenti non devono essere confuse:

Un formato può essere tecnicamente ricercabile mentre la licenza corrente nega l'operazione.

Abilita l'estrazione per formato

var token = await viewer.OpenDocumentAsync(path, new PdfConfig
{
    AllowSearch = true,
    AllowCopy   = true   // opzionale: consente all'utente di trascinare una regione e copiare il suo testo
});

AllowSearch e AllowCopy esistono su PdfConfig, WordConfig, ExcelConfig e PptConfig. Le proprietà Office delegano al loro PdfConfig nidificato. Entrambe hanno valore predefinito false.

Gli adattatori di ricerca nativa normali esistono per PDF, Word, Excel, PowerPoint, TXT, Visio, email, EPUB e MHT. XPS utilizza il suo percorso PDF per impostazione predefinita. HTML e Microsoft Project beneficiano di un reindirizzamento PDF basato su testo:

// DefaultRender = false → convertito in un PDF basato su testo → ricercabile
var token = await viewer.OpenDocumentAsync(path, new HtmlConfig { DefaultRender = false });

Per i renderer nativi, CanSearch() descrive la capacità del visualizzatore; non garantisce che un documento specifico contenga testo utilizzabile. Un PDF le cui pagine sono solo immagini scansionate può comunque produrre zero risultati nativi.

Comportamento della Ricerca normale

Il server prova le fonti di ricerca in questo ordine:

1. Risultati nativi di ISearchableViewer.
2. Un indice di ricerca .srh predefinito.
3. Un risultato di errore/vuoto quando non esiste alcuna fonte di ricerca.

CanSearch() può essere vero per un visualizzatore ricercabile anche quando un documento scansionato specifico non ha uno strato di testo e quindi restituisce zero corrispondenze.

Licenza e comportamento dell'interfaccia

Una licenza Temporanea/Demo attiva concede la Ricerca durante il suo periodo attivo. Una licenza mancante e un file legacy TRIAL non concedono alcuna capacità di Ricerca. Senza Ricerca:

• ReferenceCss e ReferenceScripts omettono i pacchetti di ricerca.
• Il middleware nega la ricerca invece di restituire risultati con licenza.

Gestisci la visibilità dell'interfaccia personalizzata tramite IDoconutLicenseService.IsCapabilityGranted(LicenseCapability.Search) e usa CanSearch() per il verdetto separato formato/sessione.

Risoluzione dei problemi