カスタム複合モデル (Components) の作成 - AWS IoT SiteWise

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

カスタム複合モデル (Components) の作成

カスタム複合モデル (コンソールを使用している場合はコンポーネント) を使うと、資産モデルとコンポーネントモデルを別のレベルで整理できます。これらを使用して、プロパティをグループ化したり、他のモデルを参照したりして、モデルを構成できます。カスタム複合モデルの使用方法の詳細については、を参照してください。カスタム複合モデル (コンポーネント)

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

以下のセクションでは、 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) を使用して、独自のプロパティを定義するインラインカスタム複合モデルを作成できます。

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 コンポーネント (コンソール) を作成するには
  1. AWS IoT SiteWise コンソールに移動します。

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

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

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

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

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

    1. コンポーネントのベースにするコンポーネントモデルを選択します。

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

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

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

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

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

注記

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

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

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

アセットモデルに同じコンポーネントの複数のインスタンスを追加したい場合 (たとえば、複数のサーボモーターを搭載した CNC マシン)、それぞれに独自の名前が付けられていて、 component-model-based すべて同じものを参照する複数のカスタム複合モデルを追加できますcomposedAssetModelId

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