DocumentaçãoWorkfrontGuia do Workfront

Editar um filtro usando o modo de texto

Last update: Fri Feb 21 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

  • Usuário

É possível editar um filtro 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 filtros mais complexos.

Para obter mais exemplos de modo de texto ao criar um filtro, consulte também a seção Amostras de filtros personalizados no artigo Amostras personalizadas de exibição, filtro e agrupamento: índice do artigo.

Requisitos de acesso

Expanda para visualizar os requisitos de acesso para a funcionalidade neste artigo.

Você deve ter o seguinte:

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 do Adobe Workfront

Novo:

  • Padrão

Atual:

  • Plano
Configurações de nível de acesso

Editar acesso a Filtros, Visualizações e Agrupamentos

Editar acesso a Relatórios, Painéis e Calendários para editar elementos de relatórios em um relatório
Permissões de objeto

Gerenciar permissões de um relatório para editar filtros em um relatório

Gerenciar permissões de um filtro para editá-lo

Para obter informações, 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:

Modo de edição de texto em um filtro

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

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

Para obter mais informações sobre a criação de filtros, consulte Visão geral dos filtros.

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

  1. Siga um destes procedimentos:

    Para acessar o filtro de uma lista, vá para a lista e clique no ícone Filtro, em seguida, passe o mouse sobre o filtro no painel lateral Filtros que você deseja modificar e clique no ícone Editar Ícone Editar . O painel lateral Filtros exibe o filtro selecionado ou o construtor de filtros herdados abre.

    OU

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

  2. Siga um destes procedimentos:

    Se você estiver usando o painel lateral Filtros em uma lista, clique em Modo de texto.

    OU

    Se você estiver usando o construtor de filtros herdados ou em um relatório, clique em Adicionar uma Regra de Filtro para começar a adicionar as condições de seu filtro. Em seguida, clique em Alternar para o modo de texto e depois em Editar modo de texto no lado direito do construtor.

  3. Adicione instruções de filtro usando o modo de texto. Cada declaração de filtro pode conter as seguintes linhas e informações adicionais:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header
    Filtrar linha/informações Exemplo

    Nome do campo e o valor igual ao que aparecem no banco de dados do Workfront.

    Esta linha é obrigatória.

    Para obter mais informações sobre como os objetos e campos aparecem no banco de dados, consulte API Explorer.

    <field name in camel case>=<value>

    Para filtrar tarefas com status Em andamento, use a seguinte linha:

    status=INP

    DICA

    Ao filtrar por status, é necessário usar o código de três letras do status, não o nome.

    Modificador do nome do campo e o modificador é igual a. Isso indica quais condições o campo que você está filtrando deve atender.

    Esta linha é obrigatória.

    <field name in camel case>_Mod=<modifier value>

    Para indicar que o status das tarefas filtradas deve ser igual a Em andamento, use a seguinte linha, além da linha acima:

    status_Mod=in

    Se o modificador for uma faixa, há duas linhas para indicar o modificador.

    EXEMPLO

    Este é um filtro de modo de texto que procura tarefas em andamento, que tenham uma Data de conclusão planejada para o mês atual e estejam atribuídas a um usuário com uma GUID específica:

    assignedToID=580a55a4000701f4b2d7dee1e7a9d427

    assignedToID_Mod=in

    status=INP

    status_Mod=in

    plannedCompletionDate=$$TODAYbm

    plannedCompletionDate_Mod=between

    plannedCompletionDate_Range=$$TODAYem

    Para obter uma lista completa de modificadores de filtro em modo de texto, consulte o artigo Modificadores de filtro e condição.

    Operador de instrução. Por padrão, cada instrução de filtro é conectada pelo operador "AND". Isso não é exibido na interface do modo de texto. Você também pode adicionar um operador "OR" entre duas instruções para indicar que deseja filtrar por objetos que podem atender a uma ou outra de duas condições.

    Os operadores de filtro são necessários somente para filtros que tenham mais de uma instrução.

    Dica:

    • "OR" diferencia maiúsculas de minúsculas e sempre deve ser capitalizado.

    • Quando você altera o operador de AND para OR, o número de itens da lista pode aumentar.

    <first field name in camel case>=<value>

    <first field name in camel case>_Mod=<modifier value>

    OR:1:<second field name in camel case>=<value>

    OR:1:<second field name in camel case>_Mod=<modifier value>

    EXEMPLO

    Para filtrar tarefas com status Em Andamento ou com Data de Conclusão Planejada de Hoje, use o seguinte:

    status=INP

    status_Mod=in

    OR:1:plannedCompletionDate=$$TODAY

    OR:1:plannedCompletionDate_Mod=eq

    Um curinga, que permite generalizar as informações em um filtro e fazer referência à hora atual do usuário que está conectado.

    Os curingas são opcionais.

    Dica:

    Recomendamos usar curingas sempre que possível para tornar seus filtros mais dinâmicos e não duplicar os mesmos filtros para cada usuário ou períodos semelhantes.

    Para obter informações sobre curingas de filtro, consulte Visão geral das variáveis de filtro curinga.

    <first field name in camel case>=<wildcard>

    <first field name in camel case>_Mod=<modifier value>

    EXEMPLO

    Para filtrar tarefas atribuídas ao usuário que está conectado no momento, use o seguinte:

    assignedToID=$$USER.ID

    assignedToID_Mod=in

  4. Para adicionar uma instrução de filtro conectada pelo operador "OR", faça o seguinte:

    1. Adicione uma nova linha de código e tipo OR:1: seguido pelo objeto ou atributo pelo qual você deseja filtrar e o valor com o qual você deseja compará-lo. Para referenciar tarefas que estão em qualquer status, exceto Nova, use a seguinte linha:

      OR:1:status=NEW

    2. Adicione uma segunda linha e digite OR:1: seguido pelo objeto, modificador e código do modificador. Para definir o modificador para a linha de código que faz referência a todos os status de tarefa, exceto para Novo, use a seguinte linha do modificador:

      OR:1:status_Mod=notin

      Cada linha da nova instrução deve ser precedida por "OR:<number>:".

      Para obter informações sobre como criar instruções "OR" em um filtro, consulte Criar instruções "OR" em filtros de modo de texto.

      note note
      NOTE
      Você pode ter várias instruções "OR" no mesmo filtro. Toda vez que você tem uma nova instrução "OR", o número após "OR:" aumenta.
      Para filtrar tarefas com status Em Andamento, atribuídas ao usuário conectado ou com Data de conclusão planejada para hoje, use o seguinte:
      status=INP
      status_Mod=in
      OR:1:assignedToID=$$USER.ID
      OR:1:assignedToID_Mod=in
      OR:2:plannedCompletionDate=$$TODAY
      OR:2:plannedCompletionDate_Mod=eq

  5. Clique em Aplicar ou Concluído para salvar suas alterações no modo de texto e continuar editando o relatório ou filtro.

  6. Clique em Salvar + Fechar para salvar seu relatório ou em Salvar Filtro para salvar o filtro na lista.

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