返回列表 发帖

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

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





第3天 测试Web Services

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

Web Service测试器

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

1. 登录Sage X3 web客户端。

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



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



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



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



6. 以下就是操作列表。



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


WEB SERVICE描述

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


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


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



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




通过测试器调用基于对象的WEB SERVICE

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

查询

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

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


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


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



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




读取

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

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



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


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



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




保存

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



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




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



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




修改

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

自web service操作,点击modify链接。


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




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



3.  web services XML结果会显示。




通过测试器调用基于WEB SERVICE的子程序

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



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





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



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




结论

现在,你已经学习了如何使用web services测试器来测试基于对象和基于子程序的web services。这些信息有助于确保web services正常工作,也有助于测试XML有效负载和web services的结果,这点在通过代码(例如。网络、Java和PHP)调用web services时非常有用。
附件: 您需要登录才可以下载或查看附件。没有帐号?申请用户

返回列表