金蝶云星空-二次开发笔记

金蝶云星空-二次开发笔记

目录

• 零、资料
  • 0.1、公共
  • 0.2、报表
  • 0.3、插件
• 一、概述
  • 1.1、平台介绍
  • 1.2、部分业务介绍

零、资料

0.1、公共

• 知识地图：https://vip.kingdee.com/article/392699482837824512?productLineId=1&isKnowledge=2
• 交流社区：https://vip.kingdee.com/search?productId=1&productLineId=1
• 环境下载：https://open.kingdee.com/K3Cloud/Open/Products.aspx
• 安装补丁报错解决：https://vip.kingdee.com/article/465831002527655168?productLineId=1&isKnowledge=2
• 账套环境升级失败：https://vip.kingdee.com/article/474018491821827072?smartSearchResId=507119989506407680&productLineId=1&isKnowledge=2
• 账表发布后不显示：https://vip.kingdee.com/article/285118203120967582?productLineId=1
• BOS开发平台打开报错：https://vip.kingdee.com/article/471624933962111488?productLineId=1
• 入门视频：https://vip.kingdee.com/school/topic/51609017830717952?productLineId=1
• 业务入门视频：https://vip.kingdee.com/school/learnPath/193413835540524288?productLineId=30
• 开发入门视频：https://vip.kingdee.com/school/learnPath/193463482326019584?productLineId=30
• BOS开发平台的使用：https://vip.kingdee.com/article/57854870606429952?productLineId=1
• 打包（部署包）: https://vip.kingdee.com/article/427104899491671040?productLineId=1
• Debug插件：https://vip.kingdee.com/article/117230406226751232?productLineId=1&isKnowledge=2
• 常见功能二开案例：https://vip.kingdee.com/article/462556395796384256?get_from=article-id&productLineId=1
• 单据转化规则：https://vip.kingdee.com/article/22473?productLineId=1

0.2、报表

• 账表入门答疑：https://vip.kingdee.com/article/61867544482929408?productLineId=1
• 直接SQL账表：https://vip.kingdee.com/article/423447326397443584?productLineId=1&isKnowledge=2
• 简单账表开发1：https://vip.kingdee.com/article/81696654923133440?productLineId=1
• 简单账表开发2：https://vip.kingdee.com/article/37120?productLineId=1
• 简单账表开发3：https://vip.kingdee.com/article/70549955693471488?productLineId=1
• 简单账表开发4：https://vip.kingdee.com/article/291965076641556224?productLineId=1&isKnowledge=2
• 简单账表开发5：https://vip.kingdee.com/article/57055224284159233?productLineId=1
• 简单账表分组汇总（小计、合计）：https://vip.kingdee.com/article/321700583491072512?productLineId=1
• 简单账表文章汇总：https://vip.kingdee.com/article/9144?productLineId=1
• 简单账表答疑：https://vip.kingdee.com/article/9147?productLineId=1
• 简单账表-表头合并：https://vip.kingdee.com/article/238975765038109184?productLineId=1
• 简单账表表单插件与普通单据表单插件的区别：https://vip.kingdee.com/article/285119333234237207?productLineId=1
• 单据状态：https://vip.kingdee.com/article/510850972030109952?productLineId=1
• 单选辅助资料列表取值SQL-1：https://vip.kingdee.com/article/76326791479923200?productLineId=1
• 单选辅助资料列表取值SQL-2：https://vip.kingdee.com/article/285118883537739560?productLineId=1
• 枚举值SQL查询：https://vip.kingdee.com/article/477437083272077824?productLineId=1
• 存货收发存汇总SQL-1：https://vip.kingdee.com/article/249594501369582336?productLineId=1
• 存货收发存汇总SQL-2：https://vip.kingdee.com/article/216227050334526208?productLineId=1
• BOM-多级展开：https://vip.kingdee.com/article/213984429721406208?productLineId=1
• 订单预留关系查询-1：https://vip.kingdee.com/article/21473?productLineId=1
• 订单预留关系查询-2：https://vip.kingdee.com/article/285117974934052612?productLineId=1

0.3、插件

• 各类插件的案例-1：https://vip.kingdee.com/article/64993872014591232?productLineId=1
• 各类插件的案例-2：https://vip.kingdee.com/article/94751030918525696?productLineId=1&isKnowledge=2
• 各类插件的注册：https://vip.kingdee.com/article/359649910671058176?productLineId=1&isKnowledge=2
• BusinessInfo和BillBusinessInfo的区别：https://vip.kingdee.com/article/285119108503429018?productLineId=1
• 获取单据头的数据：https://vip.kingdee.com/article/285119559592435553?productLineId=1
• 菜单按钮：https://vip.kingdee.com/article/86421841576829696?productLineId=1&isKnowledge=2
• WebAPI-1：https://vip.kingdee.com/article/76278025062688512?productLineId=1
• WebAPI-2：https://vip.kingdee.com/knowledge/specialDetail/229961573895771136?category=229963554177453824&id=298050747973900544&productLineId=1
• 插件读取配置文件中的配置：https://vip.kingdee.com/article/347375083319088128?productLineId=1&isKnowledge=2

一、概述

1.1、平台介绍

金蝶云星空的二次开发主要用到：BOS设计平台（拖拽设计界面），C#（编写插件代码），IIS（Web服务器），SQLServer（数据库），套打客户端。

