DocumentaciónWorkfrontGuía de Workfront

Colecciones de referencia en un informe

Last update: Mon Jun 17 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Temas:

Creado para:

  • Usuario

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 la creación de informes en Workfront, consulte Creación de 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, consulte 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, consulte Solicitud de acceso a 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:

  • Una 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.

  • Una 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 la creación de informes en Report Builder estándar, consulte Creación de 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 la Explorador de API.

Para averiguar sobre qué colecciones se pueden crear informes:

  1. Vaya a la Explorador de API.

  2. Busque el objeto del informe.

  3. Seleccione el colecciones pestaña.

    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.
    Esto abre el 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 Principal menú , luego haga clic en Informes.

  2. Clic Nuevo informe.

  3. Seleccione el objeto del informe.

  4. Salga del informe y use el botón Explorador de API, determine qué colecciones están disponibles para el objeto seleccionado para el informe.

    Para obtener más información sobre la selección del objeto de la colección, consulte la sección Busque 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. Uso del Explorador de API, vaya a la lista de campos del objeto que desea mostrar en la colección.

    Para obtener más información sobre cómo buscar los campos del objeto de la colección, vea la sección Busque 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 el Columnas (vista) pestaña, haga clic en Agregar columna.

  7. Clic Cambiar a modo de texto.

  8. Pase el ratón sobre el cuadro de diálogo y haga clic en Haga clic para editar el texto.

  9. Seleccionar todo el texto de la Modo de texto y, a continuación, pegue el código siguiente si hace referencia a un campo del objeto de recopilació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. Reemplazar Nombre de columna con el nombre de su columna en la displayname línea.

  11. Reemplazar nombre de objeto de colección con el nombre del objeto de colección en el listmethod línea, tal como aparece en la Explorador de API.

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

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

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

    Por ejemplo, si desea mostrar una lista de las tareas en un informe de proyecto. Esta colección utiliza un valuefield línea 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 utilizar problemas para el listmethod línea, en lugar de opTasks que es el nombre de la base de datos de los problemas. Para obtener información sobre cuándo usar problema y cuándo usar opTask cuando consulte problemas, consulte Utilice "opTask" y "issue" al hacer referencia a problemas.

    • Si desea mostrar una lista de las tareas de un informe de proyecto junto con su principal asignado, debe utilizar un valueexpression línea para hacer referencia a los nombres de las tareas adyacentes a los nombres de sus principales usuarios asignados 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

    Clic 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 utilizar varios valores para esta línea, pero le recomendamos que utilice la variable valueformat para una lista de colección debe ser 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 es siempre iterate, al crear una vista.
listdelimiter=<p>

Este es el delimitador que se utiliza para separar los valores de la lista.
Se recomienda utilizar <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 se deja vacía esta línea, se agrega una coma seguida de un espacio entre los valores de la colección de forma predeterminada.

displayname=Nombre de columna
Reemplazar Nombre de columna con 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.

Reemplazar nombre de objeto de colección con el nombre del objeto al que hace referencia en la 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.

Reemplazar  campo de objeto de colección  con el nombre del campo del objeto al que se hace referencia en la colección, tal como aparece en el Explorador de API.

Puede reemplazar esta línea por:

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

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

Para obtener más información sobre el formato valueexpression líneas, consulte Resumen de sintaxis de modo de 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 Principal menú , luego haga clic en Informes.

  2. Clic Nuevo informe.

  3. Seleccione el objeto del informe.

  4. Salga del informe y use el botón Explorador de API, determine qué colecciones están disponibles para el objeto seleccionado para el informe.

    Para obtener más información sobre la selección del objeto de la colección, consulte la sección Busque 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. Uso del Explorador de API, vaya a la lista de campos del objeto que desea mostrar en la colección.

    Para obtener más información sobre cómo buscar los campos del objeto de la colección, vea la sección Busque 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 el Filtros pestaña, haga clic en Cambiar a modo de texto.

  7. En el Definición de reglas de filtro para el 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. Reemplazar nombre de objeto de colección con el nombre del objeto de colección tal como aparece en la Explorador de API. Este valor suele ser la forma plural del nombre del objeto de colección.

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

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

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

    Para ver 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
    Tenga en cuenta que debe utilizar issues para el nombre del objeto de colección, en lugar de optask así es como aparecen los problemas en el Explorador de API.

  13. Clic Listo.

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

    O

    Clic 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 sobre 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 Principal menú , luego haga clic en  Informes.

  2. Clic  Nuevo informe.

  3. Seleccione el objeto del informe.

  4. Cree 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. Clic Configuración de informes.

  6. Clic Indicadores de informe.

  7. Clic Agregar indicador.

  8. Clic Mensaje personalizado.

  9. Especifique el nombre de la solicitud en la  Field ​ name field.

  10. Especifique un Etiqueta de elemento desplegable.

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

    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. Reemplazar  nombre de objeto de colección  con el nombre del objeto de colección tal como aparece en la Explorador de API. Este valor suele ser la forma plural del nombre del objeto de colección.

  14. Reemplazar  campo de objeto de colección  con el nombre del campo del objeto de colección, tal como aparece en la Explorador de API.

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

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

  16. Reemplazar  valor del modificador  con 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 la que desee mostrar solo los proyectos que tengan al menos una tarea asignada a un usuario específico, utilice el siguiente código:

    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
    Tenga en cuenta que debe utilizar problemas 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. Clic  Listo.

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

    O

    Clic  Guardar + Cerrar para guardar el informe.

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