Adicionar campos calculados a um formulário

  Cada campo deve usar a sintaxe explicada abaixo, com chaves ao redor de cada nome de campo. Quando você começa a digitar o nome de um campo, o sistema faz sugestões e você pode selecionar uma para inseri-la no cálculo. Se você inserir dados em um cálculo incorretamente, uma mensagem de aviso o alertará. Não é possível salvar o formulário, a menos que você edite o cálculo para que ele contenha campos válidos e uma expressão calculada válida.

  <div class="extension note">
  <div>NOTE</div>
  <div>
  <p>Atualmente, o sistema faz sugestões somente quando você começa a digitar o nome de um campo que deseja referenciar em um objeto ao qual o formulário personalizado será anexado. Os campos do objeto pai não são sugeridos.</p>
  </div>
  </div>

  **Nomes de campo surround com chaves**

  * Se quiser que o cálculo faça referência a um campo incorporado, o nome do campo deverá estar entre chaves.

    Por exemplo: `{actualRevenue}`

    Os nomes de campos fazem distinção entre maiúsculas e minúsculas e devem aparecer no cálculo exatamente como aparecem no sistema Workfront.

    Navegue até o [Workfront API Explorer](https://developer.adobe.com/workfront/api-explorer/) para identificar os nomes de campo que podem ser usados em cálculos.

  * Se você quiser que o cálculo faça referência a um campo personalizado, o nome do campo deverá estar entre chaves e precedido por `DE:` entre colchetes.

    Por exemplo: `{DE:Profit}`

    O sistema lista todos os campos personalizados que você pode escolher ao digitar `DE:`.

     * Para que o cálculo faça referência a um campo que extrairá dados do objeto *pai* quando o formulário personalizado for anexado a um objeto, você deve preceder o nome do campo com o tipo de objeto do objeto pai, também entre chaves.

    Por exemplo, se o formulário personalizado estiver configurado para funcionar com tarefas e você quiser que o campo calcule a receita real do objeto pai quando o formulário for anexado a uma tarefa, será necessário indicar `Project` como o tipo de objeto do campo:

    `{project}.{actualRevenue}`

    Ou, se for um campo personalizado:

    `{project}.{DE:profit}`

    **Separar itens com pontos**

    Ao fazer referência a um objeto relacionado em um campo personalizado calculado, você deve separar nomes de objeto e atributos com pontos.

    Por exemplo, em um formulário personalizado do tipo tarefa, para exibir o nome do Proprietário do Portfolio em um campo personalizado calculado, você digitaria o seguinte:

    `{project}.{porfolio}.{owner}`

    Isso determinaria o seguinte: A partir do objeto do formulário personalizado (uma tarefa), você pode acessar o próximo objeto relacionado à tarefa (um projeto). A partir daí, você pode acessar o próximo objeto relacionado ao projeto (um portfólio) e, em seguida, fazer referência aos campos definidos para o objeto do portfólio (o proprietário)

    **Sintaxe de nome para fazer referência a um campo personalizado**

    Quando você faz referência a outro campo personalizado em um campo personalizado calculado, é necessário inserir o nome do campo como ele é exibido na interface do usuário do Workfront.

    Por exemplo, para fazer referência à opção selecionada em um campo personalizado rotulado como Patrocinador executivo, você digitaria o seguinte:

    `{DE:Executive sponsor}`

    <div class="extension note">
    <div>NOTE</div>
    <div>
    <p>A sintaxe de um campo de digitação antecipada é um pouco diferente de outros tipos de campos, pois você precisa adicionar <code>:name</code> no final.</p>
    <p>Por exemplo, para fazer referência à opção selecionada em um campo de digitação antecipada personalizado chamado &quot;Patrocinador executivo&quot;, você digitaria:</p>
    <p><code>{DE:Executive sponsor:name}</code></p>
    </div>
    </div>


    **Campos personalizados calculados em formulários personalizados de vários objetos**

    Em um formulário personalizado de vários objetos, os tipos de objeto selecionados devem ser compatíveis com pelo menos um campo referenciado nos campos personalizados calculados do formulário. Campos não compatíveis com o objeto exibirão N/D no formulário.

    Para garantir que o campo calculado mostre um resultado correto para todos os tipos de objeto, você deve usar `$$OBJCODE` para definir um cálculo para cada tipo de objeto.

    <div class="extension info">
    <div>INFO</div>
    <div>
    <p><strong>Exemplo:</strong></p>
    <p>Em um formulário personalizado configurado para trabalhar com projetos, tarefas e problemas, você pode usar a seguinte fórmula para exibir o tipo de objeto:</p>
    <p><code>IF($$OBJCODE=&quot;PROJ&quot;,&quot;This is a project&quot;,IF($$OBJCODE=&quot;TASK&quot;,&quot;This is a task&quot;,&quot;This is an issue&quot;))</code></p>
    <p>Em um projeto, o campo mostrará &quot;Isto é um projeto&quot;, em uma tarefa mostrará &quot;Isto é uma tarefa&quot; e em um problema dirá &quot;Isto é um problema&quot;.</p>
    </div>
    </div>


    <div class="extension info">
    <div>INFO</div>
    <div>
    <p><strong>Exemplo:</strong> Embora não haja nenhum campo Atribuído a: Nome nos projetos, há um campo Proprietário interno (que é preenchido automaticamente com o nome da pessoa que criou o projeto, a menos que alguém altere isso manualmente).</p>
    <p>Portanto, em seu campo personalizado Encargo, você pode usar <code>$$OBJCODE</code> como mostrado abaixo para fazer referência ao campo Proprietário quando o formulário personalizado estiver anexado a um projeto, e o campo Atribuído a: Nome quando o formulário estiver anexado a uma tarefa:</p>
    <p><code>IF($$OBJCODE=&quot;PROJ&quot;,{owner}.{name},{assignedTo}.{name})</code></p>
    </div>
    </div>

    Para obter mais informações sobre variáveis como `$$OBJCODE,`, consulte [Visão geral das variáveis de filtro curinga](https://experienceleague.adobe.com/docs/workfront/quicksilver/reports-and-dashboards/reports/reporting-elements/understand-wildcard-filter-variables.html?lang=pt-BR).

    **Atualizações automáticas de campos personalizados calculados**

    Os campos personalizados calculados em um objeto são recalculados automaticamente quando as seguintes situações ocorrem:

     * Algo no objeto muda, como um cálculo diário da linha do tempo.
     * Alguém edita outro campo que é referenciado por um campo personalizado calculado no objeto.
     * A expressão calculada está vazia e o campo contém um valor, isso define o valor como nulo.

       <div class="extension note">
       <div>NOTE</div>
       <div>
       <div>Em um formulário personalizado anexado a um objeto, os demonstrativos de data e hora em campos personalizados calculados são calculados e salvos pelo Tempo universal coordenado (UTC), não pelas configurações de fuso horário definidas para a instância da organização e o perfil do usuário. Os cálculos em um formulário personalizado são gerados com base nos fusos horários individuais de cada usuário.</div>
       </div>
       </div>

  <div class="extension tip">
  <div>TIP</div>
  <div>
  <p>Você pode executar qualquer um dos seguintes procedimentos para obter ajuda com o cálculo:</p>
  <ul>
  <li>Passe o mouse sobre uma expressão no cálculo para ver uma descrição, um exemplo mostrando como ela pode ser usada e um link &quot;Saiba mais&quot; para obter mais informações no artigo <a href="https://experienceleague.adobe.com/docs/workfront/quicksilver/reports-and-dashboards/reports/calc-cstm-data-reports/calculated-data-expressions.html?lang=pt-BR">Visão geral das expressões de dados calculadas</a>.<br>
  <img src="assets/hover-expression-help-text.jpg" alt=""></li>
  <li>Use a codificação de cores para identificar os componentes adicionados. As expressões são exibidas em azul e os campos são exibidos em verde.<br>
  <img src="assets/colors-fields-expressions.jpg" alt=""></li>
  <li>Encontre erros de cálculo, destacados em rosa, conforme você avança. Você pode passar o mouse sobre um erro destacado para exibir uma breve descrição da causa.<br>
  <img src="assets/error-help.png" alt=""></li>
  <li>Na área abaixo do cálculo, visualize os resultados em um objeto do Workfront existente.</li>
  </ul>
  <!--or by providing test values (NOT READY YET; CHANGE THIS SCREENSHOT WHEN IT IS)-->
  <p><img src="assets/preview-calc.jpg" alt=""></p>
  <ul>
  <li>Referencie expressões em um cálculo longo usando os números de linha exibidos à esquerda.</li>
  </ul>
  </div>
  </div>