在 MassLynx LIMS 接口中，未将对象引用设置到对象的实例 - WKB5488

故障描述

• 在尝试将保存的 TargetLynx QLD 发送到 LIMS 时，LIMS 接口的 Activity Trace（活动跟踪）中出现以下错误：Error in sending results for the file [File name and path]. Object reference not set to an instance of an object（发送文件 [文件名和路径] 的结果时出错。未将对象引用设置到对象的实例）
• 结果未上传至 LIMS

环境

• MassLynx LIMS 接口，所有版本

原因

LIMS 接口中显示 Object reference not set to an instance of an object（未将对象引用设置到对象的实例）错误，有七个可能的原因：

最常见的原因是 (1)。

 

1. 样品的 Assay ID（分析 ID，即在 TargetLynx 数据集中）与 LIMS 接口中 Tools > Assay List（工具 > 分析列表）中配置的其中一个分析 ID 不匹配。此匹配区分大小写。

这可能是因为，在仪器上采集原始数据时，未在样品列表的 Job（任务）字段中指定适当的分析 ID。或者某些样品的 Job（任务）字段留空，可能是因为用户手动将一些样品添加到了序列的底部。

或者可能因为 LIMS 接口已经重新安装，并且尚未重新配置。缺省的分析 ID 简称为 Assay 1（分析 1）、Assay 2（分析 2）……Assay 30（分析 30）。

C:\MassLynx\Log 中的日志文件将显示以下错误：Invalid Template definition: Either the Test Definition was not found or there were multiple Assay Identifiers for the selected qld file（模板定义无效：没有找到测试定义，或者选择的 qld 文件有多个检测标识符）和 Object reference not set to an instance of an object（未将对象引用设置到对象的实例）。

注 1：不幸的是，在 TargetLynx 浏览器中无法显示 Job（任务）字段。但是，有两种方式查看 Job（任务）字段以检查不同样品的分析 ID，方法如下：

A. 打开原始数据文件中的 Header.text 文件并查看 Job Code（任务代码）字段。

或

B. 将 Job（任务）字段添加到 Samples Report（样品报告）、 Sample Summary Report（样品摘要报告）或 Experiment Report（实验报告）的标题中，然后在报告中打开 Print Preview（打印预览）并滚动浏览样品，如附件 PDF 中所述。

注 2：在一些旧版本的 MassLynx 中存在一个软件错误，这意味着 ample Summary Report（样品摘要报告）和 Samples Report（样品报告）的 Header（标题）中的 Job（任务）字段为空白。不过，此错误已在 MassLynx 4.2 SCN 997 及更高版本中修复。


2. 结果中没有分析物样品，因此没有要上传的结果。如果数据集存在 QC 样品或 Standard（标准）样品，则 Include QC samples when uploading results（上传结果时包括 QC 样品）或 Include Standard samples when uploading results（上传结果时包括标准样品）选项未选中。

C:\MassLynx\Log 中的日志文件将显示以下错误：Object reference not set to an instance of an object（未将对象引用设置到对象的实例）和 QLD file does not contain any samples（QLD 文件没有包含任何样品）。

 

3. 用于上传的 TargetLynx .qld 文件是使用比 LIMS 接口 PC 上安装的 SCN 更新的 MassLynx 版本生成的。例如，如果 TargetLynx 结果文件已保存到搭载 SCN 1035 的处理 PC 的磁盘上，而 LIMS 接口安装在搭载 SCN 1017 的仪器 PC 上，则结果将上传失败，因为 SCN 1035 中 TargetLynx 版本经过大幅改进和更新。无法在 SCN 1017 中使用 TargetLynx 正确打开在 SCN 1035 中创建的 TargetLynx 数据集或方法。这是软件的预期行为，因为我们无法保证 TargetLynx 数据集和方法的向前兼容性。有时，TargetLynx 中的不同 SCN 之间恰好存在前向兼容性，但这是偶然的，而不是基于设计。在 TargetLynx 中，SCN 997 之前发布的任何 SCN（例如 SCN 1017）与 SCN 997 或更高版本的 SCN 之间不存在前向兼容性。

