埋め込みヘルプ 国際化

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間:3分
  • 埋め込みヘルプのインターナショナリゼーションにより、埋め込みヘルプのコンテンツをさまざまな言語にローカライズして、グローバルなユーザーのニーズを満たすことができます。選択した言語で埋め込みヘルプコンテンツを作成し、表示する言語を決定できます。

    既存の埋め込みヘルプコンテンツレコードは、デフォルトで英語で書かれています。ベースシステムで提供されている英語の埋め込みヘルプコンテンツを、ニーズに合わせて他の言語に翻訳できます。選択した言語でカスタム埋め込みヘルプコンテンツを作成することもできます。

    ローカライズされた埋め込みヘルプコンテンツを理解する

    英語の埋め込みヘルプコンテンツを別の言語に翻訳したり、英語以外の言語で埋め込みヘルプコンテンツを作成したりするには、ワーキングセッションを、作成する言語に構成する必要があります。たとえば、フランス語で埋め込みヘルプコンテンツを記述する場合は、フランス語のセッションで作業している必要があります。詳細については、 ローカリゼーション設定 を参照してください。

    埋め込みヘルプキュー [sys_embedded_help_queue] テーブルの [言語 ] フィールドにアクセスして、選択した言語で表示する埋め込みヘルプコンテンツを構成します。インスタンスでアクティブ化されている外国語翻訳に応じて、埋め込みヘルプコンテンツを表示する言語を選択できます。

    埋め込みヘルプコンテンツが特定の言語で利用可能であり、ユーザーがその言語のインスタンスで作業している場合、目的の言語で利用可能な埋め込みヘルプが表示されます。

    ローカライズされた埋め込みヘルプコンテンツの操作

    ユーザーが埋め込みヘルプコンテンツレコードを要求すると、関連する埋め込みヘルプキューレコードがそれに応じて入力され、埋め込みヘルプキューレコードで指定された言語が現在のセッション言語に設定されます。

    埋め込みヘルプコンテンツがユーザーのセッション言語で利用可能な場合、コンテンツは同じ言語で表示されます。埋め込みヘルプコンテンツがユーザーのセッション言語で利用できない場合は、英語のコンテンツが表示されます。ただし、英語以外のセッションで英語のコンテンツを表示したくない場合は、sys_propertyを False (デフォルトは True) に設定できます。

    埋め込みヘルプコンテンツの優先順位付け

    ユーザーのセッション言語での埋め込みヘルプコンテンツの表示は、ロール、コンテンツがユーザー作成かどうか、最新のコンテンツバージョンなど、他のすべてのメカニズムよりも優先されます。

    ユーザーが英語以外のワーキングセッションに参加している場合、埋め込みヘルプコンテンツの表示の優先度は次のとおりです。
    1. 利用可能な場合は、ワーキングセッション言語 (英語以外) コンテンツが表示されます。
    2. ユーザー作成コンテンツは、ワーキングセッション言語のコンテンツが利用できない場合に表示されます。
    3. バージョン関連のコンテンツは、作業セッション言語とユーザーが作成したコンテンツが利用できない場合に表示されます。
    たとえば、admin ユーザーがフランス語のワーキングセッション中に埋め込みヘルプコンテンツを要求しているが、admin ロールでフランス語のコンテンツを利用できない場合、それより下位のロールでも同じ言語のコンテンツがあれば表示されます。

    フランス語の admin ロールには埋め込みヘルプコンテンツがなく、フランス語の itil ロールと英語の admin ロールのコンテンツがある場合は、フランス語の itil ロールが英語の admin ロールよりも優先されます。フランス語のコンテンツは、itil ロールレベルで表示されます。