診断および修復ツール

Windchill にはコマンドラインユーティリティの WContentVerify が付属しており、データベース内で参照されているのにボルトに存在しないコンテンツファイルがないか確認できます。また、データベースのメタデータに記録されたサイズと、コンテンツファイルの実際のサイズに違いがないかも確認されます。wt.fv.tools.WContentVerify コマンドを Windchill シェルから実行すると、存在しないファイルまたはサイズが正しくないファイルに関連付けられたビジネスオブジェクトの詳細が表示され、その結果が Windchill ログディレクトリの XML ファイルに出力されます。

codebase ディレクトリにある wt.properties ファイルの wt.mail.mailhost プロパティは、有効な SMTP サーバーを指す必要があります。

引数	説明
-user=<管理者 ID>	管理者ユーザーのユーザー ID。
-password=<<管理者パスワード>	管理者ユーザーのパスワード。
-propertyFile=<パス名>	ユーティリティのプロパティファイルの場所。
-vaults=<vault1,vault2,...>	指定されたボルトのフォルダのみがチェックされます。ボルト名にスペースを含めることはできません。ボルト名とボルト名の間も同様です。
-folders=<フォルダ 1,フォルダ 2,...>	指定されたフォルダのみがチェックされますボルト名にスペースを含めることはできません。ボルト名とボルト名の間も同様です。
-replicavaults=<ボルト 1,ボルト 2,...>	指定されたレプリカボルトのフォルダのみがチェックされます。レプリカボルト名にスペースを含めることはできません。ボルト名とボルト名の間も同様です。
-replicafolders=<フォルダ 1,フォルダ 2,...>	指定されたフォルダのみがチェックされますレプリカフォルダ名にスペースを含めることはできません。フォルダ名とフォルダ名の間も同様です。
-onlyExistence	ファイルが存在するかどうかだけをチェックして報告します。
-onlyReportLatest	作業版数が適用されたドキュメントの最新作業版数のみを報告します。
-email=[DIRECT_EMAIL,EMAIL_GROUP]	指定されたユーザーにメールを送信します。この引数はプロパティファイルの同等のプロパティを上書きします。値として、DIRECT_EMAIL、EMAIL_GROUP、または両方 (コンマで区切る) を指定できます。
-listVaultsFolders	ボルトとフォルダ名を出力して終了します。
-listRemoteVaultsFolders	リモートサイトのボルトとフォルダ名を出力して終了します。
-listReplicationRules	システムに存在するレプリケーション規則をすべて出力します。これはレプリケーション規則を持つボルトに基づいて報告されます。結果は Windchill ログディレクトリの HTML ファイルに保存されます。
-listPredictiveRules	システムに存在する予測規則をすべて出力します。これは予測規則を持つボルトに基づいて報告されます。結果は Windchill ログディレクトリの HTML ファイルに保存されます。
-usage	有効な引数のリストを出力して終了します。
-checkBusinessObject=<ビジネスオブジェクト>	保存されている場所、レプリケーションされた場所も含めて、ビジネスオブジェクトの詳細な情報を出力します。
-checkContentItem=<ファイル名>	保存されている場所、レプリケーションされているかどうかも含めて、特定のファイルの詳細な情報を出力します。
-checkPendingTransfers	まだ転送されていないリモートサイトのファイルについて詳細な情報を出力します。
-checkReplicationHistory=<リモートサイト>	リモートサイトのレプリケーションされたファイルと時期について詳細な情報を出力します。

コマンドラインで指定された引数は、プロパティファイルのプロパティ設定をオーバーライドします。

# Path to the directory that will store utility's output. If not
# specified, will default to $WT_HOME/logs
OUTPUT_STORAGE_PATH=D:\\XML_Output\\
# true/false Enable sending of summary email after a run of the utility
# The wt.properties setting of wt.mail.mailhost is required
EMAIL_GROUP.enabled=true
# Comma separated windchill usernames. Everyone on this list receives
# email notification of a completed utility execution. No spaces allowed.
EMAIL_GROUP.list=testUser1,testUser2
# Enable sending emails to modifiers of the files that have been detected to have
# errors
DIRECT_EMAIL.enabled=true
# Subject of emails sent to modifiers of files that have been detected to have
# errors
DIRECT_EMAIL.mailSubject=Direct Email Report
# Opening line(s) of emails sent to modifiers of files that have been detected to
# have errors
DIRECT_EMAIL.body=First line of Direct Email Report
# Valid windchill username that will be set as the originator of the email
# notification
DIRECT_EMAIL.replyTo=testUser3
# Valid values are html or text. Determines whether the modifiers receive a text
# or html email
DIRECT_EMAIL.format=html
# The maximum number of errors permissible for direct email to be sent.
# If the total number of errors is greater than this number,
# no direct emails will be sent, default is 2000
DIRECT_EMAIL.limit=1500
# Must be one of All or onlyReportLatest . Reports errors either in all
# iterations or the last iteration of iterated objects, default is All.
REPORT_DOCUMENTS_FILTER=All

引数

説明

-user=<管理者 ID>

管理者ユーザーのユーザー ID。

-password=<管理者パスワード>

管理者ユーザーのパスワード。

-fix

修復モードで動作します。この引数を使用する場合は、-inputFile パラメータも指定する必要があります。コンテンツファイルが削除されている場合、コンテンツファイルのコピーが <WT_ホーム>/logs/ContentItems ディレクトリに作成されます。

ボルト内のコンテンツファイルは削除されていません。データベース内のコンテンツファイルのエントリのみが削除されています。

-inputFile=<入力ファイルのフルパスとファイル名>

指定された XML ファイルを使用してプライマリコンテンツアイテムを削除します。入力として使用する XML ファイルは、診断モード (これがデフォルトモード) でこのツールを実行したときに生成される XML ファイルです。診断ファイルを更新して、データベースエントリを削除するコンテンツアイテムの deleteThisItem フィールドの値を Y に変更する必要があります。

ボルト内のコンテンツファイルは削除されていません。データベース内のコンテンツファイルのエントリのみが削除されています。

-outputPath=<出力パス名>

outputPath パラメータで指定されたディレクトリパスを使用して、XML 出力ファイルを保存します。

デフォルトでは、ログのタイムスタンプをファイル名に持つファイルが <WT_ホーム>/logs ディレクトリ内に作成され、XML ファイルがそこに保存されます。この引数が指定され、パスが入力されると、指定のパスが代わりに使用されます。

-confirmBeforeDelete=<Y/N>

各ファイルを削除する前にユーザーに確認を求めますデフォルト値は Y です。

-usage

有効な引数のリストを出力して終了します。

これ以外の方法で XML ファイルを修正すると、矛盾が生じるおそれがあります。

また、ContentHolder ごとに少なくとも 1 つのプライマリコンテンツアイテムが存在している必要があることにも注意してください。ある ContentHolder のすべてのコンテンツアイテムが XML ファイル内で削除用にマークされている場合、このツールはその ContentHolder のすべてのコンテンツアイテムに対してエラーメッセージを印刷し (XML ファイルの errorMessage フィールド)、何も削除せず、XML ファイルの残りの部分の処理を継続します。errorMessage フィールドはオプションで、正常に削除されたオブジェクトに対しては表示されません。