赛捷软件论坛's Archiver

lynn.yu 发表于 2020-2-12 20:07

[V12功能解说] 5天学习Sage X3 Web Services 第3天

[b]* 本文由赛捷软件(上海)有限公司翻译完成,未经授权不得转载。如需转载,请先联系相应版块的版主取得授权。[/b]


[attach]5847[/attach]


[b]第3天 测试Web Services[/b]

这是整个5部分系列的第3部分,主要涉及如何为Sage X3创建和耗用web services。这一部分将侧重于测试web services。在第1部分中,我们探讨了[b]Sage X3 Web Services池[/b]的设置,而在第2部分中,我们探讨了如何根据[b]X3对象和子程序[/b]创建并发布[b]web services[/b]。

[b]Web Service测试器[/b]

Sage X3 Web Services可以在交互模式下进行测试,以便查看调用参数,执行测试调用以及查看结果。V12的web service测试器在X3菜单中。

1. 登录Sage X3 web客户端。

2. 导航至功能:管理→管理→Web服务→经典版SOAP Web services。

[attach]5848[/attach]

3. 以下是web services测试器的初始屏幕。点击突出标记的链接,显示STUB。

[attach]5849[/attach]

4. 在这个屏幕的右上角部分有一个名为“URL”的字段。这个URL会被用来耗用SOAP web services。在URL上右击,并选择复制,从而获取X3实例的完整URL链接。

[attach]5850[/attach]

5. 点击向下的箭头展开操作列表。

[attach]5851[/attach]

6. 以下就是操作列表。

[attach]5852[/attach]

7. 最常用的操作有:
o        子程序web services:
        Run——基于web service运行一个子程序
o        对象web services:
        Save——创建一条新的与X3对象关联的记录(即销售订单、客户等等)
        Delete——删除一条与X3对象关联的现有记录
        Query——查询一个对象左列表
        Modify——修改/更新一条与X3对象关联的现有记录(即销售订单、客户等等)
o        其他:
        getDescription——这对在开发过程中评估web service XML非常有用


[b]WEB SERVICE描述[/b]

1.        自web service操作,点击getDescription链接。
[attach]5853[/attach]

2.        这将打开获取web service描述的窗体。录入如下所示的字段。
o        【语言代码】——web service的语言代码
o        【池别名】——web service池
o        【公用名称】——web service名称
[attach]5854[/attach]

3.        自操作菜单,点击“调用(invoke)”。

[attach]5855[/attach]

4.        将显示web services的XML描述。这可以为耗用web services提供有用的信息。

[attach]5856[/attach]


[b]通过测试器调用基于对象的WEB SERVICE[/b]

在使用基于对象的web service.时,有多种不同操作可以调用。最常用的操作显示如下。

[b]查询[/b]

通过查询操作你可以查询并返回一个对象的左列表。左列表是在对象窗体左侧的选择列表。

1. 自web service操作,点击query链接。
[attach]5857[/attach]

2. 这样会打开运行web service的窗体。如下所示录入字段。
•        【语言代码】——web service的语言代码
•        【池别名】——web service池
•        【公用名称】——web service名称
•        【对象关键字】——这个可以用来根据左列表的值筛选结果。
o        BPCORD = ‘FR004’ ——返回客户FR004的所有订单
•        【列表尺寸】——这应该用来指定要在列表中返回的项目数
[attach]5858[/attach]

3. 自操作菜单,点击“调用(invoke)”。

[attach]5859[/attach]

4. web services XML结果会显示。以下是部分结果。

[attach]5860[/attach]


[b]读取[/b]

读取操作让你可以通过记录键读取一个对象。它会以XML格式返回你通常在对象窗体上看到的所有字段。

1. 自web service操作,点击read链接。

[attach]5861[/attach]

2. 这样会打开运行web service的窗体。如下所示录入字段。
•        【语言代码】——web service的语言代码
•        【池别名】——web service池
•        【公用名称】——web service名称
•        【对象关键字】——这个必须用于指定正在读取的对象的关键字值。针对这个示例,关键字是SOHNUM ,而值则是SOWFR0110005。
[attach]5862[/attach]

3. 自操作菜单,点击“调用(invoke)”。

[attach]5863[/attach]

4. web services XML结果会显示。以下是部分结果。在XML中的GRP ID代表X3中的屏幕ID。

[attach]5864[/attach]


[b]保存[/b]

保存操作让你能够基于对象创建一条新的记录。自web service操作,点击save链接。

[attach]5865[/attach]

1. 这样会打开运行web service的窗体。如下所示录入字段。.
•        【语言代码】——web service的语言代码
•        【池别名】——web service池
•        【公用名称】——web service名称
•        【对象XML】——这是创建记录的XML有效负载。下面是本例中发送的完整的XML。
[attach]5866[/attach]

[attach]5867[/attach]

2. 自操作菜单,点击“调用(invoke)”。

[attach]5868[/attach]

3. web services XML结果会显示。在创建一条新纪录时,SOHNUM会包含在结果XML中。以下是部分结果。

[attach]5869[/attach]


[b]修改[/b]

修改操作让你能够基于对象修改一条现有的记录。

自web service操作,点击modify链接。
[attach]5870[/attach]

1. 这样会打开运行web service的窗体。如下所示录入字段。
•        【语言代码】——web service的语言代码
•        【池别名】——web service池
•        【公用名称】——web service名称
•        【对象关键字】——修改一条现有记录时,必须提供主要的对象关键字。在本示例中,关键字是:
o        SOHNUM = SOWFR0110007
•        【对象XML】——这是创建记录的XML有效负载。下面是本例中发送的完整的XML。
[attach]5871[/attach]

[attach]5872[/attach]

2. 自操作菜单,点击“调用(invoke)”。

[attach]5873[/attach]

3.  web services XML结果会显示。

[attach]5874[/attach]


[b]通过测试器调用基于WEB SERVICE的子程序[/b]

1. 自web service操作,点击run链接。

[attach]5875[/attach]

2. 这样会打开运行web service的窗体。如下所示录入字段。
o        【语言代码】——web service的语言代码
o        【池别名】——web service池
o        【公用名称】——web service名称
o        【输入XML / JSON】——这是特定web service调用的格式化XML有效负载。请注意,NAM值与子程序中的输入参数相对应。1825代表5年,因此列表中将返回过去5年的客户添加和变更。

[attach]5876[/attach]

[attach]5877[/attach]

3. 自操作菜单,点击“调用(invoke)”。

[attach]5878[/attach]

4. web services XML结果会显示。以下是部分结果。.

[attach]5879[/attach]


[b]结论[/b]

现在,你已经学习了如何使用web services测试器来测试基于对象和基于子程序的web services。这些信息有助于确保web services正常工作,也有助于测试XML有效负载和web services的结果,这点在通过代码(例如。网络、Java和PHP)调用web services时非常有用。

页: [1]

Powered by Discuz! Archiver 7.2  © 2001-2009 Comsenz Inc.