액션 프로젝트를 사용한 원격 시스템 API 캡슐화
많은 비즈니스 프로세스가 서로 다른 시스템과 애플리케이션에 걸쳐 있기 때문에 비즈니스 프로세스 관리 시스템에서는 이러한 시스템 및 애플리케이션과 상호 작용할 수 있는 수단이 필요합니다. SAP Build Process Automation에서 액션 을 사용하여 통합을 수행합니다. 상호작용하기 위한 소스 및 대상 시스템의 어플리케이션 프로그래밍 인터페이스(API)는 액션 프로젝트 내에서 액션 으로 캡슐화됩니다. 그런 다음 이러한 액션 프로젝트는 액션 프로젝트 라이브러리에 보관되며 비즈니스 프로세스에 통합할 수 있습니다. 이 접근법은 각 프로세스에 직접 API를 통합하는 데 비해 다양한 이점을 제공합니다.
- API의 추상화가 있습니다. 프로세스 개발자는 API의 기술적 세부사항을 정확히 알 필요가 없습니다.
- API는 프로세스 개발자의 요구에 맞게 조정될 수 있으며 프로세스 개발자가 사용하기 위해 필요하거나 안전한 엔드포인트와 데이터만 표시합니다.
- 액션은 한 번 구성한 후 여러 비즈니스 프로세스 프로젝트 간에 재사용할 수 있습니다.
- 액션 프로젝트를 통해 버전 관리를 수행할 수 있으므로 변화하는 프로세스 요구사항이나 API 버전 변경을 더 쉽게 처리할 수 있습니다.
액션은 API 정의를 위한 OpenAPI 사양 표준(https://spec.openapis.org/oas/v3.1.0#openapi-specification)에 의존하기 때문에 SAP 시스템의 API에만 국한되지 않고 OpenAPI 사양에서 설명되거나 설명될 수 있는 API를 통합하는 옵션을 제공합니다. 특히 SAP 솔루션에 대한 많은 API 정의는 SAP Business Accelerator Hub에서 확인할 수 있습니다.
노트
API에 대한 추가 정보, 특히 SAP Build Process Automation API에 대한 자세한 내용과 SAP Build Process Automation의 API 통합 단원에서 보다 기술적인 레벨에서 API와 상호작용하는 방법을 확인할 수 있습니다.
액션 편집기
액션 편집기 를 사용하면 기본 API에서 액션 프로젝트로 여러 액션을 작성할 수 있습니다. API 엔드포인트의 가능한 모든 매개변수를 각 액션 에 매개변수로 포함할 필요는 없으며 액션을 통해 제공된 응답에 사용 가능한 모든 응답 본문 필드도 포함할 필요가 없습니다. 따라서 비즈니스 프로세스와 관련된 정보만 포함될 수 있습니다.
액션을 정의한 후에는 프로젝트를 버전으로 릴리스한 후 액션 라이브러리에 게시해야 합니다.
API가 Actions 프로젝트에 캡슐화되어 라이브러리에 게시된 후 프로세스에 대한 액션으로 추가하는 것은 매우 간단합니다. 해당 단계 유형 액션 을 선택하고 액션 라이브러리 를 찾습니다. 프로세스에 필요한 액션을 선택하고 추가 를 선택합니다. 프로세스에 액션 단계가 포함된 후에는 해당 매개변수를 정의해야 합니다.
- 대상 변수: 프로세스 런타임 시 기본 API에 액세스하는 데 사용할 기술 SAP BTP 대상 이름을 보유하는 프로세스 변수입니다. 이 변수는 프로세스 배포 중에 대상 이름으로 채울 수 있습니다.
- 입력: 액션을 수행하기 위해 필요한 모든 매개변수에 프로세스 컨텐트 매핑(예: SAP S/4HANA 시스템에서 판매 오더 엔트리를 가져오는 경우 판매 오더 번호)
- 출력: 각 액션에 정의된 액션 호출 결과의 개요입니다.
액션 프로젝트를 사용하여 원격 시스템 API 캡슐화
단계
액션 프로젝트를 사용하여 원격 시스템 API 다시 캡슐화
액션을 선택합니다.
생성을 선택합니다.
스크롤 영역을 선택하여 아래로 스크롤합니다.
SAP Business Accelerator Hub 를 선택합니다.
스크롤 영역을 선택하여 아래로 스크롤합니다.
SAP S/4HANA Cloud Public Edition 을 선택합니다.
스크롤 영역을 선택하여 아래로 스크롤합니다.
SAP S/4HANA Cloud Public Edition 을 선택합니다.
검색 필드에 판매 를 입력합니다.
Enter를 누릅니다.
판매 오더(A2X) 를 선택합니다.
API 문서 보기 를 선택합니다.
스크롤 영역을 선택하여 아래로 스크롤합니다.
API 사양 을 선택합니다.
다운로드 를 선택합니다.
노트
다음 단계에서는 다운로드된 JSON 파일을 프로젝트에 업로드하여 Build Apps 탭으로 돌아갑니다.
뒤로를 선택합니다.
통합 소스 를 선택합니다.
스크롤 영역을 선택하여 아래로 스크롤합니다.
API 사양 업로드 를 선택합니다.
찾아보기 파일 을 선택합니다.
API_SALES_ORDER_SRV.json 을 선택합니다.
열기를 선택합니다.
다음을 선택합니다.
프로젝트 이름 필드에 SAP S/4HANA 판매 오더 액션 을 입력합니다.
내역 필드에 액션 프로젝트 를 입력하여 S/4HANA 시스템의 판매 오더와 상호작용합니다.
생성을 선택합니다.
SAP S/4HANA 판매 오더 액션 을 선택합니다.
스크롤 영역을 선택하여 아래로 스크롤합니다.
판매 오더 헤더 를 선택합니다.
판매 오더의 헤더를 읽습니다 를 선택합니다.
추가를 선택합니다.
출력 을 선택합니다.
모두 선택 을 선택합니다.
키 창을 펼치려면 화살표를 선택합니다.
검색을 선택합니다.
검색 필드에 Organi 를 입력합니다.
조직 부문 체크박스의 선택을 해제합니다.
검색 필드에 distrib를 입력합니다.
DistributionChannel 체크박스의 선택을 해제합니다.
검색 필드에 총계 를 입력합니다.
TotalNetAmount 체크박스의 선택을 해제합니다.
검색 필드에 Salesord 를 입력합니다.
SalesOrderType 체크박스의 선택을 해제합니다.
SalesOrderDate 체크박스의 선택을 해제합니다.
검색 필드에 구매 를 입력합니다.
UncheckPurchaseOrderByShipToParty 체크박스의 선택을 해제합니다.
검색 필드에 salesorga 를 입력합니다.
영업 조직 체크박스의 선택을 해제합니다.
검색 필드에 요청 을 입력합니다.
RequestedDeliveryD 체크박스의 선택을 해제합니다.
제거 를 선택합니다.
제거 를 다시 선택합니다.
노트
이제 액션에 필요하지 않은 다른 모든 키를 제거했습니다.
저장을 선택합니다.
결과
이제 액션 프로젝트를 사용하여 원격 시스템 API를 캡슐화했습니다.
태스크 1: 테스트 액션
단계
액션 프로젝트를 사용하여 원격 시스템 API 캡슐화
시험 사용 을 선택합니다.
판매 오더 헤더 를 선택합니다.
Get/A_SalesOrder("{SalesOrder}")를 선택합니다.
값 필드에 1 을 입력합니다.
실행을 선택합니다.
노트
아래에서 요청 URL, 응답 본문 출력을 검토할 수 있습니다.
API 키 표시 를 선택합니다.
노트
API 키가 액션 입력 매개변수에 포함됩니다. 이 연습문제의 다음 단계를 위해 탭을 열어 둡니다.
키 복사 를 선택하고 닫기 를 선택합니다.
입력 을 선택합니다.
추가를 선택합니다.
신규 필드 를 선택합니다.
키 필드에 APIKey 를 입력합니다.
매개변수를 선택합니다.
헤더 를 선택합니다.
값 필드에 pGAVlcXDR7tPplcGF02RinSeiT79TYSO 를 입력합니다.
노트
Label 은 Business Accelerator Hub에 있습니다. API 키를 복사한 탭으로 돌아갑니다.
개요 를 선택합니다.
스크롤 영역을 선택하여 아래로 스크롤합니다.
노트
SANDBOX URL을 복사하여 Values 입력 매개변수에 추가합니다.
레이블 필드에 https://sandbox.api.sap.com/s4hanacloud/sap/opu/odata/sap/API_SALES_ORDER_SRV 을 입력합니다.
스크롤 영역을 선택하여 아래로 스크롤합니다.
추가를 선택합니다.
테스트를 선택합니다.
수동 을 선택합니다.
URL 필드에 https://sandbox.api.sap.com/s4hanacloud/sap/opu/odata/sap/API_SALES_ORDER_SRV 을 입력합니다.
문자열 값 필드에 1 을 입력합니다.
테스트를 선택합니다.
노트
테스트 미리보기 출력에는 판매 오더의 헤더 값이 표시됩니다.
릴리스를 선택합니다.
릴리스 노트 필드에 판매 오더의 헤더 읽기 를 입력합니다.
릴리스를 선택합니다.
라이브러리에 게시 를 선택합니다.
게시를 선택합니다.
노트
판매 오더의 입력 매개변수가 추가되었습니다. 이제 로비 로 이동하여 확인할 수 있습니다.
새로 고침을 선택합니다.
결과
지금까지 액션 프로젝트를 사용하여 원격 시스템 API를 캡슐화했습니다.