Criar formulários personalizados
Observação
A ação Exibir formulário personalizado é baseada na tecnologia de Cartões Adaptáveis. Consulte esta página para obter mais informações sobre Cartões Adaptáveis.
As caixas de mensagens permitem que você solicite aos usuários que insiram várias entradas, como texto, datas e arquivos ou exibam informações e resultados na tela.
Embora a maioria das ações desse grupo possa lidar com cenários em que uma única entrada é necessária, algumas automações podem exigir uma combinação de entradas e/ou saídas. A melhor abordagem para lidar com esses cenários é a ação Exibir formulário personalizado.
Para criar um formulário personalizado, implante a ação Exibir formulário personalizado e selecione o botão Designer de formulários personalizados para abrir o designer de formulários.
No lado esquerdo do designer, há uma lista com todos os elementos de entrada disponíveis que você pode adicionar ao formulário, como entrada de texto, data e arquivo e alguns elementos não interativos, como textos e imagens.
Para adicionar um elemento ao formulário personalizado, clique duas vezes nele ou arraste e solte-o no espaço de trabalho do designer. Use o painel de pré-visualização na parte inferior do designer de formulários para ver como o formulário configurado ficará durante o tempo de execução.
Depois de adicionar um elemento, você pode lidar com todas as propriedades disponíveis no lado direito do designer de formulários. As propriedades disponíveis podem diferir dependendo da natureza do elemento selecionado.
Observação
Além dos elementos do formulário, o designer de formulários fornece algumas propriedades para configurar a aparência da caixa de diálogo pai do formulário personalizado. Para configurá-las, selecione um espaço vazio no espaço de trabalho e veja as propriedades disponíveis no respectivo painel.
Quando um usuário preenche um formulário personalizado, os dados fornecidos são armazenados na variável de objeto personalizado CustomFormData. Para acessar o valor de um elemento de entrada específico armazenado no objeto personalizado, use a seguinte notação: %CustomFormData['ElementID']%.
Importante
A ID de cada elemento deve ser exclusiva e não pode estar vazia. Além disso, deve começar com uma letra e pode conter letras latinas, números e espaços. Não é possível usar variáveis em campos de ID. Se uma ID inválida for fornecida, a última ID válida usada será restaurada automaticamente após fechar e salvar o designer de formulários.
Observação
Você pode encontrar mais informações sobre objetos personalizados e como lidar com eles em Tipos de dados avançados.
Além dos elementos de entrada e não interativos, o designer de formulários fornece algumas ações para implementar funcionalidades adicionais nos formulários.
Considere as ações como botões que permitem executar diferentes funções com base em qual botão foi pressionado. Por exemplo, use uma ação Enviar como um botão salvar para coletar e armazenar os dados do usuário fornecidos para uso posterior no fluxo.
Observação
As ações podem ser adicionadas apenas no final da estrutura do formulário, após qualquer outro tipo de elemento do formulário.
Assim como os outros elementos, cada ação tem uma ID que a descreve de forma exclusiva. Quando uma ação é selecionada, a ID é armazenada na variável ButtonPressed.
Quando um formulário contém várias ações, use esta variável e as condicionais para verificar qual delas está pressionada e implementar funcionalidades diferentes para cada cenário. Para obter mais informações sobre como implementar esse comportamento, consulte Manipular formulários personalizados.
A captura de tela a seguir mostra a aparência do formulário personalizado configurado anteriormente quando o fluxo é executado.
Personalizar elementos de formulário
| Nome do elemento | Tipo | Especificações | Propriedades de layout | Propriedades de validação | Propriedades de estilo | Imagem em segundo plano |
|---|---|---|---|---|---|---|
| Formulário personalizado | Caixa de diálogo pai | Título | Altura mínima em pixels, alinhamento vertical de conteúdo | URL, modo de preenchimento, alinhamento horizontal, alinhamento vertical | ||
| Entrada de texto | Entrada | ID, rótulo, valor padrão, multilinhas, estilo, comprimento máximo | Espaçamento, separador, altura | Validação necessária, mensagem de erro, padrão | ||
| Entrada de número | Entrada | ID, rótulo, valor padrão, valor mínimo, valor máximo | Espaçamento, separador, altura | Validação necessária, mensagem de erro | ||
| Entrada de data | Entrada | ID, rótulo, valor padrão, valor mínimo, valor máximo | Espaçamento, separador, altura | Validação necessária, mensagem de erro | ||
| Entrada de hora | Entrada | ID, rótulo, valor padrão, valor mínimo, valor máximo | Espaçamento, separador, altura | Validação necessária, mensagem de erro | ||
| Alternar entrada | Entrada | ID, rótulo, título, valor padrão, valor quando ativado, valor quando desativado | Espaçamento, separador, disposição de altura | Validação necessária, mensagem de erro | ||
| Entrada do conjunto de opções | Entrada | ID, rótulo, valor padrão, permitir seleção múltipla, estilo, opções | Espaçamento, separador, altura, quebra de linha | Validação necessária, mensagem de erro | ||
| Entrada de arquivo | Entrada | ID, rótulo, valor padrão | Espaçamento, separador, altura | Validação necessária, mensagem de erro | ||
| Bloco de texto | Elemento | ID, texto | Espaçamento, separador, alinhamento horizontal, altura, quebra de linha, linhas máximas, largura máxima | Tipo de fonte, tamanho, peso, cor, sutil, itálico, tachado | ||
| Imagem | Elemento | ID, URL, texto alternativo | Espaçamento, separador, alinhamento horizontal, altura, altura em pixels, largura em pixels, tamanho | Estilo, cor em segundo plano | ||
| Enviar | Ação | ID, título, Ignorar entradas fornecidas | ||||
| Abrir URL | Ação | ID, título, URL |
Propriedades do elemento de formulário personalizado
| Nome da propriedade | Opcional | Aceitações | Padrão | Descrição |
|---|---|---|---|---|
| Permitir várias seleções | N/A | Valor booliano | Falso | Permite que várias opções sejam selecionadas |
| Texto alternativo | Sim | Valor do texto | Texto alternativo que descreve a imagem | |
| Cor em segundo plano | Sim | Valor do texto | Aplica um plano de fundo a uma imagem transparente. Esta propriedade respeitará o estilo da imagem. Somente valores hexadecimais são aceitáveis nesta propriedade | |
| Opções | Sim | Título e valor | Descreve as opções para uso no conjunto de opções. Consiste em um título (texto a ser exibido) e um valor (valor bruto para a opção) | |
| Cor | N/A | Padrão, escuro, luz, acento, bom, aviso, atenção | Padrão | Controla a cor do texto |
| Valor padrão | Sim | Valor do texto, valor numérico | O valor padrão do elemento de entrada | |
| Mensagem de erro | Sim | Valor do texto | A mensagem de erro que deve ser exibida quando a entrada inserida não é válida | |
| Modo de preenchimento | N/A | Cobrir, repetir na horizontal, repetir na vertical, repetir | Descreve como a imagem deve preencher a área | |
| Tipo de fonte | N/A | Padrão, espaçamento uniforme | Padrão | Tipo de fonte a ser usada na renderização |
| Altura | N/A | Automático, alongar, pixels | Automático | Especifica a altura do elemento. A opção 'Pixels' está disponível apenas para elementos de imagem |
| Altura em pixels | Não | Valor numérico | 0 | Especifica a altura desejada da imagem. A imagem será distorcida para caber nessa altura exata. Isso substitui a propriedade "Tamanho". O valor padrão de 0 determina que nenhuma altura específica é especificada |
| Alinhamento horizontal | N/A | Esquerda, centro, direita | Bloco de texto: esquerda Imagem: esquerda |
Controla como este elemento é posicionado horizontalmente. Para formulários personalizados, descreve como a imagem em segundo plano deve ser alinhada se for cortada ou se estiver usando o modo de preenchimento repetido |
| ID | Não | Valor do texto | Depende do elemento | Identificador exclusivo do valor. Usado para identificar a entrada coletada quando a ação Enviar é executada. Se uma ID inválida for temporariamente usada e o designer de formulários estiver fechado, a última ID válida usada se aplicará |
| Ignorar entradas fornecidas | N/A | Valor booliano | Falso | Se habilitada, esta ação fecha o formulário sem armazenar as entradas selecionadas, funcionando como um botão Cancelar |
| Itálico | N/A | Valor booliano | Falso | Se habilitado, deixa o texto em itálico |
| Rótulo | Sim | Valor do texto | Rótulo para esta entrada | |
| Comprimento máximo | Não | Valor numérico | 0 | Especifica o número máximo de caracteres a serem coletados. O valor padrão de 0 determina que nenhum comprimento máximo é especificado |
| Máximo de linhas | Não | Valor numérico | 0 | Especifica o número máximo de linhas a serem exibidas. O valor padrão de 0 determina que nenhuma linha máxima seja especificada |
| Valor máximo | Sim | Valor do texto | Dica de valor máximo. Para entradas de data e hora, o valor deve ser expresso no formato regional do computador | |
| Largura máxima | Não | Valor numérico | 0 | Especifica a largura máxima do bloco de texto em pixels. O valor padrão de 0 determina que nenhuma largura máxima é especificada |
| Altura mínima em pixels | Não | Valor numérico | 0 | Especifica a altura mínima do formulário. O valor padrão de 0 determina que nenhuma altura mínima é especificada |
| Valor mínimo | Sim | Valor do texto | Dica de valor mínimo. Para entradas de data e hora, o valor deve ser expresso no formato regional do computador | |
| Várias linhas | N/A | Valor booliano | Falso | Se habilitado, permite várias linhas de entrada |
| Padrão | Sim | Valor do texto | Expressão regular indicando o formato necessário desta entrada de texto | |
| Separador | N/A | Valor booliano | Falso | Quando habilitado, traça uma linha de separação na parte superior do elemento |
| Tamanho | N/A | Bloco de texto: padrão, pequeno, médio, grande, extra grande Imagem: automático, alongar, pequeno, médio, grande |
Bloco de texto: padrão Imagem: automático |
Controla o tamanho do texto ou da imagem |
| Espaçamento | N/A | Padrão, nenhum, pequeno, médio, grande, extra grande, preenchimento | Padrão | Controla a quantidade de espaçamento entre este elemento e o elemento anterior |
| Tachado | N/A | Valor booliano | Falso | Se habilitado, cruza o texto |
| Estilo | N/A | Entrada de texto: texto, tel, URL, email Entrada do conjunto de opções: compacto, expandido Imagem: padrão, pessoa |
Entrada de texto: texto Entrada do conjunto de opções: compacto Imagem: padrão |
O estilo da dica de texto, conjunto de opções ou imagem |
| Sutil | N/A | Valor booliano | Falso | Se habilitado, exibe o texto ligeiramente esmaecido para parecer menos proeminente |
| Texto | Sim | Valor do texto | Novo bloco de texto | Texto a ser exibido |
| Título | Sim | Valor do texto | Alternar entrada: nova entrada de alternância Enviar: OK |
Título para o formulário personalizado ou a alternância ou o rótulo para o botão que representa esta ação |
| URL | Sim | Valor do texto | A URL da imagem (para elemento de imagem e formulário personalizado) ou a URL a ser aberta (para ação Abrir URL) | |
| Validação necessária | Sim | Valor booliano | Falso | Determina se esta entrada é necessária ou não |
| Valor quando desativado | Sim | Valor do texto | Falso | O valor quando o botão de alternância está desativado |
| Valor quando ativado | Sim | Valor do texto | Verdadeiro | O valor quando o botão de alternância está ativado |
| Alinhamento vertical | N/A | Superior, centro, inferior | Descreve como a imagem deve ser alinhada, se ela deve ser cortada ou se está usando o modo de preenchimento repetido | |
| Alinhamento do conteúdo vertical | N/A | Superior, centro, inferior | Superior | Define como o conteúdo deve ser alinhado verticalmente dentro do contêiner. Relevante apenas para formulários de altura fixa ou formulários com altura mínima especificada |
| Peso | N/A | Padrão, mais claro, mais escuro | Padrão | Controla o peso do texto |
| Largura em pixels | Não | Valor numérico | 0 | A largura desejada na tela da imagem. Isso substitui a propriedade "Tamanho". O valor padrão de 0 determina que nenhuma largura específica é especificada |
| Quebra de linha | N/A | Valor booliano | Falso | Se habilitado, permite que o texto seja quebrado. Caso contrário, o texto será cortado |
Limitações e problemas conhecidos
Problema: o painel de pré-visualização parece funcionar conforme o esperado quando a propriedade URL contém caracteres de porcentagem, mas ocorre um erro de validação Valor inválido.
Solução alternativa: esse problema acontece porque o Power Automate tenta resolver os caracteres de porcentagem como variáveis ou expressões. Para resolver esse caso, armazene a URL em uma variável anterior no fluxo, escape dos caracteres de porcentagem e use essa variável na propriedade URL. A pré-visualização não mostrará a imagem, mas ela será exibida durante o runtime.