Ao projetar formulários, às vezes podemos querer exibir dados de outros sites ou aplicativos, como taxas de estoque, status de voo, detalhes de frete, atualizações meteorológicas etc. Para buscar essas informações de sites ou aplicativos de terceiros e exibi-las nos campos durante a criação de cartões, scripts de clientes podem ser usados.
Cenário de negócios
Ryan administra uma agência de férias. Ele usa Qntl para automatizar as solicitações de reserva de seus clientes. Ryan deseja exibir a previsão do tempo do destino de férias quando um cliente reservar o pacote de férias. Ele também deseja que a previsão seja atualizada automaticamente se um cliente alterar o destino.
Solução
Para conseguir isso, Ryan pode usar a API de qualquer site de previsão do tempo no script do cliente Qntrl e exibir o clima e a temperatura quando o usuário seleciona um destino.
Configuração de exemplo
Etapa 1 – criar uma orquestração
Crie uma nova orquestração – Booking Request Orchestration (Orquestração de solicitação de reserva) – e adicione campos para registrar a solicitação do cliente.
- Adicione um campo suspenso, Selecione um destino de viagem, e adicione valores no menu suspenso de Estados como Alabama, Alasca, Califórnia, Flórida e assim por diante.
- Crie 2 campos de linha única para registar o Tempo e a Temperatura do destino .
Depois que o formulário for criado, prossiga para projetar o blueprint, definir permissões e publicar a orquestração.
Etapa 2: codificar scripts do cliente
Antes de criar scripts, selecione um site ou aplicativo do qual você gostaria de receber os dados. Usamos API do openweathermap.org no código de exemplo.
- Crie um novo script e insira um nome: Atualização do clima.
- Escolha a Booking Request Orchestration (Orquestração de solicitação de reserva) no menu suspenso Form (Formulário).
- Escolha Add new card (Adicionar novo cartão) como Execution Location (Local de execução) para executar o script quando um novo cartão for adicionado.
- Escolha onChange como o Execution Trigger (Gatilho de execução) para permitir que o script exiba a previsão do tempo quando o destino for escolhido. Ao selecionar essa opção, uma lista suspensa Fields (Campos) será exibida no painel direito, onde você poderá escolher os campos cuja atualização deve acionar o script.
- Copie e cole o script abaixo em seu editor de script e substitua os nomes dos parâmetros.
- Você pode usar o ícone ? no canto superior direito do editor de script para fazer referência aos nomes dos parâmetros.
- Quando o script estiver pronto, Publish (Publique) -o.
Script de amostra
async function onChange(forpage,oldVal,newVal,executeOnLoad){
if(executeOnLoad){
return;
}
var msg = weatherdata.weather[0].description;
current.Job.setValue(current.Layout.Fields.<select-Destination-weather-parameter-here>.id, msg);
var temp = weatherdata.main.temp - 270;
var str_a = temp.toString();
var result = Number(str_a.slice(0, 5));
var tempmsg = result + " Degree Celsius";
current.Job.setValue(current.Layout.Fields.<select-Destination-temperature-parameter-here>.id, tempmsg);
}
Etapa 3 - adicionar um cartão
Quando os scripts de formulário, blueprint e cliente estiverem prontos, podemos testar o script criando um novo cartão.
- Navegue até Cards (Cartões) e clique em Add Card (Adicionar cartão) .
- Selecione Booking Request Orchestration (Orquestração da solicitação de reserva) no menu suspenso Form (Formulário).
- Insira o destino da viagem.
- O clima e a temperatura do destino são exibidos automaticamente.
Related Articles
Caso de negócio 2: buscar dados de sites de terceiros usando scripts de servidor (antes de criar)
Às vezes, podemos querer buscar dados externos de outros aplicativos ou sites, como detalhes meteorológicos, taxas de estoque ou status de voo relacionados ao cartão, quando criamos um cartão. Os scripts do servidor podem ser usados para buscar esses ...
Caso de negócio 1: usar scripts de cliente para executar cálculos matemáticos e validações em dados
Ao projetar formulários para replicar documentos relacionados a finanças, como ordem de compra, fatura ou faturas de reembolso, nossos fluxos de trabalho podem exigir o cálculo do custo total ou a soma das despesas incorridas. Para automatizar esses ...
Gerenciar scripts do cliente
Os scripts do cliente são usados para incorporar validações adicionais aos dados de negócios enquanto são registrados no Qntrl. Em scripts de cliente, você pode codificar usando JavaScript e executar o código no navegador do usuário final enquanto ...
Caso de negócio 6: excluir cartões associados de aplicativos de terceiros (após a exclusão)
Automatize a exclusão de registros em aplicativos de terceiros, como Zoho Desk ou SAP, depois que eles forem excluídos no Qntrl usando o script de servidor "após exclusão". Cenário de negócios A Zylker usa o Jira para rastrear problemas em seus ...
Caso de negócios 5: transferir dados para aplicativos de terceiros (após a criação)
As empresas atuais usam diferentes ferramentas de software para diferentes funções, como inventário, folha de pagamento, serviços públicos etc. Os scripts de servidor permitem que as organizações busquem dados desses softwares ou sites de terceiros e ...