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

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

アラームリスト

アラームリスト ウィジェットは、オブジェクト、アラームの重大度、アラームのステータスでフィルタリングされたアラームの一覧を表示します。各アラームに提供される情報の詳細については、アラームの操作 を参照してください。

アラームリストウィジェット

設定パラメータ

フィールド 説明
タイトル ウィジェットのタイトル。デフォルトでは、ウィジェットタイプがタイトルとして使用されます。
アセットの選択 グループまたはデバイスを選択し、評価される HTML 式を(オプション)も指定できます。
ステータス 選択したアラームステータスのアラームが発生したデバイスのみを表示します。
タイプ 指定したタイプのアラームのみを表示します。
詳細は、アラームを 1 回クリックすると表示されます。
重大度 選択した重大度のアラームのみを表示します。
順序 アラームは、アクティブなステータス別(デフォルト:重大度と時間順)、
日付順(時間順で降順または昇順)、重大度別(時間順)で並べ替えることができます。
自動更新 選択した頻度で、アラームリストを自動的に更新します。
子デバイス:
アラームを表示
子デバイスのアラームを表示または非表示にします。

アプリケーション

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

アプリケーションウィジェット

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

アセットノート

アセットノート ウィジェットは、管理ユーザーから現在のウィジェットのすべての所有者に提供するメッセージが表示されます。

アセットノートウィジェット

このメッセージを提供できるのは、ホームダッシュボードの編集権限を持つユーザーのみです。

アセットプロパティ

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

アセットプロパティウィジェット

設定パラメータ

フィールド 説明
タイトル ウィジェットのタイトル。デフォルトでは、ウィジェットタイプがタイトルとして使用されます。
アセットの選択 グループまたはデバイスを選択します。
プロパティ プロパティのリストについては、アセットテーブル を参照してください。
備考
表示モードでは、このウィジェットは空でないプロパティのみを表示します。

アセットテーブル

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

設定パラメータ

フィールド 説明
タイトル ウィジェットのタイトル。デフォルトでは、ウィジェットタイプがタイトルとして使用されます。
アセットの選択 すべての子デバイスが表示されるオブジェクトを選択します。通常、グループオブジェクトになります。
プロパティ オブジェクトのプロパティまたはアクションを選択して、テーブル内の列として表示します。

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

アセットテーブルウィジェット

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

アセットテーブルウィジェットの例

プロパティを追加する

+プロパティの追加 をクリックし、追加するプロパティを 1 つ以上選択します。

備考
プロパティの「発生中のアラームステータス」は、アクティブなアラームをアイコンとしてテーブルに表示します。このプロパティを選択した場合、列一覧で「発生中のアラームステータス」というレンダータイプも設定する必要があります。

アクションを追加する

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

デバイス再起動ボタンの設定

備考
このダイアログでは、シェルコマンドに対応する最初のデバイスの定義済みシェルコマンドが表示されます。該当デバイスがない場合、一覧は空になります。詳細については、シェルを参照してください。
デバイスに送信されるオペレーションを JSON 形式で入力することもできます。サポートされたオペレーションの詳細については、デバイスベンダーにお問い合わせください。

テーブルを修正する

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

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

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

データポイントグラフ

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

データポイントグラフウィジェット

データポイントグラフ ウィジェットを作成する最も簡単な方法は、データエクスプローラに移動して、トップメニューバーの 参照 をクリックし、ダッシュボードにウィジェットとして送信 を選択します。 設定するパラメータの詳細については、視覚化の変更 を参照してください。

データポイントリスト

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

設定パラメータ

フィールド 説明
タイトル ウィジェットのタイトル。デフォルトでは、ウィジェットタイプがタイトルとして使用されます。
データポイント 利用可能なデータポイントの一覧を表示します。少なくとも 1 つのデータポイントを有効にする必要があります。データポイントを追加 をクリックし、一覧にデータポイントを追加します。データポイントの追加方法の詳細については、データポイントを追加する を参照してください。
列表示 / 非表示 表示する列を選択します。
ラベル:データポイントのラベル。詳細は、視覚化の変更 を参照してください。
ターゲット:目標値。データエクスプローラ または データポイントライブラリで構成できます。
現在値:現在の値
差分:現在値と目標値の絶対差分
差分 %:現在値と目標値の差のパーセンテージ
アセット:データポイントのデバイス名またはグループ名

データポイントテーブル

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

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

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

データポイントテーブル

イベントリスト

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

イベントリストウィジェット

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

フィールドバスデバイス

フィールドバスデバイス ウィジェットでは、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}}:上記より汎用的な形式。デバイスのどのフラグメントのプロパティにも対処できます。

    • {{devices[deviceId].name}}:指定されたインデックスのデバイス名

    • {{devices[deviceId].property}}:上記のより一般的な形式です。指定されたインデックスでデバイスのどのプロパティにも参照できます。

HTML コードで次の変数を使用できます:

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

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

  • 厳密: JS や Angularjs ディレクティブを一切許可しません。
  • 緩い: 部分的な JS (イベント) とすべての Angularjs ディレクティブを許可します。
  • なし: すべてを許可します。
