ナレッジ管理フラグメントの拡張

サービス・センターなどのナレッジを使用するRedwood Fusion UIでは、フラグメントを使用してそのナレッジ機能が提供されます。 このリリースより前は、独自のカスタム・アプリケーションUI内でナレッジ・フラグメントを使用することしかできず、フラグメント内で使用されているデータへのアクセスが制限されていました。 このリリースからは、フラグメント自体を拡張でき、データへのアクセスが向上するため、フラグメントに依存するすべてのUIでナレッジ・エクスペリエンスを拡張できます。 具体的には、このリリースの時点でRedwood My Knowledge、Redwood Service Center、My Help、Help Desk Requests、CX4Uおよびメンテナンス技術者ワークベンチでこの機能を利用できます。

ユーザーがナレッジを使用するUIで、ユーザーが必要としていると思われるナレッジ・エクスペリエンスを作成します。 これは、実装に不要な機能の非表示、コンテンツの再配置、検索結果の公開、またはユーザーが必要と考えるツールへの追加を意味する場合があります。

有効化のステップ

Visual Builder Studioを活用して、アプリケーションを公開します。 Visual Builderを使用したアプリケーションの拡張の詳細は、Oracle Help Center→関心のあるアプリケーション・サービス領域→「Books」→「Configuration and Extension」を参照してください。

ヒントと考慮事項

「App UIs」>「Customer Experience (CX)」>「Knowledge Consumption Fragments」>「Fragments」の下には、すべてのフラグメントが表示されます。拡張目標を有効にするために、これらのフラグメントで使用可能なものの簡単な概要を次に示します。 これを便利なクイック・ガイドにするために、ここで説明する変数、イベント、およびコンテナは、役に立つと思われるものです。

• knowledge-article-clarification - knowledge-article-detail-page内では、これは表示されている記事に関連付けられた製品、カテゴリおよびユーザー・グループの表示を担当するフラグメントです。
  • UI: 「自分のナレッジ」、「サービス・センター」、「マイ・ヘルプ」、「ヘルプ・デスク・リクエスト」、「CX4U」、「メンテナンス・ワークベンチ」
  • 変数
    • kmShowCategories - 表示中の記事に関連付けられているカテゴリがある場合は、そのカテゴリの表示を切り替えます。
    • kmShowProducts - 表示中の記事に関連付けられている製品がある場合は、その製品の表示を切り替えます。
    • kmShowUserGroups - 表示中の記事に関連付けられているユーザー・グループの表示を切り替えます。

• knowledge-article-content - 記事の内容を表示します。

  • UI: 「自分のナレッジ」、「サービス・センター」、「マイ・ヘルプ」、「ヘルプ・デスク・リクエスト」、「CX4U」、「メンテナンス・ワークベンチ」

  • 変数

    • articleContentTypeReferenceKey - 表示する記事のコンテンツ・タイプの参照キーが含まれます。

    • タイトル - 表示されている記事のタイトルが含まれます。

  • イベント

    • kmContentReady - 記事のコンテンツが含まれ、そのコンテンツがページにレンダリングされる直前に起動し、変更する機会が与えられます。

