DocumentaçãoWorkfrontGuia do Workfront

Fazer referência a coleções em um relatório

Last update: Sun Mar 15 2026 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

  • Usuário

Criar um relatório no Adobe Workfront permite exibir um conjunto de objetos, seus respectivos campos ou objetos vinculados em um formato de lista, grade ou gráfico.

Para obter mais informações sobre como criar um relatório no Workfront, consulte Criar um relatório personalizado.

Requisitos de acesso

Expanda para visualizar os requisitos de acesso da funcionalidade neste artigo.
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Pacote do Adobe Workfront Qualquer
Licença do Adobe Workfront

Padrão

Plano
Configurações de nível de acesso

Editar acesso a Filtros, Visualizações, Agrupamentos

Editar acesso a relatórios, painéis, calendários
Permissões de objeto

Gerenciar permissões para um relatório

Gerenciar permissões para uma exibição, filtro ou agrupamento

Para obter mais detalhes sobre as informações contidas nesta tabela, consulte Requisitos de acesso na documentação do Workfront.

Entender coleções

Uma coleção é uma lista de objetos vinculados a outro objeto.

Você tem os dois relacionamentos a seguir entre objetos no Workfront:

  • Uma relação um-para-um: um objeto pode ser vinculado a apenas um outro objeto por vez.
    Por exemplo, um projeto só pode ser vinculado a um portfólio por vez.

  • Uma relação um-para-muitos: um objeto pode ser vinculado a vários outros objetos por vez.
    Por exemplo, um projeto pode ter várias tarefas. Nesse caso, a lista de tarefas forma uma coleção para o projeto.

IMPORTANT
Você pode criar um relatório que mostre a relação um para um entre os objetos usando o Report Builder padrão. No entanto, você só pode criar um relatório que mostre a relação um para muitos entre objetos usando a interface do modo de texto no Report Builder.

Para obter mais informações sobre como criar um relatório no construtor de relatórios padrão, consulte Criar um relatório personalizado.

Para obter mais informações sobre como criar um relatório usando a interface do modo de texto, consulte:

Find collection objects and their fields in the API Explorer find-collection-objects-and-their-fields-in-the-api-explorer

Not all collections can be reported on.

To understand what objects can be associated with a collection of other, you must use the API Explorer.
For more information about the API Explorer table, see the API Explorer.

To find out what collections can be reported on:

  1. Vá para o API Explorer.

  2. Localize o objeto de seu relatório.

  3. Selecione a guia coleções.

    note note
    NOTE
    Somente os objetos listados nessa guia podem ser representados como uma coleção em um relatório do objeto selecionado.

  4. Expanda o objeto da sua coleção clicando nele.

  5. Clique no link exibido para ir para o objeto da sua coleção.
    Isso abre a guia campos para o objeto da sua coleção.

    note note
    NOTE
    Somente os campos listados nesta guia podem ser referenciados no relatório de coleta ou nos campos associados aos objetos listados nesta guia.

Coleções de referência em relatórios

Você pode fazer referência a objetos de uma coleção nos seguintes elementos de relatório:

  • Exibições
  • Filtros
  • Prompts

You cannot reference objects from a collection in the following reporting elements:

  • Agrupamento
  • Gráfico

Por exemplo, você pode fazer referência à tarefa ou às coleções de ocorrências de um relatório de projeto para mostrar informações sobre a tarefa ou a ocorrência no nível do projeto.

Fazer referência a uma coleção na Exibição de um relatório reference-a-collection-in-the-view-of-a-report

Você pode fazer referência a uma coleção de objetos na exibição de um relatório para mostrar atributos de objetos associados ao objeto do relatório.

Por exemplo, você pode mostrar informações de tarefas ou problemas em um relatório de projeto, criando uma coluna de coleção para tarefas ou problemas na exibição do relatório.

Você pode exibir informações sobre as tarefas ou problemas, como nomes, datas, principais atribuídos, percentual concluído etc. na exibição de coleção.

A exibição mostra informações de tarefas ou problemas em um formato de lista, com cada linha da lista representando informações sobre uma tarefa ou um problema. A lista de tarefas ou problemas e seus campos aparecem na mesma linha do projeto ao qual as tarefas ou problemas pertencem.

