コックピット

概要

以下のセクションでは、コックピットアプリケーションのすべての機能について詳しく説明します。

このページの内容の概要については、以下をご覧ください。

Things Cloudとそのアプリケーションの一般的側面について詳しく知りたい方は、はじめに をご覧ください。

ホームダッシュボード

コックピットアプリケーションのホーム画面は一般的なテナントのデータを表示するダッシュボードとなります。

ホームダッシュボードはテナントの全ユーザーが共有するページです。デフォルトでは、ホームダッシュボードには、ようこそメッセージ、アクティブなクリティカルアラーム、最近のアラーム、そして全オブジェクトの地図が表示されます。

ホームダッシュボードは、必要に応じて個別に編集および構築できます。ここに表示されているウィジェットを追加、削除、または変更できます。

ダッシュボードの編集の詳細については ダッシュボードの操作 をご覧ください。

ホームダッシュボードを元の内容へリセットするには、トップメニューバーの右端にある 参照 をクリックし、ダッシュボードを復元 を選択します。

アセット管理

アセット階層

アセットは建物、機械、製造単位、車両などの一般的なビジネスオブジェクトを表します。

アセットは階層形式で整理されます。例えば、エネルギーモニタリング アプリケーションのアセット階層は以下のようになると考えられます。

アセット階層は以下の2種類のオブジェクトで構成されます。

• グループ: 個々のデバイス、または他のグループをグループ化したものです。コックピットアプリケーションまたはデバイス管理アプリケーションで作成できます。

• デバイス: アセット階層内にリンク付けされるデバイスを指します。コックピットアプリケーションでデバイスを使用する前に、Things Cloudに接続する必要があります。これはデバイス管理アプリケーションで行います。デバイスの接続方法については、デバイス管理セクションの デバイスの接続をご覧ください。

この例では、グループオブジェクトは建物のアセットを表しています。 デバイスオブジェクトは部屋のアセットを表します。 グループ名と階層は、ユーザーが個別に定義することができます。 階層には、地域レベル、都市レベル、街路レベル、建物レベル、フロアレベル、部屋レベルなど、複数のレベルを設定できます。 デバイスもさまざまな階層内に設定することができ、地域階層の一部にしたり、顧客階層の一部にすることができます。

アセット階層内でデバイスを配置するには、デバイスを個別のグループに「割り当て」なければなりません。 下記をご覧ください。

アセット階層とデバイス階層の対比

Things Cloudは２種類のオブジェクト階層に対応しています。それは、デバイス階層とアセット階層です。

デバイス階層は、通信の視点からThings Cloudにデバイスがリンクされる状況を追跡します。アセット階層は、M2Mデバイス経由での遠隔操作により監視および制御されているアセットを構造化します。 詳しくは、コンセプトガイドの「Things Cloudのドメインモデル」をご覧ください。

コックピットアプリケーション内で、グループオブジェクトを作成し、デバイスを階層にリンクさせることにより、アセット階層を構築することができます。アセット階層は、使用するIoTデバイスの種類で決まります。 多数のIoTデバイスが存在しますが、ごく一般的なのは以下の2種類になります。

• スマートデバイス はセンサー、アクチュエータおよび通信モジュールを含む、内蔵型デバイスです。大抵は単一のアセットに接続されてます。スマートデバイスとは追跡装置、測候所または通信モジュールを組み込んだ「スマート」センサーなどになります。
• ゲートウェイデバイス は他のデバイスからThings Cloudへの通信を確立する役割を果たしますが、センサーまたはアクチュエータを含みません。ゲートウェイデバイスの典型例として Zigbee、Modbus、M-BusまたはKNXゲートウェイが挙げられます。

次のセクションでは、コックピットアプリケーションでスマートデバイスとゲートウェイデバイスを使用する方法について説明します。

最初の例は、スマートデバイスをアセット階層にリンクする方法を示しています。

スマートデバイスは、デバイス管理アプリケーションにおいて最上位デバイスとして表示されます。コックピットアプリケーションでは上図の矢印が示す通り、スマートデバイスをグループに分けて整理することができます。

2番目の例は、コックピットアプリケーション上でゲートウェイデバイスを使用する方法を示しています。

ゲートウェイデバイスは、デバイス管理アプリケーションにおいて最上位デバイスとして表示されます。付随するデバイス（例えば、ModbusやKNXデバイス）は子デバイスとして表示されます。これらの子デバイスを前述の通り、アセット階層内で整理することができます。

例からわかるように、デバイスはデバイス管理アプリケーションとコックピットアプリケーションでまったく異なる階層を持つことができます。デバイス管理アプリケーション内ではすべての子デバイスがゲートウェイデバイスより下位になる一方、同じ子デバイスがコックピットアプリケーションでは2つの別々の建物内で整理されます。

コックピットアセットとビジネスアセットの対比

コックピットアセット階層におけるオブジェクトのマッピングは仮想的な階層構造です。

例えば、Things Cloudプラットフォームの中でトラックの管理を行うとすると、それぞれのトラックはThings Cloudと接続している個別のトラッキングデバイスを介して表現されることになります。

建物マネジメントの場合、建物の中にあるセンサーのグループがThings Cloudプラットフォームと通信するグループとして建物を表すのが最も一般的です。

アセットのナビゲート方法

アセット階層では、Things Cloudは最上階層グループとサブグループを区別します。サブアセットは、他のグループまたはデバイスにすることができます。

ナビゲータでは、グループメニューの最上位に最上階層グループが表示されます。サブアセットは、最上階層のグループの下に表示されます。

さらに、サブアセットは、ナビゲータでグループをクリックすると、最初に表示される特定のグループのサブアセットタブに表示されます。

ナビゲータを使用して、アセット階層内を移動します。

アセットの詳細

アセットタイプ（グループまたはデバイス）に応じて、詳細情報を含むさまざまなタブが利用可能です。

グループには、次のタブが表示されます。

• サブアセット － グループの詳細とグループのすべてのサブアセットを表示します。デバイス管理 > デバイスの表示をご覧ください。
• スマートルール － グループに指定されたスマート ルールを表示します。スマート ルール をご覧ください。
• データエクスプローラ － 子のすべてのデータポイントを表示します。詳細については、データエクスプローラを使用したデータの可視化をご覧ください。

デバイスには、次のタブが表示されます。

• 情報 － デバイスに指定されたスマート ルールを表示します。スマートルールをご覧ください。
• アラーム － デバイスのアラームを表示します。デバイス管理 > アラームの操作をご覧ください。
• データエクスプローラ － 子のすべてのデータポイントを表示します。 詳細については、データエクスプローラを使用したデータの可視化をご覧ください。
• 位置 － デバイスの現在の位置を表示します（c8y_Position でのみ利用可能）。

グループまたはデバイス用にダッシュボードが作成されている場合、タブとしても追加されます。詳細については、ダッシュボードの操作をご覧ください。

さらに、アプリケーションがカスタマイズできる Web SDK拡張機能で拡張されている場合、ここに追加のタブが表示されることがあります。カスタマイズしたタブを追加する方法については、Web SDKガイドのチュートリアル をご覧ください。

グループの追加方法

1. トップメニューバーの右側にあるグループを追加をクリックします。
2. 表示されるダイアログボックスで、一意のグループ名と任意の説明を入力し、次へをクリックします。
3. デバイス一覧で、追加するデバイスにチェックマークを付けます。フィルターを適用して、表示されるデバイス数を減らすことができます。
4. 作成 をクリックして、新しいグループを作成します。

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

既存アセットの子として新規グループを追加するには、サブアセットタブのグループを追加をクリックします。

デバイスをグループに割り当てる方法

デバイスをアセット階層に追加する前に、デバイスをThings Cloudに接続しなければなりません。 デバイス管理アプリケーションを使用してデバイスをプラットフォームに接続します。デバイスの接続について詳細は、デバイス管理をご覧ください。

デバイスをグループに割り当てるには、以下の手順に従ってください。

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

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

グループの編集方法

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

グループの削除方法

グループページの最上階層グループ、または別のグループのサブアセットタブからグループを削除するには、削除する各エントリの上にカーソルを置き、右側の削除アイコンをクリックします。

表示されるダイアログボックスで、選択したアセット内のすべてのデバイスと、そのすべてのサブアセットを削除することも選択できます。

グループからデバイスを削除する方法

1. グループのサブアセットタブに移動します。
2. 削除する各デバイスの上にカーソルを置き、右側の削除アイコンをクリックします。

デバイスを削除してもデバイス、サブデバイスまたは付随データは削除されません。デバイスはそのアセット階層内から除外されるだけです。同じグループまたは別のグループへ割り当てをし直すことができます。

データエクスプローラ

