Bulk Administration Tool ユーザ ガイド Release 5.1(1)

BAT 設定プロセス

BAT は、複数のステップから成るプロセスを使用して、バルク設定トランザクションを準備します。BAT が提供するウィザードインターフェイスを使用して、設定タスクを順に処理することができます。BAT プロセスには、次のタスクが含まれています。

1. データ入力用のテンプレートを設定する。

2. CSV データファイルの形式を定義する。

3. バルクトランザクションにおける各デバイス用データを収集する。

4. Cisco CallManager データベースを使用してデータ入力ファイルを確認する。

5. Cisco CallManager データベースにデバイスを挿入する。

BAT ウィザードの使用方法

BAT ウィザードは、すべての BAT タスクについて、ステップごとに処理します。BAT を起動すると、メインウィンドウが現れ、上部に次のメニューオプションが表示されます。

• Configure

• Applications

• Help

Configure メニューでは、次のデバイスオプションまたは設定オプションのいずれかを選択して、ウィザードウィンドウにアクセスします。

• Phones

• Users

• Manager/Assistants

• User Device Profiles

• Gateways

• Forced Authorization Codes

• Client Matter Codes

• TAPS（インストールされている場合のみ）

デバイスオプションまたは設定オプションを選択すると、ウィザードには、そのオプションに特有の設定タスクのリストが表示されます。たとえば、Phones を選択すると、次のタスクのリストが表示されます。

• Insert Phones：新しい電話機を追加します。

• Update Phones：既存の電話機を見つけて修正します。

• Delete Phones：電話機を見つけて削除します。

• Export Phones：特定の電話機レコードまたはすべての電話機レコードを見つけてエクスポートします。

• Update Lines：既存の電話機の回線を見つけて修正します。

• Add Lines：既存の電話機に新しい回線を追加します。

• Reset/Restart Phones：電話機を見つけてリセットまたは再起動します。

• Insert Phones with Users：新しい電話機およびユーザを追加します。

• Generate Phone Reports：電話機に関するカスタマイズされたレポートを生成します。

• CAPF Configuration：既存の CAPF 設定を検索し、修正または削除します。

設定タスクを選択すると、ウィザードには、そのタスクに特有のステップのリストが表示されます。たとえば、Insert Phones タスクを選択した場合、次のステップが表示されます。

ステップ 1：既存の電話機テンプレートを追加、表示、または修正します。

ステップ 2：CSV データファイルを作成します。

ステップ 3：電話機レコードを確認します。

ステップ 4：電話機を挿入します。

タスクリストからステップを選択すると、設定ウィンドウ、たとえば Phone Template Configuration ウィンドウが表示されます。設定ウィンドウには、テンプレートを定義するための入力フィールドがあります。

関連項目

BAT テンプレートの使用方法

BAT 設定プロセスの最初のタスクでは、設定するデバイス用のテンプレートを設定します。追加または修正する電話機またはデバイスのタイプを指定し、次に、バルクトランザクション内のすべての電話機またはデバイスに共通の機能を記載した BAT テンプレートを作成します。

BAT テンプレートを作成できるデバイスオプションのタイプは、次のとおりです。

• 電話機：すべての Cisco IP Phone モデル、Cisco ATA 186、Cisco VGC 電話機、CTI ポート、および H.323 クライアント

• ゲートウェイ：Cisco VG200、および Cisco Catalyst 6000 FXS アナログインターフェイスモジュール用のポート

• ユーザデバイスプロファイル：Cisco IP Phone 7900 シリーズおよび Cisco SoftPhone

バルクトランザクションにおいてすべてのデバイスに共通のテンプレートフィールドに値を指定して、BAT テンプレートを定義します。BAT テンプレートフィールドに必要な値は、Cisco CallManager Administration でデバイスを追加するときに入力する値とほぼ同じです。

