SXA Storefrontのトラブルシューティング

Version: 10.1
日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

次の表に、SXA Storefrontに関連する一般的な問題と、推奨される解決策を示します。その他の質問に対する回答は、よくある質問で見つけることができます。

取り付け

発行

解決

既存のテナントのオーバーライド テンプレートは、最新バージョンのSitecore XCにアップグレードした後は存在しません。

上書きテンプレートは、既存のサイトに手動で追加する必要があります。 オーバーライド・カタログ・テンプレートの構成を参照してください。カタログ テンプレートの作成、またはカスタム カタログまたはアップグレードされたソリューションのダイレクト ナビゲーションの有効化については、「 既存のサイトでのダイレクト ナビゲーションの構成」を参照してください。

ストアフロントバックエンド

発行

解決

メインサイトと同じホスト名を使用するサブサイト(仮想フォルダを含む)を作成するときにエラーが発生しました。

SXAサイト マネージャーを開き、サブサイト (および仮想フォルダー) がリストのメイン サイトの上にリストされていることを確認します。

データベースに書き込まれるレコードの数を減らすために、xDBでの追跡からAPIを除外するにはどうすればよいですか?

excludeUrlTrackingセクションを含むように構成設定を変更します

製品リストのキャッシュはどのように設定しますか?

「製品リストキャッシュの設定」を参照してください。

HTMLキャッシングをオフにするにはどうすればよいですか?

ストアフロント サイト全体のHTMLキャッシングをオフにするには、コンテンツ エディターからsitecore/Content/<tenant>/<site>/Settings/Site Grouping/<site>に移動します。 ContentタブのFlagsセクションで、Cache Htmlチェック ボックスをオフにします。

レイアウトとコンポーネントは、カタログ アイテムを直接開いたり、カタログ アイテムに移動したりするときに、エクスペリエンス エディターで編集できません。ただし、一部のテキストは編集できます。

エクスペリエンスエディターでカテゴリページと製品ページを開くには、/sitecore/content/Sitecore/Storefront/Presentation/Partial Designs/Default Main Category Pageまたは /sitecore/content/Sitecore/Storefront/Presentation/Partial Designs/Default Main Product Page Content

または、プロモーション商品コンポーネントから詳細をクリックして、商品詳細ページを開くことができます。

プロモーション製品のレンダリングでは、コンテンツはレンダリングされません。

Commerceレンダリングは偽造防止メタレンダリングに依存しているため、Commerceレンダリングが期待どおりに動作するように、すべてのストアフロントページに偽造防止メタレンダリングを含める必要があります。

ツールボックスが空で、「現時点ではレンダリングをページに追加することはできません」というメッセージが表示されます。

エクスペリエンスエディターでカテゴリページと製品ページを開くには、/sitecore/content/<tenant>/<site>/Presentation/Partial Designs/Default Main Category Pageまたは Content/sitecore/content/<tenant>/<site>/Presentation/Partial Designs/Default Main Product Page Content

ProductListRenderingModelのChildProductsプロパティが、カテゴリに製品が含まれている場合でも、レンダリング (\Views\Commerce\Catalog\ProductList.cshtml) が常にNULLになるのはなぜですか?

ProductListレンダリングは、以前はRazorレンダリングであり、製品リストのデータ ソースとしてProductListRenderingModel.ChildProductsプロパティを使用していました。Sitecore 9.2では、レンダリングがAjax呼び出しを使用して (CatalogController.GetProductListエンドポイントから) 製品を読み込むように変更され、ChildProductsプロパティを含むAjaxレスポンスとしてProductListRenderingModelタイプではなくProductListJsonResultタイプを使用するようになりました。現在、ProductListRenderingModelタイプは、ProductListレンダリングがコンフィギュレーション パラメーターを渡すためのレンダリング モデルとしてのみ使用され、製品データは引き継がれません。ProductListRenderingModelは、UseLazyLoadingMaxPageSize、およびCurrentCatalogItemId構成パラメータの値のみを保持します。その他のプロパティはレガシーであり、非推奨になります。ビュー ファイル内のロジックもレガシであり、Model.ShowNoResultMessageプロパティが常にfalseに設定されているため、実行されることはありません。ProductListレンダリング データ フローのカスタマイズ、デバッグ、または操作には、ProductListJsonResultと関連するKnockout jsモデルを使用します。

ストアフロントフロントエンド

発行

解決

すべての国/地域は、構成設定に関係なくストアフロントに表示されます。

