翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
カスタム複合モデル (コンポーネント) を作成する
カスタム複合モデル、またはコンソールを使用している場合はコンポーネントは、アセットモデルとコンポーネントモデルに別のレベルの組織を提供します。プロパティをグループ化するか、他のモデルを参照することで、モデルを構造化できます。カスタム複合モデルの使用の詳細については、「」を参照してくださいカスタム複合モデル (コンポーネント)。
既存のアセットモデルまたはコンポーネントモデル内にカスタム複合モデルを作成します。カスタム複合モデルには 2 つのタイプがあります。モデル内の関連プロパティをグループ化するには、インラインカスタム複合モデルを作成できます。アセットモデルまたはコンポーネントモデル内のコンポーネントモデルを参照するには、component-model-basedカスタム複合モデルを作成できます。
以下のセクションでは、 を使用して AWS IoT SiteWise APIカスタム複合モデルを作成する方法について説明します。
トピック
インラインコンポーネントを作成する (コンソール)
AWS IoT SiteWise コンソールを使用して、独自のプロパティを定義するインラインコンポーネントを作成できます。
注記
これはインラインコンポーネントであるため、これらのプロパティは現在のアセットモデルにのみ適用され、他の場所では共有されません。
再利用可能なモデルを作成する必要がある場合 (例えば、複数のアセットモデル間で共有したり、1 つのアセットモデル内に複数のインスタンスを含めたりする場合)、代わりにコンポーネントモデルに基づいてコンポーネントを作成する必要があります。詳細については、次のセクションを参照してください。
コンポーネントを作成するには (コンソール)
AWS IoT SiteWise コンソール
に移動します。 ナビゲーションペインで、[モデル] を選択します。
-
コンポーネントを追加するアセットモデルを選択します。
-
プロパティ タブで、コンポーネント を選択します。
-
[コンポーネントを作成] を選択します。
-
「コンポーネントの作成」ページで、次の操作を行います。
-
ServoMotor
や など、コンポーネントの名前を入力しますServoMotor Model
。この名前は、このリージョンのアカウント内のすべてのコンポーネントで一意である必要があります。 -
(オプション) モデルの [属性定義] を追加します。属性は、ほとんど変化しない情報を表します。詳細については、「静的データ (属性) を定義する」を参照してください。
-
(オプション) モデルの [測定の定義] を追加します。測定値は、機器からのデータストリームを表します。詳細については、「機器からのデータストリームを定義する (測定)」を参照してください。
-
(オプション) モデルの [定義を変換する] を追加します。変換とは、あるフォームから別のフォームにデータをマッピングするための数式です。詳細については、「変換データ (変換)」を参照してください。
-
(オプション) モデルの [メトリクスの定義] を追加します。メトリクスとは、時間間隔でのデータを集計する数式です。メトリクスは、関連するアセットからデータを入力できるため、オペレーションまたはオペレーションのサブセットを表す値をコンピューティングすることができます。詳細については、「プロパティやその他のアセット (メトリクス) からのデータを集約する」を参照してください。
-
[コンポーネントを作成] を選択します。
-
インラインカスタム複合モデルを作成する (AWS CLI)
AWS Command Line Interface (AWS CLI) を使用して、独自のプロパティを定義するインラインカスタム複合モデルを作成できます。
CreateAssetModelCompositeModel オペレーションを使用して、プロパティを含むインラインモデルを作成します。このオペレーションでは、次の構造を持つペイロードが必要です。
注記
これはインライン複合モデルであるため、これらのプロパティは現在のアセットモデルにのみ適用され、他の場所では共有されません。これが「インライン」になるのは、 composedAssetModelId
フィールドに値を提供していないことです。
再利用可能なモデルを作成する必要がある場合 (複数のアセットモデル間で共有する場合や、1 つのアセットモデル内に複数のインスタンスを含める場合など)、代わりにcomponent-model-based複合モデルを作成する必要があります。詳細については、次のセクションを参照してください。
{ "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 コンポーネントを作成するには (コンソール)
AWS IoT SiteWise コンソール
に移動します。 ナビゲーションペインで、[モデル] を選択します。
-
コンポーネントを追加するアセットモデルを選択します。
-
プロパティ タブで、コンポーネント を選択します。
-
[コンポーネントを作成] を選択します。
-
「コンポーネントの作成」ページで、次の操作を行います。
-
コンポーネントに基づくコンポーネントモデルを選択します。
-
ServoMotor
や など、コンポーネントの名前を入力しますServoMotor Model
。この名前は、このリージョンのアカウント内のすべてのコンポーネントで一意である必要があります。 -
[コンポーネントを作成] を選択します。
-
カスタム複合モデルを作成する 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 つに追加できます。