備考
サニタイズオプション の1つである「緩い」には、サニタイズから除外されるディレクティブの定義されたリストが含まれます。サニタイズオプションをカスタマイズする方法の例については、HTML コード セクションの「ヘルプテキスト」から参照してください。

HTMLウィジェット

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

  <a style="cursor:pointer;" onclick="location.hash = '#/group/<<group-id>>/dashboard/<<dashboard-id>>'">他のダッシュボードへのリンク</a><br />

KPI

KPI(重要業績評価指標)ウィジェットは、データポイントをラベルとして表示します。例えば、デバイスの温度のデータポイントなどです。

KPIウィジェット

設定パラメータ

左側で、表示するデータポイントを選択します。 「KPI」ウィジェットを作成するには、1 つのアクティブなデータポイントを選択する必要があります。複数のデータポイントを一度に選択すると、構成を保存できません。

右側では、データポイントの表示方法を調整できます。設定項目は、次の通りです。

  • アイコン:データポイントの横に表示されるアイコン
  • 小数点以下の桁数
  • 表示する:タイムスタンプ、アイコン、トレンドアイコンを表示 / 非表示を切り替えます
  • 計測値のフォントサイズ(px)

リニアゲージ

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

線形ゲージウィジェット

備考
ラベルが正しく読み取れない場合は、データポイントの最小値や最大値を増やして、ラベルを読み取り可能な範囲に移動してください。

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

地図

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

地図ウィジェット

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

デバイスを表わすアイコンは色分けされています。使用する色は、次のルールに基づいています。

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

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

  • デバイス名。クリックすると、アプリケーションがそのデバイスに移動します。
  • デバイスが最後に位置を報告した日付(利用可能な場合)

設定パラメータ

  • アセットの選択:地図に表示されるデバイスを選択します。グループを選択すると、グループに含まれるすべてのデバイスが表示されます(サブグループ内のデバイスは除く)。
  • マーカーアイコン:地図上のマーカーのアイコン
  • ズームレベル:地図のデフォルトのズームレベル
  • 中央の境界:地図のデフォルト座標
  • 更新間隔:選択したデバイスまたはアセットの更新間隔。デバイスを 1 つだけ選択している場合、更新間隔の代わりに、リアルタイムオプションと「選択項目をフォロー」トグルを同時に選択できます。これにより、位置情報の更新後にデバイスを追跡します。
備考
対象となるデバイスがいずれも位置が不明の場合、ウィジェットは世界地図を表示し、アイコンは付帯しません。

Markdown

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

Markdownウィジェット

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

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

メッセージ送信

メッセージ送信 ウィジェットは、デバイスにメッセージを送信します。デバイス自体の動作はデバイスによって異なります。c8y_Message オペレーションに対応するデバイスのみで使用できます。

円グラフ

円グラフ ウィジェットは、現在の値を持つデータポイント(メジャーメント)を円グラフで表示します。

設定パラメータ

フィールド 説明
タイトル ウィジェットのタイトル。デフォルトでは、ウィジェットタイプがタイトルとして使用されます。
円グラフ オプション 円グラフ上に、ツールチップ、パーセンテージ、凡例をそれぞれ表示するかどうか選択できます。
データポイント 利用可能なデータポイントの一覧を表示します。
少なくとも 1 つのデータポイントを有効にする必要があります。データポイントを追加 をクリックして、一覧にデータポイントを追加します。データポイント追加方法の詳細については、データポイントを追加する を参照してください。

放射状ゲージ

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

放射状ゲージウィジェット

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

リレーアレイ制御

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

リレー制御

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

ローテーション

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

設定パラメータ

フィールド 説明
タイトル ウィジェットのタイトル。デフォルトでは、ウィジェットタイプがタイトルとして使用されます。
アセットの選択 表示されるグループまたはデバイスを選択します。
レンダリングするオブジェクトモデル レンダリングするオブジェクトモデルのタイプを選択してください。「ボックスモデル」または「電話モデル」のいずれかです。
ワイヤーフレーム 「ワイヤーフレーム」のオン / オフを切り替えます(デフォルト=オン)。「ワイヤーフレーム」モードでは、オブジェクトがスケルトンで表示されます。
カメラタイプ 使用するカメラのタイプを選択します。「平行投影カメラ」または「遠近カメラ」のいずれかです。

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

SCADA

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

SCADA ウィジェットの詳細については、SCADA ウィジェットの使用によるステータス監視 を参照してください。

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

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

SCADAウィジェット

サイロ

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

設定パラメータ

フィールド 説明
タイトル ウィジェットのタイトル。デフォルトでは、ウィジェットタイプがタイトルとして使用されます。
データポイント 利用可能なデータポイントのリストを表示します。
少なくとも 1 つのデータポイントを有効にする必要があります。
データポイントを追加 をクリックして、一覧にデータポイントを追加します。
データポイントの追加方法の詳細については、データポイントを追加する を参照してください。

信号機

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

設定パラメータ

フィールド 説明
タイトル ウィジェットのタイトル。デフォルトでは、ウィジェットタイプがタイトルとして使用されます。
アセットの選択 表示するグループまたはデバイスを選択します。
状態マッピング 各信号のプロパティを選択します。該当する信号を点滅させるには、
プロパティの値が、true、1、空でない文字列、null 以外の数値のいずれかの必要があります。