issue_and_tasks_collections_in_reports.png {width="400"}

Adicionar uma coluna de coleção em uma Exibição de relatório add-a-collection-column-in-a-report-view

Para adicionar uma coluna de coleção em uma exibição de relatório:

  1. Clique no Menu principal Ícone do Menu principal e em Relatórios.

  2. Clique em Novo Relatório.

  3. Selecione o objeto do relatório.

  4. Saia do seu relatório e, usando o API Explorer, determine quais coleções estão disponíveis para o objeto selecionado para o seu relatório.

    Para obter mais informações sobre como selecionar o objeto de sua coleção, consulte a seção Localizar objetos de coleção e seus campos no API Explorer neste artigo.

    Anote qual é o nome do objeto da coleção.

  5. Usando o API Explorer, vá para a lista de campos do objeto que deseja exibir na coleção.

    Para obter mais informações sobre como localizar os campos do objeto de sua coleção, consulte a seção Localizar objetos de coleção e seus campos no API Explorer neste artigo.

    Anote qual é o nome do campo que deseja exibir na coleção.

  6. Volte para o relatório e, na guia Colunas (Exibição), clique em Adicionar Coluna.

  7. Clique em Alternar para Modo de Texto.

  8. Clique em Editar Modo de Texto.

  9. Selecione todo o texto na caixa de diálogo Modo de Texto e remova-o. Em seguida, cole o seguinte código se estiver fazendo referência a um campo do objeto da coleção:

    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. Substitua o Nome da Coluna pelo nome da sua coluna na linha displayname.

  11. Substitua o nome do objeto da coleção pelo nome do objeto da coleção na linha listmethod, como aparece no API Explorer.

  12. Substitua o campo do objeto de coleção pelo nome do campo do objeto de coleção na linha valuefield, como aparece no API Explorer.

    Você pode substituir valuefield por valueexpression, se desejar criar uma expressão personalizada em sua exibição.

    Para obter mais informações sobre expressões personalizadas calculadas, consulte Visão geral de expressões de dados calculadas.

    Por exemplo, se você deseja exibir uma lista de tarefas em um relatório de projeto. Esta coleção usa uma linha valuefield para fazer referência aos nomes das tarefas.

    Siga um destes procedimentos:

    • Use o código a seguir para criar a coluna:

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

    • Use o código a seguir para exibir uma lista de problemas no relatório:

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

      Observe que em uma coleção você deve usar problemas para a linha listmethod, em vez de opTasks, que é o nome do banco de dados para Problemas. Para obter informações sobre quando usar issue e quando usar opTask ao se referir a problemas, consulte Usar “opTask” e “issue” ao fazer referência a problemas.

    • If you want to display a list of the tasks in a project report along with their primary assignee, you would use a valueexpression line for referencing the names of the tasks adjacent to the names of their primary assignees instead of valuefield.

      Use the following code to build your column:

      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. The following column displays in the project report, listing all tasks in each project alongside their primary assignees:

    Project report with task and assignee collection {width="400"}

  14. Clique em Salvar.

  15. (Opcional) Continue editando o relatório.

    Ou

    Clique em Salvar + Fechar para salvar o relatório.

Entender as linhas de uma coleção Ver no Modo de Texto

As linhas em uma exibição do modo de texto para uma coleção estão contornadas na tabela a seguir:

Linha de Exemplo
Descrição
valueformat=HTML
Você pode usar vários valores para esta linha, mas recomendamos que o valueformat de uma lista de coleção seja HTML.
textmode=true
Esta linha indica que a coluna foi configurada usando o modo de texto. Se você remover essa linha, o Workfront a adicionará de volta por padrão.
type=iterate
O type de uma lista é sempre iterate, ao criar um modo de exibição.
listdelimiter=<p>

Esse é o delimitador usado para separar os valores na lista.
Recomendamos usar <p>, que adiciona uma quebra de linha entre os valores.

You can also use the following:

‍ (zero-width joiner). The values of the collection have no separation between them.
, =comma separator. The values of the collection are separated by a comma followed by no space.
/ = slash separator. The values of the collection are separated by a slash.
- = separador de traço. Os valores da coleção são separados por um traço.
Deixar esta linha vazia adiciona uma vírgula seguida de um espaço entre os valores da coleção, por padrão.

