BOS标准API接口开发指南 V0.8
合集下载
BOS V6.2开发指南-网络互斥
<BOS 开发指南-网络互斥>
目录
1. 简介........................................................................................................................................... 3 1.1. 目的............................................................................................................................... 3 1.2. 适用对象....................................................................................................................... 3 1.3. 参考资料....................................................................................................................... 3 EAS 网络互斥功能说明 .......................................................................................................... 3 1.4. 为什么需要进行网络互斥 ........................................................................................... 4 1.5. 何时需要网络互斥....................................................................................................... 4 1.6. 网络控制监控列表....................................................................................................... 4 1.7. 功能互斥与数据互斥的区别 ....................................................................................... 5 开发功能互斥........................................................................................................................... 5 2.1. 调用 Action 前申请功能互斥序列图 .......................................................................... 5 2.2. 结束 Action 调用后释放功能互斥序列图 .................................................................. 5 2.3. 应用场景....................................................................................................................... 6 2.4. 功能互斥接口及使用示例 ........................................................................................... 6 2.5. 案例说明 1（利用框架集成功能互斥） .................................................................... 8 2.5.1. 第 1 步 确定需要申请锁的 action .......................................................................... 8 2.5.2. 第 2 步 设置 action 的扩展属性 ............................................................................. 8 2.5.3. 第 3 步 发布 UI 元数据........................................................................................... 9 2.6. 案例说明 2（不利用框架集成，手工申请和释放锁） .......................................... 10 开发数据互斥......................................................................................................................... 11 3.1. 打开编辑界面申请数据互斥序列图 ......................................................................... 11 3.2. 保存数据后释放数据互斥序列图 ............................................................................. 11 3.3. 关闭编辑界面释放数据互斥序列图 ......................................................................... 12 3.4. 数据互斥接口及使用说明 ......................................................................................... 12 3.5. 应用场景..................................................................................................................... 13 3.6. 案例说明 1（利用框架集成数据互斥） .................................................................. 13 3.6.1. 第 1 步 确定需要申请数据互斥的 action ............................................................ 13 3.6.2. 第 2 步 设置 action 的扩展属性 ........................................................................... 13 3.6.3. 第 3 步 发布 UI 元数据......................................................................................... 14 3.7. 案例说明 2（手工申请和释放数据互斥锁） .......................................................... 14 FAQ ......................................................................................................................................... 15 4.1. 网络互斥相关功能 FAQ ............................................................................................ 15
目录
1. 简介........................................................................................................................................... 3 1.1. 目的............................................................................................................................... 3 1.2. 适用对象....................................................................................................................... 3 1.3. 参考资料....................................................................................................................... 3 EAS 网络互斥功能说明 .......................................................................................................... 3 1.4. 为什么需要进行网络互斥 ........................................................................................... 4 1.5. 何时需要网络互斥....................................................................................................... 4 1.6. 网络控制监控列表....................................................................................................... 4 1.7. 功能互斥与数据互斥的区别 ....................................................................................... 5 开发功能互斥........................................................................................................................... 5 2.1. 调用 Action 前申请功能互斥序列图 .......................................................................... 5 2.2. 结束 Action 调用后释放功能互斥序列图 .................................................................. 5 2.3. 应用场景....................................................................................................................... 6 2.4. 功能互斥接口及使用示例 ........................................................................................... 6 2.5. 案例说明 1（利用框架集成功能互斥） .................................................................... 8 2.5.1. 第 1 步 确定需要申请锁的 action .......................................................................... 8 2.5.2. 第 2 步 设置 action 的扩展属性 ............................................................................. 8 2.5.3. 第 3 步 发布 UI 元数据........................................................................................... 9 2.6. 案例说明 2（不利用框架集成，手工申请和释放锁） .......................................... 10 开发数据互斥......................................................................................................................... 11 3.1. 打开编辑界面申请数据互斥序列图 ......................................................................... 11 3.2. 保存数据后释放数据互斥序列图 ............................................................................. 11 3.3. 关闭编辑界面释放数据互斥序列图 ......................................................................... 12 3.4. 数据互斥接口及使用说明 ......................................................................................... 12 3.5. 应用场景..................................................................................................................... 13 3.6. 案例说明 1（利用框架集成数据互斥） .................................................................. 13 3.6.1. 第 1 步 确定需要申请数据互斥的 action ............................................................ 13 3.6.2. 第 2 步 设置 action 的扩展属性 ........................................................................... 13 3.6.3. 第 3 步 发布 UI 元数据......................................................................................... 14 3.7. 案例说明 2（手工申请和释放数据互斥锁） .......................................................... 14 FAQ ......................................................................................................................................... 15 4.1. 网络互斥相关功能 FAQ ............................................................................................ 15
BOS_WebService开发指南
BOS_WebService开发指南BOS WebService开发指南LE开发部冯侃 2014-05-19一．建立Fa?ade或者Entity，本案例中以Fa?ade为例，Entity 可以参考在BOS Studio工具中建立fa?ade，在fa?ade加入相应的调用方法，可以加入多个。
将新建的facade 发布,生成相应的JAVA代码(注意：发布时要勾选“生成配臵文件”)。
详细操作，及需要注意的地方，如下面所示：1、如下图所示，在路径com.kingdee.eas.custom.webinterface.app下，新建方法fa?ade：PublicServiceFacade.fa?ade。
2、如下图所示，进入到PublicServiceFacade.fa?ade方法页签中，点击右侧的“增加”按钮，在“详细信息”分类下面填入：名称(inputData)、别名(inputData)、描述(inputData)、返回值类型(String),其它为默认值。
在“参数”分类下面填入：名称(StringXML)、数据类型(String)、别名(StringXML)、描述(StringXML)。
此时方法添加完毕，保存PublicServiceFacade.fa?ade。
二．在BOS Studio中选择Fa?ade发布WebService1、如下图所示，在“金蝶BOS设计开发工具透视图”模式中，选中PublicServiceFacade.fa?ade右击鼠标，弹出下拉框，选择“发布WebService”操作，会弹出下图二中的对话框：“请选择要发布的方法”。
这里：勾选“全选”复选框、勾选“追加到配臵文件”复选框、在“JAVA发布目录”中填入D:\Tmps路径、在“WSDL发布目录”中填入D:\Tmps路径。
点击“完成”按钮。
在控制台中会打印出相关提示语句，见本组图三显示的内容。
2、“发布WebService”操作成功后，会在上面图二的路径中，自动生成一个.wsdd后缀的文件。
bos标准简介
模块间的交互
通过统一的接口规范实现模块间的交互，确保不同模 块之间的兼容性和互操作性。
模块的复用
通过模块的复用，减少重复开发，提高开发效率和质 量。
03
bos标准的核心技术
分布式对象技术
分布式对象的概念
分布式对象技术是指在分布式系统中，将对象之间的交互和通信抽 象为对象之间的方法调用和属性访问。
随着技术的不断进步和应用需求 的不断增长，BOS标准逐渐得到 完善和发展。
BOS标准经过多年的实践和应用 ，逐渐形成了一套完整的标准体 系，并得到了广泛应用和认可。
bos标准的应用领域
智能建筑
BOS标准可以应用于智能建筑的 运营和管理，包括楼宇自控、能 源管理、安防监控等方面。
智慧城市
BOS标准可以应用于智慧城市的 运营和管理，包括城市基础设施 、公共安全、环境保护等方面。
bos标准简介
汇报人： 2023-12-13
目录
• bos标准概述 • bos标准的体系结构 • bos标准的核心技术 • bos标准的优势与特点 • bos标准的应用场景与案例分
析 • bos标准的未来发展趋势与挑
战
01
bos标准概述
bos标准的定义与背景
BOS标准定义
BOS（Building Operation System）标准是一种用于智能建筑和智慧城市建设的标准体系，旨在规 范和指导建筑设施的智能化运营和管理。
bos标准将不断深化应用层次，从简 单的数据传输向更复杂的应用场景拓
展，如实时控制、预测分析等。
个性化定制
bos标准将支持个性化定制，根据不 同用户的需求，提供定制化的解决方
案。
标准化与协同发展
标准化建设
通过统一的接口规范实现模块间的交互，确保不同模 块之间的兼容性和互操作性。
模块的复用
通过模块的复用，减少重复开发，提高开发效率和质 量。
03
bos标准的核心技术
分布式对象技术
分布式对象的概念
分布式对象技术是指在分布式系统中，将对象之间的交互和通信抽 象为对象之间的方法调用和属性访问。
随着技术的不断进步和应用需求 的不断增长，BOS标准逐渐得到 完善和发展。
BOS标准经过多年的实践和应用 ，逐渐形成了一套完整的标准体 系，并得到了广泛应用和认可。
bos标准的应用领域
智能建筑
BOS标准可以应用于智能建筑的 运营和管理，包括楼宇自控、能 源管理、安防监控等方面。
智慧城市
BOS标准可以应用于智慧城市的 运营和管理，包括城市基础设施 、公共安全、环境保护等方面。
bos标准简介
汇报人： 2023-12-13
目录
• bos标准概述 • bos标准的体系结构 • bos标准的核心技术 • bos标准的优势与特点 • bos标准的应用场景与案例分
析 • bos标准的未来发展趋势与挑
战
01
bos标准概述
bos标准的定义与背景
BOS标准定义
BOS（Building Operation System）标准是一种用于智能建筑和智慧城市建设的标准体系，旨在规 范和指导建筑设施的智能化运营和管理。
bos标准将不断深化应用层次，从简 单的数据传输向更复杂的应用场景拓
展，如实时控制、预测分析等。
个性化定制
bos标准将支持个性化定制，根据不 同用户的需求，提供定制化的解决方
案。
标准化与协同发展
标准化建设
BOSStudio开发指南之BOS元数据概要
业务功能(Function)是对运行系统的Entity对象,UI 对象及其方法的一定封装,供其它模块或二次开发使 用(目前业务功能的主要使用对象为工作流).
11
枚举(Enumeration)
枚举值的类型可以是:
Integer Long Float Double String
12
异常(Exception)
2
解决方案(Solution)
解决方案是元数据的最大载体,对应于一个元数据集 合.任一个元数据都必须归属于某个解决方案,譬如, EAS就是一个解决方案. 解决方案的定义包括:
名称,别名,描述 支持语言 发布方案
获得高回报
3
包(Package)
提供了元数据的Namespace管理,同时也提供了另一 种分类和查看的方式. 类似于目录结构的一个树状模型. 元数据必须属于且只属于一个包. 包的定义只有名称一项,与文件的命名限制一致. 在定义期,包会映射到元数据存储的实际目录.
16
业务数据类型 (DataType)
业务数据类型用来说明数据项的数据类型.
17
日志(Log)
18
Q&A
19
谢
谢!
20
�
5
关系(Relationship)
关系是指实体对象之间的连接关系.关系可以用连接 (Link)来描述 . 关系分为以下几种:
继承(Generalization/Implementation) 关联(Association)/聚合(Aggregation) 组成(Composition)
6
数据表(Table)
建立一个Join Query的步骤
基本信息 定义查询方案(Selector Specification) 定义过滤方案(Filter Specification) 定义排序方案(Sort Specification) 定义分组方案(Group Specification) 定义联接方式 定义主键
11
枚举(Enumeration)
枚举值的类型可以是:
Integer Long Float Double String
12
异常(Exception)
2
解决方案(Solution)
解决方案是元数据的最大载体,对应于一个元数据集 合.任一个元数据都必须归属于某个解决方案,譬如, EAS就是一个解决方案. 解决方案的定义包括:
名称,别名,描述 支持语言 发布方案
获得高回报
3
包(Package)
提供了元数据的Namespace管理,同时也提供了另一 种分类和查看的方式. 类似于目录结构的一个树状模型. 元数据必须属于且只属于一个包. 包的定义只有名称一项,与文件的命名限制一致. 在定义期,包会映射到元数据存储的实际目录.
16
业务数据类型 (DataType)
业务数据类型用来说明数据项的数据类型.
17
日志(Log)
18
Q&A
19
谢
谢!
20
�
5
关系(Relationship)
关系是指实体对象之间的连接关系.关系可以用连接 (Link)来描述 . 关系分为以下几种:
继承(Generalization/Implementation) 关联(Association)/聚合(Aggregation) 组成(Composition)
6
数据表(Table)
建立一个Join Query的步骤
基本信息 定义查询方案(Selector Specification) 定义过滤方案(Filter Specification) 定义排序方案(Sort Specification) 定义分组方案(Group Specification) 定义联接方式 定义主键
BOSS系统的接口规范简介
中国移动通信集团公司二○○一年八月目录1. 总则 (1)1.1. 概述 (1)1.2. 原则和目标 (1)1.3. 适用范围 (2)1.4. 起草单位 (2)1.5. 解释权 (2)2. 接入服务接口总体说明 (3)2.1. 系统总体接口应用模型 (3)2.2. 接口实现机制 (4)2.3. 接口要求 (6)3. Internet接口说明 (7)3.1. 接口应用模型 (7)3.2. 接口网络组织 (8)3.3. 接口安全控制 (10)3.3.1. 安全评估 (10)3.3.2. 访问控制 (11)3.3.3. 入侵检测 (12)3.3.4. 口令认证 (12)3.3.5. 安全审计 (12)3.3.6. 防（毒）恶意代码 (12)3.3.7. 加密 (13)3.3.8. 其他 (13)3.4. 接口连接管理 (14)3.4.1. 传输控制 (14)3.4.2. 通讯服务 (14)3.4.3. 动态资源管理 (15)3.5. 接口逻辑管理 (16)3.5.1. 数据管理 (16)3.5.1.1. 业务数据检查 (16)3.5.1.2. 数据压缩/解压 (16)3.5.2. 优先级管理 (17)3.5.3. 交换分发管理 (17)3.5.4. 完整性管理 (18)3.5.4.1. 实时交易业务 (19)3.5.4.2. 批量传输业务 (19)4. 接口服务详述 (20)4.1. 业务受理 (20)4.1.1. 功能界定 (20)4.1.2. 售不记名卡 (21)4.1.2.1. 业务描述 (21)4.1.2.2. 接口服务 (21)4.1.2.2.1. 不记名卡查询接口服务 (21)4.1.2.2.2. 不记名卡销售接口服务 (21)4.1.2.2.3. 卡销售回退接口服务 (21)4.1.3. 预销 (22)4.1.3.1. 业务描述 (22)4.1.3.2. 接口服务 (22)4.1.3.2.1. 预销初始接口服务 (22)4.1.3.2.2. 预销确认接口服务 (22)4.1.4. 用户资料变更 (22)4.1.4.1. 业务描述 (22)4.1.4.2. 接口服务 (23)4.1.4.2.1. 密码验证接口服务 (23)4.1.4.2.2. 资料查询接口服务 (23)4.1.4.2.3. 用户服务密码变更接口服务 (23)4.1.4.2.4. 客户信息资料变更接口服务 (24)4.1.4.2.5. 帐户信息资料变更接口服务 (24)4.1.5. 服务变更 (25)4.1.5.1. 业务描述 (25)4.1.5.2. 接口服务 (25)4.1.5.2.1. 服务变更初始接口服务 (25)4.1.5.2.2. 号源查询接口服务 (25)4.1.5.2.3. 业务选择接口服务 (26)4.1.5.2.4. 服务变更费用计算接口服务 (26)4.1.5.2.5. 服务变更确认接口服务 (26)4.1.6. 付费计划变更 (27)4.1.6.1. 业务描述 (27)4.1.6.2. 接口服务 (27)4.1.6.2.1. 付费计划变更初始接口服务 (27)4.1.6.2.2. 付费计划变更接口服务 (27)4.1.6.2.3. 客户化帐单格式变更接口服务 (27)4.1.7. 套餐计划变更 (28)4.1.7.1. 业务描述 (28)4.1.7.2. 接口服务 (28)4.1.7.2.1. 套餐计划变更初始接口服务 (28)4.1.7.2.2. 套餐计划查询接口服务 (28)4.1.7.2.3. 套餐计划变更确认接口服务 (28)4.1.8. 预约服务 (29)4.1.8.1. 业务描述 (29)4.1.8.2. 接口服务 (29)4.1.8.2.1. 预约服务受理接口服务 (29)4.1.8.2.2. 预约费用计算接口服务 .................................................................................................错误！未定义书签。
BOS开发指南_元数据介绍
BOS 元ቤተ መጻሕፍቲ ባይዱ据介绍 (V6.1 版)
目录 1. 什么是元数据............................................................................................................................. 4 2. 解决方案（Solution）............................................................................................................... 4 2.1. 解决方案简介.............................................................................................................4 2.2. 支持语言..................................................................................................................... 4 2.3. 发布方案..................................................................................................................... 4 3. 包（Package）........................................................................................................................... 5 3.1. 包简介......................................................................................................................... 5 4. 实体（Entity）和关系（Relationship）.................................................................................. 5 4.1. 实体对象简介.............................................................................................................5 4.2. 实体对象属性.............................................................................................................6 4.2.1. 映射..................................................................................................................... 6 4.2.2. 数据类型.............................................................................................................6 4.2.3. 约束..................................................................................................................... 7 4.2.4. 计算公式.............................................................................................................7 4.3. 实体对象方法.............................................................................................................7 4.4. 实体对象事件.............................................................................................................7 4.5. 实体对象继承.............................................................................................................8 4.6. 实体关系简介.............................................................................................................8 4.6.1. “关联/聚合”和组合............................................................................................ 8 4.6.2. 定义多对多关联................................................................................................ 9 5. 数据表（Table）........................................................................................................................ 9 5.1. 数据表简介.................................................................................................................9 5.2. 字段............................................................................................................................. 9 5.2.1. 多语言字段.......................................................................................................10 5.2.2. 约束...................................................................................................................10 5.3. 索引........................................................................................................................... 10 5.4. 主键........................................................................................................................... 10 5.5. 外键........................................................................................................................... 10 6. 查询（Query）......................................................................................................................... 11 6.1. 查询简介................................................................................................................... 11 7. 用户界面（UI）.......................................................................................................................11 7.1. 用户界面简介........................................................................................................... 11 7.2. 控件和布局............................................................................................................... 11 7.3. 数据绑定...................................................................................................................12 7.4. 界面操作（Action）.............................................................................................. 12 7.5. 界面状态...................................................................................................................12 8. 业务功能（Function）............................................................................................................ 12 8.1. 业务功能简介...........................................................................................................12 8.2. 业务功能操作...........................................................................................................12 9. 功能（Façade）....................................................................................................................... 13 9.1. 功能简介...................................................................................................................13 10. 枚举（Enumeration）...................................................................................................... 13 10.1. 枚举简介...................................................................................................................13
目录 1. 什么是元数据............................................................................................................................. 4 2. 解决方案（Solution）............................................................................................................... 4 2.1. 解决方案简介.............................................................................................................4 2.2. 支持语言..................................................................................................................... 4 2.3. 发布方案..................................................................................................................... 4 3. 包（Package）........................................................................................................................... 5 3.1. 包简介......................................................................................................................... 5 4. 实体（Entity）和关系（Relationship）.................................................................................. 5 4.1. 实体对象简介.............................................................................................................5 4.2. 实体对象属性.............................................................................................................6 4.2.1. 映射..................................................................................................................... 6 4.2.2. 数据类型.............................................................................................................6 4.2.3. 约束..................................................................................................................... 7 4.2.4. 计算公式.............................................................................................................7 4.3. 实体对象方法.............................................................................................................7 4.4. 实体对象事件.............................................................................................................7 4.5. 实体对象继承.............................................................................................................8 4.6. 实体关系简介.............................................................................................................8 4.6.1. “关联/聚合”和组合............................................................................................ 8 4.6.2. 定义多对多关联................................................................................................ 9 5. 数据表（Table）........................................................................................................................ 9 5.1. 数据表简介.................................................................................................................9 5.2. 字段............................................................................................................................. 9 5.2.1. 多语言字段.......................................................................................................10 5.2.2. 约束...................................................................................................................10 5.3. 索引........................................................................................................................... 10 5.4. 主键........................................................................................................................... 10 5.5. 外键........................................................................................................................... 10 6. 查询（Query）......................................................................................................................... 11 6.1. 查询简介................................................................................................................... 11 7. 用户界面（UI）.......................................................................................................................11 7.1. 用户界面简介........................................................................................................... 11 7.2. 控件和布局............................................................................................................... 11 7.3. 数据绑定...................................................................................................................12 7.4. 界面操作（Action）.............................................................................................. 12 7.5. 界面状态...................................................................................................................12 8. 业务功能（Function）............................................................................................................ 12 8.1. 业务功能简介...........................................................................................................12 8.2. 业务功能操作...........................................................................................................12 9. 功能（Façade）....................................................................................................................... 13 9.1. 功能简介...................................................................................................................13 10. 枚举（Enumeration）...................................................................................................... 13 10.1. 枚举简介...................................................................................................................13
对象存储BOS-BOSJavaSDK文档（精品）
BOS Java SDK文档概述本文档主要介绍BOS Java SDK的安装和使用。
在使用本文档前，您需要先了解BOS的一些基本知识，并已经开通了BOS 服务。
若您还不了解BOS，可以参考产品描述和入门指南。
安装SDK工具包运行环境Java SDK工具包可在jdk1.6、jdk1.7、jdk8环境下运行。
安装步骤1.在官方网站下载Java SDK压缩工具包。
2.将下载的bce-java-sdk-version.zip解压后，复制到工程文件夹中。
3.在Eclipse右键“工程 -> Properties -> Java Build Path -> Add JARs”。
4.添加SDK工具包lib/bce-java-sdk-version.jar和第三方依赖工具包third-party/*.jar。
其中，version为版本号。
SDK目录结构com.baidubce├──auth//BCE签名相关类├──http//BCE的Http通信相关类├──internal//SDK内部类├──model//BCE公用model类├──services│└──bos//BOS服务相关类│├──model//BOS内部model，如Request或Response│├──BosClient.class//BOS客户端入口类│└──BosClientConfiguration.class//针对BOS特有的HttpClient的配置├──util//BCE公用工具类├──BceClientConfiguration.class//对BCE的HttpClient的配置├──BceClientException.class//BCE客户端的异常类├──BceServiceException.class//与BCE服务端交互后的异常类├──ErrorCode.class//BCE通用的错误码└──Region.class//BCE提供服务的区域快速入门1.初始化一个BosClient。
新员工培训-BOS Studio开发指南
版权所有 ©1993-2006 金蝶软件(中国)有限公司
P23
P23
实体-定义实体的属性
设置字段的详细信 息：数据类型、数 据长度、默认值、 映射的数据表字段 等 定义自有属性及 关联属性
增加及设置实体 属性的扩展属性， 常用扩展属性有： isForMapping、 isForGrouping、 isForWrittenBack、 isInCode、 isVisibleForKDTa ble等。
P11
P11
解决方案-基本信息设置
版权所有 ©1993-2006 金蝶软件(中国)有限公司
P12
P12
解决方案-多语言支持设置
版权所有 ©1993-2006 金蝶软件(中国)有限公司
P13
P13
解决方案-发布方案设置
版权所有 ©1993-2006 金蝶软件(中国)有限公司
P14
P14
包
提供了元数据的Namespace管理。 提供了一种分类和查看的方式。 类似于目录结构的一个树状模型。 元数据必须属于且只属于一个包。 包定义的名称必须与文件的命名一致。 在定义期，包会映射到元数据存储的实际目录。
版权所有 ©1993-2006 金蝶软件(中国)有限公司
P51
P51
数据表-实体导出表
版权所有 ©1993-2006 金蝶软件(中国)有限公司
P52
P52
数据表-手工新建
表名称“T_KD_PurReq” 中的‘KD’ 来自当前业 务对象所在包的简码，可凭此到数据库中找到相 应的表
P22
P22
实体-设置或修改实体的基础信息
设置或修改实体 的一般信息。 注：别名一般都 必须加上。
P23
P23
实体-定义实体的属性
设置字段的详细信 息：数据类型、数 据长度、默认值、 映射的数据表字段 等 定义自有属性及 关联属性
增加及设置实体 属性的扩展属性， 常用扩展属性有： isForMapping、 isForGrouping、 isForWrittenBack、 isInCode、 isVisibleForKDTa ble等。
P11
P11
解决方案-基本信息设置
版权所有 ©1993-2006 金蝶软件(中国)有限公司
P12
P12
解决方案-多语言支持设置
版权所有 ©1993-2006 金蝶软件(中国)有限公司
P13
P13
解决方案-发布方案设置
版权所有 ©1993-2006 金蝶软件(中国)有限公司
P14
P14
包
提供了元数据的Namespace管理。 提供了一种分类和查看的方式。 类似于目录结构的一个树状模型。 元数据必须属于且只属于一个包。 包定义的名称必须与文件的命名一致。 在定义期，包会映射到元数据存储的实际目录。
版权所有 ©1993-2006 金蝶软件(中国)有限公司
P51
P51
数据表-实体导出表
版权所有 ©1993-2006 金蝶软件(中国)有限公司
P52
P52
数据表-手工新建
表名称“T_KD_PurReq” 中的‘KD’ 来自当前业 务对象所在包的简码，可凭此到数据库中找到相 应的表
P22
P22
实体-设置或修改实体的基础信息
设置或修改实体 的一般信息。 注：别名一般都 必须加上。
- 1、下载文档前请自行甄别文档内容的完整性，平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益，请联系客服反馈,我们会尽快为您处理(人工客服工作时间：9:00-18:30)。
1.2 身份认证
为客户端程序提供 appkey （应用程序编号,即为系统用户名）和 appSecret （密钥，即为系 统用户名对应密码的 MD5 哈希码，32 位长全部小写，关于 MD5 哈希码的说明请参考 /wiki/MD5#MD5_hashes 。 另 外 ， 注 意 用 户 的 密 码 取 值 于 users.passwordhash 字段，此字段的内容仅在 portal.properties#security.password.plain=true 才 会在修改用户密码的时候将明码保存）。这样客户程序本质上是以一个用户身份在使用系统。
C_CUSTOMER_ID;RANK_ID;DESC 即为 COLUMNLINK 的定义
1.1.2.2 界面视图构架 在 Portal 上可以完成底层同一张表的多视图构建。比如底层有业务伙伴表，通过建立“供应 商”，“批发商”，“零售商”等视图将业务伙伴分开，并且不同视图允许有不同的字段内容。 只不过这些字段一般都在业务伙伴表上有定义。
在服务器上给出专用 URL 来处理所有接口内容: http://127.0.0.1/servlets/binserv/Rest 同时在服务器以下位置可以获取到与业务单据相关的接口内容说明： http:/127.0.0.1/html/nds/schema/resthome.jsp 在以下位置进行数据封装测试： http://127.0.0.1/html/nds/schema/testrest.jsp
1.3 数据格式
传送内容：将必选参数和业务参数作为 query 内容填写到 HttpURLConnection 里 Post 到专 用 URL。下面介绍参数设置。
1.3.1 必选参数
sip_appkey - 应用程序的编号 sip_timestamp - 服务请求时间戳(yyyy-mm-dd hh:mm:ss.xxx)，支持毫秒，若系统不能产生毫 秒，必须补足内容，如使用.000。 sip_sign - 签名，使用 sip_appkey+sip_timestamp+appSecret 进行 MD5 哈希运算，结果为 32 位长字符串，全部小写，服务器需要校验此值。
BOS 标准 AP Portal 、BOS 的实时接口，能够支持应用程序通过 HTTP 请求的方式操作业 务数据，完成数据的更新和检索等操作。接口以 REST 模式设计，以 JSON，而不是 XML 为主要数据封装格式。
目录
1.1 概述............................................................................................................................... 2 1.1.1 设计思想........................................................................................................... 2 1.1.2 Portal、BOS 框架简介 ....................................................................................2
1.3.1 必选参数........................................................................................................... 3 1.3.2 业务参数........................................................................................................... 3 1.3.3 返回内容........................................................................................................... 4 1.4 命令............................................................................................................................... 4 1.4.1 ObjectCreate...................................................................................................... 5 1.4.2 ObjectModify .................................................................................................... 5 1.4.3 ObjectDelete...................................................................................................... 5 1.4.4 ObjectSubmit..................................................................................................... 6 1.4.5 ObjectUnsubmit ................................................................................................ 6 1.4.6 ProcessOrder ..................................................................................................... 6 1.4.7 ExecuteWebAction............................................................................................8 1.4.8 Import................................................................................................................ 8 1.4.9 Query................................................................................................................. 9 1.4.10 GetObject ........................................................................................................ 10 1.4.11 ExecuteSQL .................................................................................................... 11 1.4.12 ExecuteBatch................................................................................................... 12 1.4.13 ExecuteAudit................................................................................................... 12 1.4.14 SendSMS......................................................................................................... 12
客户表上的 RANK_ID 字段为 FK 指向 C_RANK 客户等级的 ID 字段。则：
第 2 页 共 13 页
BOS 标准 API 接口开发指南 V0.8.doc
USERS.C_CUSTOMER_ID;RANK_ID;DESC 就是一条 COLUMNLINK, 表示将获取当 前用户对应的客户的等级描述字段。通常忽略主表名称 USERS，以
注意 Portal 的表和视图，字段等都不是存储的数据库概念。Portal 的表即可以对应数据库的 表，也可以是数据库的视图。Portal 的视图主要是表数据的不同窗口的显示模板定义，与底 层视图没有关系。Portal 的字段可以是底层的字段，也可以是动作按钮，还可以是纯粹的界 面上的分栏标签。
对于接口的开发人员，面对的是和界面视图一致的操作界面。
第 1 页 共 13 页
BOS 标准 API 接口开发指南 V0.8.doc
1.1 概述
1.1.1 设计思想
我们将可快速开发作为首要设计出发点。 目前的 web 接口主要有以下几种方式 xml-rpc soap rest 作为轻量级的接口设计模型，rest 具有开发快速，接口完全自定义的特点，考虑以此模式进 行。
1.2 身份认证....................................................................................................................... 3 1.3 数据格式....................................................................................................................... 3
为客户端程序提供 appkey （应用程序编号,即为系统用户名）和 appSecret （密钥，即为系 统用户名对应密码的 MD5 哈希码，32 位长全部小写，关于 MD5 哈希码的说明请参考 /wiki/MD5#MD5_hashes 。 另 外 ， 注 意 用 户 的 密 码 取 值 于 users.passwordhash 字段，此字段的内容仅在 portal.properties#security.password.plain=true 才 会在修改用户密码的时候将明码保存）。这样客户程序本质上是以一个用户身份在使用系统。
C_CUSTOMER_ID;RANK_ID;DESC 即为 COLUMNLINK 的定义
1.1.2.2 界面视图构架 在 Portal 上可以完成底层同一张表的多视图构建。比如底层有业务伙伴表，通过建立“供应 商”，“批发商”，“零售商”等视图将业务伙伴分开，并且不同视图允许有不同的字段内容。 只不过这些字段一般都在业务伙伴表上有定义。
在服务器上给出专用 URL 来处理所有接口内容: http://127.0.0.1/servlets/binserv/Rest 同时在服务器以下位置可以获取到与业务单据相关的接口内容说明： http:/127.0.0.1/html/nds/schema/resthome.jsp 在以下位置进行数据封装测试： http://127.0.0.1/html/nds/schema/testrest.jsp
1.3 数据格式
传送内容：将必选参数和业务参数作为 query 内容填写到 HttpURLConnection 里 Post 到专 用 URL。下面介绍参数设置。
1.3.1 必选参数
sip_appkey - 应用程序的编号 sip_timestamp - 服务请求时间戳(yyyy-mm-dd hh:mm:ss.xxx)，支持毫秒，若系统不能产生毫 秒，必须补足内容，如使用.000。 sip_sign - 签名，使用 sip_appkey+sip_timestamp+appSecret 进行 MD5 哈希运算，结果为 32 位长字符串，全部小写，服务器需要校验此值。
BOS 标准 AP Portal 、BOS 的实时接口，能够支持应用程序通过 HTTP 请求的方式操作业 务数据，完成数据的更新和检索等操作。接口以 REST 模式设计，以 JSON，而不是 XML 为主要数据封装格式。
目录
1.1 概述............................................................................................................................... 2 1.1.1 设计思想........................................................................................................... 2 1.1.2 Portal、BOS 框架简介 ....................................................................................2
1.3.1 必选参数........................................................................................................... 3 1.3.2 业务参数........................................................................................................... 3 1.3.3 返回内容........................................................................................................... 4 1.4 命令............................................................................................................................... 4 1.4.1 ObjectCreate...................................................................................................... 5 1.4.2 ObjectModify .................................................................................................... 5 1.4.3 ObjectDelete...................................................................................................... 5 1.4.4 ObjectSubmit..................................................................................................... 6 1.4.5 ObjectUnsubmit ................................................................................................ 6 1.4.6 ProcessOrder ..................................................................................................... 6 1.4.7 ExecuteWebAction............................................................................................8 1.4.8 Import................................................................................................................ 8 1.4.9 Query................................................................................................................. 9 1.4.10 GetObject ........................................................................................................ 10 1.4.11 ExecuteSQL .................................................................................................... 11 1.4.12 ExecuteBatch................................................................................................... 12 1.4.13 ExecuteAudit................................................................................................... 12 1.4.14 SendSMS......................................................................................................... 12
客户表上的 RANK_ID 字段为 FK 指向 C_RANK 客户等级的 ID 字段。则：
第 2 页 共 13 页
BOS 标准 API 接口开发指南 V0.8.doc
USERS.C_CUSTOMER_ID;RANK_ID;DESC 就是一条 COLUMNLINK, 表示将获取当 前用户对应的客户的等级描述字段。通常忽略主表名称 USERS，以
注意 Portal 的表和视图，字段等都不是存储的数据库概念。Portal 的表即可以对应数据库的 表，也可以是数据库的视图。Portal 的视图主要是表数据的不同窗口的显示模板定义，与底 层视图没有关系。Portal 的字段可以是底层的字段，也可以是动作按钮，还可以是纯粹的界 面上的分栏标签。
对于接口的开发人员，面对的是和界面视图一致的操作界面。
第 1 页 共 13 页
BOS 标准 API 接口开发指南 V0.8.doc
1.1 概述
1.1.1 设计思想
我们将可快速开发作为首要设计出发点。 目前的 web 接口主要有以下几种方式 xml-rpc soap rest 作为轻量级的接口设计模型，rest 具有开发快速，接口完全自定义的特点，考虑以此模式进 行。
1.2 身份认证....................................................................................................................... 3 1.3 数据格式....................................................................................................................... 3