デバイス管理

概要

以下のセクションでは、デバイス管理アプリケーションのすべての機能について詳しく説明します。このドキュメントの内容の概要については、以下を参照してください。

ホーム ダッシュボード

デバイス管理アプリケーションのホーム画面は、テナントのデータを表示するダッシュボードです。

ホームダッシュボードに表示されるデータは、テナントのすべてのユーザーが共有します。デフォルトでは、ホームダッシュボードには最近のアラームとクイックリンクが表示されます。 ホームダッシュボードは、ニーズに応じて個別に編集およびデザインできます。表示されるウィジェットを追加、削除、変更することができます。

ダッシュボードの編集の詳細については、コックピット > ダッシュボードの操作をご覧ください。 デバイス管理アプリケーションのダッシュボードは、コックピットのダッシュボードと同様に機能します。

ホームダッシュボードをデフォルトに戻すには、上部メニューバーの右にある ダッシュボードのリセット をクリックします。

デバイスの接続

デバイスの登録

デバイス登録画面では、現在登録処理中のすべてのデバイスが表示されます。

各デバイスについて、次の情報が表示されます。

• 登録時に指定されたデバイス名
• デバイスのステータス（下記参照）
• 作成日
• デバイスが登録されたテナント名

デバイスのステータスは次のいずれかになります。

• 接続待機中 － デバイスは登録されていますが、指定されたIDのデバイスは接続を試行していません。
• 承認待ち － 指定されたIDを持つデバイスからの通信がありますが、認証情報がデバイスに送信されるためには、登録を行っているユーザーが明示的に承認する必要があります。
• 承認済み － ユーザーは認証情報をデバイスに送信することを承認しました。
• ブロック － 試行失敗回数が制限を超えたため、デバイスの登録がブロックされました。

デバイスは、さまざまな方法でThings Cloudアカウントに接続できます。

デバイスの登録

デバイスを登録するとき、次のいずれかのオプションを選択できます。

• 単一デバイス登録 － 1 つまたは複数のデバイスを 1 つずつ手動で接続します。
• 一括デバイス登録 － 一度に大量のデバイスを登録します。

単一デバイスの登録

Things Cloud は、デバイスを 1 台ずつ手動で接続するための単一デバイス登録を提供します。

デバイスを手動で接続する

1. ナビゲータのデバイスメニューにある登録をクリックします。
2. デバイスの登録 ページで、上部バーの右側にある デバイスの登録 をクリックし、ドロップダウン メニューから 単一登録 > 一般 を選択します。 デバイスの登録 ダイアログ ボックスが表示されます。  
3. デバイスID欄に、デバイスの固有IDを入力します。IDを確認するには、デバイスのマニュアルをご確認ください。モバイルデバイスの場合、IDは通常デバイスの背面にあるIMEI（International Mobile Equipment Identity [国際移動装置識別]）となります。
4. 必要に応じて、登録後にデバイスを割り当てるグループを選択します。グループ割り当ての詳細については、デバイスのグループ化をご覧ください。
5. デバイスを追加をクリックして、デバイスを追加登録します。再度、デバイスIDを入力し、オプションでグループを選択します。これにより、1回の操作で複数のデバイスを追加できます。
6. 次へをクリックして、デバイスを登録します。

登録に成功すると、デバイスが デバイス登録 画面に接続待機中というステータスで表示されます。

デバイスの電源を入れ、接続が確立されるまで待ちます。 デバイスが接続されると、そのステータスは「承認待ち」に変わります。

承認をクリックして、接続を確認します。デバイスのステータスが「承認済み」に変わります。

デバイス登録用のセキュリティ トークン ポリシー

セキュリティトークンポリシーを構成してシリアル番号を推測するなどして、まだ登録されていないデバイスが脅威アクターによって乗っ取られるリスクを軽減します。

Things Cloud は、セキュリティトークンポリシーの次の値をサポートしています。

• IGNORED - デバイスが安全な登録を必要とする場合でも、Things Cloud はその要件を無視します。
• OPTIONAL - デバイスに安全な登録が必要な場合、Things Cloud はユーザーに追加のセキュリティ トークンを要求します。
• REQUIRED - Things Cloud に接続されているすべてのデバイスは、登録中にセキュリティ トークンを使用する必要があります。

ポリシーは、上記のいずれかの値を使用して次のテナントオプションを設定することで構成できます。たとえば、次のようになります。

{ 
  "category": "device-registration", 
  "key": "security-token.policy", 
  "value": "IGNORED" 
} 

無視されたセキュリティ トークン ポリシー

セキュリティ トークン ポリシーの値を IGNORED にすると、Things Cloud に接続されたデバイスはトークン検証なしで受け入れられます。

オプションのセキュリティ トークン ポリシー

デバイス登録のリストは以下の画像に表示されます。 セキュリティ トークンの入力はすべてのデバイスに対して表示されることに注意してください。

セキュリティトークンを使用しない登録

Things Cloud に接続されているデバイスがセキュリティ トークンを使用しない場合、セキュリティ トークンの入力に値を指定しなくても登録を続行できます。

安全に接続されていないデバイスにセキュリティ トークンが提供された場合、それは受け入れられ、トークンは無視されます。

セキュリティトークンを使用した登録

Things Cloud に接続されているデバイスがセキュリティ トークンを使用する場合、接続の確立時にデバイスから送信されたトークンと一致するトークンをユーザーが提供した場合にのみ登録を完了できます。

不正なトークンを指定した場合、デバイスで使用される値とユーザー インターフェイスを介して指定された値の間の不一致を通知するエラー メッセージが表示されます。

試行が一定回数失敗すると、登録はブロックされた状態になり、対応するエラー メッセージが表示されます。 ブロックされた登録は、次にデバイスに接続する前に削除する必要があります。

「すべてを受け入れる」機能の制限された使用

すべて受け入れる 機能は、セキュリティ トークンを使用せずに Things Cloud に接続されているデバイスでサポートされています。

セキュリティ トークンを使用するデバイスでは、すべてを受け入れる 機能は利用できず、警告メッセージが表示されます。 警告メッセージの詳細には、自動的に受け入れられなかったデバイスのリストが表示されます。

このようなデバイスは、正しい セキュリティ トークン 値を指定し、承認 をクリックして手動で承認する必要があります。

必要なセキュリティ トークン ポリシー

このモードでは、Things Cloud に接続されているデバイスは接続を確立する際にセキュリティ トークンを使用する必要があり、ユーザーはデバイスを受け入れるときに同じトークンを入力する必要があります。

デバイスを受け入れる手順は、オプションのセキュリティ トークン ポリシー で説明されている手順と同じです。

このモードでは、セキュリティ トークンなしで Things Cloud に接続するデバイスはブロックされ、登録を完了できなくなります。

一括デバイス登録

多数のデバイスを接続するために、Things Cloudではデバイスを一括登録するオプションを提供しています。つまり、CSVファイルをアップロードすることで多数のデバイスを登録することができます。

デバイスを一括登録する

1. ナビゲータの デバイス メニューで 登録 をクリックします。

2. デバイス登録 ページで、上部バーの右側にある デバイスの登録 をクリックし、ドロップダウン メニューから 一括登録 > 一般 を選択します。 一括デバイス登録 ダイアログボックスが表示されます。

3. プラス ボタンをクリックして、アップロードする CSV ファイルを選択するか、ドラッグ アンド ドロップします。

アップロードされたCSVファイルの形式に応じて、次の登録タイプのいずれかの処理が行われます。

• 簡易登録
• フル登録

セパレータはCSVファイルから自動的に取得されます。 有効な区切り文字の値は、「\t」 (集計記号)、「;」 (セミコロン)、および「,」 (カンマ) です。

簡易登録

CSVファイルに、IDとPATHという2つの列がある場合、IDがデバイス識別子（シリアル番号）で、PATHがスラッシュで区切られたグループ名の一覧（登録後にデバイスを割り当てるグループへのパス）です。

ID;PATH
Device1;Group A
Device2;Group A/Group B

ファイルがアップロードされると、必要なグループが新規作成され、ステータスが「接続待機中」の新規登録が作成されます。そして、通常の登録プロセスを続行する必要があります（上記参照）。

フル登録

CSVファイルには、少なくともデバイス識別子としてのIDとデバイスの認証情報が含まれていなければなりません。

さらに、次の例のようにICCID、NAME、TYPEのような他の列を含むこともあります。

ID;CREDENTIALS;TYPE;NAME;ICCID;IDTYPE;PATH;SHELL;AUTH_TYPE
006064ce800a;LF2PWJoLG1Fz;c8y_Device;Sample_Device1;+491555555;c8y_Serial;bulk group/subgroup1;1;BASIC
006064ce8077;OowoGKAbiNJs;c8y_Device;Sample_Device2;+491555555;c8y_Serial;bulk group/subgroup2;1;BASIC

デバイスを接続するために、これらは関連情報とともに事前登録されます。具体的には、各デバイスは次のような構成設定になります。

• ユーザー名 － Things Cloudにアクセスするためのユーザー名の形式は<tenant>/device_<id>でなければなりません。<tenant> は、CSVファイルのインポート元であるテナントを示し、 <id> は、CSVファイルで該当する値を参照します。
• パスワード － Things Cloud にアクセスするための各デバイスの一意のパスワードで、CSVファイルにおける「Credentials（認証情報）」の値と同じです。
• マネージドオブジェクトとして表わされるデバイス － CSVファイルにおける TYPE、NAME、ICCID、IDTYPE、PATH、SHELL。

データがインポートされると、事前登録されたデバイス数と、発生したエラーに関するフィードバックが表示されます。

一括登録用 CSV テンプレートファイルを両タイプ（簡易/フル）用意しておりますので、ダウンロードをしてファイルの構成を表示またはコピーできます。

ExcelでCSVをインポート

1. マイクロソフト Excelでデータタブに切り替えます。
2. データタブのトップメニューバーのテキストファイルを選択します。
3. コンピューターを参照して、対象のCSVファイルを選択します。（今回の場合、Things Cloudよりダウンロードしたテンプレートファイル）
4. テキストインポート ウィザードの手順１では、設定をデフォルトのままに、次へをクリックしてください。
5. テキストインポート ウィザードの手順２では区切り文字として、セミコロンを選択し完了をクリックしてください。

ファイル形式と使用可能なCSVのデータ形式の詳細については、Things Cloud OpenAPI仕様 の 一括デバイス認証情報リクエストを作成する をご覧ください。

デバイスの表示

アカウントに接続されているすべてのデバイスを表示するには、ナビゲータのデバイスメニューですべてのデバイスをクリックします。

詳細なデバイス一覧が表示されます。

デバイス一覧

デバイス一覧の列にはデバイスごとに、次の情報が表示されます。

グローバル ロールを持つユーザーの場合、デバイス リストには項目がページ分割されて表示されます。ページごとのアイテム数を選択し、任意のページに直接ジャンプできます。インベントリロールを持つユーザーには、最初は最大 50 個のアイテムが表示されます。利用可能なデバイスが 50 を超える場合は、リストを下にスクロールするとさらに多くのデバイスが読み込まれます。

列の設定

デバイス一覧に表示される列は、必要に応じて設定できます。

列の表示／非表示

1. テーブルのヘッダーの右にある列を設定をクリックします。
2. ドロップダウンリストより、必要に応じて列のチェックボックスを選択／クリアします。  

デバイス一覧に変更が反映され、選択された列のみ表示されます。

カスタム列の追加

カスタム列を追加して、さらなるデバイスプロパティを表示できます。

1. 列を設定のドロップダウンリストより、カスタム列を追加をクリックします。
   
   
   
