接続の作成の前提条件

SAP Commerce Cloud (Hybris)アダプタとの接続を作成するには、次の前提条件を満たす必要があります:

OAuthクライアントの作成

SAP Commerce Cloud BackOfficeにログインし、「システム」 > OAuth > 「OAuthクライアント」に移動します。

「図sap_commerce_prereq1.pngの説明」
追加(+)アイコンをクリックします。「新規OAuthクライアントの作成の詳細」ダイアログ・ボックスが表示されます。

「図sap_commerce_prereq2.pngの説明」
OAuthクライアントIDとクライアント・シークレットを設定し、NEXTをクリックします。

「図sap_commerce_prereq3.pngの説明」

ノート:
クライアントIDとクライアント・シークレットは、後で「SAP Commerce Cloud (Hybris)アダプタ」接続のセキュリティを構成するときに使用します。「接続セキュリティの構成」を参照してください。

各フィールドに次の詳細を入力し、NEXTをクリックします。

要素	説明
認証局	ROLE_TRUSTED_CLIENT
クライアント権限付与タイプ	refresh_token, client_credentials, 「パスワード」
OAuthのリソースID	ブリッシュ

顧客グループ・サービスにアクセスする必要がある場合は、次の表で説明する詳細のみを入力する必要があります。

ノート:

顧客グループ・サービスにアクセスする必要がある場合は、ROLE_CUSTOMERMANAGERGROUPの認可が必要です。
顧客グループは保護されたサービスで、ROLE_CUSTOMERMANAGERGROUPで保護されています。顧客グループ・サービスにアクセスするには、顧客マネージャ・グループのメンバーである必要があります。したがって、顧客マネージャ・グループを統合ユーザーに割り当てる必要があります。「ユーザーの作成と顧客マネージャ・グループへの割当」を参照してください。
「SAP Commerce Cloud (Hybris)アダプタ」接続のリソース所有者パスワード資格証明(ROPC)セキュリティを構成して、カスタマ・グループ・サービスにアクセスします。

「スコープ」フィールドにbasicおよびextendedと入力し、NEXTをクリックします。

「図sap_commerce_prereq6.pngの説明」
「アクセス・トークンの有効期間」フィールドに、統合実行の頻度(28800など)に応じて必要な時間(秒単位)を入力します。「リフレッシュ・トークンの有効時間」フィールドに、アクセス・トークンの有効期間より大きい値(32400など)を入力します。
DONEをクリックします。

ユーザーの作成と顧客マネージャ・グループへの割当

顧客マネージャ・グループを作成してユーザーを割り当てるには、次のステップを実行します。

SAP Commerce Cloud Backofficeにログインし、「ユーザー」→「従業員」に移動します。
追加(+)アイコンをクリックします。「新規従業員の作成」ダイアログ・ボックスが表示されます。

「図create_new_employee.pngの説明」
IDを次の形式で入力します:
```
firstname.lastname@domain.com
```
たとえば: c.smith@example.com
必要な追加詳細を各フィールドに入力し、NEXTをクリックします。

「図create_new_employee2.pngの説明」
MEMBERSHIPSで、customermanagergroupを検索し、顧客マネージャ・グループにユーザーを割り当ててDONEをクリックします。

「図create_new_employee3.pngの説明」
ユーザーが作成されて顧客マネージャ・グループに割り当てられたら、ホーム・ページの「ユーザー」の下にある「従業員」をクリックします。
それぞれの顧客IDをクリックし、PASSWORDタブをクリックします。

「図create_new_employee4.pngの説明」
カスタマ・ユーザーの新しいパスワードを入力し、確認のためにパスワードを再入力して、「セーブ」をクリックします。

SAP Commerce Cloudが「SAP Commerce Cloud (Hybris)アダプタ」のカスタマイズを反映するように、特定の注釈を実行する必要があります。

SAP Commerce CloudのOmni Commerce Connect (OCC)サービスでは、3つの主要なタイプのカスタマイズが可能です。「SAP Commerce Cloud (Hybris)アダプタ」でカスタマイズを使用可能にするには、次のガイドラインに従います:

標準工程/APIでの新規カスタム・フィールドの追加

Swaggerメタデータ・ドキュメントでフィールドを検出できるように、カスタム・フィールドに@ApiParamの注釈が付けられていることを確認します。

標準オブジェクトの下への新規カスタムAPI/操作の追加

Swaggerメタデータ・ドキュメントで操作を検出できるように、操作(メソッド)に@ApiOperationおよび@ApiBaseSiteIdParamの注釈が付けられていることを確認します。

新規カスタム・オブジェクトの追加

Swaggerメタデータ・ドキュメントでオブジェクトを検出できるように、新しいオブジェクト(コントローラ・クラス)に@Api(tags = “<<Object Name>>”)の注釈が付けられていることを確認します。前述の情報に従って、操作およびフィールドを追加できます。

ノート:

<<Object Name>> を、追加する必要があるオブジェクトの実際の名前に置き換えます。

SAP Commerce CloudのOmni Commerce Connect (OCC)サービスのカスタマイズを使用して、SAP Commerce Cloudの製品のイメージをアップロードできます。

製品のイメージをアップロードするには、次のステップを実行します:

SAP Commerce CloudのOCCサービスに新しいオブジェクトを追加します。「新規カスタム・オブジェクトの追加」を参照してください。
カスタム・オブジェクトが作成されたら、Swaggerファイルを開きます。カスタム・オブジェクト(つまり、メディアとサービス(エンドポイント))がSwaggerファイルに表示されます。

SOAPアダプタ接続を使用して、Base64形式のイメージをOracle Integrationに送信できます。
SOAPアダプタをトリガー接続として構成し、Oracle Integrationの統合の起動接続としてSAP Commerce Cloudアダプタを構成します。
マッパーで、マッピングを実行します。イメージは、マッパーの関数を使用して添付参照タイプにデコードされます。同じイメージが、リクエスト・ペイロードで渡された製品IDに基づいて製品にアップロードされます。

アップロードしたイメージをバック・オフィスで確認するには: