DocumentaçãoWorkfrontGuia do Workfront

Exemplos do campo Pesquisa externa em um formulário personalizado

Last update: Wed Jul 17 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

  • undefined

Um campo Pesquisa externa em um formulário personalizado chama uma API externa e retorna valores como opções em um campo suspenso. Os usuários que trabalham com o objeto ao qual o formulário personalizado está anexado podem selecionar uma ou mais dessas opções na lista suspensa.

Este artigo fornece exemplos de como usar o campo Pesquisa externa para chamar a mesma instância do Workfront ou uma API pública. Você também pode usar a Pesquisa externa para se comunicar com um sistema externo, como Jira, Salesforce ou ServiceNow.

Os campos de Pesquisa externa só estão disponíveis no novo designer de formulário, não no construtor de formulários herdado. Para obter mais informações sobre como adicionar um campo Pesquisa Externa a um formulário personalizado e definições adicionais dos componentes de pesquisa externa, consulte Criar um formulário com o designer de formulário.

Configurar um campo Pesquisa externa para a mesma instância do Workfront

Você pode usar a Pesquisa externa para trazer dados da sua instância do Workfront para o formulário personalizado.

Este exemplo mostra como chamar a API do Workfront e trazer dados do campo "Consulta de status" existente para o campo Pesquisa externa.

  1. Abra o formulário personalizado.

  2. No lado esquerdo da tela, encontre Pesquisa externa e arraste-a para uma seção da tela.

  3. Insira o Rótulo e o Nome do campo.

  4. Selecione o Formato para o campo.

  5. Insira a chamada da URL da API no campo URL da API de base.

    • Você pode adicionar $$HOST para fazer referência à mesma instância.
    • Você pode adicionar $$QUERY para filtrar os resultados com base na consulta de um campo diferente.

    Exemplo
    $$HOST/attask/api/v15.0/project/search?status={DE:StatusQuery}&$$QUERY

  6. Revise as Dependências dos campos aos quais este campo de pesquisa faz referência na API.

    Um campo de dependência pode ser qualquer campo personalizado ou nativo existente na página de detalhes do objeto.

    Neste exemplo, o {DE:StatusQuery} será substituído pelo valor do campo personalizado StatusQuery.

  7. Selecione o Método HTTP.

    Isto provavelmente será Obter.

  8. Insira o Caminho JSON para obter os resultados da sua chamada à API.

    Exemplo
    $.data[*].name

    note note
    NOTE
    As informações do Cabeçalho não são necessárias para uma chamada para a mesma instância do Workfront.

  9. Clique em Aplicar.

    Configuração da chamada de API para o Workfront no formato personalizado

    Quando o formulário personalizado é adicionado a um objeto do Workfront (neste exemplo, um projeto), ele é semelhante a este.

    Formulário personalizado com campo de pesquisa externo

    Opções de pesquisa externa com base no status

Configurar um campo Pesquisa externa para uma API pública

Você pode usar a Pesquisa externa para chamar uma API externa pública e recuperar dados.

Este exemplo mostra como chamar uma API de países (como https://api.first.org/data/v1/countries) para que você não precise codificar todos os nomes de países nas opções suspensas.

  1. Abra o formulário personalizado.

  2. No lado esquerdo da tela, encontre Pesquisa externa e arraste-a para uma seção da tela.

  3. Insira o Rótulo e o Nome do campo.

  4. Selecione o Formato para o campo.

  5. Insira a chamada da URL da API no campo URL da API de base.

    • Você pode adicionar $$QUERY para implementar a filtragem de consultas para seus usuários finais.

    Exemplos
    Lista todos os países: https://api.first.org/data/v1/countries

    Permite que o usuário pesquise por qualquer país no campo suspenso: https://api.first.org/data/v1/countries?q=$$QUERY

    Permite que o usuário procure por um país em uma região: https://api.first.org/data/v1/countries?region={DE:Region}&q=$$QUERY

    • As regiões disponíveis são definidas em um campo personalizado separado no Workfront.
    • Quando o usuário seleciona uma região no formulário, o campo Pesquisa externa mostra apenas os países dessa região (qual país está em qual região está definida na API). O usuário também pode pesquisar por um país na região selecionada.

  6. Revise as Dependências dos campos aos quais este campo de pesquisa faz referência na API.

    Um campo de dependência pode ser qualquer campo personalizado ou nativo existente na página de detalhes do objeto.

    Neste exemplo, o {DE:Region} será substituído pelo valor do campo personalizado Região.

  7. Selecione o Método HTTP.

    Isto provavelmente será Obter.

  8. Insira o Caminho JSON para obter os resultados da sua chamada à API.

    Essa opção permite extrair dados do JSON retornado pelo URL da API. Ela serve como uma maneira de selecionar quais valores dentro do JSON aparecerão nas opções suspensas.

    Exemplo
    $.data[*].country

  9. (Opcional) Clique em Adicionar cabeçalho e digite ou cole o par de valores chave necessário para autenticação com a API.

    note note
    NOTE
    Os campos de Cabeçalho não são um local seguro para armazenar credenciais, e você deve ter cuidado com o que digitar e salvar.

  10. (Opcional) Selecione Seleção múltipla para permitir que o usuário selecione mais de um valor na lista suspensa.

  11. Clique em Aplicar.

    Configuração da chamada de API para API pública no formato personalizado

    Quando o formulário personalizado é adicionado a um objeto do Workfront (neste exemplo, um projeto), ele é semelhante a este.

    Formulário personalizado com campo de pesquisa externo

    Opções de pesquisa externa para um país com base na região

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