赛捷软件论坛 - Powered by Discuz! Board

标题: [V12功能解说] 5天学习Sage X3 Web Services 第3天 [打印本页]

作者: lynn.yu 时间: 2020-2-12 20:07 标题: [V12功能解说] 5天学习Sage X3 Web Services 第3天

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

[attach]5847[/attach]

第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。

[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非常有用

WEB SERVICE描述

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]

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

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

查询

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

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]

读取

读取操作让你可以通过记录键读取一个对象。它会以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]

保存

保存操作让你能够基于对象创建一条新的记录。自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]

修改

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

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

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

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]

结论

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

欢迎光临赛捷软件论坛 (http://sagesoft.cn/bbs/)