コネクタ クラスのプロパティ

コネクタ クラスのプロパティ

    コネクタ クラスのプロパティの定義

    新規アセットのコネクタ クラスのプロパティを定義するには、以下の手順に従います。

    1. リボンで、 [アセット ビルダー]タブ [作者]パネル [コネクタ クラスのプロパティ]の順にクリックします。[コネクタ クラスのプロパティ]ダイアログ ボックスが表示されます。
    2. [コネクタ クラスのファイル名]ドロップダウン リストから必要なコネクタ クラスを選択します。このリストには、システムアセットおよびクラウド アセット コレクションの両方にあるすべてのコネクタ クラスが表示されます。リストからコネクタ クラス名を削除するには、ドロップダウン リストの右にあるボタンをクリックします。
    3. 次に、コネクタ クラスのプロパティを割り当てます。[名前]ドロップダウン リストから必要なプロパティを選択し、[値]ドロップダウン リストから必要なプロパティ値を選択します。
    4. [OK]ボタンをクリックして、コネクタ クラスのプロパティを設定し、ダイアログ ボックスを閉じます。

    カスタム コネクタ クラスの作成

    製品で提供されるコネクタ クラスを超える接続動作を必要とする新規アセットタイプのカスタム コネクタ クラスを設定できます。次にこれらを使用して、クラスに割り当てられたアセット間でパラメータ伝播をコントロールできます。

    コネクタ クラスは XML ファイルによって、拡張子 .connectorclass を使用して定義されます。コネクタ クラスの要素によって、パラメータ マッピングが定義され、特定のマッピングが行われる条件のコントロールに使用される条件チェックが定義されます。

    コネクタ クラス XML ファイルの構造は簡単です。簡単なコネクタ クラス ファイルの例をここに示します。要素の説明は次のとおりです。

    <connector>

    <ConveyorWidth value_source="parameter">Width</ConveyorWidth> <ConveyorHeight family_type="normal"

    value_source="parameter">Height</ConveyorHeight> <ConveyorHeight family_type="inclined" connector_name="Connector1"

    value_source="Parameter">UpperHeight</ConveyorHeight> <ConveyorHeight family_type="inclined" connector_name="Connector2"

    value_source="Parameter">LowerHeight</ConveyorHeight> <ConveyorHeight family_type="spiral" connector_name="UpperConnector"

    value_source="Parameter">UpperHeight</ConveyorHeight> <ConveyorHeight family_type="spiral" connector_name="LowerConnector"

    value_source="Parameter">LowerHeight</ConveyorHeight>

    </connector>

    コネクタ クラス ファイルは常に connector という名前のルート要素を使用します。この要素には、接続され、同じコネクタ クラスに属するとアセット間で増加するパラメータを識別する一連の子要素が含まれます。

    この子要素はマッピング グループを定義します。これらの子要素は任意の名前を付けることができ、次の規則に従って、使用されます。

    • 特定のパラメータを表す各マッピング グループは、一意の要素名を持つ必要があります。上の例では、「ConveyorWidth」と「ConveyorHeight」は 2 つのマッピング グループを表しています。
    • 所定のアセットで、一致規則を満たすパラメータの一致が見つかると、現在のマッピング グループのテストが終わり、次のマッピング グループが処理されます。このため、マッピング グループ要素は優先順(優先順位が最も高いものから最も低いものへの順)で指定する必要があります。

    これらの要素の値は通常、マッピングされるパラメータ名(たとえば、上の例では「Width」)を示します。2 つのアセットがこの名前と一致するパラメータを提供する必要があり、そうでない場合、マッピングは実行されません。

    これらの要素の属性は、マッピング操作をコントロールする追加の情報を提供します。次の表に、これらの属性の説明を示します。

    プロパティ 属性値 [コメント]
    value_source パラメータ(既定値) ソース アセット内で識別されたパラメータによって、マッピングに提供される値を指定します。
      定数 割り当てられる値が value 属性で提供される定数値であることを指定します。
      この属性は、value_sourceConstant に設定されているときにパラメータに使用される値を提供します。
    connector_name   この属性は、特定のコネクタ(名前別)への一致を制限するために使用されます。アセットで接続に使用されているコネクタがこの名前と一致しない場合、マッピングは無視されます。

    上に予約された属性の他に、一致条件を定義する追加の属性を指定できます。属性名(たとえば、上の例では「family_type」)は、コネクタ クラスのプロパティを識別します。一致を簡単にするために、アセット内でこれらのプロパティの値を指定する必要があります([コネクタ クラスのプロパティ]ダイアログ ボックスを使用)。アセットが一致するコネクタ クラス プロパティを提供しない場合、マッピングは無視されます。

    ヒント: 完全に新しい XML ファイルを作成するのではなく、既存のファイルの 1 つを C:¥ProgramData¥Autodesk¥Factory Design Suite(バージョン)¥FactoryLibrary フォルダからコピーします。ファイルに新しい名前を付けて、既存のパラメータをユーザ独自のパラメータに置き換えます。必ず不要な要素を削除してください。