错误将与 (2) 中相同。C:\MassLynx\Log 中的日志文件将包含以下错误：Object reference not set to an instance of an object（未将对象引用设置到对象的实例）和 QLD file does not contain any samples（QLD 文件没有包含任何样品）。

注有关 MassLynx SCN 的发布日期，请参阅 WKB236959。

https://cn-supportt.waters.com/KB_Inf/Ma...re_released_in

 

4. MassLynx 未打开。为了使用 LIMS 接口上传 TargetLynx 结果，MassLynx 必须运行 *。

C:\MassLynx\Log 中的日志文件将显示以下错误：Object reference not set to an instance of an object（未将对象引用设置到对象的实例）和 Invalid Qld file or Unable to generate XML（Qld 文件无效或无法生成 XML）。

 

通过 Windows 快捷方式打开 LIMS 接口，或者 MassLynx 已关闭但 LIMS 接口仍保持打开状态。

建议客户通过 MassLynx 的“LIMS”快捷方式打开 LIMS 接口，不要使用 Windows 快捷方式打开。

在上传结果之前检查 MassLynx 是否打开应属于客户 SOP 中的一部分。

 

* 注意：在 MassLynx 关闭的情况下，可以通过手动运行 C:\MassLynx 中的 TargetLynx.exe 上传结果。

 

5. 安装了 QuanLynx，而没有安装 TargetLynx。必须安装 Targetlynx 才能使用 LIMS 接口上传结果。

日志文件还包含以下行：Unable to generate the XML（无法生成 XML）。

 

6. MassLynx Security（安全）已安装，但 .qld 文件没有有效的校验和。除了屏幕上显示并记录在 LIMS 接口日志中的 Object reference not set to an instance of an object（未将对象引用设置到对象的实例）外，安全审计日志中还会显示篡改警告。
请注意，为了上传结果，.qld 文件不需要位于用户通过允许的目录策略有权访问的文件夹中。

 

7.（不太可能）TestDefinition 文件是在以某种方式自定义的系统上生成的，例如添加了一个额外的 TargetLynx 字段，因此该字段出现在 TestDefinitionFile 中，但不在 TargetLynx 字段 xml 文件列表中，因此会导致配置不匹配。

 

解决方法

1. 对于 (1)，如果所有样品的分析 ID 相同（不正确），则结果仍然可以通过暂时将 LIMS 接口中配置的其中一个分析 ID 更改为数据集的 Job（任务）字段中指定的任何内容，通常为采集数据时使用的样品列表文件名称，因为原始数据中的 Job（任务）字段将使用样品列表文件的名称填充（如果它留在用于运行样品的样品列表中）。  
   
   或者
    
2. 对于原因 (1) 和 (2) 造成的问题，可在仪器上重新采集样品，采集时，在 Job（任务）字段中使用正确的分析 ID，并确保至少存在一个分析物样品。
   

4. 重新创建 TestDefinition 文件，或从其他系统获取正确 TargetLynxFields.xml 副本。

附加信息

如果采集样品时 Job（任务）字段为空，则数据中的 Job（任务）字段将填充采集数据所用的样品列表文件名。

如果 TargetLynx 数据集中的样品包含两个或更多个不同的分析 ID，TargetLynx 将无法上传此 .qld 文件中的结果。在这种情况下，解决方法之一是手动修改具有错误分析 ID 的原始数据文件中的 Header.txt 文件中，Job Code（任务代码）字段的分析 ID，然后重新处理原始数据，获得新的 .qld 文件。只要不需要更改太多的数据文件，这将是一个合理的解决方法。

应建议客户修改他们的 SOP，以便他们在仪器上运行任何样品之前，检查所有样品的 Job（任务）字段，确保指定了正确的分析 ID。

Job（任务）字段应添加到客户的所有样品列表格式文件中，确保始终显示分析 ID。