Colecciones de referencia en un informe

La creación de un informe en Adobe Workfront permite mostrar un conjunto de objetos, sus campos respectivos u objetos vinculados en una lista, una cuadrícula o un formato de gráfico.

Para obtener más información sobre cómo generar un informe en Workfront, consulte Crear un informe personalizado.

Requisitos de acceso

Expanda para ver los requisitos de acceso para la funcionalidad en este artículo.

Debe tener el siguiente acceso para realizar los pasos de este artículo:

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
plan Adobe Workfront* Cualquiera
Licencia de Adobe Workfront* Plan
Configuraciones de nivel de acceso*

Editar acceso a filtros, vistas y agrupaciones

Editar acceso a informes, tableros y calendarios

Nota: Si sigue sin tener acceso, pregunte al administrador de Workfront si ha establecido restricciones adicionales en su nivel de acceso. Para obtener información sobre cómo un administrador de Workfront puede modificar su nivel de acceso, vea Crear o modificar niveles de acceso personalizados.

Permisos de objeto

Administración de permisos de un informe

Administrar permisos para una vista, filtro o agrupación

Para obtener información sobre cómo solicitar acceso adicional, vea Solicitar acceso a los objetos.

Para saber qué plan, tipo de licencia o acceso tiene, póngase en contacto con su administrador de Workfront.

Explicación de las colecciones

Una colección es una lista de objetos vinculados a otro objeto.

Tiene las dos relaciones siguientes entre objetos en Workfront:

  • Relación uno a uno: Un objeto solo se puede vincular a otro objeto a la vez.
    Por ejemplo, un proyecto solo se puede vincular a un portafolio a la vez.

  • Relación uno a varios: Un objeto se puede vincular a varios objetos a la vez.
    Por ejemplo, un proyecto puede tener varias tareas. En este caso, la lista de tareas forma una colección para el proyecto.

IMPORTANT
Se puede generar un informe que muestre la relación uno a uno entre objetos mediante Report Builder estándar. Sin embargo, solo se puede generar un informe que muestre la relación "uno a varios" entre objetos mediante la interfaz de modo de texto de Report Builder.

Para obtener más información sobre cómo generar un informe en Report Builder estándar, consulte Crear un informe personalizado.

Para obtener más información sobre la creación de un informe con la interfaz de modo de texto, consulte:

Busque objetos de colección y sus campos en el Explorador de API find-collection-objects-and-their-fields-in-the-api-explorer

No se pueden crear informes de todas las colecciones.

Para comprender qué objetos se pueden asociar a una colección de otros, debe utilizar el Explorador de API.
Para obtener más información sobre la tabla del Explorador de API, consulte Explorador de API.

Para averiguar sobre qué colecciones se pueden crear informes:

  1. Vaya a Explorador de API.

  2. Busque el objeto del informe.

  3. Seleccione la ficha colecciones.

    note note
    NOTE
    Sólo los objetos enumerados en esta ficha pueden representarse como una colección en un informe para el objeto seleccionado.
  4. Expanda el objeto de la colección haciendo clic en él.

  5. Haga clic en el vínculo mostrado para ir al objeto de la colección.
    Se abre la ficha campos para el objeto de la colección.

    note note
    NOTE
    En el informe de recopilación solo se puede hacer referencia a los campos enumerados en esta pestaña, o a los campos asociados a los objetos enumerados en esta pestaña.

Colecciones de referencia en informes

Puede hacer referencia a objetos de una colección en los siguientes elementos de informes:

  • Vistas
  • Filtros
  • Solicitudes

No se puede hacer referencia a objetos de una colección en los siguientes elementos de informes:

  • Agrupaciones
  • Gráfico

Por ejemplo, puede hacer referencia a las colecciones de tareas o problemas de un informe de proyecto para mostrar la información de tareas o problemas en el nivel de proyecto.

Hacer referencia a una colección en la vista de un informe reference-a-collection-in-the-view-of-a-report

Puede hacer referencia a una colección de objetos en la vista de un informe para mostrar los atributos de los objetos asociados con el objeto del informe.

Por ejemplo, puede mostrar la información de tareas o problemas en un informe de proyecto mediante la generación de una columna de colección para tareas o problemas en la vista del informe.

Puede mostrar información sobre las tareas o problemas, como nombres, fechas, personas asignadas principales, porcentaje completado, etc., en la vista Colección.

La vista muestra la información de tareas o problemas en formato de lista, y cada línea de la lista representa información sobre una tarea o un problema. La lista de tareas o problemas y sus campos aparecen en la misma línea que el proyecto al que pertenecen las tareas o problemas.
issue_and_tasks_collections_in_reports.png