BAT テンプレートを作成する前に、デバイスプール、ロケーション、コール検索スペース、ボタンテンプレート、ソフトキーテンプレートなどの設定値が、Cisco CallManager Administration に設定されていることを確認してください。
BAT を使用して、Cisco CallManager Administration の新しい設定やボタンテンプレートを作成することはできません。

BAT テンプレートを作成したら、名前を付けて保存します。設定プロセスの後の部分で、このテンプレート名に CSV データファイルを関連付けます。テンプレートはシステムに保存されるので、今後のバルクトランザクションでこれらのテンプレートを再利用できます。たとえば、特定のボタンテンプレートとコール検索スペースを使用して Cisco IP Phone 7960 用テンプレートを設定した後で、違うボタンテンプレートを使用してエクステンションモビリティ機能が有効になっている別の Cisco IP Phone 7960 用テンプレートを設定できます。同じ設定を持つ多数の電話機を追加する必要があるときに、既存の BAT テンプレートを再利用できます。

マスター電話機テンプレート

複数の回線を持つ電話機のグループを追加する場合、複数の回線を備え、特定の電話機モデルに広く使用される値を持つマスター電話機テンプレートを作成します。マスターテンプレートを使用すると、マスター電話機テンプレートの回線数を上限として、異なる数の回線を持つ複数の電話機を追加できます。たとえば、8 回線を持つ Cisco IP Phone 7960 用のマスター電話機テンプレートを作成するとします。このテンプレートを使用すると、1 回線または 2 回線から最大で 8 回線を持つ電話機を追加できます。

関連項目

• 「新しいデバイスの追加用の CSV データファイル」

CSV データファイルの処理

CSV データファイルには、各デバイスに固有な設定や情報、たとえば、電話番号、MAC アドレス、および説明が含まれています。CSV データファイル内のすべての電話機とデバイスが、同じ電話機モデルとデバイスモデルであることと、BAT テンプレートと一致していることを確認してください。CSV データファイルには、BAT テンプレートの値の一部を複写できます。CSV データファイル内で値を設定すると、BAT テンプレートで設定されている値は上書きされます。この上書き機能によって、特殊な設定が可能になります。

テンプレート値の上書きの例

バルクトランザクション内の大部分の電話機を、ボイスメッセージシステムにリダイレクトする場合、Call Forward Busy（Internal/External）（CFB）フィールドおよび Call Forward No Answer（Internal/External）（CFNA）フィールドにボイスメッセージ番号を設定します。しかし、バルクトランザクション内の一部の電話機を、ボイスメッセージシステムではなく秘書にリダイレクトする場合は、CSV データファイル内の CFB フィールドおよび CFNA フィールドに、秘書の電話番号を指定できます。このように設定することによって、大部分の電話機は、BAT 電話機テンプレートから CFB および CFNA の値を使用しますが、一部の電話機は、CSV データファイルに指定されている秘書の電話番号を使用します。

電話機用の CSV データファイルには、複数の電話番号が含まれる場合があります。CSV データファイルに入力する電話番号の数は、BAT 電話機テンプレートで設定されている回線数を超えることはできません。回線数が設定値を超えると、エラーが発生します。

次のトピックでは、CSV データファイルのタイプについて説明します。

• 「既存デバイスの更新用の CSV データファイル」

• 「CSV データファイルのファイル形式のカスタマイズ」

新しいデバイスの追加用の CSV データファイル

システムに新しいデバイスを追加する場合、BAT 専用に設計された Microsoft Excel スプレッドシートを使用できます。BAT スプレッドシートには、次に挙げる便利な機能があります。

• 異なるデバイス用のマクロを含むデータファイルテンプレート

• カスタマイズされたファイル形式定義

• 複数の電話回線のサポート

• エラーチェックの記録

• CSV 形式へのファイル変換

新しいレコードを作成する場合、BAT.xlt という名前の BAT スプレッドシートを使用します。このスプレッドシートを使用すると、CSV 形式にエクスポートするときにデータが自動的に確認されます。BAT スプレッドシートの使用方法の詳細については、「BAT スプレッドシートをデータ収集に使用する方法」を参照してください。

