CSV によるデバイス情報のインポート/エクスポートが可能です。
CSV エクスポート
表示されているデバイス情報の一覧を CSV ファイルとしてダウンロードすることが可能です。CSV ファイルの形式は、「通常のデバイス情報を掲載したもの」と「アプリのインストール情報が掲載されたもの」の２種類あります。
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 と合わせる必要があります。 |