Agregar una columna de colección en una vista de informe add-a-collection-column-in-a-report-view

Para agregar una columna de colección en una vista de informe:

  1. Haga clic en el menú Principal y luego haga clic en Informes.

  2. Haga clic en Nuevo informe.

  3. Seleccione el objeto del informe.

  4. Salga del informe y, con el Explorador de API, determine qué colecciones están disponibles para el objeto que seleccionó para el informe.

    Para obtener más información acerca de cómo seleccionar el objeto de su colección, vea la sección Buscar objetos de colección y sus campos en el Explorador de API en este artículo.
    Anote el nombre del objeto de la colección.

  5. Con el Explorador de API, vaya a la lista de campos del objeto que desea mostrar en la colección.

    Para obtener más información acerca de cómo buscar los campos del objeto de su colección, vea la sección Buscar objetos de colección y sus campos en el Explorador de API en este artículo.

    Anote cuál es el nombre del campo que desea mostrar en la colección.

  6. Vuelva al informe y, en la ficha Columnas (Ver), haga clic en Agregar columna.

  7. Haga clic en Cambiar al modo de texto.

  8. Pase el cursor sobre el cuadro de diálogo y haga clic Haga clic para editar el texto.

  9. Seleccione todo el texto del cuadro de diálogo Modo de texto, quítelo y pegue el código siguiente si hace referencia a un campo del objeto de colección:

    code language-none
    valueformat=HTML
    textmode=true
    type=iterate
    listdelimiter=<p>
    displayname=Column Name
    listmethod=nested(collection object name).lists
    valuefield=collection object field
    
  10. Reemplace Column Name con el nombre de su columna en la línea displayname.

  11. Reemplace nombre de objeto de colección por el nombre de su objeto de colección en la línea listmethod, tal como aparece en el Explorador de API.

  12. Reemplace campo de objeto de colección por el nombre del campo del objeto de colección en la línea valuefield, tal como aparece en el Explorador de API.

    Puede reemplazar valuefield por valueexpression si desea crear una expresión personalizada en la vista.

    Para obtener más información sobre las expresiones personalizadas calculadas, consulte Información general sobre las expresiones de datos calculados.

    Por ejemplo, si desea mostrar una lista de las tareas en un informe de proyecto. Esta colección usa una línea valuefield para hacer referencia a los nombres de las tareas.

    Realice una de las siguientes acciones:

    • Utilice el siguiente código para generar su columna:

      code language-none
      valueformat=HTML
      textmode=true
      type=iterate
      listdelimiter=<p>
      displayname=Project Tasks Names
      listmethod=nested(tasks).lists
      valuefield=name
      
    • Utilice el siguiente código para mostrar una lista de problemas en el informe:

      code language-none
      displayname=Project Issues Names
      listdelimiter=<p>
      listmethod=nested(issues).lists
      textmode=true
      type=iterate
      valuefield=name
      valueformat=HTML
      

      Observe que en una colección debe usar issues para la línea listmethod, en lugar de opTasks, que es el nombre de base de datos de los problemas. Para obtener información sobre cuándo usar problema y cuándo usar opTask al hacer referencia a problemas, consulte Usar "opTask" y "problema" al hacer referencia a problemas.

    • Si desea mostrar una lista de las tareas en un informe de proyecto junto con su usuario asignado principal, debe utilizar una línea valueexpression para hacer referencia a los nombres de las tareas adyacentes a los nombres de sus usuarios asignados principales en lugar de valuefield.

      Utilice el siguiente código para generar su columna:

      code language-none
      valueformat=HTML
      textmode=true
      type=iterate
      listdelimiter=<p>
      displayname=Tasks Names - Primary Assignee
      listmethod=nested(tasks).lists
      valueexpression=CONCAT({name},' - ',{assignedTo}.{name})
      
  13. La siguiente columna se muestra en el informe del proyecto e incluye todas las tareas de cada proyecto junto con sus principales usuarios asignados:

  14. Haga clic en Guardar.

  15. (Opcional) Continúe editando el informe.

    O

    Haga clic en Guardar + Cerrar para guardar el informe.

Comprender las líneas de una colección Ver en modo texto

Las líneas de una vista de modo de texto de una colección se describen en la siguiente tabla:

Línea de muestra
Descripción
valueformat=HTML
Puede usar varios valores para esta línea, pero se recomienda que valueformat para una lista de colección sea HTML.
textmode=true
Esta línea indica que la columna se ha configurado con el modo de texto. Si elimina esta línea, Workfront la volverá a añadir de forma predeterminada.
type=iterate
El type de una lista siempre es iterate, al generar una vista.
listdelimiter=<p>

