Recherche

Le Doconut Viewer fournit une recherche normale en utilisant le texte extrait par le visualiseur de format ou une redirection PDF basée sur du texte. Il nécessite la capacité de licence Search.

Activer l'interface de recherche

La recherche est un module Viewer, pas une barre d'outils autonome. La page complète doit inclure les ressources Viewer, la barre d'outils Viewer, le montage Viewer, et le objViewer initialisé ; le Ruban de recherche est alors monté et attaché à cette même instance.

La recherche et l'annotation sont des fonctionnalités sous licence intégrées, pas des packages AddPlugin<T>(). Demandez les ressources de recherche auprès du Viewer injecté ; leurs balises sont émises uniquement lorsque la licence accorde la recherche.

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

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

Le ruban intégré appelle les mêmes méthodes JavaScript disponibles pour une interface personnalisée.

Gardez la composition complète du Viewer visible dans le balisage, initialisez docViewer d'abord, et ensuite attachez le Ruban sous licence :

<nav id="toolbar" aria-label="Document viewer controls">
    <!-- Contrôles du visualiseur, y compris le bouton qui ouvre la recherche -->
</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 (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>

Le composant injecte les groupes Find, Options et Results et gère la recherche, le nettoyage, les comptes de correspondances, ainsi que la navigation vers la correspondance précédente/suivante. Une barre d'outils Viewer appartenant à l'hôte n'a besoin que de le basculer :

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

Son API public est intentionnellement petit :

Le rappel optionnel onToggle(isOpen) permet à l'hôte de synchroniser son bouton de recherche, et onLayout lui permet de redimensionner/ajuster le viewer lorsque la hauteur du Ruban change. Pour la séquence de démarrage combinée du Viewer, de la Recherche et de l'Annotation, voir Quick Start.

Recherche depuis JavaScript

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

Le deuxième argument indique une correspondance mot entier/exacte. Après le rappel :

La route middleware utilise search=<term> et exact=true|false et renvoie du XML. Utilisez l'API du widget plutôt que d'analyser vous-même cette réponse interne.

Vérifier la capacité de recherche

La réponse d'initialisation indique :

X-Doconut-Can-Search: 1

Après l'initialisation, objViewer.CanSearch() expose le même verdict format/session. Il renvoie false lorsque le serveur envoie 0 ; avant la réponse, ou avec un serveur plus ancien qui omet l'en-tête, il revient à true.

Trois portes indépendantes ne doivent pas être confondues :

Un format peut être techniquement recherchable alors que la licence actuelle refuse l'opération.

Activer l'extraction par format

var token = await viewer.OpenDocumentAsync(path, new PdfConfig
{
    AllowSearch = true,
    AllowCopy   = true   // optionnel : permet à l'utilisateur de faire glisser une région et de copier son texte
});

AllowSearch et AllowCopy existent sur PdfConfig, WordConfig, ExcelConfig et PptConfig. Les propriétés Office délèguent à leurs PdfConfig imbriqués. Les deux sont par défaut false.

Des adaptateurs de recherche native normaux existent pour PDF, Word, Excel, PowerPoint, TXT, Visio, email, EPUB et MHT. XPS utilise son chemin PDF par défaut. HTML et Microsoft Project bénéficient d'une redirection PDF basée sur du texte :

// DefaultRender = false → converti en PDF texte‑basé → recherchable
var token = await viewer.OpenDocumentAsync(path, new HtmlConfig { DefaultRender = false });

Pour les rendus natifs, CanSearch() décrit la capacité du viewer ; cela ne garantit pas qu'un document particulier contienne du texte exploitable. Un PDF dont les pages ne sont que des images numérisées peut toujours produire zéro résultat natif.

Comportement de la recherche normale

Le serveur tente les sources de recherche dans cet ordre :

1. Résultats natifs ISearchableViewer.
2. Un index de recherche .srh préconstruit.
3. Une erreur/résultat vide lorsqu'aucune source de recherche n'existe.

L'index .srh est l'artifact de recherche publié avec les images de page lorsque les documents sont servis depuis un stockage partagé, ainsi un nœud qui n'a jamais ouvert le document peut encore répondre aux recherches — voir Distributed Deployments.

CanSearch() peut être vrai pour un viewer recherchable même lorsqu'un document numérisé particulier n'a pas de couche de texte et renvoie donc aucune correspondance.

Licence et comportement de l'interface

Une licence Temporaire/Démo active accorde la Recherche pendant sa période active. Une licence manquante et un fichier legacy TRIAL n'accordent aucune capacité de Recherche. Sans Recherche :

• ReferenceCss et ReferenceScripts omettent les bundles de recherche.
• Le middleware refuse la recherche au lieu de renvoyer des résultats sous licence.

Contrôlez la visibilité de l'interface personnalisée depuis IDoconutLicenseService.IsCapabilityGranted(LicenseCapability.Search) et utilisez CanSearch() pour le verdict séparé format/session.

Dépannage