2. テンプレートの作成

このテンプレートを保管しておきたいフォルダを指定します。

テンプレートには名前をつけることができます。各テンプレートには、その内容や使途に応じた適切な名前をつけてください。 テンプレート名はテンプレートを選択する場面で、後述のテンプレート説明とともに表示されます。

テンプレートの名称は、必要に応じて随時変更して構いません。ただし、テンプレートの展開やメソッドの中で templateName() 関数を使用していて、その戻り値に応じて生成されるコンテンツを決定しているような場合には、参照箇所も同時に変更する必要があります。テンプレート名の変更は、既にそのテンプレートを使って作成されているページに影響を与えることはありません。

テンプレート表示名はテンプレートに付ける、テンプレート名とは別の別名です。テンプレート表示名はページ作成時にテンプレートを選ぶ場合など、テンプレートの名前を表示する必要のある箇所で使用されます。テンプレート表示名の設定は必須ではありません。必要のある場合にだけ付けてください。テンプレート表示名が指定されていないテンプレートの場合、テンプレート名の表示には、直接テンプレート名が使用されます。

テンプレート名はテンプレートの展開やメソッドの中で参照されている場合もあり、一旦決めてしまうと変更するのが難しくなります。一方、テンプレート表示名はそういった箇所では参照されないため（templateName() 関数はテンプレート表示名を返すことはありません）U/I の都合で変更することができます。

テンプレート表示名には英語名もつけることができます。英語名は、ユーザのブラウザの言語設定が日本語以外に設定されている状況でテンプレート名を表示される時に使用されます。

テンプレート種別は下記の３種類です。いずれかを選んでください。

公開テンプレート

ページデータテンプレート

非公開テンプレート

ページデータテンプレートまたは非公開テンプレートで作成されたページは公開サーバ上に配信されません。従って URL を持ちません。これらのタイプのテンプレートでページを作成する場合には、ページ編集画面でのファイル名が設定できません。また、同画面に URL は表示されません。

このテンプレートで作成されたページを公開サーバにアップロードする際に使用する文字エンコーディングを指定します。「 チャネルのエンコーディングに従う」を指定すると、そのチャネル向けのコンテンツを生成する場合には、そのチャネルに指定されている文字エンコーディングが使用されるようになります。文字エンコーディングについては「プライマリチャネルの設定」を参照してください。

このテンプレートで作成したページを公開サーバにアップロードした時のファイル名のサフィックスを指定します。一般的には "html" や "xml" などを指定しておくとよいでしょう。

ここで指定したサフィックスはページ作成時に自動的に生成されるファイル名に使われます。あるページだけ異なるサフィックスにしたい場合は、ページ編集画面で変更してください。

このテンプレートで作成したページを公開サーバにアップロードした時のファイルのモードを指定します。「デフォルト」を指定すると、サーバ側で設定されているデフォルトのモード（644 など）になります。特にファイルのモードを指定する必要がない場合には「デフォルト」を指定しておくとよいでしょう。

指定可能なモードは下記のとおりです。

デフォルト

644

744 (XBitHack on)

754 (XBithack full)

755

その他

ファイルモードの指定は「公開テンプレート」についてのみ行うことができます。「ページデータテンプレート」と、「非公開テンプレート」は、公開サーバ上に html がアップロードされることはないので、ファイルモードの指定はできません。

WebRelease は、バージョンによってテンプレートの展開の解釈が違う場合があります。古いバージョンの WebRelease で作成されたテンプレートをそのまま使用するために、ここでWTL (WebRelease Template Language) バージョンが指定できるようになっています。

WebRelease 2.80E でテンプレートを新規に作成すると、WTL バージョンは 2.80E に固定され、WTL バージョンの選択はできません。

古いバージョンの WebRelease で作成したテンプレートを 2.80E 環境にアップロードしたり、WebRelease をアップグレードすると、プルダウンメニューで2.01互換モード／ 2.2互換モード／ 2.21互換モード／ 2.30互換モード／ 2.40互換モード／ 2.70互換モード／ 2.80互換モード、のいずれかを選択できるようになります。

WTL バージョンを旧版の WebRelease 互換モードに設定して使用すると、WebRelease はそのテンプレートで作成されたコンテンツの生成を行なう場合に、可能な限り旧版の動作を再現しながら処理を進めます。これにより、以前に作成したテンプレートで生成したページの処理結果が、WebRelease のバージョンアップで違った結果になってしまうことを極力防いでいます。