ナレッジベースの記事を参照してください。

検索結果のランク付け方法に影響を与えることはできますか?つまり、特定の検索結果をリストの一番上に押し上げることはできますか?

はい、Sitecore 9.3以降では可能です。 検索結果のブーストをご覧ください。

Storefrontサインインに別の識別子を実装できますか?

ストアフロントは、識別子としてメールアドレスのみをサポートしています。さらに、顧客が登録時に間違ったメールアドレスを入力した場合、顧客がメールアドレスを修正できるすぐに使えるアカウントパージプロセスはありません。

カタログが構成されているにもかかわらず、"カタログが構成されていません" エラー。

Commerce Navigationレンダリング バリアントで ナビゲーション設定が定義 されていることを確認します。

Creative Exchangeは、ストアフロント レンダリングのAuthorize属性とValidateAntiForgeryToken属性をエクスポートしません。

Creative Exchangeは、CMインスタンスで使用される開発者ツールです。これは、運用環境を対象としていません。Creative Exchangeは認証を処理しないため、ストアフロント レンダリングのAuthorize属性とValidateAntiForgeryToken属性はCreative Exchangeエクスポートの一部ではありません。

headセクションに2つの正規メタタグとタイトルタグがあると、カテゴリメニューが2回表示されます。

コマースメタレンダリングを参照してください。

重複するパーシャルデザインには同じ名前が付けられます。

表示名を変更するには、リボンのHomeタブでDisplay nameをクリックし、パーシャル デザインの名前を変更します。または、コンテンツ エディターでパーシャル デザインを選択し、ContentタブのAppearanceセクションで、Display nameフィールドに新しい名前を入力します。

重複する商品は検索結果に表示されます。

SXA Storefrontでのカタログの設定 」および 「SXA Storefrontでのサイト検索の設定」を参照してください。

カートがCommerce Engineからパージされているにもかかわらず、メールが送信されている。

キャンペーンのタイムアウト値に従ってPurgePolicyを再構成します。

パスワードを忘れた場合の機能は、SXAストアフロント サイトでは機能しません。

ナレッジベースの記事を参照してください。

他のサイトから製品にアクセスできます。

カタログ アイテム コンテナ レンダリングを使用すると、同じテナントの下にあるかどうかに関係なく、コンテンツ内の任意のアイテムに関連付けることができます。特定のサイトへのアクセスを制限するには、LinkProviderを変更する必要があります。

ターゲット アイテムへのパスが現在のサイトの外部にある場合、Sitecoreは /sitecore/Contentからの完全なパスを使用します。

メモ

サイト間でコンテンツを共有するのは、サイトが同じテナントの下にある場合にのみ行うようにしてください。

デフォルトのコマースヘッダーのパーシャルデザインで使用されるロゴは、ストアフロントブランドテーマの使用時にモバイル/レスポンシブモードで 表示されません。

エクスペリエンス エディターでパーシャル デザインを開き、ストアフロントのロゴが表示されるまでブラウザー ウィンドウのサイズを変更します。

ライブストアフロントのナビゲーションは、言語を切り替えると消えます。

すべての言語がライブ サイトに公開されていることを確認します。

カタログに追加された新しいアイテムは、ストアフロント サイトに表示されません。

キャッシュとインデックスの手動更新を参照してください。

ストアフロントページの読み込みにかかる時間は、以前のリリースよりも遅くなっています。

Sitecore 9.3では、新しいレンダリングが追加されました。これらのレンダリングは、カスタマイズに関してより柔軟性を提供します。ただし、それらを使用すると、ページの読み込み時間に影響を与える可能性があります。Storefrontサイト テンプレート ページを以前のレンダリングに戻すには、「既定のStorefrontサイト テンプレート ページの変更」を参照してください。

ストアフロントでのパフォーマンスが低下しています。

この問題を軽減するには、CMS専用モードを有効にします

ミニカートの中身を取り出すときの性能が悪い。

ミニカートの再計算を無効にします。

商品は複数のカテゴリに表示されるため、検索結果が重複します。

「カタログの設定」および「SXA Storefrontでのサイト検索の設定」を参照してください。

サブカテゴリ ナビゲーション レンダリングで結果が正しく並べ替えられません。

ページリストのレンダリングを使用します。

価格またはプロモーション情報はインデックス化され、価格または販売中の並べ替え順序を作成するときに利用できますか?

