目次

1. 電話端末の一括操作について

2. CSVテンプレートをダウンロードする

3. CSVファイルを編集する

3.1 新規登録用のCSVテンプレートを編集する

3.2 一括更新（・削除）用のCSVテンプレートを編集する

4. CSVファイルをアップロードする

5. アップロード時にエラーが発生した場合

5.3 CSV出力されるエラーメッセージ一覧

5.4 管理画面に表示されるエラーメッセージ一覧

6. 注意事項

1. 電話端末の一括操作について

管理画面「電話端末」メニューでは、CSVファイルを用いて以下の操作が可能です。

・複数の電話端末を一括で新規登録する

・既存の電話端末の情報を一括で更新（修正）する

・複数の電話端末を一括で削除する ※BIZTELバージョン 3.14.10 以降

本マニュアルでは、各操作に必要なCSVファイルのダウンロード、およびアップロード手順を紹介します。

※いずれの操作においても、一括で操作できる電話端末数は最大100件です。

※本操作は、最上位アカウントでのみ操作可能です。
「最上位アカウント」とは、管理画面すべての操作権限を有するシステム管理者アカウントです。
具体的なアカウント情報は非公開のため、「ポータルサイト」または「ご利用案内」をご確認ください。

2. CSVテンプレートをダウンロードする

まずは、操作に必要なCSVファイルのテンプレートを以下の手順でダウンロードします。

手順１．管理画面に最上位アカウントでログインします。

手順２．「電話端末」 > 「電話端末」をクリックします。 

手順３．「一括登録・更新」をクリックします。

手順４．以下の画面が表示されるので、用途に応じたテンプレートをクリックし、CSVファイルをダウンロードします。

3. CSVファイルを編集する

「2. CSVテンプレートをダウンロードする」でダウンロードしたテンプレートに、操作対象のアカウント情報を登録します。

※CSVファイルの編集には、市販のテキストエディタや表計算ソフトなどをご利用ください。

3.1 新規登録用のCSVテンプレートを編集する

ダウンロードしたCSVファイルのヘッダ情報に以下の内容が記載されています。
ヘッダ行の記載内容に従って、下の行に必要な情報を追記します。

※ダウンロードしたCSVテンプレートのヘッダ行（1行目、2行目）は変更しないでください。

※CSVテンプレートに登録されていない設定項目はCSVファイルによる一括設定が行えません。
「1.電話端末の設定」をご参照のうえ、手動で設定を行ってください。

端末名,内線番号,端末パスワード,通知番号,端末種別,メモ
*必須項目,必須項目（1000～3999で指定）,パスワードポリシー参照,任意項目（ハイフン抜きで入力）,必須項目,任意項目

新規登録する電話端末情報を入力すると、例として以下のような入力内容になります。
赤字の箇所が追記した内容です。

端末名,内線番号,端末パスワード,通知番号,端末種別,メモ
*必須項目,必須項目（1000～3999で指定）,パスワードポリシー参照,任意項目（ハイフン抜きで入力）,必須項目,任意項目
電話端末1,1001,********,0120******,BIZTELソフトフォン,
電話端末2,1002,********,0120******,BIZTELソフトフォン,
電話端末3,1003,********,0120******,BIZTELソフトフォン,
ソフトフォン4,1004,********,0120******,BIZTELソフトフォン,

3.2 一括更新（・削除）用のCSVテンプレートを編集する

ダウンロードしたCSVファイルには、ヘッダ情報と登録済の電話端末情報が以下の内容で記載されています。

※ダウンロードしたCSVテンプレートのヘッダ行（1行目、2行目）は変更しないでください。

※CSVテンプレートに登録されていない設定項目はCSVファイルによる一括設定が行えません。
「1.電話端末の設定」をご参照のうえ、手動で設定を行ってください。

ヘッダ行の記載内容に従って、修正が必要な情報を書き換えます。
修正が不要な電話端末は行ごと削除しても問題ありません。

"ID",端末名,端末パスワード,通知番号,端末種別,メモ,削除フラグ
*変更不可,60文字以内,パスワードポリシー参照,削除は半角ハイフン（-）入力,管理画面と同じ表記で入力,削除は半角ハイフン（-）入力,削除対象は半角数字（1）入力
10004,ソフトフォン4,,0120******,BIZTELソフトフォン,,
10003,電話端末3,,0120******,BIZTELソフトフォン,,
10002,電話端末2,,0120******,BIZTELソフトフォン,,
10001,電話端末1,,0120******,BIZTELソフトフォン,,

