Módulo deste artigo: iFlow Docs
Depois do Deploy no SAP CPI: acompanhamento do deploy, documentos de pacote, panorama de sistemas e Value Mapping no Excel
Veja quando um iFlow está Started ou por que falhou, escolha o runtime Cloud ou Edge, rode novas verificações de design, documente um pacote inteiro com o panorama de sistemas, exporte Value Mappings para o Excel e desligue qualquer ferramenta.
Pressionar Deploy no SAP Cloud Integration (SAP CPI) dá início a uma espera: ir para o Monitor, encontrar o iFlow, atualizar até aparecer Started ou Error e depois descobrir o que o erro significa. E, quando uma interface fica pronta, alguém ainda pede o documento, o desenho do panorama de sistemas e o Value Mapping numa planilha.
O Kitegra agora cobre essa parte do trabalho ao lado do designer do SAP Integration Suite: um acompanhamento do deploy com chamada de teste, um seletor de runtime para tenants com Edge Integration Cell, novas verificações de design, um documento do pacote com diagrama do panorama de sistemas e prontidão da documentação, uma planilha de Value Mapping no Excel e explicações de scripts Groovy em palavras simples. Cada ferramenta pode ser desligada individualmente. Este artigo passa por todas elas.
Acompanhamento do deploy: Started ou Error, sem sair do iFlow
Pressione Deploy no designer como de costume e confirme o diálogo do SAP. Um aviso de Implantação aparece com "Implantando…" e o tempo decorrido, e você continua trabalhando. O Kitegra pergunta o estado ao SAP depois de três segundos e depois com cada vez menos frequência, no máximo a cada 20 segundos. Quando o SAP responde, o aviso passa a mostrar:
- Started, com a versão implantada. Se o iFlow tiver um endpoint HTTP, Enviar uma chamada de teste abre o HTTP Runner com a requisição pronta, e Mostrar a mensagem mais recente abre o painel Mensagens atualizado.
- Error, com o texto de erro do SAP e, quando é um caso conhecido, o que ele costuma significar: outro iFlow implantado já usa o endereço de remetente, um script não compila, um parâmetro externalizado não tem valor ou o SAP não conseguiu compilar o iFlow. Abrir o conteúdo implantado no SAP leva você aos detalhes.
- Ainda implantando depois de dez minutos, com um link para o conteúdo implantado no SAP.
Se você cancelar o diálogo Deploy do SAP, nada é acompanhado. O acompanhamento só lê o estado da implantação; quem implanta é o SAP, a partir do seu próprio clique. Seguir depois uma mensagem pelo iFlow é descrito em rastrear uma mensagem etapa por etapa, e a chamada em si em testar um iFlow HTTPS com uma service key.
Seletor de runtime: Cloud ou Edge
Um tenant com Edge Integration Cell executa iFlows em mais de um runtime. Só nesse tipo de tenant, a caixa do Kitegra mostra Runtime: Cloud (ou o nome do runtime Edge). Escolha o runtime ali, e o Message Monitor lê as mensagens deste iFlow e define o nível de log nesse runtime. O seletor também mostra se há algo implantado em cada um e qual versão. Tenants com um único runtime nunca o veem.
Novas verificações de design no iFlow Inspector
O checklist de revisão de iFlows ganhou cinco verificações, com uma nova categoria Documentação:
| Verificação | Por que importa |
|---|---|
| Receptor sem endereço (erro) | O iFlow é implantado, mas toda chamada a esse receptor falha em tempo de execução. |
| Remetente HTTPS com endereço padrão (aviso) | Um endereço vazio, / ou provisório como /test não diz nada a quem chama, e dois iFlows podem entrar em conflito nele. |
| Remetente HTTPS exige token CSRF (info) | Todo chamador precisa buscar primeiro um X-CSRF-Token, ou o POST dele recebe 403. |
| Endereço do receptor escrito no iFlow (info) | Passar entre DEV, QA e PROD exige editar o iFlow; o Externalize Parameters resolve isso em um passo. |
| Participante mantém o nome padrão (info, Documentação) | "Sender" e "Receiver" também aparecem no monitoramento, então ninguém consegue saber de qual sistema se trata. |
Como as outras verificações, elas contam para a pontuação e podem ser desligadas uma a uma. Visualizá-las é gratuito; exportar o relatório faz parte do Pro. O Externalize Parameters e as outras novas ferramentas do Helper são descritos em Externalize Parameters, cópia de etapas e importação do Hub.
Um documento para o pacote inteiro
Ao lado de Documentar este iFlow, o menu do Kitegra agora tem Documento do pacote. Ele lê um a um todos os iFlows do pacote do iFlow aberto ("Lendo o iFlow 2 de 5…"), e você pode interromper e abrir o que já foi lido. Os iFlows que não puderam ser lidos são listados. O documento abre em uma nova aba, em Word, PDF ou HTML, ou preenchido no seu próprio modelo do Word, como o documento de design técnico de um iFlow. Ele traz a versão, o fornecedor, as tags e o número de iFlows do pacote, depois cada iFlow, e duas partes novas:
- Panorama de sistemas: um diagrama com os remetentes à esquerda, os iFlows do pacote no meio e os receptores à direita. Participantes com o mesmo nome viram uma só caixa, e cada linha mostra os seus tipos de adaptador.
- Prontidão da documentação: o que o leitor precisa, verificado item a item: a descrição e as tags do pacote, uma descrição para cada iFlow, participantes renomeados de Sender e Receiver e endereços de receptor externalizados. Mostra quantas verificações foram aprovadas e o que falta, para você preencher as lacunas antes da entrega.
Value Mapping no Excel
Na página do iFlow Docs, em Value Mappings, envie um ZIP de Value Mapping (baixe-o do pacote dele no SAP) ou o seu value_mapping.xml. O Kitegra lista os valores e gera uma pasta de trabalho do Excel com uma planilha por par de agência e identificador: agência, identificador e valor de origem, depois agência, identificador e valor de destino. O arquivo é lido no seu navegador; nada é lido do SAP e nada é enviado a lugar nenhum. A planilha de Message Mapping funciona do mesmo jeito para mappings.
Scripts explicados em palavras simples
Explicar scripts no menu do Kitegra lista todas as etapas de script Groovy do iFlow. Para cada uma, mostra o comentário de resumo do autor, as funções que define, o que lê (corpo, headers, propriedades de exchange, anexos), o que define e altera, a lógica principal (analisar ou gerar XML ou JSON, loops, decisões, chamadas HTTP, datas), as APIs SAP que usa, como Security Material, Value Mapping ou Partner Directory, e notas e riscos. Clique no nome de uma etapa para selecioná-la no diagrama. A explicação é deduzida do texto do script no seu navegador; o script nunca é enviado a lugar nenhum.
Desligue qualquer ferramenta que você não usa
A página de opções agora tem uma seção Ferramentas com um interruptor para cada ferramenta, agrupada sob o seu módulo: da verificação de XPath, Organizar, Security Material, Externalize, cópia de etapas e importação do Hub no Helper, passando por Mensagens, o seletor de runtime, o visualizador de logs e o acompanhamento do deploy, Informações do iFlow, o Inspector e a Pesquisa, Documentos e Scripts explicados, até Notas, Snippets, Comparar, Converter, Gerar e o HTTP Runner na Toolbox. Uma ferramenta desligada some do designer e do pop-up na hora; os seus dados ficam, e Ativar todas traz tudo de volta. Para desligar um módulo inteiro, use Módulos na mesma página; veja a página de opções.
O acompanhamento do deploy, o seletor de runtime, Scripts explicados e a visualização das verificações de design são gratuitos. O documento do pacote, o panorama de sistemas e a planilha de Value Mapping pertencem ao iFlow Docs, com alguns usos no Free e no Starter. Enquanto o Kitegra é lançado, todas as ferramentas ficam liberadas para todos que entrarem. Compare os planos.
Experimente no seu próximo iFlow
Veja o que o Kitegra acrescenta ao redor do designer do SAP Integration Suite, ou as novas ferramentas para escrever iFlows.
Perguntas frequentes
O Kitegra faz o deploy do meu iFlow?
Não. Você pressiona Deploy no SAP; o acompanhamento do deploy só lê o estado da implantação e avisa quando ele está Started ou falhou.
Como documento um pacote inteiro do SAP CPI?
Abra qualquer iFlow do pacote e escolha Documento do pacote no menu do Kitegra. Ele lê cada iFlow e abre um único documento com o diagrama do panorama de sistemas e a prontidão da documentação, em Word, PDF ou HTML.
Posso exportar um Value Mapping para o Excel?
Sim. Baixe o ZIP do Value Mapping a partir do pacote dele no SAP e envie-o na página do iFlow Docs. Você recebe uma planilha por par de agência e identificador; o arquivo nunca sai do seu navegador.
Por que não vejo o seletor de runtime?
Ele só aparece em tenants com mais de um runtime, como Cloud mais Edge Integration Cell.
Se eu desligar uma ferramenta, os meus dados são excluídos?
Não. A ferramenta some do designer e do pop-up, e os dados dela ficam. Ligue-a de novo na seção Ferramentas da página de opções.