金蝶云星空部署后，可以使用Web界面访问，也可以使用客户端访问。

金蝶云星空可以分为：

• 注册管理中心：负责创建、注册数据库，管理许可证，监控平台。使用administrator登录，默认密码一般为888888或kingdee@123。
• 系统前台：administrator用户可以管理用户、角色、权限、组织、基础资料、WebAPI；其他用户可以使用账套的采购管理、销售管理等正常的功能。

金蝶云星空中，一张单据主要由单据头+单据明细+拆分表构成，单据头的FID字段分别与单据明细和拆分表中的FID关联，单据明细中的FENTRYID可以与LK关联表的FENTRYID关联，LK关联表的FSID可以与上游明细表的FENTRYID关联

BOS查看单据的字段：打开单据 -》工具栏中点击“编辑” -》批量编辑单据字段

每张单据在修改之前，都需要先签出，修改完毕后，必须先保存，再签入。

云星空系统自带的单据无法直接修改，需要先在单据上右键点击“扩展”，修改后保存

单据要想出现在前台，必须先点击工具栏中的“发布-》发布到主控台”，选择合适的发布位置，选择单据对象，设置权限，勾选显示前台类型，点击确定。

注意事项1：
在创建用户之后，如对用户的权限进行修改，还需要点击列表页的 “同步注册用户” 按钮。

注意事项2：
云星空平台支持多语言，因此平台所有的表涉及中文名称的字段都需要先关联一张以_L结尾的多语言表，再取这张表中的字段，例如：要取某个物料的中文名称，需要关联物料表t_bd_material与物料多语言表t_bd_material_L，且语言标识为2052代表中文。

select t1.FNUMBER as 物料编码
      ,t2.FNAME 物料名称 
from t_bd_material as t1 
  left join t_bd_material_L as t2 on t2.FMATERIALID =  t1.FMATERIALID and t2.FLOCALEID=2052

注意事项3：
上下游单据的关联需要涉及到一张以_LK结尾的关联表，_LK结尾的表中的FSID字段关联上游单据的明细IDFENTRYID,_LK结尾的表中的FENTRYID字段关联明细表的FENTRYID字段，例如：

select distinct t1.FSALESMANID
	,t4.FNAME FSALMAN -- 业务员 
	,t5.FCUSTID 
	,t5.FNUMBER FCUSTNO -- 客户代码
	,t6.FNAME FCUSTNAME -- 客户名称
	,case when t1.fdate>='2023-01-01' and t1.fdate<=dateadd(day,1,'2023-01-01') then isnull(t2.FREALQTY,0) else 0 end FREALQTY
														
from T_SAL_ORDER t01 -- 销售订单
	left join T_SAL_ORDERENTRY t02 on t02.FID = t01.FID -- 销售订单明细
	left join T_SAL_DELIVERYNOTICEENTRY_LK t03 on  t03.FSID = t02.FENTRYID -- 发货通知单关联表
	left join T_SAL_DELIVERYNOTICEENTRY t04 on t04.FENTRYID = t03.FENTRYID -- 发货通知单明细
	left join T_SAL_OUTSTOCKENTRY_LK t05 on t05.FSID = t04.FENTRYID -- 销售出库单关联表
	left join T_SAL_OUTSTOCKENTRY t2 on t2.FENTRYID = t05.FENTRYID  -- 销售出库单明细
	left join T_SAL_OUTSTOCK t1 on t1.fid = t2.fid -- 销售出库单							
	left join T_SAL_OUTSTOCKFIN t11 on t11.FID = t1.FID -- 销售出库单财务拆分表		
	left join V_BD_SALESMAN t3 on t3.fid = t1.FSALESMANID -- 业务员
	left join V_BD_SALESMAN_L t4 on t4.FSTAFFID = t3.FSTAFFID and t4.FLOCALEID=2052 -- 业务员多语言表
	left join T_BD_CUSTOMER t5 on t5.FCUSTID = t1.FCUSTOMERID -- 客户
	left join T_BD_CUSTOMER_L t6 on t6.FCUSTID = t5.FCUSTID and t6.FLOCALEID=2052 -- 客户多语言表
	left join T_AR_RECEIVABLEENTRY_LK t7 on t7.FSID = t2.FENTRYID -- 暂估应收关联表
	left join T_AR_RECEIVABLEENTRY t8 on t8.FENTRYID = t7.FENTRYID -- 暂估应收明细
	left join t_AR_receivable t9 on t9.FID = t8.FID -- 暂估应收单
	left join T_AR_RECEIVABLEENTRY_LK t12 on t12.FSID = t8.FENTRYID and t12.FSTABLENAME='t_AR_receivableEntry'   -- 财务应收关联表
	left join T_AR_RECEIVABLEENTRY t13 on t13.FENTRYID = t12.FENTRYID -- 财务应收明细单
	left join t_AR_receivable t14 on t14.fid = t13.fid -- 财务应收单
 

1.2、部分业务介绍

销售管理：

销售订单 -下推-》发货通知单 -下推-》销售出库单 -下推-》暂估应收单 -下推-》财务应收单

采购管理：

采购订单 -下推-》收料通知单 -下推-》采购入库单 -下推-》暂估应付单 -下推-》财务应付单