Thermo
TraceFinder
Custom Report のチュートリアル
ソフトウェアバージョン 3.1
XCALI-97541_JP リビジョン A
2013 年 6 月
© 2013 Thermo Fisher Scientific Inc. All rights reserved.
TraceFinder は商標であり、Thermo Scientific および Xcalibur は、米国におけるサーモフィッ
シャーサイエンティフィック株式会社の登録商標です。
NIST は、米国における米国標準技術局の登録商標です。
Windows、Excel、Microsoft、および Visual Basic は、米国およびその他の国におけるマイクロソ
フトの登録商標です。Adobe、Acrobat、Flash、および Reader は、米国およびその他の国におけ
るアドビシステムズの登録商標です。Agilent は、米国およびその他の国におけるアジレントテ
クノロジーの登録商標です。
W3C は、米国におけるマサチューセッツ工科大学の登録サービスマークです。
その他の商標は、サーモフィッシャーサイエンティフィック株式会社およびその系列会社の所
有物です。
サーモフィッシャーサイエンティフィック株式会社は、製品を購入したお客様が製品の操作時
に使用できるように本書を提供しています。本書は著作権保護されており、サーモフィッ
シャーサイエンティフィック株式会社の書面による許可がある場合を除き、本書の全体または
一部を複製することは厳しく禁止されています。
本書の内容は、予告なしに変更されることがあります。本書のすべての技術情報は、参考を目
的としてのみ使用してください。本書に記載されているシステム構成や仕様は、購入者がこれ
までに入手したすべての情報より優先されます。
サーモフィッシャーサイエンティフィック株式会社は、本書の完全性、正確性、または誤りが
ないことを保証するものではなく、文書の指示に正しく従った場合であっても、本書の使用に
よって生じた可能性のある過失、不作為、損傷または損失については責任を負わないものとし
ます。
本書は、サーモフィッシャーサイエンティフィック株式会社と購入者との間における売買契約
の一部をなすものありません。本書に基づいて売買条件が決定または変更されることは一切な
いものとし、二つの文書の間で矛盾する情報についてはすべての場合において売買条件が優先
されるものとします。
リリース履歴 : リビジョン A、2013 年 6 月
ソフトウェアバージョン :Microsoft Windows 7 Professional; (Thermo) Foundation 2.0 SP1; Xcalibur 2.2
SP1; LC Devices 2.5 SP2; GC Devices 2.2
研究専用。診断手順での使用は対象外。
目次
目次
はじめに . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
関連文書 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
安全性に関する注意事項および特記事項 . . . . . . . . . . . . . . . . . . . . . . . . . . . . .viii
お問い合わせ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .viii
Thermo Scientific
第1章
はじめに . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1
第2章
概要 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3
テンプレートアーキテクチャ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Custom Report 作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
カスタマイズレベル . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Excel の機能および限界. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
機能 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
限界 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
第3章
入門ガイド . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9
必要条件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
ベーステンプレートを作成する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
列を使用して作業する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
セキュリティ設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
テンプレートをテストする . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
ノードをテンプレートに一時的に追加するには ( オプション ) . . . . . . . . . . 29
第4章
Batch Report を作成する. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31
レポートテンプレートを開く . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
ラベル、マップされたフィールドおよびマップされた表を追加する . . . . . 33
空の列を追加する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
派生列を追加する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
レイアウトを完了する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
VBA コードを追加する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
テンプレートをテストする . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
TraceFinder Custom reports のチュートリアル
iii
第5章
High Density Sample Report を作成する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .51
レポートテンプレートを開く . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
ラベルおよびマップされたノードを追加する . . . . . . . . . . . . . . . . . . . . . . . . . 53
繰り返しエリアを作成する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
レポートに画像を追加する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
テンポラリデータシートを作成する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
繰り返しエリアでデータを使用する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
レイアウトを完了する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
VBA コードをテンプレートに追加するには . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
[CopyPaste] アドイン機能を使用する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
[Module1] の VBA コード. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
テンプレートをテストする . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
第6章
Calibration Report を作成する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .89
レポートテンプレートを開く . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
キャリブレーションの概要を作成する – Sheet1 . . . . . . . . . . . . . . . . . . . . . . . . 93
多目的列について . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
レポートヘッダーを作成する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
派生列としてヘルパー列を追加するには . . . . . . . . . . . . . . . . . . . . . . . . . . 100
データポイントを作成する – Sheet2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
ピボットテーブルを作成するには . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
[CreatePivotTable] 機能を使用する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
[Sheet2] テンプレートを作成する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
キャリブレーションファイルリストを作成する – Sheet3 . . . . . . . . . . . . . . . 120
レイアウトを完了する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
VBA コードをテンプレートに追加するには . . . . . . . . . . . . . . . . . . . . . . . . 125
テンプレートをテストする . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
第7章
DCC Report を作成する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .129
レポートテンプレートを開く . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
レポートヘッダーを作成する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
画像エリアを作成する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
データエリアを作成する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
派生データを追加する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
ページフッターを作成する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
化合物のマッピング表を作成する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
データ表を作成するには . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
VBA コードを追加する . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
テンプレートをテストする . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
目次
付録 A
Thermo Scientific
よくある質問. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .163
一般的な質問 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
Excel バージョン番号を見つけるには、どうすればよいですか？. . . . . . 164
[Developer] タブを有効にするには、どうすればよいですか？. . . . . . . . . 165
Excel の名前付き範囲とは何ですか？. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
コマンドラインを使用して Excel レポートを作成するには、どうすれ
ばよいですか？. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
Excel レポートを開くときにセキュリティ警告が表示されるのはなぜで
すか？. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
ページ全体を通してページ番号が連続していないのはなぜですか？ . . 171
すべてのレポートのデフォルトのロゴ画像を変更するには、どうすれ
ばよいですか？. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
Excel の [Copy] 機能の代わりにアドインの [Copy/Paste] 機能を使う必
要があるのはなぜですか？. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
レポートにウォーターマークを入れるには、どうすればよいです
か？. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
「File in Use ( ファイルが使用中です )」のエラーメッセージが表示され
るのはなぜですか？. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
データ表に関する質問 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
Excel でデータ表を作成するには、どうすればよいですか？. . . . . . . . . . 175
データ表で列を追加または挿入するには、どうすればよいですか？ . . 177
データ表から列を削除するには、どうすればよいですか？ . . . . . . . . . . 178
データ表で列を移動するには、どうすればよいですか？ . . . . . . . . . . . . 179
データ表の列が XML ソースにリンクされていることを確認するには、
どうすればよいですか？. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
スプレッドシートに多くのデータ表が表示されるのはなぜですか？ . . 180
データをインポートした後にテンプレートから削除するには、どうす
ればよいですか？. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
データをインポートした後にデザインインターフェイスのレイアウト
が変更するのはなぜですか？. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184
レポートで同じフィールドを一回以上使用するには、どうすればよい
ですか？. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185
XML マップをワークブックに追加するには、どうすればよいです
か？. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186
数式を強制的に再計算するには、どうすればよいですか？ . . . . . . . . . . 186
データ表の数式が展開しないのはなぜですか？ . . . . . . . . . . . . . . . . . . . . 187
[RawFileName_SampleCentricData.xml] ファイルはどこにありますか？ . . 187
データ表が編集できないのはなぜですか？ . . . . . . . . . . . . . . . . . . . . . . . . 188
画像処理に関する質問 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
レポートに画像を追加するには、どうすればよいですか？ . . . . . . . . . . 189
レポートから画像を削除するには、どうすればよいですか？ . . . . . . . . 191
デバッグに関する質問 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
テンプレートが基礎としている VBA コードをデバッグするには、どう
すればよいですか？. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
アドインコードをデバッグするには、どうすればよいですか？ . . . . . . 192
TraceFinder Custom reports のチュートリアル
v
目次
付録 B
vi
Custom Report のアドイン API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .193
Public Sub SetupPageHeader. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
Public Sub SetupPageFooter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
Public Function CreateImage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
Public Sub CopyPaste . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
Public Function IsXPath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
Public Function HiddenRowCount. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
Public Function VisibleRowCount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
Public Function Contains . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
Public Sub ShowErrMsg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
Public Sub CheckRequiredName. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
Public Sub CheckRequiredNameInsideOf. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
Public Sub CheckRequiredNameOutsideOf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
Public Sub CheckOptionalName. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
Public Sub AddTextAsWatermark . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
Public Sub AddNamedShapeAsWatermark . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
Public Function GetXmlElement. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214
Public Function GetXmlNodesText . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
Public Function NameExists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
Public Function GetNamedRange . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
Public Sub HideColumns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
Public Sub SetPageBreakAt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
Public Sub SetFrame . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
Public Function GetRowIndex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
Public Function GetColCount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
Public Function GetRowCount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
Public Function ColumnNumber . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
Public Function DeleteName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
Public Function DeleteName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
Public Function GetListColumn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
Public Function Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
Public Function GetValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229
Public Function HideListColumn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230
Public Sub SortList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
Public Sub EnumerateColumn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
Public Function CreatePivotTable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
Public Sub SetManuallyIntegrated. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
Public Sub ReformatManuallyIntegrated . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235
Public Sub SetNoData. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236
Public Sub HideRepeatArea. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
Public Sub FormatValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
Public Sub ReplaceValue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239
Public Function ShiftRange . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
Public Function GetText . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
Public Sub MergeRowCells . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242
Public Function ArraySize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
Public Sub LogMsg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
Public Function GetValidSheetName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
Public Function FileExists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
TraceFinder Custom reports のチュートリアル
Thermo Scientific
はじめに
はじめに
本チュートリアルでは、Thermo TraceFinder™ GC/MS および LC/MS 解析ソフトウェアの
Custom reports を作成する方法を説明します。
内容
• 関連文書
• 安全性に関する注意事項および特記事項
• お問い合わせ
 文書またはヘルプへの変更を提案するには
下のボタンをクリックして、この文書に関する簡単なアンケートに答えてください。
ご協力、有難うございます。
関連文書
本チュートリアルに加え、TraceFinder アプリケーション はヘルプおよび次の文書を PDF
ファイルとして提供します。
• TraceFinder ユーザーガイド
• TraceFinder 管理コンソールユーザガイド
• TraceFinder 測定クイックリファレンスガイド
• TraceFinder 解析クイックリファレンスガイド
• TraceFinder ショートカットメニュークイックリファレンスガイド
Thermo Scientific
TraceFinder Custom reports のチュートリアル
vii
はじめに
安全性に関する注意事項および特記事項
このガイドに記載されている注意事項には必ず従ってください。安全性に関する注意事
項およびその他の特記事項はボックスで表示されます。
安全性に関する注意事項および特記事項には次が含まれます :
重要 ソフトウエアの破損、データの消失、または無効なテスト結果を防止するため
に必要な情報を示します。場合によっては、システムの最適なパフォーマンスに
とって不可欠な情報も含まれます。
補足 一般的な関心事の情報を示します。
ヒント タスクを容易化できる有用な情報を示します。
お問い合わせ
必要な情報について Thermo Fisher Scientific に問い合わせるには、複数の方法がありま
す。
 テクニカルサポートに問い合わせるには
電話
Fax
800-532-4752
電子メール
[email protected]
561-688-8736
ナレッジベース www.thermokb.com
mssupport.thermo.com でソフトウエア更新とユーティリティを検索してダウンロード
してください。
 注文情報についてカスタマサービスに問い合わせるには
電話
Fax
800-532-4752
電子メール
[email protected]
Web サイト
www.thermo.com/ms
561-688-8731
 インターネットからマニュアルをコピーするには
mssupport.thermo.com にアクセスして諸条件に同意した後、ウィンドウの左側にある
[Customer Manuals] をクリックします。
 文書またはヘルプへの変更を提案するには
• http://www.surveymonkey.com/s/PQM6P62 でリーダーアンケートにオンライで答え
てください。
• [email protected] で技術刊行物編集者に電子メールメッセージを送
信します。
viii
TraceFinder Custom reports のチュートリアル
Thermo Scientific
1
はじめに
TraceFinder アプリケーションの Custom reports は、アドインおよびテンプレートを使用す
る Microsoft Excel アプリケーションに基づいています。本チュートリアルでは、数種類
の典型的なレポートの作成プロセスを紹介し、これらのレポート作成に使用される原理
とテクニックを説明します。本チュートリアルを終了した後、ビジネスニーズに合わせ
た独自のレポート作成を開始できるようになります。
Excel アプリケーションおよび Microsoft Visual Basic™ for Applications (VBA) コードに関する
予備知識は利点となりますが、本チュートリアルを開始する前の必須要件ではありませ
ん。
本チュートリアルでは、四種類のレポートを作成する手順を段階的に紹介します。これ
らのレポートは、TraceFinder 機能の範囲を示します :
• Batch Report
これは、もっとも簡潔なレポートチュートリアルで、Custom reports 作成で使用され
る必須テクニックに注目します。Excel 表を使用して、サンプルとそれらのバッチプ
ロパティの一覧を示します。
• High Density Report
このレポートチュートリアルでは、レポートにグラフィックを含める方法、および
テンプレートで各化合物の繰り返しエリアを作成する方法を紹介します。
• Calibration Report
このレポートチュートリアルでは、レポートでクロスタブ表 (Excel アプリケーション
ではピボットテーブルと呼ばれる ) を作成する方法を説明します。
• DCC Report
このレポートチュートリアルは、インターネットのマッピングテーブルを活用して
静的メソッドデータを使用し、ドーピングコントロールセンターで一般に使用され
る DCC レポートを作成します。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
1
2
概要
本章では、TraceFinder アプリケーションで Custom reports を作成する場合に使用されるテ
ンプレート、ワークフロー、カスタマイズレベル、および Excel アプリケーションの機
能を説明します。
内容
• テンプレートアーキテクチャ
• Custom Report 作成
• カスタマイズレベル
• Excel の機能および限界
テンプレートアーキテクチャ
Custom reports テンプレートは二層構造デザインを使用します。これは、Microsoft Excel
アドインコンポーネントを使用し、すべてのテンプレートに対してフレームワークおよ
びライブラリなどのより包括的なサービスを提供します。各テンプレートレベルにおい
て、VBA コードを書いてレポートレイアウトを制御し、出力データをフォーマットでき
ます。
アドインコンポーネントは、次の主な機能を提供します :
• TraceFinder アプリケーションから送られるテンプレートのスタートアップパラメータ
を処理します。アプリケーションはこれらのパラメータを使用して、Custom reports
の作成を完全に自動化します。
• すべてのレポートでヘッダーおよびフッターを作成するためのフレームワークを提
供します。ヘッダーおよびフッターのデフォルトセットは提供アドインに含まれて
いますが、各テンプレートでこれらを無効にしてレポートをさらにカスタマイズで
きます。
• TraceFinder アプリケーションレポートに特有のユーティリティ機能を提供し、内部の
複雑さを非表示にし、テンプレートレベルでのカスタマイズを促進します。例えば、
オンラインアドイン機能を使用して、レポートにグラフィックを追加したり、クロ
スタブレポートを作成したりすることが可能です。
デザインにより、アドインモジュールをカスタマイズする必要はほぼありません。パス
ワード保護されています。アドインコードを修正しなければならない場合、パスワード
についてサーモフィッシャーサイエンティフィックの担当者までお問い合わせくださ
い。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
3
2
概要
Custom Report 作成
各テンプレートで使用される VBA コードは、最小限に維持されます。一般に、ほとんど
のテンプレートは 100 行未満の VBA コードを使用します。
Custom Report 作成
TraceFinder アプリケーションは、Custom reports を連続的に作成します。次のフロー
チャートは、Custom reports を作成するための TraceFinder のプロセスを示します。
図 1. Custom reports を作成する
4
TraceFinder Custom reports のチュートリアル
Thermo Scientific
2 概要
Custom Report 作成
完了テンプレートで Custom reports を作成するワークフローは以下のとおりです :
1. Custom reports の作成ができるように TraceFinder アプリケーションを構成します。詳
細は、TraceFinder ユーザーガイドを参照してください。すべてのレポートテンプレー
トを、アプリケーションの C:\Thermo\Shared\Templates\Reports フォルダに保存できま
す。
2. バッチ処理の Custom reports を実行する場合、TraceFinder アプリケーションは自動的
に各サンプルに対してサンプル特有のデータファイルを .xml フォーマットで作成し
ます。これらのファイルは [Data] フォルダにあります。これらは
RawFileName_SampleCentricData.xml と同じ名前で、この場合 RawFileName はサンプル
の生データファイルの名前です。
• XML ファイルには、サンプル特有のレポートを作成するために必要なすべての
データが含まれます。ほとんどの場合、レポート作成のためにこの一つのファイ
ルのみを参照すれば十分です。
• 一つ以上のサンプル特有の生データファイルを参照する必要がある場合もありま
す。
• RawFileName_SampleCentricData.xml ファイルには、バッチレベルデータである
キャリブレーションデータも含まれます。各サンプルが処理されるとこのファイ
ルが作成されることから、最後のサンプルが終了するまでバッチレベルデータは
部分的な結果しか含んでいない可能性があります。
3. Custom reports を作成するために、アプリケーションは Excel アプリケーションの
Windows コマンドラインを作成し、これをオペレーティングシステムに送ります。
オペレーティングシステムは、指定されたテンプレートで Excel アプリケーションを
開きます。テンプレートは、アドインコンポーネントを介して残りのパラメータを
処理し、これがデータをロードして処理した後、レポートを作成します。
TraceFinder アプリケーションの定期的ユーザーである場合、この処理の詳細は非表示
になっています。しかし、あなたがテンプレート開発者である場合、この処理を理
解しておくと便利です。
Excel コマンドラインはこのように見えます :
excel.exe /n TEMPLATENAME /x/CUSTOMPARAMETERS
この場合 :
• /n は、Windows オペレーティングシステムに、テンプレート自体を編集している
のではなく、Excel スプレッドシートを作成するためにこのテンプレートを使用
していることを伝えます。この切り替えがない場合、Excel アプリケーションは
編集のために指定されたテンプレートを開きます。
• /x は、これに続くすべてのパラメータが処理のためにアドインコンポーネント
に送られることを示します。
第 3 章、『入門ガイド』
、で、コマンドラインについてより詳細に説明されています。
Windows オペレーティングシステムは、指定されたテンプレートで Excel アプリケー
ションを開きます。/x の後のすべてのパラメータを、処理のためにテンプレートへ
送ります。テンプレートは、アドインコンポーネントを介してパラメータを処理し、
これがデータをロードして処理した後、レポートを作成します。カスタムパラメー
タが処理された後、アドインコンポーネントが呼び出す最初の機能は、IUtil イン
ターフェイスの Validate() 機能で、すべてのテンプレートで実行されます。この機能
Thermo Scientific
TraceFinder Custom reports のチュートリアル
5
2
概要
カスタマイズレベル
は、テンプレートデザインを不測の変更から保護します。Validate() が成功すると、
XML データのインポートを開始します。すべてのデータをインポートした後、アド
インは IUtil インターフェイスの ProcessData() 機能を呼び出してすべての後処理を実
行します。この機能は、TraceFinder アプリケーションにレポートが完了し、必要であ
れば次のレポートの準備が完了していることを通知します。
カスタマイズレベル
Excel アプリケーションは、レポートのカスタマイズにおいて柔軟性があるため、ニーズ
や技術的専門知識に合せることができます。
• テンプレートを変更して、レポートの外観をカスタマイズできます。VBA プログラ
ミングを習得する必要はありません。例えば、Excel アプリケーションへの基本的な
理解があれば、フォント変更、列のサイズ変更、または数のフォーマットが可能で
す。わずかなトレーニングで、リストの列の追加および削除ができるようになりま
す。
• VBA プログラミングの知識がある場合、テンプレートが使用するコードを修正して
テンプレートロジックをカスタマイズできます。テンプレートコードをカスタマイ
ズできるので、このレベルでアドインコードを変更する必要はありません。
• アドインフレームワークを変更する必要がある場合、高度なカスタマイズを実行で
きます。既存のアドインコンポーネントを参照することにより、各自のニーズに合
わせた完全に別の種類のテンプレートを作成できます。DCC レポートは、この種類
のカスタマイズの一例です。
6
TraceFinder Custom reports のチュートリアル
Thermo Scientific
2 概要
Excel の機能および限界
Excel の機能および限界
ここに、Custom reports 作成に影響を及ぼす可能性のある Excel アプリケーションの機能
と限界を紹介します。
機能
• 名前付き範囲 : レポート作成プロセスで広範囲で使用されています。
• XML サポート : データソースとして一つの XML ファイルに基づいて Custom reports
を作成するために使用されます。
• フレキシブルフォーマット : プロ仕様のレポートを作成するために使用されます。
限界
• Excel アプリケーションは、関係データを使用しません。代わりに、そのすべての
データは階層型構造に従います。結果として、ソース XML ファイルのデータが重複
する場合があります。
• ワークブックで各マップ XML データソースを一回のみ参照できます。同じフィール
ドを一回以上使用したい場合、同じソースを XML マップとして毎回追加しなければ
なりません。
• すべての画像は、バイト配列として XML ファイルに埋め込まれています。しかし、
Excel スプレッドシートのセルにはデータサイズの制限があり、アプリケーションが
セルにバイト配列を直接ロードするのを妨げます。したがって、すべての画像をプ
ログラムでスプレッドシートにランタイムでロードします。スプレッドシートに図
を配置すると、図のプレースホルダーを作成するだけです。
• Excel アプリケーションは、マクロまたは VBA コードに [Undo] 機能を提供しません。
マクロまたは VBA コードのいずれかを実行する場合、[Undo] スタックを完全に消去
します。
• Excel のコピー / 貼り付け機能は強力ですが、Windows の [Clipboard] を使用してデー
タを送ります。バックグラウンドでレポート処理を実行中に Windows の [Clipboard]
を使用してスプレッドシートにデータを動かす場合、間違って不正確なレポートを
作成する可能性があります。アドインコンポーネントは、この問題を回避するため
に特別のコピー / 貼り付け機能を提供します。
ヒント 一般に、コピー / 貼り付け機能はシート上のデータが多くなるにつれ遅くな
ります。Excel アプリケーションは、各タブに小さいデータセットのある多くのタブ
をより簡単に扱うことができるので、多くのレポートには、各タブが一つの印刷
ページを表す複数のタブがあります。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
7
3
入門ガイド
本章では、ThermoCustomReportBaseTemplate ファイルを作成します。このファイルは、後
の章で、特定のレポートテンプレートを作成する際のベースとして使用されます。
内容
• 必要条件
• ベーステンプレートを作成する
• 列を使用して作業する
• セキュリティ設定
• テンプレートをテストする
必要条件
Excel アプリケーションを使用して Custom reports を作成するには、システムを次の必須
コンポーネントに構成しなければなりません。
補足 TraceFinder アプリケーションをインストールして、いずれかの Custom reports を
作成したことがある場合、すでにこれらの要件に適合しています。
• Microsoft Excel 2007 SP2 (12.0.6524 以降 )
Excel アプリケーションのバージョンを確認するには、次を行います :
a. Excel アプリケーションを開きます。
b. [Office] ボタン
クします。
をクリックし、次に [Excel Options]
をクリッ
c. [Resources] をクリックします。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
9
3
入門ガイド
必要条件
d. [About Microsoft Office Excel 2007] エリアでお持ちのバージョンを確認します。
図 2. [Excel Options Resources] ダイアログボックス
• Thermo Report アドイン (Thermo Report Add-In.xla)
任意のカスタムテンプレート (*.xltm) をロードします。アドインのロードが成功した
後、次の例が示すようなアドインメニューが見えます。
図 3. アドインメニュー
[Thermo Report Add-In.xla] ファイルは次のフォルダーにあります :
C:\Thermo\Shared\Templates\Reports
Excel アプリケーションテンプレートファイル (*.xltm) は次のフォルダにインストール
されます :
C:\Thermo\Shared\Templates\Reports
10
TraceFinder Custom reports のチュートリアル
Thermo Scientific
3 入門ガイド
ベーステンプレートを作成する
ベーステンプレートを作成する
特定のレポートテンプレートを作成するには、ベーシックテンプレートファイルから開
始します (ThermoCustomReportBaseTemplate)。
 Excel アプリケーションで [Developer] タブを有効にするには
1. [Office] ボタン
します。
をクリックし、次に [Excel Options]
をクリック
2. [Show Developer tab in the Ribbon] チェックボックスを選択して [OK] をクリックしま
す。
Excel アプリケーションが [Developer] タブを表示します。
 ThermoReportAddIn 機能をロードするには
1. [Developer] タブをクリックします。
リボンが展開されて [Developer] 機能を表示します。
2. [Visual Basic]
をクリックします。
[Microsoft Visual Basic] ウィンドウが開きます。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
11
3
入門ガイド
ベーステンプレートを作成する
3. [View] > [Properties Window] を選択します。
[Properties] パネルが開きます。
図 4. [Properties] パネルが開いた状態の [Microsoft Visual Basic]
4. [Tools] > [References] を選択します。
[References - VBAProject] ダイアログボックスが開きます。チェックマークは選択され
ているリファレンスを示し、これらはリストの上部に表示されます。
12
TraceFinder Custom reports のチュートリアル
Thermo Scientific
3 入門ガイド
ベーステンプレートを作成する
5. [ThermoReportAddIn] リファレンスをロードするには、次のうちの一つを行います :
–
[Available References] リストで [ThermoReportAddIn] が選択されている場合、適切
にセットアップされています。[OK] をクリックします。
–
[Available References] リストに [ThermoReportAddIn] があるが、選択されていない
場合、チェックボックスを選択して [OK] をクリックします。
ヒント 下方向にスクロールして探します。選択されていないリファレンスは
アルファベット順で表示されます。
–
[Available References] リストに [ThermoReportAddIn] がない場合、次の手順に従っ
て手動で追加します :
i.
[Browse] をクリックします。
ii. C:\Program Files\Microsoft Office\Office12\Library フォルダに進みます。
iii. ファイルタイプを [All files(*.*)] に変更します。
iv. [Thermo Report Add-In.xla] アドインファイルを選択します。
v.
[Open] をクリックします。
アプリケーションは [References] ダイアログボックスで [ThermoReportAddIn]
を [Available References] リストに追加します。
図 5. [ThermoReportAddIn] が含まれている [References - VBAProject] ダイアログボッ
クス
vi. [ThermoReportAddIn] チェックボックスを選択して [OK] をクリックします。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
13
3
入門ガイド
ベーステンプレートを作成する
[Microsoft Visual Basic] アプリケーションが、[ThermoReportAddIn] プロジェクトを
[Visual Basic] ダイアログボックスにロードします。
図 6. [ThermoReportAddIn] が含まれている [Microsoft Visual Basic]
補足 [ThermoReportAddIn] プロジェクトはパスワード保護されています。プラス
(+) サインをクリックしてプロジェクトを展開しようとする場合、パスワードを
入力するように促されます。アドインは、Custom reports を作成するためにパス
ワードを変更する必要がないようにデザインされています。アドイン動作を変更
しなければならない場合、パスワードについてサーモフィッシャーサイエンティ
フィックの担当者までお問い合わせください。
[ThermoReportAddIn] プロジェクトはここでプロジェクトの一覧に表示されていますが、
アドインプロジェクトを使用するまでテンプレートの一部ではありません。最初にアド
インプロジェクトを使用せずに Excel アプリケーションを終了して再度開く場合、この
リファレンスは再び表示されません。
アドインを使用する準備が完了したので、アドインプロジェクトがテンプレートに関連
付られていることを確認します。
14
TraceFinder Custom reports のチュートリアル
Thermo Scientific
3 入門ガイド
ベーステンプレートを作成する
 ベーシックエレメントをアドインコンポーネントに接続するには
1. [VBAProject] の [ThisWorkbook] をダブルクリックします。
コードエディタパネルが開きます。
2. コードエディタに次のコードを入力します。
Private Sub Workbook_Open()
Set mIUtil = New MyUtil
End Sub
図 7. [Workbook] コードエディタ
[Workbook] を開くとき、アプリケーションが [MyUtil] 機能を呼び出します。
コードが [MyUtil] 機能をプロセスに接続し、[MyUtil] インターフェイスを実行します。
機能がテンプレートをアドインコンポーネントに接続します。
これで、[ProcessData] および [Validate] サブルーチンをテンプレートに追加する準備がで
きました。これらの二つの機能の詳細は、第 2 章、『概要』を参照してください。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
15
3
入門ガイド
ベーステンプレートを作成する
 モジュールをプロジェクトに追加するには
1. VBA プロジェクトを右クリックして、ショートカットメニューから [Insert] >
[Module] を選択します。
アプリケーションは、[Modules] と名前の付いたフォルダをプロジェクトに追加し、
そのフォルダに [Module1] と名前の付いたモジュールを追加し、コードエディタを開
きます。
図 8. [Module1] コードエディタ
2. [Module1] コードエディタに次のコードを入力します :
Option Explicit
Public Sub ProcessData()
End Sub
Public Function Validate(Optional showWarning As Boolean = True) As Boolean
Validate = True
End Function
[ProcessData] および [Validate] サブルーチンは、テンプレートでもっとも基本的な機能
です。
• デザインインターフェイスのすべて ( 例えば、名前付き範囲が完全か ) が正確で
あることを確認するために、[Validate()] は XML データソースがスプレッドシー
トにロードされる前に呼び出されます。データをインポートできるように、この
機能は [True] を返さなくてはなりません。[False] を返す場合、問題の詳細を説明
するエラーメッセージが表示されます。
• [ProcessData()] は XML データソースがインポートされた後に呼び出され、さらな
る処理 ( 例えば、データの抽出 ) の準備が完了しています。
これで、レポートのヘッダーとフッターの制御機能を追加する準備が完了しました。
[ThermoReportAddIn] 機能には、[mIUtil] を使用したこのインターフェイスのデフォルト
インプリメンテーションがあります。
16
TraceFinder Custom reports のチュートリアル
Thermo Scientific
3 入門ガイド
ベーステンプレートを作成する
 [MyUtil] クラスをプロジェクトに追加するには
1. VBA プロジェクトを右クリックして、ショートカットメニューから [Insert] > [Class
Module] を選択します。
アプリケーションは、プロジェクトに [Class Module] フォルダと [Class1] モジュール
を追加し、コードエディタを開きます。
2. [Class1] の名前を [MyUtil] に変更するには、次を行います :
a. [Class1] を選択します。
b. [View] > [Properties Window] を選択します。
[Class1] の [Properties] パネルが開きます。
c. [Class1] を [MyUtil] に変更して [ENTER] を押します。
d. [Properties] パネルを閉じます。
3. [MyUtil] をダブルクリックしてコードエディタを開きます。
4. [MyUtil] コードエディタに次のコードを入力します :
Option Explicit
Implements IUtil
Private Sub IUtil_ProcessData()
ProcessData
End Sub
Private Sub IUtil_SetupPageFooter()
mUtil.SetupPageFooter "", 0.5
End Sub
Private Sub IUtil_SetupPageHeader()
mUtil.SetupPageHeader
End Sub
Private Function IUtil_Validate(Optional showWarning As Boolean = True) As
Boolean
IUtil_Validate = Validate(showWarning)
End Function
Thermo Scientific
TraceFinder Custom reports のチュートリアル
17
3
入門ガイド
ベーステンプレートを作成する
図 9. [MyUtil] コードエディタ
[IUtil] インターフェイスの [ProcessData]、[SetupPageFooter]、[SetupPageHeader]、および
[Validate] 機能を使用すると、テンプレートレベルでの制御が向上します。
これで、XML データファイルをテンプレートにマップする準備が完了しました。これを
行うには、RawFileName_SampleCentricData.xml ファイルが必要です。
TraceFinder アプリケーションで Custom report を作成した場合、アプリケーションは、
Custom reports のデータソースファイルとして作用する
RawFileName_SampleCentricData.xml ファイルを作成しています。サンプル中心データは通
常、バッチの [Data] フォルダにあります。例 :
C:\Thermo\TraceFinder\Projects\Subprojects\Batches\Batches\
ML_BATCH_01\Data
TraceFinder アプリケーションをインストールしていない場合、本チュートリアルのレ
ポートテンプレートを作成するために、任意の RawFileName_SampleCentricData.xml ファ
イルを使用することができます。
 テンプレートをデータソースのスキーマと関連づけるには
1. [Microsoft Visual Basic] プロジェクトを閉じます。
2. Excel スプレッドシートで、[Developer] タブをクリックしてすべての [Developer] 機能
を表示させます。
18
TraceFinder Custom reports のチュートリアル
Thermo Scientific
3 入門ガイド
ベーステンプレートを作成する
3. [Source]
をクリックします。
スプレッドシートが [XML Source] パネルを表示します。マップされているノードを
[XML Source] パネルからスプレッドシートにドラッグできます。
デフォルトでは、Excel アプリケーションが自動的に三つのシートを作成します。次
の例では、二つのみが表示されます。
図 10. [XML Source] パネルを表示している Excel スプレッドシート
4. [XML Maps] をクリックします。
[XML Maps] ダイアログボックスが開きます。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
19
3
入門ガイド
ベーステンプレートを作成する
5. [Add] をクリックして次のファイルにナビゲートします :
RawFileName_SampleCentricData.xml
次の警告メッセージが表示される場合があります :
6. [In the Future]... チェックボックスを選択して [OK] をクリックします。
アプリケーションは、インポートされたスキーマを XML マップリストに追加しま
す。
図 11. XML マップを示す [XML Maps] ダイアログボックス
7. [OK] をクリックします。
Excel アプリケーションは、XML マップを [XML Source] パネルに追加します。
20
TraceFinder Custom reports のチュートリアル
Thermo Scientific
3 入門ガイド
ベーステンプレートを作成する
図 12. XML マップを表示している [XML Source] パネル
8. [XML Source] リストをスクロールして利用可能なデータフィールドを見ます。
これで、テンプレートはレポート作成への使用準備が完了しました。このテンプレート
を保存し、本チュートリアルのすべての Custom reports にいつでも使用できます。
 Excel ワークブックをマクロ有効テンプレートとして保存するには
1. [Office] ボタン
をクリックし、次に [Save As] を選択します。
デフォルトで、Excel アプリケーションはこのワークブックを Excel Workbook (*.xlsx)
として保存しようとします。これは、マクロをサポートしないスプレッドシートで
す。
2. [Save as Type] を [Excel Macro-Enabled Template (*.xltm)] に変更します。
3. [File Name] を [ThermoCustomReportBaseTemplate] に変更します。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
21
3
入門ガイド
ベーステンプレートを作成する
図 13. テンプレートのファイルタイプが指定された [Save As] ダイアログボックス
補足 デフォルトで、TraceFinder アプリケーションは
C:\Thermo\Shared\Templates\Reports フォルダの Excel アプリケーションテンプレー
トしか使用しません。
このテンプレートは、本チュートリアルで Custom report テンプレートのベースとして機
能します。すでに作成されたレポートとの名前付けの混乱を回避するために、本チュー
トリアル全体を通して Custom report テンプレートには「My」の接頭語を付けます。
図 14. 完成したベーステンプレート
22
TraceFinder Custom reports のチュートリアル
Thermo Scientific
3 入門ガイド
列を使用して作業する
列を使用して作業する
このセクションでは、列の追加、挿入、移動、または削除に使用できる手順を説明しま
す。
 データ表で列を移動するには
1. 列のヘッダーをクリックして列を選択します。
2. カーソルを選択された列の境界線の部分にホールドします。
3. カーソルが四方向矢印に変化したら、列を新しい位置にドラッグします。
• 列を空の列にドラッグする場合、ドラッグされた列の内容が空の列を置き換えま
す。
• 空ではない列に列をドラッグした場合、警告ダイアログボックスが表示され、移
動先の列の内容を置換したいかを確認します。
 データ表に空の列を挿入するには
1. 隣接する列のヘッダーを右クリックし、[Insert] メニューから任意のコマンドを選択
します。
Excel アプリケーションは、空のマップされていない列を選択された列の右または左
側に挿入します。デフォルトでは、新しい列は [Columnn] と名前が付けられます。
2. ツリーノードを空の列にドラッグします。
補足 Excel アプリケーションは、データ表の中央にツリーノードを直接ドラッグする
方法では新しい列を挿入させません。代わりに、空の列にツリーノードをドラッグ
して空の列を上書きするか、データ表の始めか終わりにノードをドラッグして、後
で動かします。
マップされている列を上書きしようとすると、次のエラーメッセージが表示されま
す:
Thermo Scientific
TraceFinder Custom reports のチュートリアル
23
3
入門ガイド
列を使用して作業する
補足 次のエラーメッセージが表示されたら、[Match Element Data Type] をクリックし
て閉じます。
ノードが正確にマップされていない心配がある場合、マップされているノードを確認す
る方法があります。
 テンプレートでマップされているフィールドを確認するには
次のうちの一つを行います :
• 列を選択します。
列がツリーノードにマップされている場合、Excel アプリケーションは [XML
Source] ツリーでマップされているノードを選択して太字で表示します。
• [XML Source] ツリーでマップされているノードを選択します。
すべてのマップされているノードは太字フォントで表示されます。ノードが列に
マップされている場合、Excel アプリケーションはデータ表で列を自動的に選択
します。
空の列を挿入して [XML Source] ノードを空の列にドラッグする場合、デフォルトの列
ヘッダーは変わりません。
補足 [XML Source] ツリーの「ノード」はスプレッドシートに「フィールド」を作成
します。
 マップされた名前を列ヘッダーに復元するには
例えば [Column1] のように、デフォルトのセル名を選択して削除します。
データ表の列ヘッダーは空になることはできないので、Excel アプリケーションは
マップされたノード名を自動的に使用します。
 列全体をデータ表から削除するには
列ヘッダーのセルを右クリックして [Delete] をショートカットメニューから選択しま
す。
 列の一部をデータ表から削除するには
1. 列のヘッダーをクリックして列を選択します。
2. 列を右クリックしてショートカットメニューから [Delete] > [Table Columns] を選択し
ます。
補足 列を削除するために [Delete] キーを押さないでください。
24
TraceFinder Custom reports のチュートリアル
Thermo Scientific
3 入門ガイド
セキュリティ設定
 [XML Source] ツリーからマッピングを削除するには
1. [XML Source] パネルでノードを選択します。
2. 選択された ( 太字 ) ノードを右クリックし、ショートカットメニューから [Remove
Element] を選択します。
Excel アプリケーションは、ノードとデータ表の列の間のリンクを削除します。これ
により、データ表の列は削除されません。データ表の列はマップされておらず、過
去のマップされた名前が残ります。
セキュリティ設定
マクロ有効テンプレートを Excel アプリケーションで実行するには、アドインおよびテ
ンプレートファイルのディレクトリを信頼できる場所のリストに追加しなければなりま
せん。
• TraceFinder アプリケーションをインストールした際に、デフォルトのテンプレート
フォルダ C:\Thermo\Shared\Templates\Reports は、Excel アプリケーションの信頼できる
場所のリストに追加されています。テンプレートをこのフォルダから実行する限り、
デフォルトのセキュリティ設定が機能します。
• テンプレートを別のフォルダに保存したい場合、そのフォルダは信頼できる場所に
追加できます。
 信頼できる場所のリストにフォルダを追加するには