• knowledge-article-detail-page - ナレッジ記事を表示するための完了ページ。

  • UI: 「自分のナレッジ」、「サービス・センター」、「マイ・ヘルプ」、「ヘルプ・デスク・リクエスト」、「CX4U」、「メンテナンス・ワークベンチ」

  • 変数

    • kmMoveAttributesToSecondaryColumn - xpathのカンマ区切りリストを受け入れます(例: //FAQ/QUESTION,//SOLUTION/ENVIRONMENT)。 表示されている記事に、リストされているxpathのいずれかの値がある場合、その属性値とその見出しはプライマリ・コンテンツ表示から削除され、そこに表示されるメタデータの前にセカンダリ列に追加されます。 これは、ユーザーが予測可能なロケーション(関連リンクのリストなど)で検索する属性に便利です。 xpathsの例に示すように、構造は//[Content型のrefkey]/[Attribute refkey]です。 コンテンツ・タイプ管理へのアクセス権を持つユーザーは、この情報を処理できる必要があります。

    • kmShowAuthor - 記事を作成したユーザーの名前の表示を切り替えます。

    • kmShowBusinessUnits - 記事に関連付けられているビジネス・ユニットの表示を切り替えます(ビジネス・ユニットが使用されている場合)。

    • kmShowFavorites - お気に入りが有効(CSO_ENABLE_KNOWLEDGE_FAVORITING)の場合、検索結果のお気に入りボタンの表示を切り替えます。

    • kmShowLinkUnlink - 何かがリンク可能な場合に、検索結果のリンク/リンク解除ボタンの表示を切り替えます。

    • kmShowShare - 共有が可能なコンテキストでの検索結果での共有ボタンの表示を切り替えます。

  • イベント

    • kmArticleLoaded - 記事のコンテンツとそのコンテンツ・タイプのスキーマを含む、ページに表示されるすべてのデータが含まれます。

  • コンテナ

    • コンテンツ前コンテナ - UIが左から右に読み込まれる言語の場合、これは記事のコンテンツの左側の列であり、右から左に読み込まれる言語の場合です。

    • メタデータ前コンテナ - このコンテナは、製品およびカテゴリが表示される前のセカンダリ・コンテンツ列の上部にあります。

• knowledge-article-rating - 評価フォームが表示されます(有効な場合)。

  • UI: 「自分のナレッジ」、「サービス・センター」、「マイ・ヘルプ」、「ヘルプ・デスク・リクエスト」、「CX4U」、「メンテナンス・ワークベンチ」

  • 変数

    • kmShowRating - あるUIに対してナレッジ評価をオンにし、別のUIに対してはオフにする場合は、プロファイル・オプションCSO_CONTENT_RATING_TYPEを使用して評価をオンにしてから、この変数を使用して、不要なUIに対して評価をオフにします。

• knowledge-article-recommendation - 推奨される記事を1つ表示し、ここで使用できる重要な拡張性オプションはありません。

  • UI: サービス・センター、ヘルプ・デスク・リクエスト

• knowledge-search-page - ナレッジ検索/ブラウズ・エクスペリエンスを作成するための完了ページ。

  • UI: 「自分のナレッジ」、「サービス・センター」、「ヘルプ・デスク・リクエスト」、「CX4U」、「メンテナンス・ワークベンチ」

  • イベント

    • kmSearchFilters - 検索で使用されるフィルタを監視および変更する場合に使用します。 フラグメント内で現在サポートされているフィルタに制限されていることに注意してください。たとえば、現在コンテンツ・タイプ・フィルタを追加することはできませんが、製品またはカテゴリ(あるいはその両方)にフィルタを適用できます。

    • kmSearchResults - 検索結果データの監視と変更に使用します。

• knowledge-search-results - 検索結果が表示されます。

  • UIs: 「自分のナレッジ」、「サービス・センター」、「マイ・ヘルプ」、「ヘルプ・デスク・リクエスト」、「CX4U」、「メンテナンス・ワークベンチ」

  • 変数

    • kmShowArticleExcerpts - 検索結果での抜粋の表示を切り替えます。

    • kmShowArticleIcon - 検索結果の横にあるアイコンの表示を切り替えます。

    • kmShowFavorite - お気に入りが有効(CSO_ENABLE_KNOWLEDGE_FAVORITING)の場合、検索結果のお気に入りボタンの表示を切り替えます。

    • kmShowLinkUnlink - 何かがリンク可能な場合に、検索結果のリンク/リンク解除ボタンの表示を切り替えます。

    • kmShowShare - 共有が可能なコンテキストでの検索結果での共有ボタンの表示を切り替えます。

  • コンテナ

    • 事前結果コンテナ - 検索結果のリストのすぐ上に独自のコンテンツ/コントロールを追加するロケーションを提供します。

アクセス要件

他のRedwood UIの拡張と同じ権限および設定がナレッジ・フラグメントにも適用されます。