프로젝트마다 공유 매개변수를 손으로 만들다 보면 이름이 한 글자씩 달라지거나 바인딩할 카테고리를 빠뜨리는 일이 생긴다. Revit API로 이 과정을 자동화할 수 있다. 순서는 크게 4단계다. Application의 OpenSharedParameterFile로 공유 매개변수 파일을 열고, DefinitionGroups에서 그룹을 찾거나 새로 만든 뒤 ExternalDefinitionCreationOptions로 정의를 생성한다. 그다음 CategorySet에 바인딩할 카테고리를 담고, 인스턴스 매개변수면 InstanceBinding을, 타입 매개변수면 TypeBinding을 만들어 Document의 ParameterBindings에 Insert한다. 이 작업은 문서를 수정하므로 반드시 Transaction 안에서 실행해야 한다. 공유 매개변수 파일 경로가 지정돼 있지 않으면 OpenSharedParameterFile이 널을 돌려주므로 SharedParametersFilename을 먼저 확인하는 방어 코드가 필요하다.

■ 눈여겨볼 것

공유 매개변수의 실제 식별자는 이름이 아니라 GUID다. 이름이 같아도 GUID가 다르면 Revit은 다른 매개변수로 취급하고, 그 순간 일람표와 필터가 조용히 어긋난다. 그래서 회사 표준 공유 매개변수 파일은 한 곳에 두고 버전 관리를 해야 한다. 각자 로컬에서 만든 파일로 작업하면 프로젝트를 합칠 때 같은 이름의 매개변수가 두 벌 생긴다. 자동화 스크립트를 만들 때도 매개변수를 새로 만들기 전에 같은 이름이 이미 바인딩돼 있는지 확인하는 절차를 넣어 두는 편이 안전하다.

■ 이런 분께 도움이 됩니다

• Revit API를 시작하는 개발자·BIM 엔지니어 — 바인딩은 API 입문에서 가장 자주 막히는 지점이다
• 사무소 BIM 표준 담당자 — 매개변수 세트를 프로젝트마다 자동으로 심을 수 있다
• 물량·일람표를 다루는 실무자 — 일람표가 어긋나는 원인의 상당수가 매개변수 중복이다
• 건축 전공 학생 — BIM 데이터 구조를 코드 수준에서 이해하는 출발점이 된다

■ 참고

패밀리 안에서 만든 패밀리 매개변수는 프로젝트 일람표에 나오지 않는다. 일람표에 넣으려면 공유 매개변수로 만들어야 한다는 점이 처음 쓰는 사람이 가장 자주 걸리는 부분이다.

참고 자료: Revit API Docs · 본문과 이미지는 아키포털에서 직접 작성·제작했습니다.