この例では、APEX Scriptを使用してノードタグおよびポートタグ付きのグラフを作成します:

1. APEX Script SOPで、 Snippet パラメータに以下のコードを追加します:

   # グラフを初期化します
   graph = ApexGraphHandle()
   
   # タグを作成します
   tags1: StringArray = ['abc', 'both']
   tags2: StringArray = ['t:abc', 'r:xyz', 'both']
   
   # 新しいグラフにTransformObjectノードを追加します
   graph.addNode('test1', 'TransformObject', tags=tags1)
   graph.addNode('test2', 'TransformObject', tags=tags2)
   
   # グラフをジオメトリとして書き出します
   geo = graph.writeToGeo()
   BindOutput(geo)
   

2. APEXネットワークビューでこのAPEX Scriptスニペットのグラフ表現を確認するには、 Visualizer セクションで Show を Component Script に設定します(ノードのレイアウトと色が分かりやすく変更されています):

   

3. このAPEX Scriptスニペットによって作成された新しいグラフを確認するには:

   • Bind Output Geometry を<output_node>:<output_port>に設定します(ここではoutput:geo)。

   • Visualizer セクションで、 Show を Output 1 に設定します。

   

4. Geometry Spreadsheetでタグを確認するには:

   • 新しいグラフはAPEX Script SOPの1番目の出力で利用可能です:

     

   • new_graphノードを選択します。

   • Geometry Spreadsheetで、上部のツールバーの Pointsを選択します:

     

この例では、graph::FindNodesおよびgraph::FindPortsでAPEXパスパターンのタグ関数を使用して、特定のタグ付きのノードおよびポートを検索します。

1. 前の例で作成したグラフを使用し、それを2つ目のAPEX Script SOPに入力します:

   

2. find_tags APEX Script SOPで、定義済みのヘッダを使用して、入力グラフを受け取って修正するAPEX Scriptコマンドを自動的に追加します:

   • Header パラメータをオンにします。

   • Header セクションで、 Template を Graph に設定します。すると、以下のコードがAPEX Scriptスニペットの先頭と末尾に追加されます:

     ヘッダ

     geo: Geometry = BindInput()
     graph = geo.loadFromGeo()
     

     フッタ

     geo = graph.writeToGeo()
     BindOutput(geo)
     

3. find_tagsノードの入力を指定します - Invocation セクションの Input1 Bindings で、 Bind To Geometry Parameter をオンにして、そのパラメータをgeoに設定します。geoは、APEX Script SOPに入力されるグラフジオメトリで、前の手順のヘッダで指定されています。

4. 入力グラフでタグを検索するには、以下のコードを Snippet パラメータに追加します:

   # 特定のタグを持つノードとポートを検索します
   abc_node_tag = graph.FindNodes('%tag(abc)')
   both_node_tag = graph.FindNodes('%tag(both)')
   xyz_port_tag = graph.FindPorts('%tag(xyz)')
   
   # 見つかったノードおよびポート名を出力のために配列に追加します
   both_nodes = StringArray()
   for n in both_node_tag:
       n_name = n.data()
       both_nodes.append(n_name)
   
   abc_nodes = StringArray()
   for n in abc_node_tag:
       n_name = n.data()
       abc_nodes.append(n_name)
   
   xyz_ports = StringArray()
   for p in xyz_port_tag:
       p_name = p.data()
       xyz_ports.append(p_name)
   
   # ノード配列およびポート配列を出力します
   BindOutput(abc_nodes, both_nodes, xyz_ports)
   

   Note

   ポートタグがグラフノード上にr:xyzとして格納されていても、graph.FindPorts()の使用時は、タグ関数内には(ポート名でなく)タグ名のみを指定します。 例えば、graph.FindPorts('%tag(r:xyz)') ではなく 、graph.FindPorts('%tag(xyz)')を使用します。

5. デフォルトで、APEX Script SOPの Invocation セクションにある Output Dictionary Bindings の最初のエントリは、以下のように設定されています:

   • Apex Outputs Group はoutputに設定されています。これは、グラフの出力ノードの名前です。

   • Output Attrib はparmsに設定されています。これは、ノード配列およびポート配列を格納する出力辞書の名前です。

6. 見つかったノードとポートをGeometry Spreadsheetで確認するには:

   • find_tagsノードを選択します。

   • Geometry Spreadsheetで、上部のツールバーの Detailを選択します。

   • parmsアトリビュートの Detail 列のエントリをクリックし、 Inspect を選択します:

     "abc_nodes":["test1"]
     
     "both_nodes":["test1","test2"]
     
     "xyz_ports":["test2"]
     

この例では、graph::UpdateNodeとgraph::UpdateNodeTagsを使用してグラフのタグを更新します:

1. 前の例で作成したグラフを使用し、それを2つ目のAPEX Script SOPに入力します:

   

2. update_tags APEX Script SOPで、定義済みのヘッダを使用して、入力グラフを受け取って変更するAPEX Scriptコマンドを自動的に追加します:

   • Header パラメータをオンにします。

   • Header セクションで、 Template を Graph に設定します。

3. update_tagsノードの入力を指定します - Invocation セクションの Input1 Bindings で、 Bind To Geometry Parameter をオンにして、そのパラメータをgeoに設定します。

4. 更新されたグラフを出力するには、 Bind Output Geometry をoutput:geoに設定します。

5. update_tagsノードは入力グラフを受け取り、それを変更せずに出力するようになりました。 グラフ出力を確認するには、 Visualizer セクションで Show を Output 1 に設定します。

6. 入力グラフノードでタグを更新するには、以下のコードを Snippet パラメータに追加します:

   new_tags1 = ['new_tag']
   new_tags2 = ['def', 'xform:xyz']
   
   node1 = graph.test1
   node2 = graph.test2
   
   # 既存のタグに追加します
   graph.UpdateNodeTags(nodeid=node1, tags=new_tags1)
   
   # 既存のタグを置き換えます
   graph.UpdateNode(nodeid=node2, tags=new_tags2)
   

7. APEXネットワークビューでAPEX Scriptスニペットのグラフ表現を確認します - Visualizer セクションで、 Show を Component Script に設定します(ノードのレイアウトと色が分かりやすく変更されています):

   

8. APEX Scriptスニペットで作成した新しいグラフを確認するには、 Visualizer セクションで Show を Output 1 に設定します: