Criar um formulário personalizado

• Texto de linha única
• Parágrafo
• Rich text
• 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, pois 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
• Rich text
• Texto com formatação

(Obrigatório) Esse nome é a maneira 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. Os campos Rótulo e Nome não são sincronizados. Isso oferece a opção de alterar o rótulo que os 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
• Rich text
• Texto com formatação
• Texto descritivo

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

Selecione o tipo de dados que serão captados no campo personalizado.

Observação:

• Esse campo não pode ser editado depois que o formulário for salvo. Se você pretende usar o 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 de texto para inserir números e evitar o limite.

• Texto de linha única
• Parágrafo

Selecione o tipo de permissão financeira que os usuários devem ter para exibir ou editar este campo personalizado. O formato Moeda deve ser selecionado.

• Nenhuma permissão necessária: todos os usuários podem ver este campo

• Geral: os usuários devem ter permissões para editar ou exibir Finanças Gerais

• Cobrança: Os usuários devem ter permissões para editar ou exibir taxas de cobrança

• Custo: Os usuários devem ter permissões para editar ou exibir taxas de custo

Para obter mais informações, consulte Restringir o acesso aos dados financeiros em campos personalizados.

• Texto de linha única
• Parágrafo

• Texto de linha única
• Parágrafo

• Texto descritivo

Essa opção está desabilitada por padrão.

Quando você define um campo como Inativo, ele é excluído de relatórios, filtros e visualizações, e não está mais disponível na biblioteca de campos dos formulários personalizados.

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

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

(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, pois 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 opção
• Grupo de caixas de seleção
• Menu suspenso de seleção única
• Menu suspenso de seleção múltipla

(Obrigatório) Esse nome é a maneira 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. Os campos Rótulo e Nome não são sincronizados. Isso oferece a opção de alterar o rótulo que os 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 opção
• Grupo de caixas de seleção
• Menu suspenso de seleção única
• Menu suspenso de 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 opção
• Grupo de caixas de seleção
• Menu suspenso de seleção única
• Menu suspenso de seleção múltipla

Selecione o tipo de dados que serão captados no campo personalizado.

Observação:

• Esse campo não pode ser editado depois que o formulário for salvo. Se você pretende usar o 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 de texto para inserir números e evitar o limite.

• Botões de opção
• Grupo de caixas de seleção
• Menu suspenso de seleção única
• Menu suspenso de seleção múltipla

Selecione o tipo de permissão financeira que os usuários devem ter para exibir ou editar este campo personalizado. O formato Moeda deve ser selecionado.

• Nenhuma permissão necessária: todos os usuários podem ver este campo

• Geral: os usuários devem ter permissões para editar ou exibir Finanças Gerais

• Cobrança: Os usuários devem ter permissões para editar ou exibir taxas de cobrança

• Custo: Os usuários devem ter permissões para editar ou exibir taxas de custo

Para obter mais informações, consulte Restringir o acesso aos dados financeiros em campos personalizados.

• Botões de opção
• Grupo de caixas de seleção
• Menu suspenso de seleção única
• Menu suspenso de seleção múltipla

• Botões de opção
• Grupo de caixas de seleção
• Menu suspenso de seleção única
• Menu suspenso de seleção múltipla

Selecione qualquer uma das seguintes opções:

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

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

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

• Ocultar escolha: oculta a escolha no campo. As escolhas ocultas permanecem acessíveis nos relatórios.

• Remover escolha: remova a escolha do campo.

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

Observação: não há limite para a quantidade de opções que você pode selecionar.

• Botões de opção
• Grupo de caixas de seleção
• Menu suspenso de seleção única
• Menu suspenso de seleção múltipla

Essa opção está desabilitada por padrão.

Quando você define um campo como Inativo, ele é excluído de relatórios, filtros e visualizações, e não está mais disponível na biblioteca de campos dos formulários personalizados.

• Botões de opção
• Grupo de caixas de seleção
• Menu suspenso de seleção única
• Menu suspenso de seleção múltipla

• Botões de opção
• Grupo de caixas de seleção
• Menu suspenso de seleção única
• Menu suspenso de 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, pois eles não são exibidos corretamente nos relatórios. Para obter mais informações, consulte Notas sobre nomes e rótulos de campos.

• Preenchimento automático
• Data

(Obrigatório) Esse nome é a maneira 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. Os campos Rótulo e Nome não são sincronizados. Isso oferece a opção de alterar o rótulo que os 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.

• Preenchimento automático
• 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.

• Preenchimento automático
• Data

• Data

Selecione o tipo de objeto que deseja associar ao campo.

Depois de clicar em Aplicar ou Salvar e fechar, você não poderá alterar o tipo de objeto do campo.

Observação:

• Se o administrador do Workfront personalizou o nome de Portfólios, Programas ou Projetos na interface do usuário do Workfront, o nome padrão do Workfront para o objeto aparecerá nesse menu suspenso, e não o nome personalizado. Consulte o administrador do Workfront se precisar de ajuda com isso.
• Os seguintes tipos de objeto são aceitos nos aplicativos móveis do Workfront para iOS e Android: Usuário, Empresa, Grupo, Função no trabalho, Portfólio, Programa, Projeto e Modelo.

• Preenchimento automático

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ário possam ser selecionados somente se atenderem aos seguintes critérios:

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

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

Dica: você pode criar um relatório para testar o filtro antes de adicioná-lo diretamente ao campo de preenchimento automático. Isso ajudará a verificar se o filtro retorna os objetos corretos. Em seguida, você pode alternar para o modo de texto no relatório, copiar a instrução do modo de texto e adicioná-la ao filtro de preenchimento automático.

Observação:

• Se você estiver editando um formulário personalizado, adicionar um filtro a um campo de preenchimento automático não remove nenhum objeto (fora do escopo do filtro) que os usuários já tenham adicionado usando o campo.
• Esse filtro não está disponível em dispositivos móveis. Se você usar o filtro para um campo de preenchimento automático, o campo aparecerá nos dispositivos móveis dos usuários sem ser afetado pelo filtro.

• Preenchimento automático

Essa opção está desabilitada por padrão.

Quando você define um campo como Inativo, ele é excluído de relatórios, filtros e visualizações, e não está mais disponível na biblioteca de campos dos formulários personalizados.

• Preenchimento automático
• Data

• Preenchimento automático
• 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, pois eles não são exibidos corretamente nos relatórios. Para obter mais informações, consulte Observações sobre nomes e rótulos de campos.

(Obrigatório) Esse nome é a maneira 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. Porém, os campos Rótulo e Nome não são sincronizados — isso oferece a opção de alterar o rótulo que os 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ão captados no campo personalizado.

Observação:

• Você pode alterar o tipo de formato depois que o formulário for salvo, com uma limitação: todos os valores existentes nos 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 informando que o sistema não pode converter "abc" para número/moeda). Se você pretende usar o 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 de texto para inserir números e evitar o limite.

