XForms 设计器使用手册

1. 概述

Designer 是一款所见即所得设计工具，使用该工具您可以从选项选用板中拖放控件来构建展示页面。

GForms设计器支持中文及英文两种语言，具体所使用的语言由用户的电脑配置环境决定。

2. GForms透视图

为了更好的使用GForms设计器，请在打开Eclipse开发平台后，在右上角切换到GForms透视图：

请在透视图列表中选择“GForms”，将工做台切换到以下布局：

3. 建立

3.1. 建立GForms工程

在GForms视图下，能够直接经过菜单：FileànewàGForms工程，打开建立GForms工程向导：

或直接经过菜单：FileànewàProject，在弹出的建立工程向导中，选择“GForms”分类下的“GForms工程”:

在建立GForms工程的页面，录入工程名称便可，示例以下图：

使用建议：

在建立GForms工程时，为了节省时间，请按以下建议对Eclipse进行设置：

l 为了减小Eclipse检查验证javascript、css、图片等文件的过程，在Eclipse的菜单中：WindowsàPreference，在弹出的首选项配置中，找到validation配置页，勾选上阻止全部项的验证，以下图所示：

l 取消工程的自动编译功能，由于该功能将致使大量的编译，下降开发效率。

3.2. 建立GForms表单

在GForms视图下，能够直接经过菜单：FileànewàGForms文件，打开建立GForms文件向导：

或者，直接在须要建立GForms页的文件夹右键菜单选择New-àFile：

4. GForms设计器

为了更好的使用GForms设计器，请在打开Eclipse开发平台后，在右上角切换到GForms透视图：

4.1. 控件面板

GForms平台所支持的全部的控件，包括17个核心控件（或基础控件）、8个容器控件、9个扩展控件及6个图形控件，同时还包括上下文菜单等控件类型。

能够选择任意一个控件图片，而后拖拽到右边的设计器区域，便可在设计器中添加控件。

使用提示：若是控件面板已经关闭，有两种方式打开控件面板：

方法一：则能够经过在Eclipse的菜单栏选择：WindowsàShow View，而后在弹出的视图对话框中选择Palette便可再次打开控件面板；

方法二：在设计器的右键菜单中选择“打开控件面板视图”。

4.2. 设计器区域

设计器包括5个标签页：

Ø 设计：UI设计界面。

Ø 辅助：上下文菜单及上传下载控件专用。

Ø 脚本：

编写JavaScript脚本，支持着色、提示等功能：

Ø XML：

XML编辑器，用于编辑当前GForms的配置信息或XML数据片断。

注意：

l 每一个XML片断，必须提供一个当前页惟一的ID用于标识该XML片断，而且在javaScript视图中，能够经过XML的ID去访问或操做XML数据片断。

l 每一个XML片断的只能有且仅有一个根元素，而且须要存放到<xml id=”xxx”></xml>以内。

l 每次编辑xml片断时须要确保是合法的XML，不然gforms编辑器拒绝保存。

&Oslash; 预览：

提供快速预览当前设计结果，默认使用的浏览器为Eclipse内置的IE浏览器，若是目标运行浏览器为其余浏览器，请在Eclipse之中进行浏览器设置。

设置浏览器方式为在菜单Windows&agrave;首选项：

请在进行浏览以前，把当前GForms应用部署到服务器上，如Tomcat或IBM Webshpere Application Server、weblogic等服务器之中，并在当前GForms应用的首选项中同步配置（应用发布及同步配置，请参考应用首选项配置使用手册）。

使用提示：

l GForms应用发布功能支持应用部署到本地服务器或远处服务器上。

l 预览时会直接把当前GForms表单发布到服务器。

l 除了在预览出检查开发结果，也能够在外部浏览器，如Firefox、Chrome、IE中查看开发结果（在预览页面右键选择属性便可查看访问URL路径）。

4.3. 设计器上下文菜单

设计器的包含丰富的右键菜单，方便开发人员快捷开发，用户选择不一样的控件会有不一样的右键菜单，其中在设计器的空白位置右键菜单以下图所示：