1. [Office] ボタン
します。
をクリックし、次に [Excel Options]
をクリック
[Excel Options] ダイアログボックスが開きます。
2. [Trust Center] をクリックして [Trust Center Settings] をクリックします。
[Trust Center] ダイアログボックスが開きます。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
25
3
入門ガイド
セキュリティ設定
図 15. [Trust Center] ダイアログボックス
3. [Trusted Locations] をクリックします。
4. [Add New Location] をクリックして任意のフォルダの場所にナビゲートします。
5. [Microsoft Office Trusted Location] ダイアログボックスで [OK] をクリックします。
6. [Trust Center] ダイアログボックスで [OK] をクリックします。
7. [Excel Options] ダイアログボックスで [OK] をクリックします。
これで、任意のマクロ有効テンプレートが Excel アプリケーションで実行できるように
なります。
26
TraceFinder Custom reports のチュートリアル
Thermo Scientific
3 入門ガイド
テンプレートをテストする
テンプレートをテストする
この時点で、[Windows Start] > [Run] ボックスからテストを実行する準備が完了し
ています。このテストで、入力するコードが次を実行します :
• Excel アプリケーションを開きます。
• ThermoCustomReportBaseTemplate.xltm テンプレートを使用して新しいワーク
ブックを作成します。
• パラメータをテンプレートに渡します。
• 1ngrep5_SampleCentricData.xml ソースファイルに基づいてレポートを作成しま
す。
• ThermoCustomReportBaseTemplate.xlsm ファイルにレポートを保存します。
補足 [XML Source] ツリーからどのノードもスプレッドシートにマップしてい
ないので、Excel アプリケーションは「no elements have been mapped ( どのエレ
メントもマップされていません )」というエラーメッセージを表示します。
[OK] をクリックしてこのエラーを閉じ、空のレポートの作成を継続できま
す。または、このテストを開始する前にノードを一時的にマップできます。
マップされたノードを追加する説明は、29 ページの『ノードをテンプレート
に一時的に追加するには ( オプション )』 を参照してください。
 テストを実行するには
1. [Start] > [Run] を選択します。
[Run] ダイアログボックスが開きます。
2. このコードを [Open] ボックスに入力します :
Excel.exe /n "C:\Thermo\Custom Report
Tutorials\ThermoCustomReportBaseTemplate.xltm"
/x/C:\Thermo\Custom|Report|Tutorials\Data\1ngrep5_SampleCentricData.x
ml/C:\Thermo\Custom|Report|Tutorials\Reports\MyThermoCustomReportBase
Template.xlsm/s/h
この場合 :
• /n スイッチは、Windows オペレーティングシステムに、テンプレート自
体を編集しているのではなく、Excel スプレッドシートを作成するために
このテンプレートを使用していることを伝えます。この切り替えがない
場合、Excel アプリケーションは編集のために指定されたテンプレートを
開きます。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
27
3
入門ガイド
テンプレートをテストする
• スペースが含まれる場合、テンプレートファイルパスを引用符で囲まなければな
りません。例 :
"C:\Thermo\Custom Report Tutorials\MyReportName.xltm"
これを怠った場合、Excel アプリケーションはスペースで区切られている各アイ
テムを個別の Excel ワークブックと認識し、ロードしようとします ( 同時にエ
ラーを引き起こします )。
• /x の前のスペースは、Windows にそのスペースの後のすべてを Excel テンプレー
トに渡すように伝えます。このスペースのあとに引用符を追加しないでくださ
い。そうした場合、Windows はこれを第二のスプレッドシートと認識して開こう
とします ( 同時にエラーを引き起こします )。
• /x スイッチは Custom reports に特有の内部スイッチです。[Thermo Custom Report
Add-In] ユーティリティは、/x の後のすべてのパラメータを処理します。
• /x の後のパラメータは、スペースを含むことができません。スペースが必要な場
合、代わりに縦線「|」を使用します。アドインで縦線はスペースに置き換えら
れます。次の例は、[Custom Report Tutorials] フォルダでの縦線の使用例を示しま
す:
.../x/C:\Thermo\Custom|Report|Tutorials\...
• /x の後のカスタムパラメータは、セパレータとしてスラッシュ「/」を使用しま
す。/x の後の始めの二つのパラメータが必須で、その他すべてはオプションで
す。
–
/x の後の最初のパラメータは、アドインに [XML Source] データのパスを伝え
ます。パスを正確に指定する限り、テンプレートの場所は問題になりません。
しかし、TraceFinder アプリケーションがテンプレートを使用するために、テ
ンプレートは専用のフォルダになければなりません。
–
/x の後の第二のパラメータは、作成された Excel スプレッドシートのパスをア
ドインに伝えます。
• /s パラメータは、スプレッドシートを閉じる前にファイルを保存するようにアド
インに伝えます。このスイッチがない場合、スプレッドシートは作成されますが
保存されません。
• /h パラメータは、画面更新を隠すように Excel アプリケーションに伝えます。こ
れにより、レポート作成が速くなり、画面フラッシュが減少します。しかし、テ
ンプレートをデバッグしたい場合、このスイッチを削除しなければなりません。
• [Thermo Custom Report Add-In] は、レポート作成に影響を与える追加のコント
ロールおよびパラメータをサポートします。パラメータの完全リストは、167
ページの『コマンドラインを使用して Excel レポートを作成するには、どうすれ
ばよいですか？』を参照してください。
ヒント デフォルトで、TraceFinder アプリケーションファイルは長いファイルパス
に結果を構成します。Windows の [Run] ダイアログボックスは、256 文字に制限
されています。この制限に対処するには、ファイルをルートディレクトリに近い
フォルダにコピーするか、バッチファイルにコマンドラインを置きます。
28
TraceFinder Custom reports のチュートリアル
Thermo Scientific
3 入門ガイド
ノードをテンプレートに一時的に追加するには ( オプション )
このベーステンプレートを使用し、本チュートリアルのいずれの Custom reports テンプ
レートをいつでも作成できます。
• 第 4 章、『Batch Report を作成する』
• 第 5 章、『High Density Sample Report を作成する』
• 第 6 章、『Calibration Report を作成する』
• 第 7 章、『DCC Report を作成する』
ノードをテンプレートに一時的に追加するには ( オプション )
テンプレートをテストした場合に、次のエラーメッセージが表示される可能性がありま
す :「No data was imported because no elements have been mapped. ( どのエレメントもマップさ
れていないので、データはインポートされませんでした。)」
このエラーは、テンプレートで XML マップからいずれのノードも使用しなかったため
に生じています。このオプションのエクササイズでは、テンプレートでマップされたエ
レメントがあることを示すために、ノードをマップから追加してレポートを作成しま
す。
 テンプレートにマップされているフィールドを追加するには
1. [Developer] タブをクリックしてすべての [Developer] 機能を表示させます。
2. [Source]
をクリックします。
スプレッドシートが [XML Source] パネルを表示します。マップされているノードを
[XML Source] パネルからスプレッドシートにドラッグできます。
3. [XML Source] ツリーから、少なくとも一つのノードをスプレッドシートの任意のセル
にドラッグします。
希望する数のノードをドラッグできます。
4. テンプレートを保存します。
重要 本チュートリアルのいずれかの Custom reports 作成に使用する前に、ベース
テンプレートからこれらのマップされたフィールドを削除しなければなりませ
ん。
5. 27 ページの『テンプレートをテストする』のすべての指示を繰り返します。
結果レポートに、スプレッドシートに追加したノードが表示されます。この例では、
ノード [InstrumentName] はセル A1 にマップされています。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
29
3
入門ガイド
ノードをテンプレートに一時的に追加するには ( オプション )
図 16. レポートの例
補足 TraceFinder アプリケーションの Crystal Reports とは異なり、Custom reports は名前
にタイムスタンプを付けることができます。Custom reports は既存のレポートを上書
きしません。初めてレポートを作成する場合、ファイル名にタイムスタンプは追加
されていません。同じレポートを再び作成する場合、アプリケーションは新しいレ
ポートの名前にタイムスタンプを追加します。
これでテンプレートを TraceFinder アプリケーションに統合し、Custom report がアプリ
ケーションから作成されたときの外観を確認できるようになりました。
 TraceFinder アプリケーションでテンプレートを使用するには
1. 新しいテンプレートをアプリケーションの専用フォルダにコピーします。
C:\Thermo\Shared\Templates\Reports
2. このテンプレートを、TraceFinder アプリケーションの他の提供レポートと同様に使用
します。Custom reports の使用方法の詳細は、TraceFinder ユーザーガイドを参照して
ください。
本チュートリアルで ThermoCustomReportBaseTemplate.xltm ベーステンプレートを作成す
るには、一時マップフィールドを削除しなければなりません。
 一時マップフィールドを削除するには
1. セルの左上を右クリックします。
ここを右クリッ
クします。
2. ショートカットメニューから [Delete] を選択します。
Excel アプリケーションは、スプレッドシートのすべてのデータを削除します。
[Delete] を選択するとセルの文字は削除されますが、マッピングは削除されません。
3. テンプレートを保存します。
30
TraceFinder Custom reports のチュートリアル
Thermo Scientific
4
Batch Report を作成する
本章では、TraceFinder アプリケーションが提供する標準 Batch Report と同様の Batch
Report の Excel テンプレートを作成します。
内容
• レポートテンプレートを開く
• ラベル、マップされたフィールドおよびマップされた表を追
加する
• 空の列を追加する
• レイアウトを完了する
• VBA コードを追加する
• テンプレートをテストする
TraceFinder アプリケーションの Batch Report は、バッチレベルのサマリーで、バッチのす
べてのサンプルと特定のプロパティを一覧表示します。
図 17. Batch Report テンプレートのサンプル
Thermo Scientific
TraceFinder Custom reports のチュートリアル
31
4 Batch Report を作成する
レポートテンプレートを開く
Batch Report は、Custom Reports の作成に使用される多くの概念および原理を示します。
本チュートリアルでは、次の内容を紹介します :
• 静的ラベルを追加する方法
• [XML Source] マップからデータフィールドを追加する方法
• [XML Source] マップからリスト ( または表 ) フィールドを追加する方法
• データ表に空の列を追加して使用する方法
• データ表に非表示列を追加して使用する方法
• 参照データに名前付き範囲を追加して使用する方法
• アドインコンポーネントにより公開されたインターフェイスを使用し、テンプレー
トをアドインに接続するための基本的な VBA コードを書く方法
• [Start]> [Run] コマンドを使用してレポートを作成する方法
レポートテンプレートを開く
次の手順では、第 3 章、『入門ガイド』
、で基本テンプレートとして作成した
ThermoCustomReportBaseTemplate.xltm ファイルを使用します。
 Batch Report テンプレートを開始するには
Windows エクスプローラで、ThermoCustomReportBaseTemplate.xltm ファイルのコピー
を作成し、新しいコピーに [MyBatchReport.xltm] と名前を付けます。
 Excel アプリケーションからテンプレートファイルをロードするには
1. Excel アプリケーションを開きます。
2. [Office] ボタン
を押し、メニューから [Open] を選択します。
3. [Open] ダイアログボックスで、[MyBatchReport.xltm] を選択して [Open] をクリック
します。
 Windows エクスプローラからテンプレートファイルをロードするには
Windows エクスプローラで、[MyBatchReport.xltm] ファイルを右クリックして [Open]
を選択します。
重要 このテンプレートファイルを Windows エクスプローラでダブルクリックしない
でください。編集のためにテンプレートを開く代わりに、このテンプレートに基づ
いた新しいスプレッドシートを開くことになります。
32
TraceFinder Custom reports のチュートリアル
Thermo Scientific
4 Batch Report を作成する
ラベル、マップされたフィールドおよびマップされた表を追加する
ラベル、マップされたフィールドおよびマップされた表を追加
する
次の手順で、テンプレートで静的列ヘッダーを作成して名前を付け、マップされた
フィールドおよびマップされた表を追加します。
 レポートのタイトルに静的ラベルを入力するには
1. セル B1 に [Batch Report] を入力します。
2. セル B3 に [Lab name: ( ラボ名 :)] を入力します。
3. セル B4 に [Instrument: ( 装置 :)] を入力します。
4. セル B5 に [User: ( ユーザー :)] を入力します。
5. セル B6 に [Batch: ( バッチ :)] を入力します。
6. セル H3 に [Method: ( メソッド :)] を入力します。
7. セル H5 に [Cali File: ( キャリブレーションファイル :)] を入力します。
8. [CTRL] を押してラベルセルをそれぞれ選択します。
9. 右クリックしてショートカットメニューから [Format Cells] を選択します。
[Format Cells] ダイアログボックスが開きます。
10. [Font] タブをクリックして [Font] ページを開きます。
図 18. [Format Cells] ダイアログボックスの [Font] ページ
11. [Font Style] ボックスで、[Bold] を選択します。
12. [OK] をクリックします。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
33
4 Batch Report を作成する
ラベル、マップされたフィールドおよびマップされた表を追加する
テンプレートが次の例と同様であることを確認します。
図 19. 静的ラベルのテンプレート
補足 列 A の代わりに、列 B から開始します。列 A は後で表示列として使用します。
いずれの列のサイズの修正、およびフォーマットの微調整は、すべての要素を配置し
てから最後に行うことができます。
これで、[XML Source] パネルを使用してマップされたフィールドをテンプレートに追加
する準備が完了しました。
ヒント 続行する前に、Excel ウィンドウが [Developer ( 開発 )] タブを表示しているこ
とを確認します。これはデフォルトでは非表示になっています。Excel ウィンドウが
[Developer ( 開発 )] タブを表示していない場合、第 3 章、『入門ガイド』を参照してく
ださい。
34
TraceFinder Custom reports のチュートリアル
Thermo Scientific
4 Batch Report を作成する
ラベル、マップされたフィールドおよびマップされた表を追加する
 テンプレートにマップされているフィールドを追加するには
1. Developer ([ 開発 ]) タブをクリックします。
リボンが展開されて [Developer ( 開発 )] 機能を表示します。
2. [Source] ボタン
をクリックします。
スプレッドシートが [XML Source] パネルを表示します。マップされているノードを
[XML Source] パネルからスプレッドシートにドラッグできます。
テンプレートが次の例と同様であることを確認します。
図 20. [XML Source] パネルを表示しているテンプレート
任意のレポートテンプレート作成を開始する前に、レポート上のデータポイントを
確認し、それらが [XML Source] ツリーのノードにどのようにマップされているかを
理解します。
補足 [XML Source] ツリーの「ノード」はスプレッドシートに「フィールド」を作
成します。
[XML Source] ツリーからノードを適切な表のセルにドラッグして、
[SampleCentricExportBatch] フォルダのノードからマップされたフィールドを作成する
準備が完了しました。
3. [MethodHeaderData] フォルダを開き、次を行います :
a. セル C3 に [LabName] ノードをドラッグします。
b. セル C4 に [InstrumentMethodName] ノードをドラッグします。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
35
4 Batch Report を作成する
ラベル、マップされたフィールドおよびマップされた表を追加する
4. [BatchHeaderData] フォルダを開き、次を行います :
a. セル C5 に [UserName] ノードをドラッグします。
b. セル C6 に [BatchName] ノードをドラッグします。
5. [MethodHeaderData] フォルダを開き、次を行います :
a. セル I3 に [MethodName] ノードをドラッグします。
b. セル I4 に [MasterMethodName] ノードをドラッグします。
6. [BatchHeaderData] フォルダを開き、セル I5 に [CalibrationFile] ノードをドラッグしま
す。
テンプレートが次の例と同様であることを確認します。
図 21. マップされたフィールドのテンプレート
ヒント スプレッドシートでマップされたフィールドは、[XML Source] パネルが表示
されている限り、青のボックスで示されます。[XML Source] ツリーでマップされてい
るノードは、太字で強調表示されます。
補足 [XML Source] ツリーの各ノードは、一回のみ使用できます。今後のチュートリ
アルで同じフィールドが複数回使用される場合、同じマッピングスキーマを必要な
回数だけインポートすることにより、この制限に対処します。
これでバッチのサンプルリストを作成する準備が完了しました。サンプルリストは、
マップデータ表に示されます。Excel アプリケーションでは、[XML Source] パネルから
マップされた表フィールドをドラッグできます。
36
TraceFinder Custom reports のチュートリアル
Thermo Scientific
4 Batch Report を作成する
ラベル、マップされたフィールドおよびマップされた表を追加する
[XML Source] ツリーからノードを適切な表のセルにドラッグして、
[SampleCentricExportBatch/Samples/SampleCentricExportSample] フォルダのノードからマップ
されたフィールドを作成する準備が完了しました。
 テンプレートにマップされている表を追加するには
1. セル B8 に [RawFileName] ノードをドラッグします。
2. セル C8 に [AcquisitionDate] ノードをドラッグします。
テンプレートが次の例と同様であることを確認します。
図 22. マップされた表のテンプレート
補足 スプレッドシートは、マップされた表 ( リスト ) とは異なる方法でマップさ
れたフィールドを表示します。この違いは [XML Source] ツリーで確認できます :
通常のノードは、通常のフォルダアイコン
を表示します。繰り返しまたはコ
レクションコンテナノードは、小さい下向きの矢印が付いたフォルダアイコン
を表示します。例えば、バッチでは、[BatchHeaderData] ( 通常ノード ) のセッ
トは一つのみですが、バッチには複数のサンプルがあり、各
[SampleCentricExportSample] ( 繰り返しノード ) がその一つを表します。
[XML Source] ツリーからノードを適切な表のセルにドラッグして、
[SampleCentricExportBatch/Samples/SampleCentricExportSample] フォルダのノードから追
加のマップされたフィールドを作成する準備が完了しました。
3. セル D8 に [SampleId] ノードをドラッグします。
4. セル E8 に [SampleName] ノードをドラッグします。
5. セル F8 に [ApplicationSampleType] ノードをドラッグします。
6. セル G8 に [VialPosition] ノードをドラッグします。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
37
4 Batch Report を作成する
ラベル、マップされたフィールドおよびマップされた表を追加する
7. セル H8 に [InjectionVolume] ノードをドラッグします。
8. セル I8 に [ConversionFactor] ノードをドラッグします。
9. セル J8 に [SampleComments] ノードをドラッグします。
テンプレートが次の例と同様であることを確認します。
図 23. マップされたフィールドおよび表のテンプレート
このテンプレートは最終的なテンプレートと比較すると、二つの列が用意されていませ
ん。最終的なテンプレートには C に空の列、また G に [Level] 列が表示されます。これら
の二つの列は、Custom reports 作成において重要な概念です。次の二つの手順でこれらの
列について説明します。
38
TraceFinder Custom reports のチュートリアル
Thermo Scientific
4
Batch Report を作成する
空の列を追加する
空の列を追加する
レポートツールとして Excel アプリケーションを使用する場合、列のサイズを調節する
必要があるかもしれません。Excel アプリケーションはセクションの概念をサポートしな
いことから、スプレッドシートでは、列が上から下へ同じ幅をもって存在します。しか
し、全体ではなく限られた行にだけ追加のスペースが必要な場合があります。
データ表が関与しない場合、列を小さくし、列の間のスペースを必要に応じて残すこと
ができます。しかし、同じシートにデータ表がある場合、この方法は使用できません。
詳細は、180 ページの『スプレッドシートに多くのデータ表が表示されるのはなぜです
か？』を参照してください。
対処法として、データ表に空の列を追加することができます。空の列を追加すること
で、文字が超過した場合、前の列に必要な追加のスペースを提供します。リンクされた
表で直接 [XML Source] データフィールドを使用できないことから、通常、空の列の代わ
りに非表示列を追加します。
このサンプルリストでは、[RawFileName] 列に追加のスペースが必要です。しかし、B3
から C6 のラベルとマップされたフィールドの間にスペースを入れすぎたくないため、B
列の幅を広げすぎることは希望しません。[RawFileName] 列の隣に空の列を追加すること
で、この問題が解決します。
 テンプレートに空の列を追加するには
セル C8 を右クリックしてショートカットメニューから [Insert] > [Table Columns to
the Left] を選択します。
アプリケーションは C 列に空の列を挿入して [Column1] と名前を付けます。
テンプレートが次の例と同様であることを確認します。
図 24. 空の列が挿入されたテンプレート
Thermo Scientific
TraceFinder Custom reports のチュートリアル
39
4 Batch Report を作成する
派生列を追加する
派生列を追加する
最初の列でマップされたフィールドを非表示にし、Excel 数式を使用して [Level] 列をうめ
る準備が完了しました。ここで、[Column1] を非表示にしたいとします。Excel では、列
ヘッダーが固有であり空ではないことを必要とするので、単純に削除することはできま
せん。空白文字が有効なヘッダーとして許容されるので、[Column1] を空白文字にして
非表示にすることができます。
 テンプレートに派生列を追加するには
1. [SampleCentricExportBatch/Samples/SampleCentricExportSample] フォルダを開き、
[SampleLevel] ノードを [XML Source] ツリーから セル A8 にドラッグします。
[SampleLevel] フィールドは calibration standard サンプルタイプにおいて値を持ち、
calibration standard ではないサンプルタイプでは空になっています。しかし、サンプ
ルタイプが calibration standard ではない場合、レポートで [SampleLevel] を表示すると、
レベル列を空のフィールドではなく N/A と示す必要があります。したがって、
[SampleLevel] フィールドは直接使用できません。
この問題の対処法として、[SampleLevel] を非表示列にし、[SampleLevel] を評価するた
めの Excel 数式を使用する表示用の派生列を追加します。
2. [ApplicationSampleType] セルを右クリックしてショートカットメニューから [Insert] >
[Table Columns to the Left] を選択します。
アプリケーションは、[ApplicationSampleType] 列の前の G 列に空の列を挿入し、セル
G8 にヘッダー名を [Column2] と挿入します。
3. セル G9 に、次の数式を入力します :
=IF(A9="", "N/A", A9)
この式は、A9 の [SampleLevel] が空の場合、表に N/A と表示し、そうではない場合、
[SampleLevel] 値を表示するするように伝えます。この数式は G9 にのみ入力します
が、この表にデータをインポートするときに、これは自動的にこの列のすべてのセ
ルに展開します。
40
TraceFinder Custom reports のチュートリアル
Thermo Scientific
4
Batch Report を作成する
派生列を追加する
テンプレートが次の例と同様であることを確認します。
図 25. 非表示列を参照した数式を示すテンプレート
4. この列を数式として使用するには、セルフォーマットを [General] タイプに変更しま
す。
空の列を追加する場合、セルタイプはデフォルトで文字タイプに戻ります。文字タ
イプの列は、データをインポートしても展開しません。詳細は、187 ページの『デー
タ表の数式が展開しないのはなぜですか？』を参照してください。
5. A 列ヘッダーを右クリックして [Hide] をショートカットメニューから選択します。
ヒント Excel アプリケーションでは、いずれの列も非表示にできます。しかし、
TraceFinder Custom reports に非表示列が必要な場合、常に最初の列を使用します。
非表示列を表の中に配置した場合、繰り返しエリアにデータのブロックをコピー
する時に問題を引き起こします。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
41
4 Batch Report を作成する
レイアウトを完了する
レイアウトを完了する
次の手順では、デフォルトの表ヘッダー名の名前を変更する、マップされた表の名前を
付ける、またレイアウトを完了する方法を説明します。
デフォルトでは、スプレッドシートにノードをドロップする場合、ノード名はデフォル
トのヘッダー名になります。ここでは、デフォルトのヘッダー名を変更する準備が完了
しています。次の手順で、デフォルトの表ヘッダーの名前を変更します。
 テンプレートでマップされた表ヘッダー名を変更するには
1. B8 を [RawFileName] から [File Name] に変更します。
2. C8 を [Column1] から 「 」( スペース一つ ) に変更します。
3. D8 を [AcquisitionDate] から [Date/Time] に変更します。
4. E8 を [SampleId] から [Sample ID] に変更します。
5. F8 を [SampleName] から [Sample Name] に変更します。
6. G8 を [Column2] から [Level] に変更します。
7. H8 を [ApplicationSampleType] から [Sample Type] に変更します。
8. I8 を [VialPosition] から [Pos] に変更します。
9. J8 を [InjectionVolume] から [Inj Vol] に変更します。
10. K8 を [ConversionFactor] から [Conv Factor] に変更します。
11. L8 を [SampleComments] から [Comment] に変更します。
テンプレートが次の例と同様であることを確認します。
図 26. カスタムヘッダー文字を示したテンプレート
42
TraceFinder Custom reports のチュートリアル
Thermo Scientific
4
Batch Report を作成する
レイアウトを完了する
Excel 名前付き範囲機能を使用してテンプレートの表に名前を付ける準備が完了しまし
た。セルの範囲に名前を付け、このエリアを参照するためにその名前を使用できます。
Custom reports に表示するデータがない場合、レポートに「No data in this report ( このレ
ポートにデータはありません )」と表示されます。この場合、データ表を完全に非表示
にすることができます。二つのアドインコンポーネントがこの機能を実行します。
VBA コードは二通りのセルの参照方法を提供します : 直接セル範囲 ( 例えば、
Sheet1!A5:B6) または名前付き範囲です。名前付き範囲は、デザインの柔軟性において利
点があります。
次の手順で、二つの名前付き範囲を定義します。はじめに、「No data in this report ( この
レポートにデータはありません )」が表示されるセルに、「NoData」という名前付き範囲
を定義します。アドイン機能を使用してこのメッセージを表示します。
次に、Excel は各データ表に例えば [Table1] の名前を自動的に付けます。VBA コードで表
を参照するには、これを特定の名前に変更します。
 テンプレートでデータ表に名前を付けるには
1. [Formulas] タブをクリックして [Name Manager] をクリックします。
補足 Excel アプリケーションは、[Table1] または [Table2] などのすべての表の名前
を自動的に付けます。新しい表を作成するごとに、前のものを削除しても表の名
前は増やしていきます。
2. [Name Manager] ダイアログボックスで、[Table1] をダブルクリックします。
デフォルトの表の名前は異なります。[Refers To] 列のシート、行、および列番号を使
用して表を確認します。
[Edit Name] ダイアログボックスが開きます。
3. デフォルトの名前を [Data Table] に変更します。
4. [OK] をクリックします。
この図で示されているように、二つの名前が定義されています。
図 27. 二つの名前が付けられた表を示す [Name Manager] ダイアログボックス
後で VBA コードを使用して、表が空の場合にセル B7 に「No data in the report ( この
レポートにデータはありません )」と表示させます。47 ページの『VBA コードを追
加する』を参照してください。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
43
4 Batch Report を作成する
レイアウトを完了する
5. [Name Manager] ダイアログボックスで [Close] をクリックします。
これで、テンプレートのレイアウトを仕上げる準備が完了しました。
 テンプレートで列のサイズを変更するには
1. [Page Layout] タブをクリックしてレイアウト編集機能を表示させます。
クリックして [Page Setup]
ダイアログボックスを開
きます
2. 右下の矢印をクリックして [Page Setup] ダイアログボックスを開きます。
図 28. [Page Setup] ダイアログボックス
3. [Page Setup] ダイアログボックスで、次の変更を行います :
a. [Page] タブをクリックして、Orientation ( 方向 ) を [Portrait] から [Landscape] に変
更します。
[Batch Report] は、表の幅が広いので縦方向ではフィットしません。
b. [Margins] タブをクリックし、ページの余白を次のように変更します ( すべての単
位はインチ ):
Top ( 上 ):0.65、Left ( 左 ):0.25、Right ( 右 ):0.25、Bottom ( 下 ):0、Header ( ヘッ
ダー ):0.3、Footer ( フッター ):0.3
c. [Header/Footer] タブをクリックして [Align with Page Margins] チェックボックスを
選択します。
44
TraceFinder Custom reports のチュートリアル
Thermo Scientific
4
Batch Report を作成する
レイアウトを完了する
d. [OK] をクリックして [Page Setup] ダイアログボックスを閉じます。
4. 列のタイトルの仕切りをドラッグして、すべての列をページ範囲内にフィットさせ
ます。
ページプレビューモードで、ページの右の余白は点線で示されます。
 テンプレートの背景を変更するには
1. データ表のヘッダーをクリックして [Design] タブを表示させます。
2. [Design] タブをクリックします。
[Design] タブは [Table Styles] 機能を表示します。
3. [Table Styles] ギャラリーを展開し、ギャラリーの左下にある [Clear]
リックします。
をク
背景がプレーンに変わります。
テンプレートが次の例と同様であることを確認します。
図 29. プレーンの背景の列幅の例
4. ページの最後の列の文字が境界線を超過して、新しいページを作成しないように、
次を行います :
a. 最後の列を選択します。
b. 右クリックしてショートカットメニューから [Format Cells] を選択します。
[Format Cells] ダイアログボックスが開きます。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
45
4 Batch Report を作成する
レイアウトを完了する
c. [Alignment] タブをクリックして [Alignment] ページを開きます。
図 30. [Format Cells] ダイアログボックスの [Alignment] ページ
d. [Text Control] エリアで、[Wrap Text] チェックボックスを選択します。
e. [OK] をクリックします。
テンプレートのデザインが完了です。これで VBA コードを追加してテンプレートとデー
タを接続する準備が完了しました。
46
TraceFinder Custom reports のチュートリアル
Thermo Scientific
4
Batch Report を作成する
VBA コードを追加する
VBA コードを追加する
この [Batch Report] に、VBA コードを使用して二つの機能を追加します。これらの機能は
次を実行します :
• [DataTable] と名付けられた表が存在するかを確認します。
• 表にデータがない場合、[NoData] と定義された名前付き範囲で「No data in this report
( このレポートにデータはありません )」と表示します。
 VBA データをテンプレートに接続するには
[Module1] に次のコードを追加します :
Option Explicit
Public Sub ProcessData()
If Sheet1.ListObjects("DataTable").Range.Rows.Count = 0 Then
mUtil.SetNoData "NoData"
mUtil.HideRows "DataTable" 'Hide all data area
End If
End Sub
Public Function Validate(Optional showWarning As Boolean = True) As
Boolean
Dim err_msg As String, info_msg As String, msg As String
' Check required names
mUtil.CheckRequiredName err_msg, "DataTable", "'DataTable' must be
defined."
' Display messages if any
mUtil.ShowErrMsg err_msg, info_msg, showWarning
Validate = err_msg = ""
End Function
この場合 :
• [MyUtil] クラスの [IUtil_Validate()] が [Sub Validate()] を呼び出します。
ソース XML データがインポートされる前に、[IUtil_Validate()] は名前付き範囲が
正確に定義されていることを確認します。例えば、表に列を追加する、または表
から列を削除する場合、名前付き範囲に依存している他の機能が作用するため、
関連する名前付き範囲を更新しなければなりません。
• [ThisWorkbook] の [Workbook_Open()] が [Sub ProcessData()] を呼び出します。
[Workbook_Open()] は、ソース XML ファイルがインポートされた後で呼び出され
ます。[Workbook_Open()] コードで、アプリケーションは [DataTable] 表に行があ
るかを確認します。行がない場合、アドインで定義された [SetNoData] 機能を使
用して、
「No data in this report ( このレポートにデータはありません )」を名前付き
範囲 [NoData] に設定します。この場合、[HideRows] アドイン機能を使用して
[DataTable] 行を非表示にします。
5. エラーチェックに [Visual Basic] コンパイル機能を使用するには、[Debug] > [Compile
VBAProject] を選択します。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
47
4 Batch Report を作成する
VBA コードを追加する
[Visual Basic] コードが次の例と同様であることを確認します。
図 31. VBA データ
これで、テンプレートを使用してレポートを作成する準備が完了しました。
48
TraceFinder Custom reports のチュートリアル
Thermo Scientific
4 Batch Report を作成する
テンプレートをテストする
テンプレートをテストする
この時点で、[Windows Start] > [Run] ボックスからテストを実行する準備が完了していま
す。このテストで、入力するコードが次を実行します :
• Excel アプリケーションを開きます。
• MyBatchReport.xltm テンプレートを使用して新しいワークブックを作成します。
• パラメータをテンプレートに渡します。
• 1ngrep5_SampleCentricData.xml ソースファイルに基づいてレポートを作成します。
• MyBatchReport.xlsm ファイルにレポートを保存します。
 テストを実行するには
1. [Start] > [Run] を選択します。
[Run] ダイアログボックスが開きます。
重要 デフォルトで、TraceFinder アプリケーションファイルは長いファイルパスに
結果を構成します。Windows の [Run] ダイアログボックスが 256 文字に制限しま
す。256 文字の制限を超過した場合、アプリケーションは警告なしに文字を切り
捨て、動作が失敗する可能性があります。
この制限に対処するには、ファイルをルートディレクトリに近いフォルダにコ
ピーするか、バッチファイルにコマンドラインを置きます。
2. このコードを [Open] ボックスに入力します :
Excel.exe /n "C:\Thermo\Custom Report Tutorials\MyBatchReport.xltm"
/x/C:\Thermo\Custom|Report|Tutorials\Data\1ngrep5_SampleCentricData.xml/C:\T
hermo\Custom|Report|Tutorials\Reports\BatchReport.xlsm/s/h
このコードで使用されるパラメータの詳細は、27 ページの『テンプレートをテスト
する』を参照してください。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
49
4 Batch Report を作成する
テンプレートをテストする
作成されたレポートは、次の図のように画面に表示されます ( 使用したバッチにより、
実際のデータは異なる場合があります )。
図 32. 作成されたレポート
これで、テンプレートを TraceFinder アプリケーションに統合する準備が完了しました。
 TraceFinder アプリケーションでテンプレートを使用するには
1. 新しいテンプレートをアプリケーションの専用フォルダにコピーします。
C:\Thermo\Shared\Templates\Reports
2. このテンプレートを、TraceFinder アプリケーションの他の提供レポートと同様に使用
します。
Custom reports の使用方法の詳細は、TraceFinder ユーザーガイドまたは 第 3 章、『入門
ガイド』を参照してください。
50
TraceFinder Custom reports のチュートリアル
Thermo Scientific
5
High Density Sample Report を作成する
本章では、TraceFinder アプリケーションが提供する High Density Sample Report 1 Long と同
様の High Density Sample Report の Excel テンプレートを作成します。
内容
• レポートテンプレートを開く
• ラベルおよびマップされたノードを追加する
• 繰り返しエリアを作成する
• レポートに画像を追加する
• テンポラリデータシートを作成する
• 繰り返しエリアでデータを使用する
• VBA コードをテンプレートに追加するには
• テンプレートをテストする
TraceFinder アプリケーションの High Density Sample Report はサンプルレベルのレポート
で、高密度フォーマットにおいて化合物の定量ピークのクロマトグラム、および関連の
結果を示します。
図 33. High-density report テンプレートの例
Thermo Scientific
TraceFinder Custom reports のチュートリアル
51
5
High Density Sample Report を作成する
レポートテンプレートを開く
High-density sample report を作成しながら、次の内容を紹介します :
• テンポラリシートでデータ表を使用する方法
• レポートに画像を追加する方法
• ランタイムで重複したデザインインターフェイスとして繰り返しエリアを使用する
方法
• 値を組み合わせる、または再フォーマットするためにデータ表で数式を使用する方
法
• マルチシートレポートを作成するためにシートを複製する方法
• [Start]> [Run] コマンドを使用してレポートを作成する方法
レポートテンプレートを開く
次の手順では、「入門ガイド」セクションで基本テンプレートとして作成した
ThermoCustomReportBaseTemplate.xltm ファイルを使用します。
 High density report テンプレートを開始するには
Windows エクスプローラで、ThermoCustomReportBaseTemplate.xltm ファイルのコピー
を作成し、新しいコピーに [MyHighDensitySampleReport1Long.xltm] と名前を付けま
す。
 テンプレートファイルをロードするには
1. Excel アプリケーションを開きます。
2. [Office] ボタン
をクリックし、次に [Open] を選択します。
3. [Open] ダイアログボックスで、[MyHighDensitySampleReport1Long.xltm] をダブルク
リックします。
ヒント このテンプレートファイルを Windows エクスプローラから開かないでくださ
い。編集のためにテンプレートを開く代わりに、このテンプレートに基づいた新し
いスプレッドシートを開くことになります。
52
TraceFinder Custom reports のチュートリアル
Thermo Scientific
5 High Density Sample Report を作成する
ラベルおよびマップされたノードを追加する
ラベルおよびマップされたノードを追加する
この時点で、テンプレートに静的列ヘッダーを作成して名前を付ける準備が完了してい
ます。
これらの手順に従います :
• レポートのタイトルに静的ラベルを入力するには
• [XML Source] パネルを表示するには
• 列ヘッダーに静的ラベルを入力するには
• テンプレートにマップされているフィールドを追加するには
 レポートのタイトルに静的ラベルを入力するには
1. セル B1 にレポートのタイトルを [High Density Sample Report 1 Long] と入力します。
2. セル B3 に [Lab name: ( ラボ名 :)] を入力します。
3. セル B4 に [Instrument: ( 装置 :)] を入力します。
4. セル B5 に [User: ( ユーザー :)] を入力します。
5. セル B6 に [Batch: ( バッチ :)] を入力します。
6. セル H3 に [Method: ( メソッド :)] を入力します。
7. セル H5 に [Cali File: ( キャリブレーションファイル :)] を入力します。
8. セル B1 から K5 を選択します。
9. 右クリックしてショートカットメニューから [Format Cells] を選択します。
[Format Cells] ダイアログボックスが開きます。
10. [Font] タブをクリックして [Font] ページを開きます。
図 34. [Format Cells] ダイアログボックスの [Font] ページ
Thermo Scientific
TraceFinder Custom reports のチュートリアル
53
5
High Density Sample Report を作成する
ラベルおよびマップされたノードを追加する
11. [Font Style] ボックスで、[Bold] を選択します。
12. [OK] をクリックします。
テンプレートが次の例と同様であることを確認します。
図 35. 静的ラベルのテンプレート
これで、[XML Source] パネルを表示する準備が完了しました。
ヒント 続行する前に、Excel ウィンドウが [Developer] タブを表示していることを確認
します。これはデフォルトでは非表示になっています。Excel ウィンドウが
[Developer] タブを表示していない場合、第 3 章、『入門ガイド』( 第 3 章 「入門ガイ
ド」) を参照してください。
54
TraceFinder Custom reports のチュートリアル
Thermo Scientific
5 High Density Sample Report を作成する
ラベルおよびマップされたノードを追加する
 [XML Source] パネルを表示するには
1. [Developer] タブをクリックしてすべての [Developer] 機能を表示させます。
2. [Source] ボタン
をクリックします。
スプレッドシートが [XML Source] パネルを表示します。マップされているノードを
[XML Source] パネルからスプレッドシートにドラッグできます。
任意のレポートにテンプレート作成を開始する前に、レポート上のデータポイントを確
認し、それらが [XML Source] のノードにマップされている方法を理解しておきます。
テンプレートが次の例と同様であることを確認します。
図 36. [XML Source] パネルを表示しているテンプレート
サンプルレベルのファイルリストには、一行しか含まれませんが、表フォーマットでは
読みやすさが向上します。TraceFinder のサンプルレベルのレポートのほとんどは、この
種類のファイルリストをレポートヘッダーの一部として使用します。
これで、アプリケーションがレポートヘッダーとして使用するファイルリストを追加す
る準備が完了しました。ファイルリストを作成するには、静的ラベルを追加して [XML
Source] パネルからノードをドラッグします。
 列ヘッダーに静的ラベルを入力するには
