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.
Requisitos de acesso
| 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.
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.
-
Siga um destes procedimentos:
-
Para acessar o agrupamento de um relatório, vá para o relatório e clique em Ações de Relatório > Editar > guia Agrupamentos.
-
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
.
O construtor de agrupamento é aberto.
-
-
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. -
Comece a digitar o nome de um campo pelo qual deseja agrupar.
Selecione o nome do campo quando ele aparecer na lista.
-
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=truelinha 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:
-
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 -
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 -
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:nameIndica 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.valueformatidentifica se um objeto ou campo é exibido como texto, número, porcentagem ou data.Recomendamos o uso de
HTMLparavalueformat, especialmente ao usarvalueexpression, 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
valuefielddos objetos entre chaves sempre que usá-los em umvalueexpression.Existem os seguintes cenários:
-
Para exibir o nome de um agrupamento em maiúsculas, você deve usar:
Exemplo:
group.0.valueexpression=UPPER({valuefield})O
valuefielddo objeto está escrito como aparece no API Explorer. -
Se você quiser adicionar vários
valuefieldsagrupando-os em uma linhavalueexpression, 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 porDE: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
valueexpressionfica 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
valueexpressionpara 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 ValueNamepermite inserir qualquer texto para o nome do agrupamento, enquantonamekeyexige 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 ValueRecomendamos remover todas as linhas que contêm
nameao renomear um agrupamento. - 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
-
(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=truese quiser que o agrupamento seja exibido com os resultados recolhidos
code language-none group.0.iscollapsed=falsese 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.
-
Clique em Concluído se você deseja salvar suas alterações e continuar editando o agrupamento ou relatório.
-
Clique em Salvar Agrupamento em uma lista ou em Salvar + Fechar para salvar seu relatório.