Document viewer

Utilisez la commande Visionneuse de documents pour restituer un document et l'afficher en ligne dans votre application. Par exemple, vous pouvez utiliser la commande Visionnage de document pour afficher un document de facturation ou un reçu qui peut être situé dans diverses sources, telles que des compartiments de stockage, des entités ou des liens publics.

Le contrôle Visionneuse de documents ne prend pas en charge les fichiers sur la machine locale. Vous devez référencer des documents distants à l'aide d'une URL, d'un compartiment de stockage ou d'une entité.

Lorsque vous attribuez le fichier à une variable d’application, assurez-vous que la variable est de type IResource.

Si vous souhaitez afficher uniquement une image, il est recommandé d'utiliser la commande Image .

Important :

La visionneuse de documents utilise une visionneuse PDF.js intégrée, qui fonctionne de manière cohérente sur tous les navigateurs. Aucune configuration de navigateur n'est requise. Lors du chargement de fichiers PDF à partir de serveurs de fichiers externes, le serveur doit prendre en charge les requêtes d’origine croisée. Si CORS n’est pas activé, la visionneuse PDF.js intégrée ne pourra pas restituer le document.

Utilisation de la visionneuse de documents avec un compartiment de stockage

Si vous travaillez avec un compartiment de stockage dans votre application, la propriété Source d'un contrôle Visionnage de document doit être une variable IResource :

1. Ajoutez une règle Télécharger depuis le compartiment de stockage à votre application.
2. Liez une variable IResource à la règle Télécharger depuis le compartiment de stockage .
3. Liez la même variable IResource à la propriété Source du Document Viewer.

Utilisation d’IResource

Si vous obtenez un fichier en tant que ILocalResource, il est automatiquement converti en IResource à l'aide de :

JobAttachment.fromResource(file) // file is a ILocalResource

Important :

Les fonctions suivantes sont obsolètes et ne doivent plus être utilisées :

• .toLocalResource
• .toAppsFile

Navigation sur la page

Vous pouvez naviguer par programmation vers une page spécifique à l'intérieur du visualiseur de documents en utilisant :

appsFile.NavigateToPage(pageNumber)

Général

• Source : la source du document que vous souhaitez afficher. Les types de fichiers pris en charge sont les documents et images PDF (JPEG, PNG, BMP, GIF et WEBP).
• Masqué (Hidden) : si la valeur est true, masque la commande au moment du runtime.
• Désactivé (Disabled) : si la valeur est true, désactive la commande au moment du runtime.

Events

Pas d’événements.

Style

• Alignement de commande (Control Alignment) : hérite de l'alignement parent par défaut. Un autre alignement que le parent peut être défini. Pour revenir par défaut à l'alignement parent, désélectionnez les options remplacées.
  Remarque :

  L'alignement dépend de la mise en page sélectionnée pour le parent.

• Bordure (Border) : la bordure de la commande. L'épaisseur (Thickness), la couleur (Color) et le rayon (Radius) peuvent être configurés.
• Marge (Margin) : la marge de la commande. Par défaut, une marque de 4px est définie. Les propriétés des marges Haut/Bas (Top/Bottom)et Gauche/Droite (Left/Right) sont combinées. Ces propriétés peuvent être dissociées à l'aide du bouton Lier (Link) sur le côté droit de la section Marge (Margin).
• Taille : largeur et hauteur de la commande. Par défaut, la taille est définie sur auto, ce qui signifie 320 x 410px. Pour définir des valeurs minimales ou maximales, sélectionnez l'icône à trois points (*).

Propriétés VB

Propriété VB	Type de données	Description
Source	IResource	Le fichier source actuellement visualisé.
Value	IResource	Valeur jointe ou générée à partir de la commande Visionnage de document .
Hidden	Booléen	Si la valeur est true, masque la commande au moment du runtime.
Disabled	Booléen	Si la valeur est true, désactive la commande au moment du runtime.