BOS_V6.3_BOS开发指南_WebService
Webservice学习
Web Service学习笔记（1）Web Service的宗旨是创建不需要用户界面就能与其他应用程序交互的Web应用程序。
举例说明它的优点，假如你正在为一家股票投资公司创建网站，你并不需要把不同证劵交易所得数据库与自己的后台数据库进行整合，因为你的应用程序可以使用Web Service，并使用XML格式交换数据。
Web Service是松耦合的，它与服务器端和客户端使用的操作系统、编程语言都无关。
假如你既拥有客户端又有服务器端的访问和管理权，这种情况更适合用.NET 的Remoting技术，而不是Web service。
创建Web Service必须保证的是，服务器端和客户端都要支持HTTP、SOAP（简单对象访问协议）和XML等行业标准协议。
Web Service是如何工作的Web Service允许两个程序之间交换XML文档。
在这个架构的顶层，微软实现了一个远程过程调用（Remote Procedure Call，PRC）模型。
Web Service架构包括以下特性：1。
WebServcie的服务器端和客户端应用程序都能够连接到互联网。
2。
用于进行通信的数据格式必须遵守相同的开放标准，并且在大多数情况下，这个标准几乎总是SOAP。
3。
客户端和服务器端的系统是松耦合的。
即Web Service不关心客户端和服务器端所使用的操作系统、对象模型或者编程语言。
只要Web Service和使用Web Service的应用程序都能够发送和接收遵守适当协议标准的消息即可。
下图为Web Service流程的逻辑架构如图所示，一个Web Service使用着会向Web Service发出一个调用请求。
使用者会认为它通过Internet直接和Web Service进行交流，当然这实际上是个幻象。
实际上，真正的调用由代理类完成。
代理类对于Web Service使用者来说是一个本地类。
代理会处理所有的负责的复杂架构，包括通过Internet发送请求道服务器、从web Service取回结果并呈现给Web Service使用者。
EASBOS开发指南_权限
BOS开发指南—权限目录1. 简介 (4)1.1. 目的 (4)1.2. 适用对象 (4)1.3. 参考资料 (4)2. BOS权限系统总览 (4)3. 权限项介绍 (4)3.1. 权限项的关联实体 (4)3.2. 权限项的默认依赖 (5)3.3. 权限项扩展属性: orgRelation（权限项主业务组织类型） (5)3.4. 权限项扩展属性：permItemType（权限项类型） (6)3.5. 扩展属性enableDataPermission (7)3.6. 关于菜单的权限过滤 (7)3.7. 权限项组别 (8)3.8. 同步权限项 (8)3.9. 版本差异 (8)4. 功能权限 (8)4.1. 功能方面 (8)4.1.1. 设置权限项 (8)4.1.2. 分配权限项 (9)4.2. 技术方面 (9)5. 普通数据权限 (11)5.1. 功能方面 (11)5.1.1. 权限项设置 (11)5.1.2. 建立授权规则 (11)5.1.2.1. 授权规则的实体树配置 (11)5.1.2.2. 建立授权规则 (12)5.1.3. 分配数据权限 (12)5.2. 技术方面 (13)6. 字段权限介绍 (17)6.1. 功能方面 (17)6.1.1. 实体设置 (17)6.1.2. 生成字段子系统树 (18)6.1.3. 启用字段权限 (18)6.1.4. 字段权限授权 (18)7. 特殊数据权限 (19)7.1. 功能方面 (19)7.1.1. 集成单据实体 (19)7.1.2. 配置权限项 (19)7.1.3. 特殊数据权限设置 (20)7.1.3.1. 切换CU (20)7.1.3.2. 拥有者权限 (20)7.1.3.2.1. 启用拥有者权限 (20)7.1.3.2.2. 启用拥有者例外 (20)7.1.3.2.3. 其他拥有者 (21)7.1.3.3. 主管权限 (21)7.1.3.3.1. 设置主管权限 (21)7.1.3.3.2. 指定主管权限 (22)7.1.4. 特殊数据权限和普通数据权限的关系 (22)7.2. 版本差异 (22)7.2.1. 特殊数据配置文件 (22)7.2.2. 切换CU (22)7.2.3. 特殊数据权限和普通数据权限的关系 (22)8. 用户管理 (22)9. FAQ (24)9.1. 权限项相关功能1FAQ (24)9.2. 数据权限相关功能FAQ (24)9.3. 特殊数据权限FAQ (25)9.4. 字段权限FAQ (25)10. 附录 (25)11. 备注 (25)1.1. 目的本文档概要的介绍了BOS权限系统的基本概念、基本操作及常见问题。
金蝶BOS进阶培训_Web设计器
P21
编辑界面
2.选择“EditUI”或“BillEditUI”
版权所有 ©1993-2006 金蝶软件(中国)有限公司
P22
编辑界面
3.按【确定】后，选择【下一步】
版权所有 ©1993-2006 金蝶软件(中国)有限公司
P23
编辑界面
4.选择“Entity UI”，按【选择BO对象】选择一个Entity
版权所有 ©1993-2006 金蝶软件(中国)有限公司
P40
目录
BOS Web应用的开发基础 Web设计器整体介绍 布局组件介绍 普通组件属性及事件介绍 Web设计器的相关特性介绍 发布部署介绍 BIM对Web设计器的支持
版权所有 ©1993-2006 金蝶软件(中国)有限公司
版权所有 ©1993-2006 金蝶软件(中国)有限公司
P37
布局容器-TabbedPane
TabbedPane是一种页签容器
1.使用TabbedPane在界面上画一个页签容器区域 2. TabbedPane支持Panel或FreePanel的容器作为面板 3.选中后再页签区域单击即可 4.通过点击页签可以切换页签显示面板
Form
版权所有 ©1993-2006 金蝶软件(中国)有限公司
P34
布局容器-FreePanel,Form,Composite
每个Smart布局容器中，可以设置控件的autoSize（与锚定的概念一样）。autoSize属性在控件的constraint中设置。
点击按钮打卡锚定设置对话框
上下左右四个方向都可以设置边特性。 不锚定：该边在运行期不做任何调整 固定距离：该边设计期的边距运行期边距始终一致 等比缩放：该边设计期的边距比例与运行期边距比例一致
金蝶BOS企业版V开发指南新编管理门户_Portlet开发
EAS门户Portlet制作指南说明本指南主要介绍EAS门户Portlet的制作过程。
简要阐述了EAS门户的新特性，详细介绍了制作Portlet的过程和步骤，对制作Portlet过程遇到的常见问题进行了说明。
本指南适用于EAS门户Portlet开发人员。
目录第1章 EAS门户简介EAS门户新特性新的EAS门户在上一版本门户的基础上对整体框架进行了优化，实现了相关新特性，包含如下功能：（1）自定义布局：可自由布局，跨列布局；（2）页签配置完善：以拖拽方式把Portlet配置到页签上；（3）展现框架调整：可自由拖拽布局显示，运行期用户可个性化配置界面展示样式；（4）提供容器Portlet：将多个单一Portlet组合成一个Portlet；（5）Portlet增加属性设置：支持系统级和业务级属性设置，且同时支持定义期和运行期属性设置；（6）Portlet异步加载：页签中每个Portlet异步加载，并发运行；（7）通知和待办可分类设置和授权：分类可由管理员统一建立和分配，同时允许用户自定义分类和管理管理员设置的分类。
第2章 Portlet制作Portlet制作步骤Portlet制作过程包含以下几个步骤：（1）配置Portlet信息（2）向数据库插入相关数据（3）制作Portlet内容页面，实现业务需求（4）制作Portlet业务设置页面（可选）最后一个步骤并不是必须的，在Portlet的业务需求需要业务设置时，才进行此步骤。
下面将分小节详细介绍Portlet制作的各个步骤，关于Portlet业务设置的内容将单独在第3章中介绍。
配置Portlet信息2.2.1 配置Portlet定义信息（1）配置文件路径版本：server/profiles/server1/config/portalConfig/版本：server/deploy/WEB-INF/其中，xxx表示具体的业务领域名称，如bos、eas等，详细信息请参考“附录1 Portal 配置文件拆分说明”（2）配置说明<portlet><portletID>1001</portletID><title>testPortlet</title><modes><mode><name>view</name><value></value></mode></modes></portlet>各配置参数值说明如下：1001：Portlet定义ID，全局唯一，不能重复。
BOS V6.2开发指南_BOTP
索引目录 1 BOTP 总体介绍.................................................................................................................................................................. 4 1.1 BOTP 简介............................................................................................................................................................... 4 1.2 BOS BOTP 产品特性 .............................................................................................................................................. 4 2 BOTP 规则定义实例..................................................................................................................................................... 5 2.1 新增转换规则定义 ........................................................................................................................................ 5 2.2 设置规则编码/名称 ....................................................................................................................................... 6 2.3 设置单据头属性 ............................................................................................................................................ 7 2.4 设置单据体(分录)属性 ................................................................................................................................. 7 2.5 设置分组合并规则 ........................................................................................................................................ 8 2.6 设置反写规则 ................................................................................................................................................ 9 2.7 设置源单属性 ................................................................................................................................................ 9 2.8 设置规则过滤 .............................................................................................................................................. 10 2.9 设置数据过滤 .............................................................................................................................................. 10 2.10 启用规则 ...................................................................................................................................................... 11 2.11 执行单据转换 .............................................................................................................................................. 12 2.12 查看转换结果 .............................................................................................................................................. 12 3 BOTP 规则定义详解................................................................................................................................................... 13 3.1 规则列表界面 .............................................................................................................................................. 13 3.2 规则编辑界面 .............................................................................................................................................. 14 3.3 单据头属性设置 .......................................................................................................................................... 15 3.4 单据体属性设置 .......................................................................................................................................... 16 3.5 公式平台 ...................................................................................................................................................... 16 3.6 计算公式定义 .............................................................................................................................................. 17 3.7 使用函数 ...................................................................................................................................................... 18 3.8 分组合并规则 .............................................................................................................................................. 19 3.9 反写源单 ...................................................................................................................................................... 20 3.9.1 反写概述 .............................................................................................................................................. 21 3.9.2 规则反写 .............................................................................................................................................. 21 3.9.2.1 一般反写 .............................................................................................................................. 21 3.9.2.2 核销反写 .............................................................................................................................. 22 3.9.3 业务反写 .............................................................................................................................................. 22 3.9.4 批量反写 .............................................................................................................................................. 22 3.9.5 删除反反写 .......................................................................................................................................... 23 3.9.6 反写机制 .............................................................................................................................................. 23 3.10 源单属性设置 .............................................................................................................................................. 23 3.11 规则过滤设置 .............................................................................................................................................. 25
EAS-WebService开发指南
EAS-webservice开发指南1.在设计开发工具中新建一个Facade对象如下图所示。
选择方法选项卡，建立自定义方法，如下图，这里以helloWorld为例。
2.右键点击Facade对象，选择发布为webservice如下图所示在弹出框中选中方法，填写发布目录后点击“完成”按钮如下图此时会在制定路径下生成对应全路径的java类和wsdd描述文件（描述这个java类的相关信息）3.右键点击Facade选择发布（自动生成java代码）如下图所示切换BOS到java视图，刷新主目录，然后将webservice 发布目录中的java类拷贝到对应目录下，最后结果如图所示4.接下来开始写自己的业务逻辑，打开helloWorldFacadeControllerBean，在空白处右键，选择“源代码”->”覆盖/实现方法”此时会在弹出界面中看到先前定义的getHelloWorld方法，选中此方法，点击“确定”编写如下图所示代码5.到此为止已全部开发完成，接下来进行打包。
打包与一般的eas开发打包的区别在于多了一个server\deploy\eas.ear\web.war包,eas打包不在此文档中讲解，在web.war包的WEB-INF文件夹中包含一个classes目录，将编写的类及自动生成的所有相关类的全路径class拷贝到此目录下，然后将先前生成的webservice 发布目录中的helloWorldFacade.wsdd文件拷贝到WEB-INF目录下，并打开helloWorldFacade.wsdd文件，将内容复制到server-config.wsdd文件中6.将制作好的补丁包部署到服务器上，重启服务器7.打开浏览器，输入地址：http://server-ip:port/ormrpc/services，应该可以看到新建的Webservice，右键点击相应的wsdl，选择另存为…，扩展名改为wsdl，就可以下载客户端开发使用的wsdl 文件。
webservice开发手册
1、新建工程:New->Web->Dynamic Web Project如果Target Runtime没有，则新建一个Runtime我这里选择Tomcat v5.5作为我的Server这里就添加了Runtime环境以后直接默认就可以了。
2、新建WSDL:右击工程新建web Services ->wsdl生成后的服务端包名将按照Target namespace的反过来顺序生成。
例如：现在为 生成后的包为com.shtel.eai3、修改WSDL文件:修改NewOperationRequest成自己想入参的名字，setType ->New 生成新的类型，再在新的类型上添加Add Element或Add Attribute。
例图例图例图<soap:address location="http://localhost:8080/services/"/>为工程部署后访问的地址。
如果需要添加数组类型的数据，折需要在两个新的Type中设置1…*的类型例图基类设置需要在Inherit From 添加基类。
public class PointDepositQueryRtn extends com.twq.ws.hellowsdl.BasePara implements java.io.Serializable { private com.twq.ws.hellowsdl.PointDeposit[] pointDepositSet;}4、生成service代码:右击WSDL文件，新建New ->Web Service5、当初次生成services端时，系统会要选择使用的服务器。
生成好后会在启动服务，如第一次启动，会要求配置启动服务器。
会自动生成server-config.wsdd、wsdl/helloSOAP.wsdl还会生成一个Servers的目录。
101_BOS开发使用指南
BOS开发使用指南目录一、BOS解决方案管理 (2)二、数据对象定义 (3)三、实体对象定义 (3)四、界面对象定义 (3)五、实体对象的操作 (4)1、关于数字 (4)2、新增 (4)3、修改 (5)4、删除 (5)5、获取集合 (5)6、建立主键 (5)7、登陆上下文 (6)8、使用Selector对象 (6)9、使用Filter对象 (6)10、单据操作 (7)六、开发环境建立 (7)1．apusic安装 (7)1）使用apusic2.0.2版， (7)2）设置环境变量 (7)3）把bosconfig.xml，log4j.properties (7)4）建立数据库连接 (7)5）在%apusic_home%目录下建立元数据发布目录metas (8)6）建立apusic启动批命令SetEASEnv.bat (8)7）安装ormrpc.eas (8)2．BOS的安装 (9)1）设置环境变量 (9)3.Bos开发 (9)一、BOS解决方案管理金蝶BOS Studio透视图：是BOS视图的集合，打开他默认打开BOS开发环境。
BOS的视图分为一下几种：✧BOS studio资源导航：显示已经存在的解决方案（如果方案不存在，通过Eclipse引入解决方案），可以对解决方案进行新建，删除，打开，刷新。
✧BOS控制台：显示后台输出信息和错误信息。
✧包分类：显示解决方案的包结构✧类型：分类显示BOS所有对象✧应用分类：显示建立的发布方案的内容✧大纲：BOS对象的概要信息。
✧属性：显示选中对象的属性✧BindDataView：FQA：1、如何新建一个解决方案?答：建立BOS元数据解决方案与在Eclipse中建立Java项目一样，可以通过菜单建立，需要注意的是：方案名称，与将要存在CVS中的模块名称要一致，方案建立好后，不要修改名称。
应此建议方案名称为XXXmetas（将来可能考虑把元数据，服务器端代码，客户代码合并到一个Java项目中，那时BOS解决方案就是Java项目）2、如何打开一个已经存在的解决方案？答：如果方案在CVS中，通过CVS资源库视图选中方案，把它作为项目检出；如果方案存在本地，通过Eclipse的导入功能将方案导入（不要修改名称）。
- 1、下载文档前请自行甄别文档内容的完整性，平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益，请联系客服反馈,我们会尽快为您处理(人工客服工作时间：9:00-18:30)。
BOSWebService (2)1.1.BOSWebService原理 (2)1.2.发布WebService的约束 (3)1.3.BOSWebService发布 (3)1.3.1.发布流程 (3)1.3.2.发布WebService (3)1.3.3.编辑WebService配置文件 (4)1.4.BOSWebService部署 (5)1.4.1.建立web工程 (5)1.4.2.部署发布文件 (5)1.4.3.测试是否正确 (6)1.4.4.Web工程目录及文件截图 (6)1.5.客户端代码 (6)1.5.1.获取wsdl服务描述文件 (6)1.5.2.下载工具 (7)1.5.3.建立一个新工程 (7)1.5.4.使用java客户端 (11)1.5.5.importVoucher（凭证引入 (12)1.6.BOS webservice 安全性 (13)1.6.1.BOS webservice 安全性概述 (13)1.6.2.不启用安全性 (13)1.6.3.启用安全性 (13)1.6.4.如何安全性启用 (14)1.7.EASLogin 登陆webservice 说明 (14)1.7.1.EASLogin 接口说明 (14)1.7.2.EASLogin 异常说明 (15)1.7.3.EASLogin 和前面版本的差别 (16)1.8.webservice 异常查看 (16)2.WebService 客户端开发指南 (17)2.1.前提条件 (17)2.2.获取WSDL文件 (17)2.3.生成客户端 (18)2.3.1.生成Java客户端 (18)2.3.2.建立一个新工程 (18)2.3.3.将获取到的WSDL文件拷贝到工程的根目录下： (19)2.3.4.生成客户端 (19)2.4.使用java客户端 (23)2.5.生成C# 客户端 (23)2.5.1.使用命令行 (23)2.5.2.运行命令生成客户端 (24)2.5.3.使用客户端代码 (25)3.webservice FAQ (27)3.1.在EAS 上如何发布一个webservice ? (27)3.2.如何调用一个 webservice？ (27)3.3.有哪些工具能够简单的测试 webservice？ (27)3.4.EASLogin 服务登陆如何判断失败 (27)3.5.调用webservice时报 com.kingdee.bos.IllegalSessionStateException: Pleaselogin first 异常？ (27)3.6.EAS6.0调用webservice时报没有 WSConfig.getSrvURL() 方法。
(28)3.7.调用webservice时报.SocketTimeoutException: Read timed out 异常28BOSWebService1.1. BOSWebService原理Webservice 主要由SOAP，WSDL, 以及UDDI 等几块技术组成，以XML格式进行数据的传输。
是建立可互操作的分布式应用程序的新平台Webservice的一个最基本的目的就是提供在各个不同平台的不同应用系统的协同工作能力。
使各个异构系统之间实现无缝交互。
在本质上是要为应用程序之间提供数据通讯的标准，为企业应用之间动态地提供大颗粒度的服务，并不适合于非常精细的基于会话的方法调用以及复杂的事务（transaction）处理之中。
1.2. 发布WebService的约束在BOS Studio中发布webService时，只能发布Entity和Façade两种元数据类型成WebService服务端的代码。
由于Entity或Façade函数参数和返回值可能包含很多复杂的业务类型，在发布时会生成许多辅助类，一些复杂类型在其他异构系统中生成webService客户端时不能很好的支持，因此建议在建立webService功能时，最好使用Façade，并且提供简单类型的输入和返回参数。
1.3. BOSWebService发布1.3.1.发布流程先建立需要发布的Façade,建立粗粒度的业务方法，业务方法尽可能提供简单数据类型的数据参数和返回参数。
1.3.2.发布WebService运行BOS Studio，打开“包分类”视图，在其中选中要发布WebService的实体或Façade 对象（可同时选中多个），点击鼠标右键，在弹出菜单中选择“发布WebService”,将弹出“发布WebService”向导：选择实体或Façade对象下要发布的方法，手工输入或者点击“浏览”按钮来指定发布生成代码存放的目录，可以同时勾中“追加到配置文件”。
这样BOS Studio将会根据选中的对象和要发布的方法生成WebService代码和wsdl描述1.3.3.编辑WebService配置文件在“包分类”视图中，选择要编辑其配置文件的解决方案，点击工具栏上的“编辑WebService 配置文件”按钮，将会弹出配置文件编辑向导在其间，可以增加或删除要发布的对象（方法），选择好要发布的对象（方法）后，点击“完成”按钮，即可完成对配置文件的编辑。
配置文件位于解决方案的根目录下。
1.4. BOSWebService部署1.4.1.建立web工程在apusic\domains\server1\applications下建立一个web工程。
（web工程可以从eas\Server\server\deploy\eas.ear\web.war解压）然后配置apusic\domains\server1\config\server.xml文件，在<server>下添加工程<application name="web" base="applications/web" start="auto" />重新启动服务器，访问当前工程是否可用：http://localhost:6888/web1.4.2.部署发布文件将生成的Web Serivce 的java代码编译为class或打成jar包，放在web目录下相应的web\WEB-INF\classes下或web\WEB-INF\lib目录中，把发布的wsdd文件中服务部分拷贝到server-config.wsdd中。
如EASLogin.wsdd中<service name="EASLogin" provider="java:RPC">…</service> 内容拷贝到server-config.wsdd。
1.4.3.测试是否正确重新启动服务器，通过浏览器输入服务的地址，访问服务是否正确如输入：http://localhost:6888/web/service?1.4.4.Web工程目录及文件截图1.5. 客户端代码1.5.1.获取wsdl服务描述文件WebService已经成功部署到应用服务器上（本文以Apusic为例进行说明），客户端可以通过浏览器访问到已部署的WebService。
要构建相关的客户端，就要获取已经部署的WebService的相应的WSDL文件，用鼠标右键点击蓝色的部分“(wsdl)”，选取“目标另存为”菜单，这时将出现选择保存文件位置的对话框，在文件名处将文件的后缀名由xml改为wsdl，将wsdl文件保存至本地。
1.5.2.下载工具通过下载eclipse（下载j2ee版本）或通过命令行来生成java -Djava.ext.dirs=lib org.apache.axis.wsdl.WSDL2Java其中lib是axis包目录生成客户端代码。
1.5.3.建立一个新工程例如建立一个工程名为GenerateWSClient的Java工程：将获取到的WSDL文件拷贝到工程的根目录下用鼠标右键点击要生成客户端的WSDL文件，选取菜单“Web Services”-“Generate Client”将会弹出生成客户端向导如图，使用默认值，点击“Next >”，进入下一步：依然使用默认值，点击“Next >”，进入下一步：依然使用默认值，点击“Finish”，即可生成相应的客户端工程（是一个Web工程）1.5.4.使用java客户端新生成的工程中有一个JavaSource目录，我们要使用的java代码就位于这个目录，例如上图中的WSLoginProxy.java。
以下是一个使用Java客户端的例子：import java.rmi.RemoteException;import com.kingdee.WSLoginProxy;//此为发布的代码import com.client.WSContext;public class LoginTest {public static void main(String[] args) {try {WSLoginProxy proxy = new WSLoginProxy();/*** web service客户端登陆* userName 用户名* password 密码* slnName eas* dcName 数据中心,对应的是dataCenter中数据中心id* language 语言 L2简体* dbType 数据库类型 0:sqlServer 1:db2 2:oracle* authPattern 验证方式默认 "BaseDB" ; 其他认证方式KEY可从easAuthPatterns.xml中获取*/WSContext ctx = proxy.login("用户", "", "eas", "数据中心id", "L2", 0); //成功登录后打印sessionIdSystem.out.println(ctx.getSessionId());//调用凭证业务webservice方法importVoucher（凭证引入），请看1.55节}catch (RemoteException e) {e.printStackTrace();}}}1.5.5.importVoucher（凭证引入1、凭证引入接口，两个接口方法都可用，且用法一致2、凭证 webService 接口生成客户端，可参考 EASLogin 方法3、凭证引入参数：importVoucher(wsvoucher[], int isVerify, int isCashflow)●传参数第1个：WSWSVoucher[] 普通对象数组，见构造EAS凭证字段以及含义说明●传参数第2个：isverify0 不核销，暂存1 核销，暂存2 不核销，提交3 核销，提交●传参数第3个：isImpCashflow是否引入现金流量 0 不引入 1 引入4、凭证引入代码调用说明5、返回值String[][]是一个长度为凭证数，宽度是5的字符串数据宽度的定义：外部系统凭证号，凭证字，会计年度，会计期间，处理信息，异常信息，金蝶凭证号1.6. BOS webservice 安全性1.6.1.BOS webservice 安全性概述BOS webservice 安全有两种模式，启用安全性和不启用安全性，默认配置是不启用安全性。