コミュニティでナレッジを公開する方法

By | November 28, 2020
0 Comment

前書き（ナレッジを公開する五つの方法）

前提として、一般にナレッジと言われているものをコミュニティで公開する方法は大きく五つあります。

  1. Lightningナレッジのデータカテゴリをトピックに紐づけたうえで公開するパターン
  2. LightningナレッジにCMSをかませて公開するパターン
  3. SFに固有のナレッジ機能を利用せずにCMS機能を利用してナレッジを公開するパターン
  4. SFに固有のナレッジ機能を利用せずにカスタムオブジェクトのレコードでナレッジを公開するパターン
  5. SFに固有のナレッジ機能を利用せずに静的に各ページにベタ書きでナレッジを公開するパターン

ナレッジを利用しない場合、データカテゴリ単位でのアクセス権の制御はできません。またケースデフレクションコンポーネントでの推奨記事自動表示機能も利用できません。

ナレッジもCMSも利用しない場合、ドラフト機能が利用できないため「一時的に非公開」や「事前に準備しておき、適切なタイミングで公開」といったことはできません。

パターンアクセス権の制御ドラフト備考
1○○スタンダード
2○○Winter`21で初めて実現
3×○カテゴリ階層化に難あり？（※要検証）
4××非現実的
5××非現実的

注意点（デザイン）

非機能要件の観点からの注意点としては、デザインの制約が挙げられます。

SalesforceのCommunityはデザインのカスタマイズ余地が少ないです。

Zendeskのヘルプサイトのような美しいデザインはまず実現不可能と認識しておいた方が後々のトラブルを防ぐためにもよいでしょう。

SalesforceのCommunityを利用して作成された国内のヘルプサイトのうち、最も美しいデザインなのがHolmesさんのヘルプサイトで、ここが上限と認識しておくのが吉です。

↓以下のMiitelヘルプサイトのようなZendesk系の美しいデザインは実現不可

↓Holmesヘルプサイトが国内のExperienceCloud製ヘルプサイトとしては最も美しい

具体的手順（概要）

以下では、Lightningナレッジをコミュニティで公開するための具体的な手順（パターン1の手順）を紹介していきます。

なお内容は、「Lightning Knowledge でコミュニティにナレッジを表示させるには？」というSalesforce公式ヘルプ記事に大幅な過失修正を加えたものになっています。（※過去に当該の公式ヘルプをそのまま真似したところ、抜けている手順があまりに多く全く上手くいかなかったため、今回の手順を自作したという背景があります。）

全体の流れ

  1. ナレッジの有効化
  2. ナレッジの項目とページレイアウトに関する基本カスタマイズ
  3. データカテゴリの作成
  4. レコードタイプの作成（※必要な場合のみ）
  5. トピックの有効化（※コミュニティ有効化後）
  6. プロファイル権限設定（「知識ベースの権限」および「カテゴリグループ表示設定」）
  7. テストレコードの作成
  8. コミュニティでのトピックの作成
  9. データカテゴリとトピックの関連付け
  10. 主要トピックの設定（※必要な場合のみ）
  11. ナビゲーショントピックの設定（※必要な場合のみ）
  12. 言語設定
  13. ゲストユーザへの公開設定（※必要な場合のみ）

具体的手順（詳細）

  • 1. ナレッジの有効化
  1. 設定ユーザ（＝自分自身）のユーザレコードで「ナレッジユーザ」にチェック（※一般に、ナレッジ記事を管理すなわち作成・編集・公開できるのは「ナレッジユーザライセンス」を有するユーザのみ）
  2. Salesforceナレッジの有効化（※Classicに切り替え＞設定＞ナレッジ＞ナレッジの設定 or Classicに切り替え＞サービスの設定＞ナレッジ＞ナレッジの設定）
  3. LigntingKnowledgeを有効化（※ナレッジの設定＞LightningKnowledgeの設定＞LightningKnowledgeを有効化）
  4. “Knowledge”がオブジェクトマネージャに追加されていることを確認する
  • 2. ナレッジの項目とページレイアウトに関する基本カスタマイズ（※デフォルトでは「タイトル」と「URL名」のみ）
  1. ナレッジの表示ラベルを”Knowledge”から”ナレッジ”に変更（※ユーザインタフェース＞タブと表示ラベルの名称変更＞知識ベース）
  2. リッチテキストエリア型の回答（項目名：Answer）項目を新規作成
  3. 下記ページレイアウトの設定

※公開先設定を配置しないと、「内部アプリケーションに公開」以外の公開先チャネル設定ができなくなる

設定項目公開先
内部アプリケーションに公開Salesforceの内部アプケーション
パートナーに公開パートナーコミュニティ
顧客に表示カスタマーコミュニティ
知識ベースに公開Website（Sites）

※その他、ナレッジのページレイアウト設定に関する詳細は次のヘルプを参照（https://help.salesforce.com/articleView?id=knowledge_lightning_page_layouts.htm&type=5）

  • 3. データカテゴリの設定
  1. [設定] クイック検索ボックスに「データカテゴリ」と入力し[データカテゴリ設定]をクリック
  2. [カテゴリグループ] 下部の [新規] ボタンをクリック
  3. 次の内容を入力し、[保存] ボタンをクリック

【設定例】

カテゴリグループ名グループの一意の名前下位カテゴリ
FAQFAQカテゴリA；カテゴリB；カテゴリC；カテゴリD；カテゴリE
InternalOnlyInternalOnlyカテゴリF；カテゴリG；カテゴリH；カテゴリI；カテゴリJ
  1. 画面右側の [FAQのカテゴリ] セクションにある [すべて] の[アクション] から[子カテゴリの追加]をクリック
  2. 入力欄に任意のカテゴリ名を入力し、[追加] ボタンをクリック
  3. [保存] ボタンをクリック
  4. [無効なカテゴリグループ] にある「FAQ」にマウスオーバーして、鍵マークをクリックし、カテゴリグループを有効化
  • 4. レコードタイプの作成（※スキップ可能）
  1. [設定] > [オブジェクトマネージャ] タブより、[Knowledge (ナレッジ)] を選択
  2. 画面左側 [レコードタイプ] をクリックし、画面側の [新規] ボタンをクリック
  3. 下記テーブルの様に設定し、[次へ] ボタンをクリック。既存のレコードタイプからコピー
  4. [ステップ 2. ページレイアウトを割り当て] で [保存] ボタンをクリック

【FAQレコードタイプ】

コピー元レコードタイプ–マスタ–
レコードタイプの表示ラベルFAQ
レコードタイプ名FAQ
説明
有効TRUE
プロファイルSame as Default

【InternalOnlyレコードタイプ】

コピー元レコードタイプ–マスタ–
レコードタイプの表示ラベルInternalOnly
レコードタイプ名InternalOnly
説明
有効TRUE
プロファイルSame as Default

※InternalManualカテゴリグループが不要な場合は、後から削除すること

  • 5. トピックの有効化（※コミュニティ有効化後）
  1. Lightning環境の場合、Salesforce Classic に切り替え切り替え
  2. 画面右上より [設定] | [ビルド] | [カスタマイズ] | [トピック] | [オブジェクトのトピック] を順次クリック
  3. 画面左側のオブジェクトリストよりナレッジオブジェクトの表示ラベル名をクリック
  4. [トピックを有効化] にチェックを入れ、[保存] ボタンをクリック
  • 6. プロファイル権限設定（「知識ベースの権限」および「カテゴリグループ表示設定」）
  1. [設定]クイック検索ボックスに「プロファイル」と入力し [プロファイル] をクリック
  2. （ナレッジへの権限を付与したい）プロファイル左横の [編集] ボタンをクリック
  3. [知識ベースの権限] セクションで必要な「Knowledge」 の権限にチェックを付ける
  4. [保存] ボタンをクリック
  5. プロファイル詳細画面の下側の [カテゴリグループ表示設定] セクションより「FAQ」左横の [編集] ボタンをクリック
  6. カテゴリグループ表示を [すべてのカテゴリ] に選択し、[保存] ボタンをクリック

【設定例】

プロファイル知識ベースの権限カテゴリグループ表示設定
システム管理者全権限 FAQ & InternalOnly
ゲストユーザプロファイル参照FAQ
  • 7. テストレコードの作成
  1. Knowledgeリストビューで「新規」をクリック
  2. 必要な情報を入力して、保存
  3. 「Draft Articles」リストビューに切り替え、作成したナレッジレコード右側の▼ボタンをクリック
  4. 「公開」をクリック

＝＝＝ここまでSalesforce側の設定＝＝＝

＝＝＝ここからCommunity側の設定＝＝＝

  • 8. コミュニティでのトピックの作成
  1. [設定]クイック検索ボックスに「コミュニティ」と入力し [すべてのコミュニティ] をクリック
  2. 対象コミュニティの左横の [ワークスペース] ボタンをクリック
  3. [私のワークスペース] セクションより [コンテンツ管理] タイルをクリック
  4. 画面上部の [トピック] タブをクリック
  5. 左側のメニューで [トピック管理] が選択されている状態で、[新規] ボタンをクリック
  6. 名前が「カテゴリA」～「カテゴリJ」のトピックを新規作成

※コンテンツ管理＞トピック内の各項目の詳細については次のドキュメントを参照。https://help.salesforce.com/articleView?id=networks_topics_overview.htm&type=5

  • 9. データカテゴリとトピックの関連付け
  1. 画面左側のメニューより [トピックの自動割り当て] をクリック
  2. [トピックの自動割り当て] 右横のスイッチボタンをクリックし、自動割り当てを有効化
  3. データカテゴリグループを「FAQ」 に指定します。データカテゴリを「カテゴリA」～「カテゴリJ」に指定。[トピックを追加] 入力欄に「カテゴリA」～「カテゴリJ」を入力。表示されたトピックをクリック
  4. [保存] ボタンをクリック
  • 10. 主要トピックの設定（※必要な場合のみ）

カテゴリA～カテゴリJを追加（ワークスペース＞コンテンツ管理＞トピック＞主要トピック）画像の設定

  • 11. ナビゲーショントピックの設定（※必要な場合のみ）
  1. カテゴリA～カテゴリJを追加（ワークスペース＞コンテンツ管理＞トピック＞ナビゲーショントピック）
  2. 設定した各カテゴリについて、関連記事を追加（※事実上、データカテゴリとの紐づけ）
  • 12. 言語設定

下記のそれぞれからナレッジとコミュニティのデフォルト言語が一致しているかどうか確認。ズレていた場合は一致させる。

ナレッジのデフォルト言語：設定＞ナレッジの設定> 言語設定

コミュニティのデフォルト言語：設定＞すべてのコミュニティ＞対象コミュニティのビルダー＞画面左側の設定ボタン＞言語＞デフォルトのコミュニティ言語

  • ゲストユーザへの公開設定

ゲストユーザにナレッジを公開する場合、追加で下記設定を行います。

  1. エクスペリエンスビルダー＞設定＞全般＞当該コミュニティのゲストユーザプロファイルの順にクリック
  2. 「知識ベースの権限」セクションでKnowledgeの「参照」にチェックをつけ保存

※データカテゴリの権限設定やその他の設定は一切不要です。