Soracom

Users

ドキュメント

Panel に表示するデータを選択する (Query)

Panel で可視化するデータは、「Edit Panel」画面のデータセクションの [Query] タブで選択します。

Data source は「Harvest」を選択してください

Lagoon では、そのほかの Data source は利用できません。

1 つの Panel に複数のデータを表示できます

複数の Query を設定したり、Expression 機能 を利用したりすると、1 つの Panel に複数のデータを表示できます。

Query を設定する

  1. 「Edit Panel」画面を表示します。

    詳しくは、Panel を作成 / 削除する を参照してください。

    [Query] タブに、Query の設定欄が表示されます。

  2. リソースの種類を選択します。

    リソースの種類説明
    AirIoT SIM またはバーチャル SIM/Subscriber から Harvest Data に保存されたデータ
    LoRaLoRaWAN デバイス から Harvest Data に保存されたデータ
    SigfoxSigfox デバイス から Harvest Data に保存されたデータ
    DeviceInventory デバイス から Harvest Data に保存されたデータ
    Demoサンプルデータソース (Demo)

    データが保存されていないリソースの種類は表示されません。

  3. リソースを選択します。

    サンプルデータソース (Demo) の場合は、Device-1 ~ Device-5 のいずれかを選択します。

    たとえば IoT SIM の名前、または IoT SIM の IMSI (名前を設定していない場合) を選択します。

    リソースが正しく表示されない場合は
    • Harvest Data にデータを保存していないリソースは表示されません。Harvest Data のデータを確認する操作については、Harvest Data に保存したデータを確認する を参照してください。
    • Harvest Data にデータが保存されていても、そのデータを Lagoon 3 が取得するまではリソースは表示されません。詳しくは、デバイスが Harvest Data にデータを保存した時刻と Lagoon 3 でデータを利用できる時刻について を参照してください。
    • Lagoon コンソールを表示しているときにリソースが追加されたり、リソースの名前が変更されたりすると、タイミングによってはリソースの最新情報が表示されないことがあります。一度 Lagoon コンソールからログアウトして、再度ログインしてください。
    • Panel の種類 によっては、Harvest Data にデータが保存されていても、表示不可能なデータの場合はリソースが表示されないことがあります。Table を選択して、リソースが表示されるかどうか確認してください。
    • SAM デフォルト権限設定 で特定の API の利用を禁止 (deny) していると、リソースが表示されない場合があります。詳しくは、自動的に作成される SAM ユーザーについて を参照してください。
    IoT SIM やデバイスの名前を設定するには

    SORACOM ユーザーコンソールで設定します。たとえば、IoT SIM の名前を変更する操作については、IoT SIM の名前を設定する を参照してください。

    Variables (変数) を利用する場合は「系列」を選択してから Variables を選択します

    リソースを表す Variables を定義した場合、先にリソース欄で Variables を選択すると、系列が選択できなくなります。リソースでは実際のデバイスを選択したうえで、系列を選択し、その後に Variables を選択してください。

  4. 表示するデータフォーマットを選択します。

    データフォーマット説明
    Standard

    数値が保存された系列を可視化します。

    続けて、可視化する系列を選択します。選択できる系列は、Harvest Data に保存された系列のうち、数値が保存された系列のみです。

    TableHarvest Data に保存されたすべての系列を可視化します。
    MapSoracom Map Panel を利用する際に選択します。[Latitude] で緯度として扱う系列を選択し、[Longitude] で経度として扱う系列を選択します。

  5. 表示する系列を選択します。

    系列名が表示される条件

    「Standard」または「Map」を選択した場合は、Harvest Data に保存されている系列のうち、数値が保存されている系列のみが表示されます。

    Harvest Data に保存したデータの例:

    {
      "number-value": 12.3,
      "string-value": "Hello",
      "object-value": {
        "number-value-in-an-object": 1000,
        "string-value-in-an-object": "Bye"
      }
    }
    

    たとえば、上記のデータを Harvest Data に保存した場合、「Standard」または「Map」を選択したときは、以下の系列のみが表示されます。

    • 12.3 (数値) を含む number-value
    • 1000 (数値) を含む object-value.number-value-in-an-object
    Harvest Data に保存された文字列を表示するには
    • Harvest Data に保存された文字列を表示する場合は、以下のいずれかを利用します。
    • Text は、Lagoon コンソールで指定した文字列を表示する Panel です。Harvest Data に保存されたデータを表示することはできません。

Query の名称変更、複製、表示 / 非表示切り替え、追加 / 削除する

[Query] タブでは Query の名称変更、複製、表示 / 非表示の切り替え、追加 / 削除ができます。

操作説明
Panel ごとに表示する時間範囲を設定する[Query options] を設定します。詳しくは、Panel ごとに時間範囲を設定する (Query options) を参照してください。
データソースへのリクエストとレスポンスを確認する[Query inspector] をクリックすると、データソース (Harvest Data) へのリクエストとレスポンスを確認できます。
Query 名を変更する

Query 名 (デフォルトでは A、B、C...) は、Expression 機能 や Panel の可視化に関する共通オプションの [Overrides] を利用するときに指定します。

Query 名を変更するには、Query 名 (A など) をクリックします。半角英数字 (azAZ09) または記号 (_) を使用してください。それ以外の文字を使用すると、Expression 機能などで正しく参照できない場合があります。

Query を複製する をクリックします。
Query の表示 / 非表示を切り替える をクリックします。
Query を削除する をクリックします。
Query を並べ替える をドラッグします。
Query を追加する[+Query] をクリックします。
Expression を追加する[+Expression] をクリックします。詳しくは、Query を加工して新しい Query を作成する (Expression) を参照してください。