2. ヘッダー欄に、新しいカスタム列のヘッダーを入力します。
3. フラグメントパス欄に表示したいデバイスのプロパティを入力します。ネストされたプロパティでも受け入れられます。ただし、ネストされたプロパティの場合はc8y_Mobile.mccのような標準フラグメントのみ選択できます。
4. この列を保存した後に別の列を追加 トグルをアクティブに切り替えて、現在の列を保存した直後に、ダイアログを離れることなく別のカスタム列を作成します。
5. 保存 をクリックします。

デバイス一覧に、新しく追加した列が表示されます。

リストからデバイスの削除

1. 削除したデバイスの行にカーソルを合わせます。
2. 行の右に表示された赤いマイナスアイコンをクリックします。
3. デバイスの取り外しを確認します。 必要に応じてデバイスの子デバイスを削除するか、関連付けられているデバイス所有者を削除するかを選択します。両方のオプションを選択することはできないことに注意してください。

デバイスは、プラットフォームより完全に削除されます。

デバイスのフィルタリング

デバイス一覧には、リスト内のデバイスを特定の条件で絞り込む、フィルター機能を備えています。

フィルタリングはすべての列で行えます。絞り込みたい列の名前の横にあるフィルターアイコンをクリックします。

ドロップダウンリストでフィルターオプションを指定します。

ほとんどの列はテキスト欄を表します。検索欄のように、テキストボックスに任意のテキストを入力するだけで、これらの列にフィルターを適用できます。複数の語句を抽出する場合は、「＋ 次を追加」 をクリックしてテキストボックスを追加します。

テキストのフィルタリング以外にも、いくつかのオプションがあります。

• 日付欄の場合 （例:登録日）、フィルターする日付範囲を指定します。
• ステータス列では、デバイスの送信、受信、またはメンテナンスのステータスを表すさまざまな基準でフィルタリングできます。
• アラーム列で選択できるフィルターオプションは、アラームタイプ（クリティカル、メジャー、マイナー、警告、アラームなし）に対応します。
• カスタム列の場合は、フラグメントが存在するかどうかに基づいてフィルタリングする 値が定義されている行のみ を選択するか、エントリが一致する必要がある 1 つ以上のフィルタ条件を指定します。

最後に、適用をクリックしてフィルターを実行します。

これでデバイス一覧には、フィルターオプションに一致するデバイスのみが表示されます。

列ごとに並べ替えが可能です。 それぞれの列ヘッダーの並べ替えアイコンを 1 回クリックするとエントリが昇順で並べ替えられ、2 回クリックするとエントリが降順で並べ替えられます。 この列の並べ替えを削除するには、並べ替えアイコンをもう一度クリックします。

すべてのフィルタをクリアしてすべてのデバイスを表示する場合は、テーブル ヘッダーの フィルタのクリア をクリックします。

デバイスのグループ化

デバイスは、特定のユースケースに従ってグループ化できます。デバイスは複数のグループに配置でき、グループ自体も複数のグループに含めることができます。

Things Cloudは、トップレベルのグループとサブグループを区別します。

• トップレベルのグループは、ナビゲータの最上位階層にあるグループメニューに表示されます。
• サブグループは、トップレベルのグループをさらに分割することができます。

グループの表示

ナビゲータでグループをクリックすると、すべてのグループが一覧形式で表示されます。

グループごとに、タイプや名前などさまざまな情報が提供されます。右側にある列の設定をクリックして列を追加または削除し、お好みに合わせて表示をカスタマイズします。デバイスの表示 > 列の設定 もご覧ください。

特定の条件でグループをフィルタリングするには、列ヘッダーの上にカーソルを置き、それぞれのフィルターアイコンをクリックします。

デバイスの表示 > デバイスのフィルタリング もご覧ください。

この機能は一時的なフィルターのみを作成することに注意してください。恒久的なフィルターの場合は、スマート グループ 機能を使用できます。

グループをクリックすると、その詳細が表示されます。

サブアセット ページ

サブアセット ページの上部には、グループ名と説明（編集可能）が表示され、右側にグループが作成された日時と最終更新日時の情報が表示されます。

その下に、グループに割り当てられたすべてのアセットが一覧表示されます。アセットごとに、タイプや名前などのさまざまな情報が表示されます。最上位階層のグループリストと同様に、列を追加または削除して、お好みに合わせてリストをカスタマイズしたり、フィルターを適用して特定の基準に従ってリストをフィルタリングすることができます。

さらに、デバイスを割り当てることができます（グループのデバイス割り当て 参照）。

グループの追加

1. トップバーの右側にあるグループを追加 をクリックします。
2. 表示されたウィンドウで、一意のグループ名と任意の説明を入力し、次へ をクリックします。
3. リストより、追加するデバイスを選択します。フィルターを適用して、表示されるデバイス数を減らすことができます。
4. 作成 をクリックして、新規グループを作成します。

新規グループがグループ一覧表に追加されます。

新しいグループを既存グループの子として追加するには、そのグループのサブアセットページに移動し、上部のトップメニューバーでグループを追加 をクリックします。

グループの編集

1. ナビゲータで、グループをクリックして開きます。
2. サブアセットページで、グループ名と説明を編集できます。

権限の詳細については、「管理」セクションの権限の管理をご覧ください。

グループの削除

削除する各エントリの上にカーソルを置き、右側の削除アイコンをクリックします。

グループのデバイス管理

グループのデバイス割り当て

グループにデバイスを割当てる方法は、いくつかあります。

グループの観点より

ナビゲータのドラッグアンドドロップ機能を使用して、デバイスをグループにすばやく割り当てることができます。グループとデバイスの再構築をご覧ください。

さらに、次の手順を実行してデバイスを割り当てることができます：

1. ナビゲータで、グループメニューからグループを選択し、サブアセットページを開きます。
2. トップメニューバーの右側にあるデバイスを割り当てるをクリックします。
3. リストから追加するデバイスを選択します。 フィルターを適用して、表示されるデバイス数を減らすことができます。
4. 割り当てる をクリックして、選択したデバイスを割り当てます。

デバイスは選択したグループに割り当てられ、サブアセット ページにサブアセットとして表示されます。

デバイスの観点より

1. デバイス一覧から対象のデバイスを選択して開きます。
2. 情報タブで、グループの割り当てカードまで下へスクロールします。ドロップダウン フィールドから、デバイスを割り当てるグループを選択します。ここにグループ名を直接入力することも、名前の一部のみを入力してリストをフィルタリングし、一致するグループ名のみを表示することもできます。
3. 割り当てるをクリックします。

デバイスが選択したグループに割り当てられます。

存在しないグループ名を入力して検索すると、新規ボタンが表示されますので、ここで入力した名前の新規グループを作成し、その新規グループにデバイスを割り当てることができます。

デバイスの割り当てを解除

割り当てを解除したい各デバイスの上にカーソルを置き、右側の割り当て解除アイコンをクリックします。

デバイスの割り当てを解除しても、デバイス、サブデバイス、関連するデータは削除されません。デバイスはこのグループからのみ削除されます。

デバイスの削除

削除する各デバイスの上にカーソルを置き、右側の削除アイコンをクリックします。

デバイスは完全に削除されます。

デバイスの詳細の表示

特定のデバイスの詳細を表示するには、その名前をクリックします。

デバイスの詳細情報が表示されます。

グループとデバイスの再構築

ドラッグアンドドロップ機能により、グループ、サブグループ、およびデバイスを簡単に再構築できます。

グループの移動

1. ナビゲータで、別のグループへと移動したいグループを選択します。
2. 移動先のグループへドラッグアンドドロップします。
3. 表示されるウィンドウで、操作を確認します。

デバイスの移動または追加

1. ナビゲータで、別のグループへと移動または追加したいグループまたはデバイスを選択します。
2. 移動先のグループへドラッグアンドドロップします。
3. 表示されるウィンドウで、デバイスを移動するかまたは追加するかを選択します。

スマートグループの使用

スマートグループは、フィルター条件に基づいて動的に作成されるグループです。このタイプのグループは、例えば、特定のタイプのデバイスを新しいソフトウェアまたはファームウェアバージョンに一括アップグレードする場合に使用できます。

スマートグループは、デバイス一覧から作成できます。

スマートグループの作成

1. デバイス一覧を開くには、ナビゲータですべてのデバイスをクリックします。
2. リスト内のデバイスをフィルタリングして、対象のデバイスを選択します。フィルタリングの詳細については、デバイスの表示 > デバイスのフィルタリング をご覧ください。
3. トップメニューバーの右側にあるスマートグループを作成をクリックします。
4. グループの名前を入力し、作成をクリックします。

新規グループは、ナビゲータのグループメニューの最上位階層グループとして表示されます。スマートグループは、フォルダアイコン内の小さな歯車で区別できます。

スマートグループ名と説明の下に、スマートグループの構築時に適用されたフィルター基準が表示されます。ここでフィルター設定を編集し、選択を調整できます。

スマートグループの削除

削除する各エントリの上にカーソルを置き、右側の削除アイコンをクリックします。

デバイスの詳細

デバイスごとに詳細な情報が表示されます。デバイスに対して実際に提供される情報の種類は、デバイスのタイプ、デバイスの使用状況、およびユーザーインターフェースの構成によって異なります。

デバイスの詳細情報を表示するには、デバイス一覧でデバイスをクリックします。

デバイスの詳細はタブに分かれています。タブの数は動的であり、利用可能な情報によって異なります。つまり、その特定デバイスの提供可能な情報のタブのみが表示されます。 各デバイスの詳細なタブに関連する操作とフラグメントの詳細な説明については、「リファレンスガイド」の デバイス管理ライブラリ をご覧ください。

最初、情報タブが表示されます。このタブには、デバイスに関する一般的な情報が表示され、各デバイスで使用できます。

各デバイスには少なくとも、情報、アラーム、制御、イベント、稼働率、識別子の各タブが表示されます（以下のタブリストもご覧ください）。

次のタブは最も一般的なタブで、それぞれ別途詳細に説明していきます。

名前の下にパンくずリストが表示されます。デバイスがアセット階層（グループなど）の一部である場合は、パンくずリストを使用して階層を上に簡単に移動できます。デバイスは複数の階層に所属している場合があるので、複数行のパンくずリストが表示されることがあります。

デバイスのタイプと使用状況に応じて、トップメニューバーの右側にある 参照… をクリックすると、メニューに追加のアクションが表示されます。

これらの追加メニュー項目の詳細は、必要に応じて提供されます。

アラーム

アラームタブには、デバイスのアラームに関する情報が表示されます。アラームの詳細については、アラームの操作をご覧ください。

稼働率

稼働率タブでは、マシンの可用性の監視が可能です。詳細については、デバイスの監視と制御 > 稼働率 をご覧ください。

子デバイス

子デバイスタブには、現在表示されているデバイスに接続されているデバイスの一覧が表示されます。例えば、ゲートウェイを見ると、タブにはそのゲートウェイに接続されているすべての機器が一覧表示されます。

子デバイス一覧の詳細については、デバイスの表示をご覧ください。

構成

デバイスの構成タブでは、デバイスのパラメータと初期設定を設定できます。デバイスに応じて、可能な構成は次の通りです。

• テキストベースの構成
• バイナリベースの構成スナップショット

バイナリベースの構成スナップショットの管理の詳細については、デバイス データの管理 > 構成の管理 をご覧ください。

現在のテキストベース構成スナップショットのリクエスト

1. 構成 タブに移動します。
2. デバイスがサポートする構成をリストから 1 つ選択します。
3. デバイスから新しいスナップショットを取得 をクリックします。

テキストベース構成スナップショットの追加または編集

1. 構成タブでは、テキスト欄より、手動でデバイス構成を追加または編集できます。
2. 構成をデバイスに送信をクリックし、編集内容を保存します。

制御