除常规的编辑操做：剪切、拷贝、粘贴、重复、删除、重作、取消外，还有一些功能菜单项：

菜单项	功能说明	备注
分栏	将把当前右键菜单的控件横行或纵向分裂为两个
添加状态栏	每一个GForms页面只能有一个状态栏	运行时能够经过API动态设置状态栏的内容
工具栏	每一个GForms页面只能有一个工具栏	能够经过工具栏的子菜单项：添加项：在工具栏增长一个菜单项； 添加分割线：在工具栏添加一个竖线； 删除工具栏：删除所添加的工具栏
查看属性	查看所选择空间的属性，若是属性面板关闭则能够经过该功能打开属性配置视图
打开控件面板	打开或显示设计器的控件面板

4.4. 控件类型转换

为方便开发，GForms设计器提供了控件类型转换功能，能够方便的把某个控件转换为所须要的其余控件。

当选择某个具体的控件时，如Input输入框，其上下文菜单以下图所示：

“转换到”子菜单容许把当前所选择的控件转换为其余类型。

当选择是容器控件：group、groupbox、fieldset、重复容器、表格时：

若是转换为表格，则转换后的控件以下：

4.5. 工具栏

在设计器中，选择几个控件，而后能够经过工具栏提供的功能快速实现对其、大小配置、删除、复制、取消/重作功能。

5. 视图

视图是开发GForms表单的重要组成部分，GForms的相关视图包括：控件属性视图、模型视图、模型实例视图、Web Service视图及模型/实例属性视图。

5.1. 视图选择

GForms视图打开方式：在Windows&agrave;Show views，将弹出以下对话框，在对话框中选择“GForms设计器”下的某个视图便可：

5.2. 控件属性视图

显示或配置在设计器“设计”及“辅助”两个选项卡中建立的控件。

5.3. 模型视图

模型是GForms的核心要素，是整个GForms页面的重要控制配置，如能够配置模型实例、绑定、提交(submission)、操做等，详细功能使用说明请查看“模型”章节。

5.4. 模型实例视图

模型实例视图提供全部模型实例树展示，是GForms的数据源或提交的数据载体，GForms模型实例本质上是XML数据片断，能够在模型实例树中建立元素、属性、子元素等。

5.5. Web Service视图

若是在GForms页面建立了web服务（使用WSDL或web服务URL），则可使用Web Service视图对web服务进行管理。

5.6. 模型/实例属性视图

对模型视图、模型实例视图中的项属性配置，须要在模型/实例属性视图中进行配置：

6. 模型管理

在模型视图中进行模型管理。

6.1. 模型配置

属性名称	描述
Schema	一个模型能够有多个schema文件，开发人员能够经过schema文件选择器选择多个文件，若是手动录入，则多个schema文件以空格分隔；文件的位置为相对于WebContent目录的绝对路径。
schema文本	模型的schema文本，必须是完整的schema文件内容
标识	模型的ID，是运行时访问模型的重要配置
名称空间	模型全部的名称空间列表，从schema文件或schema文本中抽取

注意：所配置的schema文件须要同步到gforms服务器上，而且须要在运行时配置文件config.properties中配置appURL，不然会报以下错误：

详细参考《GForms FAQ》文档。

6.2. 建立模型

在模型树的根节点或模型视图的工具栏中均可以进行模型的建立：

l 模型树根节点：

l 模型视图工具栏：

模型的建立包含三种方式：

&Oslash; 建立空模型：将建立一个只包含ID的空模型，模型下不包含任何模型实例、绑定、动做等信息。

&Oslash; 从XML建立模型：将建立一个包含ID的模型，模型下面建立一个从XML数据所构建的模型实例。

&Oslash; 从schema建立模型：建立一个模型，而且在模型下建立一个根据所选择的schema构建的模型实例及schema中的数据类型绑定。

6.2.1. 从XML创模型

在弹出的对话框中粘贴须要建立模型的XML数据片断，XML数据片断能够有根元素，也能够没有。

点击“OK”后，所建立的模型位于模型树中，并在模型下方有模型实例：

