Listar topics

Lista los topics seleccionados y su estado en una lista ordenada.

Hay una lista de elementos que se pueden configurar en el dashlet:

Altura en filas del canvas¶

Define la altura en número de filas asignadas al dashlet.

El valor de altura estará entre 1 y 4 donde 4 ocupará el 100% de la página.

Ancho en columnas del canvas¶

Establece el ancho que ocupará el elemento en el dashboard.

El valor máximo permitido es 12 (100% de ancho).

Autoactualización¶

Permite hacer el dashlet más dinámico agregando una actualización automática (en minutos).

Lista de campos a ver en la tabla¶

Permite seleccionar campos específicos para ver. Por defecto, el dashlet mostrará las siguientes columnas: ID, título, estado, creador y fecha de creación.

Las columnas se pueden personalizar separando las definiciones de campo con ; (punto y coma).

Cada definición de campo es una lista de tokens separados por comas:

nombre_campo,etiqueta,tipo,ancho,[opciones...]

Los primeros cuatro tokens son posicionales:

Token	Posición	Descripción	Obligatorio
`nombre_campo`	1	El ID interno del campo (ID del fieldlet o nombre de campo integrado como `title`, `name_status`, `created_by`, `created_on`, `modified_by`, `modified_on`, `assignee`, `projects`)	Sí
`etiqueta`	2	Etiqueta del encabezado de columna mostrada en el dashlet	No
`tipo`	3	Tipo de campo: `text`, `number`, `number(N)` (N = decimales), `checkbox`, `ci`	No (por defecto `text`)
`ancho`	4	Ancho de la columna en píxeles. Cuando se establece, el texto del encabezado se ajusta para caber	No (tamaño automático)

A partir de la posición 4, los tokens restantes se auto-detectan por su valor y pueden ir en cualquier orden:

Token	Valores	Descripción
`total`	`sum`, `min`, `max`, `count`, `avg`	Agregación para la fila de totales
`formato_numero`	`currency`	Usar formato decimal según la configuración regional
`simbolo`	Cualquier otro valor (ej. `$`, `€`, `%`)	Símbolo de unidad añadido después del valor
`alineacion`	`left`, `center`, `right`	Alineación del texto (por defecto `center`, `left` para título)

Ejemplo con alineación y totales:

mi_campo,Mi Etiqueta,number,,sum,right

Ejemplos¶

Un diseño simple de tres columnas:

title,Título;created_by,Creado Por;name_status,Estado

Una columna numérica con totales, formato de moneda y alineación:

title,Título;created_by,Creado Por;incoming,Mis Ingresos,number(2),,sum,currency,$,right

Esto produce:

    Título | Creado Por  | Mis Ingresos
    --------------------------------------
    Title1 | 2016-02-02  |      23,25 $
    --------------------------------------
                          |    Total: $

Tipos¶

Text¶

Tipo por defecto. Muestra el valor del campo como texto.

Number¶

Muestra un valor numérico. Se puede añadir la precisión decimal entre paréntesis: number(2) muestra 2 decimales.

Con el token total (posición 5), una fila de totales puede mostrar:

sum - Suma de todos los valores de la columna.
max - Valor máximo.
min - Valor mínimo.
count - Número de filas.
avg - Promedio de todos los valores.

El token formato_numero (posición 6) se puede establecer a currency para formatear números usando las preferencias regionales del usuario (formato US con . para decimales o formato estándar con ,).

El token simbolo (posición 7) añade un símbolo de unidad después del valor (ej. $, €, %).

Ejemplo: title,Title;created_by,Created By;incoming,My incoming,number(2),,sum,currency,$

    Title  | Created by  | My incoming
    ------------------------------------
    Title1 | 2016-02-02  | 23,25 $

Checkbox¶

Muestra un icono gráfico de marcado/desmarcado en lugar de 1 o 0 para fieldlets booleanos.

Ejemplo: title,Title;created_by,Created By;mi_check,Aprobado,checkbox

CI¶

Resuelve los MIDs de recursos a sus nombres de visualización. Útil para campos de usuario como owner o assignee que almacenan IDs internos.

Ejemplo: title,Title;created_by,Created By;owner,Owner,ci

Sin tipo ci:

    Title  | Created by  | Owner
    --------------------------------
    Title1 | 2016-02-02  | 1108

Con tipo ci:

    Title  | Created by  |  Owner
    --------------------------------
    Title1 | 2016-02-02  | admin-1

Número máximo de topics a listar¶

Establece el número máximo de topics a mostrar en la tabla. Por defecto está establecido en 100.

Si deseas mostrar todos los topics, simplemente establécelo en 0.

Ordenar por¶

Establece un orden por un campo determinado (especificado por el ID del fieldlet). Por defecto ordena por ID del topic.

Orden de clasificación¶

Indica orden ASC o DESC.

¿Mostrar fila de totales?¶

Incluye una última fila mostrando el total si tenemos un tipo number en la tabla.

Seleccionar topics en categorías¶

Selecciona una o más categorías para mostrar en la tabla.

Seleccionar topics en estados¶

Selecciona uno o más estados para configurar la tabla.

¿Excluir estados seleccionados?¶

Excluye las clases seleccionadas en el combo anterior y muestra el resto que no están seleccionadas.

Usuario asignado a topics¶

Permite filtrar los topics por usuario asignado o por cualquier usuario.

Condición avanzada JSON/MongoDB¶

Permite usar un formato JSON o una consulta MongoDB para agregar una condición.

  {"labels":[],"categories":["*id*"],"statuses":[],"priorities":[],"start":0,"limit":25}

Donde id es la clave única de la categoría que se puede consultar a través del REPL.