[Também se aplica ao v8]{class="badge positive" title="Também se aplica ao Campaign v8"}
Adicionar campos a um formulário web adding-fields-to-a-web-form
Em um formulário Web, os campos permitem que os usuários insiram informações e selecionem opções. Os formulários web podem oferecer campos de entrada, campos de seleção, conteúdo estático e avançado (captchas, subscrições, etc.).
Quando o assistente é utilizado para adicionar campos, o tipo de campo é detectado automaticamente com base no campo ou na variável de armazenamento selecionada. É possível editá-lo usando a caixa suspensa Type na guia General.
Ao usar os botões na barra de ferramentas, selecione o tipo de campo que deseja adicionar.
Os seguintes tipos de campo estão disponíveis:
- Entrada de texto/número. Consulte Adição de campos de entrada.
- Seleção da lista suspensa. Consulte Adição de listas suspensas.
- Múltipla escolha por meio de caixas de seleção. Consulte Adição de caixas de seleção.
- Seleção exclusiva por meio de botões de opção. Consulte Adição de botões de opção.
- Voto em uma grade de opções. Consulte Adição de grades.
- Números e datas. Consulte Adição de datas e números.
- Subscrição/cancelamento de subscrição de um serviço de informação. Consulte Caixas de seleção de subscrição.
- Validação de captcha. Consulte Inserir um captcha.
- Botão Download. Upload de arquivo.
- Constante oculta. Consulte Inserir uma constante oculta.
Especifique o modo de armazenamento de resposta: atualize um campo no banco de dados (armazena somente o último valor salvo) ou armazene em uma variável (a resposta não é armazenada). Para obter mais informações, consulte Campos de armazenamento de resposta.
Assistente de criação de campos field-creation-assistant
Para cada página do formulário, é possível adicionar um campo usando o primeiro botão da barra de ferramentas. Para fazer isso, acesse o menu Add using the assistant.
Selecione o tipo de campo que deseja criar: é possível escolher a inclusão de um campo no banco de dados, uma variável ou até importar um grupo de campos criado em outro formulário e coletado em um container.
Clique em Next e selecione o campo de armazenamento, a variável ou o container que deseja importar.
Clique em Finish para inserir o campo selecionado na página.
Adição de campos de entrada adding-input-fields
Para adicionar um campo de entrada, clique no botão Input control e escolha o tipo de campo que deseja adicionar.
Tipos de campos de entrada types-of-input-fields
Há cinco tipos diferentes de campos de texto que podem ser inseridos em uma página de formulário:
-
Text: permite que o usuário insira um texto em uma linha.
-
Number: permite que o usuário insira um texto em uma linha. Para obter mais informações, consulte Adicionar números.
Quando a página é aprovada, o conteúdo é verificado para garantir que o valor inserido seja compatível com o campo. Para obter mais informações, consulte Definir configurações de controle.
-
Password: permite que o usuário insira texto em uma única linha. Durante a inserção de texto, os caracteres são substituídos por pontos:
note caution CAUTION As senhas são armazenadas de forma não criptografada no banco de dados. -
Multi-line text: permite que o usuário insira texto em várias linhas.
note caution CAUTION Campos de texto multilinha são campos específicos que podem conter código de fim de linha. O espaço de armazenamento deve estar associado a um campo mapeado em um elemento XML, não em um atributo XML. -
Enriched multi-line text: permite que o usuário insira texto com um layout que será armazenado em formato HTML.
É possível selecionar o tipo de editor oferecido aos usuários. Para fazer isso, use a caixa suspensa do campo HTML editor na guia Advanced.
O número de ícones exibidos varia dependendo do tipo de editor. Para um editor Advanced, a renderização será a seguinte:
Configurar campos de entrada configure-input-fields
Todos os campos de entrada são configurados com base no mesmo modo, utilizando as seguintes opções:
A guia General permite inserir o nome do campo e atribuir um valor padrão, se necessário.
O modo de armazenamento de resposta pode ser alterado por meio do link Edit storage…. Os valores podem ser armazenados em um campo existente do banco de dados; ou você pode escolher não salvar informações no banco de dados (use uma variável local).
A guia Advanced permite definir parâmetros de exibição para o campo (posição dos rótulos, alinhamento, etc.). Consulte Definição do layout de formulários Web.
Adição de listas suspensas adding-drop-down-lists
É possível inserir uma lista suspensa em uma página de pesquisa. Isso permite que o usuário selecione um valor com base na oferta em um menu suspenso.
Para adicionar uma caixa suspensa a uma página de formulário, clique no botão Selection controls > Drop-down list na barra de ferramentas do editor de páginas.
Selecione o modo de armazenamento de resposta e confirme sua escolha.
Defina os rótulos e os valores da lista na seção inferior da guia General. Se as informações forem armazenadas em um campo existente do banco de dados e esse for um campo de lista discriminada, é possível preencher os valores automaticamente clicando em Initialize the list of values from the database, conforme mostrado abaixo:
Se os dados estiverem armazenados em uma tabela vinculada, você poderá selecionar o campo onde os valores a serem sugeridos na lista serão salvos. Por exemplo, se a tabela de países estiver selecionada, clique em Initialize the list of values from the database… e selecione o campo desejado.
Em seguida, clique no link Load para recuperar os valores:
Adição de caixas de seleção adding-checkboxes
Para selecionar uma opção, o usuário precisa usar uma caixa de seleção.
Para adicionar uma caixa de seleção a um formulário, clique no ícone Selection controls > Checkbox… na barra de ferramentas do editor de páginas.
Selecione o modo de armazenamento de resposta e confirme sua escolha.
Insira o rótulo da caixa no campo Label da guia General.
Uma caixa de seleção permite atribuir um valor ao campo de armazenamento (ou valor) dependendo se a caixa estiver ou não marcada. A seção Values permite inserir o valor a ser atribuído se a caixa estiver marcada (no campo Value) e o valor a ser atribuído se não estiver marcado (no campo Empty value). Esses valores dependem do formato de armazenamento de dados.
Se o campo de armazenamento (ou variável) for booliano, o valor a ser atribuído se a caixa não estiver marcada será deduzido automaticamente. Nesse caso, somente o campo Value if checked é oferecido, conforme mostrado abaixo:
Exemplo: atribuição de um valor a um campo, se uma caixa estiver marcada example--assign-a-value-to-a-field-if-a-box-is-checked
Queremos inserir uma caixa de seleção em um formulário para enviar uma solicitação de manutenção, conforme mostrado abaixo:
As informações serão carregadas no banco de dados e em um campo existente (neste caso, o campo Comment):
Se a caixa "Maintenance required" estiver marcada, a coluna Comment conterá "Maintenance required". Se a caixa não estiver marcada, a coluna exibirá "Manutenção não necessária". Para obter esse resultado, aplique a seguinte configuração à caixa de seleção na página do formulário:
Adição de botões de opção adding-radio-buttons
Os botões de opção permitem oferecer uma série de opções exclusivas aos usuários. Esses são valores diferentes para o mesmo campo.
Você pode criar botões de opção individualmente (botões unitários) ou por uma lista de múltipla escolha. Mas como o objetivo dos botões de opção é selecionar uma opção ou outra, sempre criaremos pelo menos um par de botões de opção, nunca apenas um único botão.
Adição de botões únicos add-single-buttons
Para adicionar um botão de opção a uma página de formulário, vá para o menu Selection controls > Radio button na barra de ferramentas do editor de páginas e escolha um modo de armazenamento.
A configuração dos botões de opção é semelhante a das caixas de seleção (consulte Adição de caixas de seleção). No entanto, nenhum valor será atribuído se a opção não estiver selecionada. Para que vários botões sejam interdependentes, ou seja, a seleção de um desmarca o outro automaticamente, eles devem ser armazenados no mesmo campo. Se eles não estiverem armazenados no banco de dados, a mesma variável local deverá ser usada para o armazenamento temporário. Consulte Campos de armazenamento de resposta.
Adição de uma lista de botões add-a-list-of-buttons
Para adicionar botões de opção por meio de uma lista, vá para o menu Selection controls>Multiple choice na barra de ferramentas do editor de páginas.
Adicione a mesma quantidade de botões de opção que houver de rótulos. A vantagem desse recurso é que você pode importar valores de um campo existente (caso de um campo discriminado) e fazer com que o usuário escolha uma opção. No entanto, o layout dos botões é menos flexível.
No entanto, é possível inserir um campo do tipo Multiple choice em um aplicativo Web, mas isso não permitirá que o usuário selecione vários valores.
Adição de grades adding-grids
As grades são usadas para criar páginas de votação em aplicações Web. Isso permite oferecer listas de botões de opção para responder pesquisas ou formulários Web do tipo avaliação, conforme mostrado abaixo:
Para usar esse tipo de elemento em um formulário, crie uma grade simples e adicione uma linha para cada elemento a ser avaliado.
O número de botões de opção em cada linha da grade corresponde ao número de valores definidos na grade simples.
Somente uma opção pode ser selecionada por linha de grade.
Adição de datas e números adding-dates-and-numbers
O conteúdo dos campos de formulário pode ser formatado para corresponder aos dados armazenados no banco de dados ou para atender a um requisito específico. Você pode criar campos adequados para a entrada de números e datas.
Adição de datas adding-dates
Para permitir que o usuário insira uma data em uma página de formulário, adicione um campo de entrada e selecione o tipo Date….
Insira um rótulo para o campo e configure o modo de armazenamento de dados.
A seção inferior da janela permite selecionar os formatos de data e hora dos valores armazenados neste campo.
Você também pode escolher não exibir a data (ou hora).
As datas podem ser selecionadas por meio de um calendário ou caixas suspensas. Você também pode inseri-las diretamente no campo, mas eles precisam corresponder ao formato especificado na tela acima.
No entanto, em alguns casos (para inserir datas de nascimento, por exemplo), pode ser mais fácil usar listas suspensas.
Para fazer isso, clique na guia Advanced e escolha o modo de entrada usando Drop-down lists.
Você pode então definir limites para os valores oferecidos na lista.
Adição de números adding-numbers
Você pode criar campos adequados para a entrada de números.
Em um campo numérico, o usuário pode inserir somente números. O controle de entrada é aplicado automaticamente quando a página é aprovada.
Dependendo do campo no qual os dados são armazenados no banco de dados, a formatação especial ou certas restrições podem ser aplicadas. Também é possível especificar valores máximos e mínimos. Esse tipo de campo é configurado da seguinte maneira:
O valor padrão é o valor exibido no campo quando o formulário é publicado. Ele pode ser corrigido pelo usuário.
Você pode adicionar um prefixo e/ou sufixo ao campo numérico por meio da guia Advanced, conforme mostrado abaixo:
No formulário, a renderização será conforme a seguir:
Caixas de seleção de subscrição subscription-checkboxes
Você pode adicionar controles para permitir que os usuários realizaem a subscrição ou unsubscription de um ou mais serviços de informação (boletins informativos, avisos, notificações em tempo real, etc.). Para se subscrever, o usuário marca o serviço correspondente.
Para criar uma caixa de seleção de subscrição, clique em Advanced controls>Subscription.
Indique o rótulo da caixa de seleção e selecione o serviço de informação em questão, usando a caixa suspensa Service.
O usuário se subscreve no serviço marcando a opção relevante.
Inserção de um captcha inserting-a-captcha
O objetivo dos testes de captcha é evitar o uso fraudulento dos formulários web.
Para inserir um Captcha em um formulário, clique no primeiro botão na barra de ferramentas e selecione Advanced controls>Captcha.
Insira o rótulo do campo. Esse rótulo será exibido na frente da área de exibição Captcha. Você pode alterar a posição desse rótulo na guia Advanced.
O Captcha é inserido na página com um campo de entrada posicionado sob o visual. Esses dois elementos são inseparáveis e considerados como um único item para o propósito do layout da página (eles ocupam uma única célula).
Quando a página é confirmada, o campo de entrada é exibido em vermelho se o conteúdo do Captcha não foi inserido corretamente.
Você pode criar uma mensagem de erro para exibir. Para fazer isso, use o link Personalize the message na guia General.
Fazer upload de arquivo uploading-a-file
Você pode adicionar um campo de carregamento a uma página. Essa funcionalidade pode ser útil para o compartilhamento de arquivos da intranet, por exemplo.
Para inserir um campo para fazer upload em uma página de formulário, selecione o menu Advanced controls > File… na barra de ferramentas do editor de páginas.
Por padrão, os arquivos carregados são armazenados em arquivos de recurso acessíveis por meio do menu Resources > Online > Public resources. Você pode usar um script para alterar esse comportamento. Esse script pode usar as funções definidas na documentação do Campaign JSAPI, incluindo as que se referem à manipulação de arquivos.
Você pode armazenar o link para esses arquivos em uma variável local ou em um campo de banco de dados. Por exemplo, você pode estender o schema de destinatários para adicionar um link a recursos baseados em arquivo.
- Esse tipo de arquivo deve ser reservado para formulários com acesso seguro (usando credenciais).
- O Adobe Campaign não controla o tamanho ou o tipo de recurso carregado: portanto, é altamente recomendável usar campos de carregamento para sites de intranet tipo seguro.
- Se vários servidores estiverem vinculados à instância ("balanceamento de carga"), você precisará verificar se as chamadas para o formulário web chegam no mesmo servidor.
- Essas implementações exigem a assistência da equipe de consulta do Adobe Campaign.
Inserção de uma constante oculta inserting-a-hidden-constant
Quando o usuário valida uma das páginas do formulário, é possível definir um valor específico para um campo desse perfil ou para uma variável.
Este campo não está visível para o usuário, mas pode ser utilizado para enriquecer os dados no perfil de usuário.
Para fazer isso, coloque uma constante na página e especifique o valor e o local de armazenamento.
No exemplo a seguir, o arquivo de origem do perfil do destinatário é preenchido automaticamente sempre que um usuário aprova essa página. A constante não é exibida na página.