Editar um agrupamento usando o modo texto

Você pode editar um agrupamento em uma lista ou relatório usando o modo de texto para acessar campos que não estão disponíveis na interface padrão e criar agrupamentos mais complexos.

TIP
Recomendamos que você crie o máximo possível do agrupamento no modo padrão e, em seguida, converta-o no modo de texto para editá-lo.

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, exibições e agrupamentos

Acesso de edição a relatórios, painéis e calendários para editar agrupamentos em um relatório

Permissões de objeto

Gerenciar permissões para um relatório editar agrupamentos em um relatório

Gerenciar permissões para um agrupamento para editá-lo

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

Pré-requisitos

Antes de começar a usar o modo de texto em um relatório ou lista, sempre verifique se você está familiarizado com a sintaxe do modo de texto do Workfront.

Para obter mais informações, consulte:

Editar um agrupamento usando o modo texto

A edição de um agrupamento usando o modo de texto é idêntica para relatórios e listas. O acesso ao agrupamento a partir de um relatório ou de uma lista é diferente.

NOTE
Os agrupamentos são um elemento de relatório obrigatório para a criação de gráficos em relatórios. Os agrupamentos do modo de texto não são suportados em gráficos. Para obter informações sobre como adicionar gráficos a relatórios, consulte Adicionar um gráfico a um relatório.

