[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]