SAP CPI에서 Deploy 이후: 배포 감시, 패키지 문서, 시스템 구성도, Excel로 만드는 Value Mapping

SAP Cloud Integration(SAP CPI)에서 Deploy를 누르면 기다림이 시작됩니다. Monitor로 넘어가 iFlow를 찾고, Started나 Error가 뜰 때까지 새로 고친 다음, 그 오류가 무슨 뜻인지 알아내야 합니다. 인터페이스가 완성되면 이번에는 누군가 문서와 시스템 구성도, 그리고 스프레드시트로 된 Value Mapping을 요청합니다.

이제 Kitegra은 SAP Integration Suite 디자이너 옆에서 이 부분의 작업도 맡습니다. 테스트 호출이 포함된 배포 감시, Edge Integration Cell이 있는 tenant를 위한 런타임 선택, 새로운 설계 점검, 시스템 구성도와 문서화 준비도가 담긴 패키지 문서, Excel로 만드는 Value Mapping 시트, 그리고 Groovy 스크립트를 쉬운 말로 풀어 주는 설명입니다. 각 도구는 따로 끌 수 있습니다. 이 글에서 하나씩 살펴봅니다.

배포 감시: iFlow를 떠나지 않고 Started 또는 오류 확인

평소처럼 디자이너에서 Deploy를 누르고 SAP 대화 상자에서 확인하세요. “배포 중…”과 경과 시간이 표시된 배포 알림이 나타나고, 그동안 계속 작업할 수 있습니다. Kitegra은 3초 뒤 SAP에 상태를 묻고, 그 뒤로는 점점 간격을 늘려 최대 20초마다 확인합니다. SAP가 응답하면 알림이 다음과 같이 바뀝니다.

• Started: 배포된 버전과 함께 표시됩니다. iFlow에 HTTP 엔드포인트가 있으면 테스트 호출 보내기가 요청이 준비된 HTTP Runner를 열고, 최신 메시지 보기가 메시지 패널을 새로 엽니다.
• 오류: SAP의 오류 텍스트와 함께, 알려진 경우라면 보통 무슨 뜻인지 보여 줍니다. 다른 배포된 iFlow가 이미 그 발신자 주소를 쓰고 있거나, 스크립트가 컴파일되지 않거나, 외부화된 파라미터에 값이 없거나, SAP가 iFlow를 빌드하지 못한 경우입니다. SAP에서 배포된 콘텐츠 열기로 자세한 내용을 볼 수 있습니다.
• 아직 배포 중: 10분이 지나도 끝나지 않으면 SAP의 배포된 콘텐츠로 가는 안내와 함께 표시됩니다.

SAP의 Deploy 대화 상자를 취소하면 아무것도 감시하지 않습니다. 감시는 배포 상태를 읽기만 하며, 배포 자체는 직접 누른 클릭으로 시작된 SAP의 작업입니다. 이후 메시지가 iFlow를 어떻게 지나가는지 따라가는 방법은 메시지를 단계별로 추적하기에서, 호출 자체는 서비스 키로 HTTPS iFlow 테스트하기에서 설명합니다.

런타임 선택: Cloud 또는 Edge

Edge Integration Cell이 있는 tenant에서는 iFlow가 여러 런타임에서 실행됩니다. 그런 tenant에서만 Kitegra 상자에 런타임: Cloud(또는 Edge 런타임의 이름)가 표시됩니다. 여기서 런타임을 고르면 Message Monitor가 그 런타임에서 이 iFlow의 메시지를 읽고 로그 수준을 설정합니다. 선택기에는 각 런타임에 배포되어 있는지와 어떤 버전인지도 표시됩니다. 런타임이 하나뿐인 tenant에서는 보이지 않습니다.

iFlow Inspector의 새로운 설계 점검

iFlow 리뷰 체크리스트에 점검 다섯 개와 새로운 문서화 범주가 추가되었습니다.

다른 점검과 마찬가지로 점수에 반영되며 하나씩 끌 수 있습니다. 보기는 무료이고, 보고서 내보내기는 Pro에 포함됩니다. Externalize Parameters와 그 밖의 새로운 Helper 도구는 Externalize Parameters, 단계 복사, Hub에서 가져오기에서 설명합니다.

패키지 전체를 위한 문서

