第09章建立一个报告格式

1、第9章 建立一个报告格式本章将介绍如何利用Report Format Editor报告格式编辑器来建立一个报告格式文件。这个文件包含那些打印报告中包含的用于数据分析的参数。您可以采用TC Publisher来生成高度专一化（用户自定义）的报告。参见TC Publisher Help TC出版帮助文件获得指导性信息。学习下列内容:页面:报告格式编辑器的使用 Using the Report Format Editor 2创建标题、页眉和页脚文本Creating Title, Header, and Footer Text 5编辑报告栏Editing Report Columns 7创建一个通用表

2、达式 Creating a Custom Expression 11编辑报告格式选项Editing Report Format Options 14打印报告格式文件 Printing Report Format Files 18报告格式编辑器的使用 Using the Report Format EditorTotalChrom在分析一个未处理的数据文件之后，它会以结果文件（.rst）的形式将这次分析保存下来，并用在序列文件列出的格式文件将分析结果报告出来。如果您已经确认在方法处理部分的附加报告文件，您可以生成高达6个的不同二级报告。如果您在序列中没有包含这个报告格式文件的名称，TotalCh

3、rom 将不会打印这个报告。除了那些您想在数据分析中指定包含的信息，报告格式文件同样定义如何在页面上显示这些信息。您也可以用一个报告格式文件格式化用于其它应用文件的信息。例如：想创建一个文件用来输出结果到SQL*LIMS，就需要将这个报告作为用一个逗号隔开的ASCII文件来保存。菜单和命令Menus and Commands这个Report Format Editor报告格式编辑器窗口可以通过从Navigator浏览器中的 Build 菜单上选择Report Format报告格式指令来获得。它包含了下列菜单和命令：文件菜单File Menu允许您来创建、打开和保存文件、输入和检查相关的一个报告

4、格式、打印报告格式的文档资料、以及退出程序返回Navigator 浏览器页面。用户备注菜单User Notes Menu允许您对这个报告创建相关的页眉、页脚和题目文本。报告菜单Report Menu允许选择那些您想在报告中出现的栏，包括那些在栏中能生成计算结果的通用表达式。编辑菜单Edit Menu允许移动和删除栏。选项命令 Options Command允许您指定一系列报告选项，例如系统页眉的宽度和里面要包含的组分。创建一个报告格式的通用步骤 General Procedure for Creating a Report Format下面是创建一个报告格式的通用步骤。在这个步骤中涉及到的有关

5、此项工作的详细细节将会在本章稍后部分提到。您也可以通过编辑一个现存的报告文件，然后采用Save As另存为命令重新命名保存创建一个新的报告格式。 创建一个新的报告格式文件：1. 进行下列操作之一： 在Navigator界面上，Build创建菜单中选择Report Format报告格式命令。就会出现Startup启动对话框。选择上面显示出来的选项中的其中一个，然后选择OK来打开Report Format Editor报告格式编辑器窗口。 如果Report Format Editor报告格式编辑器窗口已经打开，从File文件菜单选择New新建命令。这个名称会出现在报告格式编辑器窗口的标题条， To

6、talChrom会显示出这个默认格式。如果默认文件已经被修正过了，您的默认值可能从这些显示上看起来就有些不同。无论您何时更改一个未命名或已经存在的报告格式，在窗口底部的状态框都会出现字段MODIFIED。但在您保存了这个修改之后就会消失。2.如果您想改变默认标题，创建一个报告页眉和页脚。参见本章“Creating Title, Header, and Footer Text创建标题，页眉和页脚文本”部分。3.请您设定要在这个报告中采用的栏目。参见本章这两部分“Editing Report Columns编辑报告栏”和“Creating a Custom Expression创建一个通用表达式”

7、。4.当您已经开发完成报告格式时，请从File文件菜单中选择Save保存命令。Documentation文档对话框打开。5.在Documentation文档记录对话框中完成Description描述制表，并选择OK。有关输入一个文件相关描述信息的讨论，参见第2章“TotalChrom Basics TotalChrom基础知识”。TotalChrom File Save As TotalChrom文件另存为对话框打开。6.在File Name文件名文本框中输入本报告格式的一个名字，选择Save保存。对话框关闭，新的报告格式名称出现在标题条中。7.当您完成Report Format Editor

8、报告格式编辑器的运行时，从File文件菜单中选择Exit退出命令退出报告格式编辑器界面。创建标题、页眉和页脚文本Creating Title, Header, and Footer TextUser Notes用户备注菜单中出现的命令能帮助您实现在一个报告格式中创建报告标题、页眉和页脚。 创建一个报告标题：1.从User Notes用户备注菜单中选择Title标题项来打开Report Format Title报告格式标题对话框。2.对这个报告输入您想用的标题，选择OK。当您选择OK时，对话框关闭，该报告格式文件的标题会出现在报告文本顶部。您已经创建了一个报告标题之后，可以点击标题区域重新打开T

