Kitegra 2.0: autocompletar, trace de mensagens, iFlow Inspector e documentação para SAP CPI

Construir um iFlow no designer do SAP Integration Suite obriga a sair dele o tempo todo: para o monitor, para ver o que uma mensagem fez; para uma planilha, para a especificação do mapping; para outra ferramenta, para chamar o endpoint; para um colega, para perguntar qual regra de nomenclatura vale. O Kitegra é uma extensão para Chrome e Edge que traz esse trabalho para perto do diagrama que você está editando.

A versão 2.0 passa de um módulo para cinco áreas. Este artigo explica o que cada uma faz, o que a extensão altera no seu tenant e quando, o que ela guarda e sincroniza, e quantos iFlows cada plano cobre. Ela é uma das extensões do Chrome da Kitegra.

Cinco áreas ao redor do designer de iFlows

Abra um iFlow e uma caixa do Kitegra aparece na barra de ferramentas do diagrama, nos modos de visualização e de edição. “Mensagens”, “Logs” e “Informações do iFlow” têm um botão próprio nela; todas as outras ferramentas ficam no menu atrás do último botão, e Alt+Shift+P abre esse menu pelo teclado. Cada ferramenta abre um painel que você pode mover pela página. As ferramentas pertencem a cinco áreas:

• Helper (Integration Flow Helper): escreva iFlows mais rápido, com sugestões e verificações nos próprios campos do designer.
• Message Monitor: as mensagens, o trace e os logs do iFlow aberto, dentro do designer.
• iFlow Inspector: os detalhes do iFlow implantado, verificações de nomes e de design, e pesquisa.
• iFlow Docs: documentos gerados a partir de um iFlow ou de um Message Mapping.
• Toolbox: ferramentas gratuitas para comparar, converter e gerar payloads, snippets, notas e requisições HTTP.

Cada área pode ser desativada na página de opções, em “Módulos”. Ao redor delas, alguns extras do espaço de trabalho deixam o dia a dia no tenant mais fácil: uma barra de ambiente, a identificação visual da aba, links de monitoramento e atalhos de teclado.

Helper: escreva iFlows mais rápido

