Módulo deste artigo: iFlow Inspector
Checklist de revisão de iFlows do SAP CPI, e como automatizá-lo
Um checklist prático de revisão de iFlows do SAP CPI: tratamento de erros, níveis de log, segredos, protocolos, scripts e estrutura, e como executá-lo automaticamente com pontuação e relatório.
A revisão de um iFlow costuma acontecer sob pressão, logo antes de um transporte, e verifica o que o revisor lembra. Os mesmos problemas então chegam à produção de novo e de novo: nenhum tratamento de erros, uma senha em um Content Modifier, um Router sem rota padrão.
Este artigo traz um checklist de doze verificações para iFlows do SAP Cloud Integration (SAP CPI), explica por que cada uma importa e mostra como executá-las automaticamente, com uma pontuação e um relatório que você pode anexar ao transporte.
Quando revisar um iFlow
- Antes do primeiro transporte para um tenant de teste ou de produção.
- Quando um iFlow é passado para outro desenvolvedor ou para a equipe de operações.
- Depois de uma mudança maior, como um novo receptor ou um novo script.
- De tempos em tempos, nos iFlows que cresceram ao longo dos anos.
O checklist
| Verificação | Por que importa | Categoria |
|---|---|---|
| Sem Exception Subprocess | Um erro encerra a mensagem com o tratamento padrão do SAP: sem alerta e sem uma resposta limpa ao sender. | Confiabilidade |
| Nível de log detalhado | Registrar cada etapa deixa cada mensagem mais lenta e enche o armazenamento de logs do tenant. | Desempenho |
| Sem descrição | Os outros não conseguem saber o que o iFlow faz nem quem é o responsável sem abri-lo. | Manutenibilidade |
| Segredo em texto simples | Qualquer pessoa que possa abrir ou baixar o iFlow consegue ler uma senha ou um token escrito nele. | Segurança |
| Etapa de script sem script | Uma etapa de script sem arquivo de script falha em tempo de execução. | Correção |
| Processo grande | Um processo com muitas etapas é difícil de ler, testar e alterar. | Manutenibilidade |
| Protocolo inseguro | HTTP ou FTP simples enviam os dados, e as credenciais Basic, sem criptografia. | Segurança |
| Chamada sem Receiver | Uma etapa Request Reply ou Send sem canal não tem para onde enviar a mensagem. | Correção |
| Risco no script | println, ler um body grande como uma única String, scripts muito longos, parsers XML expostos a XXE. | Desempenho |
| Local Integration Process não utilizado | Nenhum Process Call chega a ele, então ele nunca é executado. | Manutenibilidade |
| Etapa não conectada | Nenhum caminho a partir de um evento de início chega a ela, então ela nunca é executada. | Correção |
| Router sem rota padrão | Quando nenhuma condição é atendida, a mensagem falha em vez de seguir um caminho conhecido. | Confiabilidade |
Essas são as categorias que o Kitegra usa. Em uma revisão manual, o que importa é que cada verificação tenha um motivo e uma correção com que a equipe concorde.
O que um checklist não enxerga
As verificações leem o design do iFlow. Elas não sabem se o mapping está certo para o negócio, se o receptor aguenta a carga ou se o tratamento de erros manda o alerta para alguém que o lê. Uma revisão ainda precisa de uma pessoa para essas perguntas, e de um teste com dados realistas.
Os nomes são uma parte separada da revisão: um pacote de regras de nomenclatura também os torna verificáveis.
Execute as verificações automaticamente
No Kitegra, abra o iFlow, clique no botão “Ferramentas do Kitegra” e escolha “Inspetor”. A aba “Design” executa as doze verificações acima no iFlow aberto e nos scripts dele:
- Cada apontamento mostra por que importa e uma linha “Correção:”.
- A “Pontuação (0–100) e nota” resume o iFlow, de A a E.
- “Configurações das verificações” desliga uma verificação ou muda quanto ela pesa na pontuação; essas configurações são sincronizadas com a sua conta Kitegra.
- “Definir linha de base” marca os apontamentos de hoje como conhecidos, para que a próxima revisão mostre só o que é novo.
- “Suprimir” oculta um apontamento e pergunta o motivo; “Mostrar conhecidos e suprimidos” os traz de volta.
Uma das verificações trata do nível de log; por que o TRACE não deve ficar ligado explica isso.
Compartilhe o resultado como relatório
“Relatório” abre o relatório do iFlow em uma nova aba: os dados do iFlow (etapas, scripts, adaptadores, processos), a pontuação, os apontamentos de design filtrados por categoria ou gravidade, e os apontamentos de nomenclatura. Exporte-o como HTML, PDF ou Excel, ou escolha “Imprimir”. Em “Cabeçalho do relatório”, você pode adicionar o nome da empresa e um logotipo de 20 KB ou menos.
O relatório é lido do modelo do iFlow e não inclui conteúdo de mensagens. Os rótulos do PDF ficam em inglês.
Como o Kitegra ajuda
As verificações de design fazem parte do iFlow Inspector do Kitegra. Elas rodam no seu navegador, no iFlow aberto; as configurações das verificações e as linhas de base são sincronizadas com a sua conta Kitegra quando você entra, e scripts e mappings nunca são enviados.
O Helper, o Message Monitor, o iFlow Inspector e o iFlow Docs contam, cada um, os iFlows em que você os usa: 5 por módulo sem uma conta Kitegra, 50 no plano Free, 100 no Starter e 300 no Pro; o Startup Team dá 300 a cada membro, e o Growth Team e o Scale Team não têm limite. A Toolbox e os extras do espaço de trabalho não contam iFlows. Enquanto o Kitegra é lançado, todas as ferramentas ficam liberadas para todos que entrarem, inclusive no plano Free. Compare os planos.
Experimente no seu próximo iFlow
Veja o que o Kitegra acrescenta ao redor do designer do SAP Integration Suite, ou confira-o ao lado das outras extensões do Chrome da Kitegra.
Perguntas frequentes
O que a revisão de um iFlow do SAP CPI deve verificar?
Tratamento de erros, nível de log, descrição, segredos em texto simples, scripts, segurança dos protocolos, partes não conectadas ou não utilizadas e rotas padrão dos Routers, além da nomenclatura e da lógica de negócio.
Por que um Router sem rota padrão é um problema?
Quando nenhuma condição é atendida, a mensagem falha em vez de seguir um caminho conhecido.
Como a pontuação é calculada?
Cada apontamento reduz a pontuação, a partir de 100, em um peso que depende da gravidade, e a pontuação corresponde a uma nota de A a E. Você pode mudar quanto cada verificação pesa.
O que “Definir linha de base” faz?
Marca os apontamentos de hoje como conhecidos, para que uma revisão posterior mostre só os novos.
Posso exportar a revisão?
Sim. O relatório do iFlow é exportado para HTML, PDF ou Excel, com o nome e o logotipo da sua empresa.
O relatório contém conteúdo de mensagens?
Não. Ele é lido do modelo do iFlow e não inclui conteúdo de mensagens.