Caso de negócio 3: validar novos dados inseridos em cartões usando scripts de servidor (antes da atualização)
Realizar operações e coordenar com as equipes pode ser uma tarefa bastante trabalhosa. Se as informações fornecidas nos detalhes do cartão forem alteradas para corromper informações posteriormente, elas poderão criar caos e atrasar a conclusão da tarefa. É por isso que, se um usuário fizer atualizações no cartão, os scripts do servidor permitirão validar os novos dados antes que eles sejam atualizados no cartão.
Cenário de negócios
A Zylker Corp associa-se a um conjunto de fornecedores cujos detalhes são salvos em um banco de dados em nuvem. Quando os detalhes do fornecedor em um cartão existente são atualizados, os detalhes precisam ser validados com os valores existentes no banco de dados. Se o detalhe atualizado estiver incorreto, o cartão não pode ser salvo.
Solução
Quando um campo de detalhes do fornecedor é atualizado no cartão, o novo valor pode ser validado com o banco de dados usando scripts de servidor. Para executar isso:
- Crie um script de servidor para validar dados do aplicativo de terceiros.
- Crie um cartão e atualize um campo para testar a funcionalidade.
Configuração de exemplo
Etapa 1: codificar scripts do servidor
Crie um novo script de servidor para validar os detalhes do fornecedor se eles forem atualizados.
- Crie um novo script de servidor e insira o nome como "Validar detalhes do fornecedor".
- Escolha Contract Initiation (Início do contrato) no menu suspenso Form (Formulário). Usamos a orquestração do caso de uso anterior aqui. Saiba mais.
- Escolha Job (Tarefa) como Execution Location (Local de execução) para executar o script.
- Escolha Before Update (Antes de atualizar) como Execution Trigger (Gatilho de execução) para executar este script sempre que a página do cartão for carregada.
- Copie e cole o script abaixo em seu editor de script e substitua os nomes dos parâmetros.
- Esse código serve para validar apenas o nome do fornecedor. Você pode usar lógica semelhante para validar outros detalhes.
- 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.
- function beforeUpdate(){
-
- //select Vendor ID parameter here
- var vendorId = current.Job.getValue(current.Layout.Fields.<select-VendorID-parameter-here>.id);
- if (!vendorId) {
- console.log("Vendor ID not present");
- return;
- }
- var url = "https://jsonplaceholder.typicode.com/users/"+vendorId;
- var params = {};
- var headers = {};
-
- var res = ZDK.HTTP.get(url, params, headers);
- if (res.status != 200) {
- console.log("Unable to fetch vendor details");
- return;
- }
- var responseBody = res.body;
- if (typeof responseBody == "string") {
- responseBody = JSON.parse(responseBody);
- }
-
- //select Vendor Name parameter here
- var orginalVendorName = responseBody.name;
- var presentVendorName = current.Job.getValue(current.Layout.Fields.<select-VendorName-parameter-here>.id);
- if (orginalVendorName != presentVendorName) {
- current.Job.addError(current.Layout.Fields.<select-VendorName-parameter-here>.id, "Vendor name is not matching in vendor database");
- }
- }
Etapa 2: adicionar cartão
Quando os scripts de servidor e orquestração 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 Contract Initiation (Início do contrato) no menu suspenso Form (Formulário).
- Insira o ID do fornecedor para preencher automaticamente outros detalhes do fornecedor e salve o cartão.
- Na página de detalhes do cartão, atualize todos os detalhes do fornecedor, como nome do fornecedor, endereço, site, contato ou e-mail do fornecedor.
- Se os detalhes inseridos não corresponderem aos detalhes no banco de dados, um erro será exibido e o cartão não poderá ser salvo.
Related Articles
Caso de negócio 4: definir condições para que os usuários excluam cartões usando scripts de servidor (antes de excluir)
As organizações fornecem permissões e privilégios a várias seções da equipe de acordo com suas funções e perfis. Para garantir que os dados no Qntrl só possam ser excluídos pelo pessoal certo, as organizações podem implementar critérios e condições ...
Gerenciar scripts de servidor
Os scripts de servidor ajudam você a codificar a lógica de negócios específica da empresa para gerenciar o banco de dados, executar processos demorados rapidamente e automatizar atividades em seus fluxos de trabalho de negócios. Esses scripts em ...
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 ...
Caso de negócio 1: preencher a lista de destinatários lidos de um cartão usando scripts de servidor (ao carregar)
Os gerentes consideram útil saber quais funcionários visualizaram um novo cartão ou comentário, como uma lista de recibos de leitura. Ela ajuda os gerentes a saber se um funcionário visualizou sua tarefa atribuída e avaliar como os funcionários ...