Criar um formulário personalizado

• Texto de linha única
• Parágrafo
• Texto com formatação
• Texto descritivo

(Obrigatório) Digite um rótulo descritivo para exibir acima do campo. Você pode alterar o rótulo a qualquer momento.

IMPORTANTE: Evite usar caracteres especiais neste rótulo. Eles não são exibidos corretamente nos relatórios. Para obter mais informações, consulte Notas sobre nomes e rótulos de campos.

• Texto de linha única
• Parágrafo
• Texto com formatação

(Obrigatório) Esse nome é a forma como o sistema identifica o campo. Quando você está configurando o widget pela primeira vez e digita o rótulo, o campo Nome é preenchido automaticamente para corresponder a ele. Mas os campos Label e Name não são sincronizados — isso dá a você a liberdade de alterar o rótulo que seus usuários veem sem precisar alterar o nome que o sistema vê.

Para obter mais informações, consulte Notas sobre nomes e rótulos de campos.

• Texto de linha única
• Parágrafo
• Texto com formatação
• Texto descritivo

• Texto de linha única
• Parágrafo
• Texto com formatação

Selecione o tipo de dados que será capturado no campo personalizado.

NOTA:

• Este campo não pode ser editado depois que o formulário é salvo. Se você pretende usar seu campo em cálculos matemáticos, certifique-se de selecionar um formato de Número ou Moeda.
• Ao selecionar Número ou Moeda, o sistema trunca automaticamente os números que começam com 0.
• O limite de caracteres para campos de Número é de 16. Você também pode usar um campo Texto para inserir números e evitar o limite.

• Texto de linha única
• Parágrafo

• Texto de linha única
• Parágrafo

• Texto descritivo

(Obrigatório) Digite um rótulo descritivo para exibir acima do campo personalizado. Você pode alterar o rótulo a qualquer momento.

IMPORTANTE:

Evite usar caracteres especiais neste rótulo. Eles não são exibidos corretamente nos relatórios. Para obter mais informações, consulte Notas sobre nomes e rótulos de campos.

• Botões de seleção
• Grupo de caixas de seleção
• Lista suspensa de seleção única
• Lista suspensa com seleção múltipla

(Obrigatório) Esse nome é a forma como o sistema identifica o campo. Quando você está configurando o widget pela primeira vez e digita o rótulo, o campo Nome é preenchido automaticamente para corresponder a ele. Mas os campos Label e Name não são sincronizados — isso dá a você a liberdade de alterar o rótulo que seus usuários veem sem precisar alterar o nome que o sistema vê.

Para obter mais informações, consulte Notas sobre nomes e rótulos de campos.

• Botões de seleção
• Grupo de caixas de seleção
• Lista suspensa de seleção única
• Lista suspensa com seleção múltipla

Digite quaisquer informações adicionais sobre o campo personalizado. Quando os usuários preencherem o formulário personalizado, poderão passar o mouse sobre o ícone de ponto de interrogação para exibir uma dica de ferramenta contendo as informações digitadas aqui.

• Botões de seleção
• Grupo de caixas de seleção
• Lista suspensa de seleção única
• Lista suspensa com seleção múltipla

Selecione o tipo de dados que será capturado no campo personalizado.

NOTA:

• Este campo não pode ser editado depois que o formulário é salvo. Se você pretende usar seu campo em cálculos matemáticos, certifique-se de selecionar um formato de Número ou Moeda.
• Ao selecionar Número ou Moeda, o sistema trunca automaticamente os números que começam com 0.
• O limite de caracteres para campos de Número é de 16. Você também pode usar um campo Texto para inserir números e evitar o limite.

• Botões de seleção
• Grupo de caixas de seleção
• Lista suspensa de seleção única
• Lista suspensa com seleção múltipla

• Botões de seleção
• Grupo de caixas de seleção
• Lista suspensa de seleção única
• Lista suspensa com seleção múltipla

• Botões de seleção
• Grupo de caixas de seleção
• Lista suspensa de seleção única
• Lista suspensa com seleção múltipla