并能够在模型实例视图中看到instance2模型实例。

6.2.2. 从schema创模型

GForms设计器支持从schema建立模型：

&Oslash; 第一步：输入schema文本

schema文件文本以下：

<xs:schema xmlns:my="http://commerce.example.com/payment" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsd="http://www.w3.org/2001/XMLSchema" targetNamespace="http://commerce.example.com/payment" elementFormDefault="qualified"> <xs:element name="payment"> <xs:complexType> <xs:sequence minOccurs="0" maxOccurs="unbounded"> <xs:choice> <xs:element ref="my:cc" /> <xs:element ref="my:exp" /> <xs:element ref="my:expenses" /> </xs:choice> </xs:sequence> <xs:attribute name="as" type="my:paymentAs" /> </xs:complexType> </xs:element> <xs:element name="cc" type="my:cc" /> <xs:element name="exp" type="xsd:gYearMonth" /> <xs:element name="expenses" type="my:expenses" /> <xs:simpleType name="cc"> <xs:restriction base="xsd:string"> <xs:minLength value="12" /> <xs:maxLength value="19" /> <xs:pattern value="[0-9]+" /> </xs:restriction> </xs:simpleType> <xs:simpleType name="paymentAs"> <xs:restriction base="xsd:string"> <xs:enumeration value="cash" /> <xs:enumeration value="credit" /> </xs:restriction> </xs:simpleType> <xsd:simpleType name="expenses"> <xsd:restriction base="xsd:decimal"> <xsd:fractionDigits value="2"/> </xsd:restriction> </xsd:simpleType> </xs:schema>

第二步：选择建立模型的元素

点击“Finish”后，所建立的模型位于模型树中，并在模型下方有模型实例：

能够看到在模型下方有一个模型实例及若干个绑定，绑定的定义从schema文件中抽取元素数据类型做为绑定的数据类型。

并能够在模型实例视图中看到instance2模型实例。

同时，所引入的schema内容将做为所建立的模型的schema文本内容，请选择“model3”，而后在属性视图中能够看到：

注意：模型所引入的schema内容能够做为运行时数据校验的依据，上述schema所建立的模型实例中，若是拖拽as属性到设计器，则默认会构建一个下拉框控件，控件的两个选项为cash、credit；同时在运行时绑定到数据节点instance('instance2')/pay:payment/pay:cc的控件，将校验其长度为12。

6.3. 建立模型实例

在模型树的模型节点右键菜单中能够看到建立模型实例的功能菜单项：

模型的建立包含三种方式：

&Oslash; 建立空模型实例：将建立一个只包含ID的空模型实例，模型实例不包含任何XML数据节点。

&Oslash; 从XML建立模型实例：将建立一个包含ID的模型实例，模型实例下面建立一个从XML数据所构建的XML数据结构。

&Oslash; 从schema建立模型实例：建立一个模型实例，而且在模型实例下建立一个根据所选择的schema构建的XML数据节点结构。

6.3.1. 从XML建立模型实例

在弹出的对话框中粘贴须要建立模型实例的XML数据片断，XML数据片断能够有根元素，也能够没有。

点击“OK”后，所建立的模型实例位于刚刚所选的模型下：

并能够在模型实例视图中看到instance5模型实例。

6.3.2. 从schema建立模型实例

GForms设计器支持从schema建立模型实例：

&Oslash; 第一步：输入schema文本

schema文件文本参考“从schema建立模型”章节。

第二步：选择建立模型的元素

点击“Finish”后，所建立的模型位于模型树中，并在模型下方有模型实例：

并能够在模型实例视图中看到instance6模型实例。

注意：所引入的schema内容不会做为运行时数据校验的依据，而是仅仅从schema中选择某个的元素来构建一个模型实例，简化模型实例建立，并不会从schema文件中读取任何其余约束信息，如元素数据类型等。

6.3.3. 配置模型实例

选择模型树中的某个模型实例节点，在“属性视图”中能够查看或配置模型是的相关配置项，其中src配置项表示模型实例的数据来自于某个文件。

