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.
Requisitos de acesso
Você deve ter o seguinte acesso para executar as etapas deste artigo:
*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.
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.
-
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 deseja modificar e clique no ícone Editar .
O construtor de agrupamento é aberto.
-
-
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. -
Comece digitando o nome de um campo pelo qual deseja agrupar.
Selecione o nome do campo ao visualizá-lo na lista.
-
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:
-
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
-
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
-
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
. Ovalueformat
identifica se um objeto ou campo é exibido como texto, número, porcentagem ou data.Recomendamos o uso de
HTML
paravalueformat
, 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ã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 umvalueexpression
.Existem os seguintes cenários:
-
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. -
Se você quiser adicionar vários
valuefields
agrupando-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 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, enquantonamekey
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. - 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
-
(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.
-
Clique em Concluído se desejar salvar suas alterações e continuar editando o agrupamento ou relatório.
-
Clique em Salvar Agrupamento em uma lista ou Salvar + Fechar para salvar seu relatório.