Kitegra 메뉴의 이 iFlow 문서화 옆에 이제 패키지 문서가 있습니다. 열려 있는 iFlow가 속한 패키지의 모든 iFlow를 하나씩 읽으며(“iFlow 읽는 중 (2/5)…”), 도중에 멈추고 그때까지 읽은 내용을 열 수도 있습니다. 읽지 못한 iFlow는 목록으로 표시됩니다. 문서는 새 탭에서 열리며, 한 iFlow의 기술 설계 문서처럼 Word, PDF, HTML로 받거나 직접 만든 Word 템플릿에 채워 넣을 수 있습니다. 패키지의 버전, 공급업체, 태그, iFlow 수가 먼저 나오고, 이어서 각 iFlow와 새로운 두 부분이 담깁니다.

• 시스템 구성도: 왼쪽에 발신자, 가운데에 패키지의 iFlow, 오른쪽에 수신자를 둔 다이어그램입니다. 이름이 같은 참여자는 상자 하나로 합쳐지고, 각 선에는 어댑터 유형이 표시됩니다.
• 문서화 준비도: 읽는 사람에게 필요한 것을 하나씩 확인합니다. 패키지의 설명과 태그, 각 iFlow의 설명, Sender와 Receiver에서 이름을 바꾼 참여자, 외부화된 수신자 주소입니다. 통과한 점검 수와 빠진 것을 보여 주므로, 넘겨주기 전에 빈 곳을 채울 수 있습니다.

Excel로 만드는 Value Mapping

iFlow Docs 페이지의 Value Mapping에서 Value Mapping ZIP(SAP의 패키지에서 다운로드) 또는 그 value_mapping.xml을 업로드하세요. Kitegra이 값을 나열하고, 에이전시와 식별자 쌍마다 시트 하나씩 담은 Excel 통합 문서를 만듭니다. 소스 에이전시, 식별자, 값, 이어서 대상 에이전시, 식별자, 값 순입니다. 파일은 브라우저 안에서 읽히며, SAP에서 아무것도 읽지 않고 어디로도 보내지 않습니다. 매핑에는 Message Mapping 시트가 같은 방식으로 동작합니다.

쉬운 말로 풀어 주는 스크립트

Kitegra 메뉴의 스크립트 설명은 iFlow의 모든 Groovy 스크립트 단계를 나열합니다. 각 스크립트에 대해 작성자의 요약 주석, 정의한 함수, 읽는 것(본문, 헤더, 교환 속성, 첨부 파일), 설정하고 바꾸는 것, 주요 로직(XML이나 JSON 파싱 또는 생성, 반복문, 조건 분기, HTTP 호출, 날짜), Security Material, Value Mapping, Partner Directory 같은 사용하는 SAP API, 그리고 참고 사항과 위험을 보여 줍니다. 단계 이름을 클릭하면 다이어그램에서 그 단계가 선택됩니다. 설명은 브라우저 안에서 스크립트 텍스트를 바탕으로 만들어지며, 스크립트는 어디로도 전송되지 않습니다.

쓰지 않는 도구는 끄세요

이제 옵션 페이지에 도구 섹션이 있으며, 모든 도구마다 스위치가 있고 모듈별로 묶여 있습니다. Helper의 XPath 확인, 정렬, Security Material, Externalize, 단계 복사, Hub에서 가져오기부터 메시지, 런타임 선택, 로그 뷰어, 배포 감시, iFlow 정보, Inspector와 검색, 문서와 스크립트 설명을 거쳐, Toolbox의 메모, 스니펫, 비교, 변환, 생성, HTTP Runner까지입니다. 끈 도구는 디자이너와 팝업에서 바로 사라집니다. 데이터는 남아 있으며 모두 켜기로 전부 되살릴 수 있습니다. 모듈 전체를 끄려면 같은 페이지의 “모듈”을 쓰세요. 옵션 페이지를 참고하세요.

배포 감시, 런타임 선택, 스크립트 설명, 설계 점검 보기는 무료입니다. 패키지 문서, 시스템 구성도, Value Mapping 시트는 iFlow Docs에 속하며 Free와 Starter에서도 몇 번 쓸 수 있습니다. Kitegra 출시 기간에는 로그인한 모든 사용자가 모든 도구를 쓸 수 있습니다. 요금제 비교하기.

다음 iFlow에서 사용해 보세요

Kitegra이 SAP Integration Suite 디자이너에 무엇을 더하는지, 또는 iFlow 작성을 위한 새로운 도구를 읽어 보세요.

자주 묻는 질문