6.4. 建立绑定

能够在模型树中建立绑定，绑定是对某个数据节点的各类约束定义，包括对数据节点定义其的数据类型、只读条件、依赖条件、计算公式、约束配置等。

在模型树的模型节点右键菜单中能够看到建立绑定的功能菜单项：

新建绑定后，在模型下方出现新建的绑定，此时在“属性视图”中能够对该绑定进行属性配置，以下图所示：

对于一个绑定，首先要定义其节点，节点能够经过XPath编辑器编辑节点选择的xpath表达式。

属性名称	描述
节点	绑定所定义的数据节点，xpath表达式
必填项约束	xpath表达式，计算结果为布尔值，定义数据节点的required条件，运行时若是知足该条件则引用该绑定的数据节点的控件将展示为必填项
标识	绑定的ID
计算	xpath表达式，计算结果为字符串，定义数据节点的计算公式，表示节点不是由用户输入的，而是根据公式动态计算
类型	节点的数据类型，数据类型包括xpath所定义的数据类型，并包括当前数据模型的schema中的数据结构
相关性约束	xpath表达式，计算结果为布尔值，定义数据节点与其余节点的依赖关系
约束	xpath表达式，计算结果为布尔值，定义数据节点约束条件，运行时若是知足该条件则引用该绑定的数据节点的控件将展示为错误状态
约束消息	只有定义了约束该配置才生效，这样在运行时若是违反该绑定的约束，则会使用该约束消息提示用户，约束消息的构建请参考格式化校验手册。 注意：消息列表来自于全局约束消息集合。
只读	xpath表达式，计算结果为布尔值，定义数据节点只读条件，运行时若是知足该条件则引用该绑定的数据节点的控件将展示为只读状态
浏览	xpath表达式，计算结果为布尔值，定义数据节点浏览态条件，运行时若是知足该条件则引用该绑定的数据节点的控件将展示为浏览状态

配置提示：

l xpath表达式：既能够手动录入xpath表达式，也能够经过xpath编辑器辅助建立xpath表达式。

l 子绑定：绑定下方还能够包含绑定，用于定义父绑定的数据节点的不一样配置项。一般不会使用到子绑定。

6.5. 建立提交submission

提交submission是GForms前端与后端服务交互的桥梁，submission的建立方式为：在模型视图中---》选择模型树---》选择某个须要建立提交的模型—》右键菜单—》“提交”：

新建“提交”后，在模型下方出现新建的提交，此时在“属性视图”中能够对该提交进行属性配置，以下图所示：

对于一个提交，必须定义资源路径，资源路径能够经过xpath定义，也能够指定一个静态的资源路径URL。

属性名称	描述
数据引用(Ref)	绑定所定义提交所提交的数据节点，xpath表达式，可为空
编码	提交时系列化的数据编码，默认为UTF-8
标识	提交的ID，是send动做引用该标识进行动做提交
方法	配置提交的mehtod，可选的有：post、get、put、delete，默认为post
分隔符	默认为&，当“方法”method为get、delete时，提交的资源路径将根据数据将进行编码构建。 如提交的数据为：<input3>test</input3>，资源URL为：http://localhost:8080/test/weather，则实际提交的资源URL为： http://localhost:8080/test/weather?input3=test
介质类型	提交到后台的请求头Accept（方法为get、delete时）或Content-Type（方法为Post、put时）内容，可选的有：application/xml、text/xml、application/json、text/json、application/x-www-form-urlencoded、application/soap+xml，默认为application/xml
模式(mode)	提交方式，可选的同步、异步，默认为异步
目标绑定	xpath表达式，当提交数据返回时，须要替换的目标模型实例节点，当“替换”为“实例”、“文本”时该配置有效，不然无效。
实例	提交数据返回时，须要替换的目标模型实例（当“替换”配置为模型实例时有效）。注意：该配置不会对提交的数据产生任何约束，若是要提交模型下非默认模型实例到后端，则请配置ref为那个非默认模型实例的xpath便可
替换	当提交数据返回时，处理方式：所有、实例、文本、空，默认为所有，其中： 所有：表示响应数据将替换当前页； 实例：表示将使用响应信息替换某个模型实例； 文本：表示将把响应信息做为文本添加到某个模型实例节点； 无：表示不做任何处理。
相关性约束	是否须要提交relevant属性为false的数据节点，默认为false，表示提交全部节点（relevant是经过配置节点的绑定relevant相关属性）
校验	是否对提交到数据进行校验，若是校验失败则提交失败并抛出xforms-submit-error事件
系列化	XML模型实例系列化类型，，可选的有：application/xml、application/x-www-form-urlencoded、multipart/related 、multipart/form-data 、none，默认为application/xml
资源XPath	提交的后端服务URL路径，经过XPath动态从模型实例中获取
资源值	提交的后端服务URL路径，若是配置了“资源XPath”则运行时忽略该配置
soap action	资源URL为web服务时有用