データエクスプローラでは、データポイント（メジャーメントまたはセンサーデータ）を可視化できます。

すべてのアセットでも、特定のアセットでもデータエクスプローラを使用できます。

• ナビゲータのデータエクスプローラをクリックすると、すべてのアセットのすべてのデータポイントが表示されます。

• 特定のアセットへ移動し、データエクスプローラタブに切り替えて、この特定のアセットとそのサブアセットのすべてのデータポイントを表示します。

データエクスプローラの右側に、使用可能なデータポイントのリストが表示されます。デフォルトで、選択したデバイスまたはグループの最初の5つのデータポイントが表示されます。データポイントの追加方法の詳細については、データポイントの追加をご覧ください。

左側のメインカードには、その可視化が表示されます。

データポイントのプロパティに基づいて可視化が生成されます。

データポイントのプロパティは、次のように事前に入力されます。

• プロパティがカスタマイズされている場合は、その値が使用されます。詳細についてはデータポイントプロパティのカスタマイズをご覧ください。

• データポイントライブラリに一致する定義がデータポイントにある場合、データポイントライブラリの値が使用されます。

データポイントライブラリには、一致するデータポイントエントリが複数存在する場合があります。この場合、最初のものが自動的に選択されます。

一般的な画面の変更の詳細については、データエクスプローラの表示を変更をご覧ください。特定のデータポイントのプロパティのカスタマイズ方法の詳細については、データポイントプロパティのカスタマイズをご覧ください。

例

ライブラリに温度データポイントが定義されており、温度メジャーメント（ライブラリ内のデータポイントとフラグメント、シリーズによって一致）を送信するデバイスがあると仮定します。「計測のしきい値の場合、アラームを作成」スマート ルールを作成し、ライブラリからデータポイントを選択すると、ライブラリの設定を使用してアラームを作成するかどうかが決定されます。

データエクスプローラの表示を変更

データエクスプローラで表示を変更するには、いくつかのプロパティを編集します。

時間範囲

表示される時間範囲を変更できます。デフォルトでは、過去 1時間の値が表示されます。

X軸の時間範囲を変更するには、以下のいずれかのオプションを使用します。

• トップメニューバーのドロップダウンリストから別の時間範囲を選択します。
• データエクスプローラの開始日および終了日フィールドにカスタムの時間範囲を入力します。
• X軸をドラッグして左右に移動し、期間を変更します。
• データエクスプローラをダブルクリックしてズームアウトします。

集計

表示されているデータを集計して、より長い期間にわたる効率的な概要を得ることができます。

デフォルトで集計は「なし」に設定されています。この値はトップメニューバーの集計フィールドで変更できます。選択可能な値は、選択した時間範囲に応じて「1分ごと」、「1時間ごと」、「毎日」となります。

集計が有効になると、データポイントグラフまたはデータポイントテーブルに表示されるタイムスタンプは、可視化を向上させるために次のようにわずかに変更されます。

• 集計が選択されていない場合、日付、時、分、秒が表示されます。
  2020年1月27日 17:26:55
• 1分単位の集計を選択した場合、2番目からのデータは表示されません。
  2020年1月27日 17:27 ― 17:28
• 1時間単位の集計を選択した場合、分秒表示は表示されません。
  2020年1月27日 05:00 ― 06:00
• 日次集計（毎日）を選択した場合、日付のみが表示されます。
  2020年1月27日 ― 2020年1月28日

リアルタイム更新

リアルタイム更新はデフォルトで有効になっています。接続されているデバイスからシステムに新しいデータが流入すると、表示されているデータが更新されます。

リアルタイム更新のオン/オフを切り替えるには、トップメニューバーのリアルタイムをクリックします。緑色のライトは、リアルタイム更新が有効であることを示します。

データポイントの表示

データポイントごとに、データポイント名の左にあるトグルを使用して表示/非表示を切り替えることができます。

データポイントの追加

データエクスプローラにデータポイントを追加するには、データポイントカードの下部のデータポイントを追加をクリックします。

ウィンドウの左部で、アセット階層からデバイスを選択します。 ナビゲータで選択したオブジェクトの下にあるアセット階層のみが表示されます。 ナビゲータでデータエクスプローラを選択した場合、すべてのアセット階層が表示されます。

ウィンドウの中央に、選択したオブジェクトのデータポイントがすべて表示されます。 データエクスプローラに表示させたいデータポイントを選択します。 追加をクリックすると、選択したデータポイントがすべてデータポイント一覧に追加されます。

右側には、選択されたすべてのデータポイントが表示されます。

データポイントライブラリの詳細については、データポイントライブラリをご覧ください。

データポイントリストからデータポイントを削除するには、メニューアイコンをクリックして、リストから削除を選択します。

データポイントプロパティのカスタマイズ

特定のデータポイントの表示を好みに合わせてカスタマイズできます。これを行うには、データポイントリストのデータポイントエントリを展開します。

次のフィールドは変更可能です。

Y軸動作

デフォルトでは、最初のデータポイントは左のY軸に配置され、残りのデータポイントは右側に配置されます。これは、特定のデータポイントの「Y軸」の値を修正する（「左」または「右」に変更。上記参照）ことで変更できます。

各データポイントは、次の条件が満たされない限り、それぞれのY軸に表示されます。

• 2つのデータポイントが同じ最小値と同じ最大値を持っている。

この場合、両方のデータポイントは同じY軸を共有します。このY軸は、単位（異なる場合は複数の単位）のみを示します。ラベルは表示されません。

アラームとイベントの追加

データポイントの他に、アラームやイベントをデータエクスプローラに追加することができます。

アラーム/イベントカードで、アラーム/イベントを追加をクリックし、アラームまたはイベントを追加します。

次のウィンドウで、最近のアラームとイベントの一覧から目的のアラームまたはイベントを選択します。追加をクリックして、選択したのものを追加します。

プロパティを変更するには、イベントを展開します。

メニューアイコンをクリックし、メニューから削除を選択してリストからエントリを削除します。

データポイントと同様に、トグルを使用してデータエクスプローラのアラーム/イベントの表示/非表示を切り替えることができます。

データエクスプローラからウィジェットを作成

データエクスプローラの現在の設定を後ほど使用するために保持したい場合は、ウィジェットとして保存します。

ダッシュボードにウィジェットとして送信

特定のアセットのデータエクスプローラからウィジェットを作成するには、トップメニューバーの参照をクリックし、ダッシュボードにウィジェットとして送信を選択します。

次のウィンドウで、現在のオブジェクトで使用可能なダッシュボードの 1つを選択し、選択をクリックして、選択したダッシュボードへデータエクスプローラをウィジェットとして追加します。

レポートにウィジェットとして送信

ナビゲータのデータエクスプローラからウィジェットを作成するには、トップメニューバーから参照をクリックし、レポートにウィジェットとして送信を選択します。

次のウィンドウで、使用可能なレポートのいずれかを選択し、選択をクリックして、選択したレポートへデータエクスプローラをウィジェットとして追加します。

メジャーメントデータのエクスポート

メジャーメントデータをcsvファイルまたはxlsxファイル形式でダウンロードすることができます。エクスポートされるメジャーメントデータは、以下の情報をカラムに分割して表示します。

• 特定のメジャーメントが取得された日時
• メジャーメントのソース
• 使用中のデバイス名
• フラグメントシリーズ（例： c8y_SpeedMeasurement）
• メジャーメントの値
• 特定のメジャーメントに使用する単位（例：「C」、「km/h」、「秒」）

メジャーメントデータをエクスポートするには、トップメニューバーの参照をクリックし、必要に応じてCSVでダウンロードまたはExcelでダウンロードを選択します。

次のウィンドウで示すように、ダウンロードが生成されます。この処理は、データエクスプローラに追加されたデータポイント数に応じて時間がかかる場合があります。ロードが完了したら、ダウンロードをクリックします。

ダッシュボードの操作

Things Cloudでは、すべてのグループとデバイスに対して個別のダッシュボードを作成できます。 ダッシュボードでは「ウィジェット」を使用して、あなたのデータの可視化をカスタマイズできます（例：アラームやイベントなど、リモートアクションをトリガーすることができます）。ウィジェットは地図、画像、グラフ、表や他の図式表現でデータを表示します。

Things Cloudでは既製のウィジェットを多数用意しています。詳しくは、ウィジェットコレクションをご覧ください。独自のウィジェットを開発し、あなたの Things Cloudアカウントに加えることもできます。 詳しくはWeb SDKガイドをご覧ください。

ダッシュボードの作成

個別のダッシュボードを作成するには、以下の手順を実行してください。

1. グループメニューで、ダッシュボードを作成するグループまたはデバイスをナビゲータで選択します。

