目的 |
CSVファイルのテンプレートを使用し、アカウントの情報を一括登録・更新を行います。 |
|---|---|
対象プラン |
|
用語 |
【CSVファイル】 カンマで区切られた値を並べたテキスト形式のファイルを指します。 |
ポイント |
・本機能はBIZTELバージョン 3.7.0 以降で利用可能です。 |
目次
1. アカウントの一括操作について
管理画面「アカウント」メニューでは、CSVファイルを用いて以下の操作が可能です。
・複数のアカウントを一括で新規登録する
・既存アカウントの情報を一括で更新（修正）する
・複数のアカウントを一括で削除する ※BIZTELバージョン 3.14.10 以降
本マニュアルでは、各操作に必要なCSVファイルのダウンロード、およびアップロード手順を紹介します。
※いずれの操作においても、一括で操作できるアカウント数は最大100件です。
※本操作は、最上位アカウントでのみ操作可能です。
「最上位アカウント」とは、管理画面すべての操作権限を有するシステム管理者アカウントです。
具体的なアカウント情報は非公開のため、「ポータルサイト」または「ご利用案内」をご確認ください。
2. CSVテンプレートをダウンロードする
まずは、操作に必要なCSVファイルのテンプレートを以下の手順でダウンロードします。
手順１．管理画面に最上位アカウントでログインします。
手順２．「アカウント」 > 「アカウント」をクリックします。
手順３．「一括登録・更新」をクリックします。
手順４．以下の画面が表示されるので、用途に応じたテンプレートをクリックし、CSVファイルをダウンロードします。
| 新規登録用 | アカウントの新規登録を行うときは、こちらのテンプレートをダウンロードします。 |
| 一括更新用 |
既存アカウントの一括更新を行うときは、こちらのテンプレートをダウンロードします。 BIZTELバージョン 3.14.10以降では、こちらのテンプレートを用いてアカウントの一括削除も可能です。 |
3. CSVファイルを編集する
「2. CSVテンプレートをダウンロードする」でダウンロードしたテンプレートに、
操作対象のアカウント情報を登録します。
※CSVファイルの編集には、市販のテキストエディタや表計算ソフトなどをご利用ください。
3.1 新規登録用のCSVテンプレートを編集する
ダウンロードしたCSVファイルのヘッダ情報に以下の内容が記載されています。
ヘッダ行の記載内容に従って、下の行に必要な情報を追記します。
※ダウンロードしたCSVテンプレートのヘッダ行（1行目、2行目）は変更しないでください。
※CSVテンプレートに登録されていない設定項目はCSVファイルによる一括設定が行えません。
「1. アカウントの作成」をご参照のうえ、手動で設定を行ってください。
アカウント,アカウントパスワード,名前,メール,エージェント利用,ロール,メモ *必須項目,必須項目,必須項目,任意項目（2段階認証の場合は必須）,どちらか入力（設定する／設定しない）,いずれか入力（ユーザ／スーパバイザ／システム管理者）,任意項目
| アカウント | 新規登録するアカウントを255字以内で入力します。 |
|---|---|
| アカウントパスワード |
アカウントのパスワードを入力します。 セキュリティ対策として、必ず複雑なパスワードをご設定ください。 ※設定可能な文字種別や文字数は「パスワードポリシー」メニューの設定内容に従います。 |
| 名前 | 利用者の名前を255字以内で入力します。 |
| メール |
パスワードを忘れたときのリセット通知メールや、非同期検索完了通知などの ※「英大文字」は入力できません。 ※2段階認証が有効化されている場合は登録必須項目です。 |
| エージェント利用 |
アカウントをコールセンターのエージェントとして利用するかどうかを選択します。 ※コールセンタープランをご契約の場合のみ入力対象です。 コールセンターのエージェントとして応対する場合は「設定する」と入力します。 コールセンターのエージェントとして応対しない場合は「設定しない」と入力します。 |
| ロール |
「システム管理者」「スーパバイザ」「ユーザ」のいずれかを入力します。 ※ロールの詳細は「1.権限（ロールとリソース）の設定」をご参照ください。 |
| メモ | ご自由にご入力ください。 |
新規登録するアカウント情報を入力すると、例として以下のような入力内容になります。
赤字の箇所が追記した内容です。
アカウント,アカウントパスワード,名前,メール,エージェント利用,ロール,メモ *必須項目,必須項目,必須項目,任意項目（2段階認証の場合は必須）,どちらか入力（設定する／設定しない）,いずれか入力（ユーザ／スーパバイザ／システム管理者）,任意項目 user1,********,ユーザ1,****@******.co.jp,設定する,ユーザ,
user2,********,ユーザ2,****@******.co.jp,設定する,ユーザ,
user3,********,ユーザ3,****@******.co.jp,設定する,ユーザ,
supervisor1,********,エージェント1,****@******.co.jp,設定する,スーパバイザ,
3.2 一括更新（・削除）用のCSVテンプレートを編集する
ダウンロードしたCSVファイルには、ヘッダ情報と登録済のアカウント情報が以下のように記載されています。
※ダウンロードしたCSVテンプレートのヘッダ行（1行目、2行目）は変更しないでください。
※CSVテンプレートに登録されていない設定項目はCSVファイルによる一括設定が行えません。
「1. アカウントの作成」をご参照のうえ、手動で設定を行ってください。
ヘッダ行の記載内容に従って、修正が必要な情報を書き換えます。
修正が不要な電話端末は行ごと削除しても問題ありません。
"ID",アカウント,アカウントパスワード,名前,メール,エージェント利用,ロール,メモ,削除フラグ
*変更不可,半角英数、（-）（_）のみ可,パスワードポリシー参照,255文字以内,削除は半角ハイフン（-）入力,どちらか入力（設定する／設定しない）,どちらか入力（ユーザ／スーパバイザ）,削除は半角ハイフン（-）入力,削除対象は半角数字（1）入力
10004,supervisor1,,エージェント1,****@******.co.jp,設定する,スーパバイザ,,
10003,user3,,ユーザ3,****@******.co.jp,設定する,ユーザ,,
10002,user2,,ユーザ2,****@******.co.jp,設定する,ユーザ,,
10001,user1,,ユーザ1,****@******.co.jp,設定する,ユーザ,,
| ID | システム用の管理番号のため、何も変更を加えないでください。 |
|---|---|
| アカウント | 登録中のアカウントが表示されます。 |
| アカウントパスワード |
ダウンロード時点は、登録の値にかかわらず空欄です。 ※設定可能な文字種別や文字数は「パスワードポリシー」メニューの設定内容に従います。 |
| 名前 | アカウント利用者の名前が表示されます。 |
| メール | アカウントに紐づくメールアドレスが表示されます。 |
| エージェント利用 |
アカウントをコールセンターのエージェントとして利用するかどうかを選択します。 ※コールセンタープランをご契約の場合のみ入力対象です。 コールセンターのエージェントとして応対する場合は「設定する」と入力します。 コールセンターのエージェントとして応対しない場合は「設定しない」と入力します。 |
| ロール |
「システム管理者」「スーパバイザ」「ユーザ」のいずれかを入力します。 ※ロールの詳細は「1.権限（ロールとリソース）の設定」をご参照ください。 ※既に「システム管理者」で登録されているアカウントは また、既に「スーパバイザ」および「ユーザ」で登録されているアカウントは |
| メモ | メモの登録内容が表示されます。 |
| 削除フラグ |
対象のアカウントを削除する場合のみ「1」と入力します。 ※BIZTELバージョン 3.14.10 以降が対象です。 |
修正・削除を行う場合、例として以下のような入力内容になります。
赤字の部分は、ダウンロードした内容例から修正を加えた箇所です。
※入力例の値をコピーしてお客様環境で登録してもエラーとなりますので、参考情報としてご確認ください。
"ID",アカウント,アカウントパスワード,名前,メール,エージェント利用,ロール,メモ *変更不可,半角英数、（-）（_）のみ可,パスワードポリシー参照,255文字以内,削除は半角ハイフン（-）入力,どちらか入力（設定する／設定しない）,どちらか入力（ユーザ／スーパバイザ）,削除は半角ハイフン（-）入力 10004,supervisor1,,スーパバイザ1,****@******.co.jp,設定する,スーパバイザ,,
10003,user3,,ユーザ3,****@******.co.jp,設定しない,ユーザ,,10002,user2,,ユーザ2,****@******.co.jp,設定する,ユーザ,,← ★アカウント修正が不要な場合は1行すべて削除
10001,user1,,ユーザ1,****@******.co.jp,設定する,ユーザ,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 出力結果に対する修正を行う場合の例
「5.1 エラーの内容を確認する」で確認したエラーに基づいて、CSVファイルを修正する場合の例を紹介します。
例）新規登録のため、以下の内容でCSVファイルをアップロードしたらエラーが出力された場合
※マニュアル上、パスワードは伏字としていますが、実際にアップロードする値は正常な値としています。
アカウント,アカウントパスワード,名前,メール,エージェント利用,ロール,メモ *必須項目,必須項目,必須項目,任意項目（2段階認証の場合は必須）,どちらか入力（設定する／設定しない）,いずれか入力（ユーザ／スーパバイザ／システム管理者）,任意項目 super visor1,********,BIZTEL 太郎,,設定する,スーパバイザ, operator1,********,BIZTEL 花子,,設定する_,ユーザ,
エラーメッセージは「エラーとなった行,エラーメッセージ（エラー要因）」の形式で出力されます。
CSVファイルのアップロード後、以下のエラーファイルが出力されたとします。
line 3,アカウント:半角英字と数字または記号（-ハイフン _アンダースコア）の組み合わせ以外を指定しないでください line 4,「設定する／設定しない」どちらかの文字列を入力してください
エラーファイルに「line3」と「line4」と記載されているため、「3行目」「4行目」がエラーとなっていることが分かります。
後に続くエラーメッセージが、エラーとなった要因を示します。
出力されるエラーメッセージの詳細は、「5.3 CSV出力されるエラーメッセージ一覧」をご確認ください。
上記内容をもとに、CSVファイルの入力内容を修正します。
line3 （3行目）のエラー修正箇所
■誤
super visor1,********,BIZTEL 太郎,,設定する,スーパバイザ,
■正
supervisor1,********,BIZTEL 太郎,,設定する,スーパバイザ,
line3（3行目）は、アカウントに利用できない半角スペースが含まれています。
半角スペースを削除するか、ハイフンやアンダースコアに修正することでエラーが解消します。
line4 （4行目）のエラー修正箇所
■誤
operator1,********,BIZTEL 花子,,設定する_,ユーザ,
■正
operator1,********,BIZTEL 花子,,設定する,ユーザ,
line4（4行目）は、エージェント利用を「設定する」「設定しない」のいずれかで設定します。
利用できない文字列が含まれる場合もエラーとなるため、正しい文字列に修正します。
最終的にファイルを以下の内容に修正し、再アップロードを行います。
アカウント,アカウントパスワード,名前,メール,エージェント利用,ロール,メモ *必須項目,必須項目,必須項目,任意項目（2段階認証の場合は必須）,どちらか入力（設定する／設定しない）,いずれか入力（ユーザ／スーパバイザ／システム管理者）,任意項目 supervisor1,********,BIZTEL 太郎,,設定する,スーパバイザ, ← 3行目「アカウント」の値を修正 operator1,********,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」が入力されています。
パスワード:値がありません
「3.1 新規登録用のCSVテンプレートを編集する」において、「アカウントパスワード」カラムが入力されていません。
パスワード:入力されたパスワードは、パスワードポリシーの要件に合っていません。
半角英小文字・半角数字 は必須です。
「アカウントパスワード」カラムの値が、パスワードポリシーで設定された文字種別の条件を満たしていません。
パスワードポリシーの詳細は「1.パスワードポリシー」をご参照ください。
パスワード:入力されたパスワードは、パスワードポリシーの要件に合っていません。
X文字以上で指定してください。
「アカウントパスワード」カラムの値が、パスワードポリシーで設定された文字数の条件を満たしていません。
パスワードポリシーの詳細は「1.パスワードポリシー」をご参照ください。
過去に使用されたパスワードが入力されました。別のパスワードを設定してください。
パスワードポリシーにおいて「過去パスワードの利用制限数（回）」が設定されている場合において、制限回数内に使用された過去のパスワードと同一の値が「アカウントパスワード」カラムに入力されています。
パスワードポリシーの詳細は「1.パスワードポリシー」をご参照ください。
名前:値がありません
「名前」カラムが入力されていません。
名前:必須です
「名前」カラムに半角スペースのみ入力されています。
名前:'null'は利用できない文字です
「名前」カラムに使用できない文字列「null」が入力されています。
名前:1文字から255文字までにしてください
「名前」カラムが256文字以上で入力されています。
メールアドレス:メールアドレス形式で指定してください
「メールアドレス」カラムに入力した値がメールアドレスの形式になっていません。
指定したメールは既に利用されています
「メールアドレス」カラムに入力した値が既存のアカウントにメールアドレスとして登録されています。
2段階認証が有効になっているため、メールアドレスは削除できません
2段階認証が有効なアカウントの「メールアドレス」カラムが空欄です。
2段階認証の詳細は「3.2段階認証」をご参照ください。
パスワード有効日数が設定されているため、
メールアドレスを削除することはできません。
パスワードポリシーで「パスワードの有効期限」が設定されているアカウントの「メールアドレス」カラムが空欄です。
パスワードポリシーの詳細は「1.パスワードポリシー」をご参照ください。
ロール：値がありません
「ロール」カラムが入力されていません。
権限の文字列が正しくありません
「3.2 一括更新（・削除）用のCSVテンプレートを編集する」において「ロール」カラムの値に誤りがあるか、変更できないロールが入力されています。
※以下の操作は管理画面操作でも行えないため、アカウントの新規作成を行ってください。
・「システム管理者」アカウントのロールを変更する
・「ユーザ」または「スーパバイザ」アカウントのロールを「システム管理者」に変更する
アカウントのロール変更に関する詳細は「2.権限（ロールとリソース）の設定」をご参照ください。
「設定する／設定しない」どちらかの文字列を入力してください
「ユーザ利用」カラムに「設定する」「設定しない」以外の文字列が入力されているか、余分な文字列が含まれています。
通話中のエージェントにて「エージェント利用」を無効化することはできません
「エージェント利用」カラムの値を変更しようとしているアカウントが通話中の状態です。
通話が終了してから、再度CSVファイルをアップロードしてください。
ステータスがログオフ以外のため、エージェント機能を無効にすることはできません
「エージェント利用」カラムの値を変更しようとしているアカウントが「ログオフ」以外のステータスです。
ステータスをログオフに変更後、再度CSVファイルをアップロードしてください。
再発信リストが存在しているため、エージェント機能を無効にすることはできません
「エージェント利用」カラムの設定を変更しようとしているアカウントにおいて、
アウトバウンド機能での再発信予定があります。
再発信するアカウントを変更するか、発信予定を消化してから、再度CSVファイルをアップロードしてください。
コールジョブを開始しているため、エージェント機能を無効にすることはできません
「エージェント利用」カラムの設定を変更しようとしているアカウントが、
アウトバウンド機能のコールジョブを実行中です。
コールジョブを停止するか、業務終了後に再度CSVファイルをアップロードしてください。
メモ: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 以降：「新規アカウントの一括登録」は行えません。