SAP 워크로드 통합 - Amazon Quick Suite
할 수 있는 작업시작하기 전 준비 사항SAP 시스템 구성 및 인증 준비SAP 통합 설정커넥터 유형별 사용 가능한 작업쿼리 파라미터SAP 워크로드 통합 관리SAP 워크로드 통합 문제 해결

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

SAP 워크로드 통합

SAP 워크로드 통합을 사용하면 다양한 SAP 시스템에서 작업을 수행할 수 있습니다. 비즈니스 데이터, 인벤토리, 재료 및 비즈니스 프로세스를 관리합니다. 이러한 통합은 작업 실행만 지원하며 Amazon Quick Suite Pro 티어 이상이 필요합니다.

할 수 있는 작업

SAP 워크로드 통합은 SAP 시스템 작업에 도움이 되는 엔터프라이즈급 연결을 제공합니다.

작업 커넥터

SAP 시스템 내에서 작업을 수행합니다. SAP APIs를 통해 비즈니스 데이터, 인벤토리 레코드, 재료 정보 및 기타 엔터프라이즈 운영을 생성, 업데이트 및 관리합니다.

여러 SAP 모듈

재료표, 비즈니스 파트너, 재료 재고, 물리적 인벤토리 문서, 제품 마스터 등 5가지 통합 유형을 지원합니다.

시작하기 전 준비 사항

SAP 워크로드 통합을 설정하기 전에 다음이 있는지 확인합니다.

  • 적절한 모듈이 설치 및 구성된 SAP 시스템.

  • 필요한 권한 및 권한이 있는 SAP 사용자 계정.

  • Amazon Quick Suite 작성자 이상.

  • Amazon Quick Suite와 SAP 시스템 간의 네트워크 연결.

SAP 시스템 구성 및 인증 준비

Amazon Quick Suite에서 통합을 설정하기 전에 SAP 시스템 구성 및 사용자 인증을 준비합니다. SAP 워크로드 통합은 여러 인증 방법을 지원하며 적절한 시스템 설정이 필요합니다.

인증 방법

SAP 워크로드 통합은 두 가지 인증 방법을 지원합니다.

OAuth 2.0(권장)

자동화된 워크플로를 위한 보안 인증 방법입니다. SAP 시스템에서 OAuth 구성이 필요합니다.

