フォームアーカイブ 設定ファイル
【注意】
- この機能はIIJ Webスタンダード2サービスでのみご利用いただけます
ファイルセットの中にあるconfig.txtというファイルがフォームアーカイブの設定ファイルです。
このファイルを編集することによって、フォームアーカイブの入力項目や入力されたデータの生成方法を変更することができます。
設定ファイルに記載できる内容について説明します。
設定ファイルの記述方法
設定ファイル内では様々な設定を複数のブロックに分けて記述します。
各ブロック内では1行につき1つの設定を記述することができます。設定の記述形式は以下の通りです。
なお、設定ファイルにおいて行の最初に#が書かれている場合、その行は無視されます。
設定項目名 = 設定内容
また、各ブロックで設定可能な項目が異なります。ブロックごとの設定可能項目については各ブロックの説明をご覧ください。
設定ファイル内で利用可能なブロックは以下のとおりです。
- [html] ブロック
- [form] ブロック
- [file] ブロック
- [redirect] ブロック
- [limit] ブロック
[html]:自動生成画面の文字コードの設定
フォームアーカイブにおいて自動生成される画面の文字コードを指定することができます。
設定項目名 | 設定可能内容 | 設定内容 |
---|---|---|
charset |
| 文字コードを設定可能内容のいずれかに指定することができます |
記述例
[html] charset = shift_jis
[form]:入力項目の設定
フォームアーカイブで使用される入力項目及び各入力項目のエラー条件を指定することができます。利用可能な設定項目とその内容について説明します。
設定項目名 | 設定可能内容 | 設定内容 |
---|---|---|
fields | 任意の項目名を指定できます | フォームアーカイブで使用するすべての項目名を半角スペース、またはタブで区切って記述することができます 項目名には半角英数字(大文字・小文字は区別されます)とアンダーバーのみ使用することができます 数字、またはアンダーバーで始まる項目名は使用できません |
required | fields で記述した項目名から任意に指定できます | 入力を必須にしたい項目名を半角スペース、またはタブで区切って記述することができます この行に記述された項目に、何も入力されなかった場合はエラーとなり、エラー画面が表示されます |
validate | ※後述します | 1行に1個ずつ「項目名 = 入力チェック種別」の形式で、入力チェックを行う項目と、行うチェックの種類を記述することができます 入力チェック種別の記述では、大文字と小文字は区別されます 1つの項目に設定することのできる入力チェック種別は1つのみです |
項目名の制限
項目名として、次の名前はご利用になれません。
ALL
validate の入力チェック種別
[form] ブロックで利用可能なvalidateでは、以下の入力チェック種別をご利用いただけます。
入力チェック種別 | 説明 |
---|---|
ZENKAKU | 全角文字以外が入力された場合、エラーになります |
HANKAKU | 半角文字以外が入力された場合、エラーになります |
ZENKAKU_NUM | 全角数字以外が入力された場合、エラーになります |
NUM | 半角数字以外が入力された場合、エラーになります |
メールアドレス形式ではないものが入力された場合、エラーになります | |
項目名1 = eq 項目名2 | 項目名1に入力されたものと、項目名2に入力されたものが等しくない場合、エラーになります |
記述例
[form] fields = NAME EMAIL POST ADDRESS SEX JOB HOBBY COMMENT PASS1 PASS2 ← 半角スペースまたはタブで区切る required = NAME EMAIL POST ADDRESS COMMENT PASS1 PASS2 ← NAME、EMAIL、POST、ADDRESS、COMMENT、PASS1、PASS2に入力がなければエラー validate EMAIL = EMAIL ← メールアドレス形式のみ validate POST = NUM ← 半角数字のみ validate NAME = ZENKAKU ← 全角文字のみ validate PASS1 = HANKAKU ← 半角文字のみ validate PASS2 = eq PASS1 ← PASS1とPASS2が異なればエラー
[file]:日次ファイルの設定
フォームアーカイブに入力されたデータは1日分ごとに、日次ファイルと呼ばれる1つのファイルにまとめることができます。
[file] ブロックでは日次ファイルをどのように生成するかを指定することができます。
設定項目名 | 設定可能内容 | 設定内容 |
---|---|---|
store |
| 日次ファイルをlogsフォルダに作成します。フォームアーカイブではonを指定してください |
charset |
| 日次ファイルの文字コードを設定可能内容のいずれかに指定することができます |
eol |
| 日次ファイルの改行コードを設定可能内容のいずれかに指定することができます |
format |
| 日次ファイルの形式を指定することができます カンマで区切る場合はcsv、タブで区切る場合はtsvを記述してください |
fields | 任意の並び順を指定できます | 各項目をどのような順番で日次ファイルに記述するかを指定することができます
|
記述例
[file] store = on ← 日次ファイルをlogsフォルダに作成 charset = shift_jis ← 文字コードはSHIFT-JIS eol = lf ← 改行はLF format = csv ← カンマ区切り fields = NAME EMAIL POST ADDRESS SEX JOB HOBBY COMMENT PASS1 _datatime _seq
[redirect]:自動生成画面の替わりに表示されるページの設定
フォームアーカイブの入力画面や送信完了画面として自動生成画面ではないWebページを用いることができます。利用可能な設定項目とその内容について説明します。
設定項目名 | 設定可能内容 | 設定内容 |
---|---|---|
input | 任意のURLを指定できます | フォームアーカイブの入力画面として表示するWebページのURLを指定することができます 自動生成画面ではないWebページを入力画面として使用する場合は、該当ページのURLをここに指定してください 入力画面として自動生成ではないWebページを使用する方法については、フォームアーカイブ 入力画面を自動生成しない もご覧ください |
thanks | 任意のURLを指定できます | フォームアーカイブの送信完了画面として表示するWebページのURLを指定することができます 自動生成画面ではないWebページを送信完了画面として使用する場合は、該当ページのURLをここに指定してください フォームアーカイブへの入力後すぐに別のフォームアーカイブに移動させたい場合などにご利用いただけます |
[limit]:連続送信の制限の設定
フォームアーカイブにおいて、同じユーザが短時間に連続して送信することを防止することができます。利用可能な設定項目とその内容について説明します。
設定項目名 | 設定可能内容 | 設定内容 |
---|---|---|
post_interval | 任意の秒数を指定できます | メールフォームからの送信が行われた後、設定された秒数の間は同じIPアドレスからの送信を行うことができなくなります 最大600秒まで設定することができ、この値を0に設定することでこの制限を解除することもできます |
sessionid |
| セッションIDはメールフォームの同じ画面から繰り返し送信することを防ぐ仕組みです この機能を使用する場合、確認画面を表示してから送信完了画面を表示するまでの時間が30分に制限されますのでご注意ください |