9、itle标题对话框。那些创建页眉和页脚的步骤与上面几乎一样，二者已经被合并成一个步骤程序。 创建页眉或页脚文本：1.从User Notes用户备注菜单中选择Header页眉或Footer页脚来打开Header页眉或Footer页脚对话框。下面显示的是Header页眉对话框。然而，除标题框之外，这两个对话框外观和功能看起来都一样。2.在对话框中的页眉或页脚文本区，输入要在报告页眉或页脚上显示的信息，并选择OK。当您输入到一行的末尾时，请按Ctrl+M来开始新的一行。您总共可以输入高达512个字符。要删除存在的文本，选择Delete删除命令。当选择OK后，报告页眉或页脚信息将出现在报告窗口。如果您

10、已经创建一个报告页眉或页脚之后，就不必选择命令来编辑页眉或页脚：仅仅只要点击Report Format Editor报告格式编辑器窗口中页眉或页脚文本的任何地方就能打开相应的对话框。编辑报告栏Editing Report ColumnsReport Format Editor报告格式编辑器中的Report报告菜单显示您想在报告中包含的不同类型栏的列表。对每一栏中各个类型的解释，参见Glossary术语表。Report报告菜单同样包含了Custom Expression通用表达式命令。Custom Expression通用表达式是数据栏的一个特殊类型，允许您在栏中进行数学运算操作。参见本章“Cr

11、eating a Custom Expression创建一个通用表达式”。在Report报告菜单中选择任意一栏，或在报告中点击这栏的名称，打开Column Information栏信息对话框，在下面的程序中描述到这些内容。您可以编辑栏信息，包括名称，以及放置这些栏到您想要其显示在报告中的任何位置。您也可以通过选择Report报告菜单中这个命令而在报告中创建空白栏。Blank Column空白栏对话框和Column Information栏信息对话框一样，如果那是页面上第一或最后一栏，系统拒绝在两栏之间插入一个空白格，或在页边空白添加空格。添加和删除栏 Adding and Deleting C

12、olumnsTotalChrom 配置的默认报告格式文件包含下面这些栏：您可以添加想要的栏或删除不想要的栏。 添加报告栏：1.选择Report报告来显示可利用的栏类型。2.从菜单中列出来的栏当中选择一个（除Custom Expression通用表达式之外）。显示Column Information栏信息对话框。字段会紧接着Current Column当前栏出现，直到您添加这栏到报告中。一旦这栏被添加了，您可以点击栏名来打开这个对话框，而不是从Report报告菜单中选择名称。3.在Column Number栏编号文本框中输入一个栏编号。这个在页面中建立这一个与其它栏相关的栏的位置。对于当前未在报

13、告中出现的一个栏类型，默认值是下一个可得到的栏编号。对已经出现在报告中的一个栏类型，默认值是现存的栏编号。如果您指派给新栏的编号与已经存在的栏编号相同，TotalChrom会自动将该些栏移开来插入新栏。4.在Column Width栏宽度项输入一个特定数字。5.如果可获得Digits数字，请键入要在十进位小数点后显示的数字数目。6.在Column Label栏标签文本框输入用于栏名称顶行中的文本。一个栏标签能包含一或两行字母数字字符。这个Column Label栏标签文本框是上面的行。如果标签内容超出了Column Width栏宽度文本框中的字符数目限制，栏会自动扩展到标签适应的宽度。 7.在

14、Second Label二级标签文本框中，输入文本用于栏名称的最底行。默认格式将第二行用在单位上。8.选择Calculate Total For This Column对这栏计算总数来看一个栏包含的总数。这个选项仅用于那些有数字值的栏。9.选择Insert/Add插入/添加命令。新栏会出现在报告格式中。有两种方法可以从一个报告格式中删除一栏：从Column Information栏信息对话框中删除，或通过在Edit编辑菜单中采用Delete Column删除栏的命令完成。 删除一栏： 点击要删除的栏，在Column Information栏信息对话框中选择Delete删除命令。或在Edit编辑

15、菜单中选择Delete Column删除栏命令，打开Delete Column删除栏对话框，输入您想要删除的栏的编号，选择OK。替换/编辑栏信息 Replacing/Editing Column Information采用Replace替换命令来修饰报告格式文件中任意栏的相关信息。 编辑现存的栏信息：1.点击想要改变的栏，打开Column Information栏信息对话框。2.编辑必需的信息，但是不要改变栏编号或移动栏。3.选择Replace替换命令。移动栏 Moving Columns您可以在报告格式文件中改变栏的位置，这项操作有以下两种方式：利用Edit编辑菜单中的Move Column