制御タブには、デバイスに送信されるオペレーションが一覧表示されます。 オペレーションの詳細についてはオペレーションの操作をご覧ください。

デバイスプロファイル

デバイスプロファイルをデバイスに適用する方法の詳細については、デバイスへのデバイスプロファイルの適用 をご覧ください。

イベント

イベントタブには、デバイスに関連するイベントが表示されます。これにより、デバイスの低レベルのトラブルシューティングが可能になります。詳細は、デバイスのトラブルシューティングをご覧ください。

ファームウェア

デバイス上のファームウェアを管理および更新方法の詳細については、デバイスのファームウェア管理 をご覧ください。

識別子

Things Cloudは、デバイスとアセットを複数の外部IDに関連付けることができます。例えば、多くの場合、デバイスはモデムのIMEI、マイクロコントローラのシリアル番号、またはアセットタグによって識別されます。識別子タブには、特定のデバイスについて記録されたすべてのIDが一覧表示されます。

これは、機能しないハードウェアがあり、記録されたデータを失わずにハードウェアを交換する必要がある場合などに便利です。新しいハードウェアをアカウントに接続し、古いハードウェアのIDを変更して、新しいハードウェアのIDを含めることで対応できます。

情報

情報 タブでは、管理に関連するデバイス情報の概要をダッシュボードに表示します。

この情報は、次のカードに記載されています。

位置

位置タブには、デフォルトとして、デバイスから送信される地図上でのデバイスの位置と座標が表示されます。位置を送信しないデバイスの場合は、手動で位置を設定できます。表示された地図の正しい位置に「ピン」を配置するだけで設定されます。

位置タブは、デバイスに c8y_Position プロパティが含まれる場合にも表示されます。新しい c8y_Position イベントを送信するときに、同じ c8y_Position フラグメントをデバイスに設定すれば、地図上に自動的にマークを付けることができます。

ログ

ログタブでは、デバイスからのログ情報を管理できます。

ログ情報のリクエスト

1. ログタブで、トップメニューバーの右側にあるログファイルのリクエストをクリックします。
2. 次のウィンドウで、ログ情報の日付と時刻の範囲を指定します。
3. ログのタイプをドロップダウンリストより選択します。表示されるログタイプのリストはデバイスによって違います。
4. オプションで、テキストで絞り込むことができます。例えば、「Users」と入力すると、返されたログ情報に「Users」という用語を含む行のみが表示されます。
5. 返される行の最大数を指定します（最新から数えます）。デフォルト値は1,000です。
6. ログファイルのリクエストをクリックします。

指定したデバイスのログ情報をリクエストします。

ログがデバイスから Things Cloudに転送されると、ログタブ上に一覧表示されます。一覧の行には、リクエストしたログの時間範囲が表示されます。

リストのエントリをクリックすると、ログ情報全体が表示されます。

ログのダウンロード

行にカーソルを合わせ、ダウンロードアイコンをクリックし、ログの抜粋をダウンロードします。

ログの削除

行にカーソルを合わせ、削除アイコンをクリックし、ログ情報を削除します。

計測値（メジャーメント）

メジャーメントタブでは、デバイスが提供する数値データをチャート形式で表示します。チャートは、複数のグラフまたは「シリーズ」を含むことができるメジャーメントのタイプにグループ化されます。

たとえば、以下のスクリーンショットは、2 つの異なるシリーズによる温度測定のグラフを示しています。

チャートに異なる系列のメジャーメントが含まれている場合、系列ごとに 1 つの Y 軸が表示されます。 上の例では、温度データは、℃と同じ単位を持つ 2 つのセンサー、つまり「sensors-1」と「sensor-2」から記録されます。 ここでは、さまざまなセンサーからのメジャーメントが個別の「シリーズ」データとして分類されます。 それぞれのセンサーからのメジャーメントは別のシリーズ名 (センサー名と同じ) を使用して保存されるため、ここでは 2 つの軸が表示されます。 メジャーメントが同じ系列に属している場合、Y 軸は 1 つだけ表示されます。

メジャーメントの詳細情報を表示するには、グラフにカーソルを合わせます。カーソルの横に、メジャーメントの詳細情報を示すツールチップが表示されます（ツールチップが最も近いメジャーメントに「スナップ」します）。

時間範囲と集計

デフォルトでは、グラフには過去1時間分の原データが表示されます。X軸の時間範囲を変更するには、右上のドロップダウンメニュー「過去1時間」を開き、時間範囲を選択します。

時間範囲を増やすと、集計フィールドの値が自動的に「1時間ごと」または「毎日」に切り替わります。これで、グラフは個々の現データポイントではなく範囲が表示されるようになります。「1時間ごと」の場合、グラフには1時間で測定された最小値と最大値の範囲が表示されます。「毎日」の場合、チャートには1日のメジャーメントの最小値と最大値が表示されます。同様に、ツールチップに個々の値ではなく、値の範囲が表示されるようになります。

これにより、より広い時間範囲にわたって効率的に概要を把握できます。グラフには、デスクトップブラウザの過負荷を避けるために、最大5.000個のデータポイントしか表示されません。データポイントが5.000個を超える細かい焦点を選択すると、「切り捨てられたデータ。集計を変更するか、より短い日付範囲を選択してください。」という警告文が表示されます。

リアルタイムをクリックすると、接続されたデバイスからシステムに新しいデータが送信されるたび、グラフのリアルタイムでのユーザーインターフェース更新を行います。

いわゆる「KPI (Key Performance Indicator)」を設定して、グラフィック表示と軸制限に影響を与えることができます。ユーザーガイドの管理をご覧ください。

メジャーメント形式

メジャーメントグラフを表示するには、デバイスは特定のフラグメント形式でメジャーメントを送らなければなりません。

"fragment_name" : {
	"series_name" : {
		"value" : ...
		"unit" : ...
	}
}

例:

"c8y_SpeedMeasurement": {
      "Speed": { "value": 1234, "unit": "km/h" }
}

"Fragment_name" と "series_name"は、別の有効な json プロパティ名に置き換えることができますが、空白および [ ] ,* などの特殊文字は使用できません。構造は、上記とまったく同じ 2 階層の json オブジェクトでなければなりません。

ネットワーク

ネットワークタブでは、モバイルネットワーク（WAN）とローカルネットワーク（LAN）のパラメータの閲覧と設定ができます。

ユーザーインターフェースのWANパラメータは、ルーターに保存されている最初のプロファイルに対応しています。これらは、リモート、またはSMSを介して設定できます。

WANパラメータの構成設定

1. アクセスポイント名（APN）を入力します。
2. 接続を確立したいプラットフォームのアカウントのユーザー名とパスワードを入力します。
3. 認証タイプを選択します。
4. 保存をクリックして、設定を保存します。

LANパラメータの構成設定

LANパラメータを設定するには、IPアドレスとサブネットマスクを入力します。

DHCPパラメータの構成設定

1. 接続を確立できるアドレス範囲を入力します。
2. DNSを入力します。
3. DNS 2を入力します。
4. ドメイン名を入力します。
5. 保存をクリックして、設定を保存します。

サービス

サービス タブには、デバイス上で実行されているすべてのサービスのリストが、ステータス、名前、タイプ、最終更新日とともに表示されます。 各列では、表示されるそれぞれの値によってサービスをフィルタリングおよび/または並べ替えることができます。

プラットフォームは、サービスの 3つのステータスオプション、Up、Down、Unknown を定義します。 これらの事前定義されたステータスには独自のグラフィック表現があり、ステータス フィルターから直接選択できます。

他のステータスオプションも許可されており、自由に定義できます。Web SDK ドキュメント リソースの サービス モジュール をご覧ください。これらはすべて同じアイコンを共有しており、ステータス フィルターに手動で入力する必要があります。 ステータス アイコンのツールチップには、実際の値が表示されます。

シェル

デバイスシェルを使用すると、リモートデバイスを対話的に操作できます。多くの産業用機器は、モデム用のATコマンド、多くの追跡装置用のCSV形式のコマンド、あるいはTixi TiXMLのような精巧なスクリプト機構など、何らかの形式のコマンド言語をサポートしています。シェルでは、デバイスの各言語でコマンドを送信し、コマンドの結果をインタラクティブに表示できます。

シェルタブには、コマンドを入力するためのコマンドプロンプトが表示されます。

コマンドプロンプトには、任意のコマンドテキストを入力できます。コマンドテキストをデバイスに送信するには、実行をクリックします。このボタンは、コマンドがテキスト領域に書き込まれた場合にのみアクティブになります。

Things Cloud には、一部のデバイス向けに頻繁に使用されるコマンドがいくつか用意されています。 コマンドプロンプト領域の上にある 定義済みのコマンド をクリックして、使用可能な定義済みコマンドのリストを含むウィンドウを開きます。 選択したコマンドを選択し、使用 をクリックしてコマンドをコマンド プロンプトにコピーします。ここに新しいコマンドを追加して再利用することもできます。

ソフトウェア

デバイスにインストールされているソフトウェアを管理および更新する方法の詳細については、デバイスのソフトウェア管理をご覧ください。

追跡

デバイスは、Things Cloudでの移動の履歴を記録することができます。この移動は、追跡タブに表示されます。

右上のドロップダウンリストより、期間を選択（または、リストから「カスタム」を選択して期間を指定）し、その期間中のデバイスの動きを表示できます。動きは、赤い線として地図上に表示されます。

地図の横に、個々の記録とその時間が一覧表示されます（「位置更新イベント」）。記録をクリックすると、地図上の「ピン」に記録時の場所が表示されます。

デバイスのタイプとThings Cloudへの統合方法に応じて、デバイス側のジオフェンシングとモーション検出を設定できます。

デバイスの監視と制御

デバイス位置の特定

Things Cloudには、アカウント内のすべてのデバイスを地図上に表示するオプションがあります。

ナビゲータのデバイスメニューで地図をクリックすると、すべてのデバイスをリアルタイムで示す地図が表示されます。

デバイスは「ピン」として表されます。ピンをクリックすると、各デバイスの名前が表示されます。デバイス名をクリックして、デバイスの詳細に切り替えます。

接続監視

デバイス管理アプリケーションでは、デバイスへの接続を監視することができます。

これは、個々のデバイス（下記参照）の階層で実行でき、デバイス一覧の複数のデバイスにわたって実行することもできます。

複数のデバイスの接続監視

デバイス一覧を開き、複数のデバイスの接続を監視します。

接続ステータスは、デバイス一覧のステータス列で矢印として示されます。

接続の送信

上矢印は、送信接続（デバイスからThings Cloudへのトラフィック）を表します。送信接続のステータスは、次のいずれかになります。

• オンライン（要求された間隔内でデータが送信されている）：緑色の矢印で示されます。
• オフライン（要求された間隔内でデータの送信がされていない）：赤い矢印で示されます。
• 不明または監視されていない（間隔が設定されていない）：灰色の矢印で示されます。

矢印にカーソルを合わせると、デバイスからサーバーへの最後のリクエストのタイムスタンプが表示されます。

デバイスがオフラインであることが検出されると（要求された間隔内でのデータ送信が停止され、上矢印が赤色に変わる）、「指定間隔内にデバイスからの応答がありませんでした」という、デバイスの使用不可アラームが作成されます。

送信接続は、アラーム、イベント、測定値など、デバイスから何かが送信された場合、または空の更新がデバイス自体に送信された場合に更新されます。 詳細については、リファレンス ガイドの デバイス管理ライブラリ > デバイスの可用性 > 可用性の監視 を参照してください。

プッシュ接続

下矢印は（Things Cloudからデバイスへの）プッシュ接続を表します。プッシュ接続のステータスは、次のいずれかになります。

• オンライン（接続確立）：緑色の矢印で示されます。
• オフライン（接続が確立されていない）：赤い矢印で示されます。
• 監視されていない：灰色の矢印で示されます。

