Kitegra 2.0: SAP CPI용 자동 완성, 메시지 Trace, iFlow Inspector, 문서화

SAP Integration Suite 디자이너에서 iFlow를 만들다 보면 디자이너를 자주 벗어나게 됩니다. 메시지가 어떻게 처리됐는지 보려고 모니터로, 매핑 명세를 보려고 스프레드시트로, 엔드포인트를 호출하려고 다른 도구로 옮겨 가고, 어떤 이름 규칙을 따라야 하는지 동료에게 묻기도 합니다. Kitegra는 이런 작업을 편집 중인 다이어그램 바로 옆으로 가져오는 Chrome·Edge 확장 프로그램입니다.

버전 2.0에서는 모듈 하나가 다섯 영역으로 커졌습니다. 이 글에서는 각 영역이 하는 일, 확장 프로그램이 tenant에서 무엇을 언제 바꾸는지, 무엇을 보관하고 동기화하는지, 요금제별로 몇 개의 iFlow를 쓸 수 있는지 설명합니다. Kitegra Chrome 확장 프로그램 중 하나입니다.

iFlow 디자이너를 둘러싼 다섯 영역

iFlow를 열면 보기 모드와 편집 모드 모두에서 다이어그램 도구 모음에 Kitegra 상자가 나타납니다. “메시지”, “로그”, “iFlow 정보”는 그 안에 각자 버튼이 있고, 나머지 도구는 모두 마지막 버튼 뒤의 메뉴에 있으며, Alt+Shift+P로 키보드에서 그 메뉴를 열 수 있습니다. 각 도구는 페이지 안에서 옮길 수 있는 패널을 엽니다. 도구는 다음 다섯 영역에 속합니다.

• Helper(Integration Flow Helper): 디자이너 자체 필드에서 제안과 점검을 받으며 iFlow를 더 빠르게 작성합니다.
• Message Monitor: 열린 iFlow의 메시지, Trace, 로그를 디자이너 안에서 봅니다.
• iFlow Inspector: 배포된 iFlow의 세부 정보, 이름 및 설계 점검, 검색.
• iFlow Docs: iFlow 또는 Message Mapping에서 생성되는 문서.
• Toolbox(화면에서는 “도구 상자”): 페이로드 비교·변환·생성, 스니펫, 메모, HTTP 요청을 위한 무료 도구.

각 영역은 옵션 페이지의 “모듈”에서 끌 수 있습니다. 그 밖에 tenant에서 일하기 편하게 해 주는 작업 공간 부가 기능도 있습니다. 환경 표시줄, 탭 브랜딩, 모니터링 링크, 키보드 단축키입니다.

Helper: iFlow를 더 빠르게 작성

