Dynamo批量修改多文件项目基点参数
Hello大家好！我是九哥~
前几天群里有个小伙伴，咨询了我一个问题：如何批量修改多个Revit文件的项目基点？
本来是想帮忙改改程序，奈何打开以后，我看到了无数的节点和连线，而且这个问题，主要是因为Transaction的问题，代码应该更容易一些~
那么我们就来一起解决下这个，本次教程呢，主要是讲解如何完全通过代码来解决这个事，最后你会发现，用代码解决这个事，就会变得超级简单了~
一、获取Revit项目文件
第一步比较简单，用自带的几个节点一连就好，如下图，我这里为了便于多次测试，把带“000”的文件过滤了一下：
二、后台打开Revit文件
我们打开API手册，搜索Application，能够找到如下三种方法，我们选择按路径和选项打开文件：
大意呢，就是需要一个模型路径和打开选项，我们分别看下。
（1）字符串路径转换为ModelPath
首先我们需要将字符串的文件路径转化为ModelPath，在API手册里搜索ModelPathUtils，就能找到相关的转换方法，我们选择
ConvertUserVisiblePathToModelPath()方法：
基本代码如下：
#获取文件路径，并后台打开文件，获取documentmodelPath = ModelPathUtils.ConvertUserVisiblePathToModelPath(i)d = app.OpenDocumentFile(modelPath, options)
（2）打开选项
在第二步的Application方法下，直接点击OpenOptions即可跳转相关页面：
这里重点关注下面这个选项，是否分离中心文件：
继续点进去，可以看到
DetachFromCentralOption的枚举：
这里我就简单选择第二个，打开并分离中心文件，实际按需选择即可。代码如下：
#打开文件的选项options = OpenOptions()options.DetachFromCentralOption = DetachFromCentralOption.DetachAndPreserveWorksets
三、获取项目基点
这里用到 System.Enum.ToObject方法，大家记住即可，就不过多讲解了，用此方法将输入的Category转换为BuiltInCategory。
然后就可以用过滤器，过滤出所需的图元了，代码如下：
#将Category转换为BuiltInCategory，并获取项目基点bic = System.Enum.ToObject(BuiltInCategory, cat.Id)element = FilteredElementCollector(d).WhereElementIsNotElementType().OfCategory(bic).ToElements()[0]
四、开启和关闭时事务
由于我们要更改项目基点的参数，开启事务是必须的，很多小伙伴都会用网上万能模板里提供的Dynamo开启和关闭事务方法，这里呢，我就直接调用API的方法了，可以参考之前的文章《如何让撤销栏显示Dynamo的具体操作内容》，介绍了Transaction相关内容。
#尝试开启事务t = Transaction(d,'设置项目基点参数')t.Start()#关闭事务t.Commit()
五、解锁和锁定项目基点
大多数情况下，Revit默认的项目基点都是锁定状态的，这样如果我们用Dynamo设置项目基点参数，是无法完成的，会提示你图元被锁定。
在API手册中直接搜索Pinned就能找到图元锁定的方法，可get可set，如下图：
那么我们就可以先解除锁定，在设置完参数以后再给他锁上，代码如下：
#解锁项目基点element.Pinned = False#锁定项目基点element.Pinned = True
六、设置项目基点参数
这里呢，我也就简单写了，直接采用LookupParameter的方法，毕竟也不涉及多语言版本等问题，就是演示下思路，只需要写一个循环即可，代码如下：
#循环参数名称，并设置项目基点参数r = []for p,v in zip(parameter_names,values):data = element.LookupParameter(p).Set(v)
七、关闭和保存
直接在API手册里搜索Document，就能看到Close的方法，如下图：
到这里我们的程序基本就完成了，如果你想让程序更完美，可以再加一个try...except...，来更好的输出错误报告，代码如下：
#返回错误报告import tracebackerrorReport = traceback.format_exc()
这样我们本次教程的代码就写完了，最后附上完整的代码和节点截图，如下：
import clrfrom System.Collections.Generic import *import Systemclr.AddReference('RevitServices')import RevitServicesfrom RevitServices.Persistence import DocumentManagerfrom RevitServices.Transactions import TransactionManagerclr.AddReference('RevitAPI')import Autodeskfrom Autodesk.Revit.DB import *doc = DocumentManager.Instance.CurrentDBDocumentapp = doc.Applicationdef tolist(x):if hasattr(x,'__iter__'): return xelse : return [x]filePath = tolist(IN[0])cat= IN[1]parameter_names = tolist(IN[2])values = tolist(IN[3])#打开文件的选项options = OpenOptions()= DetachFromCentralOption.DetachAndPreserveWorksetsdocOnDisk = []items = []result = []for i in filePath:#获取文件路径，并后台打开文件，获取documentmodelPath = ModelPathUtils.ConvertUserVisiblePathToModelPath(i)d = app.OpenDocumentFile(modelPath, options)#将Category转换为BuiltInCategory，并获取项目基点bic = System.Enum.ToObject(BuiltInCategory, cat.Id)element = FilteredElementCollector(d).WhereElementIsNotElementType().OfCategory(bic).ToElements()[0]try:#尝试开启事务t = Transaction(d,'设置项目基点参数')t.Start()#解锁项目基点= False#循环参数名称，并设置项目基点参数r = []for p,v in zip(parameter_names,values):data = element.LookupParameter(p).Set(v)#每设置成功一次，记录一个Truer.append(data)#锁定项目基点= True#关闭事务result.append(r)except:#返回错误报告import tracebackerrorReport = traceback.format_exc()result.append(errorReport)#关闭并保存文件d.Close(True)#输出运行结果OUT = result
tips：
注意，由于我这里用的LookupParameter方法设置的参数，所以就涉及Revit内部单位问题，这里我就没做处理，直接用Dynamo的单位转换节点了，如下图：
好了，今天的教程就到这里了，小伙伴们快去尝试吧~
入群或者购买教程的小伙伴，可以扫描下面的二维码，加我微信哈~
九哥的知识店铺