JavaScript コード・エレメントの追加

テンプレート内で使用しているコードの各ブロックに JavaScript コード・エレメントを使用します。
制約事項: 新規フィーチャー・アイコン JavaScript コード・エレメントは バージョン 2 テンプレートでのみ使用可能です。

このタスクについて

JavaScript は、単純な引数から複雑なスクリプトに至るまで、広範囲に利用できます。
  • 単純な引数の場合、スクリプトはテキスト・エレメントなどのエレメントのコンテンツに適用できます。 テキスト・エレメントをダブルクリックし、「スクリプト式」タブを選択し、スクリプトを入力します。
  • 複雑なスクリプトの場合、JavaScript コード・エレメントを使用してスクリプトを適用するため、このタスクを使用できます。
エレメントの「スクリプト式」タブで JavaScript コード・エレメントを使用することには、次のような利点があります。
  • 他のユーザーが使用したスクリプトを再利用できます。
  • 実行順序を考慮する必要なく計算をグループ化できます。
  • 通常のデータ構造体と複合データ構造体 (コレクションなど) を作成し、それに継続的に追加することができます。
    注: 1 つの JavaScript コード・エレメントで定義された機能を、別の JavaScript コードまたはテキスト・エレメントで呼び出すことはできません。

JavaScript ファイル utils.js が、インストール・ファイルと、事前定義のセントラル管理コンポーネント・ファイルに自動的に組み込まれます。これはレポート出力に現在日付を組み込むなどの、単純な JavaScript に使用されます。

テンプレート内の既存の JavaScript コードのリストを表示するには、 「テンプレート」 > 「JavaScript のレビュー」をクリックします。 「検索」ビューが開き、JavaScript を使用するエレメントのリストが表示されます。 ネイティブ・フィルターは、このコンテキストでは JavaScript とはみなされません。 ネイティブ・フィルターは、 検索結果にはリストされません。

手順

  1. JavaScript の処理を開始する前に、テンプレートを保存します。
  2. 「パレット」ビューで、「JavaScript コード」アイコン 「JavaScript コード」エレメントを選択して、テンプレート・コンテンツ・エディターにドラッグします。
  3. JavaScript コード・エレメントをダブルクリックします。
  4. 「スクリプト式」タブで、JavaScript コードを適用するツリーから変数を選択します。
  5. 以下のいずれかのオプションを使用して、JavaScript コードを入力します。
    • このウィンドウでスクリプトを手動で記述する
    • 外部エディターからこのウィンドウにスクリプトをコピーして貼り付ける
    • 「スクリプトの組み込み」をクリックして、コンピューター、リモート・サーバー、またはセントラル管理コンポーネントからファイルを選択する
  6. オプション: スクリプトを XHTML からコピーする場合は、 以下のことを行うことができます。
    • 「XHTML 入力」オプションを選択して スクリプトに含まれている XHTML タグを編集できるようにする。
    • 「XHTML 入力」オプションをクリアして、 スクリプトからすべての XHTML タグを削除する。
    条件内でリッチ・テキストをコピーしているか、または リッチ・テキストを使用している場合は、「XHTML 入力」オプションを選択する必要があります。
    重要: 無効な XHTML により文書生成が失敗します。変更内容を保存する前に、 ご使用の XHTML が有効であることを確認します。
  7. オプション: XHTML 出力内にテンプレートを生成している場合は、 以下のことを行うことができます。
    • 「XHTML 出力」オプションを選択して、 スクリプトを解析してスクリプトをリッチ・テキストとしてレンダリングする。
    • 「XHTML 出力」オプションをクリアして、 スクリプトをプレーン・テキストとして処理する。
    この選択は、式内のデータ・ソース属性のすべてに 適用されます。スクリプト内でプレーン・テキストと XHTML を混在させることはできません。

    リッチ・テキストをコピーしているか、または必要に応じて随時にリッチ・テキストを作成している場合、 「XHTML 出力」オプションを選択する必要があります。

  8. スクリプトを入力した後、「スクリプトのテスト」をクリックし、コードを検証します。 JavaScript にエラーがある場合、文書の生成が正常に完了しない可能性があります。
  9. 「OK」をクリックして変更を保存します。 コードのブロックがエレメント内で省略されます。テンプレート・コンテンツ・エディター内で コードを表示するために展開できます。

JavaScript エディターでの作業

JavaScript エディターは、色分けされたフォーマット設定や行番号付けを利用してスクリプトを処理するために使用します。

手順

  1. JavaScript コード・エレメントをダブルクリックします。 「JavaScript コード・エレメントのコードの入力」ウィンドウが開きます。
  2. オプション: 新規スクリプトを別のファイルから組み込む場合は、「スクリプトの組み込み」をクリックして、コンピューター、リモート・サーバー、またはセントラル管理コンポーネントからファイルを選択します。「OK」をクリックしてウィンドウを閉じ、エレメントをダブルクリックして「JavaScript コード・エレメントのコードの入力」ウィンドウを再度開きます。
  3. 「エディターで開く」をクリックし、スクリプトを Eclipse JavaScript エディターに入力します。 スクリプトが新規エディター・タブに一時 .js ファイルとして開かれ、その JavaScript を編集できます。
    注: 入力を開始し、ピリオドまたは別の文字を値として入力すると、「JavaScript ファイルのアクセス中にエラーが発生しました」メッセージが表示されることがあります。 これには「コンテンツ・アシスト中に問題が発生しました」メッセージが続くこともあります。 これらのメッセージを検出したら、メッセージに示される指示を実行して、「その他の JavaScript プロポーザル」オプションを無効にします。
    1. 「ウィンドウ」 > 「設定」 > 「JavaScript」 > 「エディター」 > 「コンテンツ・アシスト」 > 「拡張」をクリックします。
    2. 「コンテンツ・アシストのサイクル」セクションで、「その他の JavaScript プロポーザル」オプションをクリアします。
    3. 「OK」をクリックしてウィンドウを閉じます。
  4. 「アウトライン」ビューのオプションでスクリプトを管理します。
  5. 変更を保存します。
  6. 一時 JavaScript エディター・タブを閉じます。 「JavaScript コード・エレメントのコードの入力」ウィンドウに戻ります。
  7. 「スクリプトのテスト」をクリックし、コードを検証します。
  8. 「OK」をクリックし、変更内容を保存して ウィンドウを終了します。

フィードバック