Digibee Tools

Saiba mais sobre cada cápsula da coleção Digibee Tools.

Para acessar a coleção Digibee Tools e usar as funcionalidades presentes nesse artigo, você precisa ter a permissão PIPELINE:CREATE. Aprenda mais na documentação sobre Papéis.

A coleção de cápsulas Digibee Tools fornece recursos comumente utilizados em pipelines para tornar sua construção mais produtiva. Abaixo você pode conhecer mais sobre cada cápsula da coleção.

Cápsulas da coleção Digibee Tools

CPF CNPJ Validator

A cápsula CPF CNPJ Validator te permite validar o valor de números de documentos brasileiros que identificam uma pessoa de forma única: CPF (Cadastro de Pessoas Físicas) e CNPJ (Cadastro Nacional da Pessoa Jurídica).

Para isso, a cápsula CPF CNPJ Validator utiliza cálculos matemáticos e garante que o dígito verificador está correto. No entanto, a cápsula não valida a situação cadastral dos referidos documentos na Receita Federal Brasileira.

Veja um exemplo de resultado de validação:

{
  "libOutPut": {
    "isCpfValid": true,
    "isCnpjValid": false,
    "noMask": "12345678909",
    "withMask": "123.456.789-09"
  }
}

Se houver um erro no algoritmo JavaScript, um erro de execução será acionado:

{
  "timestamp": 1620665936661,
  "error": "Capsule capsule-v1-digibee-collection-name-test-capsule-name-test-1.0 failed execution. Error: com.digibee.pipelineengine.exception.PipelineEngineRuntimeException: Error during validation of Cpf/Cnpj.",
  "code": 500
}

Digibee Publish Error

A cápsula Digibee Publish Error padroniza a forma como o pipeline publica mensagens de erro. No entanto, ela não envia as mensagens diretamente para seus painéis de monitoramento ou aplicativos como Slack ou email. O objetivo da cápsula é padronizar informações importantes para o monitoramento da integração. Ele também fornece detalhes técnicos sobre a execução.

O próximo passo é criar um pipeline responsável por receber tais mensagens e selecionar opções, como enviar um email agrupado com os erros.

A cápsula também garante que todas as notificações de erros sejam padronizadas, permitindo flexibilidade no envio de informações adicionais através do campo “payload”.

Os campos “Subject” ou “Error Code” podem ser usados ​​nos critérios de agrupamento de erros, por exemplo:

  • Em uma integração de pedidos, os erros que ocorreram em um determinado período devem ser agrupados e um único ticket deve ser criado para a equipe responsável pela avaliação do incidente.

  • No caso de integração de produtos, os erros do ERP devem ser separados dos erros da plataforma de e-commerce. Neste caso, cada grupo possui um valor de agrupamento diferente e as notificações podem ser tratadas de forma descentralizada.

A cápsula Digibee Publisher Error padroniza as informações que devem ser preenchidas pelo desenvolvedor no tratamento de erros, e essas informações são publicadas pelo componente Pipeline Executor. Portanto, o pipeline “error-handling-group-and-notify” deve ser criado e publicado no mesmo ambiente. Para obter um exemplo disso, entre em contato com a equipe de suporte da Digibee.

Veja uma ilustração do uso da cápsula:

Parallel Execution List to Objects

A cápsula Parallel Execution List to Objects converte um array em um mapa de objetos usando o campo “executionId” existente na raiz do array. O uso da cápsula Parallel Execution List to Objects pode ser aplicado ao padrão de saída do componente Parallel Execution quando os objetos são recuperados do processamento paralelo.

O fluxo acima resulta no seguinte array:

[
  {
    "executionId": "Example-execution-3",
    "result": {
      "message": {
        "year": "2021"
      }
    }
  },
  {
    "executionId": "Address-execution-2",
    "result": {
      "body": {
        "address": "Disney"
      }
    }
  },
  {
    "executionId": "Customer-execution-1",
    "result": {
      "customer": {
        "name": "Mickey Mouse"
      }
    }
  }
]

Combinando o componente Block Execution com o fluxo paralelo (conforme exemplo acima) e a cápsula, o resultado é um mapa de objetos para cada “executionId”. Confira:

{
  "Examaple-execution-3": {
    "message": {
      "year": "2021"
    }
  },
  "Address-execution-2": {
    "body": {
      "address": "Disney"
    }
  },
  "Customer-execution-1": {
    "customer": {
      "name": "Mickey Mouse"
    }
  }
}

Send Email Alert

A cápsula Send Email Alert tem como objetivo facilitar o envio de mensagens de erro por email com base nas informações inseridas no formulário de configuração. Ela permite o envio de informações complementares em um modelo de email pré-definido para que a causa do erro possa ser entendida.

Para usar essa cápsula, você precisa configurar uma conta do tipo SMTP Auth And Properties. Para saber mais sobre isso, leia o artigo Contas (Accounts).

Para ver um exemplo de configuração com a conta Google, leia o artigo Como usar sua conta do Gmail com o componente de e-mail Digibee (SMTP).

Verifique o limite de mensagens permitido pela sua conta de email. Para tornar mais confiável o número de emails enviados, recomendamos o procedimento descrito na cápsula Digibee Publish Error.

Sort Array by Field

A cápsula Sort Array by Field ordena o array JSON em ordem crescente (A-Z) ou decrescente (Z-A).

A ordenação não leva em consideração o tempo cronológico das datas, apenas a ordem alfabética. Para uma organização adequada, a data deve estar no formato “aaaa-mm-dd”.

Validate Consumers

A cápsula Validate Consumers pode ser usada quando um pipeline deve ser executado com um número máximo de consumers diferente do padrão de tempo de execução, para que as execuções não sejam executadas com a configuração de implantação errada.

Por exemplo, se o pipeline permite a execução de até 2 requisições simultâneas, mas o runtime está configurado com 10 requisições simultâneas e a cápsula está configurada com 2, é emitido um erro nas execuções para que as configurações sejam corrigidas. No entanto, se a configuração da cápsula especificar 2 requisições simultâneas, a implantação deverá ser configurada com no máximo 1 ou 2 consumers.

Para saber mais, leia o artigo Conceitos de Run.

Atualizado