Linter: Detecção de erros e verificações de qualidade

Saiba como o Linter valida pipelines e cápsulas, prevenindo erros estruturais e oferecendo recomendações de boas práticas.

O Linter é uma ferramenta incorporada ao Canvas que identifica possíveis problemas de configuração e exibe alertas para ajudá-lo a detectá-los e corrigi-los mais rapidamente. A maioria dos alertas não exige correção imediata e não impede a criação dos seus fluxos.

Como os alertas funcionam

Enquanto você constrói um pipeline ou cápsula, o Linter oferece recomendações baseadas em boas práticas para ajudar a melhorar o fluxo e identificar possíveis problemas na integração. Esses problemas podem ser críticos, impedindo que a integração seja executada ou implantada, ou alertas menores que orientam para uma configuração mais segura e eficiente.

Onde os alertas aparecem

Os alertas são exibidos em dois locais:

• Diretamente no conector com problema (passe o mouse sobre o conector para detalhes), ou

• Na aba Problemas do Painel de Execução.

Cada alerta inclui uma breve descrição do problema e um link para a documentação. Ao visualizar alertas na aba Problemas, você pode clicar em Configurar passo para navegar diretamente até o conector e abrir seu formulário de configuração, independentemente do nível do fluxo.

Tipos de alertas

Os alertas são divididos em Erros e Avisos.

Erros

Alertas de Erro indicam falhas graves na criação do pipeline ou cápsula. Eles devem ser corrigidos antes de salvar o projeto.

Os erros são categorizados da seguinte forma:

• Estrutura: Problemas estruturais que impedem o processamento do fluxo de integração.

Avisos

Alertas de Aviso indicam oportunidades de melhoria na criação do pipeline ou cápsula.

Os avisos são categorizados da seguinte forma:

• Boas práticas: Hábitos de construção que melhoram a performance do pipeline ou cápsula e facilitam a manutenção futura.

Lista de alertas

Trigger

Trigger não configurado. Para implantar o pipeline, configure o trigger (Boas práticas).

O trigger define como a execução do pipeline se inicia. Para configurá-lo, selecione uma das opções disponíveis e conecte-a ao início do fluxo. Essa configuração é necessária para implantação. Para mais detalhes, consulte a documentação Visão geral de Triggers.

É possível salvar o pipeline sem configurar o trigger, mas não será possível implantá-lo.

Choice

O conector Choice precisa ter ao menos um "when" configurado (Estrutura).

O Choice permite ramificação condicional dentro de um pipeline ou cápsula. Para utilizá-lo corretamente, configure pelo menos uma condição when. Cada condição define um caminho específico para o fluxo. Saiba mais.

O conector Choice precisa ter um "otherwise" configurado (Estrutura).

A condição otherwise é executada quando nenhuma das condições when se aplica. Configure pelo menos uma condição otherwise para garantir a execução contínua do fluxo. Saiba mais.

Conectores de subfluxo

Os seguintes alertas se aplicam a conectores que estruturam subfluxos:

• Block Execution

• Do While

• For Each

• Retry

• Stream Excel

• Stream File Reader

• Stream File Reader Pattern

• Stream JSON File Reader

• Stream XML File Reader

• Stream DB V3

O OnProcess precisa ter ao menos um conector conectado (Estrutura).

O OnProcess define um dos subfluxos em um pipeline ou cápsula. Adicione e conecte pelo menos um conector para que o fluxo não seja interrompido.

O OnException precisa ter ao menos um conector conectado (Boas práticas).

O OnException trata exceções que ocorrem durante a execução do OnProcess. Adicione e conecte pelo menos um conector para garantir o tratamento adequado de erros.

Esta regra não se aplica ao conector Block Execution.

Existe ao menos um problema dentro do OnProcess (Estrutura).

Revise e resolva os problemas dentro do subfluxo OnProcess para continuar construindo seu pipeline ou cápsula.

Existe ao menos um problema dentro do OnException (Estrutura).

Revise e resolva os problemas dentro do subfluxo OnException para continuar construindo seu pipeline ou cápsula.

Parallel Execution

O conector Parallel precisa ter ao menos uma execução configurada (Estrutura).

O Parallel Execution permite configurar múltiplas execuções simultaneamente. Conecte-o a pelo menos outro conector para evitar interrupção do fluxo. Saiba mais.

O Parallel Execution deve sempre ser seguido por outro conector para que o fluxo seja executado.

O conector Parallel deve ter ao menos duas execuções configuradas (Boas práticas).

Como boa prática, configure o Parallel Execution apenas quando duas ou mais execuções precisarem rodar ao mesmo tempo. Saiba mais.

Session Management

O campo não foi declarado anteriormente (Boas práticas).

Um campo não pode ser utilizado (GET) se não foi previamente declarado (PUT). Saiba mais.

O campo foi declarado, mas não está sendo utilizado (Boas práticas).

Um campo previamente declarado (PUT) não está sendo usado. Configure um novo conector de Session Management para usar (GET) ou excluir (DELETE) o campo. Saiba mais.

Versões descontinuadas

Versão do conector descontinuada. Existe uma versão nova desse conector (Boas práticas).

Você está usando uma versão descontinuada de um conector. Uma versão mais recente e aprimorada está disponível.

Versões descontinuadas ainda podem ser usadas, mas apenas a versão mais recente recebe atualizações e melhorias.

Cápsulas

Esta Cápsula não pode ser usada aqui porque ela não existe neste realm (Estrutura).

A cápsula que você está tentando usar não existe no realm atual. Exclua-a ou substitua-a por outro conector ou cápsula disponível no seu realm.