プッシュ接続とは、/notification/operations API エンドポイントへのアクティブな HTTPS ロング ポーリング接続、または Things Cloud の MQTT エンドポイントへのアクティブな MQTT 接続です。 デバイスが接続されている場合は、データがなくても常に緑色になります。

メンテナンスモード

デバイスは、「メンテナンス」モードである場合があり、ステータス列にツールアイコンで示されます。これは、デバイスが現在メンテナンス中で監視できないことを示す特殊な接続ステータスです。メンテナンス中のデバイスは、アラームが発生しません。

デバイスのメンテナンスモードのオン/オフを切り替えるには、情報タブにある接続監視カードのスライダーを使用します（下記参照）。

特定のデバイスの接続監視

特定のデバイスの接続を監視するには、このデバイスの情報タブに移動します。デバイスステータスの下に、デバイスの接続ステータスが表示されます。

必要な間隔の欄では、間隔を指定できます。このパラメータで、デバイスからの受信頻度を定義します。例えば、必要な間隔を60に設定した場合、デバイスは少なくとも1時間に一度はThings Cloudと通信することになります。この間隔は、デバイスがデータの送信を試みる頻度に基づいてデバイス自体が設定するか、ユーザーが手動で設定します。

間隔を設定すると、その下にメンテナンススライダーが表示されます。

メンテナンススライダーを使用して、デバイスのメンテナンスモードをオンまたはオフにすることができます。このモードは、デバイスステータスに即座に反映されます。

稼働率

Things Cloudは、接続監視と稼働率を区別します。前述にある接続監視は、デバイスがThings Cloudと通信しているかどうかを示すだけで、デバイスが機能しているかどうかを自動的に示すわけではありません。

稼働率とは、デバイスがサービス中かどうかを示します。例えば、商品を販売する準備ができていれば、自動販売機はサービス中となります。自動販売機はThings Cloudとは無関係に現金で商品を販売することができるので、商売人の立場から言うと、サービス中となるのです。同様に、ゲートウェイの電源をオフにしても、ゲートウェイの背後にあるデバイスは引き続き動作できます。

Things Cloudは、機器にクリティカルな未解決アラームが存在しない限り、デバイスがサービス中であると見なします。そして、そのようなクリティカルアラームが存在した時間の割合を表示します。例えば、ある期間中もし機器にクリティカルアラームがまったくない場合は、その機器のサービス稼働率は100%とされ、もし期間中の半分はクリティカルな未解決アラームが発生していた場合は、その機器のサービス稼動率は50%とされます。

機器がオフラインの間、Things Cloudはデフォルトで次のように想定します。

• 接続が切断される前の状態がサービス中であれば、接続が切断されても機器はサービスを継続していると認識します。
• 接続が切断される前の状態がサービス停止中であれば、機器はサービスを停止中とします。

この規則には例外もあります。例えば、自動販売機がキャッシュレス決済のみに依存している場合、ネットワークへの接続が失われると、自動販売機のサービスが停止し、販売が停止します。この場合、機器の使用不可アラームを、メジャーではなくクリティカルアラームとして、管理アプリケーションで設定する必要があります。

Things Cloud は個々のデバイスの階層、およびすべてのデバイスにわたってサービスの稼働率を表示します。

特定のデバイスの稼働率を表示

特定のデバイスの稼働率を確認するには、そのデバイスの詳細にある稼働率タブをクリックします。

すべてのデバイスの稼働率を表示

すべてのデバイスにわたる全体の稼働率を表示するには、ナビゲータで稼働率をクリックします。

稼働率画面には、過去24時間、過去7日間、過去30日間のデバイスの稼働率の割合が表示されます。

アラームの操作

デバイスは、アラームを発生させて、介入が必要な問題があることを示すことができます。

アラームの表示

Things Cloudは個々のデバイス、およびすべてのデバイス全体にわたってのアラームを表示します。

• すべてのデバイスのアラームを確認する場合は、ナビゲータの概要メニューでアラームをクリックします。
• 特定のデバイスのアラームを確認する場合は、デバイスの詳細画面でアラームタブに切り替えます。

デフォルトでは、

• 未解決のアラームのみが表示されます。トップメニューバーの右側にあるクリアされたアラームを表示をオンにすると、アラーム履歴全体が表示されます。
• デバイスからのアラームはリアルタイムで表示されます。トップメニューバーのリアルタイムをクリックして、リアルタイム更新を使用不可にします。

アラームは、その重大度に従って分類されます。 Things Cloudには、次の4種類のアラームタイプがあります。

アラームタブは、これらのアラームタイプに対応する4つのセクションに分かれています。

トップメニューバーには、重大度をフィルタリングするためのボタンが表示されます。ボタンをクリックすると、対応するセクションが非表示になります。もう一度クリックすると、再び表示されます。

各セクション内で、アラームは発生順に並び替えられて、最新のアラームが最初に表示されます。

各行には、アラームに関する次の情報が表示されます。

行の右側にある矢印をクリックして展開し、アラームの詳細を表示します。

• ステータス: アラームのステータスに関する詳細情報を提供し、アラームのタイプを表示します。 タイプ情報は、アラームの複製と、管理 > ビジネスルールの管理 > アラーム マッピング でアラームの優先順位の設定に使用されます。
• 変更ログ: アラームが作成されたサーバー時間（デバイス時間と異なる場合があります）を表示します。

アラームのステータス変更

アラームのステータスを変更するには、アラームの上にカーソルを合わせ、右側に表示される該当のステータスのボタンをクリックするか、右端にあるメニューアイコンをクリックして、変更したいステータスを選択します。

すべてのアラームのステータスを一度に「クリア」に変更することもできます。トップメニューバーのすべてをクリアをクリックして、選択した重大度のすべてのアラームをクリアします。

オペレーションの操作

オペレーションは、デバイスのリモート制御に使用されます。

Things Cloudは個々のデバイス、およびすべてのデバイス全体にわたっての操作を表示します。

• すべてのデバイスの操作を表示するには、ナビゲータの概要メニューでデバイス制御をクリックします。
• 特定のデバイスの操作を表示するには、デバイスの詳細画面で制御タブに切り替えます。

デバイス制御には 2 種類の操作があり、それぞれタブで表されます。

• 単一操作 は単一のデバイス上で実行されます。単一の操作を表示するには をご覧ください。
• 一括操作は、一連のデバイス上で実行される同じ単一操作で構成されます。一括操作を表示するにはをご覧ください。

単一操作の表示

単一操作 タブで単一操作のリストをご覧ください。

単一操作は、次の4つの状態のいずれかになります。

各行に、次の操作の情報が表示されます。

行をクリックすると展開され、操作の詳細が表示されます。

• 詳細：操作名とステータスに関する情報を提供します。ステータス＝失敗 の場合は、失敗の理由が表示されます。単一操作が 一括操作 の一部である場合、一括操作の詳細を確認できます。
• 変更履歴：操作の過去の変更に関する情報を提供します。

ステータス別に単一操作のリストをフィルタリングするには、トップメニューバーにあるステータスボタンのいずれかをクリックします。すべてをクリックして、フィルターをクリアします。

トップメニューバーの右にあるリアルタイムをクリックすると、デバイスからリアルタイムで送信される操作が表示されます。再読み込み をクリックして、リストを手動で更新します。

単一操作を追加して実行する

単一操作は、一括操作またはデバイスがサポートするさまざまなタイプの操作（ファームウェア、ソフトウェア、構成 の管理など）によって作成できます。

一括操作 を作成すると、一括操作に伴う単一操作も、単一操作のリストに追加されます。

特定のデバイスの操作は、シェルタブで作成および実行されます。デバイス詳細 > シェルをご覧ください。

保留中の単一操作をキャンセルする

特定の保留中の単一操作、またはすべての保留中の単一操作を一度にキャンセルできます。

特定の保留中の単一操作をキャンセルするには、それぞれの単一操作エントリの右側にあるメニューアイコンをクリックし、操作をキャンセル を選択します。

保留中の操作をすべて一度にキャンセルするには、トップメニューバーの右側にある 参照… をクリックし、保留中の操作をすべてキャンセル を選択します。 あるいは、単一操作のリストをフィルタリングしてステータスが保留中の単一操作のみを表示し、トップメニューバーの右側にある すべてキャンセル をクリックします。

単一操作からスマートルールを作成する

スマートルールを作成する単一操作の右側にあるメニューアイコンをクリックし、スマートルールを作成 を選択します。

詳しい手順については、コックピット > スマートルール > スマートルールの作成 をご覧ください。

一括操作の表示

一括操作 タブで一括操作のリストをご覧ください。

一括操作には操作タイプとステータスがあります。

一括操作ウィザード を使用して、次の操作タイプの一括操作を追加できます。

一括操作には他の操作タイプも含めることができます。例えば、単一操作を一括操作としてスケジュールする 場合、その単一操作には異なる操作タイプが指定されます。

一括操作は、次のいずれかのステータスになります。

各行には、一括操作に関する次の情報が提供されます。

行の右側にある矢印ボタンをクリックすると、行が展開され、一括操作の詳細が表示されます。

• 詳細: 一括操作の開始日、遅延、ステータスおよび結果に関する情報を提供します。結果には、成功した操作、失敗した操作、および保留中の操作の数が一覧表示されます。一括操作が 失敗した操作を再試行する 場合、再試行元の一括操作のインデックスを示す追加の行が存在します。インデックスをクリックして、その一括操作までスクロールします。一括操作を作成する ときに説明が追加された場合、この説明を示す追加の行が表示されます。
• 操作: 操作に関する情報を JSON オブジェクトの形式で提供します。
• 操作（下段）: 一括操作を実行または完了する場合にのみ存在します。一括操作に伴う単一操作のステータスとデバイスに関する情報を提供します。ステータスごとに絞り込むことができます。また、操作 セクションの右上にある 失敗した操作を再試行 をクリックして、失敗したすべての操作を再試行するか、単一操作の上にカーソルを移動してそのすぐ隣に表示される 操作を再試行 ボタンをクリックして、単一操作を再試行することもできます。失敗した操作の再試行 もご覧ください。
• 変更履歴: 2 番目のタブには、一括操作の過去の変更に関する情報が表示されます。

一括操作のリストを操作タイプ別にフィルタリングするには、トップメニューバーのドロップダウンリストをクリックし、操作タイプのセットを選択し、適用 をクリックします。 フィルタをクリアするには、ドロップダウンリストで すべて を選択し、もう一度 適用 をクリックします。

ステータス別に一括操作のリストをフィルタリングするには、トップメニューバーにあるステータスボタンのいずれかをクリックします。 すべてのステータス をクリックしてフィルターをクリアします。

一括操作のリストを日付でフィルタリングするには、開始日時 と 終了日 の両方の日付ピッカーで日付を選択し、適用 をクリックします。 フィルターをクリアするには、その隣にある クリア をクリックします。

両方のフィルターをクリアするには、リストの下部にある フィルターのリセット をクリックします（フィルターが適用されている場合にのみ表示されます）。

一括操作の追加

一括操作を作成するには 2 つの方法があります。

• 一括操作ウィザードの使用
• 単一操作を一括操作としてスケジュールする

ウィザードを使用して一括操作を追加する

次の手順を実行します。

1. 一括操作 タブで、トップメニューバーの右側にある 新規一括操作 をクリックします。
2. 表示されるダイアログで、操作のタイプを選択します。
3. 結果のウィザードには 4 つのステップがあります。 最初の 2 つの手順は、操作のタイプによって異なります。

• 構成の更新
  • リストから構成を選択します。リストは構成タイプまたは構成名でフィルタリングできます。次へ をクリックします。
  • 選択した構成のプレビューを確認します。次へ をクリックします。
