埋め込みヘルプ 国際化

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間:3分
  • 埋め込みヘルプのインターナショナリゼーションにより、埋め込みヘルプのコンテンツをさまざまな言語にローカライズして、世界中のユーザーのニーズを満たすことができます。埋め込みヘルプコンテンツを任意の言語で記述し、表示する言語を決定できます。

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

    ローカライズされた埋め込みヘルプコンテンツについて

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

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

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

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

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

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

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

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

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

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