NetVault 12.2 - Guide de référence

Utilisant de l'option -format

Par défaut, un rapport s'affiche selon une mise en page prédéfinie lorsqu'il est exécuté dans la fenêtre de terminal. Vous pouvez utiliser l'option -format pour spécifier le nombre de caractères qui s'affichent dans une colonne, insérer un saut de ligne, ou ajouter ou supprimer des colonnes. Les sections suivantes décrivent les options de mise en forme :

Lorsque vous utilisez l'option -format, vous devez utiliser le nom réel des champs. Chaque nom doit être précédé du symbole « % ». Si le nom réel inclut le symbole «  % », utilisez la séquence d'échappement « %% » lorsque vous spécifiez le nom. De plus, vous devez spécifier tous les champs obligatoires de la syntaxe. Si vous omettez un champ dans la syntaxe, celui-ci ne s'affichera pas dans la sortie.

Pour spécifier le nombre maximum de caractères d'une colonne, ajoutez au nom réel deux deux-points suivis d'un nombre :

Exemple :

Pour inclure un saut de ligne entre chaque entrée dans la sortie du rapport, ajoutez « %\n » à la fin de la liste des champs nommés avec l'option -format :

Exemple :

Certains fichiers modèles contiennent plusieurs champs supplémentaires qui peuvent être inclus dans la sortie à l'aide de l'option -format. Pour ajouter une colonne, récupérez la liste complète des champs disponibles pour un fichier modèle à l'aide de la commande nvreport -help field <nom de la classe>. Vérifiez les informations contenues dans la colonne Description pour chaque champ et ajoutez les champs applicables. Veillez à utiliser le nom réel du champ.

L'exemple suivant utilise le rapport prédéfinis « drives ». Il comprend tous les champs par défaut et affiche le nombre d'erreurs d'écriture pour le lecteur.

Exemple :

Utilisation de l'option -sort

L'option -sort permet de trier les entrées sur un champ sélectionné. Une expression de tri est spécifiée au format suivant :

Un rapport peut être trié selon n'importe quel champ contenu dans une classe. Vous pouvez utiliser un nom réel du champ pour trier la sortie, même s'il ne s'affiche pas dans la sortie.

Lorsque vous utilisez l'option -sort, vous devez utiliser le nom réel des champs. Chaque nom doit être précédé du symbole « % ». Si le nom réel inclut le symbole «  % », utilisez la séquence d'échappement « %% » lorsque vous spécifiez le nom.

Exemple :

Vous pouvez spécifier plusieurs champs avec l'option « -sort ». Le rapport généré hiérarchise le tri selon l'ordre des noms de champs donné dans la syntaxe. Lorsque vous utilisez plusieurs champs de tri, placez tous les champs entre guillemets (" ").

Exemple :

Utilisation de l'option -include

L'option -include permet de filtrer les données pour un rapport. Une expression de filtre est spécifiée au format suivant :

Pour joindre plusieurs expressions de filtre, utilisez « AND » et « OR ». Utilisez également des parenthèses pour indiquer la priorité des arguments.

Exemples :

Utilisation de l'option -title

Lorsqu'un rapport est exécuté et visualisé depuis la ligne de commande, la sortie lui attribue le titre par défaut « CLI Report ». L'option -title permet de modifier le titre du rapport. L'option -title est spécifiée au format suivant :

Si un titre doit contenir des espaces, l'ensemble de la valeur doit être placée entre guillemets. Bien que l'option « ‑title » puisse être utilisée pour étiqueter un rapport de sortie CLI, il est préférable de l'utiliser pour étiqueter un rapport généré dans un fichier et consulté en dehors de la CLI.