メインコンテンツまでスキップ
iOS
Android
Windows
macOS
tvos

CSVファイルによる情報作成（ユーザおよびデバイス）

管理するユーザとデバイスを、組織/デバイスタグ/テンプレートへの登録とまとめて作成・更新することができます。
この場合、定められたフォーマットに従って情報を入力したCSVファイル（コンマ区切りのテキストファイル）を利用します。
CSVファイルは、テキストエディタや表計算ソフト等で作成することができます。ユーザ・デバイス一括追加のCSVファイルはこちらからダウンロードできます。
また、CSVファイルをアップロードする、インポート履歴を確認するも併せてご参照ください。

CSVファイルの仕様​

  • CSVファイルの一行目はヘッダ項目名で、書式指定の通り作成してください。入力するコラムによって、以下のパターンでの一括登録・更新ができるようになっています。
  • 全ての情報を一括作成・更新（ユーザとデバイスが関連付けられます）
  • デバイス情報のみを一括作成・更新
  • ユーザ情報のみを一括作成・更新
  • ヘッダ項目名はスペースなしとなっています
  • CSVファイルの記述は、大文字・小文字が区別されます。ただし、デバイスの管理番号のみ、大文字・小文字が区別されません。（例：DEVICE01とdevice01は同一のものとみなします。）

★：それぞれの用途で必須となる項目です
〇：ブランクの場合、その値が作成されない項目です（※1）
×：ユーザのみ、デバイスのみ作成の場合、ブランクにする必要のある項目です

ヘッダ項目名内容全てデバイスユーザ
UserNameユーザを一意に識別する ID★★★
Nameユーザの氏名〇★〇
EmailAddressユーザのメールアドレス〇★〇
SendVPPInvitationEmailVPPアプリをユーザ単位で配付する際にのみ使用します。
ユーザの作成・更新時に1を指定するとEmailAddressで指定したアドレスにVPPの招待メールが送信されます。		〇〇
UserDescriptionユーザ用の任意に入力できる情報〇★〇
Organizationsユーザに所属させる組織の組織ID（あらかじめ該当する組織を作成しておく必要があります）。複数の組織を設定する場合は|で区切ります
組織を利用しない場合、この項目は不要です		〇〇〇
Identifierデバイスを一意に識別する管理番号
★★★
Templateデバイスに関連付けるテンプレート（あらかじめ該当するテンプレートを作成しておく必要があります）〇〇★
Codeチェックインに使用するコード。ブランクの場合自動生成〇
※2		〇
※2		★
OSios、android、windows、macos （小文字で指定）
作成時のみ指定でき、更新はできません。		★★★
DeviceTagsデバイスに設定するデバイスタグ名（あらかじめ該当するデバイスタグを作成しておく必要があります）。複数のデバイスタグを設定する場合は|で区切ります
デバイスタグを利用しない場合、この項目は不要です		〇〇
WifiMacデバイスチェックインを制限するWi-Fi MACアドレス
※iOSおよびAndroidのみ		〇〇★
IMEIデバイスチェックインを制限するIMEI
※iOSおよびAndroidのみ		〇〇★
MEIDデバイスチェックインを制限するMEID
※iOSおよびAndroidのみ		〇〇★
UDIDデバイスチェックインを制限するUDID
※iOSのみ		〇〇★
Serialデバイスチェックインを制限するシリアル番号
※Windowsのみ		〇〇★
ExpirationDaysチェックイン有効期限までの日数〇
※3		〇
※3		★
DisplayNameデバイスにつけるニックネーム等〇〇★
Descriptionデバイス用の任意に入力できる情報〇〇★
RegistrationEmailチェックインに使用するメールアドレス。※チェックイン用メールは、メールアドレスを入力してデバイス情報を保存・更新したタイミングでその都度送信されます。〇〇★

※1各レコードにおける〇＝ブランクの取り扱いは以下の通りとなります。

CSVの値作成時更新時
ブランク値を作成しない登録されている値を消去
値が入っているCSVの値を適用CSVの値で更新

※2Codeコラムの取り扱いは以下の通りです。

CSVの値作成時更新時
ブランクランダムコードを自動生成作成時のランダムコードを保持
値が入っているCSVの値を適用CSVの値で更新

※3ExpirationDaysコラムの取り扱いは以下の通りです。

CSVの値作成時更新時
ブランク7日後を自動セット7日後を自動セット
値が入っているCSVの値を適用CSVの値で更新

管理デバイスの一括更新に関しては、チェックイン状態によって以下のように取り扱われます。

チェックイン状態ふるまい
チェックイン待ち
期限切れ		値の更新が可能（os以外）
チェックイン済み以下のコラム以外は更新可能
os、Code、WifiMac、IMEI、MEID、UDID、ExpirationDays、RegistrationEmail
登録解除済値の更新が不可（新しくデバイス登録する必要があります）

＜CSVファイルのサンプル＞​

