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

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

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

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

具体的手順（詳細）

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

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

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

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

  • FLSの確認
システム管理者,ServiceCloud,ServiceCloudUserEditable
Customer Community Plus User,マーケティングユーザ, 参照のみ, 標準ユーザReadable
その他なし
  • ナレッジに関するアクセス権の設定

※詳細は次のヘルプを参照（https://help.salesforce.com/articleView?id=knowledge_setup_users_lex.htm&type=5）

【設定例】

システム管理者CRUD（実際にRead以外の権限が与えられるかどうかは、ナレッジユーザライセンスの付与の有無に依存）
その他Readable
  • データカテゴリの設定
  1. [設定] クイック検索ボックスに「データカテゴリ」と入力し[データカテゴリ設定]をクリック
  2. [カテゴリグループ] 下部の [新規] ボタンをクリック
  3. 次の内容を入力し、[保存] ボタンをクリック

【設定例】

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

【FAQレコードタイプ】

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

【InternalManualレコードタイプ】

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

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

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

【設定例】

プロファイル知識ベースの権限カテゴリグループ表示設定
システム管理者all CRUD, can see and manage all dataView access to “FAQ" and “Manual"
Customer Portal UserCreate,ReadView access to “FAQ" and “Manual"
Partner Portal UserCreate, ReadView access to “FAQ" and “Manual"
  • コミュニティでのトピックの作成
  1. [設定]クイック検索ボックスに「コミュニティ」と入力し [すべてのコミュニティ] をクリックします。
  2. 対象コミュニティの左横の [ワークスペース] ボタンをクリックします。
  3. [私のワークスペース] セクションより [コンテンツ管理] タイルをクリック
  4. 画面上部の [トピック] タブをクリック
  5. 左側のメニューで [トピック管理] が選択されている状態で、[新規] ボタンをクリック
  6. 名前が「カテゴリA」～「カテゴリJ」のトピックを新規作成

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

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

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

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

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

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

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

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

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

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

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

Salesforce

Posted by regardie