• ファームウェア更新
  • リストからファームウェアを選択します。リストはファームウェア名でフィルタリングできます。次へ をクリックします。
  • バージョンを展開し、パッチを選択します。次へ をクリックします。
• ソフトウェア更新
  • リストからソフトウェアを展開してバージョンを選択し、ドロップダウンリストからソフトウェアのインストール／更新または削除も選択します。利用可能なソフトウェアのリストは、デバイスタイプ、ソフトウェアタイプ、またはソフトウェア名でフィルタリングできます。[次へ] をクリックします。複数のデバイスタイプのソフトウェアを選択した場合、警告ダイアログが表示され、サポートされていないソフトウェアが原因で一部の操作が失敗する可能性があることを通知し、確認を求めます。
  • 選択内容を確認し、次へ をクリックします。
• デバイスプロファイルを適用
  • リストからデバイスプロファイルを選択します。リストは、デバイスタイプまたはプロファイル名でフィルタリングできます。次へ をクリックします。
  • 選択内容を確認し、次へ をクリックします。

4. すべてのデバイスのページ分割されたリストにフィルターを適用して、ターゲットデバイスを選択します。ステータス、名前、タイプ、モデル、グループ、登録日、アラームでフィルタリングできます。複数のフィルターを適用できます。フィルターを適用するには、列ヘッダーをクリックし、コンテキストメニューでフィルターオプションを選択し、適用 をクリックします。グループフィルターでは、サブグループによるフィルタリングも可能です。サブグループがある場合、サブグループを選択するには、グループの右側にある矢印ボタンをクリックし、ドロップダウンから目的のサブグループを選択します。リストの上にある フィルターをクリア をクリックすると、すべてのフィルターをクリアできます。操作タイプ「構成の更新」、「ソフトウェア更新」、「デバイスプロファイルを適用」の場合、リストは対応するデバイスタイプによってすでにフィルタリングされています。次へ をクリックします。
5. 新しいタイトルを入力するか、あらかじめ設定されているタイトルを使用します。必要に応じて説明を入力します。開始日と遅延を選択します。遅延は秒またはミリ秒のいずれかで、一括操作の各単一操作の間に費やされる時間です。一括操作のスケジュール をクリックして一括操作を作成します。

単一操作を一括操作としてスケジュールする

単一操作を一括操作としてスケジュールするには、単一操作 タブまたは特定デバイスの 制御 タブから実行します。 次の手順を実行します。

1. 一括操作としてスケジュールする単一操作の右側にあるメニューアイコンをクリックし、一括操作としてスケジュール をクリックします。
2. 結果として得られるウィザードは、ウィザードを使用して一括操作を追加する で説明されている新規一括操作ウィザードに似ています。ただし、操作タイプは一括操作としてスケジュールされた操作から推測されるため、手順は 2 つだけです。ウィザード全体 の説明を参照し、その指示に従ってください。

一括操作スケジュールの編集

一括操作のスケジュールを編集できるのは、ステータス＝スケジュール済み の場合のみです。

1. 編集する一括操作の右側にあるメニューアイコンをクリックし、スケジュールを編集 をクリックします。
2. 表示されるダイアログボックスで、開始日と遅延の値を変更できます。
3. 保存 をクリックして変更を適用します。

変更はそれに応じて一括操作に適用されます。

一括操作のキャンセル

一括操作をキャンセルできるのは、ステータス＝「スケジュール済み」または「実行しています」の場合のみです。実行中の場合、単一操作がすべて作成されるまでに限って、操作をキャンセルできます。 これにより、残りの単一操作の作成をキャンセルできます。

キャンセルする一括操作の右側にあるメニューアイコンをクリックし、一括操作をキャンセル をクリックします。

失敗した操作の再試行

実行中または失敗して完了した一括操作の失敗した操作を再試行できます。

これを行うには、目的の一括操作を展開し、操作 で 失敗した操作を再試行 をクリックして、失敗したすべての操作を含む新しい一括操作を作成します。 単一操作を再試行するには、操作の上にカーソルを置き、操作を再実行 をクリックします。これにより、新しい単一操作が作成されます。

一括操作が失敗して完了した場合は、操作の右側にあるメニューアイコンをクリックし、失敗した操作を再試行 をクリックすることもできます。

失敗した一括操作を手動で成功に設定する

失敗した一括操作を手動でステータス「成功」に設定できます。

これを行うには、一括操作の右側にあるメニューアイコンをクリックし、操作を成功に設定 をクリックします。

これは、操作が通常は成功しているものの、それほど重要ではないデバイスでの操作の失敗が含まれている場合に便利です。これらの不具合が発生すると、一括操作は「失敗」ステータスのままになります。

デバイスのトラブルシューティング

デバイスのトラブルシューティングをより詳細なレベルで行うには、イベントを使用します。イベントは通常、アプリケーション固有の処理に使用されるデバイスから送信される低レベルのメッセージです。例えば、自動販売機は、イベントの形式でリアルタイムの売上を送信します。

イベントの表示

Things Cloudは個々のデバイス、およびすべてのデバイス全体にわたってのイベントを表示します。

• すべてのデバイスのイベントを表示するには、ナビゲータの 概要 メニューで イベント をクリックします。
• 特定のデバイスのイベントを表示するには、デバイスの詳細画面で イベント タブに切り替えます。

デフォルトでは、イベントはリアルタイムでデバイスから受信したものとして表示されます。リアルタイム更新を無効にするには、トップメニューバーの右側にある リアルタイム をクリックします。

イベントごとに、次の情報が表示されます。

イベントリストの一番上に最新のエントリが表示されます。

行をクリックすると、その行が展開され、（デバイスのタイプと位置として）イベントの詳細が表示されます。

デバイスから大量のイベントデータが送信される場合があるため、データを日付別にフィルタリングして表示できます。

トップメニューバーのフィールドから開始日と終了日を選択し、適用をクリックしてフィルターを適用します。フィルターをクリアするには、フィルターをクリアをクリックします。

デバイスサービスの監視

デバイス管理アプリケーションを使用すると、デバイスが実行しているサービスについて送信するデータを監視できます。

デバイス詳細画面の サービス タブには、特定のデバイスで実行されているサービスの概要が表示され、サービス詳細ビューへのエントリポイントとして機能します。 そこでは、各サービスに対して送信されたメジャーメント、イベント、アラームに関する詳細情報を確認できます。

サービス詳細画面は次のタブで構成されており、それぞれの詳細については別のセクションで説明します。

アラーム

アラーム タブには、サービスのアラームに関する情報が表示されます。 アラームの詳細については、アラームの操作をご覧ください。

イベント

イベント タブには、サービスに関連するイベントが表示されます。 詳細については、デバイスのトラブルシューティングをご覧ください。

計測値（メジャーメント）

計測値（メジャーメント） タブでは、サービスの数値データのデフォルトの視覚化をグラフ形式で提供されます。

計測値（メジャーメント） タブの使用方法の詳細については、計測値（メジャーメント）をご覧ください。

デバイスタイプの管理

さまざまなデバイスタイプからのデータを処理するために、Things Cloudはデータベースに格納されているデバイスプロトコルを使用します。

ナビゲータよりデバイスタイプメニューのデバイスプロトコルをクリックします。

デバイスプロトコル画面には、アカウントで使用可能なすべてのデバイスプロトコルの一覧が表示されます。

デバイスプロトコルの一覧には、次の情報が表示されます。

• デバイスプロトコルのタイプ（例： Modbus、CANOpen、LoRa）
• デバイスタイプ名
• デバイスのリソース数(右側)

デバイスプロトコルの追加

1. トップメニューバーの右側の デバイスプロトコルを追加 をクリックします。
2. 使用可能なデバイスプロトコルタイプの一覧から、いずれかを選択します。
3. 次のウィンドウより、名前と説明（任意）を入力し、作成をクリックします。
4. デバイスプロトコルの構成設定を入力します。デバイスプロトコルの設定は、プロトコルタイプによって異なります。
   デバイスプロトコルの追加の詳細については、追加する特定のデバイスタイプのマニュアルとプロトコル統合ガイドをご覧ください。
5. 保存をクリックします。

デバイスプロトコルが一覧に追加されます。

デバイスプロトコルのインポート

既存のプロトコルより、デバイスプロトコルを追加する場合は次の手順に従います。

1. トップメニューバーの右側のインポートをクリックします。
2. 事前定義された項目からインポートするデバイスプロトコルを選択するか、ブラウザより参照して、ファイルを読み込んでください。
3. 新しいプロトコルの名前を入力し、インポートをクリックします。

デバイスプロトコルが一覧に追加されます。

デバイスプロトコルの編集

デバイスプロトコルを編集するには、目的のプロトコルをクリックするか、その行の右側にあるメニューアイコンをクリックして編集をクリックします。

フィールドの詳細については、特定のデバイスタイプのマニュアルとプロトコル統合ガイドをご覧ください。

デバイスプロトコルの削除

デバイスプロトコルを削除するには、その行の右側にあるメニューアイコンをクリックし、削除をクリックします。

デバイスプロトコルが一覧から削除されます。

デバイスプロトコルのエクスポート

デバイスプロトコルをエクスポートするには、その行の右側にあるメニューアイコンをクリックし、エクスポートをクリックします。

デバイスプロトコルがダウンロードされます。

デバイスデータの管理

概要

デバイス管理アプリケーションは、デバイスの効率的な管理をサポートするさまざまな機能を提供します。

すべての機能は、ナビゲータの 管理 メニューからアクセスできます。

デバイスファームウェアの管理

ファームウェアリポジトリでは、Things Cloud がデバイスの参照ファームウェアを収集することを提案します。

デバイスごとに 1 つのファームウェアパッケージのバージョンのみを適用できます。

ファームウェアの表示

ナビゲータの 管理 メニューで ファームウェアリポジトリ をクリックします。

利用可能なファームウェアオブジェクトがリストとして表示されます。

各エントリには、ファームウェア名、適用可能なデバイスタイプ（設定されている場合）、特定のファームウェアで利用可能なバージョンがあるかどうか、および利用可能なバージョンがいくつあるかを示すラベルが表示されます。 トップメニューバーの左側で、名前、説明、デバイスタイプでリポジトリエントリをフィルタリングできます。フィルタリング機能の詳細については、はじめに > UI の機能と特長 > 絞り込み（フィルタリング） をご覧ください。

エントリをクリックすると、このファームウェアの詳細が、利用可能なすべてのバージョンとパッチとともに表示されます。

上部には、ファームウェア名、説明、およびオプションのデバイスタイプ フィルターが表示されます。フィルターが設定されている場合、ファームウェアはそのタイプのデバイスに対してのみインストール対象として表示されます。フィルターが設定されていない場合は、すべてのデバイスで利用できます。

バージョンとパッチのリストには、バージョン名とファームウェアバイナリの名前が表示されます。さらに、リストにはファームウェアバージョンにパッチがあるかどうかが示されており、バージョンエントリを展開すると表示できます。バージョンとパッチは作成時間順（降順）に並べられます。

ファームウェア、ファームウェアバージョン、ファームウェアパッチの追加

新しいファームウェア、ファームウェアバージョンを追加する

1. ファームウェアリポジトリ ページで、トップメニューバーの右側にある ファームウェアを追加 をクリックします。
2. 表示されるダイアログボックスで、
   • 新しいファームウェアを追加するには、ファームウェア名を入力し（表示されたウィンドウで 新規追加 をクリックして確定します）、説明とそのバージョンを追加します（すべて必須）。
   • 新しいバージョンを追加するには、ファームウェア フィールドのドロップダウンリストから新しいバージョンを追加するファームウェアを選択し、バージョンを入力します。
