內嵌自訂複合模型 Component-model-based自訂複合模型使用路徑來參考自訂複合模型屬性

自訂複合模型（元件）

當您建立特別複雜的工業資產模型時，例如具有許多部分的複雜機器，讓資產模型保持井然有序且可維護，可能會成為一項挑戰。

在這種情況下，如果您使用主控台，您可以將自訂複合模型或元件新增至現有的資產模型和元件模型。這些可協助您將相關屬性分組並重新使用子元件定義，以保持組織狀態。

自訂複合模型有兩種類型：

內嵌自訂複合模型會定義一組分組屬性，這些屬性會套用至自訂複合模型所屬的資產模型或元件模型。您可以使用它們來分組相關屬性。它們由名稱、描述和一組資產模型屬性組成。它們不可重複使用。
Component-model-based自訂複合模型參考了您想要包含在資產模型或元件模型中的元件模型。您可以使用它們在模型中包含標準子組件。它們由名稱、描述及其參考的元件模型 ID 組成。它們沒有自己的屬性；參考的元件模型會將其關聯的屬性提供給任何建立的資產。

以下各節說明如何在設計中使用自訂複合模型。

內嵌自訂複合模型

內嵌自訂複合模型提供透過分組相關屬性來組織資產模型的方法。

例如，假設您想要建立機器人資產的模型。機器人包含伺服馬達、電源和電池。每個元件都有自己的屬性，您想要包含在模型中。您可以定義名為 robot_model 的資產模型，其屬性如下。

robot_model
- servo_status （整數）
- servo_position （雙）
- powersupply_status （整數）
- powersupply_temperature （雙）
- battery_status （整數）
- battery_charge （雙）

不過，在某些情況下，可能有許多子組件，或者子組件本身可能有許多屬性。在這些情況下，可能會有太多屬性，使其難以在模型根目錄的單一平面清單中參考和維護，如上述範例所示。

若要處理這類情況，您可以使用內嵌自訂複合模型將屬性分組。內嵌自訂複合模型是一種自訂複合模型，可定義自己的屬性。例如，您可以如下所示建立機器人模型。

robot_model
- servo
  - status （整數）
  - position （雙）
- powersupply
  - status （整數）
  - temperature （雙）
- battery
  - status （整數）
  - charge （雙）

在上述範例中，servo、 powersupply和 battery是robot_model資產模型中定義的內嵌自訂複合模型名稱。然後，這些複合模型中的每個模型都會定義自己的屬性。

注意

在此情況下，每個自訂複合模型都會定義自己的屬性，因此所有屬性都是資產模型本身的一部分 (robot_model在此情況下）。這些屬性不會與任何其他資產模型或元件模型共用。例如，如果您建立的其他一些資產模型也具有稱為的內嵌自訂複合模型servo，則在 servo內變更robot_model不會影響其他資產模型servo的定義。

如果您想要實作這類共用（例如，只有一個伺服的定義，所有資產模型都可以共用），您可以改為為其建立元件模型，然後建立參考該模型的component-model-based複合模型。如需詳細資訊，請參閱下一節。

如需如何建立內嵌自訂複合模型的詳細資訊，請參閱建立自訂複合模型（元件）。

Component-model-based自訂複合模型

您可以在中建立元件模型， AWS IoT SiteWise 以定義標準的可重複使用子組件。建立元件模型後，您可以在其他資產模型和元件模型中為其新增參考。您可以透過將component-model-based自訂複合模型新增至您想要參考元件的任何模型來執行此操作。您可以從許多模型新增元件的參考，或在同一模型內多次新增參考。

如此一來，您可以避免在模型之間複製相同的定義。它還簡化了維護模型，因為您對元件模型所做的任何變更都會反映在使用該模型的所有資產模型中。

例如，假設您的工業安裝有許多類型的設備，全都使用相同類型的伺服馬達。其中有些在單一設備中有許多伺服馬達。您可以為每個設備類型建立資產模型，但不想servo每次都重複的定義。您想要將其建模一次，並在各種資產模型中使用。如果您稍後變更的定義servo，則會在所有模型和資產中更新。

若要以這種方式建立上一個範例中的機器人模型，您可以將伺服馬達、電源和電池定義為元件模型，如下所示。

servo_component_model
- status （整數）
- position （雙）

powersupply_component_model
- status （整數）
- temperature （雙）

battery__component_model
- status （整數）
- charge （雙）

然後，您可以定義參考這些元件的資產模型robot_model，例如。多個資產模型可以參考相同的元件模型。您也可以在一個資產模型中多次參考相同的元件模型，例如，如果機器人在其中有多個伺服馬達。

robot_model
- servo1 (參考：servo_component_model)
- servo2 (參考：servo_component_model)
- servo3 (參考：servo_component_model)
- powersupply (參考：powersupply_component_model)
- battery (參考：battery_component_model)

如需如何建立元件模型的詳細資訊，請參閱建立元件模型。

如需有關如何在其他模型中參考元件模型的資訊，請參閱建立自訂複合模型（元件）。

使用路徑來參考自訂複合模型屬性

當您在資產模型、元件模型或自訂複合模型上建立屬性時，您可以從其他使用其值的屬性參考它，例如轉換和指標。

AWS IoT SiteWise 提供不同的方法來參考您的屬性。最簡單的方式通常是使用其屬性 ID。不過，如果您要參考的屬性位於自訂複合模型上，您可能會發現反之，透過路徑參考它會更有用。

路徑是路徑區段的排序序列，根據其在資產模型和複合模型中巢狀複合模型之間的位置指定屬性。

取得屬性路徑

您可以從其 AssetModelProperty 的 path 欄位取得屬性的路徑。

例如，假設您的資產模型robot_model包含自訂複合模型 servo，而該模型具有屬性 position。如果您在上呼叫 DescribeAssetModelCompositeModelservo，則 position 屬性會列出如下所示path的欄位：


"path": [
    {
       "id": "asset model ID",
       "name": "robot_model"
    },
    {
       "id": "composite model ID",
       "name": "servo"
    },
    {
       "id": "property ID",
       "name": "position"
    }
]

使用屬性路徑

當您定義參考其他屬性的屬性時，可以使用屬性路徑，例如轉換或指標。

屬性會使用變數來參考另一個屬性。如需使用變數的詳細資訊，請參閱在公式表達式中使用變數。

當您定義變數以參考屬性時，您可以使用屬性的 ID 或其路徑。

若要定義使用參考屬性路徑的變數，請指定其值propertyPath的欄位。

例如，若要定義具有指標的資產模型，該指標使用路徑來參考屬性，您可以像這樣將承載傳遞給 CreateAssetModel：


{
    ...
    "assetModelProperties": [
        {
            ...
            "type": {
                "metric": {
                    ...
                    "variables": [
                        {
                            "name": "variable name",
                            "value": {
                                "propertyPath": [
                                    path segments
                                ]
                            }
                        }
                    ],
                    ...
                }
            },
            ...
        },
        ...
    ],
    ...
}

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

資產模型版本

設定物件 IDs

自訂複合模型 （元件）

主題