付録B. WAM XML構造
実行時のWebroutine呼び出しにより生成されるXMLドキュメントには、標準の形式があります。Webroutineからのすべてのフィールドやリストなどの出力は、このXMLドキュメントに定義されます。このXMLドキュメントはWebroutine XSLスタイルシートを使った変換処理の入力として使用され、最終的なプレゼンテーション出力が生成されます。異なる特定のプレゼンテーション形式に正しく変換するためには、このXMLドキュメントが広く知られた標準の形式になっている必要があります。
このXMLドキュメントは、以下のセクションに分かれています。
コンテキスト・セクション
このXMLドキュメントのコンテキスト・セクションには、Webroutineに関するコンテキスト情報が含まれています。WAMの名前、Webroutineの名前、Webroutineのタイトルなどの項目がこのセクションに含まれます。
オプション・セクション
オプション・セクションには、Webroutineの各種のオプションが含まれています。これらのオプションは変更可能で、特定の検証機能や表示機能を有効にするか無効にするかを設定できます。
メッセージ・セクション
メッセージ・セクションには、実行時にRDMLのMESSAGEコマンドを使用して出力するメッセージが含まれています。
フィールド・セクション
フィールド・セクションには、WebroutineのWEB_MAPステートメントで送信フィールドとして指定されているフィールドが含まれています。実行時に、送信用のフィールドの値がこのセクションに追加され、プレゼンテーション出力に変換されます。さらに、これらのフィールドのキャプション、説明や見出しも、実行時と設計時にこのセクションに追加されます。
リスト・セクション
リスト・セクションには、WebroutineのWEB_MAPステートメントで送信用のリストとして指定されているリストが含まれています。各リストの各フィールド列の見出しと各リスト行のフィールド値が、実行時にこのセクションに追加されます。見出しは、実行時の実際の行の値は含まれないものの、設計時にもこのセクションに含まれます。生成されたリストは、インラインされる場合は、属性がinline="true"となります。JSONリストはCDATAセクションとして送信されます。JSONリストは通常JavaScriptにより実行されます。
XMLドキュメントの例
XMLドキュメントの例を以下に示します。
<?xml version="1.0" encoding="UTF-8"?>
<!-- Web application :PSLSYSWAM Test -->
<!-- Webroutine :EmployeeEntry Add an Employee -->
<!-- Created by user :PCXUSER -->
<!-- Timestamp :2011-08-26T16:45:00 -->
<lxml:data xmlns:lxml="http://www.lansa.com/2002/XML/Runtime-Data">
<lxml:context>
<lxml:user-id>PCXUSER</lxml:user-id>
<lxml:webapplication>PSLSYSWAM</lxml:webapplication>
<lxml:webapplication-title>Test</lxml:webapplication-title>
<lxml:webroutine>EmployeeEntry</lxml:webroutine>
<lxml:webroutine-title>Add an Employee</lxml:webroutine-title>
<lxml:service-name>PSLSYSWAM_EmployeeEntry</lxml:service-name>
<lxml:partition>DEM</lxml:partition>
<lxml:language iso-lang="en">ENG</lxml:language>
<lxml:images-path>/IMAGES</lxml:images-path>
<lxml:action-request>/CGI-BIN/lansaweb</lxml:action-request>
</lxml:context>
<lxml:options>
<lxml:option name="DBCS">false</lxml:option>
<lxml:option name="align-right">true</lxml:option>
<lxml:option name="check-numeric">true</lxml:option>
<lxml:option name="debug" />
<lxml:option name="trace" />
<lxml:option name="task" />
</lxml:options>
<lxml:external-resources>
<lxml:script name="XWJQC" charset="iso-8859-1" location="header">jquery/js/jquery 1.5.1.min.js</lxml:script>
<lxml:script name="XWJQUI" charset="iso-8859-1" location="header">jquery/js/jquery-ui-1.8.10.all.min.js</lxml:script>
<lxml:script name="XWJ001" charset="iso-8859-1" location="header">script/std_jqueryui.js</lxml:script>
<lxml:style name="XWC001" charset="iso-8859-1">style/jquery/std_jqueryui.css</lxml:style>
<lxml:style name="XWT01J" charset="iso-8859-1">jquery/css/redmond/jquery-ui-1.8.10.all.css</lxml:style>
<lxml:style name="XWT01L101" charset="iso-8859-1">style/jquery/redmond/std_themelet1_style1.min.css</lxml:style>
</lxml:external-resources>
<lxml:messages />
<lxml:fields>
<lxml:field name="SURNAME">
<lxml:caption>
<lxml:label>Surname........</lxml:label>
<lxml:description>Employee Surname</lxml:description>
<lxml:heading-1>Surname</lxml:heading-1>
<lxml:heading-2 />
<lxml:heading-3 />
</lxml:caption>
<lxml:value />
</lxml:field>
<lxml:field name="GIVENAME">
<lxml:caption>
<lxml:label>Given names....</lxml:label>
<lxml:description>Employee Given Name(s)</lxml:description>
<lxml:heading-1>Given name(s)</lxml:heading-1>
<lxml:heading-2 />
<lxml:heading-3 />
</lxml:caption>
<lxml:value />
</lxml:field>
<lxml:field name="EMPNO">
<lxml:caption>
<lxml:label>Employee no....</lxml:label>
<lxml:description>Employee Number</lxml:description>
<lxml:heading-1> Employ</lxml:heading-1>
<lxml:heading-2> Number</lxml:heading-2>
<lxml:heading-3 />
</lxml:caption>
<lxml:value />
</lxml:field>
<lxml:field name="ADDRESS1">
<lxml:caption>
<lxml:label>Address 1......</lxml:label>
<lxml:description>Street No and Name</lxml:description>
<lxml:heading-1>Address line 1</lxml:heading-1>
<lxml:heading-2 />
<lxml:heading-3 />
</lxml:caption>
<lxml:value />
</lxml:field>
<lxml:field name="ADDRESS2">
<lxml:caption>
<lxml:label>Address 2......</lxml:label>
<lxml:description>Suburb or Town</lxml:description>
<lxml:heading-1>Address line 2</lxml:heading-1>
<lxml:heading-2 />
<lxml:heading-3 />
</lxml:caption>
<lxml:value />
</lxml:field>
<lxml:field name="ADDRESS3">
<lxml:caption>
<lxml:label>Country</lxml:label>
<lxml:description>State and Country</lxml:description>
<lxml:heading-1>Country</lxml:heading-1>
<lxml:heading-2 />
<lxml:heading-3 />
</lxml:caption>
<lxml:value />
</lxml:field>
<lxml:field name="POSTCODE">
<lxml:caption>
<lxml:label>Post/zip code..</lxml:label>
<lxml:description>Post / Zip Code</lxml:description>
<lxml:heading-1>Post/zip</lxml:heading-1>
<lxml:heading-2>Code</lxml:heading-2>
<lxml:heading-3 />
</lxml:caption>
<lxml:value />
</lxml:field>
<lxml:field name="PHONEHME">
<lxml:caption>
<lxml:label>Home phone.....</lxml:label>
<lxml:description>Home Phone Number</lxml:description>
<lxml:heading-1>Home phone</lxml:heading-1>
<lxml:heading-2>Number</lxml:heading-2>
<lxml:heading-3 />
</lxml:caption>
<lxml:value />
</lxml:field>
<lxml:field name="PHONEBUS">
<lxml:caption>
<lxml:label>Business ph....</lxml:label>
<lxml:description>Business Phone Number</lxml:description>
<lxml:heading-1>Business Phone</lxml:heading-1>
<lxml:heading-2>Number</lxml:heading-2>
<lxml:heading-3 />
</lxml:caption>
<lxml:value />
</lxml:field>
<lxml:field name="STARTDTER">
<lxml:caption>
<lxml:label>Start date.....</lxml:label>
<lxml:description>Start date (YYMMDD)</lxml:description>
<lxml:heading-1>Start</lxml:heading-1>
<lxml:heading-2>Date</lxml:heading-2>
<lxml:heading-3 />
</lxml:caption>
<lxml:value />
</lxml:field>
<lxml:field name="TERMDATER">
<lxml:caption>
<lxml:label>Term. date.....</lxml:label>
<lxml:description>Termination Date (YYMMDD)</lxml:description>
<lxml:heading-1>Term.</lxml:heading-1>
<lxml:heading-2>Date</lxml:heading-2>
<lxml:heading-3 />
</lxml:caption>
<lxml:value />
</lxml:field>
<lxml:field name="DEPTMENT">
<lxml:caption>
<lxml:label>Department.....</lxml:label>
<lxml:description>Department Code</lxml:description>
<lxml:heading-1> Dept</lxml:heading-1>
<lxml:heading-2> Code</lxml:heading-2>
<lxml:heading-3 />
</lxml:caption>
<lxml:value />
</lxml:field>
<lxml:field name="SECTION">
<lxml:caption>
<lxml:label>Section........</lxml:label>
<lxml:description>Section Code</lxml:description>
<lxml:heading-1> Section</lxml:heading-1>
<lxml:heading-2> Code</lxml:heading-2>
<lxml:heading-3 />
</lxml:caption>
<lxml:value />
</lxml:field>
<lxml:field name="SALARY">
<lxml:caption>
<lxml:label>Salary.........</lxml:label>
<lxml:description>Employee Salary</lxml:description>
<lxml:heading-1>Salary</lxml:heading-1>
<lxml:heading-2 />
<lxml:heading-3 />
</lxml:caption>
<lxml:value />
</lxml:field>
<lxml:field name="MNTHSAL">
<lxml:caption>
<lxml:label>Monthly Salary</lxml:label>
<lxml:description>Monthly Salary</lxml:description>
<lxml:heading-1>Monthly</lxml:heading-1>
<lxml:heading-2>Salary</lxml:heading-2>
<lxml:heading-3 />
</lxml:caption>
<lxml:value />
</lxml:field>
<lxml:field name="STARTDTE">
<lxml:caption>
<lxml:label>Start date.....</lxml:label>
<lxml:description>Start Date (DDMMYY)</lxml:description>
<lxml:heading-1>Start</lxml:heading-1>
<lxml:heading-2>Date</lxml:heading-2>
<lxml:heading-3 />
</lxml:caption>
<lxml:value />
</lxml:field>
<lxml:field name="TERMDATE">
<lxml:caption>
<lxml:label>Term. date.....</lxml:label>
<lxml:description>Termination Date (DDMMYY)</lxml:description>
<lxml:heading-1>Term.</lxml:heading-1>
<lxml:heading-2>Date</lxml:heading-2>
<lxml:heading-3 />
</lxml:caption>
<lxml:value />
</lxml:field>
</lxml:fields>
<lxml:lists>
<lxml:list name="DEPTLIST" row-count="5">
<lxml:list-header>
<lxml:header name="DEPTMENT">
<lxml:heading-1> Dept</lxml:heading-1>
<lxml:heading-2> Code</lxml:heading-2>
<lxml:heading-3 />
</lxml:header>
<lxml:header name="DEPTDESC">
<lxml:heading-1>Department</lxml:heading-1>
<lxml:heading-2>Description</lxml:heading-2>
<lxml:heading-3 />
</lxml:header>
</lxml:list-header>
<lxml:list-entries>
<lxml:entry>
<lxml:column name="DEPTMENT" id="DEPTLIST.0001.DEPTMENT" />
<lxml:column name="DEPTDESC" id="DEPTLIST.0001.DEPTDESC">Value DEPTDESC 1</lxml:column>
</lxml:entry>
<lxml:entry>
<lxml:column name="DEPTMENT" id="DEPTLIST.0002.DEPTMENT" />
<lxml:column name="DEPTDESC" id="DEPTLIST.0002.DEPTDESC">Value DEPTDESC 2</lxml:column>
</lxml:entry>
<lxml:entry>
<lxml:column name="DEPTMENT" id="DEPTLIST.0003.DEPTMENT" />
<lxml:column name="DEPTDESC" id="DEPTLIST.0003.DEPTDESC">Value DEPTDESC 3</lxml:column>
</lxml:entry>
<lxml:entry>
<lxml:column name="DEPTMENT" id="DEPTLIST.0004.DEPTMENT" />
<lxml:column name="DEPTDESC" id="DEPTLIST.0004.DEPTDESC">Value DEPTDESC 4</lxml:column>
</lxml:entry>
<lxml:entry>
<lxml:column name="DEPTMENT" id="DEPTLIST.0005.DEPTMENT" />
<lxml:column name="DEPTDESC" id="DEPTLIST.0005.DEPTDESC">Value DEPTDESC 5</lxml:column>
</lxml:entry>
</lxml:list-entries>
</lxml:list>
<lxml:list name="SECTLIST" row-count="5">
<lxml:list-header>
<lxml:header name="SECTION">
<lxml:heading-1> Section</lxml:heading-1>
<lxml:heading-2> Code</lxml:heading-2>
<lxml:heading-3 />
</lxml:header>
<lxml:header name="SECDESC">
<lxml:heading-1>Section</lxml:heading-1>
<lxml:heading-2>Description</lxml:heading-2>
<lxml:heading-3 />
</lxml:header>
</lxml:list-header>
<lxml:list-entries>
<lxml:entry>
<lxml:column name="SECTION" id="SECTLIST.0001.SECTION" />
<lxml:column name="SECDESC" id="SECTLIST.0001.SECDESC">Value SECDESC 1</lxml:column>
</lxml:entry>
<lxml:entry>
<lxml:column name="SECTION" id="SECTLIST.0002.SECTION" />
<lxml:column name="SECDESC" id="SECTLIST.0002.SECDESC">Value SECDESC 2</lxml:column>
</lxml:entry>
<lxml:entry>
<lxml:column name="SECTION" id="SECTLIST.0003.SECTION" />
<lxml:column name="SECDESC" id="SECTLIST.0003.SECDESC">Value SECDESC 3</lxml:column>
</lxml:entry>
<lxml:entry>
<lxml:column name="SECTION" id="SECTLIST.0004.SECTION" />
<lxml:column name="SECDESC" id="SECTLIST.0004.SECDESC">Value SECDESC 4</lxml:column>
</lxml:entry>
<lxml:entry>
<lxml:column name="SECTION" id="SECTLIST.0005.SECTION" />
<lxml:column name="SECDESC" id="SECTLIST.0005.SECDESC">Value SECDESC 5</lxml:column>
</lxml:entry>
</lxml:list-entries>
</lxml:list>
<lxml:json-list name="LIST01"><![CDATA[{"list":{
"LIST01":{"header":[
{"name":"DEPTMENT","heading-2":"Dept","heading-3":"Code"},
{"name":"DEPTDESC","heading-2":"Department","heading-3":"Description"},
{"name":"PCK105","heading-1":"Packed","heading-2":"(10,","heading-3":"5)"},
{"name":"DAT01","heading-2":"Date","heading-3":"field"},
{"name":"BOOL1","heading-2":"Boolean","heading-3":"Field"},
{"name":"FLT01","heading-2":"Float","heading-3":"field"},
{"name":"FLT04","heading-2":"Float","heading-3":"4"},
{"name":"INT01","heading-1":"Integer","heading-2":"field","heading-3":"1"},
{"name":"INT02","heading-1":"Integer","heading-2":"field","heading-3":"2"}],
"entries":[
["ADM","Admin > Dept",23456.78900,"2011-08-29",true,+1.234567000000000E+004,+1.234567E+004,12345,12345],
["SD","Sales\" & Dist",65432.12340,"2011-08-29",false,+1.234567000000000E+004,+1.234567E+004,12345,12345]
]}}}
]]>
</lxml:json-list>
</lxml:lists>
</lxml:data>