Salesforce ナレッジベースに直接コンテンツを公開する方法について説明します。

Salesforce の統合により Adobe RoboHelp は公開機能を拡張し、コンテンツのみを出力(以前の XML)し、直接 Salesforce ナレッジベースに記事として公開するオプションを提供します。

注意:

コンテンツのみを出力すると、XHTML に加えて、コンテンツを Salesforce、ServiceNow、および Zendesk に公開できます。

前提条件

Salesforce ナレッジベースとの接続を作成するには、Lightning ナレッジを有効にしてアカウントを設定する必要があります。詳細については、Salesforce の「取引先の設定」を参照してください。

ワークフローの設定

出力を公開する前に Salesforce ナレッジベースを設定する手順は次のとおりです。

出力プリセットを作成

RoboHelp で出力プリセットを作成するには、以下の手順を実行します。

  1. 開いているプロジェクトで、以下に示すいずれかの操作を実行します。

    • 標準ツールバーの左側に表示されている「出力」タブをクリックします。
    • 標準ツールバーの右上隅に表示されているクイック生成)をクリックし、設定を編集アイコン()をクリックします。

    出力ビューが表示されます。

  2. 出力ツールバーで、「出力プリセット」をクリックします。出力プリセットパネルが表示されます。

  3. 出力プリセットパネルで、をクリックします。

  4. 新しいプリセットダイアログボックスで、以下を指定します。

    タイプコンテンツのみのプリセットのタイプを選択する場合は、このドロップダウンリストを使用します。

    名前:出力プリセットの名前を指定します。

    ターゲット:ターゲットドロップダウンから、Salesforce ナレッジベースを選択します。

  5. 「終了」をクリックします。

    出力プリセットには、出力ツールバーの出力プリセットパネルからアクセスすることができます。または、オーサリングウィンドウのクイック生成ダイアログボックスから出力プリセットにアクセスすることもできます。

Salesforce ナレッジベースの出力プリセットの構成

コンテンツのみの出力プリセットを構成するために、次の設定を使用できます 。

全般

タイトル、ターゲット、出力パス、エンコーディングなど、基本的な出力設定を指定するには、以下のオプションを使用します。

タイトル:生成された出力のタイトルを指定します。

タイトル内で変数を使用することができます。 タイトル内で変数を使用するには、Ctrl + 1 を押して、ドロップダウンリストで変数を選択して Enter キーを押します。「コンテンツ」タブ/「変数セット」フィールドで設定された変数を選択すると、出力の生成時に、その変数の値が変数セットから取得されます。

ターゲット:ドロップダウンを使用して、「コンテンツのみ」で選択した出力を生成する Salesforce ナレッジベースを選択します。

出力パス:出力の場所を指定します。場所を選択するには、 をクリックします。

出力パスがプロジェクトフォルダーのパスに含まれていないことを確認します。出力パスがプロジェクトフォルダーのパスに含まれている場合、出力は生成されません。 また、必要なコンテンツが保管されていないフォルダーを選択してください。 RoboHelp はフォルダー内のコンテンツを削除した後、出力を生成します。

エンコーディング:コンテンツで使用する文字のエンコーディング形式を指定する場合は、このドロップダウンリストを使用します。

生成後スクリプト:出力生成後にカスタムスクリプトを実行するには、ドロップダウンリストからスクリプトの .js ファイルを選択します。

コンテンツ

以下のオプションを使用して、目次、条件式、変数セットなど、コンテンツ関連の出力設定を指定します。

目次:出力に含める目次を選択する場合は、このドロップダウンリストを使用します。このドロップダウンリストには、プロジェクトで使用可能な目次が表示されます。 デフォルトでは、このドロップダウンリストの最初の目次が選択されます。

選択された目次にあるファイルとその参照のセットが、生成された出力に表示されます。

条件式:出力の条件式を指定する場合は、このドロップダウンリストを使用します。この設定を使用すると、目的の出力タイプや対象ユーザーに応じて、出力内に表示するコンテンツと出力から除外するコンテンツを簡単に指定することができます。選択した条件式を編集するには、をクリックします。条件式を指定しない場合は、ドロップダウンリストで「なし」を選択します。

変数セット:該当する出力で使用する変数セットを指定する場合は、このドロップダウンリストを使用します。プロジェクトのデフォルトの変数セットを使用する場合は、このドロップダウンリストで <デフォルトの変数セット> を選択します。 変数セットを使用すると、出力方法に応じて変数を使用できます。 例えば、お客様と内部ユーザーとで異なる変数セットを使用して出力を生成できます。

展開テキストを含める:このオプションは、Salesforce ナレッジベースへの公開には無効です。

ドロップダウンテキストテキストを含める:このオプションは、Salesforce ナレッジベースへの公開には無効です。

注意:

Salesforce では、記事内に JavaScript またはカスケードスタイルシート(CSS)を追加することは許可されていません。そのため公開では、ドロップダウンテキスト、展開テキスト、またはサムネイルイメージを使用しないようにしてください。使用されている場合、括られたテキストはプレーンテキストとして保持されます。

レイアウト

以下のオプションを使用して、出力の外観を設定します。

マスターページ:出力のマスターページを選択する場合は、このドロップダウンリストを使用します。マスターページが選択されている場合、スタイル定義は、マスターページの CSS(カスケーディングスタイルシート)によって決定されます。「なし」に設定した場合、トピックで使用される CSS ファイルから CSS スタイルが取得されます。

Salesforce

公開プロファイル、レコードタイプ、カテゴリなどの Salesforce 公開設定を指定するには、以下のオプションを使用します。

公開プロファイル:Salesforce 接続プロファイルの中から選択するには、このドロップダウンリストを使用します。公開プロファイルの作成方法については、「公開プロファイルの構成する」を参照してください。

レコードタイプ:ドロップダウンを使用して、ユーザープロファイルに基づく表示設定に応じて Salesforce でセットアップされたページレイアウトの中から選択します。レコードタイプは、公開文書がどのように整理されるか、また、タイトル、回答、数式など、どのフィールドを表示する必要があるか定義します。このプリセット用に構成されたトピックは、選択したレコードタイプに対して公開されます。

カテゴリ:ドロップダウンを使用して、Salesforce で設定されている項目から選択します。カテゴリは階層ツリーに似ており、Salesforce ナレッジ記事を検索して分類するために使用されます。これらのカテゴリは、ユーザープロファイルに基づく、表示設定にも基づいています。

すべてのスタイルをインラインスタイルに変換:出力を Salesforce ナレッジベースに公開するときに RoboHelp で使用するスタイルを維持するには、このオプションを選択します。

画像をアップロード:トピック内の画像を公開する出力に含める場合は、このオプションを選択します。

リンクされたドキュメントのアップロード:トピックにリンクされている PPT、PPTX、DOC、DOCX、PDF などのドキュメントを公開する出力に含める場合は、このオプションを選択します。

公開プロファイルを構成する

出力を Salesforce ナレッジベースに公開する前に、プロファイルを作成して構成する必要があります。プロファイルを作成して設定するには、以下の手順を実行します。

  1. 編集/公開プロファイル」を選択します。

    公開設定ダイアログボックスが表示されます。

  2. プロファイルを作成するには、 をクリックします。

  3. 「サーバータイプ」フィールドで、「Salesforce ナレッジベース」を選択します。

  4. 「Salesforce ナレッジベース」サーバータイプに対して、以下の手順を実行します。

    • 名前:デフォルトのプロファイル名が表示されます。 必要に応じて名前を変更します。
    • サイト URL:サイト名を追加して、サイトの URL を完成させます。URL の先頭には、組織のドメインが含まれています。
                   例えば、https://yourco.salesforce.com のように入力します
  5. 保存」をクリックします。

    プロファイルが保存され、「プロファイル」列にプロファイル名が表示されます。プロファイルを編集するには、目的のプロファイル名をクリックしてそのフィールドを編集します。プロファイルを削除するには、削除するプロファイルの をクリックします。

Salesforce ナレッジベースに公開

Salesforce にリンクするようにコンテンツのみの出力プリセットを設定し、コンテンツを Salesforce ナレッジベースに公開することができます。

  1. 標準ツールバーの「出力」タブをクリックします。出力ツールバーでは「出力プリセット」がデフォルト設定です。 

  2. 出力プリセットパネルで、任意の出力プリセットをダブルクリックして編集します。

  3. 出力プリセットエディタで「公開」タブをクリックし、Salesforce タブ設定で選択したプロファイルを表示します。

    公開プロファイルダイアログボックスでサーバー情報を編集することもできます。このダイアログボックスを開くには、 をクリックします。 

  4. コンテンツの公開先のプロファイル(サーバー)を選択します。

  5. 出力プリセットパネルのプリセットを生成アイコン()をクリックします。

    次に、出力プリセットパネルで、選択した出力プリセットの横に表示されているプログレスバーを確認します。出力の生成が完了すると、画面の右下隅に成功ダイアログボックスが表示されます。 

    出力の生成が完了したら、出力プリセットパネルの をクリックして出力を表示します。

  6. 選択したプロファイル(サーバー)をパブリッシュするには、出力プリセットをクリックしてから標準ツールバーの  をクリックします。または出力プリセットパネルを右クリックし、「公開」をクリックします。

  7. RoboHelp はコンテンツを Salesforce に出力します。公開が完了すると、Robohelp は公開されたコンテンツのレポートを表示します。

  8. 公開された出力を表示するには、アイコンをクリックして Salesforce ナレッジベースのランディングページに移動し、記事を参照できます。