"ID",端末名,端末パスワード,通知番号,端末種別,メモ,削除フラグ
*変更不可,60文字以内,パスワードポリシー参照,削除は半角ハイフン（-）入力,管理画面と同じ表記で入力,削除は半角ハイフン（-）入力,削除対象は半角数字（1）入力
10004,電話端末4,,0120******,BIZTELソフトフォン,,
10003,電話端末3,,03********,BIZTELソフトフォン,,
10002,電話端末2,,0120******,BIZTELソフトフォン,, ←　★アカウント修正が不要な場合は1行すべて削除
10001,電話端末1,,0120******,BIZTELソフトフォン,,1,　←　★アカウントを削除する場合は削除フラグに「1」を入力

4. CSVファイルをアップロードする

「3. CSVファイルを編集する」で作成したCSVファイルは以下の手順で管理画面にアップロードし、設定を更新します。

本操作は、アカウントの情報が一括更新される為、業務影響のない時間帯で操作してください。

手順１．管理画面に最上位アカウントでログインします。

手順２．「電話端末」 > 「電話端末」をクリックします。 

手順３．「一括登録・更新」をクリックします。

手順４．以下の画面が表示されるので、「ファイル選択」をクリックします。

手順５．「3. CSVファイルを編集する」で作成したCSVファイルをPCからアップロードします。

手順６．「ファイル選択」ボタンの右側にアップロードしたファイル名が表示されるので、アップロードした内容が正しいかどうか確認します。

誤ったファイルをアップロードした場合は、「ファイル選択」をクリックし正しいファイルを再アップロードしてください。

手順７．「CSVアップロード」をクリックします。

手順８．確認ウィンドウが表示されるので、内容を確認し「続ける」をクリックします。

※BIZTELバージョン 3.14.10 未満は「設定を一括で登録・更新・削除します」のメッセージが「設定を一括で登録・更新します」と表示されます。

手順９．アップロードに成功すると、電話端末一覧画面に遷移します。
登録した内容が反映されていることをご確認ください。

5. アップロード時にエラーが発生した場合

何らかの理由によCSVファイルのアップロードが行えない場合、エラー内容が記載されたCSVファイルが自動でダウンロードされます。

エラー内容を確認し、CSVファイルを修正してください。

5.1 エラーの内容を確認する

エラー内容が記載されたCSVファイルは以下の手順で確認します。

手順１．CSVファイルをアップロード後、アカウント一覧画面に遷移する前に「エラーファイル（csv_upload_error.csv）を確認してください」とエラーメッセージが表示されます。

エラーメッセージの「OK」をクリックします。

手順２．エラー内容が記載されたCSVデータがPCにダウンロードされます。

手順３．ダウンロードされたCSVデータを開き、エラー内容を確認します。
記載内容に従って、CSVファイルを修正し再度アップロードしてください。

エラーメッセージに対する詳細な対応手順は「5.3 出力されるエラー内容と対応方法」をご参照ください。

5.2 出力されるエラー内容と対応方法

出力結果に対する修正例

例）新規登録のため、以下の内容でCSVファイルをアップロードしたらエラーが出力された場合
※マニュアル上、パスワードは伏字としていますが、実際にアップロードする値は正常な値としています。