Selecione o tipo de permissão financeira que os usuários devem ter para exibir ou editar este campo personalizado. O formato Moeda deve ser selecionado.

• Nenhuma permissão necessária: todos os usuários podem ver este campo

• Geral: os usuários devem ter permissões para editar ou exibir Finanças Gerais

• Cobrança: Os usuários devem ter permissões para editar ou exibir taxas de cobrança

• Custo: Os usuários devem ter permissões para editar ou exibir taxas de custo

Para obter mais informações, consulte Restringir o acesso aos dados financeiros em campos personalizados.

Digite ou cole o URL da API.

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

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/pesquisar chamadas de API 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 o URL base $$HOST/attask/api/task/search que 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á o valor na lista suspensa).

  Se a API que você está referenciando permitir, você também pode incluir modificadores em sua consulta de pesquisa para identificar como a pesquisa deve funcionar. Por exemplo, você pode usar o seguinte como URL base da API para permitir que as pessoas pesquisem qualquer projeto do Workfront que contenha um 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 $$QUERY e o usuário digitar um texto na caixa de pesquisa, as opções existentes serão reduzidas. No entanto, se você usar $$QUERY e o usuário digitar algo, uma nova chamada de rede para a API será executada. Portanto, se você tiver mais de 2000 valores em sua API e a API aceitar consultas, você poderá usar $$QUERY para pesquisar não apenas nos 2000 valores existentes, mas também na API original com as opções reduzidas.

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

  Para um campo de pesquisa externa que tem dependência de outros campos (usando a sintaxe {fieldName}), as opções retornadas da API são limitadas àquelas que correspondem a quaisquer strings ou valores inseridos nos outros campos. (Essa funcionalidade não é suportada em 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})

