|
|
@@ -0,0 +1,265 @@
|
|
|
+ 通过视图配置获取系统参数
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+工具版本迭代
|
|
|
+ 修订时间
|
|
|
+ 修订说明
|
|
|
+--------------------------------------------------------------------------------
|
|
|
+作者
|
|
|
+ 审核
|
|
|
+ 2025/05/20
|
|
|
+初次版本
|
|
|
+ 刘颖
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+使用场景：
|
|
|
+ 第三方系统获取SHR数据，可通过视图配置出的数据。
|
|
|
+
|
|
|
+
|
|
|
+使用说明：
|
|
|
+ 初始配置OSF：
|
|
|
+
|
|
|
+<service name="serviceTest" interface="com.kingdee.bos.bsf.service.app.IHRMsfService" class="com.kingdee.eas.custom.service.test.ServiceTest"
|
|
|
+version="1.0" model="ORG">
|
|
|
+<description>写入联系方式-邮件</description>
|
|
|
+<compatibility>向后兼容</compatibility>
|
|
|
+<product name="SHR" version="1.0"></product>
|
|
|
+<methods>
|
|
|
+<method name="process" description="重新计算年假">
|
|
|
+<parameters>
|
|
|
+<parameter name="ctx" type="com.kingdee.bos.Context" description="应用上下文" isRequired="true"/>
|
|
|
+
|
|
|
+<parameter name="param" type="java.util.Map" description="参数值">
|
|
|
+</parameter>
|
|
|
+
|
|
|
+</parameters>
|
|
|
+
|
|
|
+<return type="Object" description="返回一个对象值"></return>
|
|
|
+<exceptions>
|
|
|
+<exception>com.kingdee.bos.BOSException</exception>
|
|
|
+<exception>com.kingdee.eas.common.EASBizException</exception>
|
|
|
+</exceptions>
|
|
|
+</method>
|
|
|
+</methods>
|
|
|
+</service>
|
|
|
+ 注：serverTest 和 parameter 属性 整理后 正式使用时决定，参数暂时是 uipk 和where
|
|
|
+ 视图配置说明：
|
|
|
+ 这里配置显示字段是返回给第三方系统的数据：
|
|
|
+
|
|
|
+ 字段说明：
|
|
|
+ 字段是实体或者query配置字段
|
|
|
+调用说明：
|
|
|
+地址栏：
|
|
|
+ http://169.254.157.139:6888/shr/shr/msf/service.do?method=callService&serviceName=serviceTest&uipk=com.kingdee.eas.custom.dormitorysystem.dormitory.app.Dormitory.list&where=id=%27i6MAAAAAr91VKOqd%27
|
|
|
+ 地址栏调用：
|
|
|
+ Uipk：为配置视图
|
|
|
+ Where：为查询条件
|
|
|
+举例：
|
|
|
+ 需求：
|
|
|
+ 第三方系统需要获取系统员工宿舍信息以及当前宿舍下面住宿的人员
|
|
|
+ 初始部署：略~（开发或者实施 将文件放到服务路径下 导入osf 配置 即可）
|
|
|
+ 配置视图：
|
|
|
+ 1、创建视图：模型为对应的员工宿舍
|
|
|
+
|
|
|
+2、选择第三方系统需要的字段
|
|
|
+
|
|
|
+
|
|
|
+3、嵌入入住人员信息：
|
|
|
+ 同样的方法创建入住人员信息视图
|
|
|
+
|
|
|
+4、回到员工宿舍视图添加关联关系
|
|
|
+
|
|
|
+<field name="gridCol" label="自定义字段" isColFilter="true" data-isGridCol="true" data-uipk="com.kingdee.eas.custom.dormitorysystem.occupants.app.Occupants.list" data-value="id" data-comparison="Dormitory" />
|
|
|
+
|
|
|
+ 注：这里使用的是自定义字段
|
|
|
+ 参数注释：
|
|
|
+ data-isGridCol：是否为引用字段
|
|
|
+ data-uipk：引用视图：
|
|
|
+ data-value和data-comparison配合使用：
|
|
|
+ data-value当前视图的字段data-comparison引用视图字段
|
|
|
+ 翻译：这条数据的id=引用数据Dormitory条件
|
|
|
+ 入住信息里面的入住人员里面的宿舍和当前视图绑定
|
|
|
+
|
|
|
+调用返回值：
|
|
|
+此时返回的自定义字段里面放的就是人员信息
|
|
|
+
|
|
|
+[
|
|
|
+ [
|
|
|
+ {
|
|
|
+ "data": "001",
|
|
|
+ "dataType": {
|
|
|
+ "isenum": true,
|
|
|
+ "alias": "String",
|
|
|
+ "name": "String"
|
|
|
+ },
|
|
|
+ "name": "name",
|
|
|
+ "alias": "房间号"
|
|
|
+ },
|
|
|
+ {
|
|
|
+ "data": {
|
|
|
+ "displayname_l2": "根节点_A冻_1层",
|
|
|
+ "displayName": "根节点_A冻_1层",
|
|
|
+ "name": "1层",
|
|
|
+ "name_l2": "1层",
|
|
|
+ "id": "i6MAAAAAr9BVKOqd"
|
|
|
+ },
|
|
|
+ "dataType": {
|
|
|
+ "isenum": true,
|
|
|
+ "alias": "ObjectValue",
|
|
|
+ "name": "ObjectValue"
|
|
|
+ },
|
|
|
+ "name": "parent",
|
|
|
+ "alias": "父节点"
|
|
|
+ },
|
|
|
+ {
|
|
|
+ "data": {
|
|
|
+ "name": "双人间",
|
|
|
+ "name_l2": "双人间",
|
|
|
+ "id": "i6MAAAAAeUECFyqW"
|
|
|
+ },
|
|
|
+ "dataType": {
|
|
|
+ "isenum": true,
|
|
|
+ "alias": "ObjectValue",
|
|
|
+ "name": "ObjectValue"
|
|
|
+ },
|
|
|
+ "name": "RoomType",
|
|
|
+ "alias": "房间类型"
|
|
|
+ },
|
|
|
+ {
|
|
|
+ "data": "00001",
|
|
|
+ "dataType": {
|
|
|
+ "isenum": true,
|
|
|
+ "alias": "String",
|
|
|
+ "name": "String"
|
|
|
+ },
|
|
|
+ "name": "number",
|
|
|
+ "alias": "编码"
|
|
|
+ },
|
|
|
+ {
|
|
|
+ "data": [
|
|
|
+ [
|
|
|
+ {
|
|
|
+ "data": {
|
|
|
+ "name": "刘颖",
|
|
|
+ "name_l2": "刘颖",
|
|
|
+ "name_l3": "刘颖",
|
|
|
+ "id": "i6MAAAAAFNKA733t",
|
|
|
+ "name_l1": "刘颖"
|
|
|
+ },
|
|
|
+ "dataType": {
|
|
|
+ "isenum": true,
|
|
|
+ "alias": "ObjectValue",
|
|
|
+ "name": "ObjectValue"
|
|
|
+ },
|
|
|
+ "name": "person",
|
|
|
+ "alias": "人员"
|
|
|
+ },
|
|
|
+ {
|
|
|
+ "data": null,
|
|
|
+ "dataType": {
|
|
|
+ "isenum": true,
|
|
|
+ "alias": "Enum",
|
|
|
+ "name": "Enum"
|
|
|
+ },
|
|
|
+ "name": "Dormitory.RoomClassification",
|
|
|
+ "alias": "房间归类"
|
|
|
+ },
|
|
|
+ {
|
|
|
+ "data": null,
|
|
|
+ "dataType": {
|
|
|
+ "isenum": true,
|
|
|
+ "alias": "String",
|
|
|
+ "name": "String"
|
|
|
+ },
|
|
|
+ "name": "Dormitory.RoomType.name",
|
|
|
+ "alias": "房间类型"
|
|
|
+ }
|
|
|
+ ],
|
|
|
+ [
|
|
|
+ {
|
|
|
+ "data": {
|
|
|
+ "name": "刘玲",
|
|
|
+ "name_l2": "刘玲",
|
|
|
+ "name_l3": "刘玲",
|
|
|
+ "id": "i6MAAAAAF5mA733t",
|
|
|
+ "name_l1": "刘玲"
|
|
|
+ },
|
|
|
+ "dataType": {
|
|
|
+ "isenum": true,
|
|
|
+ "alias": "ObjectValue",
|
|
|
+ "name": "ObjectValue"
|
|
|
+ },
|
|
|
+ "name": "person",
|
|
|
+ "alias": "人员"
|
|
|
+ },
|
|
|
+ {
|
|
|
+ "data": {
|
|
|
+ "displayname_l2": "根节点_A冻_1层_001",
|
|
|
+ "RoomType": {
|
|
|
+ "name": "双人间",
|
|
|
+ "name_l2": "双人间",
|
|
|
+ "id": "i6MAAAAAeUECFyqW"
|
|
|
+ },
|
|
|
+ "RoomClassification": {
|
|
|
+ "isenum": true,
|
|
|
+ "alias": "房间",
|
|
|
+ "value": "3"
|
|
|
+ },
|
|
|
+ "displayName": "根节点_A冻_1层_001",
|
|
|
+ "name": "001",
|
|
|
+ "name_l2": "001",
|
|
|
+ "DormitoryType": {
|
|
|
+ "name": "男生宿舍",
|
|
|
+ "name_l2": "男生宿舍",
|
|
|
+ "id": "i6MAAAAAeSYdnt8+"
|
|
|
+ },
|
|
|
+ "id": "i6MAAAAAr91VKOqd"
|
|
|
+ },
|
|
|
+ "dataType": {
|
|
|
+ "isenum": true,
|
|
|
+ "alias": "ObjectValue",
|
|
|
+ "name": "ObjectValue"
|
|
|
+ },
|
|
|
+ "name": "Dormitory",
|
|
|
+ "alias": "宿舍"
|
|
|
+ }
|
|
|
+ ]
|
|
|
+ ],
|
|
|
+ "dataType": null,
|
|
|
+ "name": "gridCol",
|
|
|
+ "alias": "自定义字段"
|
|
|
+ }
|
|
|
+ ]
|
|
|
+]
|
|
|
+
|
|
|
+
|
|
|
+
|