端末名,内線番号,端末パスワード,通知番号,端末種別,メモ
*必須項目,必須項目（1000～3999で指定）,パスワードポリシー参照,任意項目（ハイフン抜きで入力）,必須項目,任意項目
端末1,1001,********,,BIZTELソフトフォン,
端末2,2000,********,,BIZTELソフトフォン(,

エラーメッセージは「エラーとなった行,エラーメッセージ（エラー要因）」の形式で出力されます。

line 3,指定した内線番号は既に利用されています
line 4,端末種別が正しくありません

エラーファイルに「line3」と「line4」と記載されているため、「3行目」「4行目」がエラーとなっていることが分かります。

後に続くエラーメッセージが、エラーとなった要因を示します。
出力されるエラーメッセージの詳細は、「5.3 CSV出力されるエラーメッセージ一覧」をご確認ください。

上記内容をもとに、CSVファイルの入力内容を修正します。

line3 （3行目）のエラー修正箇所

■誤
端末1,1001,********,,BIZTELソフトフォン,

■正
端末1,1000,********,,BIZTELソフトフォン,

管理画面line3（3行目）で入力した内線番号「1001」が、既に管理画面に登録されている状態です。
管理画面上に登録のない内線番号に修正することで、エラーが解消します。

line4 （4行目）のエラー詳細

■誤
端末2,2000,********,,BIZTELソフトフォン(,

■正
端末2,2000,********,,BIZTELソフトフォン,

line4（4行目）の端末種別に、余分な文字が含まれています。
正しい文字列に修正することでエラーが解消します。

最終的にファイルを以下の内容に修正し、再アップロードを行います。

端末名,内線番号,端末パスワード,通知番号,端末種別,メモ
*必須項目,必須項目（1000～3999で指定）,パスワードポリシー参照,任意項目（ハイフン抜きで入力）,必須項目,任意項目
端末1,1000,********,,BIZTELソフトフォン, ← 3行目「内線番号」の値を修正
端末2,2000,********,,BIZTELソフトフォン, ← 4行目「端末種別」の値を修正

5.3 CSV出力されるエラーメッセージ一覧

CSVファイルの入力内容に問題があった場合に出力されるエラーメッセージは以下のとおりです。
入力内容を修正し、再度「4. CSVファイルをアップロードする」の手順でCSVファイルをアップロードしてください。

※1行の中で複数のエラーがある場合、すべてのエラーがCSV出力されない場合があります。
その際は再アップロード後もエラー内容が記載されたCSVが出力されるため、都度修正を行ってください。

ヘッダーのみでデータがありません

データ行（3行目以降）に値がなく、テンプレートに情報が未入力の状態です。

対象が存在しません

「3.2 一括更新（・削除）用のCSVテンプレートを編集する」でCSVファイルを操作した際に「ID」カラムを誤って変更、または削除している可能性があります。
「ID」カラムの編集・削除は行わない状態でCSVファイルを作成してください。

権限がありません

「3.2 一括更新（・削除）用のCSVテンプレートを編集する」でCSVファイルを操作した際に「ID」カラムを誤って変更しています。
「ID」カラムの編集は一切行わない状態でCSVファイルを作成してください。

所属可能な上限数を超えています

電話端末を新規登録した結果、電話端末の登録上限数を超える場合に出力されます。
不要な電話端末を削除する、新規登録する電話端末を減らすなどの対応をお願いします。

電話端末の登録上限は「1.電話端末の設定」に記載の手順でご確認ください。

カラムの数がヘッダーの数より少ないです

ヘッダー行で指定されているカラム数に対し、データ行に登録されているカラムが少ない状態です。
データ行にカンマ「,」が抜けている項目がないかご確認ください。

対象のカラムが存在しません

CSVテンプレートのカラムが誤って削除されており、必要情報に不備がある状態です。
「2. CSVテンプレートをダウンロードする」の手順で再度テンプレートをダウンロードし、入力内容を修正してください。

端末名:値がありません

「端末名」カラムが入力されていません。

端末名:必須です

「端末名」カラムに半角スペースのみ入力されています。

端末名:'null'は利用できない文字です

「端末名」カラムに使用できない文字列「null」が入力されています。

内線番号:値がありません

「内線番号」カラムが入力されていません。

内線番号:引数が数値でありません: '(入力した値)'

「内線番号」カラムに半角数字以外の文字列が含まれています。

内線番号:数値の範囲が不正です

「内線番号」カラムに「1000 ～ 3999」以外の数字が入力されています。

指定した内線番号は既に利用されています

「内線番号」カラムに入力した番号と同じ内線番号が既に管理画面に登録されています。

内線番号:SIPユーザー番号は4桁にしてください

「内線番号」カラムに4桁ではない数字（3桁、5桁など）が入力されています。

内線番号は更新できません

「3.2 一括更新（・削除）用のCSVテンプレートを編集する」のテンプレートに「内線番号」カラムが追加されています。

※既に管理画面に登録済の内線番号は変更できないため、「内線番号」カラムを削除してください。

端末パスワード:値がありません

「3.1 新規登録用のCSVテンプレートを編集する」において、「端末パスワード」カラムが入力されていません。

選択した端末種別はパスワードが不要です

端末パスワードが不要な電話端末に対し、パスワードが入力されています。
「端末パスワード」カラムを空欄にしてください。

※モバイル端末は弊社作業で設定・登録が必要です。
電話端末を登録するだけではご利用いただけないため、お問い合わせフォームよりご依頼、または弊社営業担当へお問い合わせください。

端末種別をモバイルから他へ変更した場合、端末パスワードは必須です

「端末パスワード」カラムに値を入力してください。

※「端末種別」をモバイルから他の端末種別に変更した場合、端末パスワードが必須となります。

端末種別をBIZTELソフトフォン（WebRTC）から他へ変更した場合、
端末パスワードは必須です

「端末パスワード」カラムに値を入力してください。

※「端末種別」をBIZTELソフトフォン（WebRTC）から他の端末種別に変更した場合、端末パスワードが必須となります。

端末パスワード:書式が正しくありません

「端末パスワード」カラムに半角英数字、半角記号以外の文字列が入力されています。

端末パスワード:パスワードはX文字以上にしてください

「端末パスワード」カラムの値が、パスワードポリシーで設定された最低桁数を満たしていません。

パスワードポリシーの詳細は「1.パスワードポリシー」をご参照ください。

端末パスワード:X文字からXX文字までにしてください

「端末パスワード」カラムの値が、パスワードポリシーで設定された桁数の上限を超過しています。

パスワードポリシーの詳細は「1.パスワードポリシー」をご参照ください。

端末種別:値がありません

「端末種別」カラムが入力されていません。

登録可能な通信暗号化端末の上限数を超えています

電話端末を新規登録した結果、音声暗号化端末の登録可能上限を超える場合に出力されます。
上限を超過しないよう、電話端末の登録数を調整してください。

音声暗号化端末の登録上限は 「システム設定」 > 「ライセンス設定」メニュー内「電話端末オプション」 > 「通信暗号化端末の上限（件）」をご確認ください。

登録可能なWebRTC端末の上限数を超えています

電話端末を新規登録した結果、WebRTC端末の登録可能上限を超える場合に出力されます。
上限を超過しないよう、電話端末の登録数を調整してください。

WebRTC端末の登録可能上限は「システム設定」>「ライセンス設定」メニュー内「電話端末オプション」 > 「WebRTC端末の上限（件）」をご確認ください。

WebRTC端末としてアカウントで利用されているため端末種別を変更できません

設定変更対象のWebRTC端末が、アカウントと紐づいている状態です。
アカウントとWebRTC端末の紐づけを解除してから、CSVファイルをアップロードしてください。

端末種別が正しくありません

「端末種別」カラムに指定可能以外の端末種別が入力されているか、余分な文字列が含まれています。

WebRTCライセンスが無効です

WebRTCライセンスが無効な状態で、「端末種別」カラムに「BIZTELソフトフォン（WebRTC）」が入力されています。

通知番号が正しくありません

「通知番号」カラムの値に半角数字以外の文字列が入力されているか、管理画面「電話番号」メニューに登録されていない電話番号が入力されています。

※「通知番号」カラムの値にはハイフンを入れないでください。
また、表計算ソフトの仕様によっては、電話番号の冒頭「0」が消える場合があります。

メモ:1文字から500文字までにしてください

「メモ」カラムの値が500文字を超過しています。

削除フラグ:半角数字「1」または空欄を指定してください

「削除フラグ」カラムに、半角数字「1」以外の値が入力されています。

※BIZTELバージョン 3.14.10 以降が対象です。

5.4 管理画面に表示されるエラーメッセージ一覧

ファイルの入力内容以外に関するエラーが発生した場合、ファイルアップロード後の管理画面にエラーが表示される場合があります。

アップロードファイルがCSVファイルではありません

CSVファイル以外のファイル形式がアップロードされています。
ファイルの内容や拡張子を確認し、正しいファイルをアップロードしてください。

CSVファイルの文字コードがSJISではありません

CSVファイルにSJIS以外の文字コードが指定されています。
文字コードをSJISに変更し、再度アップロードしてください。

SERVER REQUEST TIMEOUT

BIZTELサーバへのCSVファイルのアップロードがタイムアウト（120秒）したことを示します。
お手数ですが、再度アップロードをお試しください。

インポート可能な上限数（100件）を超えています

CSVファイルの登録内容が、一括で登録可能な上限数（100件）を超えています。
登録内容を分割し、CSVファイルを複数回に分けてアップロードしてください。

6. 注意事項

・電話端末一覧の「CSVダウンロード」からダウンロードしたCSVファイルはアップロードできません。

・電話端末の登録数が既に上限に達している場合、バージョンにより操作できる範囲が異なります。

BIZTELバージョン 3.9.0 未満：本マニュアルに記載の一括操作はすべて行えません。
BIZTELバージョン 3.9.0 以降：「新規アカウントの一括登録」は行えません。