配置提示：

l 相关性约束：若是配置为true则表示当系列化须要提交的模型实例或模型实例节点时，将把那些配置了绑定属性relevant的数据节点，若是计算relevant为false，则该节点将不被系列化。

l 介质类型：若是后端服务依赖于所传递前端所发送的Accept，如spring Restfull，此时当方法为post时，须要格外注意，须要配置replace为instance并配置媒体类型为合适的类型才能实现该目的。

6.5.1. submission动做

提交能够包含若干个动做，这些动做的事件只能为：

xforms-submit、xforms-submit-error、xforms-submit-done，事件具体描述请参考“GForms标准事件”。

6.6. 建立动做

操做是GForms平台提供的标准操做，操做建立方式为：在模型视图中---》选择模型树---》选择某个须要建立动做的模型—》右键菜单—》“动做”：

6.6.1. 标准动做列表

GForms平台提供的标准动做以下表：

动做	动做描述
reset	把所选择的模型下的全部模型实例的内容进行重置
rebuild	对目标模型的全部模型实例数据结构进行重建：绑定、模型实例等，该操做将把经过XMLUtil工具所设置的节点值绑定到UI
recalculate	从新对目标模型全部的绑定计算器calculate配置属性
revalidate	该操做将对目标模型中的全部的模型实例进行验证处理（包括readonly、是否必须、是否浏览态、合法性校验等）
message	该操做将弹出一个提示信息对话框
setValue	为所选择的模型实例目标节点设置节点内容，该操做执行后，目标数据节点的值将被更新，同时引用目标数据节点的全部控件UI将自动被更新
setFocus	该操做将触发焦点聚焦在目标控件上。
toggle	使用toggle将选择某个case page，也就说toggle操做的目标对象为某个case page。
action	action操做能够组合多个其余操做，从而当action的事件知足时，触发action下的每一个操做进行执行
send	发送操做将触发某个submission执行。
unload	从目标控件卸载资源，其实就是把目标控件的html元素清空，而且若是目标控件是load动做的容器，则会把subform也销毁
load	加载资源到当前页面，该资源能够是任何的资源，如html或另一个GForms页面等。
setindex	该操做执行的目标对象为Repeater或Table控件，将选中目标控件的某行，行号从1开始。
delete	删除操做将从数据集合中删除指定位置的记录。
insert	该操做把某些现有节点或目标nodeset的最后一个节点添加到目标nodeset的父节点中
dispatch	用于向目标分发某个具体的事件
script	调用执行javascript，包括javascript原始代码，如alert等，同时也支持调用javascript函数。

建立操做后，能够在“属性视图”中配置各个操做的具体配置信息：

具体每一个动做的配置请参考“GForms操做”部分具体解释。

配置提示：

l 在模型实例树中配置的动做将做为全局动做，而在控件中所配置的动做则仅仅是针对某个控件的。

l action动做：是一系列动做的集合，全部子动做的事件均与action动做同样。

6.6.2. 调整动做顺序

在运行时，动做的执行是按顺序进行的，排在前面的将先执行，靠后的后执行，在不少时候，特别是form载入时，须要请求后台数据，而在请求执行可能须要设置一些请求参数，设置数据节点的值有两种方式：

