一覧表・単票のXMLタグ
最終更新日:2024年02月29日
一覧表・単票機能の一覧表設定画面にて、ソースデザインを選択した場合、XSLファイルを作成し設定することができますが、
そのXSLファイルを作成する際、XMLのツリー構造やタグについて把握しておく必要があります。
そのため、当ページでは検索フォームや一覧表のXMLについて、説明します。
ページの構成
一覧表は「検索フォーム」と「一覧表」について、それぞれXSLを設定するため、当ページも「検索フォーム」と「一覧表」について、XMLのツリー構造およびXMLタグとその属性について、説明します。
用語説明
当ページで使用する用語と意味は次の通りです。
| 用語 |
意味 |
| 検索フォーム |
スパイラルの一覧表・単票機能で使用する検索フォームのこと。 |
| 構造 |
XMLツリー構造のこと。 |
| タグ |
< >で囲まれたXMLの要素のこと。例）<main> |
| 属性 |
タグに属するもので、タグに対して情報を付与する。例）<searchForm action="xxxx"> actionが属性 |
| 親タグ |
説明対象のタグが所属するタグのこと。 |
| 子タグ |
説明対象のタグに所属するタグのこと。 |
| テキスト出力 |
開始タグと終了タグに囲まれた文字列のこと。例）<page>1</page> |
| 図式 |
説明対象のタグが検索フォームや一覧表のどこに該当するか表した図のこと。 |
検索フォーム
構造
<searchForm>
<fieldList>
<sys_id>
<main>
<value1 />
<value2 />
</main>
<option>
<action>
<select></select>
<select></select>
</action>
</option>
</sys_id>
<usr_example1>
<main>
<select></select>
<select></select>
</main>
</usr_example1>
<usr_example2>
<main />
<option>
<exType>
<select></select>
<select></select>
</exType>
<exists>
<select></select>
<select></select>
</exists>
<action>
<select></select>
<select></select>
</action>
</option>
</usr_example2>
<sys_multiSearch>
<main/>
<option>
<exType>
<select></select>
<select></select>
<select></select>
<select></select>
</exType>
<action>
<select></select>
<select></select>
</action>
</option>
</sys_multiSearch>
</fieldList>
<submit></submit>
</searchForm>
タグおよび属性の説明
| タグ |
searchForm |
| 説明 |
検索フォームの全体を定義 |
| 属性 |
action（検索条件の送信先） |
| 親タグ |
なし |
| 子タグ |
fieldList, submit |
| テキスト出力 |
なし |
| 図式 |
 |
| タグ |
fieldList |
| 説明 |
検索条件に使用するフィールドを定義 |
| 属性 |
なし |
| 親タグ |
searchForm |
| 子タグ |
sys_multiSearch, sys_id, usr_フィールドの差し替えキーワード |
| テキスト出力 |
なし |
| 図式 |
 |
| タグ |
sys_id |
| 説明 |
レコードIDの検索条件を定義 |
| 属性 |
id（0固定）, title（id固定）, type（id固定） |
| 親タグ |
fieldList |
| 子タグ |
main, option |
| テキスト出力 |
なし |
| 図式 |
 |
