国際化された埋め込みヘルプの作成

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間：4分

    • 提供された英語の埋め込みヘルプコンテンツを他の言語に翻訳するか、選択した言語でカスタム埋め込みヘルプコンテンツを作成します。

    始める前に

    必要なロール:embedded_help_admin または admin

    このタスクについて

    デフォルトでは、すべての埋め込みヘルプコンテンツレコードは英語です。英語以外の埋め込みヘルプコンテンツレコードを作成するには、まず埋め込みヘルプ [sys_embedded_help_content] テーブルに英語のコンテンツレコードが存在する必要があります。英語の埋め込みヘルプコンテンツレコードは、他のすべての言語の埋め込みヘルプコンテンツレコードの親です。英語以外の埋め込みヘルプコンテンツレコードを作成すると、そのレコードは翻訳されたテキスト [sys_translated_text] テーブルに格納されます。

    提供された英語のコンテンツを別の言語に翻訳するには、英語のコンテンツレコードのコピーを作成し、編集した英語以外のコピーレコードを保存します。新しいレコードが翻訳されたテキスト [sys_translated_text] テーブルに保存されます。利用可能な埋め込みヘルプコンテンツを翻訳するには、「 コピーからのカスタム埋め込みヘルプの追加 」を参照してください。

    英語以外のカスタム埋め込みヘルプコンテンツレコードを作成するには、作業インスタンスを、記述する言語と同じ言語に設定する必要があります。英語の埋め込みヘルプコンテンツをコピーできない場合は、英語以外のカスタム埋め込みヘルプコンテンツを作成します。

    英語以外の埋め込みヘルプコンテンツレコードを作成した後、同じコンテンツレコードを英語で作成し、埋め込みヘルプ [sys_embedded_help_content] テーブルに保存する必要があります。英語の埋め込みヘルプコンテンツレコードは、他のすべての言語の親です。

    手順

    1. 移動先 すべて > 埋め込みヘルプ > ヘルプコンテンツ.
    2. コピーする埋め込みヘルプトピックを開きます。
      また、埋め込みヘルプペインのメニューから [ヘルプ記事の編集 ] を選択して、埋め込みヘルプトピックを開くこともできます。
    3. 必要に応じてフィールドを更新します。
      フィールド 説明
      名前 埋め込みヘルプトピック名。
      ページ このトピックに対応する UI ページ。通常、ページ名は変更しません。
      修飾子
      • 通常の コンテンツは、ページに移動した適切なロールを持つユーザーに表示されます。
      • セットアップ コンテンツは、ガイド付きセットアップのリンクからページにアクセスすると表示されます。
      ロール トピックが支援するように書かれているロール。ロールにアサインされたユーザーが関連する UI ページに移動すると、コンテンツが表示されます。

      そのロールを含むすべてのロールにも、そのロールをターゲットとする別のトピックが同じページに存在しない限り、コンテンツが表示されます。 詳細については、次を参照してください。 埋め込みヘルプ ロール
      アクティブ このコンテンツを UI ページに表示するかどうかを指定します。このチェックボックスをオフにすると、コンテンツを利用できなくなります。
      製品 [エンタープライズ ] がデフォルトであり、変更しないでください。
      修飾子 共通 UI ページにカスタム埋め込みヘルプを提供する修飾子。

      たとえば、すべてのホームページモジュールと多くのダッシュボードモジュールで home.do ページが開きます。この埋め込みヘルプレコードに入力する前に、修飾子を作成します。
      バージョン このトピックが適切なバージョン。 カスタムアプリケーションのコンテンツを編集する場合、または組織のビジネスプロセスに関連する情報を提供する場合は、[ すべて] を選択します。
      前回の同期 更新されたコンテンツについて CDN が最後に確認された日時。ユーザーがこの UI ページにアクセスすると、プラットフォームは前回の同期日時が 15 日以上前かどうかを判断します。その場合は、CDN で更新されたコンテンツがチェックされ、日付が更新されます。
      注:
      アドミニストレーターは、システムプロパティで最終同期期間を変更できます。
      順序 順序はデフォルトでロールに基づいており、ユーザーにロールがアサインされている場合に表示するコンテンツを決定します。詳細については、「埋め込みヘルプ ロール」を参照してください。
      ドメイン 該当する場合は、このコンテンツが使用されるドメインを指定します。

      このフィールドは、アドミニストレーターがフォームを表示するように設定した場合に、フォームに表示されます。
    4. [ コンテンツ ] フィールドで、必要に応じて HTML 書式設定ツールを使用してテキストを更新します。
      リンクを追加する場合は、Web ページへの完全な URL を入力します。[ターゲット] として [新しいウィンドウ (_blank)] を選択することをお勧めします。
      注:
      埋め込みヘルプトピックに画像を追加しないでください。レコードが保存されると、画像はコンテンツセクションから削除されます。

      埋め込みビデオを追加するには、「 ヘルプトピックへのビデオコンテンツの埋め込み」を参照してください。

    5. オプション: 表、ビデオ、または関連リンクの下に別の行を追加するには、改行アイコン (⏎) をクリックします。
    6. フォームヘッダーの [ コピー ] をクリックします。
      編集したトピックが保存され、リストが再表示されます。保存されたトピックの [ServiceNow ヘルプ ] チェックボックスがオフになっています。