1）为页面配置xforms-init事件，并在事件中经过XML工具设置模型实例相关节点的值。

2）经过标准动做setValue设置数据节点的值，咱们推荐使用该方式，可是须要注意setValue动做的位置，应该放在send动做以前：

能够经过动做右键菜单的“上移动做”、“下移动做”实现。

6.7. 删除组件

在模型实例树中能够删除任何提交、绑定、动做、模型实例及模型：

选择要删除的组件，而后右键菜单中点击“删除”便可删除组件。

7. 模型实例

在模型实例视图中进行模型管理。

模型实例的建立在“模型视图”的模型树中进行，具体参考“模型管理”中的“建立模型实例”。

能够在模型实例中手动建立实例数据节点、元素、节点文本等信息。

若是配置模型实例的介质类型为json，则模型实例视图以下（增长了对json的操做）：

7.1. 模型实例配置

属性名称	描述
src	定义模型实例使用一个后台静态的XML文件数据做为模型实例的数据源
标识	模型实例ID，是运行时引用模型实例的惟一标识
介质类型	模型实例的数据源类型，目前支持xml、json两种类型

若是为模型实例配置了xml或json文件数据源，可是该文件不存在或没有同步到gforms应用，则会报以下错误：

配置提示：

1）若是为模型实例配置了src属性，而且同时配置了数据节点，则src优先于数据节点，即所配置的数据节点在运行时失效。

2）src的文件路径必须相对于webContent目录的绝对路径，而且文件必须存在根目录元素且该根目录至关于模型实例的data根节点。

<transaction> <date>2004-05-06</date> <desc>Salery</desc> <withdraw>false</withdraw> <amount>5000.00</amount> </transaction>

引用date的ref xpath表达式为：instance(‘test’)/date。

若是配置模型实例的类型为json，除了数据格式与XML不同，在设计器使用及运行时均与XML一致，如则设计器会把json字符串使用XML树的方式展示出来，运行时也能够经过xpath访问json节点。

可是，json类型的模型实例，不能够为元素节点建立属性、不可配置名称空间，同时模型实例的虚拟根节点data名称修改后再次打开将仍然为data。

若是为json类型的模型实例配置数据源文件，则数据源文件必须为json格式，且第一层必须是对象，样式以下：

{ "options":[ { "label":"PixUnit", "value":"px" }, { "label":"percentUnit", "value":"percent" } ] }

运行时的xml树状结构为（根节点data为辅助节点）：

7.2. 配置节点

选择模型实例树中的任何一个树节点，就能够在“属性视图”中看到其配置，并能够修改其配置信息。

7.3. 查看XML

能够在模型实例树的实例节点、元素节点的右键菜单使用该功能，该功能将把所选的模型实例、元素的数据结构转换为XML字符串。

7.4. 粘贴XML做为元素

能够在模型实例树任意元素节点的右键菜单使用该功能，该功能将把所粘贴的XML数据片断建立到元素节点下方。

粘贴后的模型实例结构：

配置提示：所粘贴的XML能够不存在根元素。

7.5. 查看Json

该功能只有当配置模型实例的介质类型为json时可用。

能够在模型实例树的实例节点、元素节点的右键菜单使用该功能，该功能将把所选的模型实例、元素的数据结构转换为JSON字符串。

7.6. 粘贴json做为元素

该功能只有当配置模型实例的介质类型为json时可用。

能够在模型实例树任意元素节点的右键菜单使用该功能，该功能将把所粘贴的JSON数据片断建立到元素节点下方。

粘贴后的模型实例结构：

配置提示：粘贴json为模型实例数据后，模型实例树将以xml方式查看json，如上图所示。

7.7. 新增元素

在任意一个没有元素文本的元素的右键菜单中使用该功能为元素添加子元素。

7.8. 新增属性

能够为任意一个元素增长属性。

7.9. 删除

能够删除除模型实例节点、模型实例根节点外的任意一个元素、属性或文本节点。

7.10. 建立UI

能够拓展任意模型实例数据节点到设计器，从而构建UI界面：