Este es el delimitador que se utiliza para separar los valores de la lista.
Recomendamos usar <p>, que agrega un salto de línea entre los valores.

También puede utilizar lo siguiente:

(carpintero de anchura cero). Los valores de la colección no tienen separación entre ellos.
, =separador de comas. Los valores de la colección están separados por una coma seguidos de sin espacio.
/ = separador de barras. Los valores de la colección están separados por una barra diagonal.
- = separador de guiones. Los valores de la colección están separados por un guión.
Si deja vacía esta línea, se agrega una coma seguida de un espacio entre los valores de la colección, de manera predeterminada.

displayname=Nombre de columna
Reemplazar Nombre de columna por el nombre real de la nueva columna.
listmethod=nested(collection object name).list

Esta línea define la colección a la que hace referencia.

Reemplace nombre de objeto de colección por el nombre del objeto al que hace referencia en su colección, tal como aparece en el Explorador de API. Este valor suele ser la forma plural del nombre del objeto de colección.

valuefield=collection object field

Esta línea define a qué campo se hace referencia desde el objeto de colección.

Reemplace campo de objeto de colección por el nombre del campo del objeto al que hace referencia en su colección, tal como aparece en el Explorador de API.

Puede reemplazar esta línea por:

valueexpression=campo/ campos de objeto de colección calculada

Con valueexpression, puede  mostrar una expresión personalizada calculada en la columna.

Para obtener más información sobre cómo dar formato a valueexpression líneas, vea Información general sobre la sintaxis en modo texto.

Limitaciones de una vista de colección limitations-of-a-collection-view

Tenga en cuenta las siguientes limitaciones al crear una vista de colección:

  • No se puede controlar el orden en que se muestran los datos de colección.
  • No se puede aplicar formato condicional a una vista de colección.
  • No se puede hacer que un objeto de una colección sea un vínculo en el que se puede hacer clic.
  • No se puede generar una vista de colección de otra colección.
    Por ejemplo, no puede mostrar todas las personas asignadas a cada tarea en un informe de proyecto. Solo puede mostrar el usuario asignado principal de cada tarea en una vista de proyecto.

Hacer referencia a una colección en el filtro de un informe reference-a-collection-in-the-filter-of-a-report

Puede hacer referencia a una colección de objetos en el filtro de un informe para filtrar los atributos de los objetos asociados con el objeto del informe.

Por ejemplo, puede filtrar la información de tareas o problemas de un informe de proyecto mediante una referencia a los atributos de las tareas o problemas del proyecto en la instrucción de filtro.

Para agregar una referencia a una colección en un filtro de informe:

  1. Haga clic en el menú Principal y luego haga clic en Informes.

  2. Haga clic en Nuevo informe.

  3. Seleccione el objeto del informe.

  4. Salga del informe y, con el Explorador de API, determine qué colecciones están disponibles para el objeto que seleccionó para el informe.

    Para obtener más información acerca de cómo seleccionar el objeto de su colección, vea la sección Buscar objetos de colección y sus campos en el Explorador de API en este artículo.

    Anote el nombre del objeto de la colección.

  5. Con el Explorador de API, vaya a la lista de campos del objeto que desea mostrar en la colección.

    Para obtener más información acerca de cómo buscar los campos del objeto de su colección, vea la sección Buscar objetos de colección y sus campos en el Explorador de API en este artículo.

    Anote el campo que desee mostrar en la colección.

  6. Vuelva al informe y, en la ficha Filtros, haga clic en Cambiar a modo de texto.

  7. En el área Establecer reglas de filtro para su informe, pegue el siguiente código:

    code language-none
    collection object name:collection object field=collection object value
    collection object name:collection object field_Mod=value of the modifier
    
  8. Reemplace nombre de objeto de colección por el nombre del objeto de colección tal como aparece en el Explorador de API. Este valor suele ser la forma plural del nombre del objeto de colección.

  9. Reemplace campo de objeto de colección con el nombre del campo de su objeto de colección en, tal como aparece en el Explorador de API.

  10. Reemplazar valor de objeto de colección por el valor del objeto de colección tal como aparece en Workfront.

  11. Reemplazar valor del modificador por un modificador válido.

    Para obtener una lista de modificadores, consulte Modificadores de filtro y condición.
    Por ejemplo, para generar un informe de proyecto que muestre solo los proyectos con tareas que tienen "Marketing" en su nombre, utilice el siguiente código:

    code language-none
    tasks:name=Marketing
    tasks:name_Mod=cicontains
    

    Este informe solo muestra los proyectos que tienen al menos una tarea con la palabra "marketing" en su nombre.

  12. Para filtrar por el nombre de un problema, utilice el siguiente código:

    code language-none
    issues:name=Marketing
    issues:name_Mod=cicontains
    
    note tip
    TIP
    Observe que debe usar issues para el nombre del objeto de colección, en lugar de optask, que es el modo en que aparecen los problemas en el Explorador de API.
  13. Haga clic en Listo.

  14. (Opcional) Continúe editando el informe.

    O

    Haga clic en Guardar + Cerrar para guardar el informe.

