Neste tutorial, veremos mais de perto como se pode integrar Tilda e AppMaster. Suponhamos que foi criado um determinado formulário em Tilda, e a nossa tarefa é assegurar que os dados, quando preenchidos, sejam enviados para AppMaster, aí processados e armazenados na base de dados.
Criação de gancho de rede em AppMaster
Tilda envia dados para serviços de terceiros através de um gancho da web. Por conseguinte, vale a pena começar com a criação do gancho de rede necessário e, antes de mais, preparar o processo comercial para o seu funcionamento.
Uma característica deste processo é que não se sabe antecipadamente quais os dados exactos que serão obtidos. O gancho da web trabalhará com "raw" pedidos que precisam de ser devidamente processados. Para o efeito, utilizaremos o Get Request Body bloco. Vejamos que dados provêm geralmente de Tilda, convertamo-los para String, escrevam-nos no diário de bordo e exibam-nos em resposta ao pedido.
Na secção dos pontos finais, criemos imediatamente um novo gancho para a web. É importante notar que o tipo de pedido deve ser Raw porque não tem quaisquer parâmetros de entrada codificados e está pronto para aceitar quaisquer dados. Também precisa de desactivar Middleware Token Auth porque para preencher um formulário em Tilda, não precisa de passar por autorização em AppMaster, e o envio de dados está aberto a todos.
Tilda configuração do formulário
O passo seguinte é ligar Tilda ao gancho web criado. Para o fazer, nas definições dos formulários do sítio, basta especificar o URL, embora, se necessário, possa utilizar opções adicionais. Por exemplo, para protecção adicional, passe também uma chave especial, no corpo do pedido ou no cabeçalho.
Se tudo for feito correctamente, aparecerá uma mensagem correspondente com a capacidade de ligar imediatamente este gancho do sítio a todos os formulários do sítio.
Resta apenas publicar a página com o formulário e testá-lo em acção.
Ao abrir os registos do AppMaster, pode certificar-se de que os dados do formulário foram efectivamente recebidos.
Mensagem: “Email=test%40gmail.com&Name=John+Smith&Phone=%2B1-202-202-22-22&Comments=Hello%2C+world%21%0AThis+is+my+comment&tranid=6355139%3A3971256761&formid=form513738662”
Pode ver todas as informações preenchidas no formulário. Ao mesmo tempo, torna-se claro que os dados são recebidos no formulário x-www-form-urlencoded respectivamente, já não podem ser processados como um conjunto de dados em bruto, mas sim como uma colecção de campos individuais.
AppMaster modelo de base de dados
Resta apenas fazer o manipulador certo. E é melhor começar com um modelo de base de dados onde toda a informação será armazenada.
Para um formulário padrão, um modelo simples com 4 campos é suficiente:
- Email (String)
- Name (String)
- Phone (String)
- Comments (Text)
Em seguida, é necessário voltar ao processo comercial criado e alterá-lo tendo em conta as informações recebidas sobre a composição do pedido.
Os nomes dos campos da tabela a ser preenchida serão utilizados como parâmetros de entrada. Os dados deles serão utilizados para criar um modelo (Make Tilda) e depois escrever para a base de dados (DB: Create Tilda).
A última coisa a fazer é alterar o ponto final anteriormente criado para o gancho da web. Conhecemos o formato dos dados recebidos e processamo-los, pelo que o Request payload type deve ser Form. Ao mesmo tempo, é necessário fazer corresponder os parâmetros criados no processo empresarial com os nomes exactos dos campos do formulário preenchido (vimo-los nos registos quando recebemos os dados do pedido como dados em bruto). Neste exemplo, são quase os mesmos, mas diferem no caso do primeiro carácter.
Agora é possível publicar o pedido criado e testá-lo em acção. Se repetir o preenchimento e envio do formulário em Tilda, então os dados serão enviados para AppMaster, escritos na base de dados, e isto pode ser verificado utilizando Swagger.