3. 任意で、新しいファームウェアを追加するときにデバイスタイプ フィルターを定義できます。
4. ファイルシステムからバイナリをアップロードするか、ファームウェアをダウンロードできる URL を指定します。
5. ファームウェアを追加 をクリックします。
   
   

ファームウェアオブジェクトがファームウェアリストに追加されるか、ファームウェアバージョンがファームウェアの詳細に追加され、それに応じてバージョンラベルが更新されます。

特定のファームウェアの詳細内から ファームウェアを追加 をクリックすると、ファームウェアがすでに選択されているため、ダイアログボックスの外観が若干異なります。新しいバージョン番号を入力し、バイナリをアップロードするか、ファイルパスを指定します。

新しいファームウェアパッチを追加する

1. ファームウェアリポジトリ ページで、トップメニューバーの右側にある ファームウェアパッチを追加 をクリックします。
2. 表示されるダイアログボックスで、ファームウェア フィールドのドロップダウン ストから、パッチを追加するファームウェアを選択します。
3. バージョン フィールドで、パッチを追加するバージョンを選択します。
4. パッチ フィールドにパッチの名前を入力します。
5. ファイルシステムからバイナリをアップロードするか、ファームウェアをダウンロードできる URL を指定します。
6. ファームウェアパッチを追加 をクリックします。

バージョンを追加する場合と同様に、特定のファームウェアの詳細内から ファームウェアパッチを追加 をクリックすると、ファームウェアがすでに選択されているため、ダイアログボックスの外観が若干異なります。

ファームウェアのパッチは、ファームウェアの詳細内のバージョンの詳細に追加されます。

ファームウェアの編集

1. 特定のファームウェアエントリの右側にあるメニューアイコンをクリックし、コンテキストメニューで 編集 をクリックします。
2. 名前、説明、デバイスタイプ フィルターの横にある鉛筆アイコンをクリックして、フィルターを更新します。必要な変更を加え、保存をクリックします。

それに応じてファームウェアも更新されます。

ファームウェア、ファームウェアバージョン、ファームウェアパッチの削除

ファームウェアを削除する

特定のファームウェアエントリの右側にあるメニューアイコンをクリックし、コンテキストメニューで 削除 をクリックします。

オブジェクトはファームウェアリポジトリから削除されます。

ファームウェアのバージョンまたはパッチを削除する

特定のファームウェアの詳細で、削除するバージョンまたはパッチエントリの上にカーソルを置き、削除アイコンをクリックします。ファームウェアの詳細からファームウェアのバージョンまたはパッチが削除されます。

デバイスのファームウェア管理

デバイスの ファームウェア タブでは、デバイスにインストールされているファームウェアを管理できます。

ナビゲータの デバイス メニューで すべてのデバイス をクリックし、デバイスリストから目的のデバイスを選択して、その ファームウェア タブを開きます。

ファームウェア タブには、デバイスにインストールされている現在のファームウェアが表示されます。

さらに、最後のオペレーションの操作ステータス（SUCCESSFUL、PENDING、EXECUTING、FAILED のいずれか）も表示されます。操作をクリックすると、操作の詳細が表示されます。

デバイスにファームウェアをインストール／交換する

1. ファームウェア タブで、ファームウェアをインストール（デバイスにすでにファームウェアがインストールされている場合は、Replace firmware）をクリックします。
2. リストからファームウェアと目的のバージョンを選択します。リストには、ファームウェアリポジトリ内の特定のデバイスタイプ(またはデバイスタイプのないもの)で使用可能なすべてのファームウェアが含まれています。
3. インストール をクリックします。

デバイスによって実行されるインストールオペレーションが作成されます。デバイスが操作を実行すると、すぐにファームウェアのインストールは完了します。

操作をクリックして詳細を表示します。最後の操作のステータスは、ファームウェア タブにも表示されます。

複数のデバイスにファームウェアをインストール／更新する

Things Cloud は、複数のデバイスのファームウェア更新を一度に実行するオプションを提供します。

1. 単一デバイス上でファームウェア操作（インストールまたは交換）を実行し、新しいバージョンが動作することをテストします。
2. 制御 タブで操作に移動し、コンテキストメニューで 一括操作としてスケジュール を選択します。
3. フィールドに入力して一括操作をスケジュールし、作成 をクリックします。一括操作の詳細については、デバイスの監視と制御をご覧ください。

一括操作のステータスは、デバイス制御 の 一括操作タブに表示されます。

さらに、選択したデバイスの 制御 タブに操作の詳細が表示されます。

デバイスソフトウェアの管理

ソフトウェアリポジトリでは、Things Cloudがデバイスの参照ソフトウェアを収集することを提案しています。複数のソフトウェアパッケージをデバイスにインストールできます。

ソフトウェアの表示

ナビゲータの 管理 メニューで ソフトウェアリポジトリ をクリックします。

使用可能なソフトウェアオブジェクトがリストとして表示されます。

各エントリには、ソフトウェア名、利用可能なデバイスタイプ（設定済の場合）、ソフトウェアタイプ（設定済の場合）、特定のソフトウェアで利用可能なバージョンの有無と、その数を示すバッジが表示されます。 バージョン 列を除くすべての列の値は、列ヘッダーのフィルターアイコンと並べ替えアイコンをクリックして、フィルタリングと並べ替えができます。

エントリをクリックすると、ソフトウェアの詳細と利用可能なすべてのバージョンが表示されます。

上部には、ソフトウェア名、説明、任意のデバイスタイプ フィルター、ソフトウェアタイプが表示されます。 デバイスタイプ フィルターが設定されている場合、ソフトウェアはそのタイプのデバイスに対してのみインストール対象として表示されます。 フィルターが設定されていない場合は、すべてのデバイスで使用できます。 ソフトウェアタイプにより、特定のソフトウェアタイプをサポートするデバイスにのみ、ソフトウェアをインストールできるようになります。

バージョンのリストには、バージョン名とソフトウェアバイナリの名前が表示されます。 バージョンは作成時間順（降順）に並べられます。

新しいソフトウェアまたはソフトウェアバージョンの追加

1. ソフトウェアリポジトリ ページで、トップメニューバーの右側にある ソフトウェアを追加 をクリックします。
2. 表示されるダイアログボックスで、
   • 新しいソフトウェアを追加するには、ソフトウェア名（表示されたウィンドウで 新規追加 をクリックして確認します）、説明、バージョン（すべて必須）を入力します。
   • 新しいバージョンを追加するには、ソフトウェア フィールドのドロップダウンリストから新しいバージョンを追加するソフトウェアを選択し、バージョンを入力します。
3. 任意で、新しいソフトウェアを追加するとき、デバイスタイプ フィルターを定義できます。
4. ソフトウェアタイプを定義します。これにより、特定のソフトウェアタイプをサポートすると宣言したデバイスにのみ、ソフトウェアをインストールできるようになります。
5. ファイルシステムからバイナリをアップロードするか、ソフトウェアをダウンロードできる URL を指定します。
6. ソフトウェアを追加 をクリックします。
   
   

ソフトウェアオブジェクトがソフトウェアリストに追加されるか、ソフトウェアバージョンがソフトウェアの詳細に追加され、それに応じてバージョン数ラベルが更新されます。

特定のソフトウェアの詳細ページ内で ソフトウェアを追加 をクリックすると、ソフトウェアがすでに選択されているため、ダイアログボックスの外観が若干異なります。新しいバージョン番号を入力し、バイナリをアップロードするか、ファイル パスを指定します。

ソフトウェアの編集

1. 特定のソフトウェア項目の右側にある 編集 アイコンをクリックします。
2. 横にある鉛筆アイコンをクリックして、名前、説明、デバイスタイプ フィルタ－、ソフトウェアタイプを更新します。必要な変更を加え、保存をクリックします。

それに応じてソフトウェアも更新されます。

ソフトウェア項目またはソフトウェアバージョンの削除

ソフトウェアを削除する

特定のソフトウェア項目の右側にある 削除 アイコンをクリックします。

ソフトウェアとすべてのバージョンは、ソフトウェアリポジトリから削除されます。

ソフトウェアバージョンを削除する

特定のソフトウェアの詳細で、削除するバージョンエントリの上にカーソルを置き、削除アイコンをクリックします。 ソフトウェア詳細からソフトウェアバージョンが削除されます。

デバイスのソフトウェア管理

デバイスの ソフトウェア タブでは、特定のデバイスのソフトウェアを管理できます。

ナビゲータの デバイス メニューで すべてのデバイス をクリックし、デバイスリストから目的のデバイスを選択して、ソフトウェア タブを開きます。

ソフトウェア タブには、デバイスにインストールされている利用可能なすべてのソフトウェアのリストが表示されます。特定のソフトウェアにタイプがある場合は、名前の横に表示されます。特定のソフトウェアを名前で検索したり、ソフトウェアタイプでリストをフィルタリングできます。

さらに、最後の操作に対して操作ステータス（SUCCESSFUL、PENDING、EXECUTING、FAILED のいずれか）が表示されます。操作をクリックすると、操作の詳細が表示されます。

デバイスにソフトウェアをインストールする

1. ソフトウェア タブで、ソフトウェアのインストール をクリックします。

2. ソフトウェアリポジトリで、利用可能な特定のデバイスタイプに対して、すべてのソフトウェア項目を含むリストからそれぞれのバージョンを選択し、1 つまたは複数のソフトウェア項目を選択します。 高度なソフトウェア管理機能をサポートするデバイスの場合、すでにインストールされているソフトウェア項目を、利用可能なソフトウェア項目のリストから事前にフィルタリングすることはできません。 したがって、特定のソフトウェアバージョンが選択された後、選択されたソフトウェアがすでにデバイスにインストールされているかどうかチェックされます。この場合、選択したバージョンの横に警告が表示され、このソフトウェアバージョンがデバイスにすでに存在することが示されます。 ソフトウェアの変更 ですでにインストールされているソフトウェア項目を削除することも、そのままにして変更の一部として適用することもできます。このような更新をどのように処理するかを決定するのは、デバイスエージェント次第です。

3. インストール をクリックします。

4. 右側の ソフトウェアの変更 で、計画した変更を確認し、変更の適用 をクリックしてソフトウェアの更新操作を確認します。

デバイスによって実行されるインストール操作が作成されます。ソフトウェアのインストールは、デバイスが操作を実行すると直ちに完了します。

操作をクリックして詳細を表示します。最後の操作ステータスは、ソフトウェア タブにも表示されます。

デバイスのソフトウェアを更新する

更新するソフトウェア項目の上にカーソルを置き、更新 をクリックします。 リストからバージョンを選択し、もう一度 更新 をクリックします。

ソフトウェアは選択したバージョンで更新されます。

デバイスからソフトウェアを削除する

削除するソフトウェア項目の上にカーソルを置き、削除アイコンをクリックします。

複数のデバイスにソフトウェアをインストールする

Things Cloud は、複数のデバイスのソフトウェア更新を一度に実行するオプションを提供します。

1. 単一デバイスでソフトウェア操作（インストールまたはアップデート）を実行し、新しいバージョンが動作することをテストします。
2. 制御 タブで操作に移動し、コンテキストメニューで 一括操作としてスケジュール を選択します。
3. フィールドに入力して一括操作をスケジュールし、作成 をクリックします。一括操作の詳細については、デバイスの監視と制御をご覧ください。

一括操作のステータスと詳細は、デバイス制御の一括操作タブに表示されます。

さらに、選択したデバイスの 制御 タブに操作の詳細が表示されます。

構成の管理

Things Cloudでは、構成データを取得し、構成リポジトリに格納して管理することができます。構成データには、デバイスのパラメータと初期設定が含まれます。

構成スナップショットは、例えば、次のような、同じ構成を複数のデバイスに適用する場合に役立ちます。