16、移动栏命令完成，或利用Column Information栏信息对话框中的Move移动按钮完成。 移动一栏：1.点击要移动的栏，打开Column Information栏信息对话框。2.在Column Number栏编号文本框，输入新的栏编号。3.选择Move移动来关闭对话框，重新定位栏。或1.在Edit编辑菜单中选择Move Column移动栏指令，打开Move Column移动栏对话框。2.在Which Column To Move移动哪一栏文本框中，输入要移动的栏的编号，在New Column Position新栏位置文本框中输入要这栏的新位置编号。3.选择OK命令关闭对话框，移动栏到新

17、的位置。创建一个通用表达式 Creating a Custom ExpressionCustom Expressions通用表达式允许您包含这些在生成一个报告时执行校准的结果信息。例如：您必须采用通用表达式来计算刻度估计百分比值。要获得估计值，最大峰赋值为100（或其它的百分比），用于其它色谱峰的百分比值成比例估算刻度。您可以采用下面的表达式：Scaled area估计面积:#PA/#MA*100Scaled height估计高度:#PH/#MH*100Scaled amount估计量:#AA/#MC*100在这些表达式中，#PA、#PH和#AA分别代表了色谱峰峰面积、峰高和调整过的量；#MA

18、、#MH和#MC分别代表了最大色谱峰峰面积、最大峰高和最大调整量。创建一个通用表达式与构建一个数学表达式非常类似，除了利用数据值和Custom Expression Editor通用表达式编辑器提供的运算符之外： 数据值可以是数字或预定义的值如Area Percent面积百分比和Sample Volume样品体积。 运算符可以是算术、指数和对数运算符。 计算可以是二进制的（采用两个值运行）和多水平。Custom Expression Editor通用表达式编辑器中所有数字形式采用US惯例。例如：尽管 Windows系统可能设定采用德国数字形式，如采用逗号来代表一个十进制小数点，但Custom

19、Expression Editor通用表达式编辑器仅接受句号作为小数点。当一次计算无效时（例如，除以零），在报告中会出现一条虚线来代替应该出现的数字值。您对一个表达式构造计算之后，请在Custom Expression column information通用表达式栏信息对话框中指定栏参数。这个对话框与用于所有其它报告栏栏信息的对话框是同一个对话框。一旦创建了一个通用表达式，和其它任何报告栏一样，它可被编辑、移动和删除。预定义通用表达式数据值 Predefined Custom Expression Data Values当开发一个通用表达式时，您可以从一个预定义数据值列表中选择。大多数的条目

20、涉及到独立色谱峰值（例如：#PA为色谱峰面积），其它的涉及到整个运行（例如：#TA为整体面积）。如果在这个报告产生之前Suitability适配性已经运行到数据上的话，仅可对这些条目采用Suit配套中短语来预定义值：如果它们出现在结果文件中，仅可用#SA Lambda Max #SA 最大值；#SP Peak Purity Index #SP色谱峰纯度指数和#SR Absorbance Ratio #SR吸光度比率。另外，对于#SP，这个LC235必须已经设定为光谱自动模式。 创建一个通用表达式：1.从Report报告菜单中选择Custom Expression通用表达式来打开Custom E

21、xpression Editor通用表达式编辑器对话框。左侧的列表框显示的是用于计算的数据类型。2.在Custom Expression通用表达式文本框中输入想要的表达式。输入这个表达式，要么通过从Available Column Values可采用的栏值和Available Operations可采用的操作中选择条目，要么直接在Custom Expression通用表达式文本框键入这些值和操作。采用常数作为值时，直接将想要的常数键入到Custom Expression通用表达式文本框中。Available Column Values可利用的栏数值列表中的大多数条目在Glossary术语表中被

22、定义，本手册和Help帮助中提供了这些信息。3.当表达式编写完成后，选择OK。Custom Expression Editor通用表达式编辑器对话框关闭，Custom Expression通用表达式对话框出现。4.在您想这个表达式出现的地方，输入栏编号。5.输入有关这栏的其它参数。6.选择Insert/Add插入/添加命令。您赋予给这个通用表达式的标签会显现在这栏的顶部。基于这个格式文件，当TotalChrom产生一个报告时，那个表达式结果出现在栏中。当您在窗口中点击这一栏时，在Custom Expression通用表达式对话框之后，会出现Custom Expression Editor通用表