CSV 形式のファイルの処理に精通している BAT ユーザであれば、テキストエディタを使用して、デバイス挿入タスクウィンドウに用意されているサンプルテキストファイルに準じて CSV データファイルを作成できます。テキストベースの CSV データファイルの詳細については、付録 A「テキストベースの CSV ファイル」を参照してください。

関連項目

• 「既存デバイスの更新用の CSV データファイル」

• 「CSV データファイルのファイル形式のカスタマイズ」

既存デバイスの更新用の CSV データファイル

既存の電話機とデバイスを修正または更新するには、これらのデバイスのレコードを検索する必要があります。BAT では、2 つの方法で電話機、ゲートウェイ、およびデバイスプロファイルを検索できます。つまり、カスタマイズされたクエリーを使用する方法とカスタムファイルを使用する方法です。

カスタマイズされたクエリー

BAT には、クエリー基準を定義するためのウィンドウがあります。特定のデバイスモデルを選択するか、デバイス詳細のリストと回線詳細のリストから検索基準を選択します。両方を選択することも可能です。特定のデバイスモデル、たとえば Cisco IP Phone 7912 のすべてのデバイスを検索する場合は、モデルは選択しますが、他の検索基準は追加しません。この処理によって、データベースに設定されている Cisco IP Phones 7912 すべてのレコードを取得できます。

カスタムファイル

クエリーで使用できる共通のアトリビュートがない場合は、BAT が提供するカスタムファイルオプションを使用します。カスタムファイルには、デバイス名または電話番号が記載されています。カスタムテキストファイルを作成するときは、それぞれのレコードを別々の行に記述します。検索を実行すると、基準に一致するレコードをすべて取得できます。

エクスポートファイル

電話機のグループを移動する必要がある場合は、エクスポートユーティリティを使用します。エクスポートユーティリティを使用すると、Cisco CallManager データベース内の既存レコードを抽出し、CSV データファイルに移動できます。電話機を移動するときは、Export Phones with the All Phone Details オプションを使用します。このオプションを使用すると、電話機に関連する情報（デバイスアトリビュート、回線アトリビュート、サービスなど）をすべて持つレコードを含むエクスポートファイルが生成されます。同じような回線設定を持つ電話機が複数ある場合、テンプレートを使用すれば、特定の詳細情報を持つ電話機レコードをエクスポートすることもできます。エクスポートユーティリティを使用したデバイスの更新の詳細については、「Cisco CallManager サーバから別の Cisco CallManager サーバへのレコードの移動」を参照してください。

関連項目

• 「新しいデバイスの追加用の CSV データファイル」

• 「CSV データファイルのファイル形式のカスタマイズ」

CSV データファイルのファイル形式のカスタマイズ

CSV データファイルには、デバイスアトリビュートを表す文字列と、コンマ区切り値（CSV）形式で記述された情報が格納されています。Cisco CallManager データベースにデータレコードを挿入する場合は、各データファイルが CSV 形式であることを確認してください。以前のリリースの BAT では、CSV ファイルの形式は決まっており、次の 2 つのオプションがありました。

• Default format：各デバイスに対して制限された固定数のアトリビュートと設定を持つ CSV ファイル。

• All details format：エクスポートユーティリティにより作成され、各デバイスのアトリビュートと設定すべてを持つ CSV ファイル。

CSV データファイルの最初の行には、ファイル形式、つまり、CSV ファイルに含まれている各フィールドの名前が表示されます。このファイル形式情報を利用すると、CSV データファイル内の特定のフィールドのエントリを簡単に見つけることができます。たとえば、次に示す CSV ファイルの例では、USER ID はヘッダー内の 5 番目のフィールドを表しており、電話機に対応した CSV ファイルでは、5 番目のフィールドは「johns」になっています。

デフォルトのファイル形式の CSV データファイルの例