ナビゲータの 管理 メニューから 構成リポジトリ をクリックします。構成リポジトリ 画面には使用可能なすべての構成が表示されます。各エントリには、構成の名前と説明、デバイスタイプ、構成タイプが表示されます。

構成スナップショットの追加

1. トップメニューバーの右側にある 構成スナップショットを追加 をクリックします。
2. 表示されるダイアログボックスに、一意の名前を入力します。
3. デバイスタイプ フィールドに、デバイスタイプを入力します。デバイスタイプは、対象デバイスの 情報 タブで確認できます。
4. 必要に応じて、構成の説明を入力します。
5. 構成タイプ（例：「ssh」）を入力します。
6. ファイルをアップロードするか、スナップショットの取得先外部 URL を入力するか、ファイルを選択して、構成スナップショットファイルを指定します。
7. 構成を追加 をクリックします。

構成スナップショットが構成リポジトリに追加されます。

構成スナップショットの編集

構成スナップショットを編集するには、行の右側にあるメニューアイコンをクリックし、編集 をクリックします。

フィールドの詳細については、構成スナップショットの追加 をご覧ください。

構成を更新 をクリックして変更を保存します。

構成スナップショットの削除

構成スナップショットを削除するには、行の右側にあるメニューアイコンをクリックし、削除 をクリックします。

構成スナップショットは、構成スナップショットリポジトリから削除されます。

構成スナップショットを取得して適用する

構成の管理、つまりデバイスからの構成の要求とデバイスへの構成の送信は、複数の方法で行うことができます。ユーザー権限とデバイス設定に応じて、テキストベース、入力されたファイルベース、従来のファイルベースの構成を使用できます。 詳細および技術情報については、「リファレンス ガイド」の デバイス管理ライブラリ > 構成 をご覧ください。

構成スナップショットを取得して、型指定されたファイルベースの構成をサポートするデバイスに適用する

型指定されたファイルベースの構成を使用することをお勧めします。型指定されたファイルベースの構成を使用すると、デバイスは複数の構成を同時に管理できます。さまざまなタイプのさまざまな構成をアップロードまたは取得できます。このアプローチを使用すると、構成がファイルではなくイベントとして処理され、より効率的で、より汎用性が高くなります。

1. デバイス > すべてのデバイス で目的のデバイスに移動し、その 構成 タブを開きます。
2. デバイスでサポートされている構成 で、目的の構成タイプを選択し、右側にある デバイスから新しいスナップショットを取得 をクリックします。

スナップショットを取得したら、プレビュー セクションでスナップショットを保存またはダウンロードできます。スナップショットは 構成リポジトリ に追加され、ナビゲータの 管理 メニューからアクセスできます。

複数の構成タイプをサポートするデバイスに、構成スナップショットを適用するには、次の手順を実行します。

1. 目的のデバイスに移動し、構成 タブを開きます。
2. デバイスでサポートされている構成 で、目的の構成タイプを選択します。
3. 使用可能なサポートされている構成で、構成ファイルを選択します。
4. 右側にある 構成をデバイスに送信 をクリックして、選択したスナップショットをデバイスに適用します。

従来のファイルベースの構成をサポートするデバイスに、構成スナップショットを取得して適用する

構成をファイルとして管理するデバイスは、従来のファイルベースの構成を使用して基本的な形式で構成を管理できます。従来のファイルベースの構成では、デバイスごとに 1 つの構成しか設定できません。

テキストベースの構成をサポートするデバイスに、構成スナップショットを取得して適用する

最も基本的な構成形式は、テキストベースの構成です。 テキストコマンドはデバイスから送信または受信できます。人間が判読できる短い構成ファイルに対してのみ、テキストベースの構成を使用することをお勧めします。

デバイス資格情報の管理

デバイス資格情報タブには、接続されているデバイスに対して生成されたすべての資格情報が表示されます。登録済みの各デバイスは、「device_<id>」という命名規則でここに表示されます。

デバイスの権限の管理

1. デバイスの グローバルロール 列にある矢印をクリックして、使用可能なグローバルロールのリストを開きます。
2. ロールを選択または選択解除して個々のデバイスの権限を割り当てまたは削除します。
3. 適用 をクリックします。

デバイスのロールが更新されます。

デバイス資格情報の編集

1. デバイス資格情報の行の右にあるメニューアイコンをクリックし、編集 をクリックしてデバイスの詳細を開きます。

2. 詳細画面のアクティブスライダーより、デバイスを有効/無効にすることができ、さらに、パスワードの変更、グローバルロールの選択/選択解除などが行えます。

   

3. 保存をクリックします。

デバイス資格情報が更新されます。

デバイス資格情報の無効化

デバイス資格情報の行の右にあるメニューアイコンをクリックし、無効化をクリックします。

デバイス資格情報は一時的に無効化されます。

デバイス資格情報の削除

デバイス資格情報の行の右にあるメニューアイコンをクリックし、削除をクリックします。

デバイス資格情報が完全に削除されます。

デバイスの資格情報の削除は、デバイスに対して出荷時リセットを実行したいときに必要になります。リセットすると、多くの場合デバイスに割り当てられた資格情報が失われます。デバイスを一度削除し、通常の登録処理を続行してデバイスを再登録してください。

デバイスプロファイルの管理

デバイスプロファイルは、デバイスに展開できるファームウェアバージョン、1 つまたは複数のソフトウェアパッケージおよび構成ファイルの組み合わせを表します。デバイスプロファイルに基づいて、ユーザーは一括操作を使用して特定のターゲット構成をデバイスに展開できます。

デバイスプロファイルの表示

ナビゲータの 管理 メニューで デバイスプロファイル をクリックして、デバイスプロファイル 画面にアクセスします。この画面には、使用可能なすべてのデバイスプロファイルが一覧表示されます。

各デバイスプロファイル エントリには、プロファイル名と選択したデバイスタイプ（存在する場合）が表示されます。

デバイスプロファイル名をクリックして詳細を表示します。

名前とデバイスタイプ セクションには、プロファイル名と、任意で選択されたデバイスタイプが表示されます。

以下のセクションでは、この特定のデバイスプロファイルのファームウェアバージョン、ソフトウェアパッケージ、構成ファイルを示します。

デバイスプロファイルの追加

トップメニューバーの右側にある デバイスプロファイルを追加 をクリックして、新しいデバイスプロファイルを追加します。

デバイスプロファイルを追加 ウィンドウで、プロファイル名を指定し、必要に応じて 1 つ以上のデバイスタイプを入力します。デバイスタイプが指定されている場合、デバイスプロファイルは指定されたタイプのデバイスにのみ割り当てることができます。空のままにすると、すべてのデバイスタイプで使用できます。

デバイスプロファイルに項目を追加する

デバイスプロファイルの詳細では、ファームウェアバージョン、ソフトウェアパッケージ、構成ファイルを追加できます。

ファームウェアを追加 をクリックして、ファームウェアバージョンをプロファイルに追加します。 リストからファームウェアとバージョンを選択し、保存 をクリックして選択内容をプロファイルに追加します。プロファイルにデバイスタイプが定義されている場合は、そのデバイスタイプに一致するファームウェアバージョンのみを選択できます。プロファイルに追加できるファームウェアバージョンは 1 つだけです。

ファームウェアの詳細については、デバイスファームウェアの管理をご覧ください。

ソフトウェアを追加 をクリックして、ソフトウェアパッケージをプロファイルに追加します。リストからソフトウェアとソフトウェアバージョンを選択し、保存 をクリックして選択内容をプロファイルに追加します。プロファイルにデバイスタイプが定義されている場合、そのデバイスタイプに一致するソフトウェアバージョンのみを選択できます。複数のソフトウェアパッケージをプロファイルに追加できます。

ソフトウェアの詳細については、デバイスソフトウェアの管理をご覧ください。

構成を追加 をクリックして、構成ファイルをプロファイルに追加します。リストから構成ファイルを選択し、保存 をクリックして選択内容をプロファイルに追加します。複数の構成ファイルをプロファイルに追加できます。

構成スナップショットの詳細については、構成の管理をご覧ください。

デバイスプロファイルの更新

デバイスプロファイルを更新するには、各デバイスプロファイル エントリの右側にあるメニューアイコンをクリックし、編集 をクリックします。

それぞれのフィールドの横にある鉛筆アイコンをクリックすると、デバイスプロファイルの名前とデバイスタイプを編集できます。必要な変更を加え、保存 をクリックして編集内容を保存します。

さらに、ファームウェア、ソフトウェア、構成項目を削除したり、新しい項目を追加したりすることができます。

項目を削除するには、項目の上にカーソルを置き、削除アイコンをクリックします。

ファームウェア、ソフトウェア、構成項目の追加方法の詳細については、デバイスプロファイルに項目を追加する をご覧ください。

ファームウェアの場合、プロファイル内で一度に許可される項目は 1 つだけであることに注意してください。

デバイスプロファイルの複製

デバイスプロファイルを複製するには、それぞれのデバイスプロファイル エントリの右側にあるメニューアイコンをクリックし、複製 をクリックします。

プロファイルを複製すると、同じ内容を持つプロファイルの別のインスタンスが作成されます。デフォルトでは、元のプロファイル名は「Duplicate of…」で拡張されます。名前フィールドの横にある鉛筆アイコンをクリックして編集すると、プロファイルにさらに適切な名前を付けることができます。

デバイスプロファイルの削除

デバイスプロファイルを削除するには、それぞれのデバイスプロファイル エントリの右側にあるメニューアイコンをクリックし、削除 をクリックします。

デバイスへのデバイスプロファイルの適用

デバイスプロファイルを割り当てることができます。

• 個々のデバイス
• 一括操作による複数のデバイス

特定のデバイスの デバイスプロファイル タブには、デバイスに現在インストールされているプロファイルの詳細が表示されます。

デバイスプロファイルを単一のデバイスに適用する

デバイスプロファイルは、特定のデバイスの デバイスプロファイル タブで個々のデバイスに適用できます。

1. デバイスプロファイル タブで、ドロップダウンリストからデバイスプロファイルを選択します。 デバイスタイプ（指定されている場合）に一致するプロファイル、またはデバイスタイプが指定されていないプロファイルのみが表示されます。

2. デバイスプロファイルの割り当て をクリックして、更新操作を開始します。

デバイスプロファイルを複数のデバイスに適用する

1. 概要 メニューの デバイス制御 をクリックして、デバイス制御 画面に移動します。デバイス制御 画面では、デバイスプロファイルを適用するための新しい一括操作を作成できます。
2. 一括操作 タブで、トップメニューバーの右側にある 新規一括操作 をクリックし、表示されたダイアログで デバイスプロファイルを適用 を選択します。
3. デバイスの監視と制御 > オペレーションの操作 > 一括操作の追加 で説明されている手順に従って、デバイスプロファイルを適用する一括操作をスケジュールします。

デバイスは、プロファイルのファームウェア、ソフトウェア、構成項目をインストールし、操作のステータスを報告します。プロファイルを適用すると、プラットフォーム内のデバイスオブジェクトが新しいプロファイル情報に応じて更新されます。

信頼できる証明書の管理

Things Cloud では、認証に X.509 証明書を使用して、MQTT プロトコル経由でデバイスが接続できるようになります。そのためには、証明書が Things Cloud によって信頼されている必要があります。証明書は、信頼できる証明書に追加され、有効化された状態になると信頼されます。

ナビゲータの 管理 メニューで 信頼できる証明書 をクリックします。

テナントが所有する証明書がすべて表示されます。

ステータス 列は、証明書が有効か無効かを示します。 テナントはいつでも、任意の数の有効または無効な証明書を持つことができます。

右側の矢印アイコンをクリックして証明書を展開すると、詳細が表示されます。

