翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 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 ワークロード統合は、次の 2 つの認証方法をサポートしています。

**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. 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 Material Stock オペレーション
<a name="sap-ms-operations"></a>

マテリアルストックデータの管理に使用できるオペレーション:
+ **Get Material Stock In Account** - アカウントモデルに投稿されたマテリアル株式情報を取得します。

  **オペレーション ID:** `getMaterialStockInAccount`

### SAP 物理インベントリドキュメントオペレーション
<a name="sap-pi-operations"></a>

物理インベントリドキュメントを管理するために使用できるオペレーション:
+ **PhysInventory Doc 項目の取得** - 物理インベントリ項目に関する情報を読み取ります

  **オペレーション 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 | 返される項目の数を制限します | integer | 
| 2 | \$1skip | 指定された数の項目をスキップします | integer | 
| 3 | \$1filter | 指定された基準に基づいて結果をフィルタリングします | string | 
| 4 | \$1orderby | 指定されたフィールドで結果を注文する | array | 
| 5 | \$1select | 返す特定のプロパティを選択します | array | 
| 6 | \$1expand | 関連エンティティを展開 | array | 
| 7 | \$1inlinecount | レスポンスの項目数が含まれます。 | string | 

## 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. 共有オプションを設定します。
   + **特定のユーザーと共有** - ユーザー名または E メールアドレスを入力します。
   + **組織と共有** - 組織内のすべてのユーザーが利用できるようにします。

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 とクライアントシークレットが正しいことを確認する
+ トランザクションを使用して SAP で OAuth が正しく設定されていることを確認します。 `/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`、 など`$skip`) `$top`を使用していることを確認する
+ パラメータ値が適切にフォーマットされていることを確認します。
+ SAP API が使用されている特定のパラメータをサポートしていることを確認します。
+ サポートされているクエリオプションについては、SAP API ドキュメントを参照してください。

### SAP システムの可用性の問題
<a name="sap-system-availability"></a>

SAP システムの非可用性  
**症状:** 接続がエラーを拒否した、システムが応答しない、またはサービスが使用できないメッセージ。  
**解決策:**  
+ SAP 管理者による SAP システムのステータスと可用性の確認
+ システムに影響するメンテナンスウィンドウがスケジュールされているかどうかを確認する
+ SAP システムアラートまたは既知の問題がないか確認する
+ システムの可用性を確認した後、オペレーションを再試行する