如把上图的“transaction”节点拖拽到设计器后，所构建的UI以下图所示：

各个控件的节点引用配置以下：

控件	节点引用ref
groupbox	instance('instance1')/transaction
date	date
desc	desc
withdraw	withdraw
amount	amount

能够看出，除外层的groupbox容器使用绝对路径引用模型实例节点外，其余几个控件均使用相对路径。

8. Web Service

GForms对web服务提供了支持，能够很是快捷的把一个web服务导入到GForms。

8.1. 新建web服务

在“控件面板”的最下方找到“web服务”，拖拽该图标到右边的设计器，将启动新建web服务向导过程：

第一步：指定web服务路径

支持使用本地wsdl文件或远处服务器的WSDL文件。

第二步：选择web服务服务、端口、操做

一次只能添加一个web服务操做到GForms，若是要添加多个操做须要执行屡次新建web服务向导。

第三步：配置是否建立web service UI、是否载入时调用web服务

若是须要自动构建web service的UI界面请勾选上“自动构建表单UI元素”；若是须要在form载入时就调用web服务，则请勾选“载入时调用web服务”。

当点击“Finish”按钮后，向导过程结束，将自动打开“web服务”视图：

在视图中能够看到刚才所构建的web服务操做信息，web服务视图详见下一节。

同时，在模型视图中也能够看到所建立的web服务相关的模型、模型实例及提交：

注意：开发人员不可在模型树中删除web service相关的组件，如模型、模型实例、提交组件，可是能够在新添加组件，如添加动做、绑定、提交等新组件。

8.2. web服务视图

在web服务视图中专门对GForms中的web服务进行管理。

8.2.1. web服务树结构

第一层元素：web服务名称。

第二层元素：web服务的操做。

第三层元素：web服务的请求、响应实例及提交

第四层元素及如下元素：请求或响应的模型实例结果。

8.2.2. 删除web服务及操做

在web服务节点机web服务操做节点右键菜单能够执行删除web服务及web服务操做。

8.2.3. 查看XML

在web服务的模型实例元素节点能够查看XML结构。

8.3. 建立UI

能够从web服务树中除第一层web服务树节点不能拖拽到设计器构建UI外，其余层的节点都可以：

8.3.1. 拖拽web服务操做

构建的UI如上图所示，将包含请求模型实例、提交及响应模型实例。

在运行时当用户点击提交按钮时，将调用远程web服务，并获得响应消息填充到响应UI中。

8.3.2. 拖拽web服务请求、响应

构建的UI如上图所示。

8.3.3. 拖拽实例数据节点

同模型实例树中拖拽数据节点同样，请参考“模型实例”—》“建立UI”章节。

8.3.4. 拖拽提交

提交动做，将构建一个提交按钮，按钮配置：

能够看到按钮的类型为submit，而且配置了提交为web服务的操做。

9. XPath编辑器

GForms平台提供XPath编辑器，辅助开发人员开发xpath表达式。

分为三个区域：选择区域、编辑器区域及问题显示区域。

其中，选择区域：

• 模型实例树：包含全部的模型实例数据节点，包括属性及元素，若是须要选择某个节点请双击或拖拽到编辑器区域便可。

• 函数树：包含全部的xforms1.0及xforms1.1所支持的全部xpath，每一个函数具体使用说明请参考相关xpath手册。

• 操做符树：xpath所支持的操做。

配置提示：

l 若是须要选择模型实例自身，则请在模型实例树上选择模型实例树节点或模型实例根节点便可实现。

l GForms运行时对数学xpath提供支持，可是因为使用场景较少故没有在GForms的xpath编辑器中提供出来。GForms运行时支持的数学xpath函数列表：

abs、acos、asin、atan、atan二、constant、cos、exp、log、power、sin、sqrt、tan。

这些函数能够在设计器中手动编写。

 

 

产品联系方式

 

www.ghpaas.com

 

电话: 13601178468

 

Email: ghpaas@163.com

 

产品资料：百度网盘http://yun.baidu.com/s/1bnznec3#dir/path=%2Fghorse