Modo de edição de texto em um agrupamento

É possível 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 para o modo de texto para editá-lo.

Requisitos de acesso

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

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 para editar agrupamentos em um relatório

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 de um relatório para editar agrupamentos em um relatório

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

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

*Para saber qual plano, tipo de licença ou acesso você tem, contate o administrador 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:

Modo de edição de texto em um agrupamento

A edição de um agrupamento usando o modo 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 em 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 a criação de 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 deseja modificar e clique no ícone Editar .

      O construtor de agrupamento é aberto.

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

    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 digitando o nome de um campo pelo qual deseja agrupar.

    Selecione o nome do campo ao visualizá-lo na lista.

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

    O agrupamento é exibido no modo de texto.

    Ao editar um agrupamento no modo texto, o Workfront adiciona a variável

    code language-none
    textmode=true
    

    linha de código ao agrupamento. Isso 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, seu agrupamento deve se parecer com o seguinte 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 descreve as linhas principais 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 fazem referência 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 referentes 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 fazem referência 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 fazem referência ao quarto agrupamento começam com group.3.

    Observação: 4 agrupamentos não são permitidos no construtor. Elas só são compatíveis quando o modo de texto é usado. O Workfront não oferece suporte a mais de quatro níveis de agrupamentos.

    valorcampo=

    Esse é o nome do objeto ou do campo como ele aparece no banco de dados. Para obter mais informações sobre como os 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. Para 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ê quiser agrupar por objetos relacionados a outros objetos usando a linha de código valuefield, os nomes e atributos dos objetos serã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

      Isso 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, consulte a seção Interdependência e hierarquia de objetos em Entender objetos no Adobe Workfront.

    Nota: Se você escolher um campo no modo 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. O 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ão_de_valor=

    Você pode adicionar esta linha para substituir valuefield, se quiser 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. Se quiser exibir o nome de um agrupamento em maiúsculas, use:

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

      O valuefield do objeto é 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 personalizada 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 chamado "Nome do desenvolvedor" e quiser agrupar por esse campo e exibi-lo em maiúsculas, poderá usar o seguinte valueexpression para indicar isso:

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

      Ao fazer referência a um campo personalizado do tipo Digitação antecipada, 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})

    namekey= / name=

    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ê poderá alterar esse valor para o seguinte:

    Exemplo: group.0.name=Your Value

    Name permite inserir qualquer texto para o nome do agrupamento, enquanto namekey requer que você insira uma chave que seja usada para traduzir o nome de um agrupamento.

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

    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 desejar que o agrupamento seja exibido com os resultados recolhidos

    code language-none
    group.0.iscollapsed=false
    

    se desejar que o agrupamento seja exibido com os resultados expandidos

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

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

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