DocumentaçãoWorkfrontGuia do Workfront

Coleções de referência em um relatório

Last update: Wed Jul 17 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

  • undefined

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 para a funcionalidade neste artigo.

Você deve ter o seguinte acesso para executar as etapas deste artigo:

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
plano do Adobe Workfront* Qualquer
Licença da Adobe Workfront* Plano
Configurações de nível de acesso*

Editar acesso a Filtros, Visualizações, Agrupamentos

Editar acesso a relatórios, painéis, calendários

Observação: se você ainda não tiver acesso, pergunte ao administrador do Workfront se ele definiu restrições adicionais em seu nível de acesso. Para obter informações sobre como um administrador do Workfront pode modificar seu nível de acesso, consulte Criar ou modificar níveis de acesso personalizados.
Permissões de objeto

Gerenciar permissões para um relatório

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

Para obter informações sobre como solicitar acesso adicional, consulte Solicitar acesso aos objetos.

Para descobrir seu plano, tipo de licença ou acesso, entre em contato com o administrador 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: apenas um objeto pode ser vinculado a 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 de cada 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:

Localizar objetos de coleção e seus campos no API Explorer find-collection-objects-and-their-fields-in-the-api-explorer

Nem todas as coleções podem ser relatadas.

Para entender quais objetos podem ser associados a uma coleção de outros, é necessário usar o API Explorer.
Para obter mais informações sobre a tabela do API Explorer, consulte o API Explorer.

Para descobrir quais coleções podem ser relatadas:

  1. Vá para o API Explorer.

  2. Encontre o objeto do seu relatório.

  3. Selecione a guia coleções.

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

  4. Expanda o objeto da 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:

  • Visualizações
  • Filtros
  • Prompts

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

  • Agrupamento
  • Gráfico

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

Referenciar 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

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 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. Passe o mouse sobre a caixa de diálogo e clique em Clique para editar texto.

  9. Selecione todo o texto na caixa de diálogo Modo de Texto e remova-o e cole o seguinte código se estiver fazendo referência a um campo do objeto de 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 Nome da Coluna pelo nome da sua coluna na linha displayname.

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

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

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

    Para obter mais informações sobre expressões personalizadas calculadas, consulte Visão geral das 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 o problema e quando usar o opTask ao fazer referência a problemas, consulte Usar "opTask" e "problema" ao fazer referência a problemas.

    • Para exibir uma lista de tarefas em um relatório de projeto junto com o responsável principal, use uma linha valueexpression para fazer referência aos nomes das tarefas adjacentes aos nomes de seus responsáveis principais, em vez de valuefield.

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

      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. A coluna a seguir é exibida no relatório de projeto, listando todas as tarefas em cada projeto junto com seus atribuídos principais:

  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 Exibição de coleção no Modo de Texto

As linhas em uma exibição de modo de texto para uma coleção são descritas 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 para 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.

Você também pode usar o seguinte:

‍ (junção de largura zero). Os valores da coleção não têm separação entre eles.
, =separador de vírgula. Os valores da coleção são separados por uma vírgula seguida por nenhum espaço.
/ = separador de barras. Os valores da coleção são separados por uma barra.
- = 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 por 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

Essa linha define a coleção que você está referenciando.

Substitua o nome do objeto da coleção pelo nome do objeto que você está referenciando 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.

Para obter mais informações sobre como formatar linhas valueexpression, consulte Visão geral da sintaxe do modo de texto.

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.

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

  1. Clique no 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 o campo que deseja exibir na coleção.

  6. Volte para o seu relatório e, na guia Filtros, clique em Alternar para o 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.

  12. Para filtrar o nome de um problema, use o seguinte código:

    code language-none 
    issues:name=Marketing
issues:name_Mod=cicontains
    note tip
    TIP
    Observe que você deve usar issues como o nome do objeto da coleção, em vez de optask, que é a forma 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
Você não pode fazer referência a coleções em um prompt padrão.

Um prompt personalizado é um filtro personalizado em que as instruções são unidas por símbolos de E comercial. Recomendamos que você crie sua instrução em um filtro, primeiro, e depois junte as linhas das instruções com "E" comercial.

Para obter mais informações sobre como criar uma instrução de filtro com uma referência de coleção, consulte a seção Referenciar uma coleção no Filtro de um relatório neste artigo.

Para adicionar uma referência a uma coleção no prompt personalizado de um relatório:

  1. Clique no menu Principal e em Relatórios.

  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 Referencie uma coleção no Filtro de um relatório deste artigo.

  5. Clique em Configurações do relatório.

  6. Clique em Prompts do 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. 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.

  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. O API Explorer  O não oferece um nome de objeto de coleção para problemas no momento.

  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