2. タブの右側にあるプラスアイコンをクリックして、ダッシュボードエディタを開きます。

3. ダッシュボードを追加ウィンドウの 一般 セクションで、次の情報を入力します。

   • ナビゲータのダッシュボード名の横に表示されるアイコン
   • ダッシュボードの名前として使用するメニューラベル
   • ナビゲーション内のダッシュボードの位置。「10000」が先頭となり、「-10000」が最後になります。
     
     

4. このタイプのすべてのデバイスとダッシュボードを共有するには、タイプ <デバイスタイプ> のすべてのデバイスにダッシュボードを適用 オプションを有効にします。

5. 稼働率セクションでは、グローバルロールに基づいてダッシュボードにアクセスできるユーザを指定します。デフォルトでは、使用可能なすべてのグローバルロールが選択されます。これは、少なくとも1つのロールを持つユーザがダッシュボードにアクセスできることを意味します。

   備考

   • ダッシュボードは常にその所有者と、「インベントリ」権限タイプの管理者権限を持つユーザーに表示されます。
   • この機能は完全にクライアント側のソリューションに基づいています。ユーザーがダッシュボードへの正確なリンクを持っている場合、ユーザーはダッシュボードにアクセスすることができます。

6. レイアウトセクションでは、ダッシュボードのテーマ（「淡色」、「暗色」、「UI を適合」、「ブランディング」のいずれか）と、ウィジェットのデフォルトのヘッダースタイル（「標準」、「分割線」、「重ね配置」、「非表示」のいずれか）を選択できます。また、デフォルトのウィジェット余白を変更することもできます（デフォルト値は 12px）。

7. ウィジェットタイトル　可能な場合は翻訳 オプションを選択した場合、言語表示が変更されるたびにウィジェットのタイトルが該当の言語に翻訳されます。

8. 右側の プレビュー セクションに、選択したレイアウト設定のプレビューがすぐに表示され、選択内容が表示されます。

9. 保存 をクリックしてダッシュボードを作成して開きます。

次に、ウィジェットをレポートに追加できます。レポートではダッシュボードに詳細なデータを表示することができます。

ウィジェットの追加、変更、削除方法の詳細については、ダッシュボードとレポートでのウィジェット使用 をご覧ください。

ダッシュボードの共有

特定のタイプのデバイス用にダッシュボードを作成し、それと同じタイプのすべてのデバイスと共有できます。ただし、デバイスにタイププロパティが設定されている必要があります。

これを行うには、タイプ <デバイスタイプ> のすべてのデバイスにダッシュボードを適用 オプションを選択します（「デバイスタイプ」は、選択されたデバイスのタイプに置き換えられます）。

対応するメッセージがエディタに表示されます。

グローバル時間 コンテキスト

ウィジェットの設定で、ダッシュボードのグローバル時間の範囲を指定できます。グローバル時間範囲を使用すると、ダッシュボード内のすべてのデータがこの範囲に合わせられます。最初のウィジェットでグローバル時間の範囲を設定した後、このコンテキストの共有は、グローバル時間のコンテキストを使用するように設定されている他のウィジェットで使用できるようになります。

グローバル時間の範囲は、カスタム日付ピッカーを使用して、モニタリングするニーズに応じて任意の期間に設定できます。時間範囲はダッシュボードの上部に表示されるため、データが表示されているコンテキストをすぐに確認することができます。さらに、URLに時間コンテキストのパラメーターを含めることで、特定の時間コンテキストを持つダッシュボードを共有できます。ユーザーがグローバル時間のコンテキストを設定すると、URLパラメータは自動的に設定されます。

ダッシュボードを編集

ダッシュボードを編集するには、トップメニューバーの編集をクリックします。

ダッシュボードエディタが開きます。各フィールドの詳細については、ダッシュボードの作成 をご覧ください。

ダッシュボードを1つのオブジェクトから別のオブジェクトへコピー

1. トップメニューバーの参照をクリックし、メニューからダッシュボードをコピーを選択します。

2. 次に、コピーをしたいオブジェクトへ移動し、メニューからダッシュボードを貼り付け “ダッシュボード名” を選択してダッシュボードを挿入します。

ダッシュボードをコピーする際の代替手段として「タイプ別ダッシュボード」アプローチもあります。「タイプ別ダッシュボード」アプローチでは、ダッシュボードを1つのオブジェクトから、同じタイプのすべて のオブジェクトにコピーできます。ダッシュボードの共有をご覧ください。

ダッシュボードの削除

ウィジェットからダッシュボードを削除するには、トップメニューバーの右上にある参照 をクリックし、ダッシュボードを削除を選択します。

レポートの操作

レポートを使用すると、ダッシュボードレイアウトでアプリケーション、アラーム、アセット、およびその他のデータを追跡できます。レポートは、アセットの階層に関係のないグローバル ダッシュボード ページです。

すべてのレポートを表示するには、ナビゲータでレポート をクリックします。

レポート ページには、すべてのレポートとその名前、オプションの説明、およびナビゲータの切り替えが表示されたリストがあります。

レポートを開くには、レポートリストでレポート名をクリックします。レポートの詳細が表示されます。

ナビゲータの最初のレベルでレポートをより目立つように表示したい場合は、ナビゲーターで表示 列のトグルを使用します。トグルをオンにすると、レポートがナビゲータにすぐに表示されます。

ナビゲータでの位置の設定方法の詳細については、以下の レポートの作成 をご覧ください。

レポートの作成

1. トップメニューバーでレポートを追加 をクリックして、レポートを追加 ダイアログを開きます。
   
   
2. メニューラベル フィールドにレポート名を入力し、任意で下の説明を入力します。
3. レポートをナビゲータに表示する場合、ナビゲーターで表示 を選択します。 ナビゲータでのレポートの位置を選択します。値に応じて、既存の項目を基準にして配置されます。例えば、「ホーム」の値が「10000」の場合、値が「10001」以上であれば「ホーム」の上に配置されます。
4. レイアウト セクションで、レポートのテーマ（「淡色」、「暗色」、「透明」、「ブランディング」のいずれか）と、ウィジェットのデフォルトのヘッダースタイル（「標準」、「分割線」、「重ね配置」、「非表示」のいずれか）を選択できます。また、デフォルトのウィジェット余白を変更することもできます（デフォルト値は 12px）。 ウィジェットタイトル　可能な場合は翻訳 オプションを選択した場合、言語表示が変更されるたびにウィジェットのタイトルが該当の言語に翻訳されます。 保存 をクリックしてレポートを作成し、レポートリストに追加します。

次に、ウィジェットをレポートに追加できます。

ウィジェットの追加、変更、削除方法の詳細については、ダッシュボードとレポートでのウィジェット使用 をご覧ください。

レポートの編集

レポートリストでレポート名をクリックすると、その詳細が表示されます。

レポートを編集するには、トップメニューバーで編集 をクリックします。

レポートエディタが開きます。フィールドの詳細については、レポートの作成をご覧ください。

レポートの削除

1. レポートページで、削除するレポートの上にカーソルを置き、右側に表示される削除アイコンをクリックします。
2. レポートの削除を確認します。

ダッシュボードとレポートでのウィジェット使用

ウィジェットは、地図、画像、グラフ、表、その他のデータのグラフィック表現を表示できます。ウィジェットは、アラーム、アセット、アプリケーションなどの情報を追跡したり、ダッシュボードやレポートで地図やクイックリンクなどを提供したりするのに役立ちます。

Things Cloudは事前に定義されたウィジェットタイプを提供します。詳細については、ウィジェットコレクション をご覧ください。

ウィジェットをダッシュボードまたはレポートに追加

1. トップメニューバーでウィジェットを追加 をクリックするか、あるいはメインページ（ダッシュボード／レポートが空の場合のみ利用可能）でウィジェットを追加 ボタンをクリックします。

2. ウィジェットを追加ウィンドウで、ウィジェットタイプを選択します。

3. 次に、ウィジェットを構成します。選択したウィジェットタイプに応じて、構成タブでさまざまなパラメータを指定できます。すべてのウィジェットの詳細については、ウィジェットコレクションをご覧ください。

4. 外観タブでは、ダッシュボードのレイアウトを指定するように、ウィジェットのコンテンツとヘッダーのスタイルを個別にカスタマイズできます。

5. 保存をクリックして、ウィジェットをダッシュボードまたはレポートに追加します。

ウィジェットの変更

ウィジェットはダッシュボード／レポート上で並べ替えることができます。ウィジェットをドラッグ＆ドロップすると、別の位置に移動できます。

ウィジェットの右下隅にある矢印をドラッグすれば、ウィジェットのサイズを変更できます。

