Ordenar y dar formato a los informes de Forward Path

En este tema se proporciona información acerca de cómo controlar el orden del informe Forward Path y el formato de los datos de la aplicación.

Ordenar la lista de aplicaciones

Puede ordenar la lista de aplicaciones en el informe Forward Path en función de los datos de cualquiera de las columnas. Por ejemplo, puede ordenar las aplicaciones por su nombre, fabricante, estado de RAG o los valores de cualquiera de las demás columnas.

El criterio de ordenación se establece mediante el objeto Settings, que está disponible en todo el caso. El objeto Settings es de tipo ForwardPathReportSettings. Si observa en el Explorador de propiedades (en el lado derecho del Editor de lógica de Forward Path) verá las propiedades de este objeto.

Normalmente se establece el orden en la función Initialize(). Por ejemplo, lo siguiente ordena las aplicaciones por los valores de la columna RAG:

Public Overrides Sub Initialize()

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

End Sub

De forma predeterminada, la ordenación está en orden ascendente (de menor a mayor valor). Para valores RAG, esto es verde, ámbar, rojo. Para revertir esto (a rojo, ámbar, verde), agregue otra línea como esta:

Settings.ApplicationSortDescending = true

En un informe agrupado, puede establecer el orden de clasificación de los grupos como este:

Settings.GroupSortBy = "Cost"

De forma predeterminada, esto ordena los grupos en los valores de la columna Coste del grupo en orden ascendente. Puede cambiarlo a orden descendente, así:

Settings.GroupSortDescending = true

Nota: Las convenciones para ordenar datos varían de una cultura a otra. De forma predeterminada, se utilizan las convenciones definidas por la configuración regional del usuario. Sin embargo, puede anularlo mediante la propiedad Cultura como se explica a continuación.

Dar formato a los datos de la columna

Las siguientes propiedades le permiten dar formato a las columnas de informe:

  • Formato: Utilice esta opción para especificar cómo quiere dar formato a los datos. Por ejemplo, puede especificar que los datos numéricos deban formatearse como un valor porcentual o como una moneda. El formato se especifica mediante una cadena de formato compuesto estándar (solo se puede utilizar el elemento de índice cero). A continuación ofrecemos más información y ejemplos.
  • Cultura: De forma predeterminada, el separador decimal regional y el símbolo de moneda del usuario se utilizan al aplicar formato a la moneda y a los valores decimales. Sin embargo, si está trabajando en un entorno internacional, esto puede significar que el símbolo de moneda variará según la configuración regional del dispositivo del usuario final. Puede utilizar la propiedad Cultura para anular el comportamiento predeterminado (de modo que, por ejemplo, el símbolo de moneda no cambie en función de la configuración regional del dispositivo en el que se esté visualizando el informe). La referencia cultural se especifica mediante una combinación del código de referencia cultural ISO 639 de dos letras en minúscula asociado a un idioma y el código de subcultura ISO 3166 de dos letras en mayúscula asociado a un país o región. Por ejemplo, si quiere utilizar el símbolo del dólar de los Estados Unidos, debe especificar el valor como en-US. Más información y ejemplos a continuación.

La siguiente captura de pantalla del Explorador de propiedades resalta estas propiedades para la columna Coste estándar y la primera columna CustomField. Observe que encontrará estas propiedades para las columnas estándar (como las columnas Resultado, Rag, Coste y Descripción) en el nodo Mostrar. Mientras que para las columnas CustomField, las propiedades están bajo el propio CustomField.

Explorador de propiedades

Nota: De forma predeterminada, la columna Coste tiene el formato de moneda.

Establecer la propiedad Formato

El formato se especifica mediante una cadena de formato compuesto estándar (solo se puede utilizar el elemento de índice cero). Por ejemplo, puede dar formato a una columna como porcentaje, como este:

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

Esto multiplica el valor numérico almacenado en la columna por 100 y lo convierte en una cadena que representa un porcentaje en la salida. Por ejemplo, el valor 0.05 se representa como 5.00% cuando el informe se ejecuta en el Reino Unido mediante la configuración de referencia cultural predeterminada del Reino Unido.

Puede dar formato a una columna como un valor de moneda, así:

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

Muestra el valor numérico con dos decimales y el símbolo de moneda. De forma predeterminada, el símbolo de moneda se toma de la configuración regional del usuario, por ejemplo, 75,00 £ mediante la configuración regional del Reino Unido. Puede anularlo mediante la propiedad Cultura.

Establecer la propiedad Cultura

La referencia cultural se especifica mediante una combinación del código de referencia cultural ISO 639 de dos letras en minúscula asociado a un idioma y el código de subcultura ISO 3166 de dos letras en mayúscula asociado a un país o región (como en-US para inglés de Estados Unidos).

Por ejemplo, puede establecer la propiedad Culture en japonés de esta manera:

result.CustomField1.Culture = "ja-JP"

Si la columna es una moneda, tendrá el símbolo de moneda Yen.

Puedes establecer la cultura en español, así:

result.CustomField1.Culture = "es-ES"