サンプル1　ユーザ、デバイスを関連付けて作成する場合
UserName,Name,EmailAddress,UserDescription,Identifier,Template,Code,OS,WifiMac,IMEI,MEID,UDID,Serial,ExpirationDays,DisplayName,Description,RegistrationEmail  
user0001,Test User 1,user0001@example.com,User description 1,apple001,,,ios,,,,,,,iOS Device 1,,  
user0002,Test User 2,user0002@example.com,User description 2,apple002,,,ios,,,,,,,iOS Device 2,,  
user0003,Test User 3,user0003@example.com,User description 3,google001,,,android,,,,,,,Android Device 1,,  
user0004,Test User 4,user0004@example.com,User description 4,google002,,,android,,,,,,,Android Device 2,,  
user0005,Test User 5,user0005@example.com,User description 5,ms001,,,windows,,,,,,,Windows Device 1,,  
user0006,Test User 6,user0006@example.com,User description 6,ms002,,,windows,,,,,,,Windows Device 2,,
サンプル2　デバイスのみを作成する場合
UserName,Name,EmailAddress,UserDescription,Identifier,Template,Code,OS,WifiMac,IMEI,MEID,UDID,Serial,ExpirationDays,DisplayName,Description,RegistrationEmail  
,,,,apple001,,,ios,,,,,,,iOS Device 1,,  
,,,,apple002,,,ios,,,,,,,iOS Device 2,,  
,,,,google001,,,android,,,,,,,Android Device 1,,  
,,,,google002,,,android,,,,,,,Android Device 2,,  
,,,,ms001,,,windows,,,,,,,Windows Device 1,,  
,,,,ms002,,,windows,,,,,,,Windows Device 2,,
サンプル3　ユーザのみを作成する場合
UserName,Name,EmailAddress,UserDescription,Identifier,Template,Code,OS,WifiMac,IMEI,MEID,UDID,Serial,ExpirationDays,DisplayName,Description,RegistrationEmail  
user0001,Test User 1,user0001@example.com,User description 1,,,,,,,,,,,,,  
user0002,Test User 2,user0002@example.com,User description 2,,,,,,,,,,,,,  
user0003,Test User 3,user0003@example.com,User description 3,,,,,,,,,,,,,  
user0004,Test User 4,user0004@example.com,User description 4,,,,,,,,,,,,,  
user0005,Test User 5,user0005@example.com,User description 5,,,,,,,,,,,,,  
user0006,Test User 6,user0006@example.com,User description 6,,,,,,,,,,,,,
サンプル4　ユーザ、デバイスを関連付けて、VPPアプリをユーザ単位で配付する場合
UserName,Name,EmailAddress,SendVPPInvitationEmail,UserDescription,Identifier,Template,Code,OS,WifiMac,IMEI,MEID,UDID,Serial,ExpirationDays,DisplayName,Description,RegistrationEmail  
user0001,Test User 1,user0001@example.com,1,User description 1,apple001,,,ios,,,,,,,iOS Device 1,,  
user0002,Test User 2,user0002@example.com,1,User description 2,apple002,,,ios,,,,,,,iOS Device 2,,  
user0003,Test User 3,user0003@example.com,1,User description 3,apple003,,,ios,,,,,,,iOS Device 3,,  
user0004,Test User 4,user0004@example.com,1,User description 4,apple004,,,ios,,,,,,,iOS Device 4,,  
user0005,Test User 5,user0005@example.com,1,User description 5,apple005,,,ios,,,,,,,iOS Device 5,,  
user0006,Test User 6,user0006@example.com,1,User description 6,apple006,,,ios,,,,,,,iOS Device 6,,

【CSVファイルアップロードする（デバイス・ユーザ）】

  1. 【構成】→【デバイス】/【ユーザ】画面から［インポート］をクリックします。
    　（または、【構成】→ツリーモード→【デバイス】・【ユーザ】を選択し、［インポート］をクリックします。）

  2. インポートしたい項目のタブにてCSVファイルをドラッグ＆ドロップ、もしくはこのエリアをクリックして開くファイル選択画面でCSVファイルを指定します。

  3. ［保存］をクリックします。

  4. 以下のメッセージが出たら［OK］をクリックします。

  5. 画面下部のインポート履歴画面に、今回作成したインポートデータが状態＝PENDINGにて作成されますので、少し時間をおいてからブラウザの更新ボタンをクリックします。

  6. ブラウザを更新後、インポートが完了している場合状態がSUCCESSとなります。
    （もしまだ状態がPENDINGの場合、少し時間をおいて再度ブラウザを更新してください。）
    結果の下のアイコンをクリックすると、インポート結果をCSVファイルでダウンロードでき、データが正常に登録されたかどうかを確認することができます。

インポート履歴を確認する

各インポート画面にはインポート履歴一覧があり、履歴およびインポートの結果を確認することができます。

（１） アイコンをクリックすると、過去のインポート結果を再度ダウンロードできます
（２） 履歴一覧の表示件数を20件（デフォルト）、50件、100件から選択できます
（３） 履歴が複数ページの場合、ページを移動できます
（４） 履歴一覧のチェックボックスを選択して削除することができます