ウィジェットのプロパティを編集するには、ウィジェットの右上隅にある歯車のアイコンをクリックし、メニューから編集を選択します。

ダッシュボードまたはレポートからウィジェットを削除するには、ウィジェットの右上隅にある歯車のアイコンをクリックし、メニューから削除を選択します。

ウィジェットを変更できるのは、ダッシュボード／レポートのロックが解除されている場合のみです。ダッシュボードをロック/ロック解除するには、トップメニューバーの錠アイコンが表示されたトグルを使用します。

ウィジェットでのアセット選択

次のセクションでは、ウィジェット設定で 最上階層アセットを 1つ選択する方法、アセットとして子デバイスを選択する 方法、および アセットを検索またはフィルターする 方法について説明します。

アセットを新規または既存ウィジェットに追加する

ウィジェットエディタの構成タブで、アセットの選択の下にある目的のアセットをオンにします。保存をクリックして、アセットをウィジェットに追加します。 単一のデバイスを選択することも、フォルダアイコンで示されるデバイスのグループ全体を選択することもできます。子デバイスの選択については、グループ内の子デバイスをアセットとして選択するをご覧ください。

ウィジェットのアセットを編集する場合は、ウィジェットを編集ウィンドウを開いて変更をクリックします。これにより、以前のアセットコレクションがクリアされます。新しい目的のアセットを選択し、保存をクリックします。

ウィジェットの追加／変更方法の一般的な手順については、ダッシュボードとレポートにウィジェットを追加する または ウィジェットの変更 をご覧ください。

子デバイスをアセットとして選択

アセットがグループまたは子を持つデバイスの場合、名前の横にフォルダアイコンと右向きの矢印アイコンが表示されます。リスト内の子を持つ目的グループ／デバイスをクリックすると、そのグループ／デバイスに割り当てられているすべてのアセットを表示する新しい階層が開きます。目的のアセットを選択します。前の階層に戻るには、左向きの矢印アイコンをクリックします。

未割り当てのデバイスをアセットとして選択する場合、選択したグループの最初の階層にある割り当てを解除されたデバイスフォルダで未割り当てのデバイスを見つけることができます。

アセットの検索およびフィルタリング

アセットをすばやく見つけるために、2つの使用方法があります。

1. 全文検索
2. フィルタリング

全文検索

ウィジェットエディタの構成タブで、アセットの選択 の下にある全文検索フィールドを使用できます。

全文検索では、階層全体でアセットを検索できますが、アセット名全体など、完全に一致する必要があります。

アセットを選択すると、このアセットのすべての子が表示されます。上のレベルに戻るには、検索フィールド右側の「×」をクリックします。

検索機能の詳細については、はじめに > UIの機能と特長 > 検索と絞り込み機能をご覧ください。

フィルタリング

フィルタリングは、アセットを検索するもう 1つの方法です。ただし、アセットの選択で現在の階層のアセットのみをフィルタリングします。

フィルター機能の詳細については、はじめに > UIの機能と特長 > 検索と絞り込み機能をご覧ください。

ウィジェットコレクション

コックピットアプリケーションには事前に定義されたウィジェットタイプが含まれています。ウィジェットタイプごとに、構成するパラメータと表示するデータが異なります。

次の種類を使用することができます。

アラームリスト

「アラームリスト」ウィジェットは、オブジェクト、アラームの重大度、およびアラームのステータスでフィルタリングされたアラームの一覧を表示します。各アラームに表示される情報については、デバイス管理 > アラームの操作をご覧ください。

設定パラメータ

すべてのクリティカルアラーム

「すべてのクリティカルアラーム」ウィジェットは、クリティカル状態のアラームが発生しているすべてのオブジェクトを表示します。タイトル以外で設定すべき追加パラメータはありません。

アラーム内容の詳細は、デバイス管理 > アラームの操作をご覧ください。

アプリケーション

「アプリケーション」ウィジェットには、利用可能なすべてのアプリケーションへのリンクの一覧が表示されます。タイトル以外で設定すべき追加パラメータはありません。

アプリケーションの詳細については、 管理 > アプリケーション管理をご覧ください。

アセットプロパティ

「アセットプロパティ」ウィジェットは、現在のオブジェクトの属性のユーザー定義リストを表示します。現在のオブジェクトとはデバイスまたはグループです。

設定パラメータ

アセットテーブル

「アセットテーブル」ウィジェットは、テーブル内に選択したアセットとそのすべての子デバイスの詳細を表示します。これは非常に強力なウィジェットで、選択したオブジェクトのプロパティをテーブルに配置できます。

設定パラメータ

例

次のスクリーンショットでは、5つの列が構成されています。「ID」、「作成日時」、「名前」の列はプロパティの「id」、「creationTime」、「name」をそれぞれ参照します。さらに、メンテナンスモードの切り替えとデバイスの再起動という2つのアクションがあります。

結果のテーブルは、次のように表示されます。

プロパティの追加

プロパティを追加するには、+プロパティを追加をクリックし、追加するプロパティを1つまたは複数選択します。

アクションの追加

1. +アクションを追加をクリックします。
2. メンテナンスモード表示/非表示を選択し、メンテナンスモードを切り替える定義済みアクションを追加します。
3. 操作を作成を選択して、シェルコマンドを実行するボタンを作成します。次のウィンドウでは、ボタンのラベルと実行するシェルコマンドを入力できます。

テーブルの修正

列のヘッダーを編集するには、ラベル列の値をクリックしてラベルを編集します。

列を並べ替えるには、行の一番左にあるアイコンをクリックし、エントリごとドラッグアンドドロップします。

プロパティまたはアクションを削除するには、それぞれの行にカーソルを合わせ、右側の削除をクリックします。

データポイントグラフ

「データポイントグラフ」ウィジェットは、グラフにデータポイント（メジャーメント）を表示します。表示方法はデータエクスプローラと同じです。

「データポイントグラフ」ウィジェットを作成する最も簡単な方法は、データエクスプローラに移動して、トップメニューバーの参照ボタンをクリックし、ダッシュボードにウィジェットとして送信を選択します。

設定するパラメータの詳細については、 データエクスプローラ をご覧ください。

データポイントリスト

「データポイントリスト」ウィジェットは、現在の値とデータポイントプロパティを持つデータポイント（メジャーメント）を各行に表示します。

設定パラメータ

データポイントテーブル

「データポイントテーブル」ウィジェットの構成設定は「データポイントグラフ」ウィジェットとほぼ同じですが、データポイントテーブルでは、データを折れ線グラフではなく表形式で表示します。

「データポイントテーブル」ウィジェットは選択されたデータポイント、時間間隔および集計に基づいてデータを表示します。

範囲外の値は黄色と赤色の範囲の構成を基に、表内で強調されます。

データポイントテーブルの右上にある自動スクロールトグルにより、表示動作が決まります。

• 自動スクロール オン - 新しいメジャーメントが到着すると、ウィジェットが自動的に上部にスクロールして最新の値を確認できます。
• 自動スクロール オフ - 新しいメジャーメントが到着しても、表示は変化せず、表には同じデータの断片が表示されたままになります。

イベントリスト

「イベントリスト」ウィジェットでは、選択したデバイスのイベントを監視できます。

さらに、特定の日付範囲を設定し、イベントをリアルタイムで監視することもできます。

フィールドバスデバイス

「フィールドバスデバイス」ウィジェットでは、Modbusデバイスのステータスを表示して操作することができます。

「フィールドバスデバイス」ウィジェットの詳細については、「プロトコル統合ガイド」のクラウドフィールドバス > フィールドバスデバイスウィジェット使用によるデバイスステータスの監視をご覧ください。

ヘルプおよびサービス

「ヘルプおよびサービス」ウィジェットは、ヘルプおよびサービスリソースへのリンクが表示されます。設定すべき追加パラメータはありません。

画像

「画像」ウィジェットではファイルから選択した1枚の画像を表示することができます。画像がアップロードされると、画像サイズと配置を変更することができます。

情報ゲージ

「情報ゲージ」ウィジェットは、1つのデータポイントを放射状ゲージという形で表示し、複数のデータポイントをラベルとして表示します。

ゲージ用に1つのデータポイントを選択し、左側にラベル付きで表示される複数のデータポイントを選択できます。

「情報ゲージ」ウィジェットを作成するには、少なくとも1つのデータポイントをそれぞれ有効にする必要があります。

HTML

「HTML」ウィジェットは、ユーザーが定義したコンテンツを表示します。 HTMLを使用してコンテンツをフォーマットできます。

設定パラメータ

• 対象となるアセットもしくはデバイス: オプションのHTML表現を使用するオブジェクトを選択します。

