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

# SAP 워크로드 통합
<a name="sap-integrations"></a>

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

## 할 수 있는 작업
<a name="sap-integrations-capabilities"></a>

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

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

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

## 시작하기 전 준비 사항
<a name="sap-integrations-prerequisites"></a>

SAP 워크로드 통합을 설정하기 전에 다음이 있는지 확인합니다.
+ 적절한 모듈이 설치 및 구성된 SAP 시스템.
+ 필요한 권한 및 권한이 있는 SAP 사용자 계정.
+ Amazon Quick Author 이상.
+ Amazon Quick과 SAP 시스템 간의 네트워크 연결.

## SAP 시스템 구성 및 인증 준비
<a name="sap-system-preparation"></a>

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

### 인증 방법
<a name="sap-authentication-methods"></a>

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 시스템 구성 요구 사항
<a name="sap-system-configuration"></a>

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

#### OAuth 2.0 설정
<a name="sap-oauth-setup"></a>

OAuth 2.0 인증의 경우:
+ 적절한 범위로 OAuth 권한 부여 서버 구성
+ 트랜잭션 코드를 사용하여 서비스에 OAuth가 활성화되어 있는지 확인 `/IWFND/MAINT_SERVICE`
+ 자세한 OAuth 2.0 구성은 SAP 설명서: [OAuth 2.0 구성 가이드를](https://help.sap.com/docs/ABAP_PLATFORM_NEW/fd0fc52fd22b45f29d274a7f8236e768/cdb122d5b0784c77bf1bcce17f730e74.html) 참조하세요.

#### SAP API 활성화
<a name="sap-api-activation"></a>

필요한 SAP API 서비스가 활성 상태인지 확인합니다.
+ 선택한 SAP 커넥터에 대한 특정 API 서비스 활성화
+ SAP 시스템에서 API 서비스 상태 확인
+ API 활성화에 대한 SAP 설명서: [SAP API 서비스 활성화 가이드를](https://help.sap.com/doc/saphelp_nw75/7.5.5/en-US/1b/023c1cad774eeb8b85b25c86d94f87/frameset.htm) 참조하세요.

### 사용 가능한 SAP 워크로드 통합 유형
<a name="sap-integration-types"></a>

비즈니스 요구 사항에 맞는 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 워크로드 인증 설정
<a name="sap-authentication-setup"></a>

SAP 사용자 인증 자격 증명을 준비하고 적절한 시스템 액세스 권한을 확인합니다.
+ **SAP 시스템 URL** - SAP 시스템의 기본 URL 또는 서버 주소를 가져옵니다.
+ **사용자 자격 증명** - 적절한 권한이 있는 SAP 사용자 계정을 생성하거나 식별합니다.
+ **시스템 권한** - 사용자 계정에 통합하려는 특정 SAP 모듈에 필요한 SAP 권한 부여 및 트랜잭션 코드가 있는지 확인합니다.
+ **네트워크 액세스** - SAP 시스템이 외부 연결에서 액세스할 수 있고 방화벽 규칙이 통합을 허용하는지 확인합니다.

## SAP 통합 설정
<a name="sap-integrations-setup"></a>

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

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

1. 사용 가능한 SAP 커넥터 중 하나를 선택합니다.
   + **SAP 재료표**
   + **SAP 비즈니스 파트너**
   + **SAP 재료 재고**
   + **SAP 물리적 인벤토리 문서**
   + **SAP 제품 마스터**

1. **추가**(더하기 "\$1" 버튼)를 클릭합니다.

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

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

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

   1. <a name="sap-oauth-configuration"></a>**OAuth 2.0 구성**

      OAuth 2.0 인증의 경우 다음을 제공합니다.
      + **클라이언트 ID** - SAP OAuth 클라이언트 ID
      + **클라이언트 보안 암호** - SAP OAuth 클라이언트 보안 암호
      + **토큰 URL** - OAuth 토큰 엔드포인트 URL
      + **도메인 URL** - SAP 시스템 API 엔드포인트 URL

   1. <a name="sap-basic-auth-configuration"></a>**기본 인증 구성**

      기본 인증의 경우 다음을 제공합니다.
      + **사용자 이름** - SAP 시스템 사용자 이름
      + **암호** - SAP 시스템 암호
      + **도메인 URL** - SAP 시스템 API 엔드포인트 URL

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

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

1. **다음**을 클릭합니다.

### 예상 결과
<a name="sap-integrations-setup-results"></a>

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

## 커넥터 유형별 사용 가능한 작업
<a name="sap-available-operations"></a>

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

### SAP 자재 명세서 작업
<a name="sap-bom-operations"></a>

재료표 데이터 관리에 사용할 수 있는 작업:
+ **재료 BOM 항목 가져오기** - 지정된 재료에 대한 재료 명세서 세부 정보를 검색합니다.

  **작업 ID:** `getMaterialBOMItem`

  **엔드포인트:** `GET /MaterialBOMItem`

### SAP 비즈니스 파트너 운영
<a name="sap-bp-operations"></a>

비즈니스 파트너 데이터 관리에 사용할 수 있는 작업:
+ **비즈니스 파트너 가져오기** - 비즈니스 파트너 일반 데이터를 검색합니다.

  **작업 ID:** `getBusinessPartner`
+ **비즈니스 파트너 주소 가져오기** - 비즈니스 파트너 주소 데이터를 검색합니다.

  **작업 ID:** `getBusinessPartnerAddress`
+ **비즈니스 파트너 역할 가져오기** - 비즈니스 파트너 역할 데이터를 검색합니다.

  **작업 ID:** `getBusinessPartnerRole`
+ **ID로 비즈니스 파트너 가져오기** - 비즈니스 파트너 번호를 기준으로 비즈니스 파트너 데이터를 검색합니다.

  **작업 ID:** `getBusinessPartnerByID`

  **필수 파라미터:** `BusinessPartner` (문자열, 최대 10자)
+ **ID로 비즈니스 파트너 역할 가져오기** - 키 필드를 사용하여 비즈니스 파트너 역할 데이터를 검색합니다.

  **작업 ID:** `getBusinessPartnerRoleByID`

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

### SAP 재료 재고 작업
<a name="sap-ms-operations"></a>

재료 재고 데이터를 관리하는 데 사용할 수 있는 작업:
+ **계정에서 재료 재고 가져오기** - 계정 모델에 게시된 재료 재고 정보를 검색합니다.

  **작업 ID:** `getMaterialStockInAccount`

### SAP 물리적 인벤토리 문서 작업
<a name="sap-pi-operations"></a>

물리적 인벤토리 문서를 관리하는 데 사용할 수 있는 작업:
+ **PhysInventory 문서 항목 가져오기** - 물리적 인벤토리 항목에 대한 정보를 읽습니다.

  **작업 ID:** `getPhysInventoryDocItem`

### SAP Product Master 작업
<a name="sap-pm-operations"></a>

제품 마스터 데이터 관리에 사용할 수 있는 작업:
+ **제품 마스터 항목 가져오기** - 제품 마스터 레코드를 반환합니다.

  **작업 ID:** `getProductMaster`
+ **재료별 공장 데이터 가져오기** - 제품 마스터 레코드의 공장 데이터를 반환합니다.

  **작업 ID:** `getPlantDataByMaterial`

  **필수 파라미터:** `Product` (문자열, 최대 40자)
+ **자재별 공급 계획 데이터 가져오기** - 제품 번호 및 공장별로 공급 계획 데이터를 반환합니다.

  **작업 ID:** `getSupplyPlanningDataByMaterial`

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

## 쿼리 파라미터
<a name="sap-odata-parameters"></a>

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


**지원되는 쿼리 파라미터**  

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

## SAP 워크로드 통합 관리
<a name="sap-integrations-management"></a>

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

### 통합 설정 편집
<a name="sap-integrations-editing"></a>

SAP 워크로드 통합 설정을 수정하려면 다음 단계를 따르세요.

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

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

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

1. 통합 설정 수정:
   + 인증 자격 증명(사용자 이름 및 암호)을 업데이트합니다.
   + SAP 시스템 URL 또는 연결 설정을 변경합니다.
   + 통합 이름 또는 설명을 수정합니다.

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

### 통합 공유
<a name="sap-integrations-sharing"></a>

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

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

1. 공유 옵션 구성:
   + **특정 사용자와 공유** - 사용자 이름 또는 이메일 주소를 입력합니다.
   + **조직과 공유** - 조직의 모든 사용자가 사용할 수 있도록 합니다.

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

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

### 통합 삭제
<a name="sap-integrations-deletion"></a>

SAP 통합을 영구적으로 제거하려면 다음 단계를 따르세요.

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

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

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

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

## SAP 워크로드 통합 문제 해결
<a name="sap-integrations-troubleshooting"></a>

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

### 인증 문제
<a name="sap-authentication-issues"></a>

OAuth 2.0 인증 실패  
**증상:** 토큰 생성 실패, 잘못된 클라이언트 자격 증명 또는 OAuth 범위 오류.  
**​해결 방법:**  
+ OAuth 클라이언트 ID 및 클라이언트 보안 암호가 올바른지 확인
+ 트랜잭션을 사용하여 OAuth가 SAP에서 올바르게 구성되었는지 확인 `/IWFND/MAINT_SERVICE`
+ SAP 워크로드 커넥터 유형에 필요한 범위가 올바르게 구성되어 있는지 확인합니다.
+ 토큰 URL 형식이 SAP 시스템 구성과 일치하는지 확인

기본 인증 실패  
**증상:** 로그인 실패, 잘못된 자격 증명 또는 액세스 거부 오류.  
**​해결 방법:**  
+ SAP 사용자 이름과 암호가 올바른지 확인
+ 사용자 계정에 필요한 SAP 권한 부여가 있는지 확인
+ 사용자 계정이 잠기거나 만료되지 않았는지 확인합니다.
+ 도메인 URL에 액세스할 수 있고 형식이 올바른지 확인합니다.

### SAP 시스템 구성 문제
<a name="sap-system-configuration-issues"></a>

API 서비스가 활성화되지 않음  
**증상:** 서비스 사용 불가 오류, API 엔드포인트를 찾을 수 없음 또는 HTTP 404 응답.  
**​해결 방법:**  
+ 시스템에서 필요한 SAP API 서비스가 활성화되었는지 확인
+ SAP 트랜잭션 코드를 사용하여 API 서비스 상태 확인
+ API 서비스가 선택한 SAP 커넥터 유형에 해당하는지 확인합니다.
+ SAP 관리자에게 문의하여 누락된 API 서비스를 활성화합니다.

연결 시간 초과  
**증상:** 요청 제한 시간, 네트워크 연결 오류 또는 느린 응답 시간.  
**​해결 방법:**  
+ SAP 시스템 URL이 올바르고 액세스 가능한지 확인
+ 네트워크 연결이 SAP 시스템에 대한 연결을 허용하는지 확인
+ 방화벽 규칙이 통합 트래픽을 허용하는지 확인
+ SAP 시스템 성능 및 가용성 확인

### 권한 및 권한 부여 오류
<a name="sap-permission-errors"></a>

SAP 권한 부여 부족  
**증상:** 액세스 거부 오류, 권한 부여 메시지 누락 또는 제한된 작업 실패.  
**​해결 방법:**  
+ 인증된 사용자에게 특정 모듈에 필요한 SAP 인증이 있는지 확인합니다.
+ 사용자에게 필요한 트랜잭션 코드에 대한 액세스 권한이 있는지 확인
+ 사용자 계정에 적절한 역할 할당이 있는지 확인합니다.
+ SAP 관리자에게 문의하여 누락된 권한 부여

범위 권한 오류  
**증상:** OAuth 범위 오류, API 작업에 대한 권한 부족 또는 제한된 액세스 메시지.  
**​해결 방법:**  
+ OAuth 구성에 커넥터 유형에 필요한 범위가 포함되어 있는지 확인합니다.
+ SAP 시스템에서 범위 권한이 제대로 부여되었는지 확인
+ OAuth 클라이언트에 필요한 API 액세스 권한이 부여되었는지 확인합니다.

### 데이터 형식 및 파라미터 오류
<a name="sap-data-format-errors"></a>

잘못된 파라미터 형식  
**증상:** 데이터 검증 오류, 잘못된 필드 길이 메시지 또는 파라미터 형식 예외.  
**​해결 방법:**  
+ 작업 파라미터를 검토하고 예상 SAP 데이터 형식과 일치하는지 확인합니다.
+ 필드 길이가 SAP 시스템 요구 사항과 일치하는지 확인(예: BusinessPartner 최대 10자)
+ 특정 SAP 모듈에 대한 데이터 형식이 올바른지 확인
+ 작업에 대한 모든 필수 필드가 제공되었는지 확인합니다.

쿼리 파라미터 오류  
**증상:** 쿼리 구문 오류, 지원되지 않는 파라미터 메시지 또는 잘못된 요청 오류.  
**​해결 방법:**  
+ 파라미터가 올바른 구문을 사용하는지 확인(예: , `$filter``$top`, `$skip`)
+ 파라미터 값의 형식이 올바른지 확인
+ SAP API가 사용 중인 특정 파라미터를 지원하는지 확인
+ 지원되는 쿼리 옵션은 SAP API 설명서를 참조하세요.

### SAP 시스템 가용성 문제
<a name="sap-system-availability"></a>

SAP 시스템 사용 불가  
**증상:** 연결 거부 오류, 시스템 응답 없음 또는 서비스 사용 불가 메시지.  
**​해결 방법:**  
+ SAP 관리자를 통해 SAP 시스템 상태 및 가용성 확인
+ 시스템에 영향을 미치는 예약된 유지 관리 기간이 있는지 확인
+ SAP 시스템 알림 또는 알려진 문제 확인
+ 시스템 가용성 확인 후 작업 재시도