| タグ |
usr_フィールドの差し替えキーワード |
| 説明 |
フィールド毎に検索条件を定義 |
| 属性 |
id（フィールドコード）, title（差し替えキーワード）, type（フィールドタイプ） |
| 親タグ |
fieldList |
| 子タグ |
main, option |
| テキスト出力 |
なし |
| タグ |
sys_multiSearch |
| 説明 |
複数フィールドによる検索項目 |
| 属性 |
id（-1固定）, title（multiSearch固定）, type（multiSearch固定） |
| 親タグ |
fieldList |
| 子タグ |
main, option |
| テキスト出力 |
なし |
| タグ |
main |
| 説明 |
検索する文字列 |
| 属性 |
name（どの一覧表のどのフィールドの検索文字列かを識別） |
| 親タグ |
sys_id, sys_multiSearch, usr_フィールドの差し替えキーワード |
| 子タグ |
レコードIDの場合、value1, value2。選択項目の場合、select |
| テキスト出力 |
なし |
| タグ |
option |
| 説明 |
検索条件 |
| 属性 |
なし |
| 親タグ |
sys_id, usr_フィールドの差し替えキーワード, sys_multiSearch |
| 子タグ |
exType, exists, action |
| テキスト出力 |
なし |
| タグ |
exType |
| 説明 |
検索の種類 |
| 属性 |
name（どの一覧表のどのフィールドに関する検索種類なのかを識別） |
| 親タグ |
option |
| 子タグ |
select |
| テキスト出力 |
なし |
| タグ |
exists |
| 説明 |
値の有無を指定 |
| 属性 |
name（どの一覧表のどのフィールドの有無かを識別） |
| 親タグ |
option |
| 子タグ |
select |
| テキスト出力 |
なし |
| タグ |
action |
| 説明 |
検索範囲の指定（を検索, 以外を検索） |
| 属性 |
name（どの一覧表のどのフィールドの検索範囲かを識別） |
| 親タグ |
option |
| 子タグ |
select |
| テキスト出力 |
なし |
| タグ |
select |
| 説明 |
検索の種類の選択肢 |
| 属性 |
value（検索の種類コード※） |
| 親タグ |
main, exType, exists, action |
| 子タグ |
なし |
| テキスト出力 |
あり（※） |
※属性valueの値やテキスト出力について、所属する親タグまたはフィールドタイプにより異なります。以下をご覧ください。
親タグが「main」の場合
セレクト、マルチセレクト、都道府県
フィールドのラベルIDとラベル名称になります。
<select value="1">ラベル１</select>
<select value="2">ラベル２</select>
不正アドレス
<select value="true">不正アドレス</select>
<select value="false">正常アドレス</select>
<select value="null">値なし</select>
モバイルドメイン
<select value="true">モバイルドメイン</select>
<select value="false">非モバイルドメイン</select>
<select value="null">値なし</select>
重複フラグ
<select value="true">重複する</select>
<select value="false">重複しない</select>
<select value="null">値なし</select>
ブーリアン
<select value="false">いいえ</select>
<select value="true">はい</select>
<select value="null">値なし</select>
配信エラー
<select value="4">不明なエラー(unknown)</select>
<select value="2">一時的なエラー(4.x.x)</select>
<select value="1">恒久的なエラー(5.x.x)</select>
<select value="null">値なし</select>
曜日
<select value="0">日</select>
<select value="1">月</select>
<select value="2">火</select>
<select value="3">水</select>
<select value="4">木</select>
<select value="5">金</select>
<select value="6">土</select>
親タグが「exType」の場合
<select value="0">完全一致</select>
<select value="1">部分一致</select>
<select value="7">全てを含む</select>
<select value="8">いずれかを含む</select>
<select value="16">AND</select>
<select value="17">OR</select>
※属性valueの値とテキスト出力はフィールドタイプにより異なります。操作画面にて、サンプルXMLをご確認ください。
親タグが「action」の場合
<select value="0">を検索</select>
<select value="1">以外を検索</select>
親タグが「exists」の場合
<select value="0">全て</select>
<select value="2">値なし</select>
<select value="3">値あり</select>
| タグ |
submit |
| 説明 |
検索ボタン |
| 属性 |
name（どの一覧表の検索ボタンかを識別） |
| 親タグ |
searchForm |
| 子タグ |
なし |
| テキスト出力 |
あり（検索） |
一覧表
構造
<table>
<pager>
<page></page>
<page></page>
</pager>
<cardList>
<card></card>
<card></card>
</cardList>
<fieldList>
<field />
<field>
<label></label>
<label></label>
</field>
</fieldList>
<data>
<record>
<usr_example1></usr_example1>
<usr_example2>
<full_text></full_text>
<year></year>
<month></month>
<day></day>
<hour></hour>
<minute></minute>
<second></second>
<wday></wday>
</usr_example2>
<usr_example3>
<full_label></full_label>
<full_id></full_id>
<separated_label>
<label></label>
<labe></label>
</separated_label>
</usr_example3>
</record>
</data>
</table>
タグおよび属性の説明
注1．日付フィールドおよびマルチセレクトフィールドで定義されている子タグおよび属性
日付フィールド
| タグ |
usr_フィールドの差し替えキーワード |
| 説明 |
日付フィールドの出力を定義 |
| 属性 |
timezone_digit（標準時間）, timezone_name（タイムゾーン名称） |
| 親タグ |
record |
| 子タグ |
full_text, year, month, day, hour, minute, second, wday |
| テキスト出力 |
なし |
| タグ |
full_text |
| 説明 |
日付フィールドに登録されている値 |
| 属性 |
なし |
| 親タグ |
usr_フィールドの差し替えキーワード |
| 子タグ |
なし |
| テキスト出力 |
あり（DB内登録データをそのまま出力） |
| タグ |
year |
| 説明 |
年を出力 |
| 属性 |
short（西暦二桁。一桁の場合、頭を0で埋める） |
| 親タグ |
usr_フィールドの差し替えキーワード |
| 子タグ |
なし |
| テキスト出力 |
あり（西暦の年） |
| タグ |
month |
| 説明 |
月を出力 |
| 属性 |
longLabel（英語表記の完全形）, shortLabel（英語表記の省略形） |
| 親タグ |
usr_フィールドの差し替えキーワード |
| 子タグ |
なし |
| テキスト出力 |
あり（西暦の月。一桁の場合、頭を0で埋めない） |
| タグ |
day |
| 説明 |
日を出力 |
| 属性 |
なし |
| 親タグ |
usr_フィールドの差し替えキーワード |
| 子タグ |
なし |
| テキスト出力 |
あり（西暦の日。 一桁の場合、頭を0で埋めない） |
| タグ |
hour |
| 説明 |
時を出力 |
| 属性 |
meridiem（am/pm表記）, semidiurnal（12時間制） |
| 親タグ |
usr_フィールドの差し替えキーワード |
| 子タグ |
なし |
| テキスト出力 |
あり（時。 一桁の場合、頭を0で埋める） |
| タグ |
minute |
| 説明 |
分を出力 |
| 属性 |
なし |
| 親タグ |
usr_フィールドの差し替えキーワード |
| 子タグ |
なし |
| テキスト出力 |
あり（分。 一桁の場合、頭を0で埋める） |
| タグ |
second |
| 説明 |
秒を出力 |
| 属性 |
なし |
| 親タグ |
usr_フィールドの差し替えキーワード |
| 子タグ |
なし |
| テキスト出力 |
あり（秒。 一桁の場合、頭を0で埋める） |
| タグ |
wday |
| 説明 |
曜日を出力 |
| 属性 |
longLabel（英語表記の完全形）, shortLabel（英語表記の省略形） |
| 親タグ |
usr_フィールドの差し替えキーワード |
| 子タグ |
なし |
| テキスト出力 |
あり（日本語の曜日） |
マルチセレクトフィールド
| タグ |
usr_フィールドの差し替えキーワード |
| 説明 |
マルチセレクトの出力を定義 |
| 属性 |
なし |
| 親タグ |
record |
| 子タグ |
full_label, full_id, separated_label |
| テキスト出力 |
なし |
| タグ |
full_label |
| 説明 |
マルチセレクトのラベル名称を定義 |
| 属性 |
なし |
| 親タグ |
usr_フィールドの差し替えキーワード |
| 子タグ |
なし |
| テキスト出力 |
あり（ラベル名称をコンマ区切り） |
| タグ |
full_id |
| 説明 |
マルチセレクトのラベルIDを定義 |
| 属性 |
なし |
| 親タグ |
usr_フィールドの差し替えキーワード |
| 子タグ |
なし |
| テキスト出力 |
あり（ラベルIDをコンマ区切り） |
| タグ |
separated_label |
| 説明 |
マルチセレクトのラベルID・ラベル名称のセット全てを定義 |
| 属性 |
なし |
| 親タグ |
usr_フィールドの差し替えキーワード |
| 子タグ |
label |
| テキスト出力 |
なし |
| タグ |
label |
| 説明 |
マルチセレクトとのラベルID、ラベル名称のセット |
| 属性 |
なし |
| 親タグ |
separated_label |
| 子タグ |
なし |
| テキスト出力 |
あり（ラベル名称） |
画像型フィールド
| タグ |
usr_フィールドの差し替えキーワード |
| 説明 |
画像型フィールドの出力を定義 |
| 属性 |
original（オリジナル画像のURL） |
| 親タグ |
record |
| 子タグ |
なし |
| テキスト出力 |
あり（オリジナル画像表示用URL） |
ファイルフィールド
| タグ |
usr_フィールドの差し替えキーワード |
| 説明 |
ファイルフィールドの出力を定義 |
| 属性 |
download（ダウンロード用関数）, icon（ファイル種類に応じたアイコン画像）, size（ファイルサイズ）, type（ファイル種類） |
| 親タグ |
record |
| 子タグ |
なし |
| テキスト出力 |
あり（拡張子付きファイル名称） |
| タグ |
table |
| 説明 |
一覧表テーブルを定義。 |
| 属性 |
action（一覧表の再表示を要求する送信先）, jsEncode（EUC-JP固定）, jsPath（スパイラルが使用しているJSファイル。固定）, tableId（一覧表番号） |
| 親タグ |
なし |
| 子タグ |
pager, cardList, fieldList, data |
| テキスト出力 |
なし |
| 図式 |
 |