• HTML コード

  HTMLコンテンツで使用可能な変数:

  • {{devicesCount}}: デバイス総数

  • {{usersCount}}: ユーザー総数

  • {{deviceGroupsCount}}: グループ総数

  • {{device.name}}: デバイス名

  • {{device.property}}: 上記より汎用的な形式。デバイスのどのプロパティにも対処できます。

  • {{device.c8y_Hardware.model}}: デバイスの型式

  • {{device.fragment.property}}: 上記より汎用的な形式。デバイスのどのフラグメントのプロパティにも対処できます。

「デバイス」とは、ウィジェットの設定パラメータにおいて選択された対象デバイスを指します。
「fragment.property」は各デバイスのプロパティを指します。利用可能なプロパティ名について詳しく知りたい場合、「アセットプロパティ」ウィジェットまたは「アセットテーブル」ウィジェットを使用し、ウィジェット構成設定の「+ プロパティを追加」をクリックします。サポート対象プロパティの表が表示されますので、プロパティ列から値をコピーして貼り付けることができます。これらのウィジェットで新しく生成されたプロパティは、HTMLウィジェットでは使用できません。

コードのサニタイズ・オプションを以下から選択できます。

• 厳密 - JS や Angularjs ディレクティブを許可しません。
• 緩い - 部分的な JS (イベント) とすべての Angularjs ディレクティブを許可します。
• なし - すべてを許可します。

HTMLコードフィールドでリンク（ダッシュボードへのリンクなど）を使用する場合、次の形式を使用する必要があります。

  <a style="cursor:pointer;" onclick="location.hash = '#/group/<<group-id>>/dashboard/<<dashboard-id>>'">link to another dashboard</a><br />

リニアゲージ

「リニアゲージ」ウィジェットは、データポイントをリニアゲージの形で表示します。最小および最大ターゲット値もゲージに表示されます。

「リニアゲージ」ウィジェットを作成するには、少なくとも 1つのデータポイントを有効にする必要があります。

地図

「地図」ウィジェットは、デバイスまたはグループのすべてのデバイスの位置を表示します。

地図をドラッグして移動したり、プラスとマイナスボタンを使用して拡大/縮小することができます。

デバイスを表わすアイコンは色コードで区別されます。 使用する色は以下のルールに基づいています。

• 赤 = 少なくとも 1つのクリティカルアラーム
• 橙 = 少なくとも 1つのメジャーアラーム
• 黄 = 少なくとも 1つのマイナーアラーム
• 青 = 少なくとも 1つの警告
• 緑 = アラームなし

デバイスアイコンをクリックすると、以下の情報と併せてポップアップが表示されます。

• デバイス名。クリックすると、アプリケーションはそのデバイスへ移動します。
• デバイスが最後に位置を報告した日付（利用可能な場合）
• 過去および現在の数日間におけるデバイスの追跡の表示／非表示の選択

設定パラメータ

アセットの選択: グループを選択すると、グループに含まれる（ただし、サブグループには含まれていない）すべてのデバイスが表示されます。

Markdown

「Markdown」ウィジェットはMarkdownコンテンツを表示するために使用できます。「Markdown」ウィジェットを使用すると、例えば新機能をユーザに知らせることができます。

Markdownコンテンツを提供するには、いくつかの方法があります。

• Markdownファイルをアップロードする。
• 外部ソースへのURLを提供する。
• 現在のアプリケーションのREADMEファイルをソースとして提供するために、相対ファイルパスとして「/README.md」を追加する。

メッセージ送信

「メッセージ送信」ウィジェットはメッセージをデバイスに送信します。デバイス自体における挙動はデバイス次第で変わります。c8y_Message タイプのオペレーションに対応するデバイスについてのみ使用できます。

円グラフ

「円グラフ」ウィジェットは、円グラフとして現在の値を持つデータポイント（メジャーメント）を表示します。

設定パラメータ

放射状ゲージ

「放射状ゲージ」ウィジェットは、データポイントを放射状ゲージの形式で表示します。

「放射状ゲージ」ウィジェットを作成するには、少なくとも 1つのデータポイントを有効にする必要があります。

最近のアラーム

「最近のアラーム」ウィジェットは、すべての重大度のアラームを時間順に表示します。設定すべき追加パラメータはありません。

アラーム内容の詳細は、デバイス管理 > アラームの操作をご覧ください。

リレーアレイ制御

「リレーアレイ制御」ウィジェットでは、リレーの配列内でリレーのオン/オフを個別に切り替えることができます。このタイプのオペレーションに対応するデバイスでのみ使用できます。

リレー制御

「リレー制御」ウィジェットでは、デバイスリレーのオン/オフを切り替えることができます。このタイプのオペレーションに対応するデバイスでのみ使用できます。

ローテーション

「ローテーション」ウィジェットでは、デバイスのオブジェクトモデルをレンダリングできます。

設定パラメータ

「ローテーション」ウィジェットでは、オブジェクトをドラッグしたり動かして回転できます。マウスを使用して拡大および縮小します。

SCADA

「SCADA」ウィジェットは、デバイスのステータスを画像表示します。

「SCADA」ウィジェットの詳細については、プロトコル統合ガイドのクラウドフィールドバス > SCADAウィジェットの使用によるステータス監視をご覧ください。

コードのサニタイズ・オプションを以下から選択できます。

• 厳密 - JS や Angularjs ディレクティブを許可しません。
• 緩い - 部分的な JS (イベント) とすべての Angularjs ディレクティブを許可します。
• なし - すべてを許可します。

サイロ

「サイロ」ウィジェットは、サイロとして現在の値を持つデータポイント（メジャーメント）を表示します。

設定パラメータ

信号機

「信号機」ウィジェットはデバイスの状態を信号機として表示します。

設定パラメータ

エクスポートの管理

エクスポート機能を使用すると、特定のデータを CSV または Excel ファイルにエクスポートできます。

この機能を使用すると、テナント全体のデータをリクエストできます。さらに、特定のデバイス、期間、フィールドなどのフィルタリングすることができます。エクスポートデータには、指定したすべてのフィルターと有効なフィールドに関する情報が含まれます。

すべてのエクスポートを表示するには、ナビゲータの構成メニューのエクスポートをクリックします。

エクスポートページには、今までエクスポートしたすべてのエクスポート名、ファイルタイプ、期間が一覧として表示されます。

エクスポートの追加

1. トップメニューバーのエクスポートを追加をクリックします。

2. エクスポートの名前を入力し、レポート出力のファイルタイプ（CSV または Excel(.xlsx)）を選択します。

フィルター

フィルターセクションでは、フィルターを選択して特定のオブジェクトまたは期間のデータをリクエストすることができます。

特定のオブジェクトをフィルタリングするには、検索フィールドに名前またはプロパティ値を入力し、検索アイコンをクリックします。一致するすべてのデバイスまたはグループが、値フィールドの下に表示されます。オブジェクトをクリックして選択します（緑色で強調表示）。

期間フィルターは、特定の期間のデータをフィルタリングできます。ドロップダウンフィールドから期間を選択します。「昨年」、「先月」、「先週」のいずれか、または「カスタム」を選択し、追加フィールドにカスタムの開始日/終了日の範囲を入力します。

エクスポートするオブジェクトおよび期間チェックボックスを選択して、それぞれのフィルターを有効にします。

フィールド

オブジェクトおよび期間のフィルターとは別に、特定のフィールドでデータをフィルタリングできます。

• アラーム
• イベント
• 管理対象オブジェクト (マネージドオブジェクト)
• 計測値 (メジャーメント)

フィールドを有効化/無効化するには、スライダーをご利用ください。

フィールドを有効にすると、定義済みまたは空のプロパティを追加できます。

プロパティの追加

追加をクリックして、空のプロパティを追加します。ラベルまたはパスを入力するには、列またはパスをクリックしてフィールドを編集します。例えば、アラームフィールドを有効にすると、列に「重大度」、パスに「severity」と入力してアラーム重大度のデータを受信できます。

事前定義された属性を追加をクリックして、定義済みのプロパティを追加します。リストから目的のプロパティを選択し、選択をクリックします。上部の検索フィールドを利用して、特定のプロパティを検索することもできます。

「プロパティを選択」リストからのフィールドではなく、カスタムプロパティとして定義されたフィールドが少なくとも1つある場合、エクスポートに表示するために少なくとも1つのカスタム値のプロパティを設定する必要があります。

例: エクスポートに、期間、デバイス名、タイプ、c8y_SpeedMeasurement.speed.value の4つのフィールドを定義している場合、最初の3つは定義済みプロパティで、最後の1つはカスタムプロパティです。エクスポートするメジャーメントにカスタムプロパティ c8y_SpeedMeasurement.speed.value がない場合、エクスポートファイルには表示されません。