디자이너 필드에 ${ 또는 $를 입력하면 iFlow의 그 위치에 맞는 이름 목록이 열립니다. Helper의 나머지 기능도 같은 iFlow 모델을 바탕으로 동작합니다.

• 제안: iFlow가 설정하는 header와 exchange property, SAP와 Camel의 표준 header, {{…}} 파라미터, 변수, Data Store, 그리고 자격 증명 필드의 Security Material 및 Keystore 이름.
• 표현식 점검: 닫히지 않은 표현식, 불필요한 공백, 현재 단계 전에 아무것도 설정하지 않는 header, EDMX에 없는 OData 이름.
• 소스: 샘플 페이로드의 XPath 경로, OpenAPI·Swagger·Postman 파일의 URL과 본문, ProcessDirect와 JMS로 전달되는 header.
• 다이어그램 정렬: 편집 모드에서 클릭 한 번으로 다이어그램을 정리합니다. Save로 유지하고, 옆의 실행 취소 버튼으로 되돌립니다.

앞서 나온 여섯 편의 글에서 이 기능들을 더 깊이 다룹니다. SAP CPI의 Camel Simple 표현식부터 읽어 보세요.

Message Monitor: 무슨 일이 있었는지 확인

• 메시지: 열린 iFlow의 최근 메시지를 다이어그램 옆 패널에 상태, 시간, 소요 시간과 함께 보여 주며, SAP 오류는 “일반적인 의미:” 아래에서 설명합니다.
• Trace: 스위치 하나로 iFlow의 로그 수준을 TRACE로 설정하고 작업하는 동안 유지합니다.
• 다이어그램에: 트레이스된 메시지가 지나간 단계가 다이어그램에 색칠되고, 단계를 클릭하면 그 전의 본문, header, exchange property가 보입니다.
• 메시지 로그: Message ID나 Correlation ID로 찾는 로그 뷰어, 관련 메시지의 타임라인, 다이어그램 위의 단계별 소요 시간.

전체 흐름은 메시지를 단계별로 트레이스하기에서 보여 줍니다.

iFlow Inspector와 iFlow Docs: 리뷰와 문서화

• 이름 규칙: 팀이 합의한 규칙을 모든 단계에서 점검하고, 제안 이름과 “이름 변경” 버튼을 제공합니다.
• 설계 점검: 오류 처리, 평문 비밀 값, 안전하지 않은 프로토콜, 스크립트 위험 등을 점검하며, 0에서 100까지의 점수, 기준선, HTML·PDF·Excel 보고서를 제공합니다. 점검 항목은 iFlow 리뷰 체크리스트에 정리되어 있습니다.
• iFlow 정보: 배포, 엔드포인트, Data Store 항목, 변수, 편집 잠금, 그리고 필요할 때 쓰는 Undeploy, Unlock, 삭제.
• iFlow 또는 그 package 전체 검색.
• iFlow에서 생성하는 Word·PDF·HTML 설계 문서: 다이어그램과 프로세스별 설명이 들어가며, 회사의 Word 템플릿에 채울 수도 있습니다. 기술 설계 문서 생성하기를 참고하세요.
• Message Mapping용 Excel 매핑 시트와 스크립트 설명.

Toolbox와 작업 공간

• 페이로드 비교, 형식 변환기, 결함(fault)을 넣을 수 있는 테스트 페이로드 생성기, Groovy 스니펫과 치트 시트, iFlow별·tenant별·전체 메모.
• Process Integration Runtime 서비스 키로 OAuth를 처리하는, iFlow 엔드포인트용 HTTP Runner.
• tenant별 환경 표시줄(PROD, TEST, DEV)과 탭 브랜딩, 모니터링 링크, 키보드 단축키, 속성 창 크기.

화면은 15개 언어로 제공되며 라이트 모드와 다크 모드를 지원합니다.

단계별 시작 방법

1. Chrome 또는 Microsoft Edge에 Kitegra를 추가하세요.
2. 내 tenant(*.hana.ondemand.com 주소)의 SAP Integration Suite 디자이너에서 iFlow를 여세요.
3. Content Modifier 값 같은 필드를 클릭하고 ${ 또는 $를 입력한 뒤 목록에서 이름을 고르세요.
4. 다이어그램 도구 모음의 Kitegra 상자에서 “메시지”, “로그” 또는 “iFlow 정보”를 클릭하거나, 메뉴를 열어 “검사기”와 다른 도구를 사용하세요.
5. 확장 프로그램 팝업을 열어 tenant, package, iFlow를 보고, Toolbox 페이지가 있는 “도구” 보기로 이동하세요.

계정 없이도 각 모듈을 5개 iFlow에서 사용할 수 있습니다. 더 많은 iFlow에서 쓰려면 확장 프로그램에서 Kitegra로 로그인을 선택하세요.

다음 iFlow에서 사용해 보세요

Kitegra의 다른 Chrome 확장 프로그램과 함께 Kitegra를 살펴보고, 요금제별 포함 내용을 비교해 보세요.

tenant에서 무엇을, 언제 바꾸는가

확장 프로그램은 사용자 본인의 SAP 세션으로 열린 iFlow와 그 메시지, 로그를 읽습니다. iFlow의 내용을 저장, 배포, 편집하는 일은 없습니다. “이름 변경”과 스니펫은 디자이너 필드에 입력만 할 뿐이고, 저장은 사용자가 합니다. tenant가 바뀌는 것은 이름이 정해진 다음 네 가지 작업 중 하나를 클릭할 때뿐입니다.

옵션 페이지의 스위치 하나, “테넌트를 변경하는 작업 허용”을 끄면 네 작업이 모두 꺼집니다. 버튼이 사라지고 확장 프로그램이 해당 작업을 거부합니다. HTTP Runner는 사용자가 직접 작성해 보낸 요청만 보냅니다.

보관하는 것과 동기화하는 것

• 메시지 내용(본문, header, 속성, 첨부 파일, 로그)은 페이지에 표시될 뿐, 어디에도 저장하거나 보내지 않습니다.
• Kitegra 계정이 없으면 브라우저 밖으로 아무것도 나가지 않습니다.
• 로그인하면 Kitegra는 요금제의 iFlow 수를 세기 위해, 여는 iFlow마다 이름과 ID, package, 디자이너 링크, 사용한 모듈, 날짜, SAP 계정의 단방향 해시를 보관합니다.
• 로그인하면 직접 작성한 내용이 모든 컴퓨터에서 이어집니다. 설정과 단축키, 메모, 이름 규칙, 설계 점검 설정과 기준선, tenant 브랜딩, 스니펫, 그리고 모든 인증 값과 비밀 변수를 제거한 HTTP Runner 컬렉션입니다. 옵션 페이지의 Kitegra 대시보드 스위치가 켜져 있으면(기본값은 켜짐) package와 iFlow의 이름과 ID도 전송되며, 팀 요금제에서는 팀 소유자가 이를 내 메모와 함께 볼 수 있습니다.
• 절대 보내지 않는 것: 메시지 내용, 스크립트, 매핑, 샘플 페이로드, API 명세, 자격 증명과 비밀 값. “옵션 › 동기화”의 “동기화된 데이터 삭제”로 동기화된 데이터를 Kitegra에서 지울 수 있습니다.

요금제별 iFlow 수

한도는 서로 다른 iFlow의 수를 모듈별로, 평생 기준으로 셉니다. 이미 사용한 iFlow를 다시 열어도 다시 세지 않으며, 한 모듈에서 사용한 iFlow는 다른 모듈로 그 iFlow를 사용할 때만 그 모듈에서도 셉니다.

Helper, Message Monitor, iFlow Inspector, iFlow Docs는 iFlow 수를 세고, Toolbox와 작업 공간 부가 기능은 세지 않습니다. 요금제 한도를 넘은 iFlow에는 디자이너와 팝업에 자물쇠가 표시됩니다. Kitegra 출시 기간에는 Free 요금제를 포함해 로그인한 모든 사용자가 모든 도구를 쓸 수 있습니다. Kitegra로 로그인하면 계정 없이 사용한 iFlow가 내 계정으로 옮겨집니다. 요금제 비교하기.

자주 묻는 질문