displayname=Nome da Coluna
Substitua Nome da coluna pelo nome real da nova coluna.
listmethod=nested(collection object name).list

Esta linha define a coleção à qual você está fazendo referência.

Substitua o nome do objeto da coleção pelo nome do objeto ao qual você está fazendo referência na sua coleção, como aparece no API Explorer. Normalmente, esse valor é a forma plural do nome do objeto da coleção.

valuefield=collection object field

Essa linha define qual campo você está referenciando a partir do objeto de coleção.

Substitua o campo de objeto da coleção pelo nome do campo do objeto que você está referenciando na sua coleção, como aparece no API Explorer.

É possível substituir essa linha por:

valueexpression=campo/campos de objeto de coleção calculada

Usando a expressão de valor, você pode  exiba uma expressão personalizada calculada na coluna.

For more information about how to format valueexpression lines, see Text mode syntax overview.

Limitações de uma Exibição de coleção limitations-of-a-collection-view

Considere as seguintes limitações ao criar uma exibição de coleção:

  • Não é possível controlar a ordem na qual os dados da coleção são exibidos.
  • Não é possível aplicar formatação condicional a uma exibição de coleção.
  • Não é possível transformar um objeto em uma coleção em um link clicável.
  • Não é possível criar uma visualização de coleção de outra coleção.
    Por exemplo, não é possível exibir todos os atribuídos em cada tarefa em um relatório de projeto. Você só pode exibir o responsável principal em cada tarefa em uma visualização de projeto.

Referência a uma coleção no Filtro de um relatório reference-a-collection-in-the-filter-of-a-report

Você pode fazer referência a uma coleção de objetos no filtro de um relatório para filtrar os atributos de objetos associados ao objeto do relatório.

Por exemplo, você pode filtrar por informações de tarefas ou problemas em um relatório de projeto usando uma referência aos atributos de tarefas ou problemas no projeto na instrução de filtro.

NOTE
Quando aplicado a campos que contêm vários valores (como uma coleção de notas em um projeto), o filtro determina a inclusão da seguinte maneira:
  • Se todos os itens em uma coleção contiverem o valor especificado, todo o registro será excluído dos resultados.
  • Se pelo menos um item na coleção não contiver o valor especificado, o registro permanecerá nos resultados.

Para adicionar uma referência a uma coleção em um filtro de relatório:

  1. Clique no Menu principal Ícone do Menu principal e em Relatórios.

  2. Clique em Novo Relatório.

  3. Selecione o objeto do relatório.

  4. Afaste-se do relatório e, usando o API Explorer, determine quais coleções estão disponíveis para o objeto selecionado para o relatório.

    Para obter mais informações sobre como selecionar o objeto da sua coleção, consulte a seção Localizar objetos da coleção e seus campos no API Explorer neste artigo.

    Anote qual é o nome do objeto da coleção.

  5. Usando o API Explorer, vá para a lista de campos do objeto que deseja exibir na coleção.

    Para obter mais informações sobre como localizar os campos do objeto de sua coleção, consulte a seção Localizar objetos de coleção e seus campos no API Explorer neste artigo.

    Anote o campo que deseja exibir na coleção.

  6. Volte para o seu relatório e, na guia Filtros, clique em Alternar para Modo de Texto e depois em Editar Modo de Texto.

  7. Na área Definir regras de filtro para seu Relatório, cole o seguinte 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. Substitua o nome do objeto de coleção pelo nome do objeto de coleção como ele aparece no API Explorer. Normalmente, esse valor é a forma plural do nome do objeto da coleção.

  9. Substitua o campo do objeto de coleção pelo nome do campo do seu objeto de coleção em, como ele aparece no API Explorer.

  10. Substitua o valor do objeto de coleção pelo valor do objeto de coleção como ele aparece no Workfront.

  11. Substitua o valor do modificador por um modificador válido.

    Para obter uma lista de modificadores, consulte Modificadores de filtro e condição.
    Por exemplo, para criar um relatório de projeto que exiba somente projetos com tarefas que tenham "Marketing" em seu nome, use o seguinte código:

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

    Esse relatório só exibe projetos que tenham pelo menos uma tarefa com a palavra "marketing" no nome.

    Tarefas somente de marketing no projeto {width="400"}

  12. Para filtrar o nome de uma ocorrência, use o seguinte código:

    code language-none 
    issues:name=Marketing