右側の表の情報は、提供された証明書から抽出されたものです。内容は読み取り専用であり、変更できません。

証明書の追加

新しい信頼できる証明書を追加する前に、以下を確認してください。

• PEM 形式の X.509 証明書 であること
• バージョン 3 であること
• BasicConstraints:[CA:true] が含まれていること
• Things Cloud にアップロードされていないこと
• 有効な期限内であること（期限切れでないこと）

証明書を追加するには、次の手順を実行します。

1. トップメニューバーの右側にある 信頼できる証明書を追加 をクリックします。

2. 表示されるダイアログボックスで、次の情報を入力します。

3. 証明書を追加 をクリックして証明書を検証し、保存します。

信頼できる証明書の編集

証明書の詳細ビューでは、左側のパラメータ、つまり証明書名、自動登録および有効化／無効化オプションの設定を変更できます。

フィールドの詳細については、上記の証明書の追加に関する説明をご覧ください。

信頼できる証明書の削除

信頼できる証明書リストから証明書を完全に削除するには、それぞれのエントリの右側にあるメニューアイコンをクリックし、コンテキストメニューで 削除 をクリックします。

証明書は完全に削除されます。

SmartRESTテンプレート

はじめに

SmartRESTテンプレートとは、CSVデータとThings Cloud Rest APIコールを変換するために使用されるリクエストテンプレートとレスポンステンプレートのコレクションです。例えば、毎回手動でリクエストを作成するのではなく、SmartRESTテンプレートを使用することでデバイスをプラットフォームに簡単に追加できます。

デバイスの統合を容易にするために、Things Cloudは独自のテンプレートを作成することなく使用できる静的テンプレートに対応しています。これらのテンプレートは、デバイス管理に最もよく使用されるメッセージのみに焦点を当てています。静的テンプレートの詳細については、リファレンス ガイドをご覧ください。

ナビゲータの デバイスタイプ メニューから SmartRESTテンプレート 画面を開きます。

テンプレートごとに、次の情報が表示されます。

• テンプレート名
• テンプレートID
• メッセージ数
• レスポンス数

SmartRestテンプレートを追加するには、次の2つの方法があります。

• 既存のテンプレートをインポート
• 新規のテンプレートを作成

既存のSmartRESTテンプレートのインポート

1. トップメニューバーの右側にある テンプレートのインポート をクリックします。
2. 次のウィンドウで、アップロードするファイルを選択します。
3. テンプレート名と一意のテンプレートID（両方必須）を入力します。
4. インポート をクリックして、テンプレートをインポートします。

新規のSmartRESTテンプレートの作成

1. トップメニューバーの右側にある テンプレートの作成 をクリックします。
2. 次のウィンドウで、テンプレート名と一意のテンプレートID（両方必須）を入力します。
3. 次へをクリックして、メッセージまたはレスポンスの追加を継続します。

メッセージの追加

メッセージテンプレートには、SmartRestリクエストを対応する（プラットフォームへ送信される）Rest APIコールに変換するために必要なすべての情報が含まれています。

1. 新しいメッセージを追加するには、目的のSmartRESTテンプレートの メッセージ タブに移動し、メッセージを追加 をクリックします。

2. 次のフィールドを入力します。

   フィールド	説明
   メッセージID	メッセージ識別子として使用される固有の値。テンプレートの中ですべてのメッセージとレスポンスが一意である必要があります。
   名前	メッセージの名前。必須
   対象のREST API	対象のREST API。ドロップダウンリストより選択。次のいずれかになります：アラーム、イベント、インベントリ、操作、メジャーメント
   方法	リクエストメソッドです。選択した対象のREST APIに応じて、POST、PUT、GETのいずれかになります。
   レスポンスを含む	リクエストの結果をレスポンステンプレートで処理する場合は、このチェックボックスを選択します。
   REST API組み込みフィールド	これらのフィールドはオプションであり、選択した対象のREST APIによって異なります。値を設定しない場合、デバイスは、実際にメッセージを送信するときに設定できます。
   REST APIカスタムフィールド	フィールドを追加 をクリックして、新しくフィールドを追加することができます。APIキーを入力し、目的のデータ型を選択します。

   

   下のプレビューに、リクエストメッセージのプレビューが表示されます。

3. 保存をクリックします。

メッセージがSmartRESTテンプレートに追加されます。

メッセージの削除

メッセージを削除するには、メッセージを開き、一番下にある削除をクリックします。

メッセージがSmartRESTテンプレートから削除されます。

レスポンスの追加

レスポンステンプレートには、プラットフォームREST APIコールのレスポンスからデータ値を抽出するために必要な情報が含まれており、そのデータ値はCSVデータフォーマットでクライアントに送り返されます。

1. 新規のレスポンスを追加するには、目的のSmartRESTテンプレートのレスポンスタブに移動し、レスポンスを追加をクリックします。

2. 次のフィールドを入力します。

   フィールド	説明
   レスポンスID	レスポンスIDとして使用される固有の文字列
   名前	レスポンスの名前。必須
   ベースパターン	レスポンスのベースパターン
   条件	レスポンスの条件値
   パターン	少なくとも 1 つのパターンが必要です。パターンを追加 をクリックし、パターン値を入力します。

   

3. 保存をクリックします。

レスポンスがSmartRESTテンプレートに追加されます。

詳細については、「リファレンスガイド」の SmartREST 1.0 > テンプレート > 応答用テンプレート をご覧ください。

レスポンスの削除

削除したいレスポンスをクリックして開き、一番下にある削除をクリックします。

SmartREST テンプレートの編集

目的のテンプレートをクリックするか、テンプレートカードの右上にあるメニューアイコンをクリックして編集をクリックします。

編集後、保存をクリックして設定を保存します。

SmartREST テンプレートの削除

目的のテンプレートカードの右上にあるメニューアイコンをクリックして削除をクリックします。

SmartREST テンプレートをエクスポート

目的のテンプレートカードの右上にあるメニューアイコンをクリックしてエクスポートをクリックします。

テンプレートがダウンロードされます。

SmartRESTテンプレートをCSVファイルとしてエクスポートするには、次の手順に従います。

1. エクスポートしたいテンプレートを開き、CSVプレビュータブを選択します。
2. メッセージとレスポンスに関する追加情報を表示しているCSVプレビュータブにあるクリップボードにコピーをクリックします。

SmartRESTテンプレートはCSVファイルとしてエクスポートされます。

シミュレーターの操作

Things Cloudシミュレーターを使用して、IoTデバイスのすべての側面をシミュレートすることができます。

• シミュレートされたデバイスまたはシミュレートされたデバイスのネットワークの設定ができます。
• デバイスが処理できるオペレーションの指定ができます。
• 事前定義のメッセージテンプレートまたはユーザー定義のテンプレートに基づいて作業指示を作成し、作業ステップをスケジュールします。
• 定義されたタイプのデバイスを最大10個作成できます。
• メジャーメント、アラーム、イベント、インベントリに関するメッセージの生成をします。
• シミュレーションの問題をアラームとして表示します。

シミュレーターについて

シミュレーターを使用すると、接続されたハードウェアデバイスと同じレベルの機能をシミュレートするデバイスを作成できます。

シミュレーターは、デバイスがThings Cloudプラットフォームに送信するメッセージをシミュレートするためにプレイリストを使用します。プレイリストとは、シミュレーターが次々に実行する一連の指示文のことです。最後の指示文に達すると、シミュレーターは最初の指示文へ戻り、再開します。

指示文とは、メッセージ（メジャーメント、アラーム、イベント、インベントリ）を送信するか、または、指定された時間待機をします（スリープ）。

メッセージを定義するには、メッセージテンプレート（「温度測定を作成」など）を選択し、このテンプレートの値を入力します（「23.0(度)」など）。メジャーメントの作成、イベントの送信、アラームの作成とキャンセルなど、多くの定義済みメッセージテンプレートが用意されています。これらのテンプレートはMQTT静的テンプレートに基づいています。さらに、SmartRESTテンプレートを使用して、カスタムメッセージ テンプレートを定義できます。

シミュレーターの表示

ナビゲータで、デバイスメニューのシミュレーターをクリックし、シミュレーターページを開きます。

シミュレーターの作成

1. トップメニューバーの右側にある シミュレーターを追加 をクリックします。
2. 次のウィンドウで、プリセットフィールドのドロップダウンリストからシミュレーターのタイプを選択します。「空のシミュレーター」を選択してシミュレーターを最初から作成するか、定義済みシミュレーターのいずれかを選択します。
3. シミュレーター名を入力します。
4. このシミュレーターのインスタンス数を選択します(最大10)。
5. 作成をクリックします。

シミュレーターが作成され、リストに追加されます。

シミュレーターの編集

1. シミュレーターカードの右上にあるメニューアイコンをクリックして編集をクリックするか、シミュレーターカードをクリックします。
2. 次のウィンドウで、必要な変更を行います。
3. 保存をクリックし、変更を適用します。

シミュレーターの複製

1. シミュレーターカードの右上にあるメニューアイコンをクリックして複製をクリックします。
2. 次のウィンドウで、新しいシミュレーター名を入力します。
3. 複製をクリックします。

新しいシミュレーターがリストに追加されます。

シミュレーターの削除

1. シミュレーターカードの右上にあるメニューアイコンをクリックして削除をクリックします。
2. 次のウィンドウで、シミュレーターの削除を確認します。
3. 保存をクリックします。

シミュレーターがリストから削除されます。

指示

シミュレーターごとに、シミュレーターの動作を定義する指示文を作成できます。指示文はプレイリストに追加される 1つのタスクで、シミュレーターはこのタスクに従って動作します。

指示文は、シミュレーターの 指示 タブで表示および編集できます。

例

プリセット内には、サンプル指示文がすでに追加されています。例えば、「温度計測」プリセットには、「計測を作成する」と「スリープ」の手順がすでに含まれています（上記の図参照）。

右側のパネルは、左側で選択した指示文のタイプに応じて変わります。

メジャーメントの指示文はフラグメントを参照します。フラグメントは、マネージドオブジェクトの機能を識別するために使用されます。フラグメントの詳細については「リファレンスガイド」のセンサー・ライブラリをご覧ください。

「スリープ」には、継続時間の値が秒単位で必要です。

指示の追加

1. 指示を追加 をクリックして、シミューレーターに新しい指示を追加します。
2. 次のウィンドウのドロップダウンリストより、メッセージを選択します。
3. メッセージタイプによって、必要なパラメータをそれぞれ指定します。
4. 保存をクリックします。

新しい指示がシミュレーターに追加されます。

スリープの追加

1. スリープを追加をクリックして、シミューレーターに新しい指示を追加します。
2. 次のウィンドウで継続時間を指定します。
3. 保存をクリックします。

新しいスリープの指示がシミュレーターに追加されます。

指示の削除

削除したい指示またはスリープにカーソルを合わせ、右に表示された削除アイコンをクリックします。

指示はシミュレーターから削除されます。

サポートされている操作

サポートされている操作タブでは、 構成設定やソフトウェア/ファームウェアの更新などの特定の操作が表示されます。

スライダーをクリックして、目的の操作をオンまたはオフにできます。

カスタム操作の追加

1. カスタム操作を特定したい場合、カスタム操作を追加をクリックします。
2. 次のウィンドウで、シミュレーターがサポートするカスタム操作タイプを入力します。
3. 追加をクリックします。

操作リストにカスタム操作が追加されます。

アラーム (シミュレーター)

シミュレーターのアラームタブには、（シミュレートされたデバイスではなく）シミュレーター自体に関するアラームが表示されます。つまり、シミュレーター自体が正しく動作しない場合、ここにアラームが表示されません。アラームについては、アラームの操作をご覧ください。