いいえ。検索結果を価格やプロモーションで並べ替えることはできません。

仮想フォルダの使用時に「ドキュメントが見つかりません」というエラーが発生します。

Sitecoreは、受信URLとhostNameおよびvirtualFolderに基づいてサイト コンテキストを決定し、サイト マネージャーにサイトがリストされている順序で決定します。デスクトップからSite Managerにアクセスするには、Powershell Toolbox をクリックします。この問題を解決するには、サイト マネージャー サイト リストで、メイン ストアフロント サイトの前の仮想フォルダーを使用してサイトを移動します。「SXA Site Managerを使用した複数のサイトの管理」を参照してください。

SXA Storefrontサイトが見つからないか、ナビゲーション バーなしで表示されます。

次のことを確認します。

  • CatalogStart Navigation Categoryフィールド ( sitecore/Content/<tenant>/<site>/Settings/Commerce/Catalog Configuration) は、コマース カテゴリ ナビゲーションを使用している場合、正しい値を持ちます。 ストアフロントに表示するカテゴリーを選択するを参照してください。

  • Host Nameフィールド (sitecore/Content/<tenant>/<site>/Settings/Site Grouping/<site>) は正しく、sxa.storefront.comに設定されています。指定されたホスト名の値がデフォルトのストアフロントホスト名と一致しない場合、デフォルトのストアフロントサイトはロードできません。

  • オーバーライド テンプレートが割り当てられています。次のトピックを順を追って説明します: チュートリアル: 既存のサイトでの直接ナビゲーションの構成

詳細については、「 カタログの構成」を参照してください。

その後、更新を公開し、Solrインデックスを再構築します。トラブルシューティングしている問題の解決策は、Installation Guide for On Premiseで見つけることができます。

脆弱なパスワード ポリシーにより、ユーザーは安全でないパスワードを選択できます。

ストアフロントには、Sitecoreセキュリティで定義されたデフォルトのパスワード ポリシーが付属しています。ただし、パスワード ポリシーは強力ではなく、改善される可能性があります。強力なパスワード・ポリシーでは、次の特性を持つパスワードが強制されます。

  • 大文字と小文字の両方を使用します。

  • 数字と特殊文字が含まれています。

  • 一般的な形式(カレンダーの日付、電話番号など)を禁止します。

  • 一般的な辞書エントリを禁止します。

パスワードポリシーの設定を参照してください。

個々のストアフロント サイトの環境を構成できません。環境フィールドがありません。

不足しているフィールドを手動で作成でき、Sitecore.Commerce.Engine.Connect.EngineConnectUtility.GetShopEnvironmentによって使用されます。

コンテンツ エディタで、/sitecore/Templates/CommerceConnect/Sitecore Commerce/Commerce Control Panel/Storefront Settings/Storefront/<site> に移動します。 Commerce Control Panelを右クリックし、Insert, Template fieldをクリックします。 Messageダイアログボックスで、「 Environment 」と入力し、「 OK」をクリックします。

コンテンツ エディターで /sitecore/Commerce/Commerce Control Panel/Storefront Settings/Storefronts/<site>に移動し、ストアフロント サイトをクリックして、ContentタブのCommerce Control Panelセクションで 環境 フィールドに値 (例: HabitatShops) を割り当てます。変更を保存して公開します。

ストアフロント サイトを開始し、HTTP ODataがCommerce Engineを呼び出し、Environment HTTPヘッダー値が定義した環境値を使用していることを確認します。そうでない場合は、C:\inetpub\wwwroot\xp0.sc\App_Config\Include\Y.Commerce.Engine\Sitecore.Commerce.Engine.Connect.config ファイルに設定されているもの (<defaultEnvironment>HabitatShops</defaultEnvironment> など) にフォールバックする必要があります。

解析学

発行

解決

レポート データには、すべての顧客アクティビティが含まれているわけではありません。

これは、MaxPageIndexThresholdが低すぎることが原因である可能性があります。最大値に達すると、それ以上の顧客アクティビティは記録されません。 ページのイベント、目標、結果、カスタム分析データをご覧ください。

エクスペリエンスプロファイルレポートには、匿名連絡先の分析は含まれません。

デフォルトでは、匿名の連絡先はインデックス化されません。匿名ユーザーのインデックスを有効にするには、scの /App_Data\jobs\continuous\IndexWorker\App_Data\config\sitecore\SearchIndexer と に移動します。構成ファイルXdb.Collection.IndexerSettings.xml、IndexAnonymousContactDataをtrueに設定します。詳細については、「 xDBインデックスでの匿名連絡先のインデックス作成の有効化」を参照してください。

