Visão geral das instruções "IF"
Você pode usar instruções "IF" em linguagens de programação gerais. No Adobe Workfront, as instruções "IF" permitem comparar, formatar e reunir campos de dados para fins de relatório e dados personalizados. Além disso, pensar matematicamente sobre declarações "IF" leva a uma melhor compreensão conceitual, uma vez que as variáveis para expressões são comumente usadas.
Recommendations para instruções "IF"
Considere o seguinte antes de criar uma instrução "IF":
-
Recomendamos uma compreensão básica de qualquer linguagem de programação geral, mas não a exigimos, para este guia.
-
Precisamos de uma compreensão avançada da sintaxe do modo de texto do Workfront. Isso ajuda a compreender a terminologia da API do Workfront e a entender a sintaxe dos dados personalizados nesses formatos específicos.
Para obter informações sobre a API do Workfront, consulte noções básicas sobre API.
Para obter informações sobre como usar o modo de texto, consulte Visão geral do Modo de Texto.
-
Você pode criar instruções "IF" para os seguintes elementos do Workfront:
- Visualizações
- Agrupamento
- Campos personalizados calculados
-
Não é possível criar instruções "IF" para filtros. Isso resulta em um erro "Ops" no Workfront.
-
A Equipe de suporte não ajuda na criação de dados personalizados. Você pode entrar em contato com a equipe de suporte depois de criar os campos ou colunas personalizados e não estiver vendo os resultados desejados. Para obter ajuda sobre como criar uma expressão, entre em contato com o seu Executivo de contas para saber mais sobre nossas opções de consultoria.
-
Recomendamos escrever essas expressões primeiro em um editor de texto, como Sublime ou Visual Studio Code, pois isso ajuda a ver os dados com mais clareza do que apareceria no Workfront.
Componentes de uma instrução "IF"
Você pode criar instruções "IF" no Workfront usando o seguinte formato:
IF(Condição,Expressão Verdadeira,Expressão Falsa)
-
IF = Esta é a expressão de dados calculados Workfront para "função". Semelhante às expressões SUM e PROD, isso informa primeiro o sistema a entender a função como uma instrução "IF". Use sempre letras maiúsculas para "IF" neste demonstrativo.
Para obter uma lista de todas as expressões de dados calculados, consulte Visão geral das expressões de dados calculados. -
Condição = Essa é a condição que a variável Workfront deve atender e é a base dessa equação. Tudo que pode ser especificado posteriormente na equação depende da condição. Você pode usar várias referências, comparações ou expressões matemáticas para iniciar uma equação. Alguns exemplos de condições são:
- Uma data é posterior a outra data em um objeto especificado.
- Um status é igual a um dos status disponíveis em um objeto especificado.
- O percentual concluído de uma tarefa é menor ou maior que um determinado percentual.
-
Operador de Condição = este é o operador que ajuda a criar a condição da sua instrução "IF". Por exemplo, "é igual a" ou "é maior que" são operadores de condição. Para obter uma lista de operadores de condição que você pode usar em instruções, consulte Operadores de condição em expressões personalizadas calculadas.
-
True Expression = Esta é a variável "True", que informa à equação qual indicador será exibido quando os critérios da condição forem atendidos (indicadores true).
-
Expressão Falsa = Essa é a variável "False", que informa à equação qual indicador exibir quando os critérios da condição não forem atendidos (indicadores falsos).
No exemplo a seguir, o formato da instrução original é usado para escrever uma expressão de dados simples para uma instrução "IF". A expressão compara dois campos de data diferentes no Workfront seguidos por um resultado Verdadeiro/Falso como uma string de dados:
IF({projectedCompletionDate}>{plannedCompletionDate},"Off Track","On Track")
Na linguagem cotidiana, essa declaração significaria: Se a Data de conclusão projetada do meu objeto for "Maior que" a Data de conclusão planejada do mesmo objeto, exibir as palavras "Fora do rastreamento" neste campo. Caso contrário, exiba as palavras "On Track".
Criar campos calculados em formulários personalizados ou colunas personalizadas usando instruções "IF"
Você pode criar declarações "IF" em um campo calculado em um formulário personalizado ou em uma coluna personalizada.
Há uma diferença na sintaxe usada em um formulário personalizado calculado em comparação a uma coluna personalizada calculada. Consulte os seguintes exemplos:
Instruções "IF" únicas single-if-statements
Veja a seguir exemplos de um campo personalizado calculado e sua coluna correspondente usando uma instrução "IF":
- Campo personalizado calculado:
Ao criar um campo personalizado, use a seguinte sintaxe para uma instrução "IF":
IF({Projected Completion Date}>{Planned Completion Date},"Off Track","On Track")
- Coluna personalizada calculada:
Ao criar uma coluna personalizada, você deve usar a seguinte sintaxe para a instrução "IF" na linha de expressão de valor:
valueexpression=IF({projectedCompletionDate}>{plannedCompletionDate},"Off Track","On Track")
Várias instruções "IF" multiple-if-statements
Você pode reunir várias instruções "IF" com a seguinte instrução para criar uma expressão mais complexa e dinâmica:
IF(Condição1,Expressão Verdadeira,IF(Condição2,Expressão Verdadeira,Expressão Falsa))
Veja a seguir exemplos de um campo personalizado calculado e sua coluna personalizada correspondente usando várias instruções "IF":
-
Campo personalizado calculado:
code language-none IF({projectedCompletionDate}>{plannedCompletionDate},"Off Track",IF({plannedCompletionDate}>{projectedCompletionDate},"Off Track","On Track")) -
Coluna personalizada calculada:
valueexpression=IF({"projectedCompletionDate"}>{"plannedCompletionDate"},"Off Track",IF({plannedCompletionDate}>{projectedCompletionDate},"Off Track","On Track"))
Neste exemplo, a mesma coisa foi realizada, reunindo duas variáveis de critério diferentes.
Você pode explorar ainda mais essas opções recriando esses exemplos em seu próprio ambiente.
A melhor maneira de aprender isso é experimentando com vários campos e cenários. Além disso, familiarize-se com o API Explorer, que revela os nomes de campo que podem ser usados. Para obter informações sobre o API Explorer, consulte API Explorer.
Para obter mais informações sobre a sintaxe Workfront de expressões de dados calculados, consulte Visão geral de expressões de dados calculados.