フィールド用に生成された HTML を制御する

このタスクについて

Domino® では、Release 8 からフォームレベルと個々のフィールドレベルの両方で生成された HTML を変更する機能が追加されました。これらのオプションは HTML には組み込まれていません (HTML に組み込まれている属性については、「HTML 属性をフィールドに追加する」を参照) が、これらのオプションを設定すると、Domino サーバーによってフィールドが HTML に変換される方法や、そのフィールドでの入力の処理方法を制御できます。

オプションは name=value のペアのリストで指示します。name は、英数字 (文字、数値、下線、ダッシュ) で構成され、設定されるオプションを示します。value は数値であり、該当するオプションの設定値を示します。

特定のフィールドの HTML オプションは、$$HTMLOptions_fieldname という名前の対応するテキストフィールドに保存されます。このフィールドに複数の HTML オプションを設定する場合は、複数の値を入力できるようにフィールドを設定する必要があります。

フィールドレベルの HTML オプションは、フォームレベルの HTML オプションより優先されます。

パススルー HTML をフィールド内で無効にする

このタスクについて

Domino Release 8 では、パススルー HTML をサーバーレベルで無効にすることに加えて、単一のフィールドに対してパススルー HTML を無効にする機能が追加されました。パススルー HTML を無効にすると、パススルー HTML タグ [< と >] で囲まれたすべての HTML は、通常のテキストとして処理されます。

手順

  1. パススルー HTML を無効にする対象のフィールドを作成します。
  2. $$HTMLOptions_fieldname という名前の非表示のテキストフィールドである [表示用の計算結果] を作成します。
  3. パススルー HTML をどの程度無効にするかに基づいて、このテキストフィールドの値を指定します。
    • すべてのパススルー HTML を使用可能にするには、「DisablePassThruHTML=0」を指定します。
    • [< と >] タグのみを無効にするには、「DisablePassThruHTML=1」を指定します。
    • Notes エディタの段落スタイル html を持つパススルー HTML を表示するには、「DisablePassThruHTML=2」を指定します。
    • リッチテキストパススルー属性を持つパススルー HTML にマークを付けるには、「DisablePassThruHTML=4」を指定します。
    • すべてのパススルー HTML を無効にし、Notes エディタの段落スタイル html を持つパススルー HTML を表示して、リッチテキストパススルー属性を持つパススルー HTML にマークを付けるには、「DisablePassThruHTML=7」を指定します。
      注: この設定は、この特定のフィールドでパススルー HTML を無効にするためのサーバーの設定に優先するため、値を 0 に指定すると、パススルー HTML を無効にするためにサーバーで DominoDisablePassThruHTML を設定した場合でも、このフィールドについては HTML をパススルーできるようになります。

タスクの結果

この設定は、入力には影響せず、レンダリング (Web サーバーから生成される出力) に影響します。このため、ユーザーはパススルー HTML を含むアイテムを引き続き登録できますが、Web サーバーから出力 HTML が生成される場合には、そのアイテムがパススルー HTML を含むとはみなされません。

DisablePassThruHTML のフィールドレベルの設定は、以下の処理には影響しません。

  • Notes クライアントがパススルー HTML を処理するかどうかとその方法
  • 「未加工の」HTML を文書に挿入するその他の方法 (例えば、コンテントタイプ HTML としてフォームにマークを付ける、または HTML という名前のフィールドを文書に挿入する方法)