필수 파라미터:

  • 클라이언트 ID - SAP OAuth 클라이언트 ID

  • 클라이언트 보안 암호 - SAP OAuth 클라이언트 보안 암호

  • 토큰 URL - OAuth 토큰 엔드포인트(예: https://hostname:port/sap/bc/sec/oauth2/token?sap-client=100)

  • 도메인 URL - SAP 시스템 API 엔드포인트(예: https://hostname:port/sap/opu/odata/sap/API_BUSINESS_PARTNER)

기본 인증

직접 SAP 시스템 액세스를 위한 사용자 이름 및 암호 인증.

필수 파라미터:

  • 사용자 이름 - SAP 시스템 사용자 이름

  • 암호 - SAP 시스템 암호

  • 도메인 URL - SAP 시스템 API 엔드포인트

SAP 시스템 구성 요구 사항

SAP 워크로드 통합을 사용하기 전에 SAP 시스템이 올바르게 구성되었는지 확인합니다.

OAuth 2.0 설정

OAuth 2.0 인증의 경우:

  • 적절한 범위로 OAuth 권한 부여 서버 구성

  • 트랜잭션 코드를 사용하여 서비스에 OAuth가 활성화되어 있는지 확인 /IWFND/MAINT_SERVICE

  • 자세한 OAuth 2.0 구성은 SAP 설명서: OAuth 2.0 구성 가이드를 참조하세요.

SAP API 활성화

필요한 SAP API 서비스가 활성 상태인지 확인합니다.

  • 선택한 SAP 커넥터에 대한 특정 API 서비스 활성화

  • SAP 시스템에서 API 서비스 상태 확인

  • API 활성화에 대한 SAP 설명서: SAP API 서비스 활성화 가이드를 참조하세요.

사용 가능한 SAP 워크로드 통합 유형

비즈니스 요구 사항에 맞는 SAP 통합 유형을 선택하고 시스템에서 해당 SAP 모듈을 사용할 수 있는지 확인합니다.

SAP 재료표

구성 요소 목록, 수량 및 제조 사양을 포함한 재료 명세서 데이터를 관리합니다.

필수 범위: ZAPI_BILL_OF_MATERIAL_SRV_0002

SAP 비즈니스 파트너

고객 및 공급업체 데이터, 연락처 세부 정보, 관계 관리를 포함한 비즈니스 파트너 정보를 처리합니다.

필수 범위: ZAPI_BUSINESS_PARTNER_0001

SAP 재료 재고

재료 재고 수준, 재고 이동 및 창고 정보에 액세스하고 관리합니다.

필수 범위: ZAPI_MATERIAL_STOCK_SRV_0001

SAP 물리적 인벤토리 문서

물리적 인벤토리 문서, 재고 수 및 인벤토리 조정 프로세스를 생성하고 관리합니다.

필수 범위: ZAPI_MATERIAL_STOCK_SRV_0001

SAP 제품 마스터

재료 사양, 분류 및 제품 계층 구조를 포함한 제품 마스터 데이터를 유지 관리합니다.

필수 범위: ZAPI_PRODUCT_SRV_0001

SAP 워크로드 인증 설정

SAP 사용자 인증 자격 증명을 준비하고 적절한 시스템 액세스 권한을 확인합니다.

  • SAP 시스템 URL - SAP 시스템의 기본 URL 또는 서버 주소를 가져옵니다.

  • 사용자 자격 증명 - 적절한 권한이 있는 SAP 사용자 계정을 생성하거나 식별합니다.

  • 시스템 권한 - 사용자 계정에 통합하려는 특정 SAP 모듈에 필요한 SAP 권한 부여 및 트랜잭션 코드가 있는지 확인합니다.

  • 네트워크 액세스 - SAP 시스템이 외부 연결에서 액세스할 수 있고 방화벽 규칙이 통합을 허용하는지 확인합니다.

SAP 통합 설정

SAP 시스템 구성 및 인증 자격 증명을 준비한 후 설정 프로세스는 모든 SAP 통합 유형에서 유사합니다. 보안 요구 사항에 따라 OAuth 2.0 또는 기본 인증 중에서 선택합니다.

  1. Amazon Quick Suite 콘솔에서 통합을 선택합니다.

  2. 사용 가능한 SAP 커넥터 중 하나를 선택합니다.

    • SAP 재료표

    • SAP 비즈니스 파트너

    • SAP 재료 재고

    • SAP 물리적 인벤토리 문서

    • SAP 제품 마스터

  3. 추가(더하기 "+" 버튼)를 클릭합니다.

  4. SAP 통합의 이름과 설명을 입력합니다.

  5. 통합을 위한 연결 유형을 선택합니다.

  6. 지원되는 방법 중 하나를 사용하여 인증을 구성합니다.

    1. OAuth 2.0 구성

      OAuth 2.0 인증의 경우 다음을 제공합니다.

      • 클라이언트 ID - SAP OAuth 클라이언트 ID

      • 클라이언트 보안 암호 - SAP OAuth 클라이언트 보안 암호

      • 토큰 URL - OAuth 토큰 엔드포인트 URL

      • 도메인 URL - SAP 시스템 API 엔드포인트 URL

    2. 기본 인증 구성

      기본 인증의 경우 다음을 제공합니다.

      • 사용자 이름 - SAP 시스템 사용자 이름

      • 암호 - SAP 시스템 암호

      • 도메인 URL - SAP 시스템 API 엔드포인트 URL

  7. 생성 및 계속을 선택합니다.

  8. 통합을 공유할 사용자를 선택합니다.

  9. 다음을 클릭합니다.

예상 결과

설정이 성공하면 SAP 워크로드 통합이 통합 목록에 나타나며 Amazon Quick Suite 워크플로, 자동화 및 AI 에이전트에서 사용할 수 있습니다. 구성된 인증 자격 증명을 사용하여 Amazon Quick Suite에서 직접 SAP 관련 작업을 수행할 수 있습니다.

커넥터 유형별 사용 가능한 작업

각 SAP 워크로드 커넥터는 비즈니스 도메인에 맞는 특정 작업을 제공합니다. 선택한 커넥터 유형에 사용 가능한 작업을 검토합니다.

SAP 자재 명세서 작업

재료표 데이터 관리에 사용할 수 있는 작업:

  • 재료 BOM 항목 가져오기 - 지정된 재료에 대한 재료 명세서 세부 정보를 검색합니다.

    작업 ID: getMaterialBOMItem

    엔드포인트: GET /MaterialBOMItem

SAP 비즈니스 파트너 운영

비즈니스 파트너 데이터 관리에 사용할 수 있는 작업:

  • 비즈니스 파트너 가져오기 - 비즈니스 파트너 일반 데이터를 검색합니다.

    작업 ID: getBusinessPartner

  • 비즈니스 파트너 주소 가져오기 - 비즈니스 파트너 주소 데이터를 검색합니다.

    작업 ID: getBusinessPartnerAddress

  • 비즈니스 파트너 역할 가져오기 - 비즈니스 파트너 역할 데이터를 검색합니다.

    작업 ID: getBusinessPartnerRole

  • ID로 비즈니스 파트너 가져오기 - 비즈니스 파트너 번호를 기준으로 비즈니스 파트너 데이터를 검색합니다.

    작업 ID: getBusinessPartnerByID

    필수 파라미터: BusinessPartner (문자열, 최대 10자)

  • ID로 비즈니스 파트너 역할 가져오기 - 키 필드를 사용하여 비즈니스 파트너 역할 데이터를 검색합니다.

    작업 ID: getBusinessPartnerRoleByID

    필수 파라미터: BusinessPartner (문자열, 최대 10자), BusinessPartnerRole (문자열, 최대 6자)

SAP 재료 재고 작업

재료 재고 데이터를 관리하는 데 사용할 수 있는 작업:

  • 계정에서 재료 재고 가져오기 - 계정 모델에 게시된 재료 재고 정보를 검색합니다.

    작업 ID: getMaterialStockInAccount

SAP 물리적 인벤토리 문서 작업

물리적 인벤토리 문서를 관리하는 데 사용할 수 있는 작업:

  • PhysInventory 문서 항목 가져오기 - 물리적 인벤토리 항목에 대한 정보를 읽습니다.

    작업 ID: getPhysInventoryDocItem

SAP Product Master 작업

제품 마스터 데이터 관리에 사용할 수 있는 작업:

  • 제품 마스터 항목 가져오기 - 제품 마스터 레코드를 반환합니다.

    작업 ID: getProductMaster

  • 재료별 공장 데이터 가져오기 - 제품 마스터 레코드의 공장 데이터를 반환합니다.

    작업 ID: getPlantDataByMaterial

    필수 파라미터: Product (문자열, 최대 40자)

  • 자재별 공급 계획 데이터 가져오기 - 제품 번호 및 공장별로 공급 계획 데이터를 반환합니다.

    작업 ID: getSupplyPlanningDataByMaterial

    필수 파라미터: Product (문자열, 최대 40자), Plant (문자열, 최대 4자)

쿼리 파라미터

SAP 커넥터는 API 응답을 필터링, 정렬 및 형식 지정하기 위한 표준 쿼리 파라미터를 지원합니다. 이러한 파라미터를 사용하여 데이터 검색 및 처리를 최적화합니다.

지원되는 쿼리 파라미터
# 파라미터 설명 형식
1 $top 반환된 항목 수를 제한합니다. 정수
2 $skip 지정된 항목 수를 건너뜁니다. 정수
3 $filter 지정된 기준에 따라 결과를 필터링합니다. 문자열
4 $orderby 지정된 필드별로 결과를 정렬합니다. array
5 $select 반환할 특정 속성을 선택합니다. array
6 $expand 관련 엔터티를 확장합니다. array
7 $inlinecount 응답의 항목 수 포함 문자열

SAP 워크로드 통합 관리

SAP 워크로드 통합을 생성한 후 여러 옵션을 통해 관리할 수 있습니다.

통합 설정 편집

다음 단계에 따라 SAP 워크로드 통합 설정을 수정합니다.

  1. Amazon Quick Suite 콘솔에서 통합을 선택합니다.

  2. 통합 그리드에서 SAP 워크로드 통합 유형을 선택합니다.

  3. 목록에서 통합을 선택하고 편집을 선택합니다.

  4. 통합 설정 수정:

    • 인증 자격 증명(사용자 이름 및 암호)을 업데이트합니다.

    • SAP 시스템 URL 또는 연결 설정을 변경합니다.

    • 통합 이름 또는 설명을 수정합니다.

  5. 변경 사항 저장을 선택하여 수정 사항을 적용합니다.

통합 공유

SAP 워크로드 작업 커넥터를 조직의 다른 사용자와 공유할 수 있습니다.

  1. SAP 통합 세부 정보 페이지에서 공유를 선택합니다.

  2. 공유 옵션 구성:

    • 특정 사용자와 공유 - 사용자 이름 또는 이메일 주소를 입력합니다.

    • 조직과 공유 - 조직의 모든 사용자가 사용할 수 있도록 합니다.

  3. 공유 액세스에 대한 권한 수준을 설정합니다.

  4. 통합 공유를 선택하여 공유 설정을 적용합니다.

통합 삭제

다음 단계에 따라 SAP 통합을 영구적으로 제거합니다.

  1. SAP 워크로드 통합 세부 정보 페이지에서 삭제를 선택합니다.

  2. 이 통합을 사용하여 워크플로 또는 자동화를 포함하여 삭제에 미치는 영향을 검토합니다.

  3. 통합 이름을 입력하여 삭제를 확인합니다.

  4. 통합 삭제를 선택하여 영구적으로 제거합니다.

SAP 워크로드 통합 문제 해결

이러한 문제 해결 팁을 사용하여 일반적인 SAP 워크로드 통합 문제를 해결합니다.

인증 문제

OAuth 2.0 인증 실패

증상: 토큰 생성 실패, 잘못된 클라이언트 자격 증명 또는 OAuth 범위 오류.

​해결 방법:

  • OAuth 클라이언트 ID 및 클라이언트 보안 암호가 올바른지 확인

  • 트랜잭션을 사용하여 OAuth가 SAP에서 올바르게 구성되었는지 확인 /IWFND/MAINT_SERVICE

  • SAP 워크로드 커넥터 유형에 필요한 범위가 올바르게 구성되었는지 확인합니다.

  • 토큰 URL 형식이 SAP 시스템 구성과 일치하는지 확인

기본 인증 실패

증상: 로그인 실패, 잘못된 자격 증명 또는 액세스 거부 오류.

​해결 방법:

  • SAP 사용자 이름과 암호가 올바른지 확인

  • 사용자 계정에 필요한 SAP 인증이 있는지 확인

  • 사용자 계정이 잠기거나 만료되지 않았는지 확인합니다.

  • 도메인 URL에 액세스할 수 있고 형식이 올바른지 확인합니다.

SAP 시스템 구성 문제

API 서비스가 활성화되지 않음

증상: 서비스 사용 불가 오류, API 엔드포인트를 찾을 수 없음 또는 HTTP 404 응답.

​해결 방법:

  • 시스템에서 필요한 SAP API 서비스가 활성화되었는지 확인

  • SAP 트랜잭션 코드를 사용하여 API 서비스 상태 확인

  • API 서비스가 선택한 SAP 커넥터 유형에 해당하는지 확인합니다.

  • SAP 관리자에게 문의하여 누락된 API 서비스를 활성화합니다.

연결 시간 초과

증상: 요청 제한 시간, 네트워크 연결 오류 또는 느린 응답 시간.

​해결 방법:

  • SAP 시스템 URL이 올바르고 액세스 가능한지 확인

  • 네트워크 연결이 SAP 시스템에 대한 연결을 허용하는지 확인

  • 방화벽 규칙이 통합 트래픽을 허용하는지 확인

  • SAP 시스템 성능 및 가용성 확인

권한 및 권한 부여 오류

SAP 권한 부여 부족

증상: 액세스 거부 오류, 권한 부여 메시지 누락 또는 제한된 작업 실패.

​해결 방법:

  • 인증된 사용자에게 특정 모듈에 필요한 SAP 인증이 있는지 확인합니다.

  • 사용자에게 필요한 트랜잭션 코드에 대한 액세스 권한이 있는지 확인

  • 사용자 계정에 적절한 역할 할당이 있는지 확인합니다.

  • SAP 관리자에게 문의하여 누락된 권한 부여

범위 권한 오류

증상: OAuth 범위 오류, API 작업에 대한 권한 부족 또는 제한된 액세스 메시지.

​해결 방법:

  • OAuth 구성에 커넥터 유형에 필요한 범위가 포함되어 있는지 확인합니다.

  • SAP 시스템에서 범위 권한이 제대로 부여되었는지 확인

  • OAuth 클라이언트에 필요한 API 액세스 권한이 부여되었는지 확인합니다.

데이터 형식 및 파라미터 오류

잘못된 파라미터 형식

증상: 데이터 검증 오류, 잘못된 필드 길이 메시지 또는 파라미터 형식 예외.

​해결 방법:

  • 작업 파라미터를 검토하고 예상 SAP 데이터 형식과 일치하는지 확인합니다.

  • 필드 길이가 SAP 시스템 요구 사항과 일치하는지 확인(예: BusinessPartner 최대 10자)

  • 특정 SAP 모듈에 대한 데이터 형식이 올바른지 확인

  • 작업에 대한 모든 필수 필드가 제공되었는지 확인합니다.

쿼리 파라미터 오류

증상: 쿼리 구문 오류, 지원되지 않는 파라미터 메시지 또는 잘못된 요청 오류.

​해결 방법:

  • 파라미터가 올바른 구문을 사용하는지 확인(예: , $filter$top, $skip)

  • 파라미터 값의 형식이 올바른지 확인

  • SAP API가 사용 중인 특정 파라미터를 지원하는지 확인

  • 지원되는 쿼리 옵션은 SAP API 설명서를 참조하세요.

SAP 시스템 가용성 문제

SAP 시스템 사용 불가

증상: 연결 거부 오류, 시스템 응답 없음 또는 서비스 사용 불가 메시지.

​해결 방법:

  • SAP 관리자를 통해 SAP 시스템 상태 및 가용성 확인

  • 시스템에 영향을 미치는 예약된 유지 관리 기간이 있는지 확인

  • SAP 시스템 알림 또는 알려진 문제 확인

  • 시스템 가용성 확인 후 작업 재시도