phil-让你的插件更Revit-扩展存储和模型动态更新DMU

©2013Autodesk让你的插件更Revit！-扩展存储ES和模型动态更新DMU夏晓飞技术主管开发者训练营2013©2013Autodesk什么样的插件很Revit门窗表的故事扩展存储ExtensibleStorage模型动态更新DynamicModelUpdater日程©2013Autodesk什么样的插件很Revit©2013Autodesk故事：编辑增强器（门窗表）Revit门明细表Revit符合中国建筑规范门窗明细表©2013Autodesk故事：编辑增强器Revit2011Revit2014©2013Autodesk故事：编辑增强器Revit2011Revit2014©2013Autodesk扩展存储ExtensibleStorage©2013Autodesk什么是扩展存储ESImagecourtesyofJayShuster可以通过编程的方式在Revit文档中存储任意数据支持简单数据类型，例如整形integer,双精度double,字符串string,elementid支持复合类型，例如lists和dictionaries可以替换原来利用共享参数来存储数据的老技术可以限制数据的读写操作©2013Autodesk扩展存储ES的特点ImagecourtesyofJayShuster使用方便面向对象的设计模式，Class类似的结构元数据可以根据VendorId和AppId来限制数据的读写内建支持ElementId，UV和XYZ点或者向量可以存储数据到任何elementSchema的定义就是一系列的fieldEntity里存放真正的数据，最终插入到Element里©2013Autodesk扩展存储ES和共享参数的比较ImagecourtesyofJayShuster单位高级自定义类型Element对象删除和工作集中Id的重映射。选择性的隐藏或者暴露数据。©2013Autodesk扩展存储ES：基础ImagecourtesyofJayShuster数据结构定义Schema和field面向对象的类型定义，或者数据表数据容器实例Entity面向对象的类型实例，或者数据行Autodesk.Revit.DB.ExtensibleStoragenamespace类型Schema，SchemaBuilder，Field，FieldBuilder，Entity©2013Autodesk扩展存储ES：数据类型ImagecourtesyofJayShusterbool,short,int,float,doubleStringGuidElementIdAutodesk.Revit.DB.UVAutodesk.Revit.DB.XYZArray–System.Collections.Generic.IListTMap–System.Collections.Generic.IDictionaryTKey,TValue,noreal-valuedkeyAutodesk.Revit.DB.ExtensibleStorage.Entity–aSchemainstanceorSubSchema©2013Autodesk扩展存储ES：Schema的定义ImagecourtesyofJayShusterSchemaBuilder的三个方法AddSimpleField(stringname,Type)AddArrayField(stringname,Type)AddMapField(stringname,TypekeyType,TypevalueType)返回一个FieldBuilder的实例FieldBuilder提供更多的方法来修饰一个FieldDocumentationUnits©2013Autodesk扩展存储ES：单位ImagecourtesyofJayShuster浮点类型的fields需要一个单位描述float,double,XYZ,UV和这些值的容器类型长度,温度，等内部支持单位转换例子:通过FieldBuilder.SetUnitType指定单位为长度UT_Length真正通过Entity.Set和Entity.Get函数设置或者获取数据时，可以指定单位为英尺DUT_DECIMAL_FEET©2013Autodesk扩展存储ES例子：XYZ点ImagecourtesyofJayShuster创建数据结构的定义,也就是创建schema和它的fields创建数据实例的容器也就是entity设置数据到实例的容器entity将数据注入到一个element里©2013Autodesk扩展存储ES例子：XYZ点ImagecourtesyofJayShuster©2013Autodesk列举所有的schemaImagecourtesyofJayShusterSchema类型的静态成员函数ListSchemas所有内存中注册了的schema都会被返回如果有以前的文档（即使现在关闭了）中的schema也会被包含其中只有schema本身被返回，具体应用到哪个文档，或者与文档相关的信息是没有包含的©2013Autodesk模型文档中的ESImagecourtesyofJayShuster检查给定的element是否包含了一个schema遍历所有的element，检查每个element是否包含一个schemaentity?示例代码：©2013Autodesk扩展存储ES例子：复杂数据ImagecourtesyofJayShuster使用SchemaBuilder的AddArrayField和AddMapField函数使用.NET类库中的泛型容器类型Array:IListTMap:IDictionaryTKey,TValue用对应容器生成具体的数据设置entity的值示例代码：©2013Autodesk移除模型中的扩展存储数据ImagecourtesyofJayShuster单个的entity:Element.DeleteEntityExampleusageinUpgradeSchema所有文档中整个schema:Schema.EraseSchemaAndAllEntities参数包括schema和overrideWriteAccessWithUserPermission©2013Autodesk在Revit的element中存一个文件ImagecourtesyofJayShuster定义一个schema，保存一个byte的数fieldBuilder=schemaBuilder.AddArrayField(Data,typeof(byte));将文件数据转化为byte流byte[]data=File.ReadAllBytes(filename);entity.SetIListbyte(schema.GetField(Data),data);©2013Autodesk从Revit的element中取出一个文件ImagecourtesyofJayShuster从schema的entity中取出byte流将byte流还原成文件Entityent=e.GetEntity(schema);stringfilepath=Path.Combine(ent.Getstring(schema.GetField(Folder)),ent.Getstring(schema.GetField(Filename)));byte[]data=ent.GetIListbyte(schema.GetField(Data)).ToArraybyte();File.WriteAllBytes(filepath,data);©2013Autodesk扩展存储element（2013）ImagecourtesyofJayShuster专门用于扩展存储的element在单独的element里有逻辑的组织ES的entities在共享工作集里，可以单独的更新数据而不需要锁住其他的elements©2013Autodesk写入DataStorageElementImagecourtesyofJayShuster创建DataStorage对象静态的创建函数创建entity设置数据代码示例：DataStoragemyElement=DataStorage.Create(doc);Entityentity=newEntity(mySchema);entity.Set(...);myElement.SetEntity(entity);©2013Autodesk读取DataStorageElementImagecourtesyofJayShuster从模型文档中取出DataStorageelement从DataStorageelement中取出entity从entity中取出数据ElementmyElement=newFilteredElementCollector(doc).OfClass(typeof(DataStorage)).FirstElement();Entityent=myElement.GetEntity(mySchema);varx=ent.Get...(...);©2013Autodesk识别你的DataStorageelementImagecourtesyofJayShuster你可以使用DataStorageelement单件其他插件的DataStorageelements利用DataStorageelement的UniqueId属性？利用schema的GUID属性?创建辅助标识的schema?©2013Autodesk模型动态更新DMU©2013Autodesk什么是动态模型更新DMUImagecourtesyofJayShuster它提供了在Revit外部利用插件扩展模型生成的技术它是在一个事务transaction提交前执行的Updaters不会在undone和redone的事务里执行不允许在Updater执行时调用注册和注销UpdaterUpdaters可以是非强制性的，没有也不会报错（所有的Updaters默认是强制性的）Revit会解决发生冲突的updaters，一般会移除一个，或多个Updaters提供了一些被修改的elements的信息添加，删除，和修改的element的id©2013Autodesk注册一个DMUImagecourtesyofJayShuster实现一个IUpdater接口的类型VoidExecute(UpdaterDatadata)UpdaterIdGetUpdaterId()StringGetUpdaterName()StringGetAdditionalInformation()ChangePriorityGetChangePriority()注册UpdaterApplication级别和Document级别设置触发器代码示例：©2013Autodesk在DMU中被禁止的操作ImagecourtesyofJayShuster禁止调用或者修改：需要一个transaction的方法（Export/Import）,或者必须在transaction外部调用的方法（Save&SaveAs）UI的方法（Picking，selections，etc）不能使用TransactionGroups，但是sub-transaction可以相互依赖的对象（可能导致