Hacer referencia a una colección en la solicitud personalizada de un informe reference-a-collection-in-the-custom-prompt-of-a-report

Puede hacer referencia a una colección de objetos en la petición de datos personalizada de un informe para filtrar los resultados del informe por los atributos de los objetos asociados con el objeto del informe.

Por ejemplo, puede solicitar información sobre tareas en un informe de proyecto mediante una referencia a los atributos de las tareas del proyecto en la petición personalizada del informe.

NOTE
No se puede hacer referencia a las colecciones en una petición de datos estándar.

Una petición de datos personalizada es un filtro personalizado en el que las sentencias se unen mediante símbolos ampersand. Le recomendamos que genere su enunciado en un filtro, primero, y luego que una las líneas de las instrucciones con el símbolo et.

Para obtener más información acerca de cómo generar una instrucción de filtro con una referencia de colección, vea la sección Hacer referencia a una colección en el filtro de un informe en este artículo.

Para agregar una referencia a una colección en la petición de datos personalizada de un informe:

  1. Haga clic en el menú Principal y luego haga clic en Informes.

  2. Haga clic en Nuevo informe.

  3. Seleccione el objeto del informe.

  4. Genere un filtro con una referencia de colección como se describe en la sección Hacer referencia a una colección en el filtro de un informe en este artículo.

  5. Haga clic en Configuración del informe.

  6. Haga clic en Indicadores de informe.

  7. Haga clic en Agregar solicitud.

  8. Haga clic en Mensaje personalizado.

  9. Especifique el nombre de la solicitud en el campo Fieldname.

  10. Especifique una etiqueta de elemento desplegable.

  11. Especifique lo siguiente en el campo Condición:

    code language-none
    collection object name:collection object field_Mod=value of the modifier
    
  12. (Opcional) Especifique si esta opción se muestra de forma predeterminada en la solicitud.

  13. Reemplace nombre de objeto de colección por el nombre del objeto de colección tal como aparece en el Explorador de API. Este valor suele ser la forma plural del nombre del objeto de colección.

  14. Reemplace campo de objeto de colección por el nombre del campo del objeto de colección, tal como aparece en el Explorador de API.

  15. Reemplazar valor de objeto de colección por el valor del objeto de colección tal como aparece en Workfront.

    Por ejemplo, si está filtrando proyectos en los que el nombre de la tarea contiene "Marketing", reemplace valor de objeto de colección por marketing.

  16. Reemplazar valor del modificador por un modificador válido.

    Para ver una lista de modificadores, consulte  Modificadores de filtro y condición.

    Ejemplo: Por ejemplo, para generar un informe de proyecto con una solicitud personalizada en el que desee mostrar solamente los proyectos que tengan al menos una tarea asignada a un usuario específico, use el código siguiente:

    code language-none
    tasks:assignedToID=57cf1b7a000077c9f02f66cb09c8f86c&tasks:assignedToID_Mod=in
    

    Esto genera un informe en el que todos los proyectos enumerados tienen al menos una tarea asignada al usuario cuyo GUID es 57cf1b7a000077c9f02f66cb09c8f86c.

    note note
    NOTE
    No puede hacer referencia al nombre del usuario asignado principal (campo "Asignado a") de una tarea, según el Explorador de API. Solo puede hacer referencia al ID del usuario asignado principal.

    Por ejemplo, para filtrar por cualquier proyecto en el que cualquiera de los problemas del proyecto esté asignado a un usuario específico, utilice el siguiente código para la solicitud personalizada:

    code language-none
    issues:assignedToID=57cf1b7a000077c9f02f66cb09c8f86c&issues:assignedToID_Mod=in
    

    Esto genera un informe en el que todos los proyectos enumerados tienen al menos un problema asignado al usuario cuyo GUID es 57cf1b7a000077c9f02f66cb09c8f86c.

    note note
    NOTE
    Observe que debe usar issues para el nombre del objeto de colección. El Explorador de API  no ofrece un nombre de objeto de colección para los problemas en este momento.
  17. Haga clic en Listo.

  18. (Opcional) Continúe editando el informe.

    O

    Haga clic en Guardar + Cerrar para guardar el informe.

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43