ver.1サポートサイト

一覧表・単票 > XMLタグの説明

最終更新日:2020年11月20日


当ページについて

目的

一覧表・単票機能の一覧表設定画面にて、ソースデザインを選択した場合、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
テキスト出力 なし
図式 searchform
タグ fieldList
説明 検索条件に使用するフィールドを定義
属性 なし
親タグ searchForm
子タグ sys_multiSearch, sys_id, usr_フィールドの差し替えキーワード
テキスト出力 なし
図式 fieldList
タグ sys_id
説明 レコードIDの検索条件を定義
属性 id(0固定), title(id固定), type(id固定)
親タグ fieldList
子タグ main, option
テキスト出力 なし
図式 sys_id
タグ 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">ラベル1</select>
<select value="2">ラベル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
テキスト出力 なし
図式 table
タグ pager
説明 ページャーを定義
属性 current(現在表示しているページ数),offset_end(何件まで), offset_start(何件から)
親タグ table
子タグ page
テキスト出力 なし
図式 pager
タグ page
説明 ページ数およびリンク先を定義
属性 start(最初のページ), url(ページのURL), omit(ページ数省略「…」),
scope_end, scope_start, current(現在のページ数), end(最後のページ)
親タグ pager
子タグ なし
テキスト出力 あり(ページ数, 「…」)
図式 page
タグ cardList
説明 一覧表からリンクしている単票を定義
属性 なし
親タグ table
子タグ card
テキスト出力 なし
図式 cardList
タグ card
説明 単票名、単票ごとに割り当てられるid、単票ページのURLを定義
属性 name(単票名), recordId(単票に割り当てられたid), title(単票タイトル)
親タグ cardList
子タグ なし
テキスト出力 あり(単票ページのURL)
図式 card
タグ fieldList
説明 ソート行のURLを定義または編集モードでの使用フィールドの定義
属性 idSort(初期のソート順)
親タグ table
子タグ field
テキスト出力 なし
図式 fieldList
タグ field
説明 ソート行に表示するフィールドを定義
属性 code(フィールドコード), id(フィールドID), sort(ソート行のURL),title(XSLのセレクタ)
親タグ fieldList
子タグ label
テキスト出力 なし
図式 field
タグ label
説明 選択形式のフィールドの場合、ラベルID、ラベル名称を定義
属性 value(ラベルID)
親タグ field
子タグ なし
テキスト出力 あり(ラベル名称)
図式 label
タグ data
説明 DB内登録データの表示方法を定義しています。
属性 count(ページ内表示件数), limit(選択されている表示件数),sort(初期ソート), total(全レコード件数)
親タグ table
子タグ record
テキスト出力 なし
図式 data
タグ record
説明 DB内の1レコードを定義
属性 id(行番号。1=1行目、2=2行目)
親タグ data
子タグ usr_フィールドの差し替えキーワード
テキスト出力 なし
図式 record
タグ usr_フィールドの差し替えキーワード
説明 DB内登録データの出力を定義
(注1)日付フィールド、マルチセレクトフィールド、
画像型フィールドおよびファイルフィールドは、
定義されている子タグおよび属性が異なります。
属性 なし
親タグ record
子タグ なし
テキスト出力 あり(DB内登録データ)
図式 usr_フィールドの差し替えキーワード