- このマニュアルについて
- Bulk Administration Tool （BAT）の概要
- BAT アプリケーションのイン ストール
- 電話機、 および IP テレフォニー デバイスの一括処理
- ユーザの一括処理
- Cisco IP Manager Assistant の使用方法
- ユーザ デバイス プロファイル の一括処理
- ゲートウェイとポートの一括処 理
- エクスポート ユーティリティ の使用方法
- レポートの生成
- Tool for Auto-Registered Phones Support の使用方法
- BAT および TAPS のトラブル シューティング
- テキストベースの CSV ファイ ル
- 索引
Bulk Administration Tool ユーザ ガイド Release 5.0(1)
偏向のない言語
この製品のマニュアルセットは、偏向のない言語を使用するように配慮されています。このマニュアルセットでの偏向のない言語とは、年齢、障害、性別、人種的アイデンティティ、民族的アイデンティティ、性的指向、社会経済的地位、およびインターセクショナリティに基づく差別を意味しない言語として定義されています。製品ソフトウェアのユーザーインターフェイスにハードコードされている言語、RFP のドキュメントに基づいて使用されている言語、または参照されているサードパーティ製品で使用されている言語によりドキュメントに例外が存在する場合があります。シスコのインクルーシブランゲージに対する取り組みの詳細は、こちらをご覧ください。
翻訳について
このドキュメントは、米国シスコ発行ドキュメントの参考和訳です。リンク情報につきましては、日本語版掲載時点で、英語版にアップデートがあり、リンク先のページが移動/変更されている場合がありますことをご了承ください。あくまでも参考和訳となりますので、正式な内容については米国サイトのドキュメントを参照ください。
- Updated:
- 2017年6月9日
章のタイトル： エクスポート ユーティリティ の使用方法
エクスポート ユーティリティの使用方法
システム管理者には、部門の異動、再編成、または機器のアップグレードのために、別の Cisco CallManager データベースに大量の電話機レコードを移動する機能が必要です。BAT のエクスポート ユーティリティには、大量の電話機、ユーザ、およびユーザ デバイス プロファイルの各レコードを Cisco CallManager データベースからデータ ファイルに CSV 形式でエクスポートする機能があります。さらに、そのレコードを別の Cisco CallManager データベースにインポートできます。テキスト エディタで CSV データ ファイルを編集できますが、このファイルは非常に複雑なので注意して編集する必要があります。
BAT で電話機レコードを Cisco CallManager データベースからエクスポートする場合には、電話機のモデルとモデルの回線の数がデータを構成する基礎となります。BAT データ ファイルには、1 つの電話機モデルのレコードだけが必要であることに注意してください。Export Specific Details オプションを使用する場合、BAT は 1 回線の電話機モデルの別個のデータ ファイルを生成し、2 回線の同じ電話機モデルについては別のデータ入力ファイルを生成します。
管理者をエクスポート機能によって支援するために、Device Summary Report には、Cisco CallManager データベース内のすべての電話機モデルと設定済み回線のスナップショット ビューが用意されています。
•
「Cisco CallManager サーバから別の Cisco CallManager サーバへのレコードの移動」
Cisco CallManager サーバから別の Cisco CallManager サーバへのレコードの移動
エクスポート ユーティリティを使用すると、複数の Cisco CallManager サーバ上のレコードを 1 台の Cisco CallManager サーバにマージできます。Cisco
CallManager サーバから別の Cisco CallManager サーバにレコードを移動する手順は、次のとおりです。エクスポートするのは、移動の対象となるレコードだけにしてください。次の手順を実行します。
3. 「ユーザ デバイス プロファイル レコードのエクスポート」
4. （オプション）テキスト エディタでの CSV ファイルの編集レコード形式は、そのファイル形式に指定された形式に従っている必要があります。たとえば、電話機レコードは電話機ファイル形式に従っている必要があります。
5. CSV ファイルをパブリッシャ データベース サーバ上の適切なフォルダにコピーします。
– 電話機ファイルを C:\BATFiles\Phones\ Insert フォルダに
– ユーザ ファイルを C:\BATFiles\Users\Insert Users フォルダに
– ユーザ デバイス プロファイル ファイルを C:\BATFiles\User Device Profiles フォルダに
6. ユーザ レコードを挿入します。エクスポートされなかった次の属性を設定します。
– Enable authentication proxy rights
– Enable CTI Application usage
– Calling Party Display modification
8. ユーザ デバイス プロファイル レコードを挿入します。
9. ログ ファイルでエラーをチェックします。詳細については、「エクスポート ログ ファイルの表示」を参照してください。
• Cisco CallManager への電話機の挿入（P.3-53）
電話機エクスポートの使用方法
電話機レコードをエクスポートする場合、次の 2 つのファイル形式オプションから選択できます。
All Phone Details ：複数パーティションやコール検索スペースなどの、回線設定の異なる電話機の場合。
Default Phone ファイル形式を選択した場合は、定義済みクエリーを使用してレコードをエクスポートできます。定義済みクエリーを使用してエクスポートする場合、エクスポートできる電話機レコードは、一定数の回線を持つ特定の電話機タイプに関するものだけです。たとえば、1 回線を持つ Cisco IP Phone Model 7960 のレコードをいくつかエクスポートし、2 回線を持つ Cisco IP Phone Model 7960 のレコードをいくつかエクスポートする場合は、異なる 2 つのクエリーを使用する必要があります。結果として得られる CSV ファイルも、2 つの別個のファイルになります。
表 8-1 に、Default Phone ファイル形式を選択した場合にエクスポートされるフィールドを示します。
|
|
|
|---|---|
Directory Number、Display、Line Text Label、Forward Busy、Forward No Answer、Call Pickup Group |
|
All Phone Details オプションを使用して電話機レコードをエクスポートする場合は、特定モデルの電話機の電話機レコードをエクスポートすることになります。すべてのデバイス フィールド情報、各種の回線属性、および電話機に関連付けられているサービスがエクスポートされます。クエリーを使用してレコード数を制限することはできません。
表 8-2 に、All Phone Details ファイル形式を選択した場合にエクスポートされるフィールドを示します。
（注） All Phone Details ファイル形式を使用してエクスポートする場合は、MAC アドレスではなくデバイス名が保存されます。
• 「複数ユーザを持つ電話機レコードのエクスポートおよびインポート」
電話機レコードのエクスポート
Cisco CallManager から電話機レコードをエクスポートする手順は、次のとおりです。
ステップ 1 Configure > Phones の順に選択します。Phones Options ウィンドウが表示されます。
ステップ 2 Export Phones オプション ボタンをクリックして、 Next をクリックします。Export Phones ウィンドウが表示されます。
ステップ 3 Export file name フィールドに、ファイル名を入力します。
ステップ 4 File Format Name フィールドで、Default Phone ファイル形式または All Phone
Details ファイル形式を選択します。選択項目によりエクスポート オプションが決定され、該当するエクスポート オプションのオプション ボタンが設定されます。
• All Phone Details ファイル形式を選択した場合は、 All Details オプション ボタンの下にある Model リストボックスで、デバイスのタイプまたは特定のモデルを選択します。この形式でエクスポートされるフィールドの一覧は、表 8-1 を参照してください。ステップ 6 にスキップします。
• Default Phone ファイル形式を選択した場合は、 Specific Details オプション ボタンの下にある Model リストボックスで、デバイスのタイプまたは特定のモデルを選択します。Default Phone 形式でエクスポートされるフィールドの一覧は、表 8-2 を参照してください。
ステップ 5 エクスポートする電話機セットを選択するとエクスポート ファイルをカスタマイズできますが、電話機の詳細は設定できません。次のフィールドから値を選択します。
b. 最初のドロップダウン リストボックスで、クエリー対象のフィールド（たとえば、Device Name、Location）を選択します。
c. 2 番目のドロップダウン リストボックスで、検索基準（たとえば、begins with（～で始まる）、contains（を含む）、is empty（空白））を選択します。
d. 検索フィールドまたはリストボックスで、検索する値（たとえば、デバイス名）を選択するか、入力します。
e. 定義したフィルタをクエリーに追加するには、 Add To Query をクリックします。複数のフィルタを追加するには、 AND または OR をクリックします。クエリーをさらに定義するには、サブステップ b. ～ d. を繰り返します。
f. 誤りがあった場合は、 Clear Query ボタンをクリックして、そのクエリーを削除します。その後、サブステップ b. からやり直します。
g. エクスポート対象のレコードが正しいことを確認するには、 View Query Result をクリックします。
ステップ 6 レコードをエクスポートするには、ページの最上部左側の Export をクリックします。
ステップ 7 Cisco CallManager データベースからレコードをエクスポートするために必要な時間を通知するメッセージが表示されます。トランザクションを取り消すか、または OK をクリックして処理を続行することができます。
トランザクションが完了すると、Export Completed ステータスまたは Export Failed ステータスが表示されます。エクスポートに失敗したレコードがある場合は、Export Failed メッセージが表示されます。
ステップ 8 BAT で生成されたログ ファイルを表示するには、 View Latest Log File リンクをクリックします。ログ ファイルには、エクスポートされた電話機レコードの数、エクスポートに失敗した電話機レコードの数（エラー コード含む）、作成されたエクスポート ファイルの数、およびファイルの場所が示されます。
View/Download Exported File リンクを選択すると、エクスポートされたファイルを表示またはダウンロードすることもできます。このリンクは、複数のエクスポート ファイルが作成された場合は表示されません。
エクスポートされた電話機レコードの検索
エクスポートされたファイルは、パブリッシャ サーバ上の
C:\BATFiles\Export\Phones に保存されます。
電話機の挿入時に、このファイル名を確認することで、回線の再設定が容易になります。Specific Details オプションを使用してファイルをエクスポートすると、エクスポート ファイルの名前に数字のサフィックス _n が付加されます。このサフィックスは、電話機に設定された回線の数を示しています。たとえば、エクスポート ファイルの名前を「sales」と入力し、回線 1 と回線 3 が設定された 2 回線用の電話機がある場合、ファイルの名前は sales_1_3.txt になります。
ダミーの MAC アドレスで電話機をエクスポートすると、エクスポート ユーティリティによりエクスポート ファイル名に「bat」と数字のサフィックス _n が付加されます。たとえば、ダミー MAC アドレスの電話機のエクスポート ファイル名の名前を「newsales」と入力した場合、ファイル名は newsales_bat_1.txt となります。
複数ユーザを持つ電話機レコードのエクスポートおよびインポート
電話機を制御する複数のユーザを持つ電話機レコードをエクスポートすると、エクスポート ユーティリティにより各ユーザについて一意の電話機レコードが生成されます。電話機情報は同じままですが、各レコードのユーザ ID は異なります。
複数ユーザを持つ電話機が含まれたエクスポート ファイルをインポートすると、最初の電話機レコードは関連付けられたユーザで挿入されます。後続の電話機レコードの挿入は失敗することに注意してください。ただし、BAT はすべてのレコードを挿入しようと試み、電話機に対するユーザ アソシエーションを受け入れます。
インポート トランザクションのログ ファイルには、電話機と関連付けられた最初のユーザ以外のすべてのユーザの電話機の挿入が失敗したことが示されます。
ユーザ エクスポートの使用方法
BAT を使用してユーザ レコードをエクスポートすると、エクスポート ユーティリティによりディレクトリ内の組織階層に基づいてユーザがソートされます。エクスポート ユーティリティはマネージャのユーザ ID フィールドに入力した値を調べて、同じ報告レベルのユーザを同じファイルに記録します。エクスポート ユーティリティはサフィックス「_user」または「_MgrLevel#」（# は 1 ～ 20 の数字）を付加してファイル名を変更します。
マネージャのユーザ ID は、ユーザ レコードの Manager User ID フィールドで使用される前に、ディレクトリに存在している必要があります。ファイルは、マネージャ レベルを示す数字サフィックスに基づいて、降順で挿入してください。user サフィックスを持つファイルは最後に挿入します。この方法によって、マネージャのユーザ レコードが、ユーザ レコードで使用される前に格納されます。
Active Directory ユーザの場合、パスワードはエクスポートされません。PIN は、クリアテキストでエクスポートされます。レコードをインポートした後に、Active Directory を使用してユーザのパスワードを設定する必要があります。
エクスポート ユーティリティでエクスポートされるのは、ユーザに関連付けられているデフォルト ユーザ デバイス プロファイルだけです。そのユーザ用の他のユーザ デバイス プロファイルは、Cisco CallManager Administrator を使用して別途挿入する必要があります。
設定に応じてファイル名には _t（有効）または _f（無効）というサフィックスが付加されます。ファイル名に含まれているサフィックス フラグは、認証プロキシ権限、CTI アプリケーションの使用、コール パーク取得、および発信側番号の変更という順序で指定されています。
たとえば、エクスポート ユーティリティを使用して Test.txt というエクスポート ファイルを作成するとします。Cisco CallManager データベースには、マネージャ MarieA を持つユーザ TomT が保持されています。MarieA のマネージャは JamesM です。TomT は、認証プロキシ権限が有効、CTI アプリケーションの使用とコール パーク取得が無効、および発信側番号の変更が有効になっており、MarieA と JamesM は、認証プロキシ権限と CTI アプリケーションの使用が有効、コール パーク取得が無効、および発信側番号の変更が有効になっているとします。この場合にエクスポート ユーティリティを使用すると、これらのユーザの情報は、それぞれ別個の 3 つのファイルに保存されます。TomT は CSV ファイル
Test_user_t_f_f_t.txt に、MarieA は CSV ファイル Test_MgrLevel1_t_t_f_t.txt に、JamesM は CSV ファイル Test_MgrLevel2_t_t_f_t.txt にそれぞれ保存されます。 表 8-3 にこの例を示します。
|
|
|
|||||
|---|---|---|---|---|---|---|
|
|
|
|
|
パーク取得 |
|
|
ユーザを挿入するときは、サフィックスを確認することで、認証プロキシ権限、CTI アプリケーションの使用、コール パーク取得、および発信側番号の変更が適切に設定されたファイルを選択できます。
ユーザ レコードのエクスポート
ユーザ レコードをエクスポートする場合、ユーザ レコードが Cisco CallManager 3.1 以前に作成されたために、そのユーザの PIN がブランクの場合があります。この場合は、デフォルトの PIN を指定してから、ユーザ レコードを BAT ユーザ インターフェイスに再挿入する必要があります。
ユーザ レコードを Cisco CallManager からエクスポートする手順は、次のとおりです。
ステップ 1 Configure > Users の順に選択します。User Options ウィンドウが表示されます。
ステップ 2 Export Users オプション ボタンをクリックして、 Next をクリックします。
ステップ 3 Export file name フィールドに、エクスポート ファイルのファイル名を入力します。
ステップ 4 File Format Name フィールドで、ファイル形式を選択します。デフォルトでは、Default Users が指定されています。
ステップ 5 最初のドロップダウン リストボックスで、クエリー対象のフィールド（たとえば、User ID、Department、First Name、Last Name）を選択します。
ステップ 6 2 番目のドロップダウン リストボックスで、contains または exactly を選択します。
ステップ 7 3 番目のボックス（検索フィールドまたはリストボックス）で、検索する値（たとえば、特定の名前またはユーザ ID）を入力します。
（注） ユーザを複数の部署から選択する場合は、このフィールドに複数の部署を入力します。たとえば、部署 12 と部署 34 からユーザを選択するには、3 番目のボックスに 12, 34 と入力します。操作を 2 回繰り返す必要はありません。
ステップ 8 Add To Query ボタンをクリックして、定義したフィルタをクエリーに追加します。
誤りがあった場合は、 Clear Query ボタンをクリックして、そのクエリーを削除します。その後、ステップ 5 からやり直します。
ステップ 9 View Query Result をクリックして、エクスポート対象のレコードを表示します。
ステップ 10 Export をクリックして、選択したユーザ レコードをエクスポートします。
Cisco CallManager データベースからレコードをエクスポートするために必要な時間を通知するメッセージが表示されます。トランザクションを取り消すか、または OK をクリックして処理を続行することができます。
トランザクションが完了すると、Export Completed ステータスまたは Export Failed ステータスが表示されます。エクスポートに失敗したレコードがある場合は、Export Failed メッセージが表示されます。
ステップ 11 BAT で生成されたログ ファイルを表示するには、 View Latest Log File リンクをクリックします。ログ ファイルには、エクスポートされた電話機レコードの数、エクスポートに失敗した電話機レコードの数（エラー コード含む）、作成されたエクスポート ファイルの数、およびファイルの場所が示されます。
ステップ 12 View/Download Exported File リンクを選択することで、エクスポートされたファイルを表示またはダウンロードできます。このリンクは、複数のエクスポート ファイルが作成された場合は表示されません。
エクスポートされたファイルは、パブリッシャ サーバ上の C:\BATFiles\Export\Users に保存されます。
ユーザ デバイス プロファイル エクスポートの使用方法
ユーザ デバイス プロファイル レコードをエクスポートする場合、次の 2 つのファイル形式名から選択できます。
• All User Device Profile Details
All User Device Profile Details 形式
複数パーティションやコール検索スペースなどの、回線設定の異なる電話機の場合、 All User Device Profile Details 形式を使用します。
表 8-4 に、All User Device Profile Details ファイル形式を選択した場合にエクスポートされるフィールドを示します。
Default User Device Profile 形式
ユーザ デバイス プロファイルに関連付けられた詳細の限定されたセットをエクスポートするには、Default User Device Profile 形式を使用します。特定のクエリー オプションを選択してエクスポート ファイルをカスタマイズできます。
表 8-5 に、Default User Device Profile 形式を選択した場合にエクスポートされるフィールドを示します。
|
|
|
|---|---|
Directory Number、Display、Line Text Label、Forward Busy、Forward No Answer、Call Pickup Group |
|
ユーザ デバイス プロファイル レコードのエクスポート
ユーザ デバイス プロファイルを Cisco CallManager からエクスポートする手順は、次のとおりです。
ステップ 1 BAT から、 Configure> User Device Profile の順に選択します。User Device Profile Options ウィンドウが表示されます。
ステップ 2 Export User Device Profiles を選択します。Export User Device Profiles ウィンドウが表示されます。
ステップ 3 Export File Name フィールドに、使用するファイル名を入力します。
ステップ 4 File Format Name フィールドで、次のいずれかのオプションを選択します。選択したファイル形式によって、該当するエクスポート オプションのオプション ボタンが設定されます。
All User Device Profiles Details ：ユーザ デバイス プロファイルに関連付けられたすべての回線属性、サービス、およびユーザ ID をエクスポートするには、次のフィールドに入力する必要があります。
• All Details オプション ボタンの Model リスト ボックスで、デバイス タイプまたは特定のモデルを選択します。
• 回線の数を指定して Add to Query をクリックします。
• ステップ 5 にスキップします。
Default User Device Profile ：ユーザ デバイス プロファイルに関連付けられた詳細の限定されたセットをエクスポートするには、このオプションを使用します。
エクスポート ファイルをカスタマイズするには、次の任意の詳細オプションを設定するか、または None を選択します。
• 最初のドロップダウン リストボックスで、いずれかのクエリー オプション（Device Name、Description、または Directory Number）を選択します。
• 2 番目のドロップダウン リストボックスで、いずれかのクエリー条件
（contains（を含む）、is exactly（完全一致）、not equal to（不一致）、begins with（～で始まる）、ends with（後方）、is empty（空白）、または is not empty（空白以外））を選択します。
• 3 番目のボックス（検索フィールドまたはリストボックス）で、検索する値（たとえば、特定の電話番号）を入力します。
• Add To Query ボタンをクリックして、定義したフィルタをクエリーに追加します。
• View Query Result をクリックして、エクスポート対象のレコードを表示します。
• 誤りがあった場合は、 Clear Query ボタンをクリックして、そのクエリーを削除して、やり直します。
ステップ 5 Export Options の選択を行った後、ウィンドウの一番上の Export をクリックして、選択したユーザ デバイス プロファイル レコードをエクスポートします。
Cisco CallManager データベースにレコードをエクスポートするために必要な時間を通知するメッセージが表示されます。
ステップ 6 トランザクションを取り消すか、または OK をクリックして処理を続行することができます。
Export ボタンの上の Status 領域に Export Completed または Export Failed が表示されます。
ステップ 7 エクスポートされたユーザ デバイス プロファイル レコード数およびエクスポートに失敗したユーザ デバイス プロファイル レコード数を示すログ ファイルを表示するには、 View Latest Log File リンクをクリックします。
ステップ 8 エクスポートされたファイルを表示またはダウンロードするには、
View/Download Exported File リンクを選択します。
エクスポートされたファイルは、パブリッシャ サーバ上の C:\BatFiles\Export\User Device Profiles に保存されます。
エクスポート ログ ファイルの表示
BAT は、エクスポート トランザクションごとにログ ファイルを生成し、パブリッシャ データベース サーバ上の C:\CiscoWebs\BAT\LogFiles\Export に保存します。
BAT インターフェイス上で View Latest Log File リンクをクリックすると、エクスポート トランザクションの要約と、障害の詳細が表示されます。
エクスポート トランザクションのログ ファイルを表示するには、エクスポート ウィンドウで View Latest Log File をクリックするか、次のディレクトリに進みます。
C:\CiscoWebs\BAT\LogFiles\Export
<レコード エクスポートの種類>_<選択したファイル名>#タイムスタンプ
ログ ファイル名のタイムスタンプ形式は、mmddyyyyhhmmss です。
フィードバック