Zero Touch Node(ZTN)とは

Dyanamoでは、洗練されたビジュアルプログラミングを楽しむことができるのですが、スクリプト環境についていうと、DesignScriptというDSLや、Iron Pythonが使えるのみで、事前に用意されたライブラリ以外は使うことができません。Autodesk Revitと連携させて形状を作るするだけであれば問題ありませんが、システム連携などを考慮すると貧弱に感じます。
Dynamoでは、Zero Touch Node(ZTN)と呼ばれるカスタムノードを開発することが可能です。ちょうどRevitでアドインを開発するように、C#で作ったDLLをDynamoに取り込むことができます。ついでに一般的にはPython Scriptで書くより速いようです。公式のドキュメントはここです。

しかし、関連ドキュメント少なすぎやしませんか、、、

準備

プロジェクト新規作成

Visual Studio Community 2017を使って開発します。新しいプロジェクト（クラスライブラリ .NET Framework）を選択します。.NET Framworkのバージョンは4.8としました。
次にNuGetパッケージマネージャーを使って、以下のようにDynamoの開発に必要なライブラリをインポートします。DyanamoVisualProgramming.ZeroTouchLibraryだけで大丈夫です。

DynamoServices、DynamoUnits、PhotoGeometryの3つが追加されています。これらをプロパティを選択して、「ローカルにコピー」をFalseにすると不要なパッケージがパッケージに含まれるのを防ぐことができるそうです。

デバッグ環境の整備

開発したZTNをデバッグするためには、毎回出力したDLLを手動でDynamoに読み込ませる必要があります。面倒なので、Visual Studioから起動できるようにしておきます。以下の手順で行います。

パッケージ情報(pkg.json)の作成
ビルド後に必要ファイルを自動コピーするように設定
デバッグ用の外部アプリケーションを指定

pkg.jsonは作成したカスタムノードのメタデータを記述するファイルです。Dynamoで自分でカスタムノードを作る場合は、自動生成されるものです。具体的には、以下のように記述します。

pkg.json

{
  "license": "",
  "file_hash": null,
  "name": "HelloWorldZeroTouch",
  "version": "1.0.0",
  "description": "Hello world for ZeroTouchNode",
  "group": "",
  "keywords": null,
  "dependencies": [],
  "contents": "",
  "engine_version": "1.0.0",
  "engine": "dynamo",
  "engine_metadata": "",
  "site_url": "",
  "repository_url": "",
  "contains_binaries": true,
  "node_libraries": [
    "HelloWorldZeroTouch, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null"
  ]
}

続いて、ビルドした後のdllなどをDynamoが起動時に読み込むフォルダに自動配置するようにします。自動的に読み込むフォルダは、使っているDynamoによって違います。Dynamoメニューの設定 -> ノードとパッケージのパスを管理で当該フォルダを確認してください。プロジェクトのプロパティ -> ビルドイベント -> ビルド後イベントのコマンドラインに以下を入力します。以下は、Dynamo Revit 2.0の場合の設定例です。

xcopy /Y "$(TargetDir)*.*" "$(AppData)\Dynamo\Dynamo Revit\2.0\packages\$(ProjectName)\bin\"
xcopy /Y "$(ProjectDir)pkg.json" "$(AppData)\Dynamo\Dynamo Revit\2.0\packages\$(ProjectName)"
xcopy /Y "$(ProjectDir)HelloWorldZeroTouch_DynamoCustomization.xml" "$(AppData)\Dynamo\Dynamo Revit\2.0\packages\$(ProjectName)\bin"

次に、同じくプロジェクトのプロパティから、デバッグ -> 外部プログラムの開始(X)にC:\Program Files\Autodesk\Revit 2019\Revit.exeと入力します。デバッグに利用するプログラムのパスを書き込むわけですが、ここも環境によって適宜変更してください。

開発

エントリポイントの開発

ここでようやくZTN開発ということですが、特に難しいことはなくて、public staticなメソッドを定義すればいいだけです。メソッド引数がノードへの入力になります。例えば以下の例では、Nameという文字入力をとって、固定文字を追加して出力とします。

HelloDynamo.cs

namespace HelloWorldZeroTouch
{
    public class HelloDynamo
    {
        public static string SayHello(string Name)
        {
            return "Hello " + Name + "!";
        }
    }
}

出力を複数にしたい場合は、Dictionaryをreturnすればよい。この辺はサンプルコードがいくつかあるので、そこから学ぶのが良いと思います。Nodeの中にGUIを作れたりして、実にいろんな拡張が可能です。

ちなみに、Dynamo 2.0で追加になったDictionary型を使うためには、System.Collections.IDictionaryを使います。

ノードの名称

上記のままでも使えるのですが、Dynamoに表示される名称の階層が深くてかっこ悪いです。これはアセンブリ名とC#のNamespaceから自動生成されています。これを変更する手段としては、パッケージフォルダ内にbin/アセンブリ名_DynamoCustomization.xmlというファイルを設置することで実現できます。このファイルのコピーもビルド時の挙動に組み込んでおくとよいでしょう。今回の場合は、HelloWorldZeroTouch_DynamoCustomization.xmlですね。

HelloWorldZeroTouch_DynamoCustomization.xml

<?xml version="1.0"?>
<doc>
  <assembly>
    <name>HelloWorldZeroTouch</name>
  </assembly>
  <namespaces>
    <namespace name="HelloWorldZeroTouch">
      <category>HelloWorld</category>
    </namespace>
  </namespaces>
</doc>

そうすると以下のように読み込まれるのが確認できます。

参考