CSV インポート/エクスポート

CSV によるデバイス情報のインポート/エクスポートが可能です。

CSV エクスポート

表示されているデバイス情報の一覧を CSV ファイルとしてダウンロードすることが可能です。CSV ファイルの形式は、「通常のデバイス情報を掲載したもの」と「アプリのインストール情報が掲載されたもの」の2種類あります。

CSV レイアウト

「通常のデバイス情報を掲載したもの」

項目名 説明 必須
id デバイス ID
access_token アクセストークン
hardware ハードウェアの識別子
description デバイスの説明。metadata の中にも含まれる
metadata メタデータ
devicekey デバイスキー
os インストールされている OS の識別子
osVersion インストールされている OS のバージョン
region デバイスが接続されるサーバの地域
status ステータス
wifi_mac_address Wifi の MAC アドレス
ether_mac_address イーサネットの MAC アドレス
pingInterval オンライン確認間隔
createdAt デバイスの登録日

「アプリのインストール情報が掲載されたもの」

後述する CSV インポートに適したフォーマットになります。この形式でエクスポートするには、検索条件にアプリの ID を含めて検索している必要があります。これはアプリによってオプション値の指定が異なり、CSV のレイアウトを揃える必要があるためです。

項目名 説明 利用可能な値
obniz.id デバイス ID 0000-0000 の形式
obniz.metadata.description デバイスの説明
obniz.activate_status ステータス active / inactive
obniz.online_check_interval オンライン確認間隔 1 ~ 30
obniz.notification.offline.enable オフライン通知 の有効/無効 enable / disable
obniz.notification.offline.add_issue オフラインを検知した際に課題にするかどうか enable / disable
install_app[0].id インストールするアプリ ID。全て同じアプリ ID を指定してください。 wa_xxx
install_app[0].configs.xxx アプリインストール時に必要なオプション値。xxx はオプション key と合わせる必要があります。

※オプション値は、アプリごとにその名前と必要な数が異なります。
以下オプション値と CSV レイアウトの例です。

通知温度(temperature_limit)と通知方法(notification_way)が必要な温度測定アプリの場合
項目名 説明 利用可能な値
obniz.id デバイス ID 0000-0000 の形式
obniz.metadata.description デバイスの説明
obniz.activate_status ステータス active / inactive
obniz.online_check_interval オンライン確認間隔 1 ~ 30
obniz.notification.offline.enable オフライン通知 の有効/無効 enable / disable
obniz.notification.offline.add_issue オフラインを検知した際に課題にするかどうか enable / disable
install_app[0].id インストールするアプリ ID。全て同じアプリ ID を指定してください。 wa_xxx
install_app[0].configs.temperature_limit 通知温度(アプリインストール時に必要なオプション値)
install_app[0].configs.notification_way 通通知方法(アプリインストール時に必要なオプション値)
オプション値が全く必要ないサンプルアプリの場合
項目名 説明 利用可能な値
obniz.id デバイス ID 0000-0000 の形式
obniz.metadata.description デバイスの説明
obniz.activate_status ステータス active / inactive
obniz.online_check_interval オンライン確認間隔 1 ~ 30
obniz.notification.offline.enable オフライン通知 の有効/無効 enable / disable
obniz.notification.offline.add_issue オフラインを検知した際に課題にするかどうか enable / disable
install_app[0].id インストールするアプリ ID。全て同じアプリ ID を指定してください。 wa_xxx

CSV インポート

CSV ファイルによって、特定アプリを複数デバイスに対して一括インストールします。インストールは、アプリが何もインストールされていないデバイスに対しては登録という形で、同アプリがすでにインストールされているデバイスに対しては更新という形で、行われます。必要なオプション値がインストールするアプリによって変わるので、アプリ ID で絞り込んだデバイス情報を CSV エクスポートし、これを編集することで CSV をスムーズに作成することが可能です。

CSV レイアウト

「アプリのインストール情報が掲載されたもの」でエクスポートした csv をそのまま使用できます。
文字コードはShift_JISをご利用ください。

項目名 説明 利用可能な値 必須
obniz.id デバイス ID 0000-0000 の形式
obniz.metadata.description デバイスの説明
obniz.activate_status ステータス active / inactive
obniz.online_check_interval オンライン確認間隔 1 ~ 30
obniz.notification.offline.enable オフライン通知 の有効/無効 enable / disable
obniz.notification.offline.add_issue オフラインを検知した際に課題にするかどうか enable / disable
install_app[0].id インストールするアプリ ID。全て同じアプリ ID を指定してください。 wa_xxx
install_app[0].configs.xxx アプリインストール時に必要なオプション値。xxx はオプション key と合わせる必要があります。