1. セル B8 に [Pos] を入力します。
2. セル C8 に [SampleID] を入力します。
3. セル F8 に [File Name] を入力します。
4. セル H8 に [Level] を入力します。
5. セル J8 に [Sample Name] を入力します。
6. セル M8 に [File Date] を入力します。
7. セル P8 に [Comment] を入力します。
8. セル B8 から P8 を選択します。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
55
5
High Density Sample Report を作成する
ラベルおよびマップされたノードを追加する
9. 右クリックしてショートカットメニューから [Format Cells] を選択します。
[Format Cells] ダイアログボックスが開きます。
10. [Font] タブをクリックして [Font] ページを開きます。
53 ページの『[Format Cells] ダイアログボックスの [Font] ページ』をご覧ください。
11. [Font Style] ボックスで、[Bold] を選択します。
12. [Underline] リストで、[Single] を選択します。
13. [OK] をクリックします。
これで、[XML Source] パネルを使用してマップされたフィールドをテンプレートに追加
する準備が完了しました。
補足 [XML Source] ツリーの「ノード」はスプレッドシートに「フィールド」を作成
します。
 テンプレートにマップされているフィールドを追加するには
1. [SampleCentricExportBatch/Samples/SampleCentricExportSample] フォルダからマップされ
たノードを追加するには、
[XML Source] ツリーから適切な表のセルにノードをドラッグします。
a. セル B9 に [VialPosition] ノードをドラッグします。
b. セル C9 に [SampleId] ノードをドラッグします。
c. セル F9 に [RawFileName] ノードをドラッグします。
d. セル A9 に [SampleLevel] ノードをドラッグします。
e. セル J9 に [SampleName] ノードをドラッグします。
f.
セル M9 に [AcquisitionDate] ノードをドラッグします。
g. セル P9 に [SampleComments] ノードをドラッグします。
2. セル H9 に、次の数式を入力します :
=IF(A9="", "N/A", A9)
この式は、A9 の [SampleLevel] が空の場合 (A 列は非表示列 )、表に N/A と表示し、そ
うではない場合、[SampleLevel] 値を表示するように伝えます。
補足 マップされた表で [XML Source] データフィールドを直接使用できないので、
通常、[Level] 列などの非表示列を最終レポートで追加します。フィールドが空の
場合、空欄にする代わりに N/A と表示させているため、この非表示列 は特別で
す。したがって、[XML Source] から単純にフィールドをドラッグすることはでき
ません。
56
TraceFinder Custom reports のチュートリアル
Thermo Scientific
5
High Density Sample Report を作成する
繰り返しエリアを作成する
テンプレートが次の例と同様であることを確認します。
図 37. ファイルリストを示すテンプレート
補足 本チュートリアルでは、提供されるレポートに可能な限り近いレイアウトを作
成します。同様の最終結果を得るために、様々な方法でセルをフォーマットできま
すが、列およびセルを調整して各自のビジネス要件に合ったプロレベルのレポート
を作成するには、多大な時間を要します。
繰り返しエリアを作成する
High density sample report は、サンプルの各化合物に同じ情報を繰り返します。
次の図は、各サンプルの必須情報を示します。
図 38. サンプルの必須情報
Thermo Scientific
TraceFinder Custom reports のチュートリアル
57
5
High Density Sample Report を作成する
繰り返しエリアを作成する
この場合 :
• 化合物の [Chromatogram ( クロマトグラム )] は、XML ファイルでバイト配列として
エクスポートされます。この画像は [SampleCentricExportBatch/Samples/
SampleCentricExportSample/Compounds/SampleCentricCompoundExportData/QuanResult/
QuanPeakResults/CompoundQuanPeakResultExportData/PeakImage] フォルダの定量ピーク
画像を示します。
• [Compound Name ( 化合物名 )] はライブラリで同定される完全名です。
• [Quan Mass ( 定量用 m/z)] は、定量ピークの質量対電荷比です。
• [Total Response ( トータルレスポンス )] は、[ResponseValue] により [Total Area ( 総面積 )]
または [Total Height ( 全体の高さ )] のどちらかになります。
• [Peak Response ( ピークレスポンス )] は、[ResponseValue] により [Peak Area ( ピーク面積 )]
または [Peak Height ( ピーク高さ )] のどちらかになります。定量ピークが一つの場合、
トータルレスポンスおよびピークレスポンスは同じ値を示します。
ピークが手動積分された場合、ラベル「M」がエントリーに表示されます。
• [Calculated Amount ( 定量値 )] は、サンプルタイプによりキャリブレーションレベル
値 (Cal Std サンプル ) または QC レベル値 (Chk Std サンプル ) のどちらかになります。
• [Calculated Amount ( 定量値 )] は、Cal Std サンプルのキャリブレーションレベル値で
す。
• [Calculated Amount ( 定量値 )] は、サンプルタイプによりキャリブレーションレベル
値 (Cal Std サンプル ) または QC レベル値 (Chk Std サンプル ) のどちらかになります。
• [Theoretical Amount ( 理論量 )] は、ターゲット化合物の定量結果の [Reported In Sample
Concentration ( サンプル濃度でレポート )] の値です。内標準化合物では、これはメ
ソッドで設定された量になります。
• [Quan Flag ( 定量フラグ )] は、定量ピークのフラグです。
58
TraceFinder Custom reports のチュートリアル
Thermo Scientific
5
High Density Sample Report を作成する
レポートに画像を追加する
レポートに画像を追加する
TraceFinder アプリケーションは、エクスポートされた XML ファイルで画像をバイト配列
として埋め込みます。 画像は通常大きすぎることから、Excel スプレッドシートは埋め
込み画像を直接扱うことができません。[XML Source] ツリーから画像ノードをドラッグ
する場合、画像のプレースホルダーとして作用する名前付き範囲を作成することができ
ます。ランタイムで、アプリケーションは VBA コードを介して画像を XML ファイルか
らプレースホルダーに直接ロードします。
ヒント エクスポートされた XML ファイルのすべての画像のファイル名には接尾辞
「Image」が付けられます。例えば、サンプルの TIC 画像は
[SampleTotalIonCurrentImage] となります。ノードがスプレッドシートにドラッグされ
る場合、アプリケーションがこれを適切に処理するように、この命名規則は、ノー
ドを画像ファイルとして特定します。
 テンプレートに画像ファイルを追加するには
1. [SampleCentricExportBatch/Samples/SampleCentricExportSample] フォルダを開き、
[SampleTotalIonCurrentImage] 画像ノードを [XML Source] ツリーから セル W14 にド
ラッグします。
[Edit Graphic] ダイアログボックスが開きます。
図 39. [Edit Graphic] ダイアログボックス
ダイアログボックスのツリービューは、画像ノードのみを一覧表示します。アプリ
ケーションは、現在選択されているツリーノードを強調表示します。
2. [Name for this graphic] ボックスに、デフォルトの名前を残します。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
59
5
High Density Sample Report を作成する
レポートに画像を追加する
3. [Range for this graphic] ボックスにおいて、デフォルトを [$B$10:$F$18] に変更します。
ヒント 範囲を入力することもできますが、[Range for this graphic] ボックスの隣の
ボタンをクリックしてスプレッドシートのセルを選択することもできます。
VBA コードはセルを直接参照できるので、画像に名前付き範囲のプレースホル
ダーを作成する必要はありません。しかし、画像に名前付き範囲を作成するとメ
ンテナンスがより簡単になります。
4. [OK] をクリックします。
次の VBA コードおよび [CreateImage] アドイン機能を使用すると、アプリケーション
は、ランタイムで画像をスプレッドシートにロードします :
mUtil.CreateImage NAMEDRANGEOFIMAGE, IMAGENODEPATH
この場合 :
• [NAMEDRANGEOFIMAGE] はデザイン時に作成した画像の名前付き範囲です。
• [IMAGENODEPATH] は、[XML Source] ツリーの画像ノードへの XPath です。
次のコードで、ピーク画像をこのレポートに挿入します :
mUtil.CreateImage mUtil.shiftRange("QuanChart" & cc, 0, offset, 0, offset),
"SampleCentricExportBatch/Samples/SampleCentricExportSample/Compounds/Sample
CentricCompoundExportData[CompoundKey='" & compKey &
"']/QuanResult/QuanPeakResults/CompoundQuanPeakResultExportData/PeakImage"
この例では、[ShiftRange] アドイン機能を介して、[NAMEDRANGEOFIMAGE] が各化
合物で動的に計算されます。[IMAGENODEPATH] は、XPath 表現を使用し、複合キー
に基づいて画像ノードを選択します。
補足 XPath (XML パス言語 ) は、ワールドウェブコンソーシアム (W3C) により定義さ
れており、XML 文書からノードを選択するための照会言語です。XPath に関する詳細
は、該当する外部文書を参照してください。
60
TraceFinder Custom reports のチュートリアル
Thermo Scientific
5
High Density Sample Report を作成する
レポートに画像を追加する
テンプレートが次の例と同様であることを確認します。
図 40. 画像フィールドを示すテンプレート
Thermo Scientific
TraceFinder Custom reports のチュートリアル
61
5
High Density Sample Report を作成する
テンポラリデータシートを作成する
テンポラリデータシートを作成する
このレポートではデータが事前に処理されなければならないので、Batch Report で行った
ようにデータを直接使用できません。VBA コードがレポートを作成するためにデータを
使用する前に、別のシートにデータを移し、数式を使用して、それらを組み合わせて再
フォーマットしていきます。
これらの手順に従います :
• テンポラリシートを作成するには
• テンプレートにマップされているノードを追加するには
• テンプレートでデータ表に名前を付けるには
 テンポラリシートを作成するには
1. [Sheet2] を右クリックしてショートカットメニューから [Rename] を選択します。
Excel アプリケーションは、編集中のシート名を強調表示します。
2. [tempSheet] と入力して [ENTER] を押します。
3. [Sheet3] を右クリックしてショートカットメニューから [Delete] を選択します。
4. [Confirmation ( 確認 )] ダイアログボックスで [Delete] をクリックします。
[tempSheet] をデータシートとして使用し、レポート作成時に使用される一時的なデータ
を保管します。レポート作成後、アプリケーションはこれを削除します。
[XML Source] ツリーから該当する表のセルにノードをドラッグして、
[SampleCentricExportBatch] フォルダからマップされたノードを追加し、データ表を作成
する準備が完了しました。
 テンプレートにマップされているノードを追加するには
1. [Samples/SampleCentricExportSample/Compounds] フォルダを開きます。
2. [SampleCentricCompoundExportData] フォルダを開き、次を行います :
a. セル A1 に [CompoundName] ノードをドラッグします。
b. セル B1 に [CompoundKey] ノードをドラッグします。
c. セル C1 に [ResponseValue] ノードをドラッグします。
3. [QuanResult] フォルダを開き、セル D1 に [TotalResponse] ノードをドラッグします。
4. [QuanResult/QuanPeakResults/CompoundQuanPeakResultExportData/ResultPeak]
フォルダを開き、次を行います :
a. セル E1 に [Area] ノードをドラッグします。
b. セル F1 に [ApexHeightAboveBaseLine] ノードをドラッグします。
5. [QuanResult/QuanPeakResults/CompoundQuanPeakResultExportData] フォルダを開き、セ
ル G1 に [ManualFlagSet] ノードをドラッグします。
6. [QuanResult/QuanPeakResults/CompoundQuanPeakResultExportData/ResultPeak]
フォルダを開き、セル H1 に [ApexRetentionTime] ノードをドラッグします。
62
TraceFinder Custom reports のチュートリアル
Thermo Scientific
5
High Density Sample Report を作成する
テンポラリデータシートを作成する
7. [SampleCentricCompoundExportData/QuanPeakIdentifiers/QuanPeakIdentifierExportData]
フォルダを開き、セル I1 に [DisplayRetentionTime] ノードをドラッグします。
8. [SampleCentricCompoundExportData] フォルダを開き、セル J1 に [LevelAmount] ノード
をドラッグします。
9. [QuanResult] フォルダを開き、セル K1 に [CalculatedAmount] ノードをドラッグしま
す。
10. [SampleCentricCompoundExportData] フォルダを開き、次を行います :
a. セル L1 に [Units] ノードをドラッグします。
b. セル M1 に [CompoundType] ノードをドラッグします。
c. セル N1 に [Amount] ノードをドラッグします。
11. [QuanResult] フォルダを開き、セル O1 に [ReportedInSampleConcentration] ノードを
ドラッグします。
12. [SampleCentricCompoundExportData] フォルダを開き、セル P1 に
[TotalExpectedRetentionTimes] ノードをドラッグします。
13. [SampleCentricCompoundExportData/QuanPeakIdentifiers/QuanPeakIdentifierExportData]
フォルダを開き、セル Q1 に [DisplayMassRange] ノードをドラッグします。
14. [QuanResult] フォルダを開き、次を行います :
a. セル R1 に [QuanFlags] ノードをドラッグします。
b. セル S1 に [Active] ノードをドラッグします。
c. セル T1 に [IsValidCompound] ノードをドラッグします。
これで、作成したデータ表の名前を付ける準備が完了しました。
 テンプレートでデータ表に名前を付けるには
1. [Formulas] タブをクリックして [Name Manager] をクリックします。
補足 Excel アプリケーションは、[Table1] または [Table2] などのすべての表の名前
を自動的に付けます。新しい表を作成するごとに、前のものを削除しても表の名
前を増やしていきます。
2. [Name Manager] ダイアログボックスで、[Table1] をダブルクリックします。
表の名前は異なる可能性があります。[Refers To] 列のシート、行、および列番号を使
用して表を確認します。
[Edit Name] ダイアログボックスが開きます。
3. デフォルトの名前を [DataTable] に変更します。
4. [OK] をクリックします。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
63
5
High Density Sample Report を作成する
テンポラリデータシートを作成する
次の例で示されているように、二つの名前が定義されています。
図 41. [Name Manager] ダイアログボックス
テンプレートが次の例と同様であることを確認します。
図 42. マップされたノードのテンプレート
いくつかの値は、ほとんどの場合、異なるフォーマットで、そして別のツリーノードま
たはレベルで、Custom report 作成を進めていくために一回以上エクスポートされます。
表示されている値が他のフィールドに依存する場合があり、すべてのロジックをスプ
レッドシートに移動することが不可能になる可能性があります。
[XML Source] から正しいデータポイントを見つけることに関するヘルプは、付録 B、
『Custom Report のアドイン API』を参照してください。
64
TraceFinder Custom reports のチュートリアル
Thermo Scientific
5
High Density Sample Report を作成する
繰り返しエリアでデータを使用する
繰り返しエリアでデータを使用する
繰り返しエリアでは、VBA コードを使用して投入されているフィールドと Excel アプリ
ケーション内で数式を使用して投入されているフィールドがあります。
このレポートでは、数式を二つのレベルで使用して各レベルのロジックを簡易化してい
ます。
• ファーストレベルの数式は、データ表レベルにあります。Excel アプリケーションで
は、数式列をデータ表に追加できます。数式はデータをデータ表にインポートする
ときに計算され、インポートされたデータ行ごとに展開されます。このレベルの数
式では、値を組み合わせたり、値を再フォーマットして表示できるようにしたりす
ることが可能です。
• セカンドレベルの数式は、繰り返しエリアに埋め込まれています。これは、[Excel
VLookup] 機能を使用して指定した化合物のデータ要素を取得します。
数式列はデータ表の任意の場所に追加できますが、このエクササイズでは、これらの列
をデータ表の始めに追加して [Excel VLookup] 機能 ( 列インデックスに基づく ) の使用を
簡易化しています。[Excel VLookup] 機能が作用するには、データ表の最初の列が「キー」
列でなければなりません。TraceFinder レポートでは、キーは化合物名になるので、
[CompoundName ( 化合物名 )] を最初の列に維持しなければなりません。
これで、データ表に列を追加する準備が完了しました。
これらの手順に従います :
• データ表で列を作成するには
• テンプレートのセルフォーマットを変更するには
• 列ヘッダーの名前を変更して数式を入力するには
• テンプレートで数式を指定するには
 データ表で列を作成するには
1. [CompoundType] セルを右クリックしてショートカットメニューから [Insert] > [Table
Columns to the Left] を選択します。
2. [Column1] から [Column7] のデフォルトの列名を使用するため、ステップ 1 を七回繰
り返します。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
65
5
High Density Sample Report を作成する
繰り返しエリアでデータを使用する
テンプレートが次の例と同様であることを確認します。
図 43. 列が挿入されたテンプレート
新しい列をデータ表に追加する場合、セルのフォーマットはデフォルトで [Text] になり
ます。このフォーマットでは、セルに入力する数式は Text ( 文字 ) として表示されます
( 計算された結果の代わりに、セルの等号と式に気が付くと思います )。Text の場合、
データがデータ表にインポートされた時に数式が展開しません。例 :
これで、セルフォーマットを [Text] から [General] に手動で変更する準備が完了しました。
 テンプレートのセルフォーマットを変更するには
1. [Column1] セルを選択します。
2. 右クリックしてショートカットメニューから [Format Cells] を選択します。
[Format Cells] ダイアログボックスが開きます。
66
TraceFinder Custom reports のチュートリアル
Thermo Scientific
5
High Density Sample Report を作成する
繰り返しエリアでデータを使用する
3. [Number] タブをクリックして [Number] ページを開きます。
図 44. [Format Cells] ダイアログボックスの [Number] ページ
4. [Category] リストで [General] を選択して [OK] をクリックします。
5. [Column1] セルが選択されている間に、[ENTER] を押します。
Excel アプリケーションは、新しいセルフォーマットを自動的に更新しません。
[ENTER] を押して手動で更新します。
6. 追加した七つの列ごとにステップ 1 から 4 を繰り返します。
[General] フォーマットのセルの数式 ( セルの始めに等号がない ) は、データがデータ表
にインポートされた場合、次の例が示すように展開します。
これで、列ヘッダーに名前を付ける準備が完了しました。
 列ヘッダーの名前を変更して数式を入力するには
1. セル B1 で、[Column1] を [QuanMass] に変更します。
2. セル B2 に、次の数式を入力します :
="Quan m/z:" & TEXT(S2, "0.00")
3. セル C1 で、[Column2] を [OverallResponse] に変更します。
4. セル C2 に、次の数式を入力します :
="Total " & J2 & ":" & ROUND(K2, 0)
5. セル D1 で、[Column3] を [PeakResponse] に変更します。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
67
5
High Density Sample Report を作成する
繰り返しエリアでデータを使用する
6. セル D2 に、次の数式を入力します :
="Peak" & J2 & ":" & ROUND(IF(J2="Area", L2, M2), 0) & IF(N2, "M", "")
7. セル E1 で、[Column4] を [RT] に変更します。
8. セル E2 に、次の数式を入力します :
="RT:" & TEXT(O2, "0.00") & " min (" & TEXT(P2, "0.00") & ")"
9. セル F1 で、[Column5] を [CalculatedAmount] に変更します。
10. セル F2 に、次の数式を入力します :
=IF(Q2="", "", "TAmount:" & TEXT(Q2, "0.000") & " " & U2)
11. セル G1 で、[Column6] を [TheoreticalAmount] に変更します。
12. セル G2 に、次の数式を入力します :
="Amount:" & IF(I2="Internal Standard", TEXT(N2, "0.000"), TEXT(V2, "0.000"))
& " " & U2
13. セル H1 で、[Column7] を [QuanFlag] に変更します。
14. セル H2 に、次の数式を入力します :
=IF(AC$1, Y2, "")
15. リファレンス列が正確かどうか数式を再度確認します。
テンプレートが次の例と同様であることを確認します。
図 45. 数式を示すテンプレート
これで、[Sheet1] の繰り返しエリアに数式を指定する準備が完了しました。
68
TraceFinder Custom reports のチュートリアル
Thermo Scientific
5
High Density Sample Report を作成する
繰り返しエリアでデータを使用する
 テンプレートで数式を指定するには
1. [Sheet1] タブをクリックします。
2. セル B19 から F26 を選択します。
3. [Home] タブをクリックして [Home] 機能を表示させます。
4. [Alignment] エリアで [Merge & Center] の横にある下矢印をクリックします。
図 46. セルを結合する
5. メニューから [Merge Cells] を選択します。
これらのセルを結合すると、各データ要素のスペースが広くなります。
アプリケーションはセル B19 から F19 を [Compound Name] に使用します。VBA コー
ドを使用して化合物名を設定します。繰り返しエリアのほかのフィールドは
[CompoundName] をリファレンスとして使用し、[tempSheet] の [DataTable] からデータ
を取得します。
6. セル B20 から F20 を選択し、[Quan Mass] の次の数式を入力します :
=IF(ISNA(VLOOKUP(B19, DataTable, 2, FALSE)), "",VLOOKUP(B19, DataTable, 2,
FALSE))
7. セル B21 から F21 を選択し、[Total Response] の次の数式を入力します :
=IF(ISNA(VLOOKUP(B19, DataTable, 3, FALSE)), "", VLOOKUP(B19, DataTable, 3,
FALSE))
8. セル B22 から F22 を選択し、[Peak Response] の次の数式を入力します :
=IF(ISNA(VLOOKUP(B19, DataTable, 4, FALSE)), "", VLOOKUP(B19,DataTable, 4,
FALSE))
9. セル B23 から F23 を選択し、[RT] の次の数式を入力します :
=IF(ISNA(VLOOKUP(B19, DataTable, 5, FALSE)), "", VLOOKUP(B19,DataTable, 5,
FALSE))
10. セル B24 から F24 を選択し、[Calculated Amount] の次の数式を入力します :
=IF(ISNA(VLOOKUP(B19, DataTable, 6, FALSE)), "", VLOOKUP(B19, DataTable, 6,
FALSE))
11. セル B25 から F25 を選択し、[Theoretical Amount] の次の数式を入力します :
=IF(ISNA(VLOOKUP(B19, DataTable, 7, FALSE)), "", VLOOKUP(B19, DataTable, 7,
FALSE))
12. セル B26 から F26 を選択し、[Quan Flag] の次の数式を入力します :
=IF(ISNA(VLOOKUP(B19, DataTable, 8, FALSE)), "", IF(VLOOKUP(B19, DataTable,
8, FALSE)=0, "", VLOOKUP(B19, DataTable, 8, FALSE)))
Thermo Scientific
TraceFinder Custom reports のチュートリアル
69
5
High Density Sample Report を作成する
繰り返しエリアでデータを使用する
[CompoundName] セルが空の場合は何も表示されないように、数式はデザインされてい
ます。
テンプレートが次の例と同様であることを確認します。
図 47. 繰り返しエリアの数式を示すテンプレート
繰り返しエリアのテンプレートが完了しました。これで、各化合物に対して、一行に四
つの化合物および一ページに三行の繰り返しエリアを複製する準備が完了しました ( 合
計で各ページに 12)。
70
TraceFinder Custom reports のチュートリアル
Thermo Scientific
5
High Density Sample Report を作成する
レイアウトを完了する
レイアウトを完了する
次の手順で、レイアウトを変更して名前付き範囲を作成します。
A 列を非表示にする準備が完了しています。
これらの手順に従います :
• [SampleLevel] 列を非表示にするには
• テンプレートで 19 行目を変更するには
• 結合セルの周りに境界線を追加するには
• 繰り返しエリアをコピーするには
• [QuanChart] 繰り返しエリアに名前を付けるには
• [CompoundName] の名前付き範囲を作成するには
• すべての [QuanChart] 範囲を含む名前付き範囲を作成するには
• [QuanChart] 列を調整するには
 [SampleLevel] 列を非表示にするには
A 列ヘッダーを右クリックして [Hide] をショートカットメニューから選択します。
ヒント Excel アプリケーションでは、いずれの列も非表示にできます。しかし、
TraceFinder Custom reports に非表示列が必要な場合、常に最初の列を使用します。
非表示列を表の中に配置した場合、繰り返しエリアにデータのブロックをコピー
する時に問題を引き起こします。
これで、結合セルでフォントを変更する準備が完了しました。
 テンプレートで 19 行目を変更するには
1. 19 行目の数字をクリックします。
2. 19 番目の行が元の高さの二倍になるまで、19 行目と 20 行目の間の水平セパレータ
をドラッグします。
ヒント 右のセパレータは列の幅を制御し、下のセパレータは行の高さを制御し
ます。
19 行目は高さが追加されたので、長い化合物名に対応できます。
3. 結合セルで文字が超過することを防ぐには、次を行います :
a. 結合セルを選択します。
b. 右クリックしてショートカットメニューから [Format Cells] を選択します。
[Format Cells] ダイアログボックスが開きます。
c. [Alignment] タブをクリックして [Alignment] ページを開きます。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
71
5
High Density Sample Report を作成する
レイアウトを完了する
図 48. [Format Cells] ダイアログボックスの [Alignment] ページ
d. [Text Control] エリアで、[Wrap Text] チェックボックスを選択します。
e. [Vertical ] リストで、[Top] を選択します。
f.
[Font] タブをクリックします。
g. [Font Style] ボックスで、[Bold] を選択します。
h. [OK] をクリックします。
これで、結合セルに境界線を追加する準備が完了しました。
72
TraceFinder Custom reports のチュートリアル
Thermo Scientific
5
High Density Sample Report を作成する
レイアウトを完了する
 結合セルの周りに境界線を追加するには
1. セル B10 から F26 を選択します。
2. [Home] タブをクリックして [Home] 機能を表示させます。
3. [Font] エリアで [Borders] アイコンの横にある下矢印をクリックします。
4. メニューから [Outside Borders] を選択します。
この境界線が化合物情報をグループ化します。
 繰り返しエリアをコピーするには
1. セル B10 から F26 を選択します。
セルを選択する場合、境界線エリアをクリックせずに、セル全体にわたりカーソル
をドラッグします。
2. 右クリックしてショートカットメニューから [Copy] を選択します。
3. セル G10 で右クリックしてショートカットメニューから [Paste] を選択します。
4. ステップ 3 をセル L10 と Q10 に対して繰り返します。
これで [QuanChart] 範囲に名前を付ける準備が完了しました。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
73
5
High Density Sample Report を作成する
レイアウトを完了する
 [QuanChart] 繰り返しエリアに名前を付けるには
1. セル B10 から F18 を選択します。
2. [Formulas] タブをクリックして [Define Name] をクリックします。
選択されたセル範囲は、[New Name] ダイアログボックスの [Refers To] ボックスに自
動的に表示されます。
3. [Name] ボックスで、[QuanChart1] と入力します。
4. [OK] をクリックします。
5. 次の値を使用してステップ 1 から 4 を繰り返します :
• セル G10 から K18 に、[QuanChart2] と入力します
• セル L10 から P18 に、[QuanChart3] と入力します
• セル Q10 から U18 に、[QuanChart4] と入力します
 [CompoundName] の名前付き範囲を作成するには
1. セル B19 を選択します。
2. [Formulas] タブをクリックして [Define Name] をクリックします。
選択されたセルは、[New Name] ダイアログボックスの [Refers To] ボックスに自動的
に表示されます。
3. [Name] ボックスで、[CompoundName1] を入力します。
4. [OK] をクリックします。
5. 次の値にステップ 1 から 4 を繰り返します :
• セル G19 に、[CompoundName2] を入力します
• セル L19 に、[CompoundName3] を入力します
• セル Q19 に、[CompoundName4] を入力します
74
TraceFinder Custom reports のチュートリアル
Thermo Scientific
5
High Density Sample Report を作成する
レイアウトを完了する
 すべての [QuanChart] 範囲を含む名前付き範囲を作成するには
1. セル B10 から U26 を選択します。
選択されたセルには、四つのすべての [QuanChart] 範囲が含まれます。
2. [Formulas] タブをクリックして [Define Name] をクリックします。
選択されたセルは、[New Name] ダイアログボックスの [Refers To] ボックスに自動的
に表示されます。
3. [Name] ボックスで、[RepeatArea] を入力します。
4. [OK] をクリックします。
この範囲を繰り返しエリアのシングルユニットとして扱います。
 [QuanChart] 列を調整するには
列のタイトルの仕切りをドラッグして、すべての列をページ範囲内にフィットさせ
ます。
ページプレビューモードにいる場合、点線がページの右の余白を示します。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
75
5
High Density Sample Report を作成する
レイアウトを完了する
テンプレートが次の例と同様であることを確認します。
図 49. 完成したテンプレートのデザイン
76
TraceFinder Custom reports のチュートリアル
Thermo Scientific
5 High Density Sample Report を作成する
VBA コードをテンプレートに追加するには
VBA コードをテンプレートに追加するには
テンプレートインターフェイスのデザインが完了です。これで VBA コードを追加して
データとインターフェイスを接続する準備が完了しました。
VBA コードを使用して、次を行います :
• 各シートを一ページにして必要な数のシートを作成し、各化合物の [RepeatArea] を設
定します。
補足 各化合物に対して [RepeatArea] を設定する方法には二種類あります :
• 同じシートに複数のコピーの [RepeatArea] を作成し、レポート全体を含む一
ページを作成します。
レポート全体を一シートで作成すると、パフォーマンスに悪影響を及ぼす可
能性があります。シートのサイズが大きくなるにつれて、Excel アプリケー
ションが遅くなる可能性があります。パフォーマンスを最適化するには、印
刷するページ数を 10 以下に制限します。
• ( 推奨 ) 各シートを一ページにし、必要な数のシートを作成します。
Excel アプリケーションは、各シートに小さいデータセットがある複数のシー
トを扱うほうにより優れています。
• 各シートに 12 個の化合物を配置し ( 印刷一ページになります )、必要な数のシートを
作成します。
• シートの最初の化合物名に基づいて各シートに名前を付けます。その場合、特殊文
字は削除して Excel アプリケーションのタブ名として適切な名前にします。
• シートをグループ化し、アドインコンポーネントを使用してシート全体にわたり
ページに連続的に番号を付けます。
• [Excel Sheet.Copy] 機能を使用してシートをコピーします。
[CopyPaste] アドイン機能を使用する
Excel アプリケーションの [CopyPaste] 機能は、データの移動に [Clipboard] を使用します。
これは、すべてのアプリケーションでシェアされているリソースです。本チュートリア
ルでは、他のアプリケーションとはデータをシェアしないものとします。
アドインコンポーネントの特別な [CopyPaste] 機能を使用して、[Clipboard] の使用を避け
るように設定します。セルデータのコピーおよび貼り付けを行いたい場合、Excel アプリ
ケーションの [CopyPaste] 機能の代わりに [CopyPaste] アドイン機能を使用します。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
77
5
High Density Sample Report を作成する
VBA コードをテンプレートに追加するには
[Module1] の VBA コード
「入門ガイド」の章で、[Module1] で二つの空の機能を作成しました :[ProcessData()] と
[Validate()] です。
• [Validate()] 機能は、XML データがインポートされる前に呼び出され、名前付き範囲
が完全であることを確認します。[Validate] は次のタイプの名前付き範囲を確認しま
す:
–
Required ( 必須 ): 必須の名前付き範囲がない場合、テンプレートは適切に動作し
ません。
–
Optional ( オプション ): オプションの範囲が欠けている場合、テンプレートはデ
フォルト値を使用します。例えば、[PageBreakEvery] はオプションの名前付き範囲
で、何行の [RepeatArea] を一ページに含むかを指定します。デフォルトでは、一
ページには三行あります。[RepeatArea] にさらにデータを追加し、各行に追加の
スペースが必要な場合、各ページが二行で構成されるようにセルの値を 2 に設定
して名前付き範囲を定義できます。
• [ProcessData()] 機能は、XML データがスプレッドシートにインポートされた後に呼び
出されます。
規則として、各シートのロジックコードは、[ProcessSheet1Data()] のように別の機能に
あります。
これで、フラグ記号に特別なフッターを作成する準備が完了しました。
これらの手順に従います :
• 特別なフッターを作成するには
• 各化合物に対して繰り返しエリアを複製するには
 特別なフッターを作成するには
1. [Developer] タブをクリックして [Developer] 機能を表示させます。
2. [Visual Basic]
をクリックします。
[Microsoft Visual Basic] ウィンドウが開きます。
3. [Project - VBAProject] パネルで、[MyUtil] をダブルクリックして
[MyHighDensitySampleReport1Long.xltm - MyUtil] ( コード ) ウィンドウを開きます。
4. [MyUtil] クラスモジュールで [IUtil_SetupPageFooter()] インターフェイス機能を次のよ
うに変更します。
変更前 :
Private Sub IUtil_SetupPageFooter()
mUtil.SetupPageFooter “”, 0.5
End Sub
変更後 :
Private Sub IUtil_SetupPageFooter()
mUtil.SetupPageFooter GetPageFooterText, 0.5
End Sub
78
TraceFinder Custom reports のチュートリアル
Thermo Scientific
5 High Density Sample Report を作成する
VBA コードをテンプレートに追加するには
[IUtil_SetupPageFooter()] 機能が、[Module1] で [GetPageFooterText] 機能を呼び出します。
これで、VBA コードを追加して複数の繰り返しエリアを作成する準備が完了しました。
 各化合物に対して繰り返しエリアを複製するには
1. [Project - VBAProject] パネルで、[Module1] をダブルクリックして
[MyHighDensitySampleReport1Long.xltm - Module1] ( コード ) ウィンドウを開きます。
2. [Module1] コードエディタのコードを次のコードに置き換えます :
Option Explicit
' Called after xml data gets imported
Public Sub ProcessData()
On Error GoTo ErrorHandler
mUtil.LogMsg "Processing - Start"
ProcessSheet1Data
mUtil.LogMsg "Processing - End"
Exit Sub
ErrorHandler:
MsgBox Err.Number & " - " & Err.Source & ":" & Err.Description,
vbCritical, "Process Data Error"
End Sub
Private Sub ProcessSheet1Data()
mUtil.LogMsg "Processing - Sheet1 - Start"
ActiveWorkbook.Sheets("Sheet1").Activate
Dim i As Long, j As Long, lstObj As ListObject, compName As String, offset
As Long, k As Long
Dim n As Long, h As Long, rr As Long, cc As Long, pageBreakEvery As Long,
compKey As String, nn As Long
' Setup page header/footer here once and it will be copied to all sheets
by Sheet.Copy.
' Otherwise, it's slow to set it up sheet by sheet.
' NOTE:To make this work, the page header/footer must meet certain
requirements.
mUtil.SkipSetupPageHeaderFooter = True
mIUtil.SetupPageHeader
mIUtil.SetupPageFooter
If
mUtil.GetXmlElement("SampleCentricExportBatch/Samples/SampleCentricExportSam
ple/ApplicationSampleType") <> "Breakdown" Then
pageBreakEvery = mUtil.GetValue("PageBreakEvery", 3)
h = Range("RepeatArea").Rows.Count
Thermo Scientific
' row height
TraceFinder Custom reports のチュートリアル
79
5
High Density Sample Report を作成する
VBA コードをテンプレートに追加するには
' First duplicate the RepeatArea to fill up the whole page
For i = 2 To pageBreakEvery
mUtil.CopyPaste "RepeatArea", Range("RepeatArea").offset((i - 1)
* h)
Next
Set lstObj = Worksheets("tempSheet").ListObjects("DataTable")
mUtil.LogMsg "Processing - Start - " & lstObj.Range.Rows.Count - 2 &
" Compounds"
For i = 2 To lstObj.Range.Rows.Count
If lstObj.ListColumns("Active").Range(i) And
lstObj.ListColumns("IsValidCompound").Range(i) And
lstObj.ListColumns("CompoundType").Range(i) <> "Native" And
lstObj.ListColumns("CompoundType").Range(i) <> "Breakdown" Then
n = n + 1
compName = lstObj.Range.Cells(i, 1)
If (n - 1) Mod 12 = 0 Then
If n > 1 Then
' Refresh the formula
Application.Calculate
' Turn formula into text because we will delete the
source data at the end
ActiveSheet.UsedRange.Value =
ActiveSheet.UsedRange.Value
End If
' Make a new sheet by copying it from Sheet1
Worksheets("Sheet1").Copy Before:=Worksheets("tempSheet")
' Set the sheet name to compound name for easier review
ActiveSheet.Name = mUtil.GetValidSheetName(compName)
nn = 0
End If
nn = nn + 1 ' tracks how many compounds in a sheet
rr = Int((nn - 1) / 4) + 1
' row number
cc = (n - 1) Mod 4 + 1
' column number
offset = (rr - 1) * h
Range("CompoundName" & cc).offset(offset) = compName
compKey = mUtil.VLookup(compName, Range("DataTable"), 11,
False)
mUtil.CreateImage mUtil.shiftRange("QuanChart" & cc, 0,
offset, 0, offset),
"SampleCentricExportBatch/Samples/SampleCentricExportSample/Compounds/Sample
CentricCompoundExportData[CompoundKey='" & compKey &
"']/QuanResult/QuanPeakResults/CompoundQuanPeakResultExportData/PeakImage"
If n Mod 10 = 0 Then mUtil.LogMsg "Processing - " & n & "th
Compound"
End If
80
TraceFinder Custom reports のチュートリアル
Thermo Scientific
5 High Density Sample Report を作成する
VBA コードをテンプレートに追加するには
Next
If nn > 0 Then
' Last sheet not finalized yet
Application.Calculate
' Turn formula into text
ActiveSheet.UsedRange.Value = ActiveSheet.UsedRange.Value
End If
mUtil.LogMsg "Processing - End"
End If
If n = 0 Then
mUtil.SetNoData "NoData"
Else
Sheets("Sheet1").Delete
End If
Sheets("tempSheet").Delete
mUtil.LogMsg "Processing - Sheet1 - End"
End Sub
Public Function GetPageFooterText() As String
If
mUtil.GetXmlElement("SampleCentricExportBatch/MethodHeaderData/ShowFlagsAndL
egend") Then
GetPageFooterText = "Flag legend:LOD<J<JOQ; I=Ion ratio failure;
C=Carryover; ?=Linearity limit; D=Detection limit; Q=Quan limit; POS=Rpt
limit; b=Blank; s=Solvent blank."
End If
End Function
' Validate the template design e.g. named ranges
Public Function Validate(Optional showWarning As Boolean = True) As Boolean
Dim err_msg As String, info_msg As String, msg As String
' Check required names
mUtil.CheckRequiredName err_msg, "RepeatArea", "The 'RepeatArea' is the named
range for repeating area."
mUtil.CheckRequiredName err_msg, "DataTable", "The 'DataTable' is the named
table including all compound data in TempSheet."
mUtil.CheckRequiredName err_msg, "QuanChart1", "The 'QuanChart1' is the
named cell for the first chart."
mUtil.CheckRequiredName err_msg, "QuanChart2", "The 'QuanChart2' is the
named cell for the second chart."
mUtil.CheckRequiredName err_msg, "QuanChart3", "The 'QuanChart3' is the
named cell for the third chart."
mUtil.CheckRequiredName err_msg, "QuanChart4", "The 'QuanChart4' is the
named cell for the fourth chart."
Thermo Scientific
TraceFinder Custom reports のチュートリアル
81
5
High Density Sample Report を作成する
VBA コードをテンプレートに追加するには
mUtil.CheckRequiredName err_msg, "CompoundName1", "The 'CompoundName1' is
the named cell for the compound name of the first chart."
mUtil.CheckRequiredName err_msg, "CompoundName2", "The 'CompoundName2' is
the named cell for the compound name of the second chart."
mUtil.CheckRequiredName err_msg, "CompoundName3", "The 'CompoundName3' is
the named cell for the compound name of the third chart."
mUtil.CheckRequiredName err_msg, "CompoundName4", "The 'CompoundName4' is the
named cell for the compound name of the fourth chart."
' Check optional names
mUtil.CheckOptionalNameOutsideOf err_msg, info_msg, "PageBreakEvery",
"RepeatArea", "Page break is set at every 3 rows as default."
' Display message if any
mUtil.ShowErrMsg err_msg, info_msg, showWarning
Validate = err_msg = ""
End Function
この場合 :
• [ProcessData()] は [ProcessSheet1Data] を呼び出し、エラー処理に使用されます。
• [ProcessSheet1Data] はこのレポートの本文を含みます :
–
[LogMsg] は、ログメッセージ、主にデバッギングに使用されるアドイン機能で
す。
–
[SetupPageHeader] および [SetupPageFooter] はアドイン機能で、各ページの区切り
で通常一回呼び出されます。本チュートリアルでは、[Excel Sheet.Copy] 機能を使
用してページ ( ヘッダーとフッターを含む ) を複製するので、これらの機能は必
要ありません。
–
最初の [IF] 命令文は、サンプルタイプが [Breakdown] タイプであるかを確認しま
す。High density sample report は、Breakdown ではないサンプルタイプにのみ有効
です。
–
[PageBreakEvery] が定義されていない場合、デフォルトで 3 になります。すなわ
ち、各ページに最大 3 行の [RepeatArea] を設定できます。
–
[RepeatArea] は次のように複製されます :
i.
[RepeatArea] を複製し、[CopyPaste] アドイン機能 ([Clipboard] を使用しません )
を使用してページ全体を埋めます。
ii. [DataTable] からデータを取得し、有効なコンポーネントをそれぞれ取り込み
ます。有効にするためには、化合物が選択されており、[isValidCompound] が
[True] で、化合物タイプが [Native] または [Breakdown] でなければなりません。
iii. [DataTable] からデータを取得し、有効なコンポーネントをそれぞれ取り込み
ます。有効にするためには、化合物が選択されており、[isValidCompound] が
[True] でなければなりません。
iv. 化合物名をシートに設定します ( 例えば、B19)。これにより、シート上の数
式が自動的に更新されます。[Application.Calculate] を呼び出して、シートを
コピーする前に数式を更新します。
82
TraceFinder Custom reports のチュートリアル
Thermo Scientific
5 High Density Sample Report を作成する
VBA コードをテンプレートに追加するには
v.
[Sheet.Copy] は、すべての数式を新しいシートにコピーします。
[ActiveSheet.UsedRange.Value] はそれ自体に割り当てられ、新しいシートで数
式を文字に変換してそれらをオリジナルのシートから切り離します。
vi. [Sheet.Copy] で新しいシートを作成します。
vii. [GetValidSheetName] はアドイン機能で、シート上の最初の化合物名に基づい
てシート名を割り当て、その名前が有効なタブ名であるかを確認します ( 化
合物名に無効な文字が含まれている場合があるため )。
viii. [CreateImage] はアドイン機能で、画像をスプレッドシートにロードします。
[CreateImage] は、XML ファイルから画像のバイト配列を取り込み、バイト配
列をビットマップ画像に変換し、画像を指定の名前付き範囲に移し、範囲内
にぴったりとはめ込むために画像をサイズ変更またはトリミングします。
ix. シートは、12 の化合物で埋められるとコピーされます。最後のページが完全
に埋められていない場合、特別な処理が必要です。
x. 表示するデータがない場合、コードが「このレポートにデータはありません」
が表示されていることを確認します。
xi. アプリケーションは、この処理中にテンプレートとして機能した [Sheet1] を
削除し、また処理後は必要ではなくなるため、[tempSheet] を削除します。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
83
5
High Density Sample Report を作成する
VBA コードをテンプレートに追加するには
• [GetPageFooterText] はフラグ記号を返し、ページフッターとして使用されます。
–
フッターの文字は各ページで同様であることから、[SkipSetupPageHeaderFooter]
が使用されます。
–
記号の表示 / 非表示は [ShowFlagsAndLegend] の設定に依存します。これは
[GetXmlElement] アドイン機能を使用して XML ソースファイルから直接取得され
ます。
• [Validate] は、これらの名前付き範囲を確認します :
–
[CheckRequiredName] はアドイン機能で、必須の名前付き範囲がワークブックに
存在しているかを確認します。名前付き範囲が欠けている場合、エラーメッセー
ジを指定できます。
–
[CheckOptionalNameOutsideOf ] はアドイン機能で、別の名前付き範囲外で名前付
き範囲が定義されているかを確認します。そうではない場合、警告メッセージが
デフォルト値を指定します。
–
エラーメッセージは、すべてのエラーおよび警告に対して蓄積され、一つのダイ
アログボックスに表示されます。例 :
3. エラーチェックに [Visual Basic] コンパイル機能を使用するには、[Debug] > [Compile
VBAProject] を選択します。
84
TraceFinder Custom reports のチュートリアル
Thermo Scientific
5
High Density Sample Report を作成する
テンプレートをテストする
テンプレートをテストする
この時点で、[Windows Start] > [Run] ボックスからテストを実行する準備が完了していま
す。このテストで、入力するコードが次を実行します :
• Excel アプリケーションを開きます。
• [MyHighDensitySampleReport1Long.xltm] テンプレートを使用して新しいワークブック
を作成します。
• パラメータをテンプレートに渡します。
• [4bw01_SampleCentricData.xml] ソースファイルに基づいてレポートを作成します。
• [MyHighDensitySampleReport1Long.xlsm] ファイルにレポートを保存します。
これらの手順に従います :
• テストを実行するには
• TraceFinder アプリケーションでテンプレートを使用するには
 テストを実行するには
1. [Start] > [Run] を選択します。
[Run] ダイアログボックスが開きます。
2. このコードを [Open] ボックスに入力します :
Excel.exe /n "C:\Thermo\Custom Report
Tutorials\MyHighDensitySampleReport1Long.xltm"
/x/C:\Thermo\Custom|Report|Tutorials\Data\4bw01_SampleCentricData.xml/C:\The
rmo\Custom|Report|Tutorials\Reports\MyHighDensitySampleReport1Long.xlsm/s/h
このコードで使用されるパラメータの詳細は、27 ページの『テンプレートをテスト
する』(27 ページの「テンプレートをテストする」) を参照してください。
作成されたレポートは、次の図のように画面に表示されます ( 使用したバッチにより、
実際のデータは異なる場合があります )。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
85
5
High Density Sample Report を作成する
テンプレートをテストする
図 50. レポートを作成する
これで、テンプレートを TraceFinder アプリケーションに統合する準備が完了しました。
86
TraceFinder Custom reports のチュートリアル
Thermo Scientific
5
High Density Sample Report を作成する
テンプレートをテストする
 TraceFinder アプリケーションでテンプレートを使用するには
1. 新しいテンプレートをアプリケーションの専用フォルダにコピーします。
C:\Thermo\Shared\Templates\Reports
2. このテンプレートを、TraceFinder アプリケーションの他の提供レポートと同様に使用
します。
Custom reports の使用方法の詳細は、TraceFinder ユーザーガイドを参照してください。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
87
6
Calibration Report を作成する
本章では、TraceFinder アプリケーションが提供する標準 Calibration Report と同様の
Calibration Report の Excel テンプレートを作成します。
内容
• レポートテンプレートを開く
• キャリブレーションの概要を作成する – Sheet1
–
多目的列について
–
派生列としてヘルパー列を追加するには
• データポイントを作成する – Sheet2
–
ピボットテーブルを作成するには
–
[Sheet2] テンプレートを作成する
• キャリブレーションファイルリストを作成する – Sheet3
–
VBA コードをテンプレートに追加するには
• テンプレートをテストする
TraceFinder アプリケーションの Calibration Report はバッチレベルのレポートで、バッチ
のキャリブレーション結果を示します。Calibration Report には、次の三つのセクション
が含まれます :
• キャリブレーションの概要データ
• 各化合物のキャリブレーションデータポイント
• キャリブレーションファイルのリスト
レポートの各セクションは、Excel スプレッドシートで別のシートに示されます。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
89
6
Calibration Report を作成する
図 51. [Sheet1] のテンプレート - キャリブレーションの概要データ
図 52. [Sheet2] のテンプレート - キャリブレーションデータポイント
90
TraceFinder Custom reports のチュートリアル
Thermo Scientific
6
Calibration Report を作成する
図 53. [Sheet3] のテンプレート - キャリブレーションファイル
Calibration Report を作成しながら、次の内容を紹介します :
• 列を追加、挿入、削除、または移動するためにデータ表で作業する方法
• データフィールドが一回しか参照されないという制限を対処するために同じフィー
ルドを複数回使用する方法
• クロスタブ ( ピボットテーブル ) レポートを作成する方法
• 表示用にデータをフィルターする方法
• 派生列および行の使用方法
任意のレポートにテンプレート作成を開始する前に、レポート上のデータポイントを確
認し、それらが [XML Source] のノードにマップされている方法を理解します。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
91
6
Calibration Report を作成する
レポートテンプレートを開く
レポートテンプレートを開く
次の段階的な手順では、「入門ガイド」セクションで基本テンプレートとして作成した
[ThermoCustomReportBaseTemplate.xltm] ファイルを使用します。
 High density report テンプレートを開始するには
[Windows Explorer] で、ThermoCustomReportBaseTemplate.xltm ファイルのコピーを作成
し、新しいコピーに [MyCalibrationReport.xltm] と名前を付けます。
 テンプレートファイルをロードするには
1. Excel アプリケーションを開きます。
2. [Office] ボタン
をクリックし、次に [Open] を選択します。
3. [Open] ダイアログボックスで、[MyCalibrationReport.xltm] をダブルクリックします。
ヒント このテンプレートファイルを Windows エクスプローラから開かないでくださ
い。編集のためにテンプレートを開く代わりに、このテンプレートに基づいた新し
いスプレッドシートを開くことになります。
92
TraceFinder Custom reports のチュートリアル
Thermo Scientific
6 Calibration Report を作成する
キャリブレーションの概要を作成する – Sheet1
キャリブレーションの概要を作成する – Sheet1
Calibration Report の [Calibration summary ( キャリブレーションの概要 )] ページには、次の
レポートに示されるように概要データのリストが含まれます。
図 54. Calibraiton summary ( キャリブレーション概要 ) Report
この場合 :
• [Compound] は化合物名です。
• 検量線が手動積分された場合、[Manually Integrated] は M の印が付けられます。そう
ではない場合、空欄になります。
• [*Curve Type] は利用可能な検量線の種類の一つを示します :
–
L (Linear ( 直線 ))
–
Q (Quadratic ( 二次曲線 ))
–
A (Average RF ( 平均 RF))
–
I (Internal Standard, 検量線はありません。)
• [A0/y-Intercept/Mean RF] は、多目的列です。この値は、検量線の種類に依存します。
• [A1/Slope] は、多目的列です。この値は、検量線の種類に依存します。
• [A2] は二次曲線の検量線の 種類にのみ使用されます。
• [R^2/R^2/%RSD] は、多目的列です。
• [Flag] はキャリブレーションフラグです。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
93
6
Calibration Report を作成する
キャリブレーションの概要を作成する – Sheet1
多目的列について
多目的列の内容は、検量線の種類の設定に依存します。
• Linear ( 直線 ) の検量線の種類では、検量線の方程式は y = A0 + A1 * x となり、この場
合、A0 列が y 切片で、A1 列がスロープになります。A2 列は空です。
• Quadratic ( 二次曲線 ) の検量線の種類では、検量線の方程式が y = A0 + A1 * x + A2 *
x^2 となります。三つのすべての列が使用されます。
• Average RF ( 平均 RF) の検量線の種類では、各化合物の検量線に一つの値があります。
最初の列のみが使用されます。Average RF ( 平均 RF) 値は、[ 検量線の作成方法 ] 設定
に依存します。
–
絶対検量線法の平均 RF:
[ 量 ] = ([ レスポンス ])/([ 測定上の RF])
–
内標準法の平均 RF:
[ 量 ] = ([ レスポンス ] * [ISTD 量 ])/([ISTD レスポンス ] * [ 測定上の RF])
• 直線または二次曲線の検量線では、四番目の列が [R^2] の値を示します。[ 平均 RF]
検量線では、四番目の列が [%RSD] の値を示します。
ロジックコードをスプレッドシート ( および VBA コード ) に配置すると、維持が困難に
なる可能性があります。この理由から、追加のデータポイントを Custom report で使用で
きるようにエクスポートしています。
[SampleCentricExportBatch/CalibrationData/CompoundCurveExportData]
フォルダの [CurveSummaryValue1]、[CurveSummaryValue2]、[CurveSummaryValue3]、
および [CurveSummaryValue4] 列は、この種類のシェアされた列を示します。
94
TraceFinder Custom reports のチュートリアル
Thermo Scientific
6 Calibration Report を作成する
キャリブレーションの概要を作成する – Sheet1
レポートヘッダーを作成する
このセクションでは、レポートヘッダーの静的ラベルを作成し、データノードを [XML
Source] ツリーからドラッグします。
これらの手順に従います :
• レポートのタイトルに静的ラベルを入力するには
• 列ヘッダーに静的ラベルを入力するには
• テンプレートにマップされているフィールドを追加するには
• テンプレートにマップされている表を追加するには
 レポートのタイトルに静的ラベルを入力するには
1. セル B1 に [Calibration Report] を入力します。
2. セル B1 から L1 を選択します。
3. 右クリックしてショートカットメニューから [Format Cells] を選択します。
[Format Cells] ダイアログボックスが開きます。
4. [Alignment] タブをクリックして [Alignment] ページを開きます。
図 55. [Format Cells] ダイアログボックスの [Alignment] ページ
5. [Horizontal] リストで、[Center] を選択します。
6. [Text Control] エリアで、[Merge cells] チェックボックスを選択します。
7. [OK] をクリックします。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
95
6
Calibration Report を作成する
キャリブレーションの概要を作成する – Sheet1
8. スプレッドシートで、次を行います :
a. セル A3 に [Lab name ( ラボ名 ):] を入力します。
b. セル A4 に [Instrument ( 装置 ):] を入力します。
c. セル A5 に [User ( ユーザー ):] を入力します。
d. セル A6 に [Batch ( バッチ ):] を入力します。
e. セル G3 に [Method ( メソッド ):] を入力します。
f.
セル G5 に [Cali File ( キャリブレーションファイル ):] を入力します。
9. [CTRL] キーを押したまま、作成したラベルセルを選択します。
10. 右クリックしてショートカットメニューから [Format Cells] を選択します。
[Format Cells] ダイアログボックスが開きます。
11. [Font] タブをクリックして [Font] ページを開きます。
図 56. [Format Cells] ダイアログボックスの [Font] ページ
12. [Font Style] ボックスで、[Bold] を選択します。
13. [OK] をクリックします。
テンプレートヘッダーはこのようになります :
96
TraceFinder Custom reports のチュートリアル
Thermo Scientific
6 Calibration Report を作成する
キャリブレーションの概要を作成する – Sheet1
 列ヘッダーに静的ラベルを入力するには
1. セル C8 に [Calibration Summary ( キャリブレーションの概要 )] を入力します。
2. セル C11 に [Compound ( 化合物 )] を入力します。
3. セル D10 に [Manually Integrated ( 手動積分 )] を入力します。
4. セル E10 に [Curve Type ( 検量線の種類 )] を入力します。
5. セル F9 に [A0 y-Intercept (y 切片 ) Mean RF] を入力します。
6. セル G9 に [A1 Slope ( スロープ )] を入力します。
7. セル H9 に [A2] を入力します。
8. セル I9 に [R^2 R^2 %RSD] を入力します。
9. セル C8 から I10 を選択します。
10. 右クリックしてショートカットメニューから [Format Cells] を選択します。
[Format Cells] ダイアログボックスが開きます。
11. [Font] タブが選択されていない場合、これをクリックします。
96 ページの『[Format Cells] ダイアログボックスの [Font] ページ』をご覧ください。
12. [Font Style] ボックスで、[Bold] を選択します。
13. [OK] をクリックします。
ヒント 続行する前に、Excel ウィンドウが [Developer] タブを表示していることを確認
します。これはデフォルトでは非表示になっています。Excel ウィンドウが
[Developer] タブを表示していない場合、第 3 章、
『入門ガイド』を参照してください。
任意のレポートにテンプレート作成を開始する前に、レポート上のデータポイントを確
認し、それらが [XML Source] ツリーのノードにマップされている方法を理解します。
補足 [XML Source] ツリーの「ノード」はスプレッドシートに「フィールド」を作成
します。
 テンプレートにマップされているフィールドを追加するには
1. [Developer] タブをクリックして [Developer] 機能を表示させます。
2. [Source] ボタン
をクリックします。
スプレッドシートが [XML Source] パネルを表示します。マップされているノードを
[XML Source] パネルからスプレッドシートにドラッグできます。[XML Source] ツリー
からノードを適切な表のセルにドラッグして、[SampleCentricExportBatch] フォルダの
ノードからマップされたフィールドを作成する準備が完了しました。
3. [MethodHeaderData] フォルダを開き、次を行います :
a. セル B3 に [LabName] ノードをドラッグします。
b. セル B4 に [InstrumentMethodName] ノードをドラッグします。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
97
6
Calibration Report を作成する
キャリブレーションの概要を作成する – Sheet1
4. [BatchHeaderData] フォルダを開き、次を行います :
a. セル B5 に [UserName] ノードをドラッグします。
b. セル B6 に [BatchName] ノードをドラッグします。
5. [MethodHeaderData] フォルダを開き、次を行います :
a. セル G3 に [MethodName] ノードをドラッグします。
b. セル G4 に [MasterMethodName] ノードをドラッグします。
6. [BatchHeaderData] フォルダを開き、セル G5 に [CalibrationFile] ノードをドラッグし
ます。
これで、マップされた表をテンプレートに追加する準備が完了しました。Excel アプリ
ケーションを使用して、[XML Source] パネルからマップされた表ノードをドラッグでき
ます。
 テンプレートにマップされている表を追加するには
[SampleCentricExportBatch/CalibrationData/CompoundCurveExportData] フォルダのノード
からマップされたフィールドを作成するには、
[XML Source] ツリーから適切な表のセルにノードをドラッグします。
a. セル A12 に [CompoundName] ノードをドラッグします。
b. セル D12 に [CurveSummaryValue1] ノードをドラッグします。
c. セル E12 に [CurveSummaryValue2] ノードをドラッグします。
d. セル F12 に [CurveSummaryValue3] ノードをドラッグします。
e. セル G12 に [CurveSummaryValue4] ノードをドラッグします。
98
TraceFinder Custom reports のチュートリアル
Thermo Scientific
6 Calibration Report を作成する
キャリブレーションの概要を作成する – Sheet1
テンプレートが次の例と同様であることを確認します。
図 57. マップされたフィールドのテンプレート
Thermo Scientific
TraceFinder Custom reports のチュートリアル
99
6
Calibration Report を作成する
キャリブレーションの概要を作成する – Sheet1
派生列としてヘルパー列を追加するには
このセクションでは、派生列として [CompoundType] および [HasActiveReplicates] の二つの
ヘルパー列を追加します。データ表のある列は、[CompoundType] および
[HasActiveReplicates] に依存しますが、これらは作成されたレポートで表示されません。
これらの手順に従います :
• テンプレートに二つの新しい列を追加するには
• テンプレートで派生列をマップするには
• テンプレートでヘルパー列を非表示にするには
• テンプレートに三つの新しい列を追加するには
• テンプレートのセルフォーマットを変更するには
• テンプレートで列ヘッダーの名前を変更するには ( オプション )
• テンプレートに数式を入力するには
• ヘルパー列および行を非表示にするには
• XML ファイルをテンプレートにインポートするには
• テンプレートの背景を変更するには
• [Compound Name ( 化合物名 )] 列を拡大するには
• テンプレートのヘッダー文字を調整するには
• [Mean RF ( 測定上の RF)] および [ %RSD] セルのデータの種類を変更するには
• レイアウトデザインを保存するには
 テンプレートに二つの新しい列を追加するには
1. A 列ヘッダーのセルを右クリックして [Insert] をショートカットメニューから選択し
ます。
2. ステップ 1 を繰り返して、新しい列を一つ追加します。
C 列から開始して、Excel アプリケーションはすべてのセルを右にシフトします。
3. [SampleCentricExportBatch/CalibrationData/CompoundCurveExportData] フォルダを開き、
次を行います :
a. [XML Source] ツリーから [CompoundType] ノードをセル B12 にドラッグします。
b. [XML Source] ツリーから [HasActiveReplicates] ノードをセル A12 にドラッグしま
す。
後の操作で、これらの列を非表示にし、数式を使用して表示用に値を作成します。
これで、マップされたフィールドをテンプレートに追加する準備が完了しました。
100
TraceFinder Custom reports のチュートリアル
Thermo Scientific
6 Calibration Report を作成する
キャリブレーションの概要を作成する – Sheet1
 テンプレートで派生列をマップするには
[SampleCentricExportBatch/CalibrationData/CompoundCurveExportData] フォルダからマッ
プされたフィールドを追加するには、[XML Source] ツリーから適切な表のセルにノー
ドをドラッグします。
a. セル C12 に [ManualFlagSet] ノードをドラッグします。
b. セル D12 に [CurveType] ノードをドラッグします。
c. セル E12 に [CalibrationFlags] ノードをドラッグします。
テンプレートが次の例と同様であることを確認します。
図 58. マップされた表のテンプレート
補足 静的ヘッダーとマップされたフィールドが正しく位置合わせされていませんが、
心配しないでください。次のセクションで、静的ヘッダーを正しい列に移動します。
 テンプレートでヘルパー列を非表示にするには
1. セル A1 から A11 を選択します。
セルのみを選択します。列全体を選択しないでください。
2. 右クリックしてショートカットメニューから [Insert] を選択します。
[Insert] ダイアログボックスが開きます。
3. [Shift Cells Right] オプションを選択して [OK] をクリックします。
4. ステップ 1 から 3 をさらに二回繰り返します。
この時点で、合計で五つの空の列があります : 追加した三つの列と、すでに設けられ
ていた二つです。列はセル 1 から 11 のみが空です。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
101
6
Calibration Report を作成する
キャリブレーションの概要を作成する – Sheet1
テンプレートが次の例と同様であることを確認します。
図 59. 五つの空の列を示すテンプレート
 テンプレートに三つの新しい列を追加するには
1. G12 セルを右クリックしてショートカットメニューから [Insert] > [Table Columns to
the Left] を選択します。
Excel アプリケーションは、G 列の左にデフォルト名が [Column1] の新しい列を追加
します。
2. G12 セルを右クリックしてショートカットメニューから [Insert] > [Table Columns to
the Left] を選択します。
Excel アプリケーションは、G 列の左にデフォルト名が [Column2] の新しい列を追加
します。
3. L12 セルを右クリックしてショートカットメニューから [Insert] > [Table Column to the
Right] を選択します。
Excel アプリケーションは、L 列の右にデフォルト名が [CurveSummaryValue5] ( 前の列
名に基づいて ) の新しい列を追加します。
この時点で、[Manually Integrated ( 手動積分 )]、[Curve Type ( 検量線の種類 )]、および
[Flag ( フラグ )] に使用するための三つの空の列があります。
新しい列をデータ表に追加する場合、セルのフォーマットはデフォルトで [Text] になり
ます。このフォーマットでは、セルに入力する数式は文字として表示されます。Text の
場合、データがデータ表にインポートされる時に数式が展開しません。
これで、セルフォーマットを [Text] から [General] に手動で変更する準備が完了しました。
102
TraceFinder Custom reports のチュートリアル
Thermo Scientific
6 Calibration Report を作成する
キャリブレーションの概要を作成する – Sheet1
 テンプレートのセルフォーマットを変更するには
1. [Column1] セルを右クリックしてショートカットメニューから [Format Cells] を選択
します。
[Format Cells] ダイアログボックスが開きます。
2. [Number] タブをクリックして [Number] ページを開きます。
図 60. [Format Cells] ダイアログボックスの [Number] ページ
3. [Category] リストで [General] を選択して [OK] をクリックします。
4. [Column1] セルが選択されている間に、[ENTER] を押します。
Excel アプリケーションは、新しいセルフォーマットを自動的に更新しません。
[ENTER] を押して手動で更新します。
5. 追加した三つの列ごとにステップ 1 から 5 を繰り返します。
次の手順で、列ヘッダーに意味のある名前を付けます。後でこのヘッダーは非表示にす
るので、この手順はオプションです。
 テンプレートで列ヘッダーの名前を変更するには ( オプション )
1. セル G10 で、[Column1] を [Manually Integrated ( 手動積分 )] に変更します。
2. セル H10 で、[Column2] を [Curve Type ( 検量線の種類 )] に変更します。
3. セル M11 で、[CurveSummaryValue5] を [Flag ( フラグ )] に変更します。
これで、列に数式を入力する準備が完了しました。
 テンプレートに数式を入力するには
1. セル G13 に、次の数式を入力します :
=IF(C13, "M", "")
2. セル H13 に、次の数式を入力します :
=IF(B13="Internal Standard", "I", LEFT(D13, 1))
Thermo Scientific
TraceFinder Custom reports のチュートリアル
103
6
Calibration Report を作成する
キャリブレーションの概要を作成する – Sheet1
3. セル M13 に、次の数式を入力します :
=IF(A13, IF(E13=0, "", E13), "")
[R^2] 列より下のフィールドは [ 平均 %RSD] 値であり、これはすべての RSD 値の平均に
なります。結果は、[SampleCentricExportBatch/CalibrationSummaryData/AverageRSD] ノード
のもとで XML ファイルにもエクスポートされます。Excel データ表は、データ表を展開
する場合、[ 平均 %RSD] 行を自動的に押し下げます。
これで、ヘルパー列および行を非表示にする準備が完了しました。
 ヘルパー列および行を非表示にするには
1. A 列から E 列を選択します。
2. 右クリックしてショートカットメニューから [Hide] を選択します。
3. 12 行目の列の最初の 12 の数字を右クリックし、ショートカットメニューから [Hide]
を選択します。
Excel アプリケーションは 12 行目を非表示にします。非表示の行の内容は、いつでも
復元できます。
12 行目の内容を復元するには、次を行います :
a. 11 行目から 13 行目を選択します。
b. 右クリックしてショートカットメニューから [Unhide] を選択します。
テンプレートが次の例と同様であることを確認します。
図 61. 完成した Sheet1
104
TraceFinder Custom reports のチュートリアル
Thermo Scientific
6 Calibration Report を作成する
キャリブレーションの概要を作成する – Sheet1
テンプレートの [Sheet1] は実行の準備が完了しました。
これで、データ表をテストするために XML ファイルを直接インポートする準備が完了
しました。このデータは保存しません。インポートされたデータがレポートでどのよう
に表示されるかをテストすることが目的です。
 XML ファイルをテンプレートにインポートするには
1. テンプレートを保存します。
ヒント [Import] 機能には [Undo] がありません。例えば、誤った .xml ファイルを
インポートするなど間違った場合に備えてテンプレートを保存します。
2. [Developer] タブをクリックして [Import] ボタンをクリックします。
[Import XML] ダイアログボックスが開きます。
3. Sample-centric data ファイルを選択し、[Import] をクリックします。
Excel アプリケーションは、スプレッドシートに .xml ファイルをインポートします。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
105
6
Calibration Report を作成する
キャリブレーションの概要を作成する – Sheet1
テンプレートが次の例と同様であることを確認します。
図 62. インポートされたデータを示すテンプレート
4. このバージョンのテンプレートを破棄し、インポート機能を実行する前に保存した
テンプレートを開きます。
データはランタイムで上書きされるので、インポートされたデータをテンプレート
に残してもレポート作成において問題になりません。
詳細な説明は、183 ページの『データをインポートした後にテンプレートから削除す
るには、どうすればよいですか？』を参照してください。
106
TraceFinder Custom reports のチュートリアル
Thermo Scientific
6 Calibration Report を作成する
キャリブレーションの概要を作成する – Sheet1
 テンプレートの背景を変更するには
1. データ表のヘッダーをクリックして [Design] タブを表示させます。
2. [Design] タブをクリックします。
[Design] タブは [Table Styles] 機能を表示します。
3. [Table Styles] ギャラリーを展開し、ギャラリーの左下にある [Clear]
リックします。
をク
背景がプレーンに変わります。
[Compound Name ( 化合物名 )] 列は大変狭いので、化合物名全体は表示されません。セル
の文字は、隣のセルが空である限り、そこに超過することができます。これで、
[Compound Name ( 化合物名 )] 列の後に空の列を導入する準備が完了しました。
補足 列全体を広くしても、データ表の上のセルのアライメントに影響を及ぼすので、
問題解決にはなりません。
 [Compound Name ( 化合物名 )] 列を拡大するには
1. [Compound Name] 列ヘッダーを右クリックして、ショートカットメニューから
[Insert] > [Table Columns to the Left] を選択し、空の列を挿入します。
Excel アプリケーションは、空のマップされていない列を表に挿入します。デフォル
トでは、新しい列は [Column1] と名前が付けられます。
2. セル G1 から G11 を選択します。
セルのみを選択します。列全体を選択しないでください。
3. 右クリックしてショートカットメニューから [Insert] を選択します。
[Insert] ダイアログボックスが開きます。
4. [Shift Cells Right] オプションを選択して [OK] をクリックします。
5. セル G3 から G6 を選択します。
6. 右クリックしてショートカットメニューから [Cut] を選択します。
7. セル F3 で右クリックしてショートカットメニューから [Paste] を選択します。
これらのヘッダー列の文字を左に移動することにより、文字がページを超過するこ
とを防ぎます。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
107
6
Calibration Report を作成する
キャリブレーションの概要を作成する – Sheet1
 テンプレートのヘッダー文字を調整するには
1. [Manually Integrated ( 手動積分 )] および [Curve Type ( 検量線の種類 )] のヘッダーセル
を選択します。
2. 右クリックしてショートカットメニューから [Format Cells] を選択します。
[Format Cells] ダイアログボックスが開きます。
3. [Alignment] タブをクリックして [Alignment] ページを開きます。
95 ページの『[Format Cells] ダイアログボックスの [Alignment] ページ』をご覧くださ
い。
4. [Horizontal] リストで、[Center] を選択します。
5. [OK] をクリックします。
[Mean RF ( 測定上の RF)] および [ %RSD] セルは、小数点以下 3 桁の数値フォーマットが
必要です。これで、これらのセルのデータの種類を変更する準備が完了しました。
 [Mean RF ( 測定上の RF)] および [ %RSD] セルのデータの種類を変更するには
1. J13 から M13 のセルを選択します。
セルのみを選択します。列全体を選択しないでください。
2. 右クリックしてショートカットメニューから [Format Cells] を選択します。
[Format Cells] ダイアログボックスが開きます。
3. [Number] タブをクリックして [Number] ページを開きます。
103 ページの『[Format Cells] ダイアログボックスの [Number] ページ』をご覧くださ
い。
4. [Category] リストで、[Number] を選択します。
5. [Decimal places] ボックスで、値を 3 に変更します。
108
TraceFinder Custom reports のチュートリアル
Thermo Scientific
6 Calibration Report を作成する
キャリブレーションの概要を作成する – Sheet1
 レイアウトデザインを保存するには
1. [Developer] タブをクリックして [Map Properties] をクリックします。
最初のマップが自動的に選択された状態で [XML Map Properties] ダイアログボックス
が開きます。
2. [Adjust Column Width] チェックボックスを解除します。
このオプションが選択されている場合、インポートされたデータにフィットするよ
うにフィールドが展開してしまい、レイアウトが変更されます。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
109
6
Calibration Report を作成する
キャリブレーションの概要を作成する – Sheet1
オプションで列のサイズを変更して、ページでの外観を最適化できます。データを再び
インポートする場合、テンプレートが次の例と同様であることを確認します。
図 63. 完成したレイアウトを示すテンプレート
テンプレートのデザインが完了です。このシートでは VBA コードは必要ありません。
110
TraceFinder Custom reports のチュートリアル
Thermo Scientific
6 Calibration Report を作成する
データポイントを作成する – Sheet2
データポイントを作成する – Sheet2
Calibration report の [Sheet2] は、それぞれのキャリブレータに対する各化合物の定量値を
示すデータのクロスタブ ( ピボットテーブル ) リストを含みます。
Custom report でこのシートを作成するには、アドイン機能を使用してクロスタブタイプ
のレポートを作成し、必要なパラメータを公開します。
ピボットテーブルの作成に関する詳細は、Excel アプリケーションの文書を参照してくだ
さい。
ピボットテーブルを作成するには
各化合物の定量値 ( ピボットデータポイント ) およびキャリブレータはこれらの要素に
依存します :
• 化合物タイプ (Compound type)
• 検量線の種類 (Curve type)
• マニュアルフラグ (Manual flag) ( 手動積分は量の計算方法に影響を及ぼします )
• サンプルレベル (Sample level) ( 列ヘッダーとして )
• 測定日 (Acquisition date) ( 並べ替え目的 )
• 予想保持時間 (Expected retention time) ( 並べ替え目的 )
• 除外の理由 (Exclusion reason) ( 値のフラグのため )
Calibration Report は、次のようなフラグを示すためにピボットテーブルを必要とします :
• 手動積分された検量線に「Manually Integrated ( 手動積分 )」
• 除外ポイントに「X」
• 内標準が検出されなかったことによる除外に「X(ISNF)」
Excel ピボットテーブルは、ピボットデータポイントとして数値とのみ連動します。本
チュートリアルでは、これらのデータポイントのピボットデータを特別な値に再フォー
マットして、ピボットテーブルが作成された後にテンプレートが別に処理できるように
します。
• [ 手動積分 ] フラグに対しては、手動積分ポイントであるため、データポイントを
「負」の値に変更します。データポイントは通常「正」の値であることから、ピボッ
ト選択後にこれらの値を簡単に同定することができます。
• X フラグに対しては、データポイントの値を大きな数に変更します ( 例 :
88 987 654 321)。この数は有効な値でなければなりませんが、実際のデータポイント
でないものとします。
• X(ISNF) フラグに対しては、データポイントの値を異なる大きい数に変更します。
( 例 : 9 987 654 321)。この数は有効な値でなければなりませんが、実際のデータポイ
ントでないものとします。
ヒント これらの大きい数は、測定値に基づきます。これらの数が、レポートの
実際の結果データと一致した場合、異なる数を使用します。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
111
6
Calibration Report を作成する
データポイントを作成する – Sheet2
[CreatePivotTable] 機能を使用する
次の [CreatePivotTable] アドイン機能を使用して、レポートのピボットテーブルを作成し
ます。
CreatePivotTable(dataTableName, targetRange, rowFields, columnFields,
valueFields, [pivotTableName])
この場合 :
• [dataTableName] は、ピボットテーブルが基本にするデータ表の名前付き範囲です。
• [targetRange] は、シートでピボットテーブルが位置する場所の名前付き範囲です。
• [rowFields] は、ピボットテーブルで行になる [Compound Name ( 化合物名 )] および
[Curve Type ( 検量線の種類 )] 列由来のセミコロン区切りの文字列です。
• [columnFields] は、ピボットテーブルで列になる [Acquisition Date ( 測定日 )] および
[Sample Level ( サンプルレベル )] 列由来のセミコロン区切りの文字列です。
• [valueFields] は、ピボットデータ値になる [Point Value ( ポイントの値 )] 列由来のセミ
コロン区切りの文字列です。
• [pivotTableName] は、ピボットテーブルの名前を指定するオプションの変数です。
[CreatePivotTable] アドイン機能は、次の二つのタスクを実行します :
• [ActiveWorkbook.PivotCaches.Create] および [ActiveSheet.PivotTables.AddDataField Excel] 機
能を使用して、ピボットテーブルを作成します。
• ピボットテーブルのデフォルトのスタイルと境界線を消去します。
フォーマット要件のため、ピボットテーブルをレポートで直接使うことはできません。
この機能を実行した後、Excel アプリケーションは一時的なシートにピボットテーブルを
作成します。[CopyPaste] アドイン機能を使用してデータをレポートシートにコピーしま
す。
Excel スプレッドシートで、[XML Source] の各ノードは、一回のみ使用できます。スプ
レッドシートですでにマップされているツリーノードをドラッグしようとすると、
「element has already been mapped and cannot be mapped more than once. ( エレメントはすでに
マップされており、一回以上マップできません。)」というエラーメッセージが表示され
ます。
この問題を回避するため、必要な数の XML マップを同じ [XML Source] ファイルに追加
できます。これにより、例えば [SampleCentricExportBatch_Map1] などの連続的に番号が
付けられた XML マップが作成されます。
112
TraceFinder Custom reports のチュートリアル
Thermo Scientific
6 Calibration Report を作成する
データポイントを作成する – Sheet2
[Sheet2] テンプレートを作成する
[XML Source] パネルでもう一つのマップを作成し、そのマップを使用してレポートのタ
イトルを作成します。
これらの手順に従います :
• XML マッピングファイルを追加するには
• レポートのタイトルに静的ラベルを入力するには
• テンプレートでクロスタブ表を作成するには
• テンプレートに二つのヘルパー列を追加するには
• [ProcessSheet2Data] アドイン機能を作成するには
• [Sheet2] にピボットテーブルをコピーするには
• レイアウトを完了するには
 XML マッピングファイルを追加するには
1. スプレッドシートの [XML Source] で、[XML Maps]
をクリックします。
[XML Maps] ダイアログボックスが開きます。
2. [Add] をクリックします。
3. XML マッピングファイル ( 前回使用したものと同様 ) を選択して [Open] をクリック
します。
Excel アプリケーションは、マッピングファイルを [This Workbook] リストの [XML
Maps] に追加します。これは、オリジナルのマッピングファイルの複製であることか
ら、ファイル名に数字の 1 が付けられます。
4. [OK] をクリックします。
インポートする .xml ファイルが一つしかないので、この .xml ファイルをインポートする
場合、アドインコンポーネントはすべてのマップを設定します。
重要 XML マップファイルの名前を変更しないでください。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
113
6
Calibration Report を作成する
データポイントを作成する – Sheet2
 レポートのタイトルに静的ラベルを入力するには
1. セル B1 にレポートのタイトル [Calibration Report] を入力します。
2. セル A3 に [Lab name ( ラボ名 ):] を入力します。
3. セル A4 に [Instrument ( 装置 ):] を入力します。
4. セル A5 に [User ( ユーザー ):] を入力します。
5. セル A6 に [Batch ( バッチ ):] を入力します。
6. セル F3 に [Method ( メソッド ):] を入力します。
7. セル F5 に [Cali File ( キャリブレーションファイル ):] を入力します。
8. [CTRL] キーを押したまま、作成したラベルセルを選択します。
9. 右クリックしてショートカットメニューから [Format Cells] を選択します。
[Format Cells] ダイアログボックスが開きます。
10. [Font] タブをクリックして [Font] ページを開きます。
96 ページの『[Format Cells] ダイアログボックスの [Font] ページ』をご覧ください。
11. [Font Style] ボックスで、[Bold] を選択します。
12. [OK] をクリックします。
テンプレートが次の例と同様であることを確認します。
図 64. 静的ラベルのテンプレート
114
TraceFinder Custom reports のチュートリアル
Thermo Scientific
6 Calibration Report を作成する
データポイントを作成する – Sheet2
 テンプレートでクロスタブ表を作成するには
1. [SampleCentricExportBatch/CalibrationData/CompoundCurveExportData] フォルダを開き、
[XML Source] ツリーから適切な表のセルにノードをドラッグします。
a. セル D1 に [CompoundName] ノードをドラッグします。
b. セル E1 に [CurveType] ノードをドラッグします。
c. セル F1 に [ManualFlagSet] ノードをドラッグします。
d. セル G1 に [SampleLevel] ノードをドラッグします。
2. [SampleCentricExportBatch/CalibrationData/CalibrationReplicates/SampleCompoundReplicateEx
portData] フォルダを開き、
[XML Source] ツリーから適切な表のセルにノードをドラッグします。
a. セル H1 に [AcquisitionDate] ノードをドラッグします。
b. セル I1 に [ExpectedRetentionTime] ノードをドラッグします。
c. セル J1 に [ExclusionReason] ノードをドラッグします。
d. セル K1 に [CurveDataPointValue] ノードをドラッグします。
[Curve Type ( 検量線の種類 )] および [Point Value ( ポイントの値 )] の二つのヘルパー列を
追加する準備が完了しました。
• レポートで種類の最初の文字のみが表示されるように、[Curve Type ( 検量線の種類 )]
列は再フォーマットが必要です :
– L (Linear ( 直線 ))
– Q (Quadratic ( 二次曲線 ))
– A (Average RF ( 平均 RF))
– I (Internal Standard, 検量線はありません。)
• [Point Value ( ポイントの値 )] 列には、ピボットテーブルで使用される準備ができた
データが含まれます。
 テンプレートに二つのヘルパー列を追加するには
1. A 列ヘッダーのセルを右クリックして [Insert] をショートカットメニューから選択し
ます。
2. ステップ 1 を繰り返して、新しい列を一つ追加します。
Excel アプリケーションはすべてのセルを右にシフトします。
3. B 列のデフォルトヘッダーを [Curve Type ( 検量線の種類 )] に変更します。
4. C 列のデフォルトヘッダーを [Point Value ( ポイントの値 )] に変更します。
5. セル B2 に、次の数式を入力します :
=IF(A2="Internal Standard", "I", LEFT(E2, 1))
6. セル C2 に、次の数式を入力します :
=IF(OR(J2="eISTDNotFound",J2= "eISTDManuallyExcluded"), 99987654321,
IF(J2="eManual", 88987654321, IF(F2, -K2, K2)))
これで、ピボットテーブルを処理する機能を追加する準備が完了しました。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
115
6
Calibration Report を作成する
データポイントを作成する – Sheet2
 [ProcessSheet2Data] アドイン機能を作成するには
1. [Developer] タブをクリックして [Developer] 機能を表示させます。
2. [Visual Basic]
をクリックします。
[Microsoft Visual Basic] ウィンドウが開きます。
3. [Module1] コードエディタに次のコードを入力します :
Public Sub ProcessData()
ProcessSheet2Data
End Sub
Private Sub ProcessSheet2Data()
Dim rng As Range
Set rng = mUtil.CreatePivotTable("DataTable", "TempSheet!O1",
"CompoundName;Curve Type", "AcquisitionDate;SampleLevel", "Point Value")
End Sub
この場合 :
[CreatePivotTable] は、[DataTable] に基づいてピボットテーブルを作成し ([TempSheet] の
データの名前付き範囲 )、セル [TempSheet!O1] を開始位置としたピボットテーブルを入
れます。
ピボットテーブルは、[CompoundName] および [CurveType] の列名を行のタイトルとし
て使用し、[AcquisitionDate] および [SampleLevel] を列ヘッダーとして使用し、
[PointValue] 列の値を使用します。
Custom report を作成する場合、次の例に示されるように、Excel スプレッドシートのオリ
ジナルのデータ表はピボットテーブルに置き換わります。
116
TraceFinder Custom reports のチュートリアル
Thermo Scientific
6 Calibration Report を作成する
データポイントを作成する – Sheet2
図 65. オリジナルのデータ表
Thermo Scientific
TraceFinder Custom reports のチュートリアル
117
6
Calibration Report を作成する
データポイントを作成する – Sheet2
図 66. ピボットテーブルに置き換わったデータ表
補足 2 行目の [AcquisitionDate ( 測定日 )] は並べ替え目的です。レポートでは必要あり
ません。
[TempSheet] のピボットテーブルには、Calibration Report の二ページ目に含ませるデータ
があります。
 [Sheet2] にピボットテーブルをコピーするには
[CopyPaste] アドイン機能を使用します。
Private Sub ProcessSheet2Data()
Dim rng As Range
Set rng = mUtil.CreatePivotTable("DataTable", "TempSheet!O1",
"CompoundName;Curve Type", "AcquisitionDate;SampleLevel", "Point Value")
mUtil.CopyPaste mUtil.ShiftRange(rng, 0, 2), "Sheet2!A11", False, True
End Sub
118
TraceFinder Custom reports のチュートリアル
Thermo Scientific
6 Calibration Report を作成する
データポイントを作成する – Sheet2
レポートを作成する場合、[Sheet2] は次の例のようになります :
図 67. 作成されたレポートの [Sheet2]
 レイアウトを完了するには
( オプション ) 列のサイズを調整してページでの外観を最適化します。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
119
6
Calibration Report を作成する
キャリブレーションファイルリストを作成する – Sheet3
キャリブレーションファイルリストを作成する – Sheet3
Calibration Report の最後のシートには、すべてのキャリブレーションサンプルタイプの
リストが含まれます。このリストに必要な情報は、各化合物ノードに埋め込まれている
ので、不必要なデータを除外しなければなりません。Excel フィルタ ? 機能を使用し、
[CompoundID] 列を派生ヘルパー列として追加することにより、このフィルターリスト
を作成します。このサンプルリストには、サンプルを測定日で並べ替えられるように
[Acquisition date] の派生列も含まれていなければなりません。
これらの手順に従います :
• レポートのタイトルに静的ラベルを入力するには
• テンプレートに XML マッピングファイルを追加するには
• テンプレートにマップされているフィールドを追加するには
 レポートのタイトルに静的ラベルを入力するには
1. セル B1 にレポートのタイトル [Calibration Report] を入力します。
2. セル B3 に [Lab name ( ラボ名 ):] を入力します。
3. セル B4 に [Instrument ( 装置 ):] を入力します。
4. セル B5 に [User ( ユーザー ):] を入力します。
5. セル B6 に [Batch ( バッチ ):] を入力します。
6. セル F3 に [Method ( メソッド ):] を入力します。
7. セル F5 に [Cali File ( キャリブレーションファイル ):] を入力します。
8. [CTRL] キーを押したまま、作成したラベルセルを選択します。
9. 右クリックしてショートカットメニューから [Format Cells] を選択します。
[Format Cells] ダイアログボックスが開きます。
10. [Font] タブをクリックして [Font] ページを開きます。
96 ページの『[Format Cells] ダイアログボックスの [Font] ページ』を参照してくださ
い。
11. [Font Style] ボックスで、[Bold] を選択します。
12. [OK] をクリックします。
これで、もう一つの XML マップを追加して [Sheet3] に使用する準備が完了しました。
120
TraceFinder Custom reports のチュートリアル
Thermo Scientific
6 Calibration Report を作成する
キャリブレーションファイルリストを作成する – Sheet3
 テンプレートに XML マッピングファイルを追加するには
1. スプレッドシートの [XML Source] で、[XML Maps]
をクリックします。
[XML Maps] ダイアログボックスが開きます。
2. [Add] をクリックします。
3. XML マッピングファイル ( 前回使用したものと同様 ) を選択して [Open] をクリック
します。
Excel アプリケーションは、マッピングファイルを [This Workbook] リストの [XML
Maps] に追加します。これは、オリジナルのマッピングファイルの二番目の複製ファ
イルであることから、ファイル名に数字の 2 が付けられます。
4. [OK] をクリックします。
インポートする .xml ファイルが一つしかないので、この .xml ファイルをインポートする
場合、アドインコンポーネントはすべてのマップを設定します。
これで、[SampleCentricExportBatch_Map2] ファイルからマップされたノードを追加する準
備が完了しました。
 テンプレートにマップされているフィールドを追加するには
1. [SampleCentricExportBatch/CalibrationReplicates/SampleCompoundReplicateExportData] フォ
ルダを開き、
[XML Source] ツリーから適切な表のセルにノードをドラッグします。
2. セル A8 に [AcquisitionDate] ノードをドラッグします。
3. セル B8 に [VialPosition] ノードをドラッグします。
4. セル C8 に [SampleId] ノードをドラッグします。
5. セル D8 に [RawFileName] ノードをドラッグします。
6. セル E8 に [SampleLevel] ノードをドラッグします。
7. セル F8 に [SampleName] ノードをドラッグします。
8. セル G8 に [FileDate] ノードをドラッグします。
9. セル H8 に [Comments] ノードをドラッグします。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
121
6
Calibration Report を作成する
キャリブレーションファイルリストを作成する – Sheet3
テンプレートが次の例と同様であることを確認します。
図 68. ヘッダーおよびマップされたフィールドを示すテンプレート
レイアウトを完了する
次の手順では、デフォルトの表ヘッダーの名前を変更し、マップされた表の名前を付
け、またレイアウトを完了する方法を説明します。
これらの手順に従います :
• マップされた表ヘッダー名を変更するには
• テンプレートで表に名前を付けるには
• テンプレートの背景を変更するには
 マップされた表ヘッダー名を変更するには
1. B8 を [VialPosition] から [Pos] に変更します。
2. C8 を [SampleId] から [Sample ID] に変更します。
3. D8 を [RawFileName] から [File Name] に変更します。
4. E8 を [SampleLevel] から [Level] に変更します。
5. F8 を [SampleName] から [Sample Name] に変更します。
6. G8 を [FileDate] から [File Date] に変更します。
7. H8 を [Comments] から [Comment] に変更します。
8. セル B8 から H8 を選択します。
122
TraceFinder Custom reports のチュートリアル
Thermo Scientific
6 Calibration Report を作成する
キャリブレーションファイルリストを作成する – Sheet3
9. [Vial Pos] セルを右クリックしてショートカットメニューから [Format Cells] を選択し
ます。
[Format Cells] ダイアログボックスが開きます。
10. [Font] タブをクリックして [Font] ページを開きます。
96 ページの『[Format Cells] ダイアログボックスの [Font] ページ』を参照してくださ
い。
11. [Font Style] ボックスで、[Bold] を選択します。
12. [Underline] リストで、[Single] を選択します。
13. [OK] をクリックします。
14. 列のサイズを調整して、幅を最適化した後も一ページで印刷できるように設定しま
す。
テンプレートが次の例と同様であることを確認します。
図 69. カスタムヘッダー文字を示したテンプレート
Excel 名前付き範囲機能を使用してテンプレートの表に名前を付ける準備が完了しまし
た。セルの範囲に名前を付けることで、このエリアを参照する時に、その名前を使用で
きます。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
123
6
Calibration Report を作成する
キャリブレーションファイルリストを作成する – Sheet3
 テンプレートで表に名前を付けるには
1. [Formulas] タブをクリックして [Name Manager] をクリックします。
補足 Excel アプリケーションは、[Table1] または [Table2] などのすべての表の名前
を自動的に付けます。新しい表を作成するごとに、前のものを削除しても表の名
前をインクリメントします。
2. [Name Manager] ダイアログボックスで、[Table1] をダブルクリックします。
表の名前は異なる可能性があります。[Refers To] 列のシート、行、および列番号を使
用して表を確認します。
[Edit Name] ダイアログボックスが開きます。
3. デフォルトの名前を [DataTableFileList] に変更します。
4. [OK] をクリックします。
5. [Name Manager] ダイアログボックスで [Close] をクリックします。
これで、テンプレートのレイアウトを仕上げる準備が完了しました。
 テンプレートの背景を変更するには
1. データ表のヘッダーをクリックして [Design] タブを表示させます。
2. [Design] タブをクリックします。
[Design] タブは [Table Styles] 機能を表示します。
3. [Table Styles] ギャラリーを展開し、ギャラリーの左下にある [Clear]
リックします。
をク
背景がプレーンに変わります。
4. A 列ヘッダー ([AcquisitionDate]) を右クリックして [Hide] をショートカットメニュー
から選択します。
補足 Excel スプレッドシートでは、いずれの列も非表示にできます。しかし、
TraceFinder Custom reports に派生列が必要な場合は、常に最初の列を使用します。
派生列を表の中に配置した場合、繰り返しエリアにデータブロックをコピーする
時に問題を引き起こす可能性があります。
124
TraceFinder Custom reports のチュートリアル
Thermo Scientific
6 Calibration Report を作成する
キャリブレーションファイルリストを作成する – Sheet3
VBA コードをテンプレートに追加するには
これで VBA コードを使用してテンプレートにフィルタ ? 機能を追加する準備が完了しま
した。
 テンプレートに [Acquisition Date ( 測定日 )] フィルター機能を追加するには
1. [Developer] タブをクリックして [Developer] 機能を表示させます。
2. [Visual Basic]
をクリックします。
[Microsoft Visual Basic] ウィンドウが開きます。
3. VBA プロジェクトを右クリックして、ショートカットメニューから [Insert] >
[Module] を選択します。
アプリケーションは、プロジェクトの [Module] フォルダにモジュールを追加し、
コードエディタを開きます。
4. モジュールのコードエディタに次のコードを入力します :
Public Sub ProcessData()
ProcessSheet2Data
ProcessSheet3Data
End Sub
Private Sub ProcessSheet3Data()
ActiveWorkbook.Sheets("Sheet3").Activate
Range("DataTableFileList").AutoFilter Field:=1, Criteria1:=Cells(9, 1)
mUtil.SortList "DataTableFileList", "AcquisitionDate"
End Sub
[Visual Basic] コードが次の例と同様であることを確認します :
図 70. VBA データ
このコードと RawFileName_SampleCentricData.xml ファイルを使用して、テンプレートを
実行する準備が完了しました。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
125
6
Calibration Report を作成する
テンプレートをテストする
テンプレートをテストする
この時点で、[Windows Start] > [Run] ボックスからテストを実行する準備が完了していま
す。このテストで、入力するコードが次を実行します :
• Excel アプリケーションを開きます。
• [MyCalibrationReport.xltm] テンプレートを使用して新しいワークブックを作成します。
• パラメータをテンプレートに渡します。
• [level5_SampleCentricData.xml] ソースファイルに基づいてレポートを作成します。
• [MyCalibrationReport.xlsm] ファイルに、このレポートを保存します。
これらの手順に従います :
• テストを実行するには
• TraceFinder アプリケーションでテンプレートを使用するには
 テストを実行するには
1. [Start] > [Run] を選択します。
[Run] ダイアログボックスが開きます。
ヒント デフォルトでは、TraceFinder アプリケーションファイルは長いファイルパ
スになってしまいます。Windows の [Run] ダイアログボックスが 256 文字に制限
します。この制限に対処するには、ファイルをルートディレクトリに近いフォル
ダにコピーするか、バッチファイルにコマンドラインを置きます。
2. このコードを [Open] ボックスに入力します :
Excel.exe /n "C:\Thermo\Custom Report Tutorials\MyCalibrationReport.xltm"
/x/C:\Thermo\
Custom|Report|Tutorials\Data\level5_SampleCentricData.xml/C:\Thermo\
Custom|Report|Tutorials\Reports\MyCalibrationReport.xlsm/s/h
このコードで使用されるパラメータの詳細は、27 ページの『テンプレートをテスト
する』を参照してください。
作成されたレポートは、次の例と同様になります ( 使用したバッチにより、実際のデー
タは異なる場合があります ):
126
TraceFinder Custom reports のチュートリアル
Thermo Scientific
6
Calibration Report を作成する
テンプレートをテストする
図 71. 作成されたレポート
これで、テンプレートを TraceFinder アプリケーションに統合する準備が完了しました。
 TraceFinder アプリケーションでテンプレートを使用するには
1. 新しいテンプレートをアプリケーションの専用フォルダにコピーします。
C:\Thermo\Shared\Templates\Reports
2. このテンプレートを、TraceFinder アプリケーションの他の提供レポートと同様に使用
します。
Custom reports の使用方法の詳細は、TraceFinder ユーザーガイドを参照してください。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
127
7
DCC Report を作成する
本章では、TraceFinder アプリケーションが提供する Steroid Analysis Report と同様の
Doping Control Center Report ( ドーピングコントロールセンターレポート ) の Excel テンプ
レートを作成します。
内容
• レポートテンプレートを開く
• レポートヘッダーを作成する
• 画像エリアを作成する
• データエリアを作成する
• 派生データを追加する
• ページフッターを作成する
• 化合物のマッピング表を作成する
• データ表を作成するには
• VBA コードを追加する
• テンプレートをテストする
DCC Report は、一般的にドーピングコントロールセンターで使用される、特定のメソッ
ドに関連する特別な Custom report です。
DCC Report は他のレポートと異なり、標準のヘッダーおよびフッターを使用しません。
このレポートのテンプレートを作成するには、付属のアドインフレームワークおよび
Excel 数式機能を使用して、数式を任意のビジネスニーズに適合させます。
DCC Report の機能には次が含まれます :
• 高度に要約された、シングルページのサンプルレベル概要レポート
• 約 26 種類の化合物の特定メソッド ( 次の例では最大 28 種類 )
• レポートの上部に表示されるクロマトグラム ( その下に化合物および関連データがあ
ります。)
• 指定の順序で表示される化合物 ( このメソッドでは、特別な並べ替えに適合するよう
に化合物名の始めに Z または ZZ が付けられています。実際のレポートでは追加の
マッピング表を使用して、これらの接頭語を削除します。)
• レポートの下に表示される、化合物関連データおよびこのデータに基づく計算値
Thermo Scientific
TraceFinder Custom reports のチュートリアル
129
7
DCC Report を作成する
図 72. DCC Report の例
DCC Report を作成しながら、次の内容を紹介します :
• ヘッダー、フッター、およびその他の静的オブジェクトの作成方法
• アドインフレームワークを使用せずに特定のヘッダーおよびフッターを作成する方
法
• 化合物名を表示する化合物のマッピング表を作成する方法
• 数式で参照記号を使用する方法
• 化合物関連情報のデータ表を維持したまま [TempSheet] を使用する方法
• データをインポートした後に、化合物名でデータ表を並べ替える方法
130
TraceFinder Custom reports のチュートリアル
Thermo Scientific
7 DCC Report を作成する
レポートテンプレートを開く
• 各化合物を繰り返し、化合物のマッピング表を通して表示名を検出し、それを表示
ページにコピーし、また化合物の画像エリアを作成するテンプレートを作成する方
法
任意のレポートにテンプレート作成を開始する前に、レポート上のデータポイントを確
認し、それらが [XML Source] のノードにマップされている方法を理解します。
レポートテンプレートを開く
次の段階的な手順では、「入門ガイド」セクションで基本テンプレートとして作成した
[ThermoCustomReportBaseTemplate.xltm] ファイルを使用します。
 DCC Report テンプレートを開始するには
[Windows エクスプローラ ] で、[ThermoCustomReportBaseTemplate.xltm] ファイルのコ
ピーを作成し、新しいコピーに [MyDCCReport.xltm] と名前を付けます。
 テンプレートファイルをロードするには
1. Excel アプリケーションを開きます。
2. [Office] ボタン
をクリックし、次に [Open] を選択します。
3. [Open] ダイアログボックスで、[MyDCCReport.xltm] をダブルクリックします。
ヒント このテンプレートファイルを [Windows エクスプローラ ] から開かないでくだ
さい。編集のためにテンプレートを開く代わりに、このテンプレートに基づいた新
しいスプレッドシートを開くことになります。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
131
7
DCC Report を作成する
レポートヘッダーを作成する
レポートヘッダーを作成する
このレポートでは同じページに異なるレイアウトの多くのセクションが存在するので、
小さい列を多く設けることで調整を簡易化します。Excel アプリケーションを使用して一
つのセルから次のセルまで ( セルが空である場合 ) 文字を表示できます。
このセクションでは、レポートヘッダーの静的ラベルを作成し、データノードを [XML
Source] ツリーからドラッグします。
 レポートのタイトルに静的ラベルを入力するには
1. セル A3 に [Data File:] を入力します。
2. セル A4 に [Sple Name:] を入力します。
3. セル A5 に [Inj Vol:] を入力します。
4. セル A6 に [Inst Meth:] を入力します。
5. セル G5 に [Dil Factor:] を入力します。
6. セル G6 に [Proc Mtd.:] を入力します。
7. セル M3 に [Cali File:] を入力します。
8. セル M4 に [Instr.:] を入力します。
9. セル M5 に [Vial:] を入力します。
10. セル M6[Acqu.Date:] を入力します。
11. [CTRL] を押したままで、作成したラベルセルを選択します。
12. 右クリックしてショートカットメニューから [Format Cells] を選択します。
[Format Cells] ダイアログボックスが開きます。
132
TraceFinder Custom reports のチュートリアル
Thermo Scientific
7 DCC Report を作成する
レポートヘッダーを作成する
13. [Font] タブをクリックして [Font] ページを開きます。
図 73. [Format Cells] ダイアログボックスの [Font] ページ
14. [Font Style] ボックスで、[Bold] を選択します。
15. [OK] をクリックします。
これで、[SampleCentricExportBatch] フォルダからマップされたノードを追加する準備が
完了しました。
補足 [XML Source] ツリーの「ノード」はスプレッドシートに「フィールド」を作成
します。
 テンプレートにマップされているフィールドを追加するには
1. [Developer] タブをクリックして [Developer] 機能を表示させます。
ヒント デフォルトで非表示になっている [Developer] タブを有効にする手順につ
いては、第 3 章、『入門ガイド』を参照してください。
2. [Source]
をクリックします。
スプレッドシートが [XML Source] パネルを表示します。マップされているノードを
[XML Source] パネルからスプレッドシートにドラッグできます。
3. [SampleCentricExportBatch] フォルダを開き、[XML Source] ツリーから適切な表のセル
にノードをドラッグします。
a. [MethodHeaderData] フォルダを開き、セル R1 に [LabName] ノードをドラッグし
ます。
b. [Samples/SampleCentricExportSample] フォルダを開き、セル C3 に [RawFileName]
ノードをドラッグします。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
133
7
DCC Report を作成する
レポートヘッダーを作成する
c. [Samples/SampleCentricExportSample] フォルダを開き、セル C4 に [SampleName]
ノードをドラッグします。
d. [Samples/SampleCentricExportSample] フォルダを開き、セル C5 に [InjectionVolume]
ノードをドラッグします。
e. [MethodHeaderData] フォルダを開き、セル C6 に [InstrumentMethodName] ノード
をドラッグします。
f.
[Samples/SampleCentricExportSample] フォルダを開き、セル I5 に [ConversionFactor]
ノードをドラッグします。
g. [MethodHeaderData] フォルダを開き、セル I6 に [MethodName] ノードをドラッグ
します。
h. [MethodHeaderData] フォルダを開き、セル O3 に [CalibrationFile] ノードをドラッ
グします。
i.
[MethodHeaderData] フォルダを開き、セル O4 に [InstrumentName] ノードをド
ラッグします。
j.
[Samples/SampleCentricExportSample] フォルダを開き、セル O5 に [VialPosition]
ノードをドラッグします。
k. [Samples/SampleCentricExportSample] フォルダを開き、セル O6 に [AcquisitionDate]
ノードをドラッグします。
テンプレートが次の例と同様であることを確認します。
図 74. ヘッダーセルを示すテンプレート
134
TraceFinder Custom reports のチュートリアル
Thermo Scientific
7
DCC Report を作成する
画像エリアを作成する
画像エリアを作成する
次の例に示されるように、各化合物に対して、定量ピーククロマトグラム、クロマトグ
ラムの下に化合物名、および右に凡例が表示されなければなりません。
図 75. DCC Report で表示される化合物データ
この画像エリアを作成するには、三つの名前付き範囲を定義します :
• セル A7 から D11 に画像を表示するための [QuanChart]
• セル A12 に化合物名を表示するための [CompoundName]
• セル E7 から E12 に凡例を表示するための [ChartLegend]
この DCC Report テンプレートを作成するには、このエリアを 28 回複製します。
[ShiftRange] 機能を使用して各化合物範囲を動的に計算し、値が設定された後に VBA
コードを使用して [ChartLegend] セルを結合します。
これらの手順に従います :
• テンプレートで [QuanChart] 名前付き範囲を作成するには
• テンプレートでセルを結合するには
• テンプレートで [CompoundName] 名前付き範囲を作成するには
• テンプレートで [ChartLegend] 名前付き範囲を作成するには
• セル範囲に境界線を追加するには
• [QuanChart] セル範囲を水平にコピーするには
• [QuanChart] セル範囲を垂直にコピーするには
• [ChartLegend] 列を調整するには
• [QuanChart] 列を調整するには
• 行の高さを調整するには
Thermo Scientific
TraceFinder Custom reports のチュートリアル
135
7
DCC Report を作成する
画像エリアを作成する
 テンプレートで [QuanChart] 名前付き範囲を作成するには
1. セル A7 から D11 を選択します。
2. [Formulas] タブをクリックして [Define Name] をクリックします。
アプリケーションは、[New Name] ダイアログボックスの [Refers To] ボックスで選択
されたセルの範囲を表示します。
3. [Name] ボックスで、[QuanChart] と入力します。
4. [OK] をクリックします。
これでセルを結合する準備が完了しました。
 テンプレートでセルを結合するには
1. セル A7 から D11 を選択します。
2. [Home] タブをクリックして [Home] 機能を表示させます。
3. [Alignment] エリアで [Merge & Center] 下矢印をクリックします。
4. メニューから [Merge Cells] を選択します。
これで、化合物の名前付き範囲を作成する準備が完了しました。
136
TraceFinder Custom reports のチュートリアル
Thermo Scientific
7
DCC Report を作成する
画像エリアを作成する
 テンプレートで [CompoundName] 名前付き範囲を作成するには
1. セル A12 を選択します。
2. [Formulas] タブをクリックして [Formulas] 機能を表示させます。
3. [Defined Names] エリアで [Define Name] をクリックします。
選択されたセルは、[New Name] ダイアログボックスの [Refers To] ボックスに自動的
に表示されます。
4. [Name] ボックスで、[CompoundName] を入力します。
5. [OK] をクリックします。
これで凡例の名前付き範囲を作成し、文字を範囲の下から上まで調整する準備が完了し
ました。
 テンプレートで [ChartLegend] 名前付き範囲を作成するには
1. セル E7 から E12 を選択します。
2. [Formulas] タブをクリックして [Define Name] をクリックします。
選択されたセル範囲は、[New Name] ダイアログボックスの [Refers To] ボックスに自
動的に表示されます。
3. [Name] ボックスで、[ChartLegend] を入力します。
4. [OK] をクリックします。
5. [ChartLegend] セル範囲のセル ( セル A7 から D11) を選択します。
6. 右クリックしてショートカットメニューから [Format Cells] を選択します。
[Format Cells] ダイアログボックスが開きます。
7. [Alignment] タブをクリックして [Alignment] ページを開きます。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
137
7
DCC Report を作成する
画像エリアを作成する
図 76. [Format Cells] ダイアログボックスの [Alignment] ページ
8. [Vertical ] リストで、[Top] を選択します。
9. [OK] をクリックします。
138
TraceFinder Custom reports のチュートリアル
Thermo Scientific
7
DCC Report を作成する
画像エリアを作成する
 セル範囲に境界線を追加するには
1. セル A7 から E12 を選択します。
選択されたセルはこのようになります :
これらの選択されたセルには、画像エリア、右に凡例の列、そして下に化合物名の
行が含まれます。
2. [Home] タブをクリックして [Home] 機能を表示させます。
3. [Font] エリアで [Borders] アイコンの横にある下矢印をクリックします。
4. メニューから [Outside Borders] を選択します。
境界線が引かれたセルはこのようになります :
次の手順では、この境界線エリアを 28 回コピーします。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
139
7
DCC Report を作成する
画像エリアを作成する
 [QuanChart] セル範囲を水平にコピーするには
1. セル A7 から E12 を選択します。
セルを選択する場合、境界線エリアをクリックせずに、セル全体にわたりカーソル
をドラッグします。
2. 右クリックしてショートカットメニューから [Copy] を選択します。
3. セル F7 で右クリックしてショートカットメニューから [Paste] を選択します。
4. ステップ 3 をセル K7 と P7 に対して繰り返します。
[Copy/Paste] 機能でセルと境界線をコピーしますが、名前付き範囲はコピーされません。
 [QuanChart] セル範囲を垂直にコピーするには
1. 7 行目から 12 行目を選択します。
2. 右クリックしてショートカットメニューから [Copy] を選択します。
3. セル A13 で右クリックしてショートカットメニューから [Paste] を選択します。
4. ステップ 3 を セル A19、A25、A31、A37、および A43 に対して繰り返します。
これで、最大 28 の化合物を保持できる 28 の画像エリアが完成しました。それぞれのエ
リアが、このようなデータを表示します :
次の手順で、スプレッドシートで列を調整します。
 [ChartLegend] 列を調整するには
1. E 列のヘッダーをクリックします ( 最初の凡例の列 )。
2. E 列が 6.00 ポイントの幅になるまで E 列と F 列の間のセパレータをドラッグします。
Excel アプリケーションは、セパレータをドラッグする際に列幅を表示します。
3. 他の凡例の列 (J、O、および T) にステップ 1 を繰り返します。
140
TraceFinder Custom reports のチュートリアル
Thermo Scientific
7
DCC Report を作成する
画像エリアを作成する
 [QuanChart] 列を調整するには
1. A 列のヘッダーをクリックします ( 最初のチャートの列 )。
2. A 列が 4.00 ポイントの幅になるまで A 列と B 列の間のセパレータをドラッグします。
Excel アプリケーションは、セパレータをドラッグする際に列幅を表示します。
3. 他のチャートの列 (B、C、および D)、(F、G、H、および I)、(K、L、M、および N)、
および (P、Q、R、および S) にステップ 1 および 2 を繰り返します。
 行の高さを調整するには
1. 7 行目の数字をクリックします。
2. 7 番目の行が元の高さの 4.00 ポイントになるまで、7 行目と 8 行目の間のセパレータ
をドラッグします。
ヒント 右のセパレータは列の幅を制御し、下のセパレータは行の高さを制御し
ます。
3. 他の行においても、ステップ 1 および 2 を繰り返します (48 行目まで )。
テンプレートが次の例と同様であることを確認します。
図 77. 28 の画像エリアを示すテンプレート
Thermo Scientific
TraceFinder Custom reports のチュートリアル
141
7
DCC Report を作成する
データエリアを作成する
データエリアを作成する
[Sheet1] の下で、最大 28 の化合物を表示するために最大 28 行を確保します。130 ページ
の『DCC Report の例』を参照してください。
以下の手順では、列ヘッダーを作成し、VBA コードを使用してデータを設定します。
 テンプレートで列ヘッダーに静的ラベルを入力するには
1. セル A50 に [Name] を入力します。
2. セル E50 に [Symbol] を入力します。
この列は、後で [VBA Vlookup] 機能のキーとして作用します。
3. セル F50 に [RT] を入力します。
4. セル H50 に [Cal. Amt] を入力します。
5. セル J50 に [Resp:] を入力します。
6. セル K50 に [Type] を入力します。
7. セル M50 に [Diagnostic Behaviors] を入力します。
これで、データを分類して名前付き範囲を作成する準備が完了しました。
 テンプレートでデータの名前付き範囲を作成するには
1. セル E51 から K78 を選択します。
2. [Formulas] タブをクリックして [Define Name] をクリックします。
選択されたセル範囲は、[New Name] ダイアログボックスの [Refers To] ボックスに自
動的に表示されます。
3. [Name] ボックスで、[DataArea] を入力します。
4. [OK] をクリックします。
5. 一ページにすべてを表示させるために、データ行を可能な限り小さくします。50 行
目から 78 行目では行の高さを 9 ポイントに変更します。
142
TraceFinder Custom reports のチュートリアル
Thermo Scientific
7
DCC Report を作成する
派生データを追加する
派生データを追加する
このセクションでは、[Sheet1] に派生データを追加します。完成したシートはこのよう
になります :
図 78. 派生データを示す完成したテンプレート
これらの手順に従います :
• テンプレートで派生データに静的ラベルを入力するには
• テンプレートでタイトルのフォントをフォーマットするには
• テンプレートにチェックボックスを追加するには
• テンプレートで数式を入力するには
Thermo Scientific
TraceFinder Custom reports のチュートリアル
143
7
DCC Report を作成する
派生データを追加する
 テンプレートで派生データに静的ラベルを入力するには
1. セル M50 に [Diagnostic Behaviors] を入力します。
2. セル M53 に [T/E (conc)] を入力します。
3. セル M57 に [Expected and Reference limits (ng/ml)] を入力します。
4. セル M62 に [Alter] を入力します。
5. セル M65 に [Hydrolyze] を入力します。
6. セル M68 に [Derivatization] を入力します。
7. セル M71 に [IS-Areas] を入力します。
これで、これらのタイトルを太字フォントでフォーマットする準備が完了しました。
 テンプレートでタイトルのフォントをフォーマットするには
1. [CTRL] を押したままで、作成したラベルセルを選択します。
2. 右クリックしてショートカットメニューから [Format Cells] を選択します。
[Format Cells] ダイアログボックスが開きます。
3. [Font] タブをクリックして [Font] ページを開きます。
133 ページの『[Format Cells] ダイアログボックスの [Font] ページ』をご覧ください。
4. [Font Style] ボックスで、[Bold] を選択します。
これで、特定のセルにチェックボックスを追加する準備が完了しました。
 テンプレートにチェックボックスを追加するには
1. セル R53 で q を入力します。
2. セル R53 を右クリックして次のポップアップボックスを表示させます。
3. [Calibri] の横にある下矢印をクリックします ([Calibri] はスプレッドシートのデフォル
トのフォントです )。
4. フォントのリストから、[Wingdings] を選択します。
[Wingdings] フォントの q はこのように表示されます :
5. セル T58、S66、S69、および S72 に対してステップ 1 から 4 を繰り返します。
これで、派生データに数式を入力する準備が完了しました。
144
TraceFinder Custom reports のチュートリアル
Thermo Scientific
7
DCC Report を作成する
派生データを追加する
 テンプレートで数式を入力するには
1. セル P52 に、次の数式を入力します :
=IF(VLOOKUP("E", DataArea, 6, FALSE) = 0, 0, VLOOKUP("T", DataArea, 6, FALSE)
/ VLOOKUP("E", DataArea, 6, FALSE))
2. セル P53 に、次の数式を入力します :
=IF(VLOOKUP("E", DataArea, 4, FALSE) = 0, 0, VLOOKUP("T", DataArea, 4, FALSE)
/ VLOOKUP("E", DataArea, 4, FALSE))
3. セル P54 に、次の数式を入力します :
=IF(VLOOKUP("Etio", DataArea, 4, FALSE) = 0, 0, VLOOKUP("Andro", DataArea, 4,
FALSE) / VLOOKUP("Etio", DataArea, 4, FALSE))
4. セル P55 に、次の数式を入力します :
=IF(VLOOKUP("T", DataArea, 4, FALSE) = 0, 0, VLOOKUP("Andro", DataArea, 4,
FALSE) / VLOOKUP("T", DataArea, 4, FALSE))
5. セル T54 に、次の数式を入力します :
=IF(VLOOKUP("T", DataArea, 4, FALSE) = "0", "Im 0", "Not 0")
6. セル P58 に、次の数式を入力します :
=VLOOKUP("Andro", DataArea, 4, FALSE)
7. セル P59 に、次の数式を入力します :
=VLOOKUP("Etio", DataArea, 4, FALSE)
8. セル P60 に、次の数式を入力します :
=VLOOKUP("DHEA", DataArea, 4, FALSE)
9. セル S58 に、次の数式を入力します :
=VLOOKUP("E", DataArea, 4, FALSE)
10. セル S59 に、次の数式を入力します :
=VLOOKUP("T", DataArea, 4, FALSE)
11. セル S60 に、次の数式を入力します :
=IF(VLOOKUP("c-DHEA", DataArea, 6, FALSE)=0, "N/A", VLOOKUP("DHEA", DataArea,
6, FALSE) / VLOOKUP("c-DHEA", DataArea, 6, FALSE))
12. セル Q63 に、次の数式を入力します :
=IF(VLOOKUP("Etio", DataArea, 6, FALSE) = 0, 0, IF(VLOOKUP("S_Etio",
DataArea, 6, FALSE) = 0, 0, VLOOKUP("Etio", DataArea, 6, FALSE) /
(VLOOKUP("Etio", DataArea, 6, FALSE) + VLOOKUP("S_Etio", DataArea, 6,
FALSE))))
13. セル Q66 に、次の数式を入力します :
= IF(VLOOKUP("MT", DataArea, 6, FALSE) = 0, 0, O66 * VLOOKUP("D5-Andro",
DataArea, 6, FALSE)/VLOOKUP("MT", DataArea, 6, FALSE))
14. セル Q69 に、次の数式を入力します :
=IF(VLOOKUP("Andro",DataArea,6,FALSE)=0,0,IF(VLOOKUP("Andro-mono",DataArea,6
,FALSE)
=0,0,VLOOKUP("Andro",DataArea,6,FALSE)/(VLOOKUP("Andro",DataArea,6,FALSE)+VL
OOKUP("Andro-mono",DataArea,6,FALSE))))
Thermo Scientific
TraceFinder Custom reports のチュートリアル
145
7
DCC Report を作成する
派生データを追加する
15. セル Q72 に、次の数式を入力します :
=TEXT(VLOOKUP("MT", DataArea, 6, FALSE), "0,000")
すべての数式は、名前付き範囲 [DataArea] で定義された記号に基づいた Excel のルック
アップ機能に含まれています。これらの数式は、データがインポートされて [DataArea]
範囲にコピーされた後に計算され、埋められます。
テンプレートの派生データエリアはこのようになります :
図 79. 派生データを示すテンプレート
146
TraceFinder Custom reports のチュートリアル
Thermo Scientific
7 DCC Report を作成する
ページフッターを作成する
ページフッターを作成する
このセクションでは、データ表のフッターを作成します。
 レポートフッターに静的ラベルを入力するには
1. セル A79 に [Verified:] と入力します。
2. セル A79 に [Bacteria:] と入力します。
3. セル A79 に [Positive:] と入力します。
4. セル A79 に [Substances:] と入力します。
 チェックボックスを追加するには
1. セル I79 で q を入力します。
2. セル I79 を右クリックして次のポップアップボックスを表示させます。
3. [Calibri] の横にある下矢印をクリックします ([Calibri] はスプレッドシートのデフォル
トのフォントです )。
4. フォントのリストから、[Wingdings] を選択します。
[Wingdings] フォントの q はこのように表示されます :
5. ステップ 1 から 4 をセル M79 に繰り返します。
テンプレートのフッターはこのように表示されます :
図 80. フッターを示すテンプレート
Thermo Scientific
TraceFinder Custom reports のチュートリアル
147
7
DCC Report を作成する
化合物のマッピング表を作成する
化合物のマッピング表を作成する
DCC Report では、特定の順番で化合物を一覧表示する必要があります。二つの目的を満
たすマッピング表を作成します :
• 並べ替え : このレポートには、メソッドの化合物名において接頭語を使用した特別な
並べ替え順序が必要です。接頭語は後でレポートから削除します。
• 参照 :M51 から T72 の多くの数式は、Excel アプリケーションの [Vlookup] 機能を使用
します。実際の化合物名を使用する代わりに、いくつかの化合物は記号を使用しま
す。
マッピング表の最初の列には、メソッドで定義された名前と一致しなければならない化
合物名が含まれます。
マッピング表の第二の列には、レポートで表示させたい任意の名前が含まれます。
マッピング表の第三の列には、数式で参照する化合物の記号が含まれます。化合物名の
代わりに記号を使用することで、数式の読み取りと保守が容易になります ( 例えば、数
式を変更せずに表示名を変更できます )。
次の表の値を使用してテンプレートでマッピング表を作成します。
表 1. マッピング表の列の値 ( シート 1/2)
148
メソッドでの名前
表示される名前
11b-Hydroxyandrosterone
11b-Hydroxyandrosterone
11b-Hydroxyetiocholanolone
11b-Hydroxyetiocholanolone
16-Androstenol
16-Androstenol
Allotetrahydrocortisol
Allotetrahydrocortisol
Androstandiole1
Androstandiole1
Androstandiole2
Androstandiole2
Androstendione
Androstendione
Androsterone
Androsterone
Cortisol
Cortisol
Cortisone
Cortisone
Dehydroepiandrosterone
Dehydroepiandrosterone
Dihydrotestosterone
Dihydrotestosterone
Epitestosterone
Epitestosterone
E
Etiocholanolone
Etiocholanolone
Etio
Etiocholanolone_S_Artefact
Etiocholanolone_S_Artefact
S_Etio
Methyltestosterone
Methyltestosterone
MT
Norandrosterone
Norandrosterone
Pregnandiole
Pregnandiole
Testosterone
Testosterone
Tetrahydrocortisol
Tetrahydrocortisol
TraceFinder Custom reports のチュートリアル
記号
Andro
DHEA
T
Thermo Scientific
7 DCC Report を作成する
化合物のマッピング表を作成する
表 1. マッピング表の列の値 ( シート 2/2)
メソッドでの名前
表示される名前
記号
Z-Androsterone_mono
Androsterone_mono
Andro-mono
Zd5_Stanozolol_M1
d5_Stanozolol_M1
Zd5-Androsterone_bis
d5-Androsterone_bis
Zd5-Norandrosterone
d5-Norandrosterone
ZTestosterone-d3
Testosterone-d3
ZZ_Cyclo_DHEA
Cyclo_DHEA
D5-Andro
c-DHEA
これらの手順に従います :
• テンプレートで列ヘに静的ラベルを入力するには
• テンプレートで化合物を追加するには
• テンプレートでデータの名前付き範囲を作成するには
• テンプレートでマッピング表の列を非表示にするには
 テンプレートで列ヘに静的ラベルを入力するには
1. セル V50 に [Name in Method] を入力します。
2. セル W50 に [Name to be displayed] を入力します。
3. セル X50 に [Symbol] を入力します。
これで、化合物、表示名、および記号をマッピング表に追加する準備が完了しました。
 テンプレートで化合物を追加するには
1. セル V51 から V76 に、化合物名を入力します。
2. セル W51 から W76 に、表示名を入力します。
ほとんどの場合、表示名は化合物名と同様ですが、最後のいくつかの化合物は、Z
または ZZ を名前から削除します。Excel アプリケーションは、これらの化合物をリ
ストの最後に並べ替えるために、先頭の Z を使用します。
3. Y 列で、指定の化合物の記号を入力します。
このレポートの数式では、ここに示されている記号を使用します。
これで、このマッピング表の名前付き範囲を作成する準備が完了しました。VBA コード
において、この名前付き範囲を参照します。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
149
7
DCC Report を作成する
化合物のマッピング表を作成する
 テンプレートでデータの名前付き範囲を作成するには
1. セル V51 から X78 を選択します。
2. [Formulas] タブをクリックして [Define Name] をクリックします。
選択されたセル範囲は、[New Name] ダイアログボックスの [Refers To] ボックスに自
動的に表示されます。
3. [Name] ボックスで、[CompoundMapTable] を入力します。
4. [OK] をクリックします。
テンプレートが次の例と同様であることを確認します。
図 81. 化合物のマッピング表を示すテンプレート
これで、マッピング表を非表示にする準備が完了しました。マッピング表は、作成され
たレポートで表示されません。
150
TraceFinder Custom reports のチュートリアル
Thermo Scientific
7
DCC Report を作成する
データ表を作成するには
 テンプレートでマッピング表の列を非表示にするには
1. 列 V、W、および X を選択します。
2. 右クリックしてショートカットメニューから [Hide] を選択します。
Excel アプリケーションは、列 V、W、および X を非表示にします。非表示の列の内
容は、いつでも復元できます。
列 V、W、および X を復元するには、次を行います :
a. 列 U および Z を選択します。
b. 右クリックしてショートカットメニューから [Unhide] を選択します。
データ表を作成するには
セル A5 から T78 でレポートされるソースデータは [*_SampleCentricData.xml] ファイル由
来ですが、特別な並べ替えが必要であるため、データを直接使用できません。このセク
ションでは、インポートされたデータをテンポラリシートに配置します。それらを基に
レポートを作成していきます。
これらの手順に従います :
• テンプレートで [Sheet3] を削除するには
• テンプレートで [Sheet2] の名前を変更するには
• テンプレートにマップされているノードを追加するには
• テンプレートに七つのヘルパー列を追加するには
• テンプレートのセルフォーマットを変更するには
• テンプレートで列ヘッダーの名前を変更するには
• テンプレートで数式を入力するには
• テンプレートで表に名前を付けるには
 テンプレートで [Sheet3] を削除するには
[Sheet3] タブを右クリックしてショートカットメニューから [Delete] を選択します。
 テンプレートで [Sheet2] の名前を変更するには
1. [Sheet2] タブを右クリックしてショートカットメニューから [Rename] を選択します。
2. [TempSheet] と入力して [ENTER] を押します。
[XML Source] ツリーから該当する表のセルにノードをドラッグして、
[SampleCentricExportBatch] フォルダからマップされたノードを追加する準備が完了しま
した。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
151
7
DCC Report を作成する
データ表を作成するには
 テンプレートにマップされているノードを追加するには
1. [Samples/SampleCentricExportSample/Compounds/SampleCentricCompoundExportData]
フォルダを開き、セル A1 に [CompoundName] ノードをドラッグします。
2. [Samples/SampleCentricExportSample/Compounds/SampleCentricCompoundExportData/QuanR
esult]
フォルダを開き、セル B1 に [ActualRTDisplayValue] ノードをドラッグします。
3. [CalibrationData/CompoundCurveExportData/CalibrationReplicates/SampleCompoundReplicate
ExportData]
フォルダを開き、セル C1 に [CalculatedAmount] ノードをドラッグします。
4. [Samples/SampleCentricExportSample/Compounds/SampleCentricCompoundExportData/QuanR
esult]
フォルダを開き、セル D1 に [TotalResponse] ノードをドラッグします。
5. [Samples/SampleCentricExportSample/Compounds/SampleCentricCompoundExportData]
フォルダを開き、次を行います :
a. セル E1 に [ResponseValue] ノードをドラッグします。
b. セル F1 に [CompoundType] ノードをドラッグします。
c. セル G1 に [CompoundKey] ノードをドラッグします。
d. セル H1 に [QuanMassRange] ノードをドラッグします。
6. [SampleCentricExportBatch/Samples/SampleCentricExportSample/
Compounds/SampleCentricCompoundExportData/QuanPeakIdentifiers/QuanPeakIdentifierExp
ortData/PeakDetectionParameters]
フォルダを開き、セル I1 に [FilterString] ノードをドラッグします。
7. [Samples/SampleCentricExportSample/Compounds/SampleCentricCompoundExportData/QuanR
esult]
フォルダを開き、次を行います :
a. セル J1 に [TotalIonArea] ノードをドラッグします。
b. セル K1 に [TotalIonHeight] ノードをドラッグします。
c. セル L1 に [ManualIntegrationFlagSet] ノードをドラッグします。
8. [CalibrationData/CompoundCurveExportData/CalibrationReplicates/SampleCompoundReplicate
ExportData]
フォルダを開き、セル M1 に [Units] ノードをドラッグします。
これで、ヘルパー列を作成して表示用にデータを操作する準備が完了しました。
 テンプレートに七つのヘルパー列を追加するには
1. [Units] ヘッダーセルを右クリックしてショートカットメニューから [Insert] > [Table
Column to the Right] を選択します。
Excel アプリケーションは、M 列の右にデフォルト名が [Column1] の新しい列を追加
します。
2. [Column1] ヘッダーセルを右クリックしてショートカットメニューから [Insert] >
[Table Column to the Right] を選択します。
152
TraceFinder Custom reports のチュートリアル
Thermo Scientific
7
DCC Report を作成する
データ表を作成するには
3. [Column1] から [Column7] までの名前の七つの新しい列ができるまで、最後の列を右
クリックして右側に列を追加し続けます。
新しい列ヘッダーがこのようになることを確認します :
これで、セルフォーマットを [Text] から [General] に変更する準備が完了しました。
 テンプレートのセルフォーマットを変更するには
1. [Column1] セルを右クリックしてショートカットメニューから [Format Cells] を選択
します。
[Format Cells] ダイアログボックスが開きます。
2. [Number] タブをクリックして [Number] ページを開きます。
図 82. [Format Cells] ダイアログボックスの [Number] ページ
3. [Category] リストで [General] を選択して [OK] をクリックします。
4. [Column1] セルが選択されている間に、[ENTER] を押します。
Excel アプリケーションは、新しいセルフォーマットを自動的に更新しません。
[ENTER] を押して手動で更新します。
5. 追加した七つの列ごとにステップ 1 から 5 を繰り返します。
これで、列ヘッダーに意味のある名前を付ける準備が完了しました。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
153
7
DCC Report を作成する
データ表を作成するには
 テンプレートで列ヘッダーの名前を変更するには
1. セル N1 で、[Column1] を [Response] に変更します。
2. セル O1 で、[Column2] を [MassCharge] に変更します。
3. セル P1 で、[Column3] を [RT] に変更します。
4. セル Q1 で、[Column4] を [AreaIntensity] に変更します。
5. セル R1 で、[Column5] を [HeightIntensity] に変更します。
6. セル S1 で、[Column6] を [Amt] に変更します。
7. セル T1 で、[Column7] を [ChartLegend] に変更します。
これで、これらの七つの列に数式を入力する準備が完了しました。
 テンプレートで数式を入力するには
表示されている各セルに、次の数式を入力します :
a. セル N2
=TEXT(D2, "0")
b. セル O2
="m/z=" & H2
c. セル P2
="RT=" & B22
d. セル Q2
=IF(L2, "M", "A") & "A=" & TEXT(J2, "0")
e. セル R2
=IF(L2,"M","A")&"H="&TEXT(K2,"0")
f.
セル S2
="Amt=" & TEXT(C2, "0.0")
g. セル T2
= O2 & CHAR(10) & P2 & CHAR(10) & Q2 & CHAR(10) & R2 & CHAR(10) & S2
この数式は、すべての記号フィールドを連結し、レポートで使用できるようにしま
す。
これで、作成した表の名前を付ける準備が完了しました。
154
TraceFinder Custom reports のチュートリアル
Thermo Scientific
7
DCC Report を作成する
データ表を作成するには
 テンプレートで表に名前を付けるには
1. [Formulas] タブをクリックして [Name Manager] をクリックします。
2. [Name Manager] ダイアログボックスで、作成した表の名前をダブルクリックします。
名前は、作成した表の数によって異なります。
[Edit Name] ダイアログボックスが開きます。
3. 名前を [DataTable] に変更して [OK] をクリックします。
4. [Name Manager] ダイアログボックスで [Close] をクリックします。
テンプレートが次の例と同様であることを確認します。
図 83. 完成したデータ表のレイアウト
テンプレートインターフェイスのデザインが完了です。次のセクションでは、VBA コー
ドを追加して、[TempSheet] の [DataTable] から [Sheet1] の列にデータを設定します。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
155
7
DCC Report を作成する
VBA コードを追加する
VBA コードを追加する
これで VBA コードを使用して、テンプレートの [Sheet1] で列を設定する準備が完了しま
した。
これらの手順に従います :
• VBA データをテンプレートに接続するには
• [MyUtil] クラスモジュールからコードを削除するには
• [Module1] モジュールを編集するには
• テストを実行するには
• TraceFinder アプリケーションでテンプレートを使用するには
 VBA データをテンプレートに接続するには
1. [Developer] タブをクリックして [Developer] 機能を表示させます。
2. [Visual Basic]
をクリックします。
[Microsoft Visual Basic] ウィンドウが開きます。
このレポートは標準のヘッダーおよびフッターを使用しないので、次の手順でヘッダー
およびフッターのコードを削除します。
 [MyUtil] クラスモジュールからコードを削除するには
1. フッターを指定するコードを削除するには、一重引用符 ( チェックマーク ) を入力し
てフッターコードをコメントアウトします :
Private Sub IUtil_SetupPageFooter()
' mUtil.SetupPageFooter "", 0.5
End Sub
2. ヘッダーを指定するコードを削除するには、一重引用符 ( チェックマーク ) を入力し
てヘッダーコードをコメントアウトします :
Private Sub IUtil_SetupPageHeader()
' mUtil.SetupPageHeader
End Sub
156
TraceFinder Custom reports のチュートリアル
Thermo Scientific
7
DCC Report を作成する
VBA コードを追加する
[MyUtil] コードはこのようになります :
Option Explicit
Implements IUtil
Private Sub IUtil_ProcessData()
ProcessData
End Sub
Private Sub IUtil_SetupPageFooter()
'
mUtil.SetupPageFooter "", 0.5
End Sub
Private Sub IUtil_SetupPageHeader()
'
mUtil.SetupPageHeader
End Sub
Private Function IUtil_Validate(Optional showWarning As Boolean = True) As
Boolean
IUtil_Validate = Validate(showWarning)
End Function
 [Module1] モジュールを編集するには
1. [Module1] をクリックします。
[Module1] ウィンドウには、[ThermoCustomReportBaseTemplate.xml] テンプレートから
受け取ったコードが含まれます。
2. ベーステンプレートのコードを次のコードに置き換えます :
Option Explicit
' Called after xml data gets imported
Public Sub ProcessData()
ProcessSheet1Data
End Sub
Private Sub ProcessSheet1Data()
Dim i As Long, r As Long, c As Long, compName As String, compId As String,
arrCompounds() As String
Dim rr As Long, cc As Long
ActiveWorkbook.Sheets("Sheet1").Activate
' Sort the data table by compound name
mUtil.SortList "DataTable", "CompoundName", Sheets("TempSheet")
' Get a unique list of compound names
arrCompounds = mUtil.GetUniqueList("DataTable", 1)
For i = 1 To UBound(arrCompounds)
Thermo Scientific
r = Int((i - 1) / 4) + 1
' row number
c = (i - 1) Mod 4 + 1
' col number
rr = (r - 1) * 6
' row offset
cc = (c - 1) * 5
' col offset
TraceFinder Custom reports のチュートリアル
157
7
DCC Report を作成する
VBA コードを追加する
' Get the compound display name from the CompoundMapTable
compName = mUtil.VLookup(arrCompounds(i), Range("CompoundMapTable"),
2, False)
If compName <> "" Then
' Copy compound display name to column A starting from row 51
Range("A" & 50 + i) = compName
' Copy compound display name to the image area under the image
Range("CompoundName").Offset(rr, cc) = compName
' Copy symbol to column E starting from row 51
Range("E" & 50 + i) = mUtil.VLookup(arrCompounds(i),
Range("CompoundMapTable"), 3, False)
' Copy RT to column F starting from row 51
Range("F" & 50 + i) = mUtil.VLookup(arrCompounds(i),
Range("DataTable"), 2, False)
' Copy Calc Amt to column H starting from row 51
Range("H" & 50 + i) = mUtil.VLookup(arrCompounds(i),
Range("DataTable"), 3, False)
' Copy Units to column I starting from row 51
Range("I" & 50 + i) = mUtil.VLookup(arrCompounds(i),
Range("DataTable"), 13, False)
' Copy Response to column J starting from row 51
Range("J" & 50 + i) = mUtil.VLookup(arrCompounds(i),
Range("DataTable"), 14, False)
' Copy RespValue to column K starting from row 51
Range("K" & 50 + i) = mUtil.VLookup(arrCompounds(i),
Range("DataTable"), 5, False)
' Set the legend next to the image
mUtil.ShiftRange("ChartLegend", cc, rr, cc, rr) =
mUtil.VLookup(arrCompounds(i), Range("DataTable"), 20, False)
' Merge the legend cells and make the text wrap
With mUtil.ShiftRange("ChartLegend", cc, rr, cc, rr)
.MergeCells = True
.WrapText = True
End With
Application.Calculate
' Refresh formula
' Load images in place
compId = mUtil.VLookup(arrCompounds(i), Range("DataTable"), 7,
False)
mUtil.CreateImage mUtil.ShiftRange("QuanChart", cc, rr, cc, rr),
"SampleCentricExportBatch/Samples/SampleCentricExportSample/Compounds/Sample
CentricCompoundExportData[CompoundKey='" & compId &
"']/QuanResult/QuanPeakResults/CompoundQuanPeakResultExportData/PeakImage",
20, 5, 12, 2
End If
Next
158
TraceFinder Custom reports のチュートリアル
Thermo Scientific
7
DCC Report を作成する
VBA コードを追加する
mUtil.HideColumns "V:AA"
ActiveWorkbook.Sheets("TempSheet").Delete
'
mUtil.AddTextAsWatermark "Thermo Custom Report", Range("Sheet1!A1:T78")
End Sub
' Validate the template design e.g. named ranges
Public Function Validate(Optional showWarning As Boolean = True) As Boolean
Validate = True
End Function
この場合 :
• [SortList] は、データ表を化合物名で並べ替えます。
• [GetUniqueList] は、各化合物を繰り返すために使用される化合物名の固有リスト
を取得します。
• [CopyPaste] は、[TempSheet] のデータ表からの次の列を [Sheet1] の下のデータエリ
アにコピーします。
–
DisplayRetentionTime
–
CalculatedAmount
–
Units
–
Response
–
ResponseValue
• 各化合物を繰り返すためには、VBA 機能が次を行います :
–
各化合物の化合物名、画像および記号を配置するために使用される行と列の
オフセットを計算します。
–
[VLookup] は、化合物表示を [CompoundMapTable] から取得します。
–
[Range("A" &amp; 50 + i)…] は、化合物の表示名を、A1 から開始する各定量
チャートの下にあるデータエリアにコピーします。
–
[Range("CompoundName").Offset(rr, cc)…] は、化合物の表示名を、各定量
チャートの下にあるデータエリアにコピーします。
–
[Range("E" & 50 + i)…] は、E51 から開始して記号を E 列にコピーします。
–
[ShiftRange] は、指定したオフセットにより画像の凡例をシフトし、これを
[ChartLegend] 名前付き範囲にコピーします。
–
凡例のセルを結合し、[WrapText] プロパティを [True] に設定して、文字が隣
のセルに超過しないようにします。
–
[CompoundKey] に基づいて、XML ファイルから画像をロードします。
• [ActiveWorkbook.Sheets("TempSheet").Delete] が [TempSheet] を削除します。
3. エラーチェックに [Visual Basic] コンパイル機能を使用するには、[Debug] > [Compile
VBAProject] を選択します。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
159
7
DCC Report を作成する
テンプレートをテストする
Excel レポート作成にこのテンプレートを使用するには、メソッドで定義された特定の化
合物が存在するか、メソッドを適合させるために [CompoundMapTable] を修正しなけれ
ばなりません。
テンプレートをテストする
この時点で、[Windows Start] > [Run] ボックスからテストを実行する準備が完了していま
す。このテストで、入力するコードが次を実行します :
• Excel アプリケーションを開きます。
• [MyDCCReport.xltm] テンプレートを使用して新しいワークブックを作成します。
• パラメータをテンプレートに渡します。
• [4bw01_SampleCentricData.xml] ソースファイルに基づいてレポートを作成します。
• [MyDCCReport.xlsm] ファイルにレポートを保存します。
これらの手順に従います :
• テストを実行するには
• TraceFinder アプリケーションでテンプレートを使用するには
 テストを実行するには
1. [Start] > [Run] を選択します。
[Run] ダイアログボックスが開きます。
ヒント デフォルトで、TraceFinder アプリケーションファイルは長いファイルパス
になってしまいます。Windows の [Run] ダイアログボックスが 256 文字に制限し
ます。この制限に対処するには、ファイルをルートディレクトリに近いフォルダ
にコピーするか、バッチファイルにコマンドラインを置きます。
2. このコードを [Open] ボックスに入力します :
Excel.exe /n "C:\Thermo\Custom Report Tutorials\MyDCCReport.xltm"
/x/C:\Thermo\Custom|Report|Tutorials\Data\4bw01_SampleCentricData.xml/C:\The
rmo\Custom|Report|Tutorials\Reports\MyDCCReport.xlsm/s/h
このコードで使用されるパラメータの詳細は、27 ページの『テンプレートをテスト
する』を参照してください。
3. [OK] をクリックします。
160
TraceFinder Custom reports のチュートリアル
Thermo Scientific
7 DCC Report を作成する
テンプレートをテストする
作成されたレポートは、次の図と同様になります ( 使用したバッチにより、実際のデー
タは異なる場合があります ):
図 84. DCC Report の例
これで、テンプレートを TraceFinder アプリケーションに統合する準備が完了しました。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
161
7
DCC Report を作成する
テンプレートをテストする
 TraceFinder アプリケーションでテンプレートを使用するには
1. 新しいテンプレートをアプリケーションの専用フォルダにコピーします。
C:\Thermo\Shared\Templates\Reports
2. このテンプレートを、TraceFinder アプリケーションの他の Custom reports と同様に使
用します。
Custom reports の使用方法の詳細は、TraceFinder ユーザーガイドまたは 第 3 章、『入門
ガイド』を参照してください。
162
TraceFinder Custom reports のチュートリアル
Thermo Scientific
A
よくある質問
この付録では、TraceFinder の Custom reports に関してよくある質問に回答します。チュー
トリアルの章では、詳細なご案内をいたします。
内容
• 一般的な質問
• データ表に関する質問
• 画像処理に関する質問
• デバッグに関する質問
一般的な質問
このセクションでは、TraceFinder の Custom reports に関する一般的な質問に回答します。
• Excel バージョン番号を見つけるには、どうすればよいですか？
• [Developer] タブを有効にするには、どうすればよいですか？
• Excel の名前付き範囲とは何ですか？
• コマンドラインを使用して Excel レポートを作成するには、どうすればよいですか？
• Excel レポートを開くときにセキュリティ警告が表示されるのはなぜですか？
• ページ全体を通してページ番号が連続していないのはなぜですか？
• すべてのレポートのデフォルトのロゴ画像を変更するには、どうすればよいです
か？
• Excel の [Copy] 機能の代わりにアドインの [Copy/Paste] 機能を使う必要があるのはな
ぜですか？
• レポートにウォーターマークを入れるには、どうすればよいですか？
• 「File in Use ( ファイルが使用中です )」のエラーメッセージが表示されるのはなぜで
すか？
Thermo Scientific
TraceFinder Custom reports のチュートリアル
163
A
よくある質問
一般的な質問
Excel バージョン番号を見つけるには、どうすればよいですか？
 Excel バージョン番号を見つけるには
1. Excel アプリケーションを開きます。
2. [Office] ボタン
します。
をクリックし、次に [Excel Options]
をクリック
3. [Excel Options] ダイアログボックスの左パネルで、[Resources] をクリックします。
[Excel Options] ダイアログボックスの [Resources] ページがバージョン番号を表示します。
164
TraceFinder Custom reports のチュートリアル
Thermo Scientific
A
よくある質問
一般的な質問
[Developer] タブを有効にするには、どうすればよいですか？
Excel アプリケーションで [Visual Basic Development] を開始するには、[Developer] タブを有
効にしなければなりません。これはデフォルトでは非表示になっています。
 [Developer] タブを有効にするには
1. [Office] ボタン
します。
をクリックし、次に [Excel Options]
をクリック
2. [Popular] をクリックします。
3. [Show Developer tab in the Ribbon] チェックボックスを選択します。
図 85. [Excel Options Popular] ダイアログボックス
Thermo Scientific
TraceFinder Custom reports のチュートリアル
165
A
よくある質問
一般的な質問
Excel の名前付き範囲とは何ですか？
セルの範囲に名前を定義でき、この名前を数式または VBA コードで使用してそのセル範
囲を参照できます。
 セルの範囲に名前を指定するには
1. セルを選択します。
2. [Formulas] タブをクリックします。
3. [Define Name] をクリックします。
アプリケーションは、[New Name] ダイアログボックスの [Refers To] ボックスで選択
されたセルの範囲を表示します。
Excel アプリケーションは、例えば、データ表や形などのいくつかのオブジェクトにデ
フォルト名を自動的に割り当てます。
 名前を追加、削除、または修正するには
1. [Formulas] タブをクリックします。
2. [Name Manager] をクリックします。
[Name Manager] ダイアログボックスが開きます。
3. [Name Manager] ダイアログボックスで、次のうちの一つを行います :
[New] をクリックして新しい名前を作成します。
- または 編集する名前を選択して [Edit] または [Delete] をクリックします。
166
TraceFinder Custom reports のチュートリアル
Thermo Scientific
A
よくある質問
一般的な質問
コマンドラインを使用して Excel レポートを作成するには、どうすればよ
いですか？
新しいレポートテンプレートを開発する場合、または既存のものを修正する場合、実際に
それをアプリケーションで使用する前にテストしたい場合があります。このような場合、
[Start] メニューの [Windows Run] ボックスを使用できます。このコマンドを使用します :
Excel.exe /n [/embedded] TEMPLATEFILE
/x/SAMPLECENTRICDATAFILE/OUTPUTFILE[/s][/h][/p PRINTERNAME]
[/v][/c][/h][/f][/l][/b][/g[/t][/d]]
例:
Excel.exe /n "C:\Thermo\Custom Report Tutorials\MyBatchReport.xltm"
/x/C:\Thermo\Custom|Report|Tutorials\Data\1ngrep5_SampleCentricData.xml/C:\T
hermo\Custom|Report|Tutorials\Reports\BatchReport.xlsm/s/h
この場合 :
• /n スイッチは、テンプレート自体を編集するのではなく、Excel スプレッドシートを
作成するためにこのテンプレートを使用していることを Windows に伝えます。この
スイッチを使用しない場合、Excel アプリケーションは編集用に指定されたテンプ
レートを開きます。
• /embedded スイッチは、Excel を埋め込んで、つまり、サイレントモードで実行するよ
うに Windows に伝えます。この場合、画面に Excel スプレッドシートは表示されませ
んが、[Task Manager] で表示されます。このスイッチがオンの場合、レポート作成後に
Excel アプリケーションを自動的に閉じるために、/c カスタムスイッチも含めている
ことを確認してください。この設定をしなかった場合、Windows をシャットダウンす
るまで、もしくは [Task Manager] で終了するまで、Excel アプリケーションを実行しま
す。
• スペースが含まれる場合、テンプレートのファイルパスは引用符で囲まれていなけ
ればなりません。この設定をしなかった場合、Excel アプリケーションは、スペース
で区切られている各アイテムを個別の Excel ワークブックと認識し、ロードしようと
します。その結果、エラーメッセージが表示されます。
重要 このスペースの後のすべてを Excel テンプレートに渡すように Windows に伝
えるために、/x の前にスペースが挿入されなければなりません。このスペースの
後に引用符を追加しないでください。追加した場合、これを二番目のスプレッド
シートを開くための指示であると Windows が認識し、エラーメッセージが表示さ
れます。
• /x スイッチは Custom reports に特有の内部スイッチです。[Custom Report Add-In] は、
/x の後のすべてのパラメータを処理します。
重要 Excel アプリケーションおよびオペレーティングシステムの両方が、/x の後
のパラメータにスペースが含まれていなことを必要とします。この要件は、Excel
アプリケーションおよびオペレーティングシステムを使用する上で課されていま
す。スペースが必要な場合、代わりに縦線「|」を使用します。アドインは、すべ
ての縦線をスペースに置き換えます。図例として、このセクションでの前述の例
で、[Custom Report Tutorials] フォルダの名前の中で垂直バーが使用されています。
• /x の後のカスタムパラメータは、セパレータとしてスラッシュ「/」を使用します。
/x の後の始めの二つのパラメータが必須です。その他すべてはオプションです。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
167
A
よくある質問
一般的な質問
• /x の後の最初のパラメータは、アドインに [XML Source] データの場所を伝えます。
パス名を正確に指定すれば、テンプレートの場所は問題になりません。しかし、
TraceFinder アプリケーションがテンプレートを使用するためには、テンプレートは専
用のフォルダになければなりません。
• /x の後の二番目のパラメータは、アドインが作成された Excel スプレッドシートを保
存する場所のパスの名前を指定します。
• カスタムスイッチは次のようになります :
は、スプレッドシートを閉じる前に、ファイルを二番目のカスタムパラメー
タに指定された場所に保存するようにアドインに伝えます。このスイッチがない
場合、スプレッドシートは作成されますが保存されません。
–
/s
–
/h
–
/p
–
/v
–
/c
は、レポート作成後に Excel ワークブックを閉じます。
–
/f
は、Excel スプレッドシートを PDF ファイルとして保存します。
–
/l
–
/b は、Excel のコピー機能を使用してデータをコピーします。データの移動には
[Clipboard] を使用します。サーモフィッシャーサイエンティフィックは、この機
能の使用しないことを推奨します。レポート作成は、バックグラウンドで実行さ
れる時間を要するプロセスであり、[Clipboard] を使用することで悪影響をまねく
可能性があります。
–
/g
–
/d
–
/t
は、画面更新を隠すように Excel アプリケーションに伝えます。このスイッチ
により、特にレポートのサイズが大きい場合、レポート作成が迅速化します。ま
た、画面フラッシュが減少します。
はレポートを印刷します。オプションとして、このスイッチの後でプリンタ
を指定できます。プリンタを指定しない場合、スイッチはデフォルトのプリンタ
を使用します。
は、印刷される予定のプレビューを表示します。印刷を続行する前に、手動
でプレビューウィンドウを閉じなければなりません。
は、オプションのパスワードでシートをロックします。パスワード保護され
ている場合、シートは読み取り専用です。変更するには、Excel ウィンドウの
[Review] タブを使用してシートをロック解除します。
はログファイルを作成し、[LogMsg] 機能により作成されたすべてのメッセー
ジを記録します。ログファイルは [ThermoCustomReport.log] と名前が付けられ、
現在のユーザーの一時フォルダに存在します。このスイッチがオンになっている
場合、/d および /t スイッチは、ログファイル名にタイムスタンプを追加します。
は、ログファイル名に [ThermoCustomReport_yyyyMMdd.log] のフォーマットで
日付を追加します。この場合、yyyy は年 ( 例、2011)、MM は月 ( 例、12 月の場合
は 12)、および dd は二桁の日にち ( 例、六日には 06) を表します。
は、ログファイル名に [ThermoCustomReport_yyyyMMdd_HHmmss.log] のフォー
マットでタイムスタンプを追加します。この場合、yyyy は年、MM は月、dd は日
にち、HH は 24 時間フォーマットでの時間、mm は分、および ss は秒を表しま
す。例 : [ThermoCustomReport_20110902_150208.log]
ヒント デフォルトで、TraceFinder アプリケーションファイルは長いファイルパスに
なります。Windows の [Run] ダイアログボックスは、256 文字に制限されています。
この制限に対処するには、ファイルをルートディレクトリに近いフォルダにコピー
するか、バッチファイルにコマンドラインを置きます。
168
TraceFinder Custom reports のチュートリアル
Thermo Scientific
A
よくある質問
一般的な質問
Excel レポートを開くときにセキュリティ警告が表示されるのはなぜです
か？
意図されていないマクロ実行を回避するために、Excel アプリケーションには厳しいセ
キュリティ要件があり、この要件はテンプレートおよびレポートにも適用されます。
Excel アプリケーションは、信頼できないロケーションからマクロまたは VBA コードで
スプレッドシートが開かれる際に次のセキュリティ警告メッセージを表示します。
図 86. セキュリティ警告メッセージ
有効なマクロなしで、アドインコンポーネントは実行されず、レポートを作成できませ
ん。
マクロ有効テンプレートを Excel アプリケーションで実行するには、アドインおよびテ
ンプレートファイルのディレクトリを信頼できる場所のリストに追加しなければなりま
せん。
• TraceFinder アプリケーションをインストールした際に、インストーラが
[C:\Thermo\Shared\Templates\Reports] デフォルトテンプレートフォルダを Excel アプリ
ケーションの信頼できる場所のリストに追加します。テンプレートをこのフォルダ
から実行する限り、セキュリティ設定は適切です。
• 次の手順に従って、フォルダを信頼できる場所のリストに追加できます ( 例えば、別
のフォルダにテンプレートを保存したい場合 )。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
169
A
よくある質問
一般的な質問
 信頼できる場所のリストにフォルダを追加するには
1. [Office] ボタン
します。
をクリックし、次に [Excel Options]
をクリック
2. [Trust Center] をクリックします。
3. [Trust Center Settings] をクリックします。
4. [Trusted Locations] をクリックして [Microsoft Office Trusted Location] ダイアログボック
スを開きます。
図 87. [Trust Center] ダイアログボックス
5. [Add New Location] をクリックします。
6. [Microsoft Office Trusted Location] ダイアログボックスで、新しい場所を追加して [OK]
をクリックします。
170
TraceFinder Custom reports のチュートリアル
Thermo Scientific
A
よくある質問
一般的な質問
ページ全体を通してページ番号が連続していないのはなぜですか？
Excel では通常、各シートでページ番号は 1 から開始します。しかし、複数のシートをグ
ループ化することにより、それらに連続的なページ番号を割り当てることもできます。
Custom report アドインを介してレポートを作成する場合、連続的なページ番号が確実に
割り当てられてるようにワークブックのすべてのシートは自動的にグループ化されま
す。例えば、パフォーマンス向上のために各ページが個別のシートに配置される
Confirmation Report などの特定のレポートにとって、グループ化は特に重要です。特定
の状況・条件では、グループ化されたシートが明確にならない可能性があります。
無効なシートをクリックすることにより、このグループ化を解除できます。また、任意
のタブを右クリックしてメニューから [Ungroup Sheets] を選択することによりグループ化
を解除することもできます。
ページ番号が連続的に割り当てられていない場合、シートを手動で編集して (188 ページ
の『データ表が編集できないのはなぜですか？』を参照 ) 、グループ化することを忘れ
ている可能性があります。または、例えば、無効なシートをクリックしてしまったこと
により、シートのグループ化を意図せずに壊した可能性もあります。
シートをグループ化するには、タブを右クリックし、メニューから [Select All Sheets] を
選択します。シートタブをクリックしている時に、[CTRL] および [SHIFT] キーを使用し
てシートを個別にグループ化または選択することもできます。
すべてのレポートのデフォルトのロゴ画像を変更するには、どうすればよ
いですか？
デフォルトで、Custom reports は [C:\Thermo\Shared\Templates\Reports\mylogo.jpg] として保
存されているロゴ画像を使用します。このファイルを独自のロゴ画像に置き換えること
ができます。
 特定のレポートでロゴを変更するには
1. [MyUtil] クラスの [IUtil_SetupPageHeader()] 機能を使用します。
この機能は通常、[mUtil.SetupPageFooter] アドイン機能を呼び出してデフォルトの
ヘッダーを作成します。
2. デフォルトのヘッダーを任意のコードに置き換えます。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
171
A
よくある質問
一般的な質問
Excel の [Copy] 機能の代わりにアドインの [Copy/Paste] 機能を使う必要があ
るのはなぜですか？
Excel のコピー機能はフォーマットされたセルの複製において有効ですが、データを移す
ために [Clipboard] を使用します。[Clipboard] は、すべての実行アプリケーションで共有
されるシステムワイドのリソースであり、レポート作成は、通常バックグラウンドで実
行される時間を要するプロセスです。したがって、データを移動するために [Clipboard]
を使用すると意図しない悪影響をまねく可能性があります。例えば、バックグランドで
レポート処理が実行されている間に、E メールを作成するためにフォアグラウンドで同
時に [Clipboard] を使用する場合、Excel アプリケーションは間違って不正確なレポートを
作成する可能性があります。
Excel アプリケーションには [Clipboard] を使用しないコピー機能がありませんが、アドイ
ンコンポーネントにより作成された特別な [copy/paste] 機能を使用できます。これは、
[Clipboard] を使用しないことを除き、Excel のコピー機能と同様です。VBA コードでセル
データのコピーおよび貼り付けを行いたい場合は、Excel のコピー機能ではなく、アドイ
ンのコピー / 貼り付け機能を使用してください。この機能の使用に関する詳細は、付録
B、『Custom Report のアドイン API』を参照してください。
172
TraceFinder Custom reports のチュートリアル
Thermo Scientific
A
よくある質問
一般的な質問
レポートにウォーターマークを入れるには、どうすればよいですか？
レポートにウォーターマークを追加するには、二つのアドイン機能があります。一つは
ウォーターマークとして文字を追加し、もう一つは画像を追加します。次の関数を呼び
出すことで、レポートのすべてのページに文字のウォーターマークを追加します。
mUtil.AddTextAsWatermark "Thermo Custom Report", Range("Sheet1!A1:T78")
図 88. ウォーターマークを示す Custom report
Thermo Scientific
TraceFinder Custom reports のチュートリアル
173
A
よくある質問
一般的な質問
「File in Use ( ファイルが使用中です )」のエラーメッセージが表示されるの
はなぜですか？
Custom report テンプレートで作成されたレポートを作成中に Excel ウィンドウが開いてい
る場合、このメッセージが表示されます :
TraceFinder は Custom report を作成する場合、隠れた Excel ウィンドウで [Personal Macro
Workbook] を開きます。すでに開いている Excel ウィンドウがあり、Excel は二つのウィン
ドウが同時に開くことを許可しないので、このエラーメッセージが表示されます。
次の方法のいずれかを使用してこの問題を解決します :
• 現在開いている Excel ウィンドウをすべて閉じます。
• マクロを [Personal Macro Workbook] に保存しないでください。
• [Personal Macro Workbook] が必要ではない場合、[Microsoft\Excel\XLSTART] フォルダか
らこれを削除します。
• [PERSONAL.XLSB] ファイルを一時的に [Microsoft\Excel\XLSTART] フォルダから動か
します。
• [PERSONAL.XLSB] ファイルを共有します。
ファイルを共有するには、次を行います :
a. Excel ウィンドウで、[View] タブをクリックし、Window オプションで [Unhide] を
クリックします。
[Unhide] ダイアログボックスが開きます。
b. [PERSONAL.XLSB] を選択して [OK] をクリックします。
c. Excel ウィンドウで、[Review] タブをクリックし、[Changes] オプションで [Share
Workbook] をクリックします。
[Share Workbook] ダイアログボックスが開きます。
d. [Allow changes by more than one user...] オプションを選択して [OK] をクリックし
ます。
e. 「ワークブックを保存しますか」と質問されたら、[OK] をクリックします。
174
TraceFinder Custom reports のチュートリアル
Thermo Scientific
A よくある質問
データ表に関する質問
データ表に関する質問
このセクションでは、TraceFinder Custom report のデータ表に関する質問に回答します。
• Excel でデータ表を作成するには、どうすればよいですか？
• データ表で列を追加または挿入するには、どうすればよいですか？
• データ表から列を削除するには、どうすればよいですか？
• データ表で列を移動するには、どうすればよいですか？
• データ表の列が XML ソースにリンクされていることを確認するには、どうすればよ
いですか？
• スプレッドシートに多くのデータ表が表示されるのはなぜですか？
• データをインポートした後にテンプレートから削除するには、どうすればよいです
か？
• データをインポートした後にデザインインターフェイスのレイアウトが変更するの
はなぜですか？
• レポートで同じフィールドを一回以上使用するには、どうすればよいですか？
• XML マップをワークブックに追加するには、どうすればよいですか？
• 数式を強制的に再計算するには、どうすればよいですか？
• データ表の数式が展開しないのはなぜですか？
• [RawFileName_SampleCentricData.xml] ファイルはどこにありますか？
• データ表が編集できないのはなぜですか？
Excel でデータ表を作成するには、どうすればよいですか？
データ表 (Excel の旧バージョンではリストとも呼ばれた ) とは関連するデータの表です。
Excel アプリケーションでデータ表を作成するには、複数の方法があります。Custom
reports では、XML ソースから Excel スプレッドシートにツリーノードをドラッグするこ
とによってのみデータ表を作成します。各ノードは、データ表で一つの列になります。
データ表には二つの行があります。一つはヘッダーであり、もう一つはその下に配置さ
れる空の行でデータホルダーとして作用します。二番目の行はデータをインポートする
と展開します。
補足 XML ソースツリーには、単一値ノードとコレクションノードの二種類のノード
が含まれます。単一値ノードをスプレッドシートに配置すると、単一セルにリンク
され、そのセルだけが強調表示されます。コレクションノードをスプレッドシート
に配置すると、Excel アプリケーションは自動的に二行でデータ表を作成します。
スプレッドシートで単一値ノードにマップされたフィールドは、XML ソースパネル
が表示されないかぎり、データがインポートされる前に表示されません。データ表
は常に表示されます。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
175
A
よくある質問
データ表に関する質問
データ表は、XML ソースツリーにリンクされていない列を有することができます。
Custom reports では二つの目的でこれらの列を使用できます :
• 前の列のスペースが不十分である場合、文字のスペースを確保するため。例えば、
長い化合物名に対応するために、リンクされていない列を使用できます。
• 他の列に基づいた値をプレフォーマットするために Excel 数式を使用して派生列を作
成するには、二行目に数式を入力します。Excel アプリケーションは、データをイン
ポートした後に自動的に展開し、すべての行でこれらを計算します。
図 89. データがインポートされる前のデータ表
 データをインポートするには
1. [Developer] タブをクリックして [Developer] 機能を表示させます。
2. [Import] をクリックします。
[Import XML] ダイアログボックスが開きます。
重要 Excel はデータのインポートを元に戻せないので、データをインポートする
前に常にテンプレートを保存します。テンプレートが壊れるのを防ぐために、イ
ンポートされたデータとともにテンプレートを保存しないでください。
3. .xml ファイルを選択し、[Import] をクリックします。
Excel アプリケーションは、スプレッドシートにデータをプレビュー設定します。
176
TraceFinder Custom reports のチュートリアル
Thermo Scientific
A よくある質問
データ表に関する質問
図 90. インポートされたデータのプレビュー
データ表で列を追加または挿入するには、どうすればよいですか？
スプレッドシートにおいて、既存の Excel データ表の最初または最後にのみ XML ソース
ノードを配置できます。列がすでに XML ソースにマップされている場合、データ表の
中にソースノードは配置できません。もし配置した場合、次のエラーメッセージが表示
されますが、マップされていない列では任意でソースノードを配置できます。
 データ表の中にノードを配置するには
1. 次のうちの一つを行います :
a. ツリーノードをデータ表の最初または最後に配置します。
b. データ表内の任意の場所に列を移動します。
データ表内での列の移動に関する詳細は、95 ページの『レポートヘッダーを作
成する』を参照してください。
- または a. 列を右クリックして [Insert] > [Table Columns to the Left] を選択し、空 ( マップさ
れていない ) の列を挿入します。
新しい列 ( 通常 [Column1] と呼ばれる ) はマップされていません。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
177
A
よくある質問
データ表に関する質問
b. これにツリーノードをドラッグしてドロップします。
2. 次のフォーマットに関するエラーメッセージが表示されたら、[Match Element Data
Type] をクリックして閉じます。
 マップされたノードを確認するには
次のうちの一つを行います :
• 列を選択します。
列がツリーノードにマップされている場合、Excel アプリケーションは [XML Source]
ツリーでマップされているノードを選択して太字フォントで表示します。
- または • XML ソースツリーでマップされているノードを選択します。
すべてのマップされているノードは太字フォントで表示されます。ノードが列にマップ
されている場合、Excel アプリケーションはデータ表で列を自動的に選択します。
空の列を挿入して XML ソースノードを空の列にドラッグする場合、デフォルトの列
ヘッダーは変わりません。
詳細な説明は、95 ページの『レポートヘッダーを作成する』を参照してください。
データ表から列を削除するには、どうすればよいですか？
データ表から列を削除する必要がある場合があります。
• データ表で列を含むスプレッドシートの列全体を削除するには、列ヘッダーセルを
右クリックしてショートカットメニューから [Delete] を選択します。
補足 [Delete] キーを押しても列は削除されません。
• データ表の外側の列を削除せずにデータ表の列を削除するには、列を右クリックし
て [Delete] > [Table Columns] を選択します。
• XML ソースツリーからマッピングを削除するには、太字フォントで表示されている
ノードを右クリックして [Remove Element] を選択します。
このステップで、このノードとデータ表の列の間のリンクが削除されますが、デー
タ表の列は削除されません。データ表の列はマッピングが解除されますが、過去の
名前が残ります。
詳細な説明は、95 ページの『レポートヘッダーを作成する』を参照してください。
178
TraceFinder Custom reports のチュートリアル
Thermo Scientific
A よくある質問
データ表に関する質問
データ表で列を移動するには、どうすればよいですか？
データ表で列を移動するにはこの手順に従います。
 表の列を移動するには
1. 列を選択し、マウスカーソルを選択されたセルの境界線の上でホールドします。
2. ポインターが [Resize All] に変化したら、列を新しい位置にドラッグします。
図 91. 表の列を移動する
詳細な説明は、95 ページの『レポートヘッダーを作成する』を参照してください。
データ表の列が XML ソースにリンクされていることを確認するには、どう
すればよいですか？
データ表の列は、XML ソースにマップされている場合もあればマップされていない場合
もあります。マップされているかを確認するには、[Developer] > [Source] を選択して
XML ソースパネルを開き、スプレッドシートで確認する列をクリックします。マップさ
れている列に対しては、Excel アプリケーションは XML ソースツリーの中でマップされ
ているノードを自動的に選択します。このノードは、表示エリアで自動的に表示されま
す。
XML ソースウィンドウの太字フォントで表示されているすべてのノードは、マップされ
ているノードです。XML ソースツリーで太字フォントで表示されているノードをクリッ
クすると、Excel アプリケーションは、マップされているフィールドまたは列を表示させ
ます。
詳細な説明は、95 ページの『レポートヘッダーを作成する』を参照してください。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
179
A
よくある質問
データ表に関する質問
スプレッドシートに多くのデータ表が表示されるのはなぜですか？
XML ソースツリーからノードをドラッグして別のノードの隣に配置すると、Excel は自
動的にそれらを一つのデータ表に結合します。
 二つの隣り合ったノードの自動結合を制御するには
1. [Developer] > [Source] を選択します。
2. [Options] をクリックし、[Automatically Merge Elements When Mapping] を選択します。
図 92. ノードを一つのデータ表に自動的に結合する
[Automatically Merge Elements When Mapping] は、デフォルトで選択されています。この
チェックボックスを選択しない場合、Excel は XML ソースからノードをドロップするご
とに新しいデータ表を作成するので、スプレッドシートに複数のデータ表が表示される
可能性があります。
Excel はまた、ノードを既存のデータ表に隣接していないセルに配置すると新しいデータ
表を作成します。[Automatically Merge Elements When Mapping] オプションは、この動作に
影響を与えません。
データ表を個別に作成する場合、それらを後で結合することはできません。
スプレッドシートの各データ表は、次の例が示すように右下にある小さなトライアング
ルでマークされています。A 列および B 列は一つのデータ表に属します。C 列および D
列は個別のデータ表です。
180
TraceFinder Custom reports のチュートリアル
Thermo Scientific
A よくある質問
データ表に関する質問
図 93. 三角形のデータ表マーカー
データ表マーカー
Excel は、[Table1] または [Table2] などのデフォルト名を各データ表に自動的に割り当てま
す。[Formulas > Name Manager] を選択すると、次の図が示すように、これらの名前が
[Name Manager] ダイアログボックスに表示されていることを確認できます
図 94. [Name Manager] ダイアログボックスのデータ表のデフォルト名
サーモフィッシャーサイエンティフィックは、自動的に割り当てられたデータ表の名前
を数式や VBA コードで参照できる特徴的な名前に変更することを推奨します。
二つの列の間にスペースを設けたい場合があります。例えば、長い化合物名に対応する
ために十分なスペースを設けたいとします。このために、個別の表を作成しないでくだ
さい。それで解決する場合もありますが、代わりに空の列を作成してください。説明
は、39 ページの『空の列を追加する』を参照してください。
一つのデータ表と個別のデータ表の影響は、XML ソースツリーの異なるレベルからノー
ドを配置するか、データ表にソースデータをインポートするまでは明確にならない可能
性があります。次の図で、A 列および B 列は一つのデータ表に属します。C 列および D
列は個別のデータ表です。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
181
A
よくある質問
データ表に関する質問
図 95. 一つのデータ表 (A 列と B 列 ) と二つの個別のデータ表 (C 列と D 列 )
「LevelName」は化合物のサブコレクションです。B 列および D 列では、フッ素 (fluorene)
とベンゾピレン (benzo[a]pyrene) 以外、一つの化合物に三つのキャリブレーションレベル
があります。これらは内標準化合物でキャリブレーションレベルと関連しません。
182
TraceFinder Custom reports のチュートリアル
Thermo Scientific
A よくある質問
データ表に関する質問
三番目および四番目の列は XML ソースに直接マップされています。しかし、最初の
データ表では、各「CompoundName」は「LevelName」ごとに繰り返されており、各
「LevelName」は「CompoundName」ごとに繰り返されています。
例えばベンゼン (benzene) などのターゲット化合物は、複数のキャリブレーションレベル
を有することができますが、フッ素 (fluorene) などの内標準化合物にはキャリブレーショ
ンレベルがありません。D 列などの個別のデータ表で「LevelName」をマップする場合、
フッ素 (fluorene) などの内標準化合物にはエントリーがありません。しかし、
「CompoundName」および「LevelName」を A 列および B 列などの一つのデータ表にとも
にマップすると、対応する「LevelName」が空であるにも関わらずフッ素 (fluorene) がリ
ストに表示されます。
新しいレポートを作成する場合、個別のデータ表をいつ使用し、いつ使用しようしない
のか決定するために役立つことから、一つのデータ表と個別のデータ表の違いを認識す
ることは大変重要です。付属の High Density Sample Report Long 2 テンプレートに、これ
らの二つのデータ表を一緒に使用する方法の例があります。
データをインポートした後にテンプレートから削除するには、どうすれば
よいですか？
データのインポートは、Excel で元に戻すことのできない操作の一つです。サーモフィッ
シャーサイエンティフィックは、データをインポートする前にテンプレートを保存する
ことを推奨します。データをインポートした後にテンプレートを保存しないでくださ
い。
補足 インポートされたデータをテンプレートに残した場合、テンプレートの開発者
を混乱させるかもしれませんが、データは実行時に上書きされるので、レポート作
成において問題になりません。
インポートされたデータでテンプレートを保存した場合、これらの手順に従ってテンプ
レートからデータを削除できます :
• 単一値セルの場合、セルを選択して [Delete] キーを押して文字を削除します。セルの
マッピングは削除されません。
• データ表の場合、ヘッダー行を除く表全体を選択し、右クリックして
[Delete] > [Table Rows] を選択します。データ表全体を削除してしまうことを回避する
ためにヘッダー行を除外しなければなりません。[Delete] キーを押してもテンプレー
トから文字しか削除されず、データ表を二行に縮小することはありません。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
183
A
よくある質問
データ表に関する質問
データをインポートした後にデザインインターフェイスのレイアウトが変
更するのはなぜですか？
データをインポートした後にデザインインターフェイスのレイアウトが変更している場
合、[Adjust Column Width] プロパティのデフォルトが [True] に戻ったことが考えられま
す。
 [Adjust Column Width] プロパティをオフにするには
1. Excel スプレッドシートで [Developer] タブをクリックします。
2. 関連するマップを選択します。
3. [Map Properties] をクリックします。
[XML Map Properties] ダイアログボックスが開きます。
4. [Adjust Column Width] チェックボックスを解除します。
このチェックボックスを選択すると、データをインポートした時に、データを適合
させようとしてセルが展開し、結果としてインターフェイスのレイアウトが変更し
ます。このチェックボックスはデフォルトで選択されています。しかし、サーモ
フィッシャーサイエンティフィックは、レイアウトデザインを保存するためにすべ
ての XML マップに対してこのチェックボックスを解除することを推奨します。
184
TraceFinder Custom reports のチュートリアル
Thermo Scientific
A よくある質問
データ表に関する質問
レポートで同じフィールドを一回以上使用するには、どうすればよいです
か？
XML ソースのツリーノードは、一回のみ使用できます。すでにマップされているツリー
ノードをスプレッドシートにドラッグしようとすると、次のエラーメッセージが表示さ
れます。
Custom reports では、フィールドが一回以上必要な場合は常に個別の XML マップを使用
します。XML マップは同じファイルに必要な回数だけ追加できます。
図 96. 同じファイルに追加された複数のマッピング
インポートする .xml ファイルが一つしかないので、この .xml ファイルをインポートする
場合にアドインコンポーネントはすべてのマップを設定します。
[SampleCentricExportBatch_Map]、[SampleCentricExportBatch_Map1] などのデフォルト名を
維持しなければなりません。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
185
A
よくある質問
データ表に関する質問
XML マップをワークブックに追加するには、どうすればよいですか？
XML マップはワークブックに追加できます。
 XML マップをワークブックに追加するには。
1. Excel スプレッドシートで、[Developer] タブをクリックしてすべての [Developer] 機能
を表示させます。
2. [Source]
をクリックします。
3. [XML Maps] をクリックします。
[XML Maps] ダイアログボックスが開きます。すべての既存のマップが一覧表示され
ます。
[XML Maps] ダイアログボックスを使用して新しいマップを追加、名前変更、または削除
ができます。
数式を強制的に再計算するには、どうすればよいですか？
Excel アプリケーションにシートの数式を再計算させたい場合、データをコピーする前に
VBA コードで [Application.Calculate] 機能を呼び出します。
186
TraceFinder Custom reports のチュートリアル
Thermo Scientific
A よくある質問
データ表に関する質問
データ表の数式が展開しないのはなぜですか？
新しい列をデータ表に追加する場合、セルのフォーマットはデフォルトで [Text] になり
ます。[Text] フォーマットでは、セルに入力した数式は文字として表示され、データ表
にデータをインポートしても展開しません。次の例にある B2 セルが示すように、セル
の等号 (=) は、計算されるセルと区別され、[Text] フォーマットととして識別されます。
図 97. 等号でマークされた [Text] フォーマットのセル
 データ表で数式を展開するには
1. 次の例が示すように、手動でセルフォーマットを [General] フォーマットなどの別の
フォーマットに変更します。
図 98. 等号がない [General] フォーマットのセル
2. データ表全体でセルフォーマットを更新するには、各セルをクリックして [ENTER]
を押します。
[RawFileName_SampleCentricData.xml] ファイルはどこにありますか？
TraceFinder アプリケーションは、実行するバッチまたはサンプルをレポートするために
Custom report を選択する場合、[RawFileName_SampleCentricData.xml] ファイルを作成しま
す。このファイルにはすべてのサンプル特有のデータが含まれており、Custom reports に
より使用される唯一のファイルです。ファイルは通常、バッチの [Data] フォルダにあり
ます :
C:\Thermo\TraceFinder\1.1\Projects\PROJECTNAME\SUBPROJECTNAME\
BATCHNAME\Data
ファイルの場所の例 :
C:\Thermo\TraceFinder\1.1\Projects\ProjectA\SubprojectA\ ML_BATCH_01\Data
テンプレートをテストするために [Start] メニューの [Run] ボックスを使用する場合、
[Run] ボックスでテンプレートに正しいパスを渡す限り、このファイルをローカルドラ
イブの任意の場所に配置できます。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
187
データ表が編集できないのはなぜですか？
作成されたレポートでデータ表を編集しようとすると、Excel から次のエラー
メッセージを受け取る可能性があります。
シートをグループ化することにより、このエラーメッセージが表示されます。グ
ループ化されたシートは、Excel スプレッドシートで選択されたシートです。作
成されたレポートに複数のシート ( タブ ) が含まれる場合、アドインコンポーネ
ントは自動的にそれらを一緒にグループ化し、すべてのシートのページに連続的
に番号を付けます。このグループ化が行われない場合、各シートのページは 1 か
ら始まり、通常望ましくありません。
無効なシートをクリックすることにより、このグループ化を解除できます。ま
た、任意のタブを右クリックしてメニューから [Ungroup Sheets] を選択すること
によりグループ化を解除することもできます。シートを再びグループ化するに
は、タブを右クリックし、メニューから [Select All Sheets] を選択します。
図 99. 複数のシートのグループ化を解除する
手動でグループ化を解除する場合、ページ番号が正しいことを確認するために編
集後と印刷前に必ずグループ化を復元してください。
A よくある質問
画像処理に関する質問
画像処理に関する質問
このセクションの質問は、TraceFinder Custom reports での画像処理に関連します。
• レポートに画像を追加するには、どうすればよいですか？
• レポートから画像を削除するには、どうすればよいですか？
レポートに画像を追加するには、どうすればよいですか？
TraceFinder アプリケーションは、[RawFileName_SampleCentricData.xml] ファイルに埋め込
まれたバイト配列として画像をエクスポートします。しかし、Excel スプレッドシートは
画像をバイト配列に直接変換できません。画像のバイト配列は通常大きすぎるため、セ
ルに直接配置することができません。
この制限への対処法として、イメージノードをスプレッドシートにドラッグアンドド
ロップする場合、アドインコンポーネントは、このイベントを取り込み、ドラッグする
画像のプレースホルダーとして作用する名前付き範囲を作成するように指示します。
画像は、VBA コードの [CreateImage] と呼ばれる特別なアドイン機能を介して、このプ
レースホルダーにロードされます。詳細は、198 ページの『Public Function CreateImage』
を参照してください。
補足 エクスポートされた XML ファイルのすべての画像ノードには、その名前に接尾
辞「Image」が付けられます。例えば、サンプルの TIC 画像は
[SampleTotalIonCurrentImage] となります。この命名規則により、アプリケーションが
画像を適切に処理できるように、アドインがドラッグアンドドロップイベントを画
像として取り込むことが可能になります。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
189
A
よくある質問
画像処理に関する質問
 レポートに画像を追加するには
1. XML ソースツリーから画像ノードをスプレッドシートににドラッグします。
[Edit Graphic] ダイアログボックスが開きます。
このダイアログボックスに表示されているツリーは、名前に接尾辞「Image」が付け
られた画像ノードのみを表示しています。現在選択されているツリーノードは自動
的に強調表示されます。
2. [Edit Graphic] ダイアログボックスで図の名前とセル範囲を指定します。
ヒント [Edit Graphic] ダイアログボックスの [Range for This Graphic] ボックスで範
囲を直接入力するか、右のリストからセルを選択できます。
ヒント VBA コードはセルを直接参照できるので、画像に名前付き範囲のプレー
スホルダーを作成する必要はありません。しかし、画像に名前付き範囲を作成す
るとメンテナンスが後でより簡単になります。
[CreateImage] 機能のシンタックスについては、198 ページの『Public Function CreateImage』
を参照してください。
190
TraceFinder Custom reports のチュートリアル
Thermo Scientific
A よくある質問
デバッグに関する質問
レポートから画像を削除するには、どうすればよいですか？
画像は VBA コードを介してロードされているので、画像を削除したい場合、テンプレー
トが基礎としている対応する VBA コードを削除しなければなりません。画像を削除する
場合、スプレッドシートで画像用に確保されているセルも削除または非表示により削除
しなければなりません。付属の Quantitation Report でこの使用例を見ることができます。
ここでは TIC 画像の表示 / 非表示が
[SampleCentricExportBatch/MethodHeaderData/ShowChromatogramOnQuanReport] ノードの値
により制御されています。
デバッグに関する質問
このセクションでは、VBA コードのデバッグに関する情報を提供します。
• テンプレートが基礎としている VBA コードをデバッグするには、どうすればよいで
すか？
• アドインコードをデバッグするには、どうすればよいですか？
テンプレートが基礎としている VBA コードをデバッグするには、どうすれ
ばよいですか？
テンプレートが基礎としている VBA コードをデバッグするには数種類の方法があります
が、最初にテンプレートの実行を停止しなければなりません。テンプレートはデフォル
トで実行されますが、変数が定義されていないにもかかわらず、停止します。これは、
コードモジュールの始めに [Option Explicit] 命令文が含まれているものと推定されます。
VBA では、コードは必要に応じてコンパイルされます。プロセスは、機能をコンパイル
できない場合、実行を停止します。コードモジュールの始めに [Option Explicit] 命令文が
含まれている場合、VBA はすべての変数がそれらを使用する前に明確に確実に定義され
ていることを要求します。定義されていない新しい変数を機能で追加している場合、テ
ンプレートは機能の開始する前に停止します。
 VBA コードをデバッグするには
1. コードのどこに問題があるかを推定します。
2. その場所の任意の変数を定義されていない変数に変更します。
コードをコンパイルしようとすると、コンパイラエラーが表示されますが、デバッ
グ目的でこのエラーを無視することができます。
3. テンプレートを実行します。
コンパイラは、定義されていない変数がある機能を開始する前に停止します。
4. 変数の変更を元に戻してコードにブレイクポイントを設定し、F5 キーを押してプロ
グラムを実行します。
プログラムは、この機能で設定した最初のブレイクポイントで停止します。停止後、
通常どおりコードの手順を進められます。常にスプレッドシートに切り替えて、そ
の時点でコードがどのように作用しているかを確認することができます。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
191
A
よくある質問
デバッグに関する質問
アドインコードをデバッグするには、どうすればよいですか？
アドインコードは、レギュラーの VBA プロジェクトです。191 ページの『テンプレート
が基礎としている VBA コードをデバッグするには、どうすればよいですか？』で説明し
た手順と同じ手順を使用してアドインコードをデバッグを行えます。アドインプロジェ
クトはパスワード保護されているという点のみが異なります。いずれかのパスワード保
護されているモジュールでエラーが発生すると、一般の [Microsoft Visual Basic] エラー
メッセージが作成されます。
エラーのデバッギングを行うには、有効なパスワードでアドインプロジェクトのロック
を解除します。プロジェクトのロック解除後、他の VBA コードと同様にデバッギングを
行えます。
192
TraceFinder Custom reports のチュートリアル
Thermo Scientific
B
Custom Report のアドイン API
Excel アドインコンポーネントである Custom report アドインアプリケーションプログラミ
ングインターフェイス (API) は、Excel テンプレートを使用することにより、レポートを
カスタマイズするためのフレームワークを提供します。
アドインファイルは [Thermo Report Add-In.xla] と呼ばれ、通常
[C:\Thermo\Shared\Templates\Reports] フォルダにインストールされます。アドインコン
ポーネントは通常テンプレートと関連しており、関連のテンプレートを開くか使用する
場合にのみロードされます。
アドインコンポーネントは、以下の二つを主に実行します :
• Custom Report の作成を自動化する。
• テンプレート開発者が使用できる数種類のヘルパー関数 (APIs) を提供する。
第 2 章、『概要』、では、Custom reports の自動作成について紹介します。この付録では、
テンプレート VBA コードで使用できるすべての Public APIs を説明します。大部分の
Custom reports はアドインコードを変更せずに作成できます。
内容
• Public Sub SetupPageHeader
• Public Sub SetupPageFooter
• Public Function CreateImage
• Public Sub CopyPaste
• Public Function IsXPath
• Public Function HiddenRowCount
• Public Function VisibleRowCount
• Public Function Contains
• Public Sub ShowErrMsg
• Public Sub CheckRequiredName
Thermo Scientific
TraceFinder Custom reports のチュートリアル
193
B
Custom Report のアドイン API
内容 ( つづき )
• Public Sub CheckRequiredNameInsideOf
• Public Sub CheckRequiredNameOutsideOf
• Public Sub CheckOptionalName
• Public Sub AddTextAsWatermark
• Public Sub AddNamedShapeAsWatermark
• Public Function GetXmlElement
• Public Function GetXmlNodesText
• Public Function NameExists
• Public Function GetNamedRange
• Public Sub HideColumns
• Public Sub SetPageBreakAt
• Public Sub SetFrame
• Public Function GetRowIndex
• Public Function GetColCount
• Public Function GetRowCount
• Public Function ColumnNumber
• Public Function DeleteName
• Public Function DeleteName
• Public Function GetListColumn
• Public Function Value
• Public Function GetValue
• Public Function HideListColumn
• Public Sub SortList
• Public Sub EnumerateColumn
• Public Function CreatePivotTable
• Public Sub SetManuallyIntegrated
• Public Sub ReformatManuallyIntegrated
• Public Sub SetNoData
194
TraceFinder Custom reports のチュートリアル
Thermo Scientific
B
Custom Report のアドイン API
内容 ( つづき )
• Public Sub HideRepeatArea
• Public Sub FormatValue
• Public Sub ReplaceValue
• Public Function ShiftRange
• Public Function GetText
• Public Sub MergeRowCells
• Public Function ArraySize
• Public Sub LogMsg
• Public Function GetValidSheetName
• Public Function FileExists
この付録に記されているすべての API 関数は Util クラスに存在します。パブリックイン
スタンス (mUtil) は、例えば [mUtil.ShiftRange(…)] などのように、アドインコンポーネン
トを参照するすべてのテンプレートが直接使用できるように、アドインの [Module1] で
作成されます。
補足 アドインソースコードにアクセスできる場合、この付録に記されているよりも
多くの API を見つけることができます。これらのうちの数種類は旧バージョンの
Excel アプリケーションのために作成されており現在は必要ではありませんが、下位
互換性のために維持されています。
ヒント アドイン VBA プロジェクト (ThermoReportAddIn) はパスワード保護されてい
ます。しかし、アドインソースコードにアクセスしなければならない場合、パス
ワードについてサーモフィッシャーサイエンティフィックの担当者までお問い合わ
せください。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
195
B
Custom Report のアドイン API
Public Sub SetupPageHeader
Public Sub SetupPageHeader
Public Sub SetupPageHeader(Optional ByVal withPrintTimestamp As Boolean = True)
目的
この関数は、一般的に レポートで使用されるデフォルトのページヘッダーを提供しま
す。
通常 [IUtil] インターフェイスが実行されている場合に呼び出されます。デフォルトの
ヘッダーが必要ではない場合、[MyUtil] クラスの [IUtil_SetupPageHeader()] からこの部分
を削除してください。
パラメータ
次の表に、[Public Sub SetupPageHeader] シンタックスで値を提供しなければならないパラ
メータが示されています。
表 2. [Public Sub SetupPageHeader] パラメータ
パラメータ
説明
withPrintTimestamp
レポートを印刷する場合、ページ中央の二行目にページヘッ
ダーがタイムスタンプを含むかを指定します。
• True: ヘッダーにタイムスタンプを含めます。
• False: ヘッダーにタイムスタンプを含めません。
デフォルトでは [True] になっています。
このパラメータはオプションです。
196
TraceFinder Custom reports のチュートリアル
Thermo Scientific
B
Custom Report のアドイン API
Public Sub SetupPageFooter
Public Sub SetupPageFooter
Public Sub SetupPageFooter(text As String, Optional bottomMarginInInch As Double
= 0.75, Optional picFileName As String)
目的
この関数は、一般的に レポートで使用されるデフォルトのページフッターを提供しま
す。
この関数は、通常 [IUtil] インターフェイスが実行されている場合に呼び出されます。デ
フォルトのフッターが必要ではない場合、[MyUtil] クラスの [IUtil_SetupPageFooter()] から
この部分を削除してください。
パラメータ
次の表に、[Public Sub SetupPageFooter] シンタックスで値を提供しなければならないパラ
メータが示されています。
表 3. [Public Sub SetupPageFooter] パラメータ
パラメータ
説明
text
フッターテキストを指定します。
bottomMarginInInch
ページの下の余白をインチで指定します。
デフォルトは 0.75 です。
このパラメータはオプションです。
picFileName
表示される画像ファイル ( フルパス ) を指定します。
このパラメータにはデフォルトがありません。
このパラメータはオプションです。
フッターには一つの画像のみが表示可能です。
Excel アプリケーションに画像の表示位置を示すために、文字
列には「&G」が含まれていなければなりません。文字列に
「&G」が含まれていない場合、画像は表示されません。
画像ファイルを設定しない場合、
[C:\Thermo\Shared\Templates\Reports] レポートフォルダの .jpg 画
像が表示されます。これは、凡例で手動積分を示すために使
用されます。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
197
B
Custom Report のアドイン API
Public Function CreateImage
Public Function CreateImage
Public Function CreateImage(ByVal target, ByVal imagePath As String, Optional
ByVal cropTop As Long = 1, Optional ByVal cropLeft As Long = 1, Optional ByVal
cropRight As Long = 1, Optional ByVal cropBottom As Long = 1) As String
目的
この関数は、XML ファイルからの imagePath でバイト配列に基づいた画像を作成し、そ
のターゲットの場所を指定します。
パラメータ
次の表に、[Public Function CreateImage] シンタックスで値を提供しなければならないパラ
メータが示されています。
表 4. [Public Function CreateImage] パラメータ
パラメータ
説明
target
名前付き範囲 ( 例えば ［QuanChart］) またはセル範囲 ( 例え
ば、Sheet1!A1:E5) のどちらかによりセルの範囲を指定して画像
を設定する場所を示します。
imagePath
完全な [XPath] を XML ソースツリーの画像ノードに指定しま
す。次はその例です :
SampleCentricExportBatch/Samples/
SampleCentricExportSample/Compounds/
SampleCentricCompoundExportData
[CompoundKey='" & compId & "']/
QuanResult/QuanPeakResults/
CompoundQuanPeakResultExportData/
PeakImage.
cropTop
画像の上部でどの程度切り取るかを指定します。
デフォルトは 1 です。
このパラメータはオプションです。
cropLeft
画像の左側でどの程度切り取るかを指定します。
デフォルトは 1 です。
このパラメータはオプションです。
cropRight
画像の右側でどの程度切り取るかを指定します。
デフォルトは 1 です。
このパラメータはオプションです。
cropBottom
画像の下部でどの程度切り取るかを指定します。
デフォルトは 1 です。
このパラメータはオプションです。
198
TraceFinder Custom reports のチュートリアル
Thermo Scientific
B
Custom Report のアドイン API
Public Function CreateImage
表示例
DCC Report での例をここに示します :
mUtil.CreateImage mUtil.ShiftRange("QuanChart", cc, rr, cc, rr),
"SampleCentricExportBatch/Samples/SampleCentricExportSample/Compounds/Sample
CentricCompoundExportData[CompoundKey='" & compId & "']
/QuanResult/QuanPeakResults/CompoundQuanPeakResultExportData/
PeakImage", 20, 5, 12, 2
この例では :
• [target] パラメータは、シフトされた名前付き範囲です。
• [imagePath] は、化合物同定を指定する表現の [XPath] です。
• 画像を囲むすべての余白が切り取られています : 上部は 20、左側は 5、右側は 12、
および下部は 2 です。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
199
B
Custom Report のアドイン API
Public Sub CopyPaste
Public Sub CopyPaste
Public Sub CopyPaste(ByVal source, ByVal target, Optional ByVal inclRowHeight As
Boolean = True, Optional ByVal valueOnly = False, Optional ByVal copyFormula =
True)
目的
この関数は、主に [Clipboard] の使用を回避するために Excel アプリケーションの
[Selection.Copy] を置き換えます。レポート処理は通常バックグラウンドで実行され、あ
る程度の時間を要します。[Clipboard] を使用してスプレッドシートにデータを動かす場
合、間違って不正確なレポートを作成する可能性があります。
この関数は、特に大量のデータをコピーする場合、Excel アプリケーションの
[Selection.Copy] 関数よりも遅くなります。[Clipboard] の使用を希望し、アプリケーショ
ンがバックグラウンドでレポートを作成している間にコンピューターを使用しないこと
が分かっている場合、[UseClipboard] グローバルパラメータを [Util] クラスで [True] に設
定することにより、Excel アプリケーションの [Selection.Copy] 関数に切り替えることがで
きます。また、[/b] コマンドラインオプションを使用して切り替えることもできます。
パラメータ
次の表に、[Public Sub CopyPaste] シンタックスで値を提供しなければならないパラメータ
が示されています。
表 5. [Public Sub CopyPaste] パラメータ ( シート 1/2)
パラメータ
説明
source
名前付き範囲 ( 例えば ［DataTable］) またはセル範囲 ( 例えば、
TempSheet!A1:E5) によりセルの範囲を指定してコピーするソースの
場所を示します。
target
セルの範囲を指定し、コピー先の場所を示します。名前付き範囲
( 例えば、[ChartLegend]) またはセル範囲 ( 例えば、
[TempSheet!A1:E5]) により、この範囲を指定できます。ターゲッ
トセル範囲はソースセル範囲と一致する必要はありません。ソー
スセル範囲よりも小さい場合、コピーされたすべてのソースセル
の大きさに展開します。貼り付けするターゲットの最初のセルだ
けの場合もあります。
inclRowHeight
ターゲットに行の高さがコピーされるべきかを指定します。
• True: ターゲットに行の高さをコピーします。
• False: ターゲットに行の高さをコピーしません。
デフォルトでは [True] になっています。
このパラメータはオプションです。
200
TraceFinder Custom reports のチュートリアル
Thermo Scientific
B
Custom Report のアドイン API
Public Sub CopyPaste
表 5. [Public Sub CopyPaste] パラメータ ( シート 2/2)
パラメータ
説明
valueOnly
セルのフォーマットおよび数式が値とともにコピーされるかを決
定します。
• True: セルの値のみをコピーします。
• False: セルの値に加えてフォーマットおよび数式をコピーしま
す。
デフォルトでは [False] になっています。
このパラメータはオプションです。
copyFormula
• 数式がコピーされるかを指定します。
• True: 数式をコピーします。
• False: 数式をコピーしません。
デフォルトでは [True] になっています。
このパラメータはオプションです。[valueOnly] パラメータを
[False] に設定した場合にのみ有効になります。
表示例
次の例では、[tempSheet] シートのセル M2 からセル M29 を [Sheet1] のセル H51 から開始
してコピーします。これには行の高さの調整は含まれず、文字の値のみをコピーします
( フォーマットまたは数式は含みません )。
mUtil.CopyPaste "tempSheet!M2:M29", "Sheet1!H51", False, True
Thermo Scientific
TraceFinder Custom reports のチュートリアル
201
B
Custom Report のアドイン API
Public Function IsXPath
Public Function IsXPath
Public Function IsXPath(ByVal rng As Range) As Boolean
目的
この関数は、特定のセルまたはセル範囲に有効な [XPath] が含まれるかを決定します。
この関数を含める理由は、有効な [XPath] ではない時に値がアクセスされた場合、Excel
アプリケーションが例外処理を実行してしまうことを回避するためです。
パラメータ
次の表に、[Public Function IsXPath] シンタックスで値を提供しなければならないパラメー
タが示されています。
表 6. [Public Function IsXPath] パラメータ
パラメータ
説明
rng
名前付き範囲 ( 例えば ［DataTable］)、セル範囲 ( 例えば、
TempSheet!A1:E5)、またはセルによりセルの範囲を指定します。
• True: セルまたはセル範囲に有効な [XPath] が含まれます。
• False: セルまたはセル範囲に有効な [XPath] が含まれません。
202
TraceFinder Custom reports のチュートリアル
Thermo Scientific
B
Custom Report のアドイン API
Public Function HiddenRowCount
Public Function HiddenRowCount
Public Function HiddenRowCount(ByVal Range1) As Long
目的
この関数は、指定されたセル範囲の非表示行の数をかえします。主に、コピー場所を計
算するために使用されます。例えば、Quantitation Report で使用されます。
パラメータ
次の表に、[Public Function HiddenRowCount] シンタックスで値を提供しなければならな
いパラメータが示されています。
表 7. [Public Function HiddenRowCount] パラメータ
Thermo Scientific
パラメータ
説明
Range1
名前付き範囲 ( 例えば ［DataTable］)、セル範囲 ( 例えば、
TempSheet!A1:E5)、またはセルによりセルの範囲を指定します。
TraceFinder Custom reports のチュートリアル
203
B
Custom Report のアドイン API
Public Function VisibleRowCount
Public Function VisibleRowCount
Public Function VisibleRowCount(ByVal Range1) As Long
目的
この関数は、指定されたセル範囲の表示行の数をかえします。主に、コピー場所を計算
するために使用されます。例えば、Quantitation Report で使用されます。
パラメータ
次の表に、[Public Function VisibleRowCount] シンタックスで値を提供しなければならない
パラメータが示されています。
表 8. [Public Function VisibleRowCount] パラメータ
204
パラメータ
説明
Range1
名前付き範囲 ( 例えば ［DataTable］)、セル範囲 ( 例えば、
TempSheet!A1:E5)、またはセルによりセルの範囲を指定します。
TraceFinder Custom reports のチュートリアル
Thermo Scientific
B
Custom Report のアドイン API
Public Function Contains
Public Function Contains
Public Function Contains(ByVal Range1, ByVal Range2) As Boolean
目的
この関数は、ある範囲に別の範囲が含まれるかを決定します。この関数は主に、名前付
き範囲をチェックするために [Validate()] 関数で使用されます。
パラメータ
次の表に、[Public Function Contains] シンタックスで値を提供しなければならないパラ
メータが示されています。
表 9. [Public Function Contains] パラメータ
パラメータ
説明
Range1
名前付き範囲 ( 例えば ［DataTable］)、セル範囲 ( 例えば、
TempSheet!A1:E5)、またはセルによりセルの範囲を指定します。
• True: その範囲に別の範囲が含まれます。
• False: その範囲に別の範囲が含まれません。
Range2
名前付き範囲 ( 例えば ［DataTable］)、セル範囲 ( 例えば、
TempSheet!A1:E5)、またはセルによりセルの範囲を指定します。
• True: その範囲に別の範囲が含まれます。
• False: その範囲に別の範囲が含まれません。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
205
B
Custom Report のアドイン API
Public Sub ShowErrMsg
Public Sub ShowErrMsg
Public Sub ShowErrMsg(ByVal err_msg As String, ByVal warn_msg As String, Optional
ByVal showWarning As Boolean = True)
目的
この関数は、指定されたメッセージとともにダイアログボックスを表示します。この関
数は主に、名前付き範囲をチェックするために [Validate()] 関数で使用されます。
パラメータ
次の表に、[Public Sub ShowErrMsg] シンタックスで値を提供しなければならないパラメー
タが示されています。
表 10. [Public Sub ShowErrMsg] パラメータ
パラメータ
説明
err_msg
表示するエラーメッセージを指定します。
warn_msg
表示する警告メッセージを指定します。
showWarning
[err_msg] が定義されていない場合、警告メッセージが表示さ
れるかを指定します。[err_msg] が定義されている場合、メッ
セージボックスは常に表示されます。
• True:[err_msg] が定義されていない場合、警告メッセージ
を表示します。
• False:[err_msg] が定義されていない場合、警告メッセージ
を表示しません。
デフォルトでは [True] になっています。
このパラメータはオプションです。
206
TraceFinder Custom reports のチュートリアル
Thermo Scientific
B
Custom Report のアドイン API
Public Sub CheckRequiredName
Public Sub CheckRequiredName
Public Sub CheckRequiredName(err_msg As String, ByVal reqName As String,
Optional ByVal msg As String)
目的
この関数は、指定された必須の名前 (reqName) が名前付き範囲として定義されているか
を決定します。定義されていない場合、関数は msg により指定されたメッセージをエ
ラーメッセージ (err_msg) に付けます。reqName が定義されている場合、この関数はオリ
ジナルのエラーメッセージを変更しません。この関数は主に、名前付き範囲をチェック
するために [Validate()] 関数で使用されます。
パラメータ
次の表に、[Public Sub CheckRequiredName] シンタックスで値を提供しなければならない
パラメータが示されています。
表 11. [Public Sub CheckRequired Name] パラメータ
パラメータ
説明
err_msg
表示するエラーメッセージを指定します。
reqName
必須の名前付き範囲の名前を指定します。
msg
reqName が名前付き範囲として定義されていない場合、デフォ
ルトメッセージで使用するメッセージ文字を指定します。
このパラメータはオプションです。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
207
B
Custom Report のアドイン API
Public Sub CheckRequiredNameInsideOf
Public Sub CheckRequiredNameInsideOf
Public Sub CheckRequiredNameInsideOf(err_msg As String, ByVal reqName As String,
ByVal containerName As String, Optional ByVal msg As String)
目的
この関数は、reqName により指定された必須の名前が名前付き範囲として定義されてい
るか、また containerName により指定された名前付き範囲内であるかをチェックします。
定義されていない場合、関数は msg により指定されたメッセージを err_msg により指
定されたエラーメッセージに付けます。必須の名前が定義されている場合、この関数は
オリジナルのエラーメッセージを変更しません。この関数は主に、名前付き範囲を
チェックするために [Validate()] 関数で使用されます。
パラメータ
次の表に、[Public Sub CheckRequiredNameInsideOf ] シンタックスで値を提供しなければな
らないパラメータが示されています。
表 12. [Public Sub CheckRequiredNameInsideOf ] パラメータ
パラメータ
説明
err_msg
表示するエラーメッセージを指定します。
reqName
必須の名前付き範囲の名前を指定します。
containerName
コンテナセルの名前付き範囲を指定します。
msg
reqName により指定された必須の名前が、名前付き範囲として
定義されていない、また containerName により指定された範囲
外で定義されている場合に使用するメッセージ文字を指定し
ます。msg が欠けており、reqName が定義されていない場合、
この関数はデフォルトのメッセージを作成します。
このパラメータはオプションです。
208
TraceFinder Custom reports のチュートリアル
Thermo Scientific
B Custom Report のアドイン API
Public Sub CheckRequiredNameOutsideOf
Public Sub CheckRequiredNameOutsideOf
Public Sub CheckRequiredNameOutsideOf(err_msg As String, ByVal reqName As
String, ByVal containerName As String, Optional ByVal msg As String)
目的
この関数は、reqName により指定された必須の名前が、名前付き範囲として定義されて
いるか、また containerName により指定された名前付き範囲外であるかを決定します。
定義されていない場合、関数は msg により指定されたメッセージを err_msg により指
定されたエラーメッセージに付けます。必須の名前が定義されている場合、この関数は
オリジナルのエラーメッセージを変更しません。この関数は主に、名前付き範囲を
チェックするために [Validate()] 関数で使用されます。
パラメータ
次の表に、[Public Sub CheckRequiredNameOutsideOf ] シンタックスで値を提供しなければ
ならないパラメータが示されています。
表 13. [Public Sub CheckRequiredNameOutsideOf] パラメータ
パラメータ
説明
err_msg
表示するエラーメッセージを指定します。
reqName
必須の名前付き範囲の名前を指定します。
containerName
コンテナセルの名前付き範囲を指定します。
msg
reqName により指定された必須の名前が、名前付き範囲として
定義されていない、また containerName により指定された範囲
外で定義されている場合に使用するメッセージ文字を指定し
ます。msg が欠けており、reqName が定義されていない場合、
この関数はデフォルトのメッセージを作成します。
このパラメータはオプションです。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
209
B
Custom Report のアドイン API
Public Sub CheckOptionalName
Public Sub CheckOptionalName
Public Sub CheckOptionalName(info_msg As String, ByVal optName As String,
Optional ByVal msg As String)
目的
この関数は、optName により指定されたオプションの名前が、名前付き範囲として定義
されるかを決定します。定義されない場合、関数は msg により指定されるメッセージ
を info_msg により指定される情報メッセージに付けます。optName が定義されている場
合、この関数はオリジナルの情報メッセージを変更しません。この関数は主に、名前付
き範囲をチェックするために [Validate()] 関数で使用されます。
パラメータ
次の表に、[Public Sub CheckOptionalName] シンタックスで値を提供しなければならない
パラメータが示されています。
表 14. [Public Sub CheckOptionalName] パラメータ
パラメータ
説明
info_msg
表示する情報メッセージを指定します。
optName
オプションの名前付き範囲の名前を指定します。
msg
オプションの名前 (optName) が名前付き範囲として定義されて
いない場合、使用するメッセージ文字を指定します。msg が欠
けており、optName が定義されていない場合、この関数はデ
フォルトのメッセージを作成します。
このパラメータはオプションです。
210
TraceFinder Custom reports のチュートリアル
Thermo Scientific
B
Custom Report のアドイン API
Public Sub AddTextAsWatermark
Public Sub AddTextAsWatermark
Public Sub AddTextAsWatermark(text As String, rng As Range, Optional size As
Double = 40#)
目的
この関数は、レポートの各印刷ページに文字のウォーターマークを追加します。
パラメータ
次の表に、[Public Sub AddTextAsWatermark] シンタックスで値を提供しなければならない
パラメータが示されています。
表 15. [Public Sub AddTextAsWatermark] パラメータ
パラメータ
説明
text
ウォーターマークとして表示する文字を指定します。
rng
ウォーターマークを表示するために使用されるセルの範囲を
指定します。
size
ウォーターマーク文字のフォントサイズを指定します。
デフォルトは 40 です。
このパラメータはオプションです。
表示例
[ProcessSheet1Data()] 関数の終わりで次のラインを [MyDCCReport template] に追加すると、
図 100 で示されるウォーターマークが作成されます。
mUtil.AddTextAsWatermark "Thermo Custom Report", Range("Sheet1!A1:T78")
Thermo Scientific
TraceFinder Custom reports のチュートリアル
211
B
Custom Report のアドイン API
Public Sub AddTextAsWatermark
図 100. 印刷ページのウォーターマーク
212
TraceFinder Custom reports のチュートリアル
Thermo Scientific
B Custom Report のアドイン API
Public Sub AddNamedShapeAsWatermark
Public Sub AddNamedShapeAsWatermark
Public Sub AddNamedShapeAsWatermark(name As String, rng As Range)
目的
この関数は、ウォーターマークとして使用する名前付きシェイプ ( 通常、画像 ) をレ
ポートの各印刷ページに追加します。
パラメータ
次の表に、[Public Sub AddNamedShapeAsWatermark] シンタックスで値を提供しなければな
らないパラメータが示されています。
表 16. Public Sub AddNamedShapeAsWatermark parameters
Thermo Scientific
パラメータ
説明
name
ウォーターマークとして使用するシェイプ ( 通常、画像 ) の名
前を指定します。Excel アプリケーションは自動的に名前をす
べてのシェイプに割り当てます。
rng
ウォーターマークを表示するために使用されるセルの範囲を
指定します。
TraceFinder Custom reports のチュートリアル
213
B
Custom Report のアドイン API
Public Function GetXmlElement
Public Function GetXmlElement
Public Function GetXmlElement(XPath As String) As String
目的
この関数は、現在の XML ソースファイルの指定された [XPath] のエレメントコンテント
を返します。
パラメータ
次の表に、[Public Function GetXmlElement] シンタックスで値を提供しなければならない
パラメータが示されています。
表 17. [Public Function GetXmlElement] パラメータ
214
パラメータ
説明
XPath
XML ドキュメントにおいて、ノードに [XPath] を指定します。
[XPath] には表現式が含まれる可能性があります。
TraceFinder Custom reports のチュートリアル
Thermo Scientific
B
Custom Report のアドイン API
Public Function GetXmlNodesText
Public Function GetXmlNodesText
Public Function GetXmlNodesText(XPath As String) As String()
目的
この関数は、現在の XML ソースファイルの指定された [XPath] にノードを含む文字列配
列を返します。
パラメータ
次の表に、[Public Function GetXmlNodesText] シンタックスで値を提供しなければならな
いパラメータが示されています。
表 18. [Public Function GetXmlNodesText] パラメータ
Thermo Scientific
パラメータ
説明
XPath
XML ドキュメントにおいて、ノードに [XPath] を指定します。
[XPath] には表現式が含まれる可能性があります。
TraceFinder Custom reports のチュートリアル
215
B
Custom Report のアドイン API
Public Function NameExists
Public Function NameExists
Public Function NameExists(name As String) As Boolean
目的
この関数は、指定された名前付き範囲が定義されているかを決定します。
パラメータ
次の表に、[Public Function NameExists] シンタックスで値を提供しなければならないパラ
メータが示されています。
表 19. [Public Function NameExists] パラメータ
パラメータ
説明
name
チェックする名前付き範囲の名前を指定します。
• True: 指定された名前付き範囲が存在します。
• False: 指定された名前付き範囲が存在しません。
216
TraceFinder Custom reports のチュートリアル
Thermo Scientific
B
Custom Report のアドイン API
Public Function GetNamedRange
Public Function GetNamedRange
Public Function GetNamedRange(ByVal name As String, c1 As String, r1 As Long,
Optional c2 As String, Optional r2 As Long) As Boolean
目的
この関数は、指定された名前付き範囲が検出されているかを決定します。
パラメータ
次の表に、[Public Function GetNamedRange] シンタックスで値を提供しなければならない
パラメータが示されています。
表 20. [Public Function GetNamedRange] パラメータ
パラメータ
説明
name
取得する名前付き範囲の名前を指定します。
c1
名前付き範囲が検出されている場合、開始列の文字を返しま
す。
• True: 指定された名前付き範囲が存在します。残りの c1、
r1、c2、r2 オプションはセル範囲を返します。
• False: 指定された名前付き範囲が存在しません。
r1
名前付き範囲が検出されている場合、開始行の数字を返しま
す。
• True: 指定された名前付き範囲が存在します。残りの c1、
r1、c2、r2 オプションはセル範囲を返します。
• False: 指定された名前付き範囲が存在しません。
c2
名前付き範囲が検出されている場合、最終列の文字を返しま
す。
• True: 指定された名前付き範囲が存在します。残りの c1、
r1、c2、r2 オプションはセル範囲を返します。
• False: 指定された名前付き範囲が存在しません。
このパラメータはオプションです。
r2
名前付き範囲が検出されている場合、最終行の数字を返しま
す。
• True: 指定された名前付き範囲が存在します。残りの c1、
r1、c2、r2 オプションはセル範囲を返します。
• False: 指定された名前付き範囲が存在しません。
このパラメータはオプションです。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
217
B
Custom Report のアドイン API
Public Sub HideColumns
Public Sub HideColumns
Public Sub HideColumns(ByVal target, Optional ByVal hide As Boolean = True)
目的
この関数は、対象範囲を非表示または表示させます。
パラメータ
次の表に、[Public Sub HideColumns] シンタックスで値を提供しなければならないパラ
メータが示されています。
表 21. Public Sub HideColumns parameters
パラメータ
説明
target
非表示にする対象範囲を指定します。対象範囲は、名前付き
範囲 ( 例えば、[QuanChart])、セル範囲 ( 例えば、A1:E5)、行範
囲 ( 例えば、10:30)、または列範囲 ( 例えば、A:C) の場合があ
ります。
hide
対象範囲を非表示または表示するかを決定します。
• True: 対象範囲を非表示にします。
• False: 対象範囲を表示します。
デフォルトでは [True] になっています。
このパラメータはオプションです。
218
TraceFinder Custom reports のチュートリアル
Thermo Scientific
B
Custom Report のアドイン API
Public Sub SetPageBreakAt
Public Sub SetPageBreakAt
Public Sub SetPageBreakAt(ByVal target)
目的
この関数は、指定されたセルの場所またはセル範囲の開始位置でページの区切りを設定
します。
パラメータ
次の表に、[Public Sub SetPageBreakAt] シンタックスで値を提供しなければならないパラ
メータが示されています。
表 22. [Public Sub SetPageBreakAt] パラメータ
Thermo Scientific
パラメータ
説明
target
ページの区切りを設定する対象範囲を指定します。
TraceFinder Custom reports のチュートリアル
219
B
Custom Report のアドイン API
Public Sub SetFrame
Public Sub SetFrame
Public Sub SetFrame(ByVal target, Optional ByVal vLines As Boolean = False,
Optional ByVal hLines As Boolean = False)
目的
この関数は、指定されたセル範囲のまわりの境界線のフレームを設定します。オプショ
ンのパラメータを使用して水平線フレームのみを作成するか、垂直線フレームのみを作
成できます。
次の表に、[Public Sub SetFrame] シンタックスで値を提供しなければならないパラメータ
が示されています。
表 23. [Public Sub SetFrame] パラメータ
パラメータ
説明
target
境界線フレームの対象範囲を指定します。
vLines
境界線フレームに垂直線が表示されるかを指定します。
• True: 垂直線が表示されます。
• False: 垂直線が表示されません。
デフォルトでは [False] になっています。
このパラメータはオプションです。
hLines
境界線フレームに水平線が表示されるかを指定します。
• True: 水平線が表示されます。
• False: 水平線が表示されません。
デフォルトでは [False] になっています。
このパラメータはオプションです。
220
TraceFinder Custom reports のチュートリアル
Thermo Scientific
B
Custom Report のアドイン API
Public Function GetRowIndex
Public Function GetRowIndex
Public Function GetRowIndex(str As String, col As String, startRow As Long) As
Long
目的
この関数は、指定された文字列を検出しない場合、特定の列または -1 で指定された文字
列の行インデックスを返します。空のセルを検出すると検索を停止します。
パラメータ
次の表に、[Public Function GetRowIndex] シンタックスで値を提供しなければならないパ
ラメータが示されています。
表 24. [Public Function GetRowIndex] パラメータ
Thermo Scientific
パラメータ
説明
str
検索する文字列を指定します。
col
指定された文字列の列の文字を指定します。
startRow
検索を開始する行を指定します。
TraceFinder Custom reports のチュートリアル
221
B
Custom Report のアドイン API
Public Function GetColCount
Public Function GetColCount
Public Function GetColCount(row As Long, startCol As String, Optional toCol As
Long = 0) As Long
目的
この関数は、二列の間の指定された行において空ではないセルの数を返します。
パラメータ
次の表に、[Function GetColCount] シンタックスで値を提供しなければならないパラメー
タが示されています。
表 25. [Public Function GetColCount] パラメータ
パラメータ
説明
row
行番号を指定します。
startCol
カウントする最初の列の文字を指定します。
toCol
カウントする最後の列の文字を指定します。0 の場合、関数は
すべての列をカウントします。
デフォルトは 0 です。
このパラメータはオプションです。
222
TraceFinder Custom reports のチュートリアル
Thermo Scientific
B
Custom Report のアドイン API
Public Function GetRowCount
Public Function GetRowCount
Public Function GetRowCount(col, Optional startRow As Long = 1, Optional toRow As
Long = 0) As Long
目的
この関数は、指定の行の間の指定された列において空ではないセルの数を返します。
パラメータ
次の表に、[Public Function GetRowCount] シンタックスで値を提供しなければならないパ
ラメータが示されています。
表 26. [Public Function GetRowCount] パラメータ
パラメータ
説明
col
列の番号または文字を指定します。
startRow
カウントする最初の行の数字を指定します。
デフォルトは 1 です。
このパラメータはオプションです。
toRow
カウントする最後の行の数字を指定します。0 の場合、関数は
すべての行をカウントします。
デフォルトは 0 です。
このパラメータはオプションです。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
223
B
Custom Report のアドイン API
Public Function ColumnNumber
Public Function ColumnNumber
Public Function ColumnNumber(ByVal ColumnLetter As String) As Long
目的
この関数は、A 列は 1、B 列では 2 などのように、指定された列の文字を数字に変換しま
す。
パラメータ
次の表に、[Public Function ColumnNumber] シンタックスで値を提供しなければならない
パラメータが示されています。
表 27. [Public Function ColumnNumber] パラメータ
224
パラメータ
説明
ColumnLetter
列の文字を指定します。
TraceFinder Custom reports のチュートリアル
Thermo Scientific
B
Custom Report のアドイン API
Public Function DeleteName
Public Function DeleteName
Public Function DeleteName(name As String) As Boolean
目的
この関数は、名前付き範囲を削除するか、または維持するかを決定します。
パラメータ
次の表に、[Public Function DeleteName] シンタックスで値を提供しなければならないパラ
メータが示されています。
表 28. [Public Function DeleteName] パラメータ
パラメータ
説明
name
削除または維持する名前付き範囲の名前を指定します。
• True: 名前付き範囲を削除します。
• False: 名前付き範囲を維持します。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
225
B
Custom Report のアドイン API
Public Function DeleteName
Public Function DeleteName
Public Function GetUniqueList(ByVal target, Optional ByVal col As Long = 1,
Optional startIndex As Long = 1, Optional ByVal inclHiddenRows As Boolean =
False) As String()
目的
この関数は、startIndex から指定された列の文字を含む固有の文字列の配列を返しま
す。オプションで、返された配列で非表示列を含むことができます。
パラメータ
次の表に、[Public Function GetUniqueList] シンタックスで値を提供しなければならないパ
ラメータが示されています。
表 29. [Public Function GetUniqueList] パラメータ
パラメータ
説明
target
名前付き範囲、セル範囲、またはセルによりセルの範囲を指
定します。
col
リストを取得する列を指定します。
デフォルトは 1 です。
このパラメータはオプションです。
startIndex
行の開始インデックスを指定します。
デフォルトは 1 です。
このパラメータはオプションです。
inclHiddenRows
返されたリストが非表示行を含むべきかを指定します。
• True: 非表示行を含みます。
• False: 非表示行を含みません。
デフォルトでは [False] になっています。
このパラメータはオプションです。
226
TraceFinder Custom reports のチュートリアル
Thermo Scientific
B
Custom Report のアドイン API
Public Function GetListColumn
Public Function GetListColumn
Public Function GetListColumn(ByVal tableName As String, ByVal columnName As
String) As String()
目的
この関数は、指定された列の文字を含む文字列の配列を返します。
パラメータ
次の表に、[Public Function GetListColumn] シンタックスで値を提供しなければならないパ
ラメータが示されています。
表 30. [Public Function GetListColumn] パラメータ
Thermo Scientific
パラメータ
説明
tableName
データ表の名前を指定します。
columnName
列ヘッダー文字である、列の名前を指定します。
TraceFinder Custom reports のチュートリアル
227
B
Custom Report のアドイン API
Public Function Value
Public Function Value
Public Function Value(ByVal target, Optional ByVal rowOffset As Long = 0,
Optional ByVal colOffset As Long = 0)
目的
この関数は、オプションのオフセットを持つ対象セルの値を返します。
パラメータ
次の表に、[Public Function Value] シンタックスで値を提供しなければならないパラメータ
が示されています。
表 31. [Public Function Value] パラメータ
パラメータ
説明
target
名前付き範囲、セル範囲、またはセルによりセルの範囲を指
定します。
rowOffset
行のオフセットを指定します。
デフォルトは 0 です。
このパラメータはオプションです。
colOffset
列のオフセットを指定します。
デフォルトは 0 です。
このパラメータはオプションです。
228
TraceFinder Custom reports のチュートリアル
Thermo Scientific
B
Custom Report のアドイン API
Public Function GetValue
Public Function GetValue
Public Function GetValue(ByVal target, ByVal defaultValue)
目的
この関数は、対象が検出されない場合、対象セルの値、または指定されたデフォルト値
を返します。
パラメータ
次の表に、[Public Function GetValue] シンタックスで値を提供しなければならないパラ
メータが示されています。
表 32. [Public Function GetValue] パラメータ
パラメータ
説明
target
名前付き範囲、セル範囲、またはセルによりセルの範囲を指
定します。
defaultValue
対象が検出されない場合、デフォルト値を指定します。
デフォルトはゼロです。
このパラメータはオプションです。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
229
B
Custom Report のアドイン API
Public Function HideListColumn
Public Function HideListColumn
Public Function HideListColumn(listName As String, colName As String)
目的
この関数は、指定されたデータ表の指定された列を非表示にします。
パラメータ
次の表に、[Public Function HideListColumn] シンタックスで値を提供しなければならない
パラメータが示されています。
表 33. [Public Function HideListColumn] パラメータ
230
パラメータ
説明
listName
リストまたはデータ表の名前を指定します。
colName
列ヘッダー文字である、列の名前を指定します。
TraceFinder Custom reports のチュートリアル
Thermo Scientific
B
Custom Report のアドイン API
Public Sub SortList
Public Sub SortList
Public Sub SortList(listName As String, sortColNames As String, Optional sheet As
Worksheet)
目的
この関数は、指定された列により、リストまたはデータ表を並べ替えます。
パラメータ
次の表に、[Public Sub SortList] シンタックスで値を提供しなければならないパラメータが
示されています。
表 34. [Public Sub SortList] パラメータ
パラメータ
説明
listName
リストまたはデータ表の名前を指定します。
sortColName
列ヘッダー文字である、列の名前を指定します。
sheet
シート ( 別名、タブ ) を指定します。このパラメータが欠けて
いる場合、関数はデフォルトで有効なシートを使用します。
このパラメータはオプションです。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
231
B
Custom Report のアドイン API
Public Sub EnumerateColumn
Public Sub EnumerateColumn
Public Sub EnumerateColumn(ByVal target, ByVal colIndex As Long)
目的
この関数は、連続的な番号 (1、2、3 など ) を作成し、指定された列を列挙します。
パラメータ
次の表に、[Public Sub EnumerateColumn] シンタックスで値を提供しなければならないパ
ラメータが示されています。
表 35. [Public Sub EnumerateColumn] パラメータ
232
パラメータ
説明
target
名前付き範囲、セル範囲、またはセルによりセルの範囲を指
定します。
colIndex
列のインデックスを指定します。
TraceFinder Custom reports のチュートリアル
Thermo Scientific
B
Custom Report のアドイン API
Public Function CreatePivotTable
Public Function CreatePivotTable
Public Function CreatePivotTable(ByVal dataTableName As String, ByVal target,
ByVal rowFields As String, ByVal columnFields As String, ByVal valueFields As
String, Optional ByVal pivotTableName = "PivotTable1") As Range
目的
Excel アプリケーションは、ピボットテーブルの作成に有効なツールです。しかし、これ
らの表の作成は通常手動による処理で、数種類のステップを要し、多くの Excel ユー
ザーがよく理解できない場合があります。[CreatePivotTable] 関数は、内部詳細を非表示
にし、いくつかの該当するパラメータだけを表示することで、テンプレート開発者の処
理を簡易化にしています。使用する ( コピーする ) 準備が完了したピボットテーブルを
Custom reports で作成することが目標です。Custom reports は、例えば、背景色および境界
線などを使用しません。この関数の例は、第 6 章、『Calibration Report を作成する』を参
照してください。
パラメータ
次の表に、[Public Function CreatePivotTable] シンタックスで値を提供しなければならない
パラメータが示されています。
表 36. [Public Function CreatePivotTable] パラメータ
パラメータ
説明
dataTableName
ピボットテーブルが基本にするデータ表の名前を指定します。
target
名前付き範囲、セル範囲、またはセルによりセルの範囲を指
定します。
rowFields
ピボットテーブルの行に変換するオリジナルデータ表の列名
を指定します。セミコロンを使用して複数の列を連結するこ
とができます。
columnFields
ピボットテーブルの列に変換するオリジナルデータ表の列名
を指定します。セミコロンを使用して複数の列を連結するこ
とができます。
valueFields
ピボットテーブルの値に変換するオリジナルデータ表の列名
を指定します。セミコロンを使用して複数の列名を連結する
ことができます。
pivotTableName
結果のピボットテーブルの名前を指定します。Excel アプリ
ケーションは通常、ピボットテーブルにデフォルト名を自動
的に割り当てます。ピボットテーブルをプログラムで参照す
る必要がある場合、参照できるように名前を割り当てなけれ
ばなりません。
デフォルト名は [PivotTable1] です。
このパラメータはオプションです。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
233
B
Custom Report のアドイン API
Public Sub SetManuallyIntegrated
Public Sub SetManuallyIntegrated
Public Sub SetManuallyIntegrated(ByVal dataTableName As String, ByVal refColName
As String, ByVal valueColName As String, Optional ByVal negateValue As Boolean =
False, Optional ByVal extraCols As Long = 0)
目的
サーモフィッシャーサイエンティフィックのレポートでは、手動積分の値は通常、長方
形のボックスで表示されます。[Public Sub SetManuallyIntegrated] 関数は、主に二つの目的
で作成されます :
• 最終的な表示用にデータ表をフォーマットするために使用できます。この場合、
refColName は通常、手動積分フラグを含む非表示列です。ValueColName はボックス
で囲まれた列です。ボックスで一つ以上の列を囲む場合、extraCol パラメータを使
用できます。例えば、長い化合物名は三つの列が必要ですが、その値は一つ ( 最初 )
の列で定義されます。この場合、extraCols は 2 でなければなりません。
• 今後の処理でデータを再フォーマットするために使用できます。例えば、Calibration
Report の作成において、ピボットテーブルに変換する前に、この関数を使用して
データ表をフォーマットできます。Excel ピボットテーブルは数字とのみ連動できる
ため、このステップは必須です。
パラメータ
次の表に、[Public Sub SetManuallyIntegrated] シンタックスで値を提供しなければならない
パラメータが示されています。
表 37. [Public Sub SetManuallyIntegrated] パラメータ
パラメータ
説明
dataTableName
データ表の名前を指定します。
refColName
参照値として作用する列の名前 ( 列ヘッダー文字 ) を指定しま
す。
valueColName
操作される値を含む列名を指定します。
negateValue
値を無効するべきかを指定します。
• True: 値を無効にします。
• False: 値を無効にしません。
デフォルトでは [False] になっています。
このパラメータはオプションです。
extraCols
手動積分フレームに含まれる追加の列の数を指定します。
デフォルトは 0 です。
このパラメータはオプションです。
234
TraceFinder Custom reports のチュートリアル
Thermo Scientific
B Custom Report のアドイン API
Public Sub ReformatManuallyIntegrated
Public Sub ReformatManuallyIntegrated
Public Sub ReformatManuallyIntegrated(ByVal target As Range)
目的
この関数は、値が負である指定された列において、セルの周りにボックスを追加する特
別な目的の関数です。また、負の値を正の値に変換します。この関数は、ピボットテー
ブルが作成された後、Calibration Report で手動積分フラグの後処理に使用されます。
パラメータ
次の表に、[Public Sub ReformatManuallyIntegrated] シンタックスで値を提供しなければな
らないパラメータが示されています。
表 38. [Public Sub ReformatManuallyIntegrated] パラメータ
Thermo Scientific
パラメータ
説明
target
名前付き範囲、セル範囲、またはセルによりセルの範囲を指
定します。
TraceFinder Custom reports のチュートリアル
235
B
Custom Report のアドイン API
Public Sub SetNoData
Public Sub SetNoData
Public Sub SetNoData(ByVal target, Optional ByVal text As String = "No data for
this report")
目的
この関数は、対象セルで指定された文字を設定します。より一貫性のあるレポートを作
成するために、これを使用できます。
パラメータ
次の表に、[Public Sub SetNoData] シンタックスで値を提供しなければならないパラメー
タが示されています。
表 39. [Public Sub SetNoData] パラメータ
パラメータ
説明
target
名前付き範囲、セル範囲、またはセルによりセルの範囲を指
定します。
text
表示する文字を指定します。
パラメータはデフォルトで「No data in this report ( このレポー
トにデータはありません )」になります。
このパラメータはオプションです。
236
TraceFinder Custom reports のチュートリアル
Thermo Scientific
B
Custom Report のアドイン API
Public Sub HideRepeatArea
Public Sub HideRepeatArea
Public Sub HideRepeatArea(Optional name As String = "RepeatArea", Optional
hideHelperColumns As Boolean = True)
目的
この関数は、繰り返しエリア (RepeatArea) の名前付き範囲で行を非表示にします。通常、
シートが処理された後に呼び出されます。数種類のテンプレートには、繰り返しエリア
の横にヘルパー列 ( 例えば、データ表 ) があり、これも非表示にされなければなりませ
ん。オプションの [hideHelperColumns] パラメータは関数呼び出しでヘルパー列を非表
示にします。
パラメータ
次の表に、[Public Sub HideRepeatArea] シンタックスで値を提供しなければならないパラ
メータが示されています。
表 40. [Public Sub HideRepeatArea] パラメータ
パラメータ
説明
name
繰り返しエリアの名前を指定します。繰り返しエリアの名前
付き範囲は通常、[RepeatArea] として定義されます。
デフォルトは [RepeatArea] です。このパラメータはオプション
です。
hideHelperColumns
ヘルパー列を非表示にするかを指定します ( 通常、繰り返しエ
リアの右側 )。
• True: ヘルパー列を非表示にします。
• False: ヘルパー列を非表示にしません。
デフォルトでは [True] になっています。
このパラメータはオプションです。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
237
B
Custom Report のアドイン API
Public Sub FormatValue
Public Sub FormatValue
Public Sub FormatValue(ByVal target, ByVal limitValue, ByVal biggerFormat As
String, ByVal smallerFormat As String, Optional ByVal zeroFormat = Nothing)
目的
この関数は、制限値および指定したフォーマットに基づいて、セル値をフォーマットし
ます。
パラメータ
次の表に、[Public Sub FormatValue] シンタックスで値を提供しなければならないパラメー
タが示されています。
表 41. [Public Sub FormatValue] パラメータ
パラメータ
説明
target
名前付き範囲、セル範囲、またはセルによりセルの範囲を指
定します。
limitValue
制限値を指定します。
biggerFormat
[limitValue] よりも大きい値で使用するフォーマットを指定
します。
smallerFormat
[limitValue] よりも小さい値で使用するフォーマットを指定
します。
zeroFormat
ゼロ値のセルで使用するフォーマットを指定します。
このパラメータは、デフォルトでゼロになります。ゼロに設
定されている場合、ゼロ値のセルは空になります。
このパラメータはオプションです。
238
TraceFinder Custom reports のチュートリアル
Thermo Scientific
B
Custom Report のアドイン API
Public Sub ReplaceValue
Public Sub ReplaceValue
Public Sub ReplaceValue(ByVal target, ByVal fromValue, ByVal toValue)
目的
この関数は、セル値を別のセル値で置き換えます。
パラメータ
次の表に、[Public Sub ReplaceValue] シンタックスで値を提供しなければならないパラメー
タが示されています。
表 42. [Public Sub ReplaceValue] パラメータ
Thermo Scientific
パラメータ
説明
target
名前付き範囲、セル範囲、またはセルによりセルの範囲を指
定します。
fromValue
置換する値を指定します。
toValue
[fromValue] を置換する値を指定します。
TraceFinder Custom reports のチュートリアル
239
B
Custom Report のアドイン API
Public Function ShiftRange
Public Function ShiftRange
Public Function ShiftRange(ByVal target, ByVal left As Long, ByVal top As Long,
Optional ByVal right As Long = 0, Optional ByVal bottom As Long = 0) As Range
目的
この関数は、対象範囲を指定された余白にシフトします。右側と下のパラメータがゼロ
ではない場合、オリジナルの範囲を縮小または拡大します。この関数はしばしば、画像
の範囲を計算するために繰り返して使用されます。
パラメータ
次の表に、[Public Function ShiftRange] シンタックスで値を提供しなければならないパラ
メータが示されています。
表 43. [Public Function ShiftRange] パラメータ
パラメータ
説明
target
名前付き範囲、セル範囲、またはセルによりセルの範囲を指
定します。
left
範囲の左側に適用するシフト値を指定します。
top
範囲の上部に適用するシフト値を指定します。
right
範囲の右側に適用するシフト値を指定します。
デフォルトは 0 です。0 の場合、シフトされません。
このパラメータはオプションです。
bottom
範囲の下部に適用するシフト値を指定します。
デフォルトは 0 です。0 の場合、シフトされません。
このパラメータはオプションです。
240
TraceFinder Custom reports のチュートリアル
Thermo Scientific
B
Custom Report のアドイン API
Public Function GetText
Public Function GetText
Public Function GetText(ByVal target, Optional ByVal rowDelim As String = vbLf,
Optional ByVal colDelim As String = vbTab) As String
目的
この関数は、既定のデリミタで指定された対象範囲の文字を含む文字列を返します。
パラメータ
次の表に、[Public Function GetText] シンタックスで値を提供しなければならないパラメー
タが示されています。
表 44. [Public Function GetText] パラメータ
パラメータ
説明
target
名前付き範囲、セル範囲、またはセルによりセルの範囲を指
定します。
rowDelim
行の連結に使用するデリミタを指定します。
デフォルトは [vbLf ] です。
このパラメータはオプションです。
colDelim
列の連結に使用するデリミタを指定します。
デフォルトは [vbTab] です。
このパラメータはオプションです。
Thermo Scientific
TraceFinder Custom reports のチュートリアル
241
B
Custom Report のアドイン API
Public Sub MergeRowCells
Public Sub MergeRowCells
Public Sub MergeRowCells(ByVal target, Optional ByVal rowAutoFit As Boolean =
True)
目的
この関数は、指定された対象範囲の行のセルを結合します。通常、複数のセルにわたっ
て展開する長い値を連結するために使用されます。Text タイプの値は、隣のセルが空で
ある限り、そこに超過することができます。しかし、他のタイプの値 ( 例えば、日付ま
たは数字 ) は隣のセルに超過できません。代わりに、値がフィットできない場合、「#」
が表示されます。この場合、最終レポートで正確に値を表示するためにセルを結合しな
ければなりません。
パラメータ
次の表に、[Public Sub MergeRowCells] シンタックスで値を提供しなければならないパラ
メータが示されています。
表 45. [Public Sub MergeRowCells] パラメータ
パラメータ
説明
target
名前付き範囲、セル範囲、またはセルによりセルの範囲を指
定します。
rowAutoFit
結合後に、行の高さが自動的にフィットするべきかを指定し
ます。
• True: 行の高さは自動的に文字にフィットするように展開し
ます。
• False: 行の高さは自動的に文字にフィットするように展開
しません。
デフォルトでは [True] になっています。
このパラメータはオプションです。
242
TraceFinder Custom reports のチュートリアル
Thermo Scientific
B
Custom Report のアドイン API
Public Function ArraySize
Public Function ArraySize
Public Function ArraySize(arr() As String) As Long
目的
この関数は、配列のサイズを返します。配列が初期化されていない場合、0 を返します。
パラメータ
次の表に、[Public Function ArraySize] シンタックスで値を提供しなければならないパラ
メータが示されています。
表 46. [Public Function ArraySize] パラメータ
Thermo Scientific
パラメータ
説明
arr
チェックする配列を指定します。
TraceFinder Custom reports のチュートリアル
243
B
Custom Report のアドイン API
Public Sub LogMsg
Public Sub LogMsg
Public Sub LogMsg(ByVal msg As String, Optional ByVal fileName As String = "")
目的
この関数は、ログファイルにメッセージを追加します。ログファイルの各メッセージの
先頭にタイムスタンプを自動的に追加します。[fileName] が “” の場合、コマンドライ
ンに [ /g ] オプションが含まれていない限りログメッセージは記録されません。アプリ
ケーションのコマンドラインには、このオプションが含まれず、レポートでログファイ
ルが作成されません。この関数は主にテンプレート開発用にデザインされています。
パラメータ
次の表に、[Public Sub LogMsg] シンタックスで値を提供しなければならないパラメータが
示されています。
表 47. [Public Sub LogMsg] パラメータ
パラメータ
説明
msg
ログファイルに追加するメッセージ文字を指定します。
fileName
ログファイルの名前を指定します。[fileName] を指定しない
場合、関数は /g、/d、または /t オプションにより指定されたデ
フォルトのログファイル名を使用します。
デフォルトは “” です。
このパラメータはオプションです。
244
TraceFinder Custom reports のチュートリアル
Thermo Scientific
B
Custom Report のアドイン API
Public Function GetValidSheetName
Public Function GetValidSheetName
Public Function GetValidSheetName(name As String) As String
目的
この関数は、指定された名前に基づいた有効なシート名として文字列を返します。Excel
アプリケーションのシート名は Windows のファイル名と同様で、数種類の特殊文字を許
可しません。この関数は、これらの特殊文字をスペースに置き換えます。さらに、シー
ト名は 30 文字を超えてはならないので、この関数は最大 25 文字で長い名前をトリミン
グして省略記号 (…) を付け加えます。また、Excel ワークブックのシート名は重複できま
せん。同じ名前がすでに存在する場合、この関数は名前に番号を追加します。この関数
は、主に化合物名を、多くのレポートで使用される適切なシート名として使用します。
パラメータ
次の表に、[Public Function GetValidSheetName] シンタックスで値を提供しなければならな
いパラメータが示されています。
表 48. [Public Function GetValidSheetName] パラメータ
Thermo Scientific
パラメータ
説明
name
シート名の基礎として使用される名前を指定します。
TraceFinder Custom reports のチュートリアル
245
B
Custom Report のアドイン API
Public Function FileExists
Public Function FileExists
Public Function FileExists(ByVal fileName As String) As Boolean
目的
この関数は、指定されたファイルがすでに存在するかを決定します。この関数は
Windows API ラッパーです。
パラメータ
次の表に、[Public Function FileExists] シンタックスで値を提供しなければならないパラ
メータが示されています。
表 49. [Public Function FileExists] パラメータ
パラメータ
説明
fileName
チェックするファイルの名前を指定します。
• True: 指定されたファイルがすでに存在します。
• False: 指定されたファイルが存在しません。
246
TraceFinder Custom reports のチュートリアル
Thermo Scientific

Thermo Fisher Scientific 社フォーカス用ピペットスタンド販売中止の

MYECL Imager

DENSO CUSTOM PIT オリジナル商品「ドライブ

①全道大会申込みについてのお願い

カタログダウンロード - 株式会社 旭川保健医療情報センター[アーミック]

パソコンCS試験・Excel（3級）（水）

キャンペーンチラシ

実践・アンケート調査（入門編） - 熊本大学 政策創造研究教育センター

高速シーケンス解析依頼書

PDF 介入カテーテル パンフレット