構成ファイル
O&O DeskInfo の設定はひとつの XML ファイルに保存されます。通知領域のメニューで使う設定のほか、余白、任意の色、グラフの寸法と履歴数、ヘルプデスクの案内文、管理対象 PC の制限も指定できます。
以下は各要素のリファレンスです。
構成ファイルの保存先
ファイル名は OODeskInfo.cfg です。次の順に検索します。
- コマンドラインで
/cfgを指定した場合は、そのパスを使用します。 OODeskInfo.exeと同じフォルダーにOODeskInfo.cfgがあれば、そのファイルを使用します。USB メモリで実行ファイルと設定を一緒に持ち運べます。- それ以外はユーザープロファイルの
%LocalAppData%\OO Software\OO DeskInfo\OODeskInfo.cfgを使用し、存在しなければ作成します。
有効な構成ファイルを用意するには、一度起動して終了し、%LocalAppData%\OO Software\OO DeskInfo\ に作成されたファイルを開いてください。現在値が既に記入されています。
XML の構造と書式
<?xml version="1.0"?>
<Settings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<Language>en</Language>
<PanelPosition>RightTop</PanelPosition>
<TextSize>12</TextSize>
</Settings>
次の規則に従ってください。
- ルート要素は
<Settings>です。既定の XML 名前空間は宣言しません。 - 要素名は大文字と小文字を区別します。本書の表記に正確に合わせてください。
- 真偽値は小文字の
trueまたはfalseです。 - 色には英語名(
White、Black、Red、Green、Orangeなど)または#RRGGBB、#AARRGGBB形式の 16 進値を使います。 - 各設定要素は省略可能です。省略すると既定値が使われるため、たとえば 2 項目だけでも有効です。
- 要素の順序は問いませんが、プログラムが書き出す順序を保つと比較しやすくなります。
変更の自動反映
ファイルの変更は監視され、保存後約 1 秒で適用されます。通常は再起動せず、エディターを開いたままデスクトップで結果を確認できます。
エディターが複数回に分けて保存することがあるため、書き込みが止まってから読み込みます。書き込み途中の内容が適用されるのを防ぐための待ち時間です。
多くの変更はグラフ履歴を保持したまま表示を再構築します。次の 4 項目は起動時にしか初期化されないリソースを使うため、変更するとプログラムが再起動します。
通知領域のメニューで変更した設定も、すぐに反映され、ファイルに保存されます。
実行中も列レイアウトのキャッシュなどが書き戻されます。編集中は現在のファイルを使用し、古いコピーで上書きして設定を巻き戻さないようにしてください。
閉じタグの欠落、不正な値や文字などで解析できない場合、同じフォルダーにタイムスタンプ付きの .invalid バックアップを作成し、既定値で開始します。壊れた内容も残るため、原因を調べて値を転記できます。
一般
Language
型:文字列、既定値:空 (システム言語)
表示言語を指定します。空の要素または system は Windows の表示言語に従います。指定できる言語は使用中のバージョンに従います。
| 値 | 表示言語 |
|---|---|
空 または system | Windows の表示言語 |
en | 英語 |
de | ドイツ語 |
fr | フランス語 |
通知領域のメニューやコマンドラインの /lang からも指定できます。日本語の言語コードは ja です。
<Language>en</Language>
LogEnabled
型:真偽値、既定値:false
詳細ログを %LocalAppData%\OO Software\OO DeskInfo\Logs\OODeskInfo.log に保存します。問題の調査時に有効にし、サポートへの問い合わせに添付してください。
ShowWelcome
型:真偽値、既定値:true
起動時に初期設定ウィザードを開くかを指定します。完了後は自動的に false になります。再び表示するには true、管理対象 PC で初回から省略するには配布前に false にします。
UpdateSpeed
型:数値 (秒)、既定値:5
表示値の更新間隔です。メニューでは 1(高速)、5(標準)、10(低速)を選べます。ほかの値はカスタムとして表示されます。ドライブのアクセス表示と CPU/RAM カウンターの間隔もこの値から算出します。更新速度を参照してください。
UseEfficiencyMode
型:真偽値、既定値:true
Windows に対し、プロセスを低い優先度で、対応するハードウェアでは高効率コアで実行するよう要求します。効率モード非対応の Windows では効果がありません。
LaunchTaskManager
型:真偽値、既定値:true
通知領域のアイコンをダブルクリックしたときに Windows タスク マネージャーを開くかを指定します。
位置とモニター
PanelPosition
型:LeftTop | RightTop | LeftBottom | RightBottom、既定値:RightTop
表示する画面の隅を指定します。
Monitor
型:数値、既定値:0
表示先のモニターを 0 から始まる番号で指定します。0 は最初のモニターです。ShowOnAllMonitors が true のときは無視されます。
ShowOnAllMonitors
型:真偽値、既定値:false
true にすると、接続中のすべてのモニターに同じプロファイル、位置、外観で同時に表示します。
TopMargin, RightMargin, BottomMargin, LeftMargin
型:数値 (ピクセル)、既定値:0
デスクトップ統合モードで、画面端から表示までの余白を指定します。タスクバー、ドック、壁紙の一部などに重なるときに調整します。
<TopMargin>40</TopMargin>
<RightMargin>24</RightMargin>
<BottomMargin>0</BottomMargin>
<LeftMargin>0</LeftMargin>
IsIntegratedWithDesktop
型:真偽値、既定値:true
true ならデスクトップアイコンの背面の壁紙上に表示し、false ならスライドウィンドウを使用します。
DisplayAlwaysOnTop
型:真偽値、既定値:false
スライドウィンドウに限り、ほかのウィンドウより手前に表示します。
ShowButtonOnDesktop
型:真偽値、既定値:true
スライドウィンドウに限り、画面端のタブボタンを表示します。false のときは通知領域のアイコンから開閉します。
ButtonYPosition
型:数値、既定値:175
タブボタンの垂直位置(ピクセル)です。通常はマウスでドラッグして調整します。
外観
AutoAdjustTextColor
型:真偽値、既定値:true
true では壁紙の明るさに合わせて明るい背景は黒、暗い背景は白の文字を選び、TextColor を無視します。固定色を使うには false にします。
TextColor
型:色、既定値:White
固定する文字色です。AutoAdjustTextColor が false のときだけ有効です。メニューにない色も指定でき、その場合はカスタムと表示されます。
メニューで選べる色は次のとおりです。
| メニューの色 | 値 |
|---|---|
| 白 | White |
| ライトグレー | #F2F2F2 |
| グレー | #D9D9D9 |
| ダークグレー | #838383 |
| 黒 | Black |
| 赤 | Red |
| 緑 | Green |
| 青 | #3082CF |
TextSize
型:数値 (ポイント)、既定値:12
表示の文字サイズです。メニューからは 10、12、14 を選べ、ほかの値はカスタムと表示されます。
DisplayOpacity
型:数値 (%)、既定値:80
パネル全体の不透明度です。メニューからは 100、80、40 を選べます。
Opacity
型:数値 (%)、既定値:80
スライドウィンドウの背景の不透明度です。メニューからは 100、80、40 を選べます。
PanelColor
型:色、既定値:#3082CF (青)
スライドウィンドウのタブボタンの色です。メニューからは青(#3082CF)、White、Black、Red、Green、オレンジ(#FF6A00)を選べます。
FillColorNormal
型:色、既定値:#FF82BC1D (緑)
ドライブ使用率が 90% 未満のときのバーの色です。
FillColorWarning
型:色、既定値:#FFFFBC00 (黄)
使用率が 90% 以上 95% 未満のときのバーの色です。
FillColorCritical
型:色、既定値:#FFDD4A17 (赤)
使用率が 95% 以上のときのバーの色です。
FillColorBackground
型:色、既定値:#FF838383 (灰色)
ドライブ使用率バーの背景色です。
列のレイアウト
UseBalancedColumnDistribution
型:真偽値、既定値:true
true は重みに基づいて各列に割り当てます。ラベルの行やドライブは 1 単位、グラフは高さに比例して数え、グループは分割しません。false では項目を単純に順番に配置します。
BalancedColumnAlignment
型:RightBound | LeftBound、既定値:RightBound
列の高さをぴったりそろえられないときに短くする列を指定します。RightBound は左端列を短くするので右寄せ向き、LeftBound は右端列を短くするので左寄せ向きです。
グラフとパフォーマンス監視
ShowCPUGraph
型:真偽値、既定値:true
使用中のプロファイルに CPU 履歴グラフがあれば表示します。
ShowRAMGraph
型:真偽値、既定値:true
使用中のプロファイルに RAM 履歴グラフがあれば表示します。
ShowGPUGraph
型:真偽値、既定値:true
使用中のプロファイルに GPU 履歴グラフがあれば表示します。GPU データが取得できないシステムでは該当する行が自動で隠れます。
ShowNetworkGraph
型:真偽値、既定値:true
使用中のプロファイルに含まれていれば、ネットワークの送信・受信グラフを両方表示します。
ShowNetworkTrafficInBitsPerSecond
型:真偽値、既定値:true
true はビット毎秒で 10 進単位(b/s、Kb/s、Mb/s、Gb/s)、false はバイト毎秒で 2 進換算の単位(B/s、KB/s、MB/s、GB/s)を使います。
PerformanceGraphHeight
型:数値 (ピクセル)、既定値:48
各グラフの高さです。高くすると小さな変動を見分けやすくなり、列の配分でも大きな重みとして扱われます。
PerformanceGraphMinWidth
型:数値 (ピクセル)、既定値:200
グラフの最小幅です。列に余裕があれば、その幅まで拡大します。
MaxHistoryItems
型:数値、既定値:1024
指標ごとに保持するサンプル数です。通常の更新間隔では 1024 サンプルが約 17~34 分に相当します。増やすと長期間の最小・最大値を確認でき、減らすとメモリ使用量を抑えられます。
PerformanceAverageMinSampleCount
型:数値、既定値:32
平均値を表示するまでに必要なサンプル数です。起動直後に平均値が大きく動くのを防ぎます。実際の上限は MaxHistoryItems です。
ドライブと USB デバイス
ShowDriveActivity
型:真偽値、既定値:true
ドライブごとの読み書きのアクティビティを表示します。
ShowUnknownUSBDeviceNotification
型:真偽値、既定値:false
まだ信頼していない USB ストレージを接続したときに通知します。
TrustedUSBDevices
型:文字列のリスト、既定値:空
常に信頼する USB デバイスの一覧です。該当項目を削除すると次回から再び警告し、要素全体を削除するとすべての信頼設定がリセットされます。
<TrustedUSBDevices>
<string>USBSTOR\DISK&VEN_SANDISK&PROD_ULTRA&REV_1.00\4C530001…</string>
</TrustedUSBDevices>
ネットワーク
NetworkAdapter
型:文字列、既定値:空 (自動)
表示対象のネットワークアダプターの説明です。自動選択なら要素を省略します。Windows の説明文字列との完全一致が必要なので、まずメニューで選び、保存された値を読み取ってください。
プロファイル
SelectedProfile
型:文字列、既定値:Default
使用するプロファイルを指定します。
| 値 | プロファイル |
|---|---|
Default | 標準 |
Full | すべて |
Minimum | 最小 |
DriveLED | ドライブのみ |
| その他の値 | CustomProfile で定義したプロファイル |
CustomProfile
型:要素、既定値:なし
独自プロファイルの定義です。構造と使用可能なキーは表示プロファイルを参照してください。
<CustomProfile>
<Name>Custom</Name>
<DisplayName>IT Support Profile</DisplayName>
<ShowLabels>true</ShowLabels>
<Keys>
<Item>InfoMessage</Item>
<Item>-</Item>
<Item>UserAndMachine</Item>
<Item>-</Item>
<Item>OS</Item>
</Keys>
<ColumnAssignments>InfoMessage:0;UserAndMachine:0;OS:0</ColumnAssignments>
</CustomProfile>
展開と操作制限
次の 4 項目は管理環境用です。組み合わせ方は組織への展開を参照してください。
InfoMessage
型:文字列、既定値:空
システム情報の上に表示する任意の 1 行です。ヘルプデスクの連絡先などに使います。プロファイルに InfoMessage キーが含まれる場合だけ表示され、定義済みプロファイルにはすべて含まれています。
<InfoMessage>IT Help Desk: helpdesk@example.com | Phone: +49 30 1234-5678</InfoMessage>
SetAutoRun
型:真偽値、既定値:未設定
ユーザーに確認せず自動起動の登録を指定します。true で作成、false で削除します。要素を省略するとユーザーの設定を維持します。
IsRestricted
型:真偽値、既定値:未設定
true にすると読み取り専用になり、構成ファイルへの書き込みを止め、通知領域のメニューを隠します。配布した設定をユーザーが変更したり誤って壊したりするのを防ぎます。
TrayMenu
型:Full | ExitOnly | HideMenu | HideAll、既定値:Full
ユーザーに見せる通知領域のアイコンとメニューの範囲を指定します。
| 値 | アイコン | メニュー |
|---|---|---|
Full | 表示 | すべて |
ExitOnly | 表示 | 終了 のみ |
HideMenu | 表示 | なし |
HideAll | 非表示 | なし |
プログラムが管理する値
次の要素は自動で管理されます。通常は編集せず、配布用の構成ファイルからも除いてください。
| 要素 | 内容 |
|---|---|
NewsletterSubscribed | 製品案内からニュースレターに登録したかどうか。 |
ScrollViewerPosition | 表示領域のスクロール位置。 |
SavedColumnLayout | 起動を速くするため保存された、前回の列レイアウト。 |
LayoutEnvironmentFingerprint | レイアウトの再計算が必要かを判断するための、モニター、解像度、文字サイズ、DPI、プロファイルの組み合わせ。 |
WindowPosition、AppViewMode | O&O 共通設定から継承した要素。O&O DeskInfo では使用しません。 |
完全な設定例
サポート用 PC の例です。ドイツ語、左下への表示、大きい文字、ヘルプデスクの連絡先を設定し、自動起動を強制して操作を制限します。
<?xml version="1.0"?>
<Settings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<!-- General -->
<Language>de</Language>
<LogEnabled>false</LogEnabled>
<ShowWelcome>false</ShowWelcome>
<UpdateSpeed>5</UpdateSpeed>
<!-- Position -->
<PanelPosition>LeftBottom</PanelPosition>
<Monitor>0</Monitor>
<ShowOnAllMonitors>false</ShowOnAllMonitors>
<IsIntegratedWithDesktop>true</IsIntegratedWithDesktop>
<TopMargin>0</TopMargin>
<BottomMargin>48</BottomMargin>
<LeftMargin>24</LeftMargin>
<!-- Appearance -->
<AutoAdjustTextColor>true</AutoAdjustTextColor>
<TextSize>14</TextSize>
<DisplayOpacity>100</DisplayOpacity>
<UseBalancedColumnDistribution>true</UseBalancedColumnDistribution>
<BalancedColumnAlignment>LeftBound</BalancedColumnAlignment>
<!-- Graphs -->
<ShowCPUGraph>true</ShowCPUGraph>
<ShowRAMGraph>true</ShowRAMGraph>
<ShowGPUGraph>false</ShowGPUGraph>
<ShowNetworkGraph>true</ShowNetworkGraph>
<ShowNetworkTrafficInBitsPerSecond>true</ShowNetworkTrafficInBitsPerSecond>
<PerformanceGraphHeight>64</PerformanceGraphHeight>
<!-- Drives and USB -->
<ShowDriveActivity>true</ShowDriveActivity>
<ShowUnknownUSBDeviceNotification>true</ShowUnknownUSBDeviceNotification>
<!-- Profile -->
<SelectedProfile>Custom</SelectedProfile>
<CustomProfile>
<Name>Custom</Name>
<DisplayName>Support</DisplayName>
<ShowLabels>true</ShowLabels>
<Keys>
<Item>InfoMessage</Item>
<Item>-</Item>
<Item>UserAndMachine</Item>
<Item>-</Item>
<Item>OS</Item>
<Item>-</Item>
<Item>CPU</Item>
<Item>-</Item>
<Item>NetworkBasic</Item>
<Item>-</Item>
<Item>LocalDrives</Item>
<Item>-</Item>
<Item>Performance</Item>
</Keys>
<ColumnAssignments>InfoMessage:0;UserAndMachine:0;OS:0;CPU:0;NetworkBasic:1;LocalDrives:1;Performance:2</ColumnAssignments>
</CustomProfile>
<!-- Deployment -->
<InfoMessage>IT Help Desk: helpdesk@example.com | Phone: +49 30 1234-5678</InfoMessage>
<SetAutoRun>true</SetAutoRun>
<IsRestricted>true</IsRestricted>
<TrayMenu>ExitOnly</TrayMenu>
</Settings>
編集時には XML コメント(<!-- … -->)を使えますが、プログラムが書き戻すと失われます。コメント付きの原本はクライアントではなく配布用共有フォルダーに保管してください。