Trier et formater les rapports Forward Path

Cette rubrique fournit des informations sur la façon de contrôler l’ordre de tri du rapport Forward Path et la mise en forme des données de l’application.

Trier la liste des applications

Vous pouvez trier la liste des applications dans le rapport Forward Path en fonction des données contenues dans l’une des colonnes. Par exemple, vous pouvez trier les applications en fonction de leur nom, de leur fabricant, de leur statut RAG ou des valeurs dans l’une des autres colonnes.

Vous définissez l’ordre de tri à l’aide de l’objet Settings, qui est disponible tout au long du scénario. L’objet Settings est de type ForwardPathReportSettings. Si vous regardez dans l’Explorateur de propriétés (à droite de l’Éditeur logique Forward Path avant), vous verrez les propriétés de cet objet.

Généralement, vous définissez l’ordre de tri dans la fonction Initialize (). Par exemple, les éléments suivants trie les applications par les valeurs de la colonne RAG :

Public Overrides Sub Initialize()

   ' Sort the report on the RAG column.
   Settings.ApplicationSortBy = "Rag"

End Sub

Par défaut, le tri est dans l’ordre croissant (valeur la plus basse à la plus élevée). Pour les valeurs RAG, ceci est vert, ambre, rouge. Pour inverser ceci (en rouge, ambre, vert), ajoutez une autre ligne comme ceci :

Settings.ApplicationSortDescending = true

Dans un rapport groupé, vous pouvez définir l’ordre de tri des groupes comme ceci :

Settings.GroupSortBy = "Cost"

Par défaut, cela trie les groupes sur les valeurs de la colonne Coût du groupe dans l’ordre croissant. Vous pouvez le changer en ordre décroissant, comme ceci :

Settings.GroupSortDescending = true

Note : Les conventions de tri des données varient d’une culture à l’autre. Par défaut, les conventions définies par les paramètres régionaux de l’utilisateur sont utilisées. Cependant, vous pouvez remplacer cela à l’aide de la propriété Culture comme expliqué ci-dessous.

Formater les données de colonne

Les propriétés suivantes vous permettent de formater des colonnes de rapport :

  • Format : permet de spécifier le mode de mise en forme des données. Par exemple, vous pouvez spécifier que les données numériques doivent être formatées sous la forme d’une valeur en pourcentage ou d’une devise. Vous spécifiez la mise en forme à l’aide d’une chaîne mise en forme composite standard (seul l’élément d’index zéro peut être utilisé). Nous fournissons plus d’informations et d’exemples ci-dessous.
  • Culture — Par défaut, le séparateur décimal régional et le symbole monétaire de l’utilisateur sont utilisés lors de la mise en forme de devises et de valeurs décimales. Toutefois, si vous travaillez dans un environnement international, cela peut signifier que le symbole monétaire varie en fonction des paramètres régionaux de l’appareil de l’utilisateur final. Vous pouvez utiliser la propriété Culture pour remplacer le comportement par défaut (de sorte que, par exemple, le symbole monétaire ne change pas en fonction des paramètres régionaux du périphérique sur lequel le rapport est affiché). Vous spécifiez la culture à l’aide d’une combinaison du code de culture de deux lettres en minuscules ISO 639 associé à une langue et du code de sous-culture de deux lettres en majuscules ISO 3166 associé à un pays ou à une région. Par exemple, si vous souhaitez utiliser le symbole dollar américain, vous devez spécifier la valeur en-US. Plus d’informations et d’exemples suivent.

La capture d’écran suivante de l’Explorateur de propriétés met en évidence ces propriétés pour la colonne Coût standard et la première colonne CustomField. Notez que vous trouvez ces propriétés pour les colonnes standard (telles que les colonnes Résultat, Rag, Coût et Description) sous le nœud Affichage. Alors que pour les colonnes CustomField, les propriétés sont sous CustomField lui-même.

Explorateur de propriétés

Note : Par défaut, la colonne Coût est formatée en devise.

Définir la propriété Format

Vous spécifiez la mise en forme à l’aide d’une chaîne mise en forme composite standard (seul l’élément d’index zéro peut être utilisé). Par exemple, vous pouvez formater une colonne sous forme de pourcentage, comme ceci :

result.CustomField1.Format = "{0:P}"

Cela multiplie la valeur numérique stockée dans la colonne par 100 et la convertit en une chaîne représentant un pourcentage dans la sortie. Par exemple, la valeur 0,05 est affichée sous la forme de 5,00% lorsque le rapport est exécuté au Royaume-Uni à l’aide du paramètre de culture britannique par défaut.

Vous pouvez formater une colonne en tant que valeur monétaire, comme ceci :

result.CustomField1.Format = "{0:C}"

Cette option affiche la valeur numérique avec deux décimales et le symbole monétaire. Par défaut, le symbole monétaire est extrait des paramètres régionaux de l’utilisateur, par exemple, 75,00 £en utilisant les paramètres régionaux du Royaume-Uni. Vous pouvez remplacer ce paramètre à l’aide de la propriété Culture.

Définir la propriété Culture

Vous spécifiez la culture à l’aide d’une combinaison du code de culture de deux lettres en minuscules ISO 639 associé à une langue et du code de sous-culture de deux lettres en majuscules ISO 3166 associé à un pays ou à une région (par exemple en-US pour l’anglais des États-Unis).

Par exemple, vous pouvez définir la propriété Culture sur Japonais comme ceci :

result.CustomField1.Culture = "ja-JP"

Si la colonne est une devise, elle aura le symbole de la devise Yen.

Vous pouvez définir la culture en espagnol, comme ceci :

result.CustomField1.Culture = "es-ES"