Planbar智能构件开发之PythonParts开发入门

1 什么是PythonParts

Planbar提供一套参数化的构件，如叠合楼板、叠合墙板等等；用户为了提高建模以及出图效率会定制开发一套符合公司标准的参数化构件，俗称参数化构件库，例如梁、柱、楼梯等等。

那么，用户就可考虑使用Planbar平台提供的一种解决方案-PythonParts。

PythonParts是以Python编程语言书写的智能化构件，用户可按照自己的需求进行定制化开发，以达到最高的建模和出图效率。

2 PythonParts API

Planbar提供一整套详尽的Python API，供用户使用，具体请参考网站：https://pythonparts.allplan.com/

3 PythonParts 入门介绍

3.1查询ETC、STD等相关文件夹路径
软件安装完成后，在桌面上出现服务2018、Planbar2018两个快捷按钮。点开服务2018，可找到“一般程序数据”以及“办公室标准”两个路径，即ETC和STD文件夹位置。

3.2PythonParts 基本要求
一个成功的Python Parts需要两个文件夹来保存相关内容：std/Library和Std\PythonPartsScripts

3.3std/Library
std/Library路径是放置构件本身的，即构件入口文件，用户可以创建自己的文件夹，比如：PYP-Joerg，其下至少包括xxx.png; xxx.pyp; xxx_chn.xml以及pics文件夹
xxx.png 封面
xxx.pyp 构件入口
xxx_chn.xml 界面翻译
pics文件夹 保存所需要的图片（大样图）
建议打开PYP后，第一行是公司LOGO

例如：Std\Library\PYP-Joerg

3.4Std\PythonPartsScripts
Std\PythonPartsScripts路径是保存xxx.py文件的，是智能构件的运行逻辑，用户可以创建自己的文件夹，如AT_reinforcement或者PY-ruan等等。如果是默认安装，srd下面是没有PythonPartsScripts这个文件夹的，用户需要自己新建这个名字的文件夹。

例如：Std\PythonPartsScripts\AT_reinforcement

注意：这个自己创建的文件夹名字不能与Etc\PythonPartsScripts下文件夹重名！！！

具体名字如下图：

3.5例子
PYP内容
Std\Library\PYP-Joerg

PY内容
Std\PythonPartsScripts\AT_reinforcement

3.6最基本案例
Planbar提供一整套最基本的案例，以便用户理解上手。进入C盘，打开隐藏文件夹，找到ProgrammData文件夹，之后依次进入C:\ProgramData\Nemetschek\Allplan\2019\ETC\Examples，将PythonParts文件夹复制到Std\Library文件夹下面。

这样就可在软件界面，库/办公室/PythonParts中找到全面的最基本的Python库。