フィールドが valid.key.with.dot の場合、パス内で [‘fragment.key.with.dot’] として参照します。 例: [‘fragment.key.with.dot’].series.value

「計測値」が有効な場合は、データポイントから追加を選択することもできます。データポイントの追加方法の詳細については、データポイントの追加をご覧ください。

データポイントから追加された JsonPath式は、フラグメントとシリーズの命名の柔軟性を高めるために括弧 [ ] 表記で保存されます（空白などは対応します）。

エクスポートのスケジュール設定

CSV または Excelファイルへのエクスポートを任意の時間に設定するには、それぞれのエクスポートを開き、下部のスケジュールを追加をクリックします。

次のウィンドウでは、以下の情報を入力して、予定した時間にメールでエクスポートを受信します。

1 - 頻度

ドロップダウンリストからエクスポートを送信する間隔（時間、日、週、月、年）を選択します。選択した頻度に応じて、追加のタイミング情報を指定します。例えば、「月」を選択した場合、日、時間を指定します。

2 - Eメールを送信

メール情報を入力します。

送信先フィールドに、受信者のメールアドレスを入力します。このフィールドは必須です。オプションで、コピー（CC）またはブラインドコピー（BCC）を送信するためのメールアドレスを指定できます。複数の受信者を入力するには、区切り文字としてカンマを使用します。

必要に応じて、返信用の送信者のメールアドレスを追加します。

メールの件名を指定します。このフィールドはあらかじめ入力されていますが、変更することができます。

メールに記載されるメッセージ本文を入力します。利用可能なプレースホルダーは {host}、{binaryId}です。デフォルト値は「エクスポートされたデータを含むファイルは、{tenant-domain}/inventory/binaries/{binaryId} からダウンロードできます。」です。 ブラウザからの Basic Auth 認証によるAPIリクエストを制限している場合は、リンクを「{tenant-domain}/apps/cockpit/index.html#/?download={binaryId}」に変更いただくと、アプリケーションからダウンロード可能となります。

作成をクリックして、新しいエクスポートスケジュールを作成します。

エクスポートスケジュールは、エクスポートの詳細に追加されます。

データのエクスポート

CSV または Excelファイルにデータをエクスポートするには、リストの各行の前にあるチェックボックスを選択して、トップメニューバーの右側にあるエクスポートをクリックします。

各エクスポートファイルへのリンクが記載されたメールが届きます。

ドキュメントの標準時刻のプロパティ（アラームのtimeまたはcreationTimeなど）は、ISO-8601で定義されている日付と時刻の形式に従って Excelファイル と CSVファイルにエクスポートされます。

エクスポートドキュメントの制限に達し、その制限により結果が切り捨てられると、ドキュメントの最後にインジケーター付きの追加行が追加されます。

インジケーターを使用したCSVエクスポートのサンプル：

時間,デバイス名,作成日時,デバイス名,ID,ソース,テキスト,時間,タイプ
2021-11-25T10:37:06.485Z,Position #1,2021-11-25T10:37:06.485Z,Position #1,1266,1195,Location updated,2021-11-25T10:37:06.485Z,c8y_LocationUpdate
2021-11-25T10:37:01.484Z,Position #1,2021-11-25T10:37:01.484Z,Position #1,1265,1195,Location updated,2021-11-25T10:37:01.484Z,c8y_LocationUpdate
[…]
limit exceeded!,result truncated!,limit exceeded!,result truncated!,limit exceeded!,result truncated!,limit exceeded!,result truncated!,limit exceeded!

エクスポートの編集

それぞれの行をクリックするか、行の右端にあるメニューアイコンをクリックし、編集をクリックします。

フィールドの詳細については、エクスポートの追加をご覧ください。

エクスポートの複製

1. 行の右端にあるメニューアイコンをクリックし、複製をクリックします。
2. 少なくとも名前は変更します。
3. 保存して閉じるをクリックしてエクスポートを保存し、エクスポートリストに戻ります。

エクスポートの削除

行の右端にあるメニューアイコンをクリックし、削除をクリックします。

データポイントライブラリ

データポイントライブラリは、データポイントプロパティのデフォルト値を持つデータポイントのコレクションを提供します。

データポイントプロパティは、文書作成アプリケーションにおける「段落書式」に似ています。各段落を個別に書式設定する必要はありません。代わりに、デフォルトの書式を定義して、文書内の段落に適用します。データポイントライブラリは、データポイントに対して同じ機能を提供します。さまざまなデバイスからあなたのデータポイントへ容易に適用できる、多数のデフォルトデータポイント「テンプレート」が提供されます。

コックピットアプリケーションは、どのようにデータポイントライブラリを使用するのでしょう？ 色またはラベルなど、データポイントについてのデフォルトの可視化を判断するため、Things Cloudプラットフォームはデータポイントライブラリを検索し、一致するエントリを探します。データポイントライブラリ内のフラグメントとシリーズの値がメジャーメントと一致すると、エントリは「一致する」と見なされます。一致するエントリが見つかれば、該当するデータポイントプロパティがデフォルトの可視化に使用されます。

加えて、データポイントライブラリのプロパティはしきい値ビジネスルールにも使われます。データポイントライブラリで構成設定された赤色と黄色の値は、アラームを発動するしきい値ルールによって使用されます。

データポイントライブラリを開くには、ナビゲータの構成メニューで データポイントライブラリ をクリックします。

使用可能なデータポイントのリストが開きます。データポイントごとに、次の情報がリストに表示されます。

• データポイントの色とラベル
• フラグメント名とシリーズ
• メジャーメント単位
• 値（最小値、最大値、赤/黄の範囲）

データポイントをライブラリに追加

1. トップメニューバーのデータポイントを追加をクリックします。
2. 次の情報を入力します。

3. 保存をクリックして、データポイントをライブラリに追加します。

データポイントの編集

リスト内のそれぞれのエントリをクリックするか、エントリの右側にあるメニューアイコンをクリックし、編集をクリックします。

データポイントの削除

エントリの右側にあるメニューアイコンをクリックし、削除をクリックします。

スマートルール

Things Cloudには、リアルタイムでデータを分析し、データに基づいてアクションを実行できるカスタムストリーミング処理アプリケーションが含まれています。

コックピットアプリケーションには、簡単にルールを作成するために、テンプレート（スマートルールテンプレート）からルールを作成できるスマートルールビルダーを備えています。

スマートルール機能は、テナントに Smartrule マイクロサービス と Apama-ctrl マイクロサービス が 登録されている場合にのみ使用できます。

スマートルールはパラメータ化され、パラメータには2通りのソースがあります。

• ルールパラメータ は、スマートルールをテンプレートから作成する場合にユーザーから提供されます。例としてメールアドレスやアラームテキストが挙げられます。
• オブジェクトパラメータ はグループまたはデバイスに保存されます。これらのパラメータはスマートルール作成後でも編集可能です。例として、しきい値の最小値と最大値が挙げられます。

スマートルールには2つの種類があります。

• グローバルスマートルール

  グローバルスマートルールは、グローバルコンテキスト（スマート ルール ページ、アラーム、データエクスプローラなど）で作成されます。

• ローカルスマートルール

  ローカルスマートルールは、グループまたはデバイスのいずれかで作成されます。これらは、グループ/デバイスにアクセスできるすべてのユーザーに表示されます。

スマートルールは次の 2つの場所で確認できます。

• 構成メニューのグローバルスマートルールページ

  

  グローバルスマートルールページでは、グローバルスマートルールのみが表示されます。

• デバイスまたはグループのスマートルールタブ

  

  ローカルコンテキスト（グループまたはデバイス）では、ローカルのスマートルールが表示されます。関連する権限を持つユーザーの場合、ローカルとグローバルの両方のスマートルールが表示されます。

スマートルールの作成

スマートルールは、ナビゲータの構成メニューからグローバルスマートルールページ、または任意のグループ/デバイスの情報タブ（ローカルのスマートルール）で作成できます。

1. トップメニューバーのスマートルールを追加をクリックします。
   
2. リストからスマートルールのテンプレートを選択します。注記：このリストはインストールによって異なる場合があります。
3. 次のウィンドウで、スライダーをクリックしてルールを有効にするか無効にするかを選択します。詳細については、グループ/デバイスのスマートルールを有効化/無効化 をご覧ください。
4. 次に、ルールのパラメータを設定します。パラメータはルールによって異なります。詳細については、スマートルールコレクションで各ルールの説明をご覧ください。
5. 作成をクリックして、スマートルールを作成します。

スマートルールは複数回インスタンス化できます。

スマートルールの編集

エントリの右端にあるメニューアイコンをクリックし、編集をクリックします。

フィールドについての詳細はスマートルールの作成をご覧ください。

