チュートリアル: トラブルシューティング コンポーネントの実装
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
トラブルシューターは、選択したSitecoreアイテムが正しく設定され、適切に動作しているかどうかを判断するロジックをSitecoreユーザーが実行できるようにするコンポーネントです。
このチュートリアルでは、テキスト ファイルのカスタム プロバイダーの実装に関するチュートリアル シリーズで構成されたファイル システム プロバイダーにトラブルシューティング機能を追加します。これにより、Sitecoreサーバーがアクセスできるファイルを使用するようにファイル システム エンドポイントが設定されているかどうかを判断できるトラブルシューティング ツールが追加されます。
トラブルシューターは、もともとエンドポイント用に設計されました。これらは、エンドポイントが適切に設定されているかどうかをユーザーが判断できるようにするために使用されます。これはトラブルシューターの主な用途ですが、アイテムが次のData Exchange Framework基本テンプレートから継承されていれば、任意のタイプのアイテムで使用できます。
-
Convertible
-
Troubleshootable
このチュートリアルでは、次の方法について説明します。
-
トラブルシューターコンポーネントを構築する
-
エンドポイントでのトラブルシューティング ツールを指定する
-
トラブルシューティング ツールをテストする
完成したコードとインストール パッケージは 、GitHubで入手できます。
トラブルシューターコンポーネントを構築する
Microsoft Visual Studioでトラブルシューティング コンポーネントを作成し、サーバーに配置する必要があります。
トラブルシューターコンポーネントを作成するには:
-
Visual Studioで、次のクラスを追加します。
手記このトラブルシューターは、Sitecore.DataExchange.Troubleshooters.BaseEndpointTroubleshooter.任意のタイプのコンポーネントに対してカスタムトラブルシューティングを作成するには、から継承Sitecore.DataExchange.Troubleshooters.ITroubleshooter。
-
プロジェクトをコンパイルします。
-
Examples.DataExchange.Providers.FileSystem.dllをSitecoreサーバーにデプロイします。
エンドポイントでのトラブルシューティング ツールを指定する
トラブルシューターは、Data Exchange FrameworkテンプレートConvertibleおよびTroubleshootableから継承する任意のアイテムに指定できます。
この例では、トラブルシューティング ツールは、条件を満たすBase Endpointテンプレートから継承されるテキスト ファイル エンドポイントに追加されるため、追加の作業は必要ありません。
エンドポイントでトラブルシューティング ツールを指定するには:
-
コンテンツ エディターで、/sitecore/templates/Data Exchange/Providers/File System/Endpoints/Text File Endpoint/__Standard Valuesに移動します。
-
右側のペインで、次のフィールド値を指定します。
畑
価値
Troubleshooter Type
Examples.DataExchange.Providers.FileSystem.TextFileEndpointTroubleshooter, Examples.DataExchange.Providers.FileSystem
-
アイテムを保存します。
トラブルシューティング ツールをテストする
トラブルシューティング ツールはテキスト ファイル エンドポイントに割り当てられているため、トラブルシューティング ツールをテストするには、次の操作を行う必要があります。
-
コンテンツ エディターで、テナントを選択します。 Endpoints/Providers/File System/City Information Fileに移動します。
-
メニュー リボンで、Run Troubleshooterをクリックします。
エンドポイントが適切に設定され、ファイルが存在し、Sitecoreサーバーがファイルにアクセスできる場合は、成功メッセージが表示されます。

エンドポイントにファイルパスが指定されていない場合は、エラーメッセージが表示されます。

エンドポイントにファイル パスが指定されているが、ファイルが存在しない場合、またはファイル権限によってSitecoreサーバーがファイルにアクセスできない場合は、エラー メッセージが表示されます。