NUMBER OF LINES,MAC ADDRESS,DESCRIPTION,LOCATION,USER ID,DIRECTORY NUMBER,DISPLAY,LINE TEXT LABEL,FORWARD BUSY EXTERNAL,FORWARD NO ANSWER EXTERNAL,FORWARD NO COVERAGE EXTERNAL,FORWARD BUSY INTERNAL,FORWARD NO ANSWER INTERNAL,FORWARD NO COVERAGE INTERNAL,CALL PICKUP GROUP,SPEED DIAL NUMBER, SPEED DIAL LABEL

1,1231123245AB,SEP1231123245AB,Dallas,johns,9728437154,9728437154,
Mike,9728437172,9728437196,9728437127,9728437154,9728437178,
9728437189,9728437121/TollByPass,1230000000,Helpdesk

このリリースでは、File Format Configuration ウィンドウを使用して、CSV データファイルのファイル形式をカスタマイズできるようになりました。BAT テンプレートに含まれているアトリビュートを、独自のファイル形式に追加できます。この機能を使用すると、テンプレートのエントリを、デバイス用の特定のアトリビュート値で上書きできます。たとえば、独自のファイル形式のルートパーティションアトリビュートを選択し、電話機ごとに、異なるパーティションを CSV データファイルに入力することができます。

このウィンドウでは、Device フィールドと Line フィールドから特定のアトリビュートを選択できます。

次のデバイスアトリビュートは、すべてのファイル形式に必ず含まれます。

• Number of Lines

• MAC Address

• Description

（注）すべての電話機 CSV データファイルで、Number of Lines が最初の項目になっていることを確認してください。

File Format Configuration ダイアログボックスでは、Device Field ボックスでデバイスアトリビュートを簡単に選択できます。矢印をクリックすると、そのアトリビュートを Selected Device Field ボックスに移動できます。Ctrl キーを押したまま選択すると、複数のアトリビュートを同時に選択できます。

ファイル形式内のデバイスアトリビュートフィールドと回線アトリビュートフィールドの順序は、上向き矢印と下向き矢印を使用して変更できます。アトリビュートを選択した後に、上向き矢印をクリックすると、その項目は前方に移動し、下向き矢印をクリックすると、その項目は後方に移動します。回線アトリビュートをデバイスアトリビュートより前に移動したり、短縮ダイヤルの順序を変更したりすることはできません。

ヒント CSV ファイル形式は、別のデータベースに格納されている従業員の電話機情報の配列に合うようにカスタマイズすることもできます。この方法を利用すると、会社のデータベースと Cisco CallManager データベースとの間でデータを簡単にエクスポートできます。

カスタマイズされたファイル形式の CSV データファイルの例

Device フィールド：MAC Address、Description、Device Pool、Calling Search Space

Line フィールド：Directory number、Partition、Line Text Label（ファイル内では電話番号の後に移動）

File Format には、短縮ダイヤルのコードは含まれません。Include Speed Dials in the CSV Format チェックボックスをオンにすると、短縮ダイヤルを選択することができます。

NUMBER OF LINES,MAC ADDRESS,DESCRIPTION,DEVICE POOL,CSS,DIRECTORY NUMBER,LINE TEXT LABEL,PARTITION,

1,2234900AEF01,SEP2234900AEF01,DP_1,CSS_Restricted,
9725098827,Lobby Phone,Part1

ファイル形式と CSV データファイルの関連付け

テキストエディタを使用して CSV データファイルを作成する場合、最初に、カスタマイズされたファイル形式を作成し、そのファイル形式で指定した順序で値を入力することができます。カスタマイズされたファイル形式のテキストベースの CSV データファイルを挿入する前に、その CSV データファイルにファイル形式名を関連付ける必要があります。1 つの CSV データファイルに関連付けられるファイル形式は 1 つだけです。

Add File Format ウィンドウを使用して、File Name ドロップダウンリストで CSV データファイル <CSVfilename>.txt を選択します。次に、File Format Name ドロップダウンリストで、希望するファイル形式を選択します。CSV データファイル内のデータは、選択したカスタムファイル形式と一致している必要があります。