一方で、旧版との互換モードを指定している限り、テンプレート中で新バージョンの機能を使うことはできません。たとえば新バージョンで導入された関数を旧版の互換モードが指定されているテンプレートの展開の中で使用することはできません。

一旦作成したテンプレートは、リニューアルなどのタイミングで、なるべく最新の WTL バージョンで稼動させるようにメンテナンスを行なっていただくことをお推めいたします。

「テンプレート一覧」画面または「コンポーネント一覧」画面の右上に表示される「WTL 設定」ボタンをクリックすると WLT 一括設定パネルが表示されます。このパネルを使えば、複数のテンプレートやコンポーネントに対して WTL バージョンを一括して設定することができます。

この項目を指定することで、展開結果のサイズの上限値を指定することができます。

この制限は、主にテンプレートの作成中に使用します。テンプレートの作成中には、例えば、入れ子になっている wr-for タグの閉じタグの記述が間違っているようなことが起こりがちです。そのような状態のテンプレートで作成されているページを Preview した場合など、予期せぬ非常に大きな展開結果を生成してしまい、それがシステム全体のレスポンス低下やメモリ不足などの障害を引き起こしてしまう可能性があります。テンプレート作成作業中には展開結果のサイズの上限を指定しておくことをお推めします。

新規にテンプレートを作成すると、展開結果サイズ制限の初期値は「10 M バイト」となります。ほとんどの場合、この初期値のまま使用していただいて問題ないと考えられますが、必要があれば制限値を変更して使用してください。

展開結果のサイズ制限は FTP 実行時にも適用されます。

「可能なかぎりエラーを検出」のチェックを ON にしておくと、コンテンツ生成時に、可能な限りエラーチェックを行い、エラーをレポートします。OFF にしておくと、エラーをなるべく抑えながらコンテンツ生成を行うように動作します。 なるべく ON にしてエラーが検出される状況でお使いください。

コンテンツ生成の動作に関する設定オプションです。

• 全角で表記された英字 (ＡからＺとａからｚ) を対応する半角表記に変換する
• 全角で表記された数字 (０１２３４５６７８９) を対応する半角表記に変換する
• 全角で表記された記号 (！”＃＄％＆’（）＊＋，－．／：；＜＝＞？＠［＼］＾＿｀｛｜｝～ ) を対応する半角表記に変換する
• 半角カタカナ (カタカナと記号。「」、と濁点と半濁点 ) を対応する全角表記に変換する
• 全角スペースを除去する
• 改行コードを LF (0x0a) に統一

のなかから、必要なチェックボックスをオンにしておくと、展開の結果生成されるコンテンツ中の該当する全角を半角に、また半角を全角に自動変換するフィルター処理が行なわれます。

「全角スペースを除去する」を指定しておくと、コンテンツ中に含まれている全角のスペースがすべて除去されます。

「改行コードを LF (0x0a) に統一」をオンにしておくと、行末の改行コードを NewLine (0x0a) に自動変換します。生成されるコンテンツが HTML ではなく、実行されるスクリプトの場合、行末コードに 0x0a が要求される場合があります。そういったコンテンツを生成するテンプレードでは、このチェックボックスをオンにしておいてください。

テンプレートに関する設定オプションです。

公開開始指定時刻の入力は必須

公開終了指定時刻の入力は必須

個別のページでエンコーディングの指定ができる

このテンプレートを使った新規ページの作成を禁止

削除禁止

このテンプレートを使って作成されているページの数が表示されます。

テンプレートの種類が増えてくると名前だけではテンプレートの違いを表現しにくくなってくる場合があります。テンプレートには、名前以外に簡単な説明をつけることができるようになっています。ページ作成時など、テンプレートを選ぶ必要のある状況では、テンプレート名（テンプレート表示名）とともに、テンプレート説明が表示されます。テンプレートの内容を理解しやすくするために、テンプレートに簡潔な説明をつけておいてください。 テンプレート説明には英語文もつけることができます。英語文は、ユーザのブラウザの言語設定が日本語以外に設定されている場合に、テンプレート説明が表示される時に使用されます。