使用方法 App ConnectSalesforce Commerce Cloud デジタルデータ
Salesforce Commerce Cloud Digital Data （旧Demandware）は、顧客にオンライン統一ショッピング体験を提供するクラウドベースのソリューションを企業に提供します。 このプラットフォームにより、企業は貴重なインサイトの獲得から顧客のニーズを予測することができ、顧客は迅速かつ容易に商品を閲覧し、購入することができる。
- ショップAPIは、商品の閲覧や購入の完了など、ウェブサイト上でのインタラクションのためのものです。
- Data APIは、商品在庫や顧客リストなどのバックエンドシステムリソース用です。
- Meta APIは、カスタム属性を含む、オープン・コマースAPIで提供されるリソースやドキュメントに関する詳細です。
App Connect 現在、 Salesforce Commerce Cloud Digital Data アプリケーションで Data API をサポートしている。
以下の情報では App Connect を使用して、 Salesforce Commerce Cloud Digital Data を他のアプリケーションに接続する方法について説明します。
対応製品およびAPIバージョン
このコネクタがサポートする製品およびAPIバージョンを確認するには、 IBM サポートページの詳細システム要件を参照してください。
Salesforce Commerce Cloud デジタルデータへの接続
接続するには App ConnectSalesforce Commerce Cloud Digital Data アカウントに接続するには、以下の接続情報が必要です：
- 基本 URL
- API バージョン
- クライアント ID
- クライアント・シークレット
これらの設定に入力しなければならない値を確認するには、以下の表を参照してください。
| 名前 | 情報 |
|---|---|
| 基本 URL | Salesforce Commerce Cloud Digital Data インスタンスのベース URL (またはプロトコルとホスト名)。 例えば、インスタンスの URL が https://mysite.demandware.net/on/demandware.store/Sites-Site/default/ViewApplication-DisplayWelcomePage の場合、ベースとなる URL を https://mysite.demandware.net と指定します。 この値は通常、 Salesforce Commerce Cloud Digital Data ユーザー・インターフェースの Business Managerホスト名として表示されます。 |
| API バージョン | Salesforce B2C Commerce インスタンスの API バージョン。 App Connect はバージョン 18.3 と 21.3 をサポートしている。 デフォルトでは、バージョン 21.3。 APIバージョンの取得方法が不明な場合は、 Salesforce Commerce Cloud Digital Data 管理者にお尋ねいただくか、以下の手順に従ってください。
|
| クライアント ID |
または、 Salesforce Commerce Cloud Digital Data Business Managerアカウント( ヒント： サンドボックスやテスト環境を使用している場合、クライアントIDのデモ値
aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa を使用することができます。 |
| クライアント・シークレット | クライアントIDを取得したら、デジタル認証サーバーにアクセストークンをリクエストする必要があります。 リクエストが成功すると、Digital Authorization Serverはアクセストークンを返す。 Salesforce Commerce Cloud Digital Dataのアカウント管理者と協力して、OCAPIクライアントのクライアントシークレットを取得します。 ヒント： サンドボックスやテスト環境を使用している場合、クライアントシークレットにデモ値
aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa を使用することができます。 |
App Connect Designer ページ（以前は Catalog ページ ）から Salesforce Commerce Cloud Digital Data エンドポイントに初めて接続するには、 Salesforce Commerce Cloud Digital Data を展開し、 Connect をクリックします。 詳細については、 アカウントの管理を参照してください。
で作成したアカウントをフローで使用する前に App Connect で作成されたアカウントをフローで使う前に、そのアカウントを識別できるような意味のある名前に変更してください。 アプリケーションとAPI] ページでアカウント名を変更するには、アカウントを選択し、オプションメニュー(Ȯ)を開き、[ アカウント名の変更 ]をクリックします。
最初に考慮すべきこと
を使用する前に App ConnectSalesforce Commerce Cloud Digital Data を使用する前に、以下の点に注意してください。
- (一般的な考察) App Connect Designerの Applications and APIs ページで利用可能なトリガーイベントとアクションのリストを見ることができます。
アプリケーションによっては、イベントとアクションは環境と、コネクタが設定可能なイベントとアクションの動的検出をサポートしているかどうかに依存する。 アプリケーションが設定可能なイベントをサポートしている場合、イベント・リストの下に Show more configurable events リンクが表示されます。 アプリケーションがアクションのダイナミックディスカバリーをサポートしている場合、アクションリストの下に Show more リンクが表示されます。
- (一般的な考慮事項）アプリケーションに複数のアカウントを使用している場合、そのアプリケーションのアクションを選択したときに表示されるフィールドのセットは、アカウントによって異なる可能性があります。 フローエディターでは、アプリケーションによっては、常にアクションのための静的フィールドのキュレーションセットを提供します。 他のアプリケーションは、接続先のインスタンスで設定されているフィールドのセットを取得するために、ダイナミック・ディスカバリーを使用します。 例えば、あるアプリケーションの2つのインスタンスに2つのアカウントがある場合、最初のアカウントはすぐに使える設定を使うかもしれません。 しかし、2つ目のアカウントには余分なカスタムフィールドが設定されている可能性があります。
出来事と行動
Salesforce コマース・クラウド・デジタル・データ・イベント
これらのイベントは、フロー内のアクションを完了するためにフローを開始するトリガーとなる、このアプリケーションの変更に対するものである。
より多くの設定可能なイベントを表示します：デフォルトで表示されるイベントは、最適化された接続を使用して事前に設定されています。 新しいオブジェクトや更新されたオブジェクトについてこのアプリケーションをポーリングしてフローをトリガーできるイベントを設定すると、さらに多くの項目が利用できるようになります。
Salesforce コマース・クラウド・デジタル・データ・アクション
あなたのフローは、このアプリケーション上でこれらのアクションを完了します。
| オブジェクト | アクション | 説明 |
|---|---|---|
| アドレス | 住所の作成 | 指定された住所情報で新しい顧客住所を作成します |
| アドレスを削除 | 顧客の住所を削除します | |
| アドレスを取得する | 顧客の住所を取得する | |
| 住所の更新 | 指定された住所情報で顧客の住所を更新します | |
| 住所を更新または作成する | アドレスを更新または作成する | |
| キャンペーン | キャンペーンを作成する | 提供された情報を使用してキャンペーンを作成します |
| キャンペーンを削除する | キャンペーンをIDで削除します | |
| キャンペーンを取得する | キャンペーン情報を取得します | |
| キャンペーン更新 | 指定された情報でキャンペーンを更新します | |
| キャンペーンを更新または作成する | キャンペーンを更新または作成する | |
| カタログ | カタログを取得する | カタログを取得する |
| カタログの更新 | 提供された情報を使用してカタログを更新します | |
| カテゴリ | カテゴリーの作成 | 提供された情報を使用してカタログカテゴリを作成します。 |
| カテゴリーの削除 | カタログIDとカテゴリIDでカテゴリを削除します | |
| カテゴリを取得する | ||
| カテゴリを更新する | 提供された情報を使用してカタログカテゴリを更新します | |
| カテゴリを更新または作成する | カテゴリーの更新または作成 | |
| カスタマー | 顧客の作成 | 新しい顧客を作成します。 指定された顧客番号、認証情報、および顧客情報を使用して顧客が作成されます。 このアクションは、ログインの受け入れ基準、一意性、および必須の顧客プロパティを検証します。 アクションが顧客の作成に失敗した場合、適切なメッセージと共に400エラーコードを返します。 |
| 顧客を削除する | 顧客および顧客住所などの関連情報を削除します | |
| 顧客を取得する | 顧客情報を取得する | |
| 顧客を更新する | 指定された情報で顧客を更新します。 顧客番号は更新可能ですが、既に同じ顧客番号を持つ別の顧客が存在する場合、 CustomerNumberAlreadyInUseException が発生します。 | |
| 顧客を更新または作成する | 顧客を更新または作成する | |
| 在庫リスト | 在庫リストを作成する | 提供された情報を使用して在庫リストを作成します |
| 在庫リストを削除する | IDで在庫リストを削除します | |
| 在庫リストを取得する | 在庫リスト情報を取得する | |
| 在庫リストを更新する | 指定された情報で在庫リストを更新します | |
| 在庫リストを更新または作成する | 在庫リストを更新または作成する | |
| 製品在庫記録 | 製品在庫記録を作成する | 提供された情報を使用して製品在庫記録を作成します |
| 製品在庫レコードを削除する | IDで製品在庫レコードを削除します | |
| 製品在庫記録を取得する | 製品在庫レコードを取得する | |
| 製品在庫記録を更新する | 指定された情報で製品在庫記録を更新します | |
| 製品在庫レコードを更新または作成する | 製品在庫レコードを更新または作成する | |
| 製品 | 製品の作成 | 提供された情報を使用して製品を作成します。 同じ一意の識別子を持つ製品が存在する場合、リクエストにヘッダー x-dw-validate-existing=true が渡されない限り、その製品はクリーンアップされ上書きされます。 |
| 製品を削除 | IDで製品を削除します | |
| 製品を取得する | 製品情報を取得します | |
| 製品を更新 | 提供された情報を使用して製品を更新します。 更新可能なフィールドは以下の通りです：名前、ページ説明、詳細説明、ページタイトル、ページキーワード、ブランド、EAN、UPC、製造元SKU、製造元名、検索可能、単位、検索可能、オンラインフラグ、デフォルトバリエーションID。 | |
| 商品の更新または作成 | 製品の更新または作成 | |
| サイトクーポン | サイトクーポンを作成する | 提供された情報を使用してクーポンを作成します。 同じ一意の識別子を持つクーポンが存在する場合、そのクーポンは完全に置き換えられます。 |
| サイトクーポンを削除する | IDでクーポンを削除します | |
| サイトクーポンを取得する | クーポン情報を取得します。 クーポン文書では、stats expand を指定した場合に export_code_count、redemption_count、total_codes_count などのフィールドが返されます。 | |
| サイトクーポンを更新する | 指定された情報でクーポンを更新します | |
| サイトのクーポンを更新または作成する | サイトの更新または作成 | |
| サイトプロモーション | サイトプロモーションを作成する | 提供された情報を使用してプロモーションを作成します |
| サイトプロモーションを削除 | プロモーションをIDで削除します | |
| サイトプロモーションを取得する | 昇進情報を入手するための行動 | |
| サイト更新プロモーション | 指定された情報でプロモーションを更新します | |
| サイトプロモーションの更新または作成 | サイトプロモーションの更新または作成 | |
| サイト | サイトを取得する | 既存のサイトを取得する |
| 店舗 | 店舗を作成する | 提供された情報を使用してストアを作成します |
| ストアを削除 | IDでストアを削除します | |
| 店舗を検索する | ストア情報を取得します | |
| ストアを更新 | 指定された情報でストアを更新します | |
| ストアを更新または作成する | ストアを更新または作成する |