NCMB CLIは、ターミナルを使ってNCMBの操作ができるコマンドラインプログラム(CLI)です。データをエクスポートしたり、逆にインポートできます。
今回はデバイストークンをインポートする際の手順について解説します。
CSVフォーマットについて
利用するCSVフォーマットでは、少なくとも以下の項目を用意してください。
- deviceToken
- deviceType
NCMBの管理画面上は他に、以下の項目を用意しています。
- applicationName
- appVersion
- badge
- channels
- sdkVersion
- timeZone
objectId、createDate、updateDateはあっても登録されません。
データの更新について
CSVインポートする場合、設定されているフィールドを使ってデータの存在チェックをします。デバイストークンの場合は、InstallationクラスのdeviceTokenを存在チェックに使います。
もしデータがない場合は、新規保存します。データがある場合は、他のフィールドデータを適用して更新します。
必須項目について
保存、更新する際にも deviceToken
および deviceType
は必須です。 deviceType
は ios
または android
と入力してください。
インストール
インストールは npm にて行います。Node.jsが必要なので、こちらは別途インストールしてください。
npm install ncmb-cli -g
使い方
コマンドは次のように入力します。型変換をするのでオプションが追加されています。
ncmb csv import filename -b -d --object true --classname Installation -l
$ ncmb csv import --classname Installation installation.csv -b -d --object -l Row #1, data saved. objectId is ugbU98tKfz4yptsb Row #2, data saved. objectId is wL60DHR34ZtqcLK1
まとめ
これまで新規のインストールには対応していましたが、アップデートではエラーが出てしまっていました。今回のアップデートにより、デバイストークンのインポートはもちろん、アップデートも行えます。既存データの移行時にも役立ててください。