関連項目

• 「既存デバイスの更新用の CSV データファイル」

• 「新しいデバイスの追加用の CSV データファイル」

BAT スプレッドシートをデータ収集に使用する方法

BAT スプレッドシートを使用すると、CSV データファイルを簡単に作成できます。複数のデバイスを追加し、各デバイスのレコードをスプレッドシート形式で表示できます。スプレッドシート内のファイル形式はカスタマイズ可能です。確認とエラーチェックが自動的に行われるので、設定エラーを減少させることができます。BAT スプレッドシートの下部には複数のタブがあり、このタブを使用して、BAT 内のさまざまなデバイスとユーザの組み合せに必要なデータ入力フィールドにアクセスできます。

CSV データファイルは、BAT テンプレートと連携して動作します。たとえば、BAT スプレッドシートの Phone タブでは、Location、Forward Busy Destination、または Call Pickup Group の各フィールドをブランクのままにすることができます。その場合、これらのフィールドには、BAT 電話機テンプレートからの値が使用されます。しかし、Forward Busy Destination フィールドまたは Call Pickup Group フィールドに値を指定すると、その値が BAT 電話機テンプレートでこれらのフィールドに対して設定されている値を上書きします。

ヒント BAT をインストールすると、スプレッドシート用の Microsoft Excel ファイルはパブリッシャデータベースサーバに置かれますが、通常、パブリッシャデータベースサーバは Microsoft Excel を実行していません。パブリッシャデータベースサーバから、作業用のローカル PC に BAT.xlt ファイルをコピーする必要があります。

ローカルマシンにファイルをコピーするには、フロッピーディスクまたはマッピングされたネットワークドライブを使用して、パブリッシャデータベースサーバ上のパス C:\CiscoWebs\BAT\ExcelTemplate を開きます。 BAT.xlt ファイルを Microsoft Excel がインストールされているローカルマシンにコピーします。

BAT スプレッドシートを使用して CSV データファイルを作成するには、BAT.xlt ファイルを見つけてダブルクリックします。BAT スプレッドシートを開くときは enable macros を選択しておく必要があります。

スプレッドシートには、アトリビュートヘッダーを持つカラムのセットが表示されます。ヘッダーは、BAT フィールドの名前、必須フィールドであるかオプションフィールドであるかの区別、およびフィールドに入力可能な最大文字数を示すためのものです。

スプレッドシートの下部には、すべてのデバイスに対応するタブが表示されています。処理をするデバイスタイプのタブをクリックすると、カラムが調整され、選択したデバイスに関連するフィールドがすべて表示されます。たとえば、電話機とユーザを同時に追加するには、 Phones-Users のマークが付いたタブをクリックします。

次に、 Create File Format ボタンをクリックして、CSV データファイルのファイル形式を定義します。Field Selection ダイアログボックスを使用して、CSV データファイルに含める項目と、項目の順序を選択します。 Update をクリックすると、スプレッドシート内のカラムは、指定した新しいファイル形式に合せて調整されます。

最初の行では、すべての必須フィールドおよび該当するオプションフィールドに、デバイスのデータを入力します。デバイスごとにデータを新しい行に入力してください。

（注）スプレッドシート内にブランク行がある場合、システムは「end of file」マーカーとして処理し、それ以降のレコードを廃棄します。

すべてのデバイスレコードの入力が完了したら、BAT スプレッドシートデータを CSV ファイル形式でエクスポートします。BAT は、CSV ファイル形式を使用して、Cisco CallManager パブリッシャデータベースに対してバルクトランザクションを実行します。

（注）いずれかのフィールドにコンマを入力した場合、BAT.xlt を使用して BAT 形式にエクスポートするときに、そのフィールドエントリは二重引用符で囲まれます。

CSV 形式ファイルは、テキストファイルとして、C:\XLSDataFiles フォルダ、またはユーザが選択した別のフォルダに保存されます。ファイル名の形式は次のとおりです。

<tabname><timestamp>.txt