23、达式编辑器对话框。创建另外的通用表达式 Creating Additional Custom Expressions现存的通用表达式栏中的数据总是被作为创建另外的通用表达式的一个基础。这个能让您很快就从现存的通用表达式派生出新的通用表达式，而不需要重新输入数据。当在报告中仅有一个通用表达式时，它的数据总是作为创建另外一个通用表达式的模板。但是当有多个通用表达式时，您必须选择那些您想利用其数据的特定通用表达式。您可以通过下面之一来实现： 点击想得到的通用表达式。或 从Report报告菜单选择Custom Expression通用表达式来打开Duplicate Columns复制栏对话框。选择要用

24、其数据的那个通用表达式，然后选择OK。无论您选择的是哪一个方法，Custom Expression Editor通用表达式编辑器对话框都会出现。同时它已经被填满了表达式数据。利用在“Creating a Custom Expression创建一个通用表达式”中描述的步骤来建立这个通用表达式。编辑报告格式选项Editing Report Format OptionsReport Format Editor报告格式编辑器中的这个Options选项命令，打开一个含有一系列选项的对话框，这些选项与您想在报告中包含的信息相关。 编辑报告格式选项：1.选择Options选项命令，出现Report Form

25、at Options报告格式选项对话框。2.选择您想在报告中包含的System Header系统页眉大小。这个系统页眉包含有关数据分析的摘要信息；不仅仅是一个标记（像用户输入的报告页眉）。下表显示了那些在Small小，Medium中，Large大的报告页眉中包含的数据。条目 Item小Small中Medium大Large软件版本号 Software Version number xxx处理号Process Numberxxx操作者姓名Operator namexxx样品名Sample Namexxx仪器名称和通道Instrument Name and Channelxxx报告的日期（和时间）D

26、ate (and time) of reportxxx数据采集时间/日期Data Acquisition Time/Datexxx序列文件名和循环编号Sequence File name and Cycle #xxx架子/小瓶编号Rack/Vial numberxxx样品量和稀释因子Sample Amount and Dilution Factorxxx结果文件Result Filexxx样品编号Sample number xx内标物量Internal Standard Amountxx研究名称Study name xx自动进样器名称Autosampler name xx接口串行端口编号Int

27、erface serial # xxA/D mV 范围A/D mV Rangexx延迟时间Delay timexx结束时间 End timexx取样速率Sampling ratexx样品体积Sample Volumexx面积抑制Area rejectxx仪器方法文件Instrument method filexx处理方法文件Processing method filexx校准方法文件Calibration method filexx原始数据文件Raw Data Filexx报告格式文件Report Format Filexx噪音和面积域值Noise and Area Thresholdx方法中

28、的仪器注意事项Instrument notes from the methodx方法处理参数Method processing parametersx附加序列样品值Additional sequence sample values x检测到的色谱峰总数Total number of peaks detectedx当一个原始文件开始处理色谱峰检测时，生成的每一个报告页眉中都包含着一个处理编号(例如：从一个RRT文件生成)。处理编号是一个指定给服务分析器的唯一编号，用于Client/Server Analyze客户/服务器分析来执行创建报告。如果一个方法指定了一系列不同的报告，那么当文件被这个方法

29、分析时，所有一系列结果报告包含相同的编号，但是方法被用来处理数据时，每次的那个编号都不同。由于处理编号只出现在色谱峰检测处理开始时，它自己和处理编号说明都将被打印在仅列于Software Version软件版本编号之下的一行里面。第一次报告产生，分析软件设置处理编号作为其原始值（1）。3.选择Instrument Control Parameters仪器控制参数检查框，在报告中引入用LINK控制的仪器的摘要信息。4.选择任何一个您想利用的Report Body Options报告主体选项。在报告中仅打印系统页眉信息，取消选择 Print Main Report Body打印主报告主体，跳到第5

30、步。每个报告主题选项的描述参见Status状态条。某些选项在下面有详细描述。 如果选择在报告主体中包含名称或时间组，然后组内的单色谱峰组分将不被报告。相反地，如果组已经被定义，但是没有包含在报告主体中，单色谱峰组分和/或色谱峰在基于它们各自的校准上将被报告。 如果您选择Missing Components丢失组分，Missing Named Groups丢失名称组或Missing Timed Groups丢失时间组，因为没有发现色谱峰，那么色谱峰索引和数量将是零。这些行将包含零和将利用期望保留时间。5.对Area Reject面积抑制项输入一个值代表那个您想包含在在报告中的最小色谱峰面积。这个值仅用于生成报告。6.选择任何一个您想利用的Miscellaneous Options多元选项。有关这里面每个选项的详细信息参见Status状态条。某些选项在下面有更深入的描述： 如果您选择Expand Named Groups扩展名称组或Expand Timed Groups扩展时间组， TotalChrom将在主报告之后包含一个补充报告。这个报告包括单色谱峰组分和/或色谱峰结果。这些组分总是基于这些组成员的独立校准上。对于时间组成员，这可能是