1. Clique em Opções e habilite qualquer um dos itens a seguir:

   • Mostrar Valores: mostra os valores de cada escolha no campo. O rótulo de cada opção é exibido por padrão.
   • Classificar seleções de A a Z: classifica as seleções adicionadas em ordem alfabética no campo.

2. Para cada opção adicionada para o usuário, clique no ícone de engrenagem e selecione uma das seguintes opções:

   • Selecionar por padrão: selecione a opção por padrão no campo.

   • Ocultar opção: oculta a opção no campo. As opções ocultas permanecem acessíveis nos relatórios.

   • Remover Opção: remova a opção do campo.

     AVISO: se você tiver objetos atuais usando essa opção, não remova-a do campo. Sua remoção fará com que os dados do histórico sejam perdidos. Em vez disso, selecione a opção para ocultá-la, o que impede que os usuários a selecionem no futuro.

NOTA:

Não há limite para o número de opções que você pode selecionar.

• Botões de seleção
• Grupo de caixas de seleção
• Lista suspensa de seleção única
• Lista suspensa com seleção múltipla

(Obrigatório) Digite um rótulo descritivo para exibir acima do campo personalizado. Você pode alterar o rótulo a qualquer momento.

IMPORTANTE: Evite usar caracteres especiais neste rótulo. Eles não são exibidos corretamente nos relatórios. Para obter mais informações, consulte Notas sobre nomes e rótulos de campos.

• Typeahead
• Data

(Obrigatório) Esse nome é a forma como o sistema identifica o campo. Quando você está configurando o widget pela primeira vez e digita o rótulo, o campo Nome é preenchido automaticamente para corresponder a ele. Mas os campos Label e Name não são sincronizados — isso dá a você a liberdade de alterar o rótulo que seus usuários veem sem precisar alterar o nome que o sistema vê.

Para obter mais informações, consulte Notas sobre nomes e rótulos de campos.

• Typeahead
• Data

Digite quaisquer informações adicionais sobre o campo personalizado. Quando os usuários preencherem o formulário personalizado, poderão passar o mouse sobre o ícone de ponto de interrogação para exibir uma dica de ferramenta contendo as informações digitadas aqui.

• Typeahead
• Data

• Data

Selecione o tipo de objeto que deseja associar ao campo.

Depois de clicar em Aplicar ou Salvar+Fechar, não é possível alterar o tipo de objeto do campo.

NOTA:

• Se o administrador do Workfront personalizou o nome de Portfolio, Programas ou Projetos na interface do usuário do Workfront, o nome padrão do Workfront para o objeto será exibido nessa lista suspensa, não no nome personalizado. Consulte o administrador do Workfront se precisar de ajuda com isso.
• Os seguintes tipos de objetos são suportados nos aplicativos móveis iOS e Android Workfront: usuário, empresa, grupo, função de trabalho, Portfolio, programa, projeto e modelo.

• Typeahead

Adicione um filtro para um tipo de objeto para limitar os objetos que os usuários podem escolher quando estiverem usando o campo.

Por exemplo, é possível limitar um campo para que os nomes de usuários possam ser selecionados somente se atenderem aos seguintes critérios:

• Eles pertencem a um ou mais grupos especificados por você
• Eles estão associados a uma função ou a um cargo especificado por você
• Eles pertencem ao mesmo grupo que a pessoa que está usando o campo

Você deve definir o filtro para o tipo de objeto selecionado usando a sintaxe do Modo de texto. Para obter informações sobre como criar um filtro usando o Modo Texto, consulte Editar um filtro usando o modo texto.

NOTA:

• Se você estiver editando um formulário personalizado existente, adicionar um filtro a um campo Digitação antecipada não removerá nenhum objeto (fora do escopo do filtro) que os usuários já tenham adicionado usando o campo.
• Este filtro não está disponível em dispositivos móveis. Se você usar o filtro para um campo Digitação antecipada, o campo aparecerá nos dispositivos móveis dos usuários não afetados pelo filtro.