スマートルールの複製

1. エントリの右端にあるメニューアイコンをクリックし、複製をクリックします。
2. 少なくともルール名を変更します。
3. 作成をクリックしてスマートルールを保存し、スマートルールリストに戻ります。

スマートルールの削除

エントリの右端にあるメニューアイコンをクリックし、削除をクリックします。

スマートルールのデバッグ

デバッグを容易にするために、スマートルールから対応するイベント処理モジュールへの直接リンクがあります。

エントリの右端にあるメニューアイコンをクリックし、検査をクリックしてこのリンクを使用します。

グループのスマートルールでの対象デバイスについて

グループに対してスマートルールを作成する際、そのとき登録されているデバイスを含めるかどうかを選ぶことができます。 なお、グループのスマートルールを作成した後にデバイス追加された場合、そのデバイスは初期状態 対象外 として登録されます。対象とする場合、グループのスマートルールに対し、対象デバイスとして明示的に含める操作が必要です。

グループ/デバイスでのスマートルールの有効化/無効化

スマートルールが編集ウィンドウ（グローバルスマートルールページ、特定のデバイス/グループのスマートルールタブからアクセス可能）で有効に設定されている場合、そのスマートルールは全体的に「有効」になり（基礎となるモジュールがデプロイされます）、ルールがデバイスとグループで使用できるようになります。

無効 に設定されている場合、「スイッチオフ」になります（基礎となるモジュールがデプロイされません）。

スマートルールを全体的に有効/無効にすることに加えて、スマートルールは特定のオブジェクト（グループまたはデバイス）に対して、アクティブまたは非アクティブ状態にすることができます。アクティブの場合、ルールはこのグループとデバイスのイベントを処理します。

ルールを明示的にアクティブまたは非アクティブにするには、特定のグループ/デバイスのスマートルールタブに移動し、アクティブ/非アクティブスライダーをそれぞれアクティブまたは非アクティブに設定します。

単一オブジェクトのスマートルールを無効にする使用例としては、特定のデバイスが過剰に多数のしきい値アラームを発生した場合が考えられます。ルールはこのデバイスに対してのみ非アクティブ化できますが、他のすべてのオブジェクトについては引き続きアクティブです。

グループの場合は、グループのみのスライダーでスマートルールを有効/無効にします。その後、スライダー下のドロップダウンボックスを使用して、グループの子のルールを個別にアクティブ/非アクティブにできます。

例: 明示的しきい値を定義する

しきい値ルールを定義するには、次の手順に従います。

1. ナビゲータから該当グループまたはデバイスを選択します。
2. データエクスプローラタブに切り替えます。
3. しきい値を上げるデータポイントがデフォルトで表示されない場合は、データポイントを追加をクリックして、データポイントを追加して選択します。
4. 目的のデータポイントの行の右端にあるメニューアイコンをクリックし、スマートルールを作成を選択します。
   
   
   
5. 「計測値のしきい値超過時 アラームを作成」を選択します。
6. 赤の障害範囲の最小値と最大値を入力します。メジャーメントが赤の障害範囲に入るとアラームが生成され、赤の障害範囲から抜けるとアラームはクリアされます。詳細については、スマートルールコレクションの「計測値のしきい値超過時 アラームを作成」をご覧ください。
7. アラーム作成では、アラームタイプとアラームテキストを任意で編集できます。
8. 対象のアセットもしくはデバイスより、このルールを適用するオブジェクトを選択できます。
9. 作成をクリックして、スマートルールを作成します。

ルールは自動的に有効となり、アラームが発生すると表示されます。

チェーンルールの実行

スマートルールはプラットフォーム内に新規データ項目を作成することができます。例えば、しきい値ルールは新規アラームを作成します。この新規データは、「アラーム時に電子メールを送信」ルールなどのように、別のスマートルールによってさらに取り扱うことができます。

このメカニズムを使用して、連鎖型のスマートルールを作成することができます。

スマートルールコレクション

Things Cloudでは、事前設定されたグローバルスマートルールが使用できます。グローバルスマートルールは種類ごとに、構成するパラメータが異なります。

次のタイプが使用可能です。

アラーム時に電子メールを送信

機能

アラームが発生すると、メールが送信されます。

パラメータ

このルールでは、次のパラメータを使用します。

トラブルシューティング

• アラームが、どこかから複製されたのではなく、生成されたものであることを確認します。

• デバイスがメンテナンスモードであることを確認します。こうすれば、抑制ポリシーにより新しいアラームは生成されません。

• アラームの重大度を変更するアラームマッピング ルールを設定している場合（管理 > アラームマッピングをご覧ください）、アラームの重大度が予想と異なることがあります。

• 迷惑メールフォルダを確認してください。

アラーム時に重大度を上げる

機能

アラームが一定時間有効になっていると、重大度が上がります。

パラメータ

このルールでは、次のパラメータを使用します。

説明

設定されたタイプのアラームが発生すると、アラームの有効時間の監視が開始されます。

指定した継続時間が経過してもアラームが有効な場合は、重大度が 1レベル（マイナーからメジャーなど）上がります。

アラームがクリティカル状態に達すると、それ以上のアクションができなくなるため、監視は停止します。

ジオフェンスの際にアラームを作成

機能

ジオフェンスの境界を越えると、アラームが作成されます。

このルールでは、ジオフェンスに入るか出るか、またはその両方を行うように設定できます。既存のアラームは、例えば、ジオフェンス領域を出た追跡車両がジオフェンス領域に再び入ってきた場合など、反対の条件が再び当てはまる場合にクリアされます。

パラメータ

このルールでは、次のパラメータを使用します。

トラブルシューティング

• ルールを作成/有効化した後、少なくとも一度はデバイスがジオフェンス内にあることを確認してください。

• デバイスがメンテナンスモードであることを確認します。こうすれば、抑制ポリシーにより新しいアラームは生成されません。

• アラームの重大度を変更するアラームマッピング ルールを設定している場合(管理 > アラームマッピングをご覧ください)、アラームの重大度が予想と異なることがあります。

ジオフェンスの際に Eメールを送信

機能

ジオフェンスの境界を越えると、メールが送信されます。

パラメータ

このルールでは、次のパラメータを使用します。

トラブルシューティング

• ルールを作成/有効化した後、少なくとも一度はデバイスがジオフェンス内にあることを確認してください。

• 迷惑メールフォルダを確認してください。

エネルギー消費を計算

機能

電気、ガス、水道メーターからのデータに基づいて消費データポイントを作成します。

パラメータ

このルールでは、次のパラメータを使用します。

消費メジャーメントの単位は常に1時間あたりのものになります（メジャーメントが「kg」の場合、消費は「kg/時」になります）。

このルールは、指定した時間の最後の2つのメジャーメントを取得し、値と時間の差を計算してから、1時間あたりの消費量を計算します。

例
20分ごとに計算するようにルールが設定されているとします。次のメジャーメントが送信されます。
11:59に100kg、12:14に200kg。
12:20にルールがトリガーされ、最後の2つのメジャーメントが取得されます。値と時間の差を計算します。したがって、12:20に作成された消費メジャーメント値は400kg/hとなります。 最後の期間に新しいメジャーメントが作成されなかった場合は、消費量 0のメジャーメントが作成されます。

計測値がない場合にアラームを作成

機能

新しいメジャーメントデータを一定時間受信しなかった場合、アラームを発生します。

パラメータ

このルールでは、次のパラメータを使用します。

アラーム時に操作を実行

機能

特定のアラームが発生すると、指定された操作がデバイスに送信されます。

パラメータ

このルールでは、次のパラメータを使用します。

計測のしきい値の場合、アラームを作成

機能

メジャーメントの値が赤色/黄色範囲（障害/注意範囲）に入るとアラームが発生し、赤色/黄色範囲から抜けるとアラームがクリアされます。

アラームの重大度は、次のように決定されます。

• メジャーメント値が赤色の範囲（障害範囲）に移動すると、クリティカルアラームが作成されます。赤色の範囲外に移動すると、クリティカルアラームはクリアされます。

• メジャーメント値が黄色の範囲（注意範囲）に移動すると、マイナーアラームが作成されます。黄色の範囲外に移動すると、マイナーアラームがクリアされます。

このルールでは、デバイスオブジェクトまたはデータポイントライブラリの次のパラメータを使用します。

• データポイントライブラリの赤色/黄色の範囲（障害/注意範囲）: システムがクリティカルアラームを作成する必要がある場合は赤色の範囲、マイナーアラームを作成する必要がある場合は黄色の範囲。データポイントには、赤色/黄色の範囲に少なくとも 1つが設定されている必要があります。

