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      | [オンライン確認間隔](./pinginterval)      |      |
| createdAt         | デバイスの登録日                          | ✅   |

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

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

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