Digite ${ ou $ em um campo do designer e abre-se uma lista com os nomes que fazem sentido naquele ponto do iFlow. O resto do Helper se apoia no mesmo modelo do seu iFlow:

• Sugestões: os headers e as exchange properties que o seu iFlow define, headers padrão do SAP e do Camel, parâmetros {{…}}, variáveis, Data Stores e, nos campos de credenciais, nomes de Security Material e de Keystore.
• Verificação de expressões: expressões não fechadas, espaços sobrando, headers que nada define antes da etapa atual e nomes OData que o EDMX não tem.
• Fontes: caminhos XPath a partir de um payload de exemplo, URLs e corpos a partir de um arquivo OpenAPI, Swagger ou Postman, e headers passados por ProcessDirect e JMS.
• Organizar diagrama: arruma o diagrama com um clique no modo de edição; Save mantém o resultado, e o botão de desfazer ao lado deixa como estava.

Os seis artigos anteriores aprofundam esses temas, começando por Expressões Camel Simple no SAP CPI.

Message Monitor: veja o que aconteceu

• Mensagens: as últimas mensagens do iFlow aberto em um painel ao lado do diagrama, com status, horário e duração, e o erro do SAP explicado em “O que costuma significar:”.
• Trace: um único interruptor define o nível de log do iFlow como TRACE e o mantém ligado enquanto você trabalha.
• No diagrama: as etapas por onde uma mensagem rastreada passou ficam coloridas no diagrama, e um clique em uma etapa mostra o body, os headers e as exchange properties antes dela.
• Logs de mensagens: um visualizador de logs com busca por Message ID ou Correlation ID, uma linha do tempo das mensagens relacionadas e os tempos de cada etapa no diagrama.

Rastrear uma mensagem etapa por etapa mostra o fluxo completo.

iFlow Inspector e iFlow Docs: revisar e documentar

• Nomenclatura: as regras que a sua equipe combina, verificadas em cada etapa, com um nome sugerido e um botão “Renomear”.
• Verificações de design: tratamento de erros, segredos em texto simples, protocolos inseguros, riscos em scripts e mais, com uma pontuação de 0 a 100, uma linha de base e um relatório em HTML, PDF ou Excel. O checklist de revisão de iFlows lista todas elas.
• Informações do iFlow: implantação, endpoints, entradas do Data Store, variáveis e o bloqueio de edição, com Undeploy, Unlock e Excluir quando você precisar.
• Pesquisa no iFlow ou no pacote inteiro.
• Um documento de design gerado a partir do iFlow, em Word, PDF ou HTML, com o diagrama e uma narrativa de cada processo, ou preenchido no seu próprio modelo do Word. Veja como gerar um documento de design técnico.
• Uma planilha de mapping em Excel para Message Mappings, e scripts explicados.

Toolbox e espaço de trabalho

• Comparação de payloads, um conversor de formatos, um gerador de payloads de teste com falhas, snippets de Groovy e um guia rápido, e notas por iFlow, por tenant ou globais.
• Um HTTP Runner para os endpoints dos seus iFlows, com OAuth a partir de uma service key do Process Integration Runtime.
• Uma barra de ambiente (PROD, TEST, DEV) e identificação visual da aba por tenant, links de monitoramento, atalhos de teclado e o tamanho do painel de propriedades.

A interface está disponível em 15 idiomas, nos modos claro e escuro.

Como começar, passo a passo

1. Adicione o Kitegra ao Chrome ou ao Microsoft Edge.
2. Abra um iFlow no designer do SAP Integration Suite do seu tenant (um endereço *.hana.ondemand.com).
3. Clique em um campo, como um valor de Content Modifier, e digite ${ ou $; escolha um nome da lista.
4. Na caixa do Kitegra na barra de ferramentas do diagrama, clique em “Mensagens”, “Logs” ou “Informações do iFlow”, ou abra o menu dela para o “Inspetor” e as outras ferramentas.
5. Abra o pop-up da extensão para ver seus tenants, pacotes e iFlows, e a visão “Ferramentas” com as páginas da Toolbox.

Sem conta, você pode usar cada módulo em 5 iFlows. Para usá-los em mais, escolha Entrar com o Kitegra na extensão.

Experimente no seu próximo iFlow

Veja o Kitegra ao lado das outras extensões do Chrome da Kitegra e compare o que cada plano inclui.

O que ela altera no seu tenant, e quando

A extensão lê o iFlow aberto, as mensagens e os logs dele com a sua própria sessão do SAP. Ela nunca salva, implanta nem edita o conteúdo de um iFlow: “Renomear” e os snippets apenas digitam nos campos do designer, e quem salva é você. Ela só altera o seu tenant quando você clica em uma de quatro ações nomeadas:

Um único interruptor na página de opções, “Permitir ações que alteram o tenant”, desliga as quatro: os botões somem e a extensão as recusa. O HTTP Runner envia apenas as requisições que você mesmo escreve e envia.

O que ela guarda, e o que sincroniza

• O conteúdo das mensagens (bodies, headers, propriedades, anexos e logs) é exibido na página, nunca armazenado nem enviado a lugar nenhum.
• Sem uma conta Kitegra, nada sai do seu navegador.
• Com login, a Kitegra guarda, para cada iFlow que você abre, o nome e o id, o pacote, o link do designer, os módulos usados, as datas e um hash irreversível da sua conta SAP, para contar os iFlows do seu plano.
• Com login, o que você escreveu acompanha você em qualquer computador: configurações e atalhos, notas, regras de nomenclatura, configurações e linhas de base das verificações de design, identidade visual dos tenants, snippets e as coleções do HTTP Runner, sem nenhum valor de autenticação nem variável secreta. Com a chave “Painel do Kitegra” ligada na página de opções (ligada por padrão), os nomes e ids dos seus pacotes e iFlows também são enviados, e em um plano de equipe o dono da equipe pode vê-los, assim como suas notas.
• Nunca enviados: conteúdo de mensagens, scripts, mappings, payloads de exemplo, especificações de API, credenciais e segredos. Em Opções › Sincronização, “Excluir dados sincronizados” remove da Kitegra o que foi sincronizado.

Quantos iFlows cada plano cobre

O limite conta iFlows distintos, por módulo, para sempre: abrir um iFlow que você já usou não conta de novo, e um iFlow usado por um módulo só é contado por outro quando você usa esse outro módulo nele.

O Helper, o Message Monitor, o iFlow Inspector e o iFlow Docs contam iFlows; a Toolbox e os extras do espaço de trabalho não contam nenhum. Um iFlow além do limite do seu plano mostra um cadeado no designer e no pop-up. Enquanto o Kitegra é lançado, todas as ferramentas ficam liberadas para todos que entrarem, inclusive no plano Free. Quando você entra com o Kitegra, os iFlows que usou sem conta passam para a sua conta. Compare os planos.

Perguntas frequentes