Para obter mais informações sobre como criar agrupamentos, consulte Criar agrupamentos no Adobe Workfront.

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

  1. Siga um destes procedimentos:

    1. Para acessar o agrupamento de um relatório, vá para o relatório e clique em Ações de Relatório > Editar > guia Agrupamentos.

    2. Para acessar o agrupamento de uma lista, vá para a lista e, no menu suspenso Agrupamento, passe o mouse sobre o agrupamento que você deseja modificar e clique no ícone Editar Ícone Editar .

      O construtor de agrupamento é aberto.

  2. Clique em Adicionar agrupamento para adicionar os agrupamentos, clique em Alternar para modo de texto no canto superior direito do construtor e em Editar modo de texto.

    note tip
    TIP
    Você pode adicionar até 3 agrupamentos na interface padrão. Você pode adicionar um quarto agrupamento usando apenas o modo de texto e não pode ter mais de quatro níveis de agrupamento no Workfront.
  3. Comece a digitar o nome de um campo pelo qual deseja agrupar.

    Selecione o nome do campo quando ele aparecer na lista.

  4. Clique em Alternar para o modo de texto no canto superior direito do construtor.

    O agrupamento é exibido no modo de texto.

    Quando você edita um agrupamento no modo de texto, o Workfront adiciona o

    code language-none
    textmode=true
    

    linha de código para o agrupamento. Indica que o agrupamento é modificado no modo de texto.

    Exemplo: para agrupar uma lista de tarefas pelo Nome do Projeto e, em seguida, pelo nome do Destinatário Principal, o agrupamento deve ter a seguinte aparência no modo de texto.

    code language-none
    textmode=true<br>group.0.linkedname=project<br>group.0.namekey=view.relatedcolumn<br><strong>group.0.valuefield=project:name</strong><br>group.0.namekeyargkey.0=project<br>group.0.namekeyargkey.1=name<br><strong>group.0.valueformat=string</strong><br>group.1.linkedname=assignedTo<br>group.1.namekey=view.relatedcolumn<br><strong>group.1.valuefield=assignedTo:name</strong><br>group.1.namekeyargkey.0=assignedTo<br>group.1.namekeyargkey.1=name<br><strong>group.1.valueformat=string</strong>
    
    note important
    IMPORTANT
    As linhas em negrito são obrigatórias.

    Cada campo no agrupamento tem várias linhas de código que se referem a esse campo.

    A tabela abaixo contorna as linhas-chave em um agrupamento de modo de texto.

    note tip
    TIP
    As linhas-chave em um agrupamento em modo de texto são semelhantes às linhas necessárias para construir visualizações em modo de texto.
    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 layout-auto
    Linha de Exemplo Descrição
    grupo.<número>.

    Cada linha de código é precedida por este texto. As linhas de código que se referem ao mesmo campo selecionado no agrupamento são numeradas com o mesmo número, da seguinte maneira:

    • O primeiro agrupamento do relatório tem um número de grupo de 0. Todas as linhas que se referem ao primeiro agrupamento começam com group.0.
    • O segundo agrupamento do relatório tem um número de grupo de 1. Todas as linhas que se referem ao segundo agrupamento começam com group.1.
    • O terceiro agrupamento do relatório tem um número de grupo de 2. Todas as linhas que se referem ao terceiro agrupamento começam com group.2.
    • Somente no modo de texto, é possível adicionar um número de grupo de 3 para um quarto agrupamento. Todas as linhas que se referem ao quarto agrupamento começam com group.3.

    Observação: 4 agrupamentos não são suportados no construtor. Eles só são compatíveis ao usar o modo de texto. O Workfront não oferece suporte a mais de 4 níveis de agrupamentos.

    valorcampo=

    Este é o nome do objeto ou do campo como aparece no banco de dados. Para obter mais informações sobre como objetos e campos aparecem no banco de dados, consulte API Explorer.

    Existem os seguintes cenários:

    1. Se o nome do campo exibido for uma frase em vez de um único substantivo, você deverá usar a sintaxe de camel case para o valuefield. Por exemplo, para a Data de início planejada de uma tarefa, o código é:

      Exemplo: group.0.valuefield=plannedStartDate

    2. Se você quiser exibir um campo personalizado, o valor valuefield é o nome real do campo, como você o vê na interface. Por exemplo, para um campo personalizado chamado “Mais informações”, o código é:

      Exemplo: group.0.valuefield=More information

    3. Se você deseja agrupar por objetos que estão relacionados a outros objetos usando a linha de código valuefield, os nomes e atributos dos objetos são separados por dois-pontos.

      Por exemplo, um agrupamento por Nome de Portfolio para uma lista de tarefas tem o seguinte valor para a linha do campo de valor:

      Exemplo: group.0.valuefield=project:portfolio:name

      Indica que, a partir do objeto do relatório (tarefa), você pode acessar o próximo objeto relacionado (projeto); a partir daí, você pode acessar o seguinte objeto relacionado a partir do projeto (portfólio); em seguida, o nome do portfólio (nome).

    Para obter informações sobre como os objetos se conectam entre si, consulte a seção Interdependência e hierarquia de objetos em Entender objetos no Adobe Workfront.

    Nota: Se você escolher um campo no modo de texto que não seja válido na interface padrão e alternar para a interface padrão, o agrupamento será deletado.

    valueformat=

    Esta linha representa o formato usado para exibir o valuefield. valueformat identifica se um objeto ou campo é exibido como texto, número, porcentagem ou data.

    Recomendamos o uso de HTML para valueformat, especialmente ao usar valueexpression, para garantir a exibição mais precisa de suas informações.

    Para obter informações sobre valores adicionais para esta linha, consulte Usar formatação condicional no Modo de Texto.

    expressãode valor=

    Você pode adicionar esta linha para substituir valuefield, caso queira agrupar sua lista por um cálculo entre vários campos.

    Você deve colocar valuefield dos objetos entre chaves sempre que usá-los em um valueexpression.

    Existem os seguintes cenários:

    1. Para exibir o nome de um agrupamento em maiúsculas, você deve usar:

      Exemplo: group.0.valueexpression=UPPER({valuefield})

      O valuefield do objeto está escrito como aparece no API Explorer.

    2. Se você quiser adicionar vários valuefields agrupando-os em uma linha valueexpression , separe-os por um ponto.

      Por exemplo, se você quiser exibir o nome do portfólio em maiúsculas em uma lista de tarefas, você usaria o seguinte código na linha valueexpression:

      Exemplo: group.0.valueexpression=UPPER({project}.{portfolio}.{name})

      Se você quiser usar um campo personalizado em uma linha valueexpression, preceda o nome do campo por DE: para indicar que ele é um campo personalizado. O nome do campo é grafado conforme aparece na interface.

      Importante: Quando você usa um campo personalizado colocado em uma seção de formulário personalizado que tem permissões restritas para alguns usuários, o cálculo de valueexpression fica em branco quando esses usuários exibem esse cálculo em um relatório. Para obter informações sobre como ajustar permissões em seções de formulário personalizadas, consulte Criar um formulário personalizado.

      Por exemplo, se você tiver um campo personalizado rotulado “Nome do Desenvolvedor” e quiser agrupar por esse campo e exibi-lo em maiúsculas, poderá usar a seguinte valueexpression para indicar isso:

      Exemplo: group.0.valueexpression=UPPER({DE:Developer Name})

      Ao fazer referência a um campo personalizado do tipo Typeahead, use a seguinte expressão para fazer referência ao nome do objeto selecionado em um campo rotulado como “Nome do desenvolvedor”:

      valueexpression=UPPER({DE:Developer Name:name})

    chave_nome= / nome=

    Esta linha define o rótulo de agrupamento. Nesse caso, ele está usando o valor abreviado com base na chave.

    Se quiser modificar o nome do agrupamento, você pode alterar esse valor para o seguinte:

    Exemplo: group.0.name=Your Value

    Name permite inserir qualquer texto para o nome do agrupamento, enquanto namekey exige a inserção de uma chave usada para traduzir o nome de um agrupamento.

    Para alterar o nome do agrupamento, você também pode adicionar a linha displayname , se não houver uma.

    nome_de_exibição =

    Você pode adicionar a seguinte linha para alterar o nome de uma coluna, o que substitui o valor namekey/name:

    Exemplo: group.0.displayname=Your Value

    Recomendamos remover todas as linhas que contêm name ao renomear um agrupamento.

  5. (Opcional) Adicione uma das seguintes linhas de código a qualquer agrupamento para indicar se os resultados do agrupamento devem ser exibidos em uma lista expandida ou recolhida. Por padrão, os agrupamentos são exibidos expandidos:

    code language-none
    group.0.iscollapsed=true
    

    se quiser que o agrupamento seja exibido com os resultados recolhidos

    code language-none
    group.0.iscollapsed=false
    

    se quiser que o agrupamento seja exibido com os resultados expandidos

    note tip
    TIP
    • Quando você ajusta os agrupamentos manualmente ao exibir uma lista, o Workfront se lembra de sua preferência manual até que você faça logoff. Ao efetuar logon novamente, a lista é exibida de acordo com essa configuração.
    • Os resultados de um agrupamento sempre são exibidos expandidos após acessá-los a partir de um elemento de gráfico.
  6. Clique em Concluído se você deseja salvar suas alterações e continuar editando o agrupamento ou relatório.

  7. Clique em Salvar Agrupamento em uma lista ou em Salvar + Fechar para salvar seu relatório.

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