| タグ |
pager |
| 説明 |
ページャーを定義 |
| 属性 |
current（現在表示しているページ数）,offset_end（何件まで）, offset_start（何件から） |
| 親タグ |
table |
| 子タグ |
page |
| テキスト出力 |
なし |
| 図式 |
 |
| タグ |
page |
| 説明 |
ページ数およびリンク先を定義 |
| 属性 |
start（最初のページ）, url（ページのURL）, omit（ページ数省略「…」）,
scope_end, scope_start, current（現在のページ数）, end（最後のページ） |
| 親タグ |
pager |
| 子タグ |
なし |
| テキスト出力 |
あり（ページ数, 「…」） |
| 図式 |
 |
| タグ |
cardList |
| 説明 |
一覧表からリンクしている単票を定義 |
| 属性 |
なし |
| 親タグ |
table |
| 子タグ |
card |
| テキスト出力 |
なし |
| 図式 |
 |
| タグ |
card |
| 説明 |
単票名、単票ごとに割り当てられるid、単票ページのURLを定義 |
| 属性 |
name（単票名）, recordId（単票に割り当てられたid）, title（単票タイトル） |
| 親タグ |
cardList |
| 子タグ |
なし |
| テキスト出力 |
あり（単票ページのURL） |
| 図式 |
 |
