## 前言 上一篇整理了关于如何在协同开发平台搭建开发环境的笔记 (传送门：[[二开笔记] 如何使用协同开发平台进行新项目开发](https://wenku.my7c.com/article/285511185883886592?cid=286067358412903424))，反响超乎了 Yogurt 的预期，看来在这个关键时期，不光是 Yogurt，还有很多同行都在寻找和摸索使用新平台的操作方法。Yogurt 从自身的项目出发，继续整理的关于协同开发平台的笔记，这一次是关于动态表单项目的创建。 ## 开发环境 | 信息 | 说明 | | ---------------- | ---------------------------------------------------- | | 操作系统版本 | Microsoft Windows 10 专业工作站版 10.0.19042 64 位 | | 金蝶云星空版本 | v7.7.0.202112 | | BOS 版本 | v7.72388.8 | ## 操作步骤 ### Step 1 启动开发环境 打开项目目录，找到步骤 Step 5 创建的 `StartService.bat` 文件，就是那个用来 `启动开发环境的BAT命令`。鼠标选中后右键选择 `以管理员身份运行`  将会打开两个窗口，一个是 IISExpress.exe，一个是浏览器。实测需要等待约 3-5 分钟左右才会启动完成，这时你可以喝口水，放松一下。  如果看到这个页面，恭喜你，开发环境顺利搭建完成了。  ### Step 2 登录开发环境 Step 1 正常启动成功后，打开 `协同开发平台` 在登录界面的 `服务器设置` 中输入 `http://localhost:配置的端口`，例如这里配置的端口为 `1203`，因此输入的是 `http://localhost:1203`。  修改完后，正常登录即可。 ### Step 3 打开项目 等待登录完成，将在 `我的应用` 对话框中看到新建的项目  ### Step 4 新建表单插件工程 在右侧的项目对话框里，展开 `程序集包`，选择 `表单插件工程` (一定要选中)，然后 `右键` 在弹出的菜单中选择 `新建表单插件工程`。  在弹出的对话框中添加输入 `工程名称` ，一般情况下 `工程目录` `引用/输出目录` 都是默认在项目文件夹的 `K3Cloud/bin` 目录下，自动生成的路径，可以不用管。 工程名称按照金蝶社区的开发规范的格式来写，Yogurt 的格式是参考了官方的插件名称来的。 > 开发商代码.K3.项目名称.BusinessPlugIn  新建好表单插件工程后，选中新建的工程(一定要选中)，`右键` 在弹出的菜单中选择 `添加插件`  然后根据提示依次选择/输入相关的信息。 插件类型这里是动态表单，所以就选择 `动态表单插件` 插件名称建议是 **英文**，必填，插件描述是对这个插件的描述，也可以认为就是这个插件的 **中文名称**，非必填，但是个人建议写上后期添加插件的时候好区分一点。  添加完插件之后，系统会自动创建一个关于动态表单插件的模板。模板好评！！！个人认为这个功能比用 BOS 设计器来开发要舒服很多。 在协同开发平台里可以直接查看和编辑代码，个人认为仅限于临时改改代码可以，开发的效率还是不太高。建议使用 `Visual Studio`，简称 `VS`。Yogurt 使用的是 `Visual Studio 2019 Community` 也就是社区版(免费)。  使用 `VS` 开发的话，可以选中工程后，`右键` 在弹出的菜单中选择 `在VS中打开`。  VS 中打开的效果如下，相对来说在这里开发要效率高一点，比如各种代码提示和补全什么的。大神盲写请忽略，哈哈哈哈哈。  ### Step 5 编译工程 一般来说，写完代码直接在 VS 里直接编译就可以了，不过协同开发平台里也提供了一个 `编译工程` 的功能，应该是给没有安装 VS 的情况准备的，没关系，都能用，生成 dll 的路径都是一样的 —— `项目文件夹\K3Cloud\bin`。这个也是好评！！！之前用 BOS 设计器开发的时候为了避免因为各种引用污染了开发环境，所以就手动复制粘贴生成的 dll 到开发环境的 `bin` 目录，哎，难哪，这下每个有独立的开发环境 (差不多2个G，也是。。。总比没有好)，不用那么麻烦的复制粘贴了。 需要注意的是：**只有编译好的项目才能被注册**。  ### Step 6 新建动态表单 做完前面的准备，就可以创建动态表单了，当然，这个顺序倒不是必须的，可以按自己的习惯来。在 `业务领域` 的 `子系统` 下找到 `动态表单` 的分类，`右键` 在弹出的菜单中选择 `新增`  然后按自己的需求，选择不同的创建类型，目前 Yogurt 的使用场景是选择的 `空白对象`，然后输入动态表单的 `名称`  首次创建出来的动态表单不会自动保存的，创建完毕后要记得先保存。如果不小心关掉的话，再次打开就有可能是下图这样了  这个是跟协同开发平台的 `签入签出` 的源代码管理机制有关系，好处呢肯定是有，只是一开始可能会觉得很烦，习惯了好像也还行。如果出现上图的情况，解决办法就是选中当前表单，然后 `右键` 在弹出的菜单中选择 `签出` 即可。  `签出` 后就没有提示了，此时就可以愉快的编辑动态表单了 ### Step 7 注册表单插件 如果说 Step 6 的操作是创建动态表单的 "身体" 的话，那么注册表单插件就是创建了动态表单的 "灵魂"。 在右侧下方的属性栏里找到 `表单插件` 选项。这里需要注意的是，要在 `_Bill` 这一层才可以添加。  在弹出的对话框中你可以看到所有注册的插件，下图是新建的动态表单，所以还没有插件。点击 `注册` 按钮  在弹出对话框中的 `选择程序集` 下拉框中点击 `浏览`，在弹出的文件夹对话框大概率不是根目录，而是别的目录。 **切记：千万不要引用除了根目录 `K3Cloud/bin` 目录下的任何 dll，都不会生效的**。  此时建议找到项目文件夹下的 `K3Cloud/bin` 目录，从地址栏中把它复制出来，然后粘贴到弹出的对话框的路径中  然后将 `修改日期` 改为 `降序`，那么你将能够快速的找到刚刚编译好的插件了，如下图。  双击插件，将其添加到系统中，然后勾选需要注册的插件。这里就是为什么希望大家填写项目描述了 —— `程序集描述` 就是 `项目描述` 了，当你的工程里有很多个插件的时候，你将能够感受到这个便利。  点击 `确定` 后，回到 `插件配置信息`，点击 `确定` 退出即可  最后回到动态表单界面的时候 **不要忘记保存**，不保存的话，刚刚做的所有操作都是无效的。  ## 后记 以上就是在协同开发平台里新建一个动态表单项目的操作过程了。新建其他表单类型应该都是大同小异的，操作体验上和 BOS 设计器的感觉差不多，部分操作感觉体验变得麻烦了，但个人觉得无伤大雅，新增的这个代码模板功能真的不错，再也不用每次都把社区的全事件示例贴上去了，挺棒的。还有就是可以自动编译结果至 `K3Cloud/bin` 目录下。除了怕污染开发环境外，还有一个原因就是代码是需要 git 托管的，BOS 设计器时期不这么做，用 git 不太好管理。 好啦，差不多就这些，如果对大家有所帮助，将是 Yogurt 的荣幸。

为什么编译工程，在引用DLL，提示找不到插件的

学习