ここで、<tabname> は、作成したデバイス入力ファイルのタイプ（phone、user
device profiles など）を表します。<timestamp> は、ファイルが作成された正確な日時を表します。

次に、変換した CSV データファイル（CSV 形式バージョン）を Cisco CallManager パブリッシャデータベースサーバに戻し、BAT がアクセスできるようにします。そのためには、マッピングされたネットワークドライブまたはフロッピーディスクを使用して、<tabname><timestamp>.txt ファイルを、 C:\XLSDataFiles フォルダからパブリッシャサーバ上の C:\BATFiles の下にある適切なフォルダにコピーします。

関連項目

BAT データ入力ファイルの確認

BAT ウィザードの次のタスクでは、Validate File オプションを使用します。このタスクでは、CSV データファイルの名前およびデバイス用の BAT テンプレートを選択します。CSV データファイルにすべての詳細が記述されている場合は、モデルを選択します。レコードの挿入方法としては、次のオプションがあります。

Specific Details： Default ファイル形式または Custom ファイル形式のレコードを確認します。

All Details： エクスポートユーティリティで All Details オプションを使用して生成したファイルのレコードを確認します。

Validate を選択すると、システムは、パブリッシャデータベースの情報と照合してエラーをチェックする確認ルーチンを実行します。チェックされる項目は、次のとおりです。

• データベーステーブルに依存しないフィールド、たとえば、Description、
Display Text、Speed-dial Label に、有効な文字が使用されていること。

• Cisco CallManager で、グループ、プール、パーティション、および他の参照アトリビュートが設定されていること。

• デバイスに設定されている回線数が、デバイステンプレートと一致していること（Specific Details の場合のみ）。

ここでは、ユーザが存在するかどうか、または BAT で定義した必須フィールドやオプションフィールド、たとえばダミーの MAC アドレスについてはチェックされません。

トランザクションが完了したら、 View Latest Log File を選択して、正しいと確認できなかったデバイスと、エラーコードを示すログファイルを表示します。ログファイルの詳細については、「BAT および TAPS のトラブルシューティング」を参照してください。

関連項目

BAT データ入力ファイルの挿入

データ入力ファイルの確認が終了したら、Insert ウィンドウを使用して、デバイスレコードを Cisco CallManager パブリッシャデータベースに追加できます。このタスクでは、データ入力ファイルの名前、デバイス用の BAT テンプレート、およびモデル（必要に応じて）を選択します。レコードの挿入方法としては、次のオプションがあります。

Specific Details： カスタマイズされたファイル形式のレコードを挿入します。

All Details： エクスポートユーティリティで All Details オプションを使用して生成したファイルのレコードを挿入します。

Insert をクリックすると、Cisco CallManager データベースにレコードを挿入するために必要な時間を通知するメッセージが表示されます。トランザクションがシステムのパフォーマンスの低下を引き起こす可能性がある場合は、トランザクションを取り消すことができます。

注意 BAT は、オフピーク時間帯にだけ使用してください。それ以外のときに使用すると、バルクトランザクションが Cisco CallManager のパフォーマンスに影響を与え、コール処理に不具合が生じる場合があります。

OK をクリックすると、Transaction Status ウィンドウが表示されます。 Show Latest Status ボタンをクリックすると、進行中のトランザクションが表示されます。

（注）電話機レコードの回線情報に何らかの問題がある場合、BAT は、その電話機レコードを挿入しません。

トランザクションが完了したら、 View Latest Log File をクリックして、追加されたレコード数と追加に失敗したレコード数を示すログファイル（エラーコードを含む）を表示します。ログファイルの詳細については、「BAT ログファイル」を参照してください。

BAT トランザクションを開始した後で、Cisco CallManager のパフォーマンスの低下が認められた場合は、トランザクションを停止できます。進行中の BAT トランザクションを停止するツールの使用方法については、「BAT トランザクションの停止」を参照してください。

関連項目

• 「BAT アプリケーションの使用方法」