IoT Platform コンソールでは、Thing Specification Language（TSL）モデルをインポートして、複数のプロパティ、イベント、およびサービスを追加できます。TSL モデルをインポートするには、TSL JSON ファイルをアップロードするか、別のプロダクトの TSL モデルを現在のプロダクトにコピーします。このトピックでは、TSL モデルをインポートして一度に複数の TSL 機能を追加する方法について説明します。
前提条件
プロダクトが作成されていること。詳細については、「プロダクトの作成」をご参照ください。
使用上の注意
新しい TSL モデルをインポートすると、プロダクトの以前に定義された機能は上書きされます。このコマンドを実行する際は注意してください。
ゲートウェイ サブデバイス プロダクトのゲートウェイ接続プロトコルが Modbus、OPC UA、ZigBee、または BLE の場合、プロダクトの TSL モデルをインポートすることはできません。
プロダクトが公開されている場合、プロダクトの TSL 機能を追加または変更することはできません。TSL 機能を追加または変更するには、プロダクトを非公開にする必要があります。
別のプロダクトの TSL モデルをインポートする場合、プロダクトに指定されている [カテゴリ] パラメーターの値は同じである必要があります。
TSL 機能の追加
IoT Platform コンソール にログインします。
IoT Platform コンソールの左上隅で、IoT Platform がアクティブ化されているリージョンを選択します。
[すべての環境] タブの [概要] ページで、管理するインスタンスを見つけ、インスタンス [ID] またはインスタンス名をクリックします。
左側のナビゲーションウィンドウで、 [プロダクト] を選択します。
[プロダクト] ページで、機能を追加するプロダクトを見つけ、表示[アクション] 列の をクリックします。
[製品詳細] ページで、[機能の定義] タブをクリックし、次に [ドラフトの編集] をクリックします。
[インポート] をクリックします。表示されるダイアログボックスで、TSL モデルをインポートします。
以下の方法がサポートされています。
[プロダクトのコピー] タブで、ソースプロダクトと TSL モデルバージョンを選択し、[OK] をクリックします。
選択した TSL モデルバージョンのデフォルトモジュールとカスタムモジュールがソースプロダクトからインポートされます。[機能の定義] タブで、[ドラフトの編集] をクリックします。表示されるページで、管理する TSL 機能を見つけ、[編集] をクリックして機能を変更します。
[TSL のインポート] タブで、JSON ファイルまたは複数の JSON ファイルを含む ZIP パッケージをアップロードします。
TSL ファイルの変更およびパッケージ化方法については、「TSL モデルとは」をご参照ください。
説明ファイルが要件を満たしていない場合、IoT Platform にファイルをアップロードすると、検証に失敗したことを示すプロンプトが表示されます。プロンプトに従ってファイルを確認し、変更します。その後、ファイルを再アップロードします。問題のトラブルシューティング方法の詳細については、「TSL モデルファイルをインポートするときに検証に失敗した場合はどうすればよいですか？」をご参照ください。
TSL モデルの公開
TSL モデルは、公開された後にのみ有効になります。
[機能の定義] > [ドラフトの編集] を選択します。表示されるページの左下隅にある [オンラインでリリース] をクリックします。[モデルをオンラインでリリースしますか？] ダイアログボックスが表示されます。
オプション。 [+投稿ノートを追加] をクリックし、バージョン番号とノートを入力します。
パラメーター
説明
バージョン番号
TSL モデルのバージョン番号。バージョン番号に基づいて TSL モデルを管理できます。
バージョン番号は 1 ～ 16 文字で、文字、数字、およびピリオド（.）を含めることができます。
ノート
TSL モデルの説明。説明には、文字、数字、および特殊文字を含めることができます。説明は 1 ～ 100 文字である必要があります。
オンラインバージョンが利用可能な場合、リリースする現在のバージョンとオンラインバージョンの違いを確認する必要があります。
[差分を表示] をクリックします。[差分を表示] パネルで、バージョン間の差分を表示できます。設定を確認した後、[確認] をクリックします。[モデルをオンラインでリリースしますか？] ダイアログボックスで、チェックボックスが自動的に選択されます。
バージョン間の差分を表示したくない場合は、「現在のバージョンとオンラインバージョンの差分を確認済みであることを確認してください。」を選択します。
[OK] をクリックして、TSL モデルを公開します。
実行結果
TSL モデルを公開した後、公開されたモデルを IoT Platform コンソールで表示できます。[プロダクト詳細] ページの [機能の定義] タブで、次の操作を実行できます。
[TSL モデル] をクリックして、JSON 形式の TSL モデルを表示します。
関連 API 操作
API | 説明 |
プロダクトの TSL モデルの機能または拡張情報を変更します。 | |
プロダクトの TSL モデルの詳細をクエリします。 | |
プロダクトの TSL モデルを宛先プロダクトにコピーします。 | |
プロダクトの TSL モデルを公開します。 | |
TSL モデルをプロダクトにインポートします。拡張情報はインポートできません。 | |
公開されたプロダクトの TSL モデルの詳細をクエリします。 |
次のステップ
デフォルトでは、プロダクトのデバイスによって送信された TSL データは、ホット データストレージ スペースに自動的に書き込まれます。ビジネス要件に基づいて、一部またはすべての TSL モデルのホット データストレージ サービスを停止できます。