• オブジェクトの赤色の範囲（障害範囲）: システムがクリティカルアラームを作成する必要がある場合の範囲。これらの値は、各データポイントのデータエクスプローラで編集できます。 これらは、許容される最小値/最大値を含む狭い間隔［赤の最小値：赤の最大値］であることに注意してください。以下の例もご覧ください。

• オブジェクトの黄色の範囲: システムがマイナーアラームを作成する必要がある場合の範囲。これらの値は、各データポイントのデータエクスプローラで編集できます。これらは、許容される最小値を含むが、許容される最大値を含まない半開間隔［黄色の最小値：黄色の最大値］であることに注意してください。以下の例も参照してください。

例

例1 - 赤色の範囲（障害範囲）

赤色の範囲を［60 ; 90］に設定すると、

• 赤色の最小値: 60
• 赤色の最大値: 90

メジャーメントが 60～90（値60と90を含む）の場合、クリティカルアラーム（赤色）が作成されます。

例2 - 黄色の範囲（注意範囲）

黄色の範囲（注意範囲）を［30 ; 50］に設定すると、

• 黄色の最小値: 30
• 黄色の最大値: 50

メジャーメントが 30～49 の場合、マイナーアラーム（黄色）が作成されます。 値50 は黄色の範囲外です。

例3 - 赤色/黄色の範囲（障害/注意範囲）

上記の動作の結果、次のような構成を設定できます。

• 赤の最小値: 60
• 赤の最大値: 90
• 黄色の最小値: 30
• 黄色の最大値: 60

メジャーメントが 60 の場合、赤色には値60 が含まれるため、結果としてクリティカルアラーム(赤色)が作成されます。

例4 - 重複

赤色の範囲（障害範囲）と黄色の範囲（注意範囲）は重なることがあります。この重複範囲内の値は、黄色の範囲内にあるものとして扱われます。

黄色の範囲を［30 ; 60］に設定し、赤色の範囲を［50 ; 90］に設定すると、次のようになります。

• 赤色の最小値: 50
• 赤色の最大値: 90
• 黄色の最小値: 30
• 黄色の最大値: 60

メジャーメントが 55 の場合、マイナーアラーム(黄色)が作成されます。

これらのメカニズムを使用して、データポイントライブラリで全体的なしきい値範囲を構成できます。これらの全体的な値は、特定のオブジェクトに対してケースバイケースでオーバーライドできます。

パラメータ

このルールでは、次のパラメータを使用します。

説明

このルールは、入力されるメジャーメントごとに次の手順を実行します。

• スマートルールに有効なデータポイントがあるかどうかを確認します。それがない場合は、ルールエンジン（CEP）から重大度がメジャーアラームが送信され、ルール設定が無効であることを通知します。

• ソースオブジェクトに対してルールが有効になっているかどうかを確認します。

• メジャーメントにフラグメントとシリーズ(設定データポイントのパラメータ)のデータが含まれているかどうかを確認します。

• 赤色/黄色の範囲（障害/注意範囲）のデータは、次のいずれかから収集されます。

  • データポイントライブラリ（制御パラメータ）
  • ソースオブジェクト（メジャーメント）が見つかった場合、ソースオブジェクトでのデータポイント優先の範囲がマージ（結合）されます。

マージ（結合）されたパラメータで、赤色/黄色の範囲（障害/注意範囲）が定義されていない場合、アラームは生成されません。

• 赤色の範囲（障害範囲）内の受信値: オブジェクトに対して特定のタイプの重大度がクリティカルのアクティブなアラームがない場合は、クリティカルアラームを作成します。それ以外は何もしません。

• 黄色の範囲（注意範囲）内の受信値: オブジェクトに対して特定のタイプの重大度がマイナーのアクティブなアラームがある場合は、マイナーアラームを作成します。それ以外は何もしません。

• 黄色/赤色の範囲外のメジャーメント: オブジェクトに対して指定したタイプのアクティブアラームがある場合、クリティカルアラームまたはマイナーアラーム（あるいはその両方）をクリアします。

トラブルシューティング

• アラームが、どこかから複製されたのではなく、生成されたものであることを確認します。

• デバイスがメンテナンスモードであることを確認します。こうすれば、抑制ポリシーにより新しいアラームは生成されません。

• アラームの重大度を変更するアラームマッピング ルールを設定している場合（管理 > アラームマッピングをご覧ください）、アラームの重大度が予想と異なることがあります。

• 次回のスケジュールされたメジャーメントでアラームがクリアされていて、その値が緑色の範囲になっているか確認してください。

計測値のしきい値超過時アラームを作成

機能

メジャーメント値が赤色の範囲（障害範囲）に入るか、赤色の範囲から出ると、クリティカルアラームが生成またはクリアされます。

アラームの重大度は、次のように決定されます。

• メジャーメントが赤色の範囲（障害範囲）に移動すると、重大度はクリティカルになります。

• メジャーメントが緑色の範囲に入ると、アラームは作成されません。

パラメータ

このルールでは、次のパラメータを使用します。

トラブルシューティング

• アラームが、どこかから複製されたのではなく、生成されたものであることを確認します。

• デバイスがメンテナンスモードであることを確認します。こうすれば、抑制ポリシーにより新しいアラームは生成されません。

• アラームの重大度を変更するアラームマッピング ルールを設定している場合（管理 > アラームマッピングをご覧ください）、アラームの重大度が予想と異なることがあります。

• 次回スケジュールされたメジャーメントでアラームがクリアされていて、その値が緑色の範囲になっているか確認してください。

スマートルール変数

一部のルールパラメータに、さまざまなトリガーフィールドを変数として使うことができます。ルールがトリガーされると、変数はトリガーフィールドの実際の値に置き換えられます。

このメカニズムを使用すると、デバイス名またはアラームテキストをさまざまな出力（Eメールなど）で行うことができます。

すべてのトリガー（アラーム、メジャーメント、オペレーション、イベント）から使用される共通フィールド

オペレーション固有のフィールド

メジャーメント固有のフィールド

さらに、次のパターンがサポートされています。

例

Things Cloud トリガー

{
  "source":{
    "id":"10200"
  },
  "type":"TestEvent",
  "text":"sensor was triggered",
  "time":"2014-03-03T12:03:27.845Z",
  "c8y_Position":{
    "lat":2,
    "lng":2
  },
  "c8y_evtdata":{
    "data1":111,
    "date2":222,
    "evtInnerData":{
      "indate1":333,
      "indate2":444
    }
  }
}

例えば、ここでは次の変数を定義できます。

コックピットアプリケーションの構成

Things Cloud では、個別のニーズに応じてカスタムコックピット アプリケーションを構成できます。

カスタムコックピット アプリケーションの構成

ナビゲータで、構成メニューのアプリ構成をクリックします。

アプリ構成ページでは、コックピットアプリケーションをさまざまな面でカスタマイズできます。

機能

機能セクションでは、グローバル検索、アラーム、データエクスプローラなどの特定の機能を無効にすることができます。

デフォルトでは、すべての機能が有効になっています。機能を無効にするには、機能の横にあるスライダーを使用します。ナビゲータのそれぞれのメニュー項目（グローバル検索ボタンと同様の各ボタン）はすぐに削除され、再度有効になるまで機能は使用できなくなります。

トップレベル ノード

トップレベル ノード で、ナビゲータの最上位階層に表示するグループを選択できます。デフォルトでは、グループエントリのみが表示されます（機能セクションで無効になっていない場合）。

右側でナビゲータのトップレベル ノードとして表示するルートグループまたはサブグループを選択します。選択すると、グループがカスタムのトップレベル ノードのリストに追加されます。さらに、特定のグループのデバイスの表示を有効/無効にすることで、ノードをさらに構成できます。無効にすると、このグループのすべてのデバイスが非表示になり、ナビゲータに表示されません。

ホームダッシュボード

ホームダッシュボードセクションでは、ホームダッシュボード（このアプリケーションのランディングページ）の処理方法を選択できます。

ホームダッシュボードのカスタマイズには、以下のオプションのいずれかを選択できます。

• デフォルト ホーム ダッシュボード：テナント全体に反映されます（デフォルト）。
• カスタム ホーム ダッシュボード：現在のカスタムアプリケーションにのみ反映されます。
• ユーザー ホーム ダッシュボード：現在のユーザーにのみ反映されます。このユーザーには、アクセス権限のタイプ「インベントリ」の作成権限が必要になります。

ホームダッシュボードの変更を元に戻すには、ダッシュボードをリセットをクリックします。これにより、ダッシュボードのすべての変更が元に戻り、初期状態に戻ります。

ナビゲータの非表示

最後に、起動時にナビゲータを非表示にするかどうかを指定できます。デフォルトでは、ナビゲータは起動時に表示されます。