Adobe Experience Manager ページに ServiceNow ケースを表示

  • リリースバージョン: Australia
  • 更新日 2023年08月03日
  • 所要時間:7分
  • Adobe Experience Manager (AEM) 内で利用可能なケースコンポーネントを使用して、カスタマーサービスケースに ServiceNow インスタンスからアクセスし、AEM ベースの Web サイトで表示します。

    始める前に

    ケース API および CSM 添付ファイル API に AEM インスタンスからアクセスするためのクロスオリジンリソース共有 (CORS) ルールを定義します。詳細については、「AEM から ServiceNow API エンドポイントにアクセスするためのクロスオリジンリソース共有ルール (CORS) を定義します」を参照してください。

    必要なロール:AEM 作成者

    このタスクについて

    ケース REST API を使用すると、カスタマーサービスケースレコードを作成、取得、および更新することができます。詳細については、「ケース API」を参照してください。

    CSM 添付ファイル API を使用すると、カスタマーサービスケースに関連付けられた添付ファイルをアップロード、ダウンロード、削除したり、添付ファイルのメタデータを取得したりすることができます。詳細については、 「CSM 添付ファイル API」を参照してください。

    手順

    1. AEM インスタンスにログインします。
    2. AEM ページを編集モードで開きます。
    3. コンポーネントブラウザを開きます。
    4. [すべて] リストから、[ServiceNow] を選択します。
    5. コンポーネントをページの必要な位置にドラッグします。
      注:
      コンポーネントが利用できない場合、ケースコンポーネントを含めるようにテンプレート構成を更新してください。また、サイトテンプレートのプロパティを変更して、各ケースコンポーネントを許可されたコンポーネントのリストに追加する必要があります。
    6. 編集するコンポーネントダイアログを開きます。
      注:
      AEM のページで編集モードのケースコンポーネントには、パブリックユーザーを含むすべてのユーザーがアクセスできます。パブリックユーザーは、ログインしていない匿名の AEM ユーザーです。
    7. ServiceNow インスタンスのすべてのオープンカスタマーサービスケースを列カードとして表示するには、ケースカードコンポーネントプロパティを設定します。
      表 : 1. ケースカードコンポーネントプロパティ
      プロパティ 説明
      役職 AEM ページに表示されるこのコンポーネントのタイトル。
      ラベルパラメーター ケース [sn_customerservice_case] テーブル列のカンマ区切りラベルのパラメーター。各パラメーターは、「ラベル:」の形式で指定します。ラベルにコンポーネントが表示されます。は、ケース [sn_customerservice_case] テーブルの列の名前です。

      例:番号:番号,優先度:優先度,製品:製品

      ケースリストページの URL リダイレクト先のケースリストの相対 URL

      例:/content/servicenow/en/now_case_list.html

      ケースビューページ URL リダイレクト先のケースビューの相対 URL

      例:/content/servicenow/en/now_case_view.html

      ケースのないコンポーネントを非表示にする 表示するケースがない場合は、コンポーネントを非表示にするオプション。
      カスタム CSS クラス カスタムスタイルをこのコンポーネントに適用するためのカスタム CSS クラス。詳細については、「AEM の ServiceNow コンポーネントの色をカスタマイズする」を参照してください。
    8. ユーザーに対して新しいケースコンポーネントプロパティを設定し、AEM ページから ServiceNow インスタンスでカスタマーサービスケースを作成します。
      表 : 2. 新しいケースコンポーネントプロパティ
      プロパティ 説明
      役職 AEM ページに表示されるこのコンポーネントのタイトル。
      簡単な説明ラベル ケースの簡単な説明を入力するフィールドのラベル。
      説明ラベル ケースの説明を入力するフィールドのラベル。
      製品ラベル 製品リストのラベルとプレースホルダーテキストを定義する、セミコロンで区切られたパラメーター。
      資産ラベル 資産リストのラベルとプレースホルダーテキストを定義する、セミコロンで区切られたパラメーター。
      リストアイテム数 製品および資産リストに含めることができるアイテムの最大数。

      値を増減するには、増加アイコンまたは減少アイコンを使用します。また、値は手動で入力できます。値は 1 より大きい値でなければなりません。

      資産を表示 コンポーネントの資産リストを表示するオプション。
      ケースリストページの URL リダイレクト先のケースリストの相対 URL

      例:/content/servicenow/en/now_case_list.html

      ケースビューページ URL リダイレクト先のケースビューの相対 URL

      例:/content/servicenow/en/now_case_view.html

      注:
      ケース作成ウィンドウからケースビューページに移動するには、このプロパティの値を入力する必要があります。
      添付ファイルのサイズ制限 (MB) ケースに追加できる添付ファイルの最大サイズの制限。
      カスタム CSS クラス カスタムスタイルをこのコンポーネントに適用するためのカスタム CSS クラス。詳細については、「AEM の ServiceNow コンポーネントの色をカスタマイズする」を参照してください。
    9. ServiceNow インスタンスからのカスタマーサービスケースとコメント、添付ファイル (存在する場合) を表示するために、[ケースビュー] コンポーネントプロパティを設定します。
      表 : 3. ケースビューコンポーネントプロパティ
      プロパティ 説明
      ケースパラメーター ケース番号の URL クエリパラメーターの名前。

      例:case_no

      ラベルパラメーター ケース [sn_customerservice_case] テーブル列のカンマ区切りラベルのパラメーター。各パラメーターは、「ラベル:」の形式で指定します。ラベルにコンポーネントが表示されます。は、ケース [sn_customerservice_case] テーブルの列の名前です。

      例:番号:番号,優先度:優先度,製品:製品

      アクティビティカウント [アクティビティ] タブに表示されるコメントや添付ファイルなどのアクティビティの最大数。

      値を増減するには、増加アイコンまたは減少アイコンを使用します。また、値は手動で入力できます。値は 1 より大きい値でなければなりません。

      添付ファイルのサイズ制限 (MB) ケースに追加できる添付ファイルの最大サイズの制限。

      値を増減するには、増加アイコンまたは減少アイコンを使用します。また、値は手動で入力できます。値は 1 より大きい値でなければなりません。

      記事ページの URL リダイレクト先の記事ページの相対 URL
      例:/content/servicenow/en/now_article_view.html
      注:
      ケースに記事リンクが含まれている場合は、ケースからナレッジ記事ビューページに移動するために、このプロパティの値を入力する必要があります。
      カスタム CSS クラス カスタムスタイルをこのコンポーネントに適用するためのカスタム CSS クラス。詳細については、「AEM の ServiceNow コンポーネントの色をカスタマイズする」を参照してください。
    10. カスタマーサービスケースのリストを表示するには、[ケースリスト] コンポーネントのプロパティを設定します。
      表 : 4. ケースリストコンポーネントプロパティ
      プロパティ 説明
      役職 AEM ページに表示されるこのコンポーネントのタイトル。
      ラベルパラメーター ケース [sn_customerservice_case] テーブル列のカンマ区切りラベルのパラメーター。各パラメーターは、「ラベル:」の形式で指定します。ラベルにコンポーネントが表示されます。は、ケース [sn_customerservice_case] テーブルの列の名前です。

      例:番号:番号,優先度:優先度,製品:製品

      ケースカウント コンポーネントに表示する最大ケース数。

      値を増減するには、増加アイコンまたは減少アイコンを使用します。また、値は手動で入力できます。値は 1 より大きい値でなければなりません。

      このフィールドに入力できる最大値は 50 です。

      ケース作成を表示 コンポーネントにケースを作成するボタンを表示するオプション。
      ケース作成ボタンのラベル ケースを作成するボタンのラベル。
      ケース作成ページの URL リダイレクト先のケース作成ページの相対 URL。

      例:/content/servicenow/en/now_case_create.html

      ケースビューページ URL リダイレクト先のケースビューの相対 URL。

      例:/content/servicenow/en/now_case_view.html

      カスタム CSS クラス カスタムスタイルをこのコンポーネントに適用するためのカスタム CSS クラス。詳細については、「AEM の ServiceNow コンポーネントの色をカスタマイズする」を参照してください。