issues:name_Mod=cicontains
    note tip
    TIP
    Observe que você deve usar issues para o nome do objeto da coleção, em vez de optask, que é como os problemas aparecem no API Explorer.

  13. Clique em Concluído.

  14. (Opcional) Continue editando o relatório.

    Ou

    Clique em Salvar + Fechar para salvar o relatório.

Referenciar uma coleção no prompt personalizado de um relatório reference-a-collection-in-the-custom-prompt-of-a-report

Você pode fazer referência a uma coleção de objetos no prompt personalizado de um relatório para filtrar os resultados do relatório para os atributos de objetos associados ao objeto do relatório.

Por exemplo, você pode solicitar informações sobre tarefas em um relatório de projeto usando uma referência aos atributos de tarefas no projeto no prompt personalizado do relatório.

NOTE
Não é possível fazer referência a coleções em um prompt padrão.

A custom prompt is a custom filter where the statements are joined by ampersand symbols. We recommend that you build your statement in a filter, first, then join the lines of the statements with ampersands.

For more information about building a filter statement with a collection reference, see the section Reference a collection in the Filter of a report in this article.

To add a reference to a collection in the custom prompt of a report:

  1. Click the Main menu Main Menu icon , then click Reports.

  2. Clique em Novo Relatório.

  3. Selecione o objeto do relatório.

  4. Crie um filtro com uma referência de coleção conforme descrito na seção Faça referência a uma coleção no Filtro de um relatório neste artigo.

  5. Clique em Configurações de Relatório.

  6. Clique em Prompts de Relatório.

  7. Clique em Adicionar prompt.

  8. Clique em Personalizar prompt.

  9. Especifique o nome do prompt no campo Camponome*.

  10. Especifique um Rótulo de Item Suspenso.

  11. Especifique o seguinte no campo Condição:

    code language-none 
    collection object name:collection object field_Mod=value of the modifier

  12. (Opcional) Especifique se essa opção é exibida por padrão no prompt.

  13. Replace collection object name with the name of your collection object as it appears in the API Explorer. Normalmente, esse valor é a forma plural do nome do objeto da coleção.

  14. Substitua o campo do objeto de coleção pelo nome do campo do seu objeto de coleção, como ele aparece no API Explorer.

  15. Substitua o valor do objeto de coleção pelo valor do objeto de coleção como ele aparece no Workfront.

    Por exemplo, se estiver filtrando projetos nos quais o nome da tarefa contém "Marketing", substitua o valor do objeto de coleção por marketing.

  16. Substitua o valor do modificador por um modificador válido.

    Para obter uma lista de modificadores, consulte Modificadores de filtro e condição.

    Exemplo: Por exemplo, para criar um relatório de projeto com um prompt personalizado no qual você deseja exibir somente projetos que tenham pelo menos uma tarefa atribuída a um usuário específico, use o código abaixo:

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

    Isso gera um relatório em que todos os projetos listados têm pelo menos uma tarefa atribuída ao usuário cuja GUID é 57cf1b7a000077c9f02f66cb09c8f86c.

    note note
    NOTE
    Você não pode referenciar o nome do destinatário primário (campo "Atribuído a") de uma tarefa, de acordo com a API Explorer. Você só pode fazer referência à ID do responsável principal.

    Por exemplo, para filtrar qualquer projeto em que qualquer um dos problemas do projeto seja atribuído a um usuário específico, use o seguinte código para o seu prompt personalizado:

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

    Isso gera um relatório em que todos os projetos listados têm pelo menos um problema atribuído ao usuário cuja GUID é 57cf1b7a000077c9f02f66cb09c8f86c.

    note note
    NOTE
    Observe que você deve usar problemas para o nome do objeto da coleção. No momento, a API Explorer não oferece um nome de objeto de coleção para problemas.

  17. Clique em Concluído.

  18. (Opcional) Continue editando o relatório.

    Ou

    Clique em Salvar + Fechar para salvar o relatório.

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