• Typeahead

• Typeahead
• Data

(Obrigatório) Digite um rótulo descritivo para exibir acima do campo personalizado. Você pode alterar o rótulo a qualquer momento.

IMPORTANTE: Evite usar caracteres especiais neste rótulo. Eles não são exibidos corretamente nos relatórios. Para obter mais informações, consulte Notas sobre nomes e rótulos de campos.

(Obrigatório) Esse nome é a forma como o sistema identifica o campo. Quando você está configurando o widget pela primeira vez e digita o rótulo, o campo Nome é preenchido automaticamente para corresponder a ele. Mas os campos Label e Name não são sincronizados — isso dá a você a liberdade de alterar o rótulo que seus usuários veem sem precisar alterar o nome que o sistema vê.

Para obter mais informações, consulte Notas sobre nomes e rótulos de campos.

Selecione o tipo de dados que será capturado no campo personalizado.

NOTA:

• É possível alterar o tipo de formato depois que o formulário é salvo, com uma limitação: todos os valores existentes em objetos devem poder ser convertidos para o novo tipo. (Por exemplo, se o tipo de formato for Texto e um objeto estiver armazenando o valor "abc", você não poderá converter o campo e receberá um erro de que o sistema não poderá converter "abc" em número/moeda.) Se você pretende usar seu campo em cálculos matemáticos, certifique-se de selecionar um formato de Número ou Moeda.
• Ao selecionar Número ou Moeda, o sistema trunca automaticamente os números que começam com 0.
• O limite de caracteres para campos de Número é de 16. Você também pode usar um campo Texto para inserir números e evitar o limite.

Digite ou cole o URL da API.

O URL da API deve retornar um conteúdo JSON das opções que você deseja mostrar na lista suspensa. Você pode usar o campo Caminho JSON para selecionar os valores específicos das opções suspensas do JSON retornado.

Ao inserir o URL da API, você pode passar os seguintes valores no URL:

• $$HOST - representa o host atual do Workfront e pode ser usado para fazer chamadas de API /search para a API do Workfront. Quando esse curinga é usado, a autenticação é tratada e os usuários não precisam enviar cabeçalhos de autenticação. (Por exemplo, os usuários podem pesquisar tarefas usando a URL base $$HOST/attask/api/task/search e isso permitirá pesquisar tarefas e selecionar valores de uma lista de tarefas retornada.)

• $$QUERY - Representa o texto de pesquisa que o usuário final digita no campo e permite implementar a filtragem de consultas para seus usuários finais. (O usuário pesquisará pelo valor na lista suspensa.)

  Se a API à qual você está fazendo referência permitir, também será possível incluir modificadores na consulta de pesquisa para identificar como a pesquisa deve funcionar. Por exemplo, você pode usar o seguinte como a URL da API Base para permitir que as pessoas pesquisem por qualquer projeto do Workfront que contenha texto específico: $$HOST/attask/api/v15.0/proj/search?name=$$QUERY&name_Mod=contains.

  Saiba mais sobre os modificadores de pesquisa do Workfront em Noções básicas sobre API.

  OBSERVAÇÃO: se você não estiver usando o $$QUERY e o usuário digitar o texto na caixa de pesquisa, ele restringirá as opções que você já tem. No entanto, se você usar $$QUERY e o usuário digitar algo, uma nova chamada de rede para sua API será executada. Portanto, se você tiver mais de 2000 valores em sua API e a API for compatível com consultas, será possível utilizar o $$QUERY não apenas para pesquisar a partir dos valores de 2000 existentes, mas a partir da API original com as opções limitadas.

• {fieldName} - Onde fieldName é qualquer campo personalizado ou nativo no Workfront. Dessa forma, você pode implementar filtros de opção de lista suspensa em cascata ao passar o valor de um campo já selecionado para o campo de pesquisa Externo para filtrar opções. (Por exemplo, o campo Região já existe no formulário e você está restringindo uma lista de países da API para aqueles que estão em uma região específica.)

  Para um campo de pesquisa externo que tem uma dependência em outros campos (usando a sintaxe {fieldName}), as opções retornadas da API são limitadas àquelas que correspondem a qualquer cadeia de caracteres ou valor inserido em outros campos. (Essa funcionalidade não é compatível com listas e relatórios.)