アナリティクスには、すべてのオーダーが含まれているわけではありません。

すべての注文を分析に含めるには、マーケティング定義をデプロイする必要があります。

訪問した製品ページとカテゴリ ページ イベントはxDBに記録されません。

製品またはカテゴリの訪問を、カテゴリと製品の詳細情報とともにxDBに記録するには、Visited Product PageレンダリングまたはVisited Category Pageレンダリングをページに追加する必要があります。これらのレンダリングはライブストアフロントには表示されませんが、エクスペリエンスエディターには表示されます。

たとえば、Visited Category Page Eventsレンダリングをカテゴリ ページに追加するには、コンテンツ エディタでカテゴリ ページ (sitecore/Content/<tenant>/<site>/Presentation/Partial Designs/Category Page Content) を選択し、リボンのPresentationタブでDetailsをクリックします。 Layout DetailsダイアログボックスでMVC Layoutをクリックし、ダイアログボックスの左側にあるリストでControlsをクリックします。コントロールのリストで、「 Visited Category Page」をクリックし、「 OK」をクリックします。 Layout Detailsダイアログボックスで、もう一度OKをクリックします。

大事な

最適化 タブからイベントを有効にしないでください。イベントのカスタム値はxDBに含まれません。

エラー

発行

解決

ECMです。ImagesAreNotAvailableです。

Commerceマーケティング自動化キャンペーンでは、会社のロゴを含む事前構成された電子メール テンプレートを使用します。このエラーを解決するには、使用するロゴをメディアライブラリにアップロードします。

コンテンツエディターで検索を実行すると、Search.logにSOLRエラーが記録されます。

コンテンツ エディタで、/sitecore/System/Settings/Buckets/Facets/CommerceConnect/Inventoryに移動します。リストされている各品目 (在庫ありの場所、注文可能な場所、在庫切れの場所、予約注文可能) について、ContentタブのFacetセクションで、Enabledチェック ボックスをオフにします。リボン メニューで、変更を保存します。

サイトの仮想ディレクトリへのAJAX呼び出しにより、エラーが発生します。

これは、AJAX呼び出しで仮想ディレクトリ フォルダ名がURLに追加され、フォルダ名に大文字が含まれている場合に発生します。この問題を解決するには、フォルダ名を小文字に変更します。

ストアフロント テーマのエクスポートは部分的にしか完了していません。Index.htmlファイルに「オブジェクトが移動しました」というメッセージが含まれています。

ストアフロントで使用されているホスト名のsxa.storefront.com証明書または有効な証明書が使用されていることを確認します。

「GUIDには32桁の数字と4つのダッシュが含まれている必要があります」というエラーが表示されます。

マスター インデックスとWebインデックスを再構築します。

コマースマーケティングオートメーションキャンペーンは機能しません。

Commerceマーケティング オートメーション キャンペーンを設定するには、xDBがインストールされ、有効になっている必要があります。

ログのScribanエラー。

高負荷でScribanテンプレートを使用すると、競合状態が発生し、ページが正しくレンダリングされない場合があります。詳細については、Sitecoreナレッジ ベース を参照してください。

チェックアウトページへのアクセス時に「ホスト名を解析できませんでした」というエラーが表示されます。

コンテンツ エディタで、sitecore/Content/<tenant>/<site>/Settings/Site Grouping/<site>に移動します。「コンテンツ」タブの「ホスト名」フィールドで、ホスト名が1つだけ定義されていることを確認します。|(パイプ)、たとえばhabitat.dev.local|storefront.dev.local.代わりに、サイト グループ の下に複数のサイト定義アイテムを作成します。

エクスペリエンスエディターでページを表示しようとすると、「要求されたドキュメントのレイアウトが見つかりませんでした」というエラーが発生します。

「既存のサイトでのダイレクト ナビゲーションの構成」を参照してください。

新しく作成したSXA Storefrontサイトにアカウントを登録できません。

使用中の環境のJSON設定ファイルを編集し、ポリシー Sitecore.Commerce.Plugin.Customers.CustomerPropertiesPolicyのDomainプロパティの値を設定して、新しく作成されたドメイン名 (デフォルトではストアフロントの名前と一致する) を含めます。

何かフィードバックはありますか?

この記事を改善するための提案がある場合は、