| タグ |
fieldList |
| 説明 |
ソート行のURLを定義または編集モードでの使用フィールドの定義 |
| 属性 |
idSort（初期のソート順） |
| 親タグ |
table |
| 子タグ |
field |
| テキスト出力 |
なし |
| 図式 |
 |
| タグ |
field |
| 説明 |
ソート行に表示するフィールドを定義 |
| 属性 |
code（フィールドコード）, id（フィールドID）, sort（ソート行のURL）,title（XSLのセレクタ） |
| 親タグ |
fieldList |
| 子タグ |
label |
| テキスト出力 |
なし |
| 図式 |
 |
| タグ |
label |
| 説明 |
選択形式のフィールドの場合、ラベルID、ラベル名称を定義 |
| 属性 |
value（ラベルID） |
| 親タグ |
field |
| 子タグ |
なし |
| テキスト出力 |
あり（ラベル名称） |
| 図式 |
 |
| タグ |
data |
| 説明 |
DB内登録データの表示方法を定義しています。 |
| 属性 |
count（ページ内表示件数）, limit（選択されている表示件数）,sort（初期ソート）, total（全レコード件数） |
| 親タグ |
table |
| 子タグ |
record |
| テキスト出力 |
なし |
| 図式 |
 |
| タグ |
record |
| 説明 |
DB内の1レコードを定義 |
| 属性 |
id（行番号。1=1行目、2=2行目） |
| 親タグ |
data |
| 子タグ |
usr_フィールドの差し替えキーワード |
| テキスト出力 |
なし |
| 図式 |
 |
| タグ |
usr_フィールドの差し替えキーワード |
| 説明 |
DB内登録データの出力を定義
（注1）日付フィールド、マルチセレクトフィールド、
画像型フィールドおよびファイルフィールドは、
定義されている子タグおよび属性が異なります。 |
| 属性 |
なし |
| 親タグ |
record |
| 子タグ |
なし |
| テキスト出力 |
あり（DB内登録データ） |
| 図式 |
 |