• {referenceObject}.{fieldName} - Onde o campo faz parte de um objeto. Essa sintaxe é semelhante às expressões personalizadas. (Por exemplo, portfolioID={project}.{portfolioID})

OBSERVAÇÃO: revise a documentação da API com a qual você está trabalhando para as consultas específicas que você pode definir.

Digite ou cole o caminho JSON para a 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.

Por exemplo, se a URL da API retornar JSON neste formato:

   {
    dados: {
      { name: "USA"},
      { name: "Canada"}
    }
   }

em seguida, use "$.data[*].name" para selecionar EUA e Canadá como opções suspensas.

Para obter mais informações sobre o Caminho JSON e verificar se você grava o Caminho JSON correto, consulte https://jsonpath.com/.

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

OBSERVAÇÃO: os campos de Cabeçalho não são um local seguro para armazenar credenciais, e você deve ter cuidado com o que inseriu e salvou.

(Obrigatório) Digite um rótulo descritivo para exibir acima do widget. Você pode alterar o rótulo a qualquer momento.

IMPORTANTE: Evite usar caracteres especiais neste rótulo. Eles não são exibidos corretamente nos relatórios. Para obter mais informações, consulte Notas sobre nomes e rótulos de campos.

(Obrigatório) Esse nome é como o sistema identifica o widget. Quando você está configurando o widget pela primeira vez e digita o rótulo, o campo Nome é preenchido automaticamente para corresponder a ele. Mas os campos Label e Name não são sincronizados — isso dá a você a liberdade de alterar o rótulo que seus usuários veem sem precisar alterar o nome que o sistema vê.

Para obter mais informações, consulte Notas sobre nomes e rótulos de campos.

(Obrigatório) Digite ou cole o URL do widget onde ele está armazenado na Internet.

Se você estiver adicionando um widget de vídeo, é possível fazer isso adicionando o seguinte na caixa de URL:

• Link para o YouTube ou Vimeo

• Link de vídeo da Google Drive

• Link para vídeo com extensão MP4 e MOV

• Link para vídeo já carregado na área Documentos na sua instância do Workfront. Para obter instruções, consulte Adicionar um widget de vídeo a um formulário personalizado na área Documentos neste artigo.

(Obrigatório) Digite um rótulo descritivo para exibir acima do campo. Você pode alterar o rótulo a qualquer momento.

IMPORTANTE: Evite usar caracteres especiais neste rótulo. Eles não são exibidos corretamente nos relatórios. Para obter mais informações, consulte Notas sobre nomes e rótulos de campos.

(Obrigatório) Esse nome é a forma como o sistema identifica o campo. Ao configurar o campo pela primeira vez e digitar o rótulo, o campo Nome é preenchido automaticamente para corresponder a ele. Mas os campos Label e Name não são sincronizados — isso dá a você a liberdade de alterar o rótulo que seus usuários veem sem precisar alterar o nome que o sistema vê.

Para obter mais informações, consulte Notas sobre nomes e rótulos de campos.

(Obrigatório) Selecione um campo nativo do Workfront.

Somente campos nativos para os objetos do formulário estão disponíveis. Por exemplo, se a lista Tipos de objeto na parte superior do designer do formulário mostrar Projeto, você poderá selecionar campos nativos para projetos, mas não campos específicos para tarefas.

Adicione um filtro para o campo de referência para limitar a lista de itens que os usuários podem escolher quando estiverem usando o campo.

Por exemplo, é possível limitar um campo para que os nomes de usuários possam ser selecionados somente se atenderem aos seguintes critérios:

• Eles pertencem a um ou mais grupos especificados por você
• Eles estão associados a uma função ou a um cargo especificado por você
• Eles pertencem ao mesmo grupo que a pessoa que está usando o campo

Você deve definir o filtro para o campo de referência selecionado usando a sintaxe do Modo de texto. Para obter informações sobre como criar um filtro usando o Modo Texto, consulte Editar um filtro usando o modo texto.

NOTA:

• A opção de filtro só está disponível quando você faz referência a um campo de digitação antecipada nativo, como Portfolio, Empresa ou Proprietário.
• Se você estiver editando um formulário personalizado existente, adicionar um filtro a um campo nativo não removerá nenhum objeto (fora do escopo do filtro) que os usuários já tenham adicionado usando o campo.
• Este filtro não está disponível em dispositivos móveis. Se você usar o filtro para um campo nativo, o campo aparecerá nos dispositivos móveis dos usuários não afetados pelo filtro.

(Obrigatório) Digite um rótulo descritivo para exibir acima do widget. Você pode alterar o rótulo a qualquer momento.

IMPORTANTE: Evite usar caracteres especiais neste rótulo. Eles não são exibidos corretamente nos relatórios. Para obter mais informações, consulte Notas sobre nomes e rótulos de campos.

(Obrigatório) Esse nome é como o sistema identifica o widget. Quando você está configurando o widget pela primeira vez e digita o rótulo, o campo Nome é preenchido automaticamente para corresponder a ele. Mas os campos Label e Name não são sincronizados — isso dá a você a liberdade de alterar o rótulo que seus usuários veem sem precisar alterar o nome que o sistema vê.

Para obter mais informações, consulte Notas sobre nomes e rótulos de campos.

(Obrigatório) Digite ou cole um link de protótipo XD válido.

Observação: a configuração Acesso ao link na guia Compartilhar no Adobe XD deve ser definida como Qualquer pessoa com o link. Caso contrário, os usuários não poderão visualizar o protótipo.

(Obrigatório) Digite um rótulo descritivo para exibir acima do campo. Você pode alterar o rótulo a qualquer momento.

IMPORTANTE:

Evite usar caracteres especiais neste rótulo.

Recomendamos que você escolha um rótulo pelo qual possa identificar facilmente de onde vem o registro do Planning. Adicione informações como o nome do espaço de trabalho ou o nome do tipo de registro.

(Recomendado) Digite quaisquer informações adicionais sobre o campo. Quando os usuários preencherem o formulário personalizado, poderão passar o mouse sobre o ícone de ponto de interrogação para exibir uma dica de ferramenta contendo as informações digitadas aqui.

Aqui é possível adicionar informações explícitas sobre o registro e os objetos que você está conectando.

(Obrigatório) Selecione um tipo de objeto do Workfront que esteja conectado a um tipo de registro no Workfront Planning.

Você pode selecionar entre os seguintes tipos de objeto:

• Projeto
• Portfólio
• Programa
• Empresa
• Grupo

Somente os tipos de objeto do Workfront para os tipos de objeto do formulário estão disponíveis.

Por exemplo, se a lista Tipos de objeto na parte superior do designer de formulário mostrar Projeto, você só poderá selecionar Projeto nesse campo e não poderá selecionar Portfolio, embora os portfólios também possam ser conectados a tipos de registro.

(Obrigatório) Selecione o espaço de trabalho do Planning de onde vêm os registros que você deseja exibir no Workfront.

Somente os espaços de trabalho conectados aos tipos de objeto selecionados no campo Tipo de objeto são exibidos.

(Obrigatório) Selecione o tipo de registro do Workfront Planning que tem uma conexão com o tipo de objeto do Workfront.

Somente os tipos de registro que têm conexões com o tipo de objeto selecionado no campo Tipo de objeto são exibidos.

(Obrigatório) Selecione o campo de conexão entre o tipo de registro selecionado do Planning que você deseja exibir nos objetos do Workfront e o tipo de objeto do Workfront.

OBSERVAÇÃO

Você pode ter vários campos de conexão entre o mesmo objeto e tipos de registro, mas pode selecionar apenas um campo.