カスタム複合モデルの作成 (コンポーネント）

カスタム複合モデル、またはコンソールを使用している場合はコンポーネントは、アセットモデルとコンポーネントモデルに別のレベルの組織を提供します。プロパティをグループ化するか、他のモデルを参照することで、モデルを構造化できます。カスタム複合モデルの使用の詳細については、「」を参照してくださいカスタム複合モデル (コンポーネント）。

既存のアセットモデルまたはコンポーネントモデル内にカスタム複合モデルを作成します。カスタム複合モデルには 2 つのタイプがあります。モデル内の関連プロパティをグループ化するには、インラインカスタム複合モデルを作成できます。アセットモデルまたはコンポーネントモデル内のコンポーネントモデルを参照するには、コンポーネントモデルベースのカスタム複合モデルを作成できます。

以下のセクションでは、 AWS IoT SiteWise API を使用してカスタム複合モデルを作成する方法について説明します。

インラインコンポーネントの作成 (コンソール）

AWS IoT SiteWise コンソールを使用して、独自のプロパティを定義するインラインコンポーネントを作成できます。

注記

これはインラインコンポーネントであるため、これらのプロパティは現在のアセットモデルにのみ適用され、他の場所では共有されません。

再利用可能なモデルを作成する必要がある場合 (複数のアセットモデル間で共有する場合や、1 つのアセットモデル内に複数のインスタンスを含める場合など）、代わりにコンポーネントモデルに基づいてコンポーネントを作成する必要があります。詳細については、次のセクションを参照してください。

コンポーネントを作成するには (コンソール）

1. AWS IoT SiteWise コンソールに移動します。

2. ナビゲーションペインで、[モデル] を選択します。

3. コンポーネントを追加するアセットモデルを選択します。

4. プロパティ タブで、コンポーネント を選択します。

5. [コンポーネントを作成] を選択します。

6. 「コンポーネントの作成」ページで、次の操作を行います。

   1. ServoMotor や など、コンポーネントの名前を入力しますServoMotor Model。この名前は、このリージョンのアカウント内のすべてのコンポーネントで一意である必要があります。

   2. (オプション) モデルの [属性定義] を追加します。属性は、ほとんど変化しない情報を表します。詳細については、「静的データ (属性) の定義」を参照してください。

   3. (オプション) モデルの [測定の定義] を追加します。測定値は、機器からのデータストリームを表します。詳細については、「機器からのデータストリームの定義 (測定値) 」を参照してください。

   4. (オプション) モデルの [定義を変換する] を追加します。変換とは、あるフォームから別のフォームにデータをマッピングするための数式です。詳細については、「データの変換 (変換) 」を参照してください。

   5. (オプション) モデルの [メトリクスの定義] を追加します。メトリクスとは、時間間隔でのデータを集計する数式です。メトリクスは、関連するアセットからデータを入力できるため、オペレーションまたはオペレーションのサブセットを表す値をコンピューティングすることができます。詳細については、「プロパティおよびその他のアセットのデータ (指標) の集計」を参照してください。

   6. [コンポーネントを作成] を選択します。

インラインカスタム複合モデルの作成 (AWS CLI）

AWS Command Line Interface （AWS CLI) を使用して、独自のプロパティを定義するインラインカスタム複合モデルを作成できます。

Model CreateAssetModelCompositeオペレーションを使用して、プロパティを含むインラインモデルを作成します。このオペレーションでは、次の構造を持つペイロードが必要です。

注記

これはインライン複合モデルであるため、これらのプロパティは現在のアセットモデルにのみ適用され、他の場所では共有されません。これが「インライン」になるのは、 composedAssetModelIdフィールドに値を提供しないということです。

再利用可能なモデルを作成する必要がある場合 (複数のアセットモデル間で共有する場合や、1 つのアセットモデル内に複数のインスタンスを含める場合など）、代わりにコンポーネントモデルベースの複合モデルを作成する必要があります。詳細については、次のセクションを参照してください。

{
    "assetModelCompositeModelName": "CNCLathe_ServoMotorA",
    "assetModelCompositeModelType": "CUSTOM",
    "assetModelCompositeModelProperties": [
        {
            "dataType": "DOUBLE",
            "name": "Servo Motor Temperature",
            "type": {
            "measurement": {}
            },
            "unit": "Celsius"
        },
        {
            "dataType": "DOUBLE",
            "name": "Spindle speed",
            "type": {
            "measurement": {}
            },
            "unit": "rpm"
        }
    ]
}

component-model-based コンポーネントの作成 (コンソール）

AWS IoT SiteWise コンソールを使用して、コンポーネントモデルに基づいてコンポーネントを作成できます。

component-model-based コンポーネントを作成するには (コンソール）

1. AWS IoT SiteWise コンソールに移動します。

2. ナビゲーションペインで、[モデル] を選択します。

3. コンポーネントを追加するアセットモデルを選択します。

4. プロパティ タブで、コンポーネント を選択します。

5. [コンポーネントを作成] を選択します。

6. 「コンポーネントの作成」ページで、次の操作を行います。

   1. コンポーネントの基礎となるコンポーネントモデルを選択します。

   2. ServoMotor や など、コンポーネントの名前を入力しますServoMotor Model。この名前は、このリージョンのアカウント内のすべてのコンポーネントで一意である必要があります。

   3. [コンポーネントを作成] を選択します。

component-model-based カスタム複合モデルの作成 (AWS CLI）

を使用して、アセットモデル内に component-model-based カスタム複合モデル AWS CLI を作成できます。 component-model-based カスタム複合モデルは、既に他の場所で定義したコンポーネントモデルへの参照です。

CreateAssetModelCompositeModel オペレーションを使用して、 component-model-based カスタム複合モデルを作成します。このオペレーションでは、次の構造を持つペイロードが必要です。

注記

この例では、 の値は、既存のコンポーネントモデルのアセットモデル ID または外部 ID composedAssetModelIdです。詳細については、AWS IoT SiteWise  ユーザーガイドの 外部 IDs を持つオブジェクトの参照を参照してください。コンポーネントモデルの作成方法の例については、「」を参照してくださいコンポーネントモデルの作成 (AWS CLI）。

{
    "assetModelCompositeModelName": "CNCLathe_ServoMotorA",
    "assetModelCompositeModelType": "CUSTOM",
    "composedAssetModelId": component model ID
]

これは単なるリファレンスであるため、 component-model-based カスタム複合モデルには名前以外の独自のプロパティはありません。

同じコンポーネントの複数のインスタンスをアセットモデル (例えば、複数のサーボモーターを持つ CNC マシン) に追加する場合は、それぞれに独自の名前があるが、すべて同じ を参照する複数の component-model-based カスタム複合モデルを追加できますcomposedAssetModelId。

コンポーネントは他のコンポーネント内にネストできます。そのためには、この例に示すように、 component-model-based 複合モデルをコンポーネントモデルの 1 つに追加できます。