Soracom

Harvest Files に画像ファイルを保存して、その画像ファイルを Lagoon 3 の Dashboard に表示できます。Harvest Files の画像を表示できる Panel の種類は以下のとおりです。

• Soracom Dynamic Image Panel
• Soracom X/Y Image

ステップ 1: Harvest Files を有効化する

SORACOM Lagoon で可視化するために、Harvest Files の /lagoon/ 以下に保存されたファイルについて、パスなどの情報を自動的に Harvest Data に保存するように設定します。

1. SIM グループ画面で [SORACOM Harvest Files 設定] をクリックします。

   SIM グループ画面を表示する操作について詳しくは、グループの設定を変更する を参照してください。

2. スイッチをクリックして「ON」にします。

3. 以下の項目を設定し、[保存] をクリックします。

   設定	項目
   [HARVEST DATA 連携]	ON
   [連携対象のファイルパス]	/lagoon/.*

   

   設定について詳しくは、SORACOM Harvest Files を有効化する を参照してください。

4. IoT SIM が所属するグループを切り替えます。

   IoT SIM から送信したデータが Harvest Files に保存できるようになりました。

ステップ 2: デバイスから HTTP でファイルを Harvest Files に送信する

SORACOM Air for セルラーの IoT SIM または SORACOM Arc のバーチャル SIM/Subscriber を利用しているデバイスで、Harvest Files のエントリポイント に、以下のように HTTP PUT もしくは POST リクエストを送信すると Harvest Files にファイルが保存されます。

たとえば、以下のように HTTP PUT リクエストを送信して、/lagoon/harvest.png (PNG ファイル) を保存します。

curl -v -X PUT http://harvest-files.soracom.io/lagoon/harvest.png \
-H "content-type:image/png" \
--data-binary @harvest.png

ステップ 3: Harvest Files に保存されたファイルを確認する

ユーザーコンソールでは、Harvest Files で保存されたファイルを確認およびダウンロードできます。

1. ユーザーコンソール にログインし、Harvest Files に画像を保存した IoT SIM にあわせてカバレッジタイプを変更します。

   たとえば、グローバルカバレッジの IoT SIM を利用した場合は、グローバルカバレッジの表示に変更します。詳しくは、SORACOM ユーザーコンソールで表示するカバレッジタイプを変更する を参照してください。

2. [メニュー] → [データ収集・蓄積・可視化] → [SORACOM Harvest Files] の順にクリックします。

3. lagoon/ ディレクトリをクリックします。

   harvest.png が表示されます。

   

   保存されたファイルは、この画面でダウンロードできます。

ステップ 4: Harvest Data に保存されたデータを確認する

ステップ 1: Harvest Files を有効化する で設定した内容に従って、Harvest Files に保存されたファイルのパスが、Harvest Data に保存されています。ユーザーコンソールの「SORACOM Harvest Data」画面でデータを確認します。

1. [メニュー] → [データ収集・蓄積・可視化] → [SORACOM Harvest Data] の順にクリックします。

2. [リソース] で、ステップ 2: デバイスから HTTP でファイルを Harvest Files に送信する で利用した IoT SIM を選択します。

   Harvest Files に保存されたファイルのパスが、Harvest Data に保存されていることが確認できます。

   

   データ:

   {
     "url": "/v1/files/private/lagoon/harvest.png",
     "contentType": "image/png",
     "contentLength": 13138,
     "eTag": "de9b7c99acd744cdca2f37ad20adb011"
   }
   

ステップ 5: SORACOM Lagoon 3 で Harvest Files に保存した画像を表示する

Harvest Files に保存した画像を Lagoon 3 で表示します。

1. Lagoon コンソールにアクセスして、新しい Dashboard と Panel を作成 します。

   「Edit Panel」画面が表示されます。

   

2. Panel に表示するデータを選択 します。

   Panel は以下のように設定します。

   項目	説明
   Query A	「Air」→ ステップ 2: デバイスから HTTP でファイルを Harvest Files に送信する で利用した IoT SIM →「Table」の順に選択します。

3. Panel の表示内容を設定します。

   Panel は以下のように設定します。

   項目	説明
   Panel の種類	Soracom Dynamic Image Panel
   [Settings] → [言語] (Language)	「日本語」を選択します。
   [Settings] → [モード]	「Harvest Files」を選択します。
   [Settings] → [名前]	「A-url」を選択します。
   [Settings] → [縦横比を保つ]	オンにします。

   

   Harvest Data に保存されたデータのうち、最新データの url に記載されたパスの画像ファイルが表示されます。

   

同一の IoT SIM で任意のデータを Harvest Data に送信する場合

Harvest Files の画像が表示されないことがあります。以下の手順で Panel の設定を変更すると、最後に Harvest Files に保存した画像が表示されます。

{
  "temperature": 20
}

1. SORACOM Dynamic Image Panel の [Transform] をクリックして、「Filter data by values」を選択します。

2. 以下の項目を設定します。

   項目	説明
   [Filter type]	「Include」を選択します。
   [Conditions]	「Match any」のままにします。

3. [＋Add condtion] をクリックして、以下の項目を設定します。

   項目	説明
   [Field]	「url」を選択します。
   [Match]	「Is not null」を選択します。