「構成」ページのプロパティと値は、Marketing Platform システムテーブルに格納されます。configTool ユーティリティは、IBM Unica Marketing Platform システムテーブルとの間で構成設定をインポートおよびエクスポートします。
以下の理由がある場合に、configTool を使用すると便利です。
|
Campaign で提供されるパーティションおよびデータソーステンプレートをインポートする場合。これは、その後「構成」ページを使用して変更または複製 (またはその両方を) することができます。
|
|
|
製品インストーラで自動的にデータベースにプロパティを追加できないときに、IBM Unica Marketing 製品を登録する (製品の構成プロパティをインポートする) 場合。
|
|
|
XML バージョンの構成設定をバックアップのためにエクスポートする場合、または IBM Unica Marketing の別のインストール先にインポートする場合。
|
|
|
「カテゴリの削除 」リンクのないカテゴリを削除する場合。これを行うには、configTool を使用して構成をエクスポートし、そのカテゴリを作成する XML を手動で削除した後、configTool を使用して、編集済みの XML をインポートします。
|
|
このユーティリティは、設定プロパティとその値が含まれている、Marketing Platform システムテーブルデータベースにある usm_configuration テーブルと usm_configuration_values テーブルを変更します。最良の結果を得るために、これらのテーブルのバックアップコピーを作成するか、または configTool を使用して既存の構成をエクスポートし、その結果ファイルをバックアップしてください。そうしておけば、configTool を使用してインポートする際にエラーが発生した場合でも、構成を復元する方法が得られます。
|
このセクションで後述するように、configTool ユーティリティでは、製品を登録および登録抹消するコマンドのパラメータとして製品名を使用します。IBM Unica Marketing のリリース 8.0.0 では、多くの製品名が変更されています。ただし、configTool で認識される名前は変更されていません。configTool で使用する場合に有効な製品名を、製品の現在名と共に以下のリストに示します。
configTool -d -p "elementPath" [-o]
configTool -i -p "parent ElementPath" -f importFile [-o]
configTool -x -p "elementPath" -f exportFile
configTool -r productName -f registrationFile [-o]
configTool -u productName
-d -p "elementPath"
構成プロパティ階層のパスを指定して、構成プロパティとその設定を削除します。
要素パスでは、カテゴリとプロパティの内部名を使用する必要があります。これらの内部名を調べるには、「構成」ページに進み、目的のカテゴリまたはプロパティを選択して、右ペインで括弧に入れて表示されるパスを見てください。構成プロパティ階層内のパスは | 文字を使用して区切り、パス全体を二重引用符で囲みます。
|
|
|
|
-i -p "parentElementPath" -f importFile
指定された XML ファイルから構成プロパティとその設定をインポートします。
インポートするには、カテゴリのインポート先の親要素へのパスを指定します。configTool ユーティリティは、パスで指定したカテゴリの下 に、プロパティをインポートします。
カテゴリは、最上位より下の任意のレベルに追加できますが、トップカテゴリと同じレベルにカテゴリを追加することはできません。
親要素パスでは、カテゴリとプロパティの内部名を使用する必要があります。これらの内部名を調べるには、「構成」ページに進み、目的のカテゴリまたはプロパティを選択して、右ペインで括弧に入れて表示されるパスを見てください。構成プロパティ階層内のパスは | 文字を使用して区切り、パス全体を二重引用符で囲みます。
tools/bin ディレクトリに対するインポートファイルの相対位置を指定するか、ディレクトリの絶対パスを指定することができます。相対パスを指定するか、または何もパスを指定しないと、configTool はまず tools/bin ディレクトリに対して相対的なファイルを探します。
デフォルトでは、このコマンドは既存のカテゴリを上書きしませんが、-o オプションを使用して、上書きを強制することができます。
-x -p "elementPath" -f exportFile
指定の名前の XML ファイルに構成プロパティとその設定をエクスポートします。
すべての構成プロパティをエクスポートするか、または構成プロパティ階層内のパスを指定して特定のカテゴリにエクスポートを限定することができます。
要素パスでは、カテゴリとプロパティの内部名を使用する必要があります。これらの内部名を調べるには、「構成」ページに進み、目的のカテゴリまたはプロパティを選択して、右ペインで括弧に入れて表示されるパスを見てください。構成プロパティ階層内のパスは | 文字を使用して区切り、パス全体を二重引用符で囲みます。
現行ディレクトリに対するエクスポートファイルの相対位置を指定するか、ディレクトリの絶対パスを指定することができます。ファイル指定に区切り文字 (Unix では /、Windows では / または ¥) が含まれていない場合、configTool は、Marketing Platform のインストール先の tools/bin ディレクトリにファイルを書き込みます。xml 拡張子を指定していない場合、configTool によってその拡張子が追加されます。
-r productName -f registrationFile
アプリケーションを登録します。登録ファイルの位置は、tools/bin ディレクトリからの相対パス、または絶対パスで指定できます。デフォルトでは、このコマンドは既存の構成を上書きしませんが、-o オプションを使用して、上書きを強制することができます。productName パラメータは、上記にリストされているうちのいずれかでなければなりません。
-u productName
productName で指定されているアプリケーションを登録抹消します。製品カテゴリへのパスを含める必要はありません。製品名で十分です。productName パラメータは、上記にリストされているうちのいずれかでなければなりません。これは、製品のすべてのプロパティおよび構成設定を削除します。
-i または -r と共に使用すると、既存のカテゴリまたは製品登録 (ノード) を上書きします。
-d と共に使用すると、「構成」ページに「カテゴリの削除」リンクのないカテゴリ (ノード) を削除することができます。
|
|
|
|
提供されている Campaign データソーステンプレートのいずれかを、デフォルトの Campaign パーティション (partition1) にインポートします。この例では、Oracle データソーステンプレート (OracleTemplate.xml) が、Marketing Platform のインストール先の tools/bin ディレクトリにあることを前提にしています。
|
|
|
|
|
Marketing Platform のインストール先の既存の Campaign パーティション (データソースエントリを含む全体) をエクスポートし、partitionTemplate.xml という名前のファイルに保存して、デフォルトの tools/bin ディレクトリに格納します。
|
|
|
Marketing Platform のインストール先のデフォルトの tools/bin ディレクトリにある app_config.xml という名前のファイルを使用して、手動で productName というアプリケーションを登録し、このアプリケーションの既存の登録を上書きするように強制します。
|