Adobe Experience Manager ページに ServiceNow ナレッジ記事を表示する
Adobe Experience Manager (AEM) 内で利用可能なナレッジコンポーネントを使用して、ナレッジベースに ServiceNow インスタンスからアクセスし、関連付けられているナレッジ記事を AEM ベースの Web サイトで表示します。
始める前に
- ナレッジ記事のナレッジ管理 REST API エンドポイントを使用するには、ナレッジ API プラグイン (sn_km_api) を有効にします。詳細については、「ナレッジ管理 REST API」を参照してください。
- Knowledge API に AEM インスタンスからアクセスするためのクロスオリジンリソース共有 (CORS) ルールを定義します。詳細については、「AEM から ServiceNow API エンドポイントにアクセスするためのクロスオリジンリソース共有ルール (CORS) を定義します」を参照してください。
必要なロール：AEM 作成者
手順
- AEM インスタンスにログインします。
- AEM ページを編集モードで開きます。
- コンポーネントブラウザを開きます。
- [すべて] リストから、[ServiceNow] を選択します。
-
コンポーネントをページの必要な位置にドラッグします。
注:コンポーネントが利用できない場合、ナレッジコンポーネントを含めるようにテンプレート構成を更新してください。また、サイトテンプレートのプロパティを変更して、各ナレッジ記事コンポーネントを許可されたコンポーネントのリストに追加する必要があります。
-
編集するコンポーネントダイアログを開きます。
注:デフォルトでは、AEM でページの編集モードになっているナレッジコンポーネントは、パブリックユーザー (ログインしていない匿名 AEM ユーザー) が利用することはできません。デフォルトの動作を変更するには、各ナレッジコンポーネントの [公開] プロパティを有効にする必要があります。
-
検索結果コンポーネントのプロパティを設定し、ServiceNow インスタンスのナレッジベースから得られたナレッジ記事のリストを含むナレッジ検索の結果を表示します。
表 : 1. 検索結果コンポーネントプロパティ プロパティ 説明 公開 コンポーネントのコンテンツを表示してユーザーに公開するオプション。選択すると、コンポーネントに含まれる非認証ユーザーが利用できるナレッジ記事が、パブリックユーザーを含むすべてのユーザーが利用できるようになります。 ナレッジベース 関連するナレッジ記事を含めるためのナレッジベースのシステム識別子 (sys_id)。 [フィールドを追加] をクリックして、ナレッジベースの sys_id を入力します。複数のエントリを追加できます。
注:値を追加しない場合、OSGi 構成設定のナレッジベースが ServiceNow コンポーネントに使用されます。言語 ナレッジ記事の検索結果の表示をさまざまな言語で有効にします。 次のオプションのいずれかを選択します。- ServiceNow OSGi 構成から選択：ナレッジ記事は、ServiceNow コンポーネントの OSGi 構成で構成された言語で表示されます。デフォルトでは、この値が選択されます。
- ポータル言語に制限：ナレッジ記事は、AEM サイトで構成された言語で表示されます。
- すべての言語：ナレッジ記事はすべての言語で表示されます。
検索パラメータ 検索クエリのパラメーターキー 例：kb_query
セカンダリーフィールド 記事と併せて表示されるナレッジ記事のメタデータ。メタデータには、作成者、記事の最終更新日、記事の最終表示日などの情報が含まれます。複数のエントリでは、フィールドをカンマで区切ります。 例：
author,sys_view_count,sys_updated_on,rating検索結果数 検索結果リストに含める記事の最大数 値を増減するには、増加アイコンまたは減少アイコンを使用します。また、値は手動で入力できます。値は 1 より大きい値でなければなりません。
記事ページの URL リダイレクト先の記事ページの相対 URL 例：/content/NOWApp/now_article_view.html
カスタム CSS クラス カスタムスタイルをこのコンポーネントに適用するためのカスタム CSS クラス。詳細については、「AEM の ServiceNow コンポーネントの色をカスタマイズする」を参照してください。 -
検索ボックスコンポーネントのプロパティを設定して、ユーザーが検索テキストを入力し、検索テキストに一致する ServiceNow インスタンス内のナレッジ記事を検索できる検索ボックスをユーザーに表示します。
注:検索を [検索ボックス] コンポーネントからトリガーすると、[検索結果] コンポーネントが表示されます。
表 : 2. [検索ボックス] コンポーネントプロパティ プロパティ 説明 公開 コンポーネントのコンテンツを表示してユーザーに公開するオプション。選択すると、コンポーネントに含まれる非認証ユーザーが利用できるナレッジ記事が、パブリックユーザーを含むすべてのユーザーが利用できるようになります。 プレースホルダー 検索ボックスに表示されるヒントテキスト。ユーザーが検索できるコンテンツや検索テキストの条件に関する情報を提供します。 例：検索 (最低 3 文字)
ナレッジベース 関連するナレッジ記事を含めるためのナレッジベースのシステム識別子 (sys_id)。 [フィールドを追加] をクリックして、ナレッジベースの sys_id を入力します。複数のエントリを追加できます。
注:値を追加しない場合、OSGi 構成設定のナレッジベースが ServiceNow コンポーネントに使用されます。言語 ナレッジ記事のさまざまな言語での表示を検索ボックスで有効にします。 次のオプションのいずれかを選択します。- ServiceNow OSGi 構成から選択：ナレッジ記事は、ServiceNow コンポーネントの OSGi 構成で構成された言語で表示されます。デフォルトでは、この値が選択されます。
- ポータル言語に制限：ナレッジ記事は、AEM サイトで構成された言語で表示されます。
- すべての言語：ナレッジ記事はすべての言語で表示されます。
検索ページ URL リダイレクト先の検索ページの相対 URL 例：/content/NOWApp/now_article_search.html
検索パラメータ 検索クエリのパラメーターキー 例：kb_query
先行入力 先行入力検索を有効にするオプション。 先行入力検索結果数 先行入力検索結果リストに含める記事の最大数 値を増減するには、増加アイコンまたは減少アイコンを使用します。また、値は手動で入力できます。値は 1 より大きい値でなければなりません。
記事ページの URL リダイレクト先の記事ページの相対 URL 例：/content/NOWApp/now_article_view.html
カスタム CSS クラス カスタムスタイルをこのコンポーネントに適用するためのカスタム CSS クラス。詳細については、「AEM の ServiceNow コンポーネントの色をカスタマイズする」を参照してください。 -
ナレッジ記事とその添付ファイル (利用可能な場合) を ServiceNow インスタンスから表示するには、[記事ビュー] コンポーネントプロパティを設定します。
表 : 3. 記事ビューコンポーネントプロパティ プロパティ 説明 公開 コンポーネントのコンテンツを表示してユーザーに公開するオプション。選択すると、コンポーネントに含まれる非認証ユーザーが利用できるナレッジ記事が、パブリックユーザーを含むすべてのユーザーが利用できるようになります。 記事パラメータ 記事番号の URL クエリパラメータの名前 例：kb_article
セカンダリーフィールド 記事と併せて表示されるナレッジ記事のメタデータ。メタデータには、作成者、記事の最終更新日、記事の最終表示日などの情報が含まれます。複数のエントリでは、フィールドをカンマで区切ります。 例：
author,sys_view_count,sys_updated_on,rating言語パラメータ ナレッジ記事用に要求された言語を含む URL クエリパラメータの名前 例：kb_lang
カスタム CSS クラス カスタムスタイルをこのコンポーネントに適用するためのカスタム CSS クラス。詳細については、「AEM の ServiceNow コンポーネントの色をカスタマイズする」を参照してください。 -
リストの基準に応じてナレッジ記事のリストを表示するには、[記事リスト] コンポーネントプロパティを設定します。
表 : 4. 記事リストコンポーネントプロパティ プロパティ 説明 公開 コンポーネントのコンテンツを表示してユーザーに公開するオプション。選択すると、コンポーネントに含まれる非認証ユーザーが利用できるナレッジ記事が、パブリックユーザーを含むすべてのユーザーが利用できるようになります。 役職 コンポーネントヘッダーとして表示される記事リストに対応するタイトル 例：最も閲覧された記事
ナレッジベース 関連するナレッジ記事を含めるためのナレッジベースのシステム識別子 (sys_id)。 [フィールドを追加] をクリックして、ナレッジベースの sys_id を入力します。複数のエントリを追加できます。
注:値を追加しない場合、OSGi 構成設定のナレッジベースが ServiceNow コンポーネントに使用されます。言語 記事を表示する際にさまざまな言語によるナレッジ記事の表示を有効にします。 次のオプションのいずれかを選択します。- ServiceNow OSGi 構成から選択：ナレッジ記事は、ServiceNow コンポーネントの OSGi 構成で構成された言語で表示されます。デフォルトでは、この値が選択されます。
- ポータル言語に制限：ナレッジ記事は、AEM サイトで構成された言語で表示されます。
- すべての言語：ナレッジ記事はすべての言語で表示されます。
セカンダリーフィールド 記事と併せて表示されるナレッジ記事のメタデータ。メタデータには、作成者、記事の最終更新日、記事の最終表示日などの情報が含まれます。複数のエントリでは、フィールドをカンマで区切ります。 例：
author,sys_view_count,sys_updated_on,rating基準 ナレッジ記事リストの条件のリスト。次のオプションのいずれかを選択します。 - 特集：glide.knowman.default_keyword プロパティで構成されたキーワードに基づく特集記事のリスト特集記事の詳細については、「主なコンテンツへのナレッジ記事の追加 」および「ナレッジプロパティ」を参照してください。
- 最も表示された記事：最も表示されたナレッジ記事のリスト
記事の数 記事リストに含める記事の最大数 値を増減するには、増加アイコンまたは減少アイコンを使用します。また、値は手動で入力できます。値は 1 より大きい値でなければなりません。
記事ページの URL リダイレクト先の記事ページの相対 URL 例：/content/NOWApp/now_article_view.html
空の場合はコンポーネントを非表示 表示するナレッジ記事がない場合は、コンポーネントを非表示にするオプション。 カスタム CSS クラス カスタムスタイルをこのコンポーネントに適用するためのカスタム CSS クラス。詳細については、「AEM の ServiceNow コンポーネントの色をカスタマイズする」を参照してください。