Dica: revise a documentação da API com a qual você está trabalhando para ver 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 de lista suspensa.

Por exemplo, se o URL da API retornar JSON no seguinte formato, você poderá usar “$.data[*].name” para selecionar EUA e Canadá como opções de lista suspensa:

   {
    data: {
      { name: "EUA"},
      { name: "Canadá"}
    }
   }

Para obter mais informações sobre o caminho JSON e garantir que você o escreva corretamente, consulte https://jsonpath.com/.

Clique em Adicionar cabeçalho e digite ou cole o par de valores chave exigido para autenticação com a API.

Nota: os campos de Cabeçalho não são um local seguro para armazenar credenciais, portanto tenha cuidado com o que inserir e salvar.

Essa opção está desabilitada por padrão.

Quando você define um campo como Inativo, ele é excluído de relatórios, filtros e visualizações, e não está mais disponível na biblioteca de campos dos formulários personalizados.

(Exigido) 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, pois eles não são exibidos corretamente nos relatórios. Para obter mais informações, consulte Observações sobre nomes e rótulos de campos.

(Exigido) Esse nome é a maneira 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. Os campos Rótulo e Nome não são sincronizados. Isso oferece a opção de alterar o rótulo que os usuários veem sem precisar alterar o nome que o sistema vê.

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

(Exigido) 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 do Google Drive

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

• Link para o 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 a partir da área Documentos neste artigo.

Essa opção está desabilitada por padrão.

Quando você define um campo como Inativo, ele é excluído de relatórios, filtros e visualizações, e não está mais disponível na biblioteca de campos dos formulários personalizados.

(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, pois eles não são exibidos corretamente nos relatórios. Para obter mais informações, consulte Observações sobre nomes e rótulos de campos.

(Obrigatório) Esse nome é a maneira 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. Os campos Rótulo e Nome não são sincronizados. Isso oferece a opção de alterar o rótulo que os usuários veem sem precisar alterar o nome que o sistema vê.

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

(Exigido) Selecione um campo nativo do Workfront.

Só estão disponíveis campos nativos para os objetos do formulário. 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ário possam ser selecionados somente se atenderem aos seguintes critérios:

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

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

Observação:

• A opção de filtro só está disponível quando você referencia um campo nativo de preenchimento automático, como Portfólio, 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.
• Esse 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 sem ser afetado pelo filtro.

Essa opção está desabilitada por padrão.

Quando você define um campo como Inativo, ele é excluído de relatórios, filtros e visualizações, e não está mais disponível na biblioteca de campos dos formulários personalizados.

(Exigido) 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, pois eles não são exibidos corretamente nos relatórios. Para obter mais informações, consulte Observações sobre nomes e rótulos de campos.

(Exigido) Esse nome é a maneira 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. Os campos Rótulo e Nome não são sincronizados. Isso oferece a opção de alterar o rótulo que os usuários veem sem precisar alterar o nome que o sistema vê.

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

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

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

Essa opção está desabilitada por padrão.

Quando você define um campo como Inativo, ele é excluído de relatórios, filtros e visualizações, e não está mais disponível na biblioteca de campos dos formulários personalizados.

(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 que ajude a identificar facilmente de onde vem o registro do Planejamento. 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, você pode adicionar informações detalhadas 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 Planejamento do Workfront.

Você pode selecionar entre os seguintes tipos de objeto:

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

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

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

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

Apenas 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 Planejamento do Workfront que possui 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 do Planejamento selecionado, 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 os mesmos tipos de registro, mas pode selecionar apenas um campo.

(Opcional) Selecione até 7 campos de pesquisa do tipo de registro conectado para exibir no formulário personalizado. O campo principal é selecionado por padrão e não pode ser editado.

Os campos do registro conectado que você selecionar são exibidos em uma visualização de tabela no formulário personalizado. Quando o formulário é anexado a um objeto do Workfront, a visualização de tabela é somente leitura.

Essa opção está desabilitada por padrão.

Quando você define um campo como Inativo, ele é excluído de relatórios, filtros e visualizações, e não está mais disponível na biblioteca de campos dos formulários personalizados.