使用导入接口编辑器将设备连接到LIMS

导入接口:将数据自动导入LIMS

将分析仪器、测试机、外部实验室以及SAP等ERP系统与LIMS对接:支持CSV、JSON、XML、REST-API和SFTP——采用基于人工智能的映射技术。

没有接口的日常生活

实验室里会耗费时间——并导致错误的四件事

数值被逐一输入

设备打印或导出数据后,有人会手动将数字录入系统。每个数值都要经过两次处理,而在第二次处理时就会出现数字颠倒的情况。

每台设备的操作方式各不相同

一个设备输出分号,下一个输出制表符,第三个则要到第13行才开始显示标题行。针对每种格式,都需要维护一个专门的Excel临时解决方案。

该映射是手动完成的

如果没有明确的键,就必须由某人来决定某个测量值属于哪个样本。这种做法通常可行——直到某次行不通,并在审计中被发现为止。

每次连接都需要IT部门介入

新增一个接口意味着需要开一张工单、联系一家服务商以及等待时间。在此之前,这一步骤仍将通过Excel继续处理。

LDB LIMS的导入接口编辑器正是为此而设计的: 这是一个可将众多类型各异、使用频率不一的设备、系统和外部实验室接入系统的工具——从每小时提交数据的分析仪,到每年发送三次文件的合作伙伴实验室,均可实现对接。

核心功能

不仅仅是测量数据——几乎所有送入实验室的样本

导入接口编辑器不仅限于分析仪器。任务、主数据和文档也是通过同一界面导入的。

这些数据可以导入

  • 测量值
  • 样本
  • 订单
  • 客户与联系人
  • 检测设备
  • 材料和批次
  • 附件
  • 发票和报价单
  • 报告和规格说明
  • 配方、模板、任务

此外还有笔记、工时记录和文件——共计19种数据类型,均可通过导入接口进行创建或更新。

支持的格式

CSVJSONXMLHL7LDTPDFPNGJPG

HL7 和 LDT 支持医疗数据交换。Excel 同样适用——只需在 Excel 中将其保存为 CSV 文件即可。其他内容则通过转换代码添加。

传播途径

哪种方式适合您的设备?

从手动操作到全自动操作,共有四种方式。选择取决于三个因素:源系统的功能、IT系统的支持程度以及数据更新的频率。

上传文件

手动

将设备的导出文件直接上传至接口。这是一种入门方式,也适用于运行频率较低的设备。

IT 投入: 无
适用场景: 测试阶段、小批量

SFTP / FTP

设备标准

该设备将文件存储在服务器上,LDB LIMS会自动调用该文件。导入的文件将被移动或删除。

检索频率: 每10分钟一次
配额: 每个周期10个文件
端口: 22(SFTP)· 21(FTP)

HTTPS / REST

推与拉

外部系统会主动通过POST方法发送数据,或者由LDB LIMS主动获取数据。这是最快捷的方式——几乎是实时的。

登录: 基本认证或证书
响应: 200 成功 · 400 拒绝
适用场景: ERP、门户网站、第三方实验室

接收电子邮件

没有IT项目

该接口可通过电子邮件接收附件。对于仅提供此种方式的合作伙伴实验室而言,这非常有用。

IT 工作量: 极小
适用于: 外部实验室、单项检测结果

MCP

人工智能和语音助手

ChatGPT、Claude 及其他人工智能应用程序通过开放的导入接口传输数据——病理学诊断报告通过语音录入而非手动输入,采样过程可在移动中通过语音记录,微生物学检测结果则可解放双手进行记录。

授权: 由您决定AI可以使用哪些接口
权限: 与LDB用户绑定
审计日志: 每次更改均标注“MCP”
更多关于MCP的信息

专用表格

录入而非导出

您可以自行创建一个HTML页面或表单——用于现场采样、供提交者使用,或是用于目前尚未存在的数据采集。提交后,输入的数据将直接进入导入接口。

路径: 表单 → HTTPS 接收
适用对象: 采样员、提交人、特殊情况
无文件时: 输入内容将立即保存为数据记录
图片和PDF文件 通过文件名、二维码或人工智能,将样本与正确的样本进行匹配。
审计轨迹 完整记录每次导入操作——包括原始数据。
导入映射

“列到字段”——设置一次,即可自动运行

在映射过程中,您需要指定文件的哪一列对应LDB LIMS中的哪个字段:客户、订单、样本、采样点、参数、测量值。

您上传一个示例文件,LDB LIMS会读取其中的属性行,然后您进行映射。无论参数是并排排列在列中,还是逐行排列,都无关紧要——映射会遵循您文件的结构,而不是相反。

屏幕截图:带属性映射的导入映射

调整名称

每个属性都会被赋予一个通俗易懂的名称——原本晦涩难懂的列标题变成了“取样器”。

设置默认值

如果导入文件中的某个字段为空,LDB LIMS会自动将其填充为预设的默认值。

合并字段

可以将多个列合并为一个字段——名字和姓氏合并为“姓名”。

检查输入内容

一个模板会在导入时对数据进行验证:如果某个值不符合预期格式,导入过程会立即中止,而不是生成无效数据。

如果该文件根本不是CSV文件呢?

随后,在映射生效之前,转换代码会生成所需的格式。您实验室的管理员可以自行编写和维护该代码。此外,我们也可提供此项服务,按小时计费。在导入窗口中,您将看到原始数据和转换后的版本并排显示。

手册中的转换代码
AI扩展

将非结构化数据转换为结构化数据

手写采样记录、拍摄的测量结果照片、来自委托方或外部实验室的PDF文件:该AI扩展功能可将非结构化文档转换为结构化数据,对其进行验证,并将其传递至导入环节。

截图:基于人工智能的亲笔签名采样记录导入及验证

两个型号,而不是一个

一个模型进行预测,另一个模型则独立验证结果。两个建议并列显示,各自附有置信度值——您可以立即看出它们在哪些方面一致、哪些方面不一致。

每个数值都有据可查

对于每个被识别的字段,LDB LIMS都会显示该值在原始文档中的来源位置。对于无法明确识别的内容,系统会将其标记为需人工核查,而非默认直接采用。

访问您的主数据

人工智能可以有针对性地在数据库中进行检索——例如查找上述检测设备并准确匹配。它不提供建议,只是进行检索。

关于该 AI 扩展功能的具体工作原理、可识别的数据类型以及如何针对每个接口进行配置,请参阅其专属页面。

查看基于AI的进口商品
导入模式

由您决定哪些内容可以被覆盖

导入操作可以创建、更新数据,也可以选择不进行任何操作。该模式需针对每个接口分别设置——并适用于每次运行。

默认模式为 update:新值将无条件被采用。此外,还有其他模式:仅填充空参数、仅更新已存在的参数、为缺失的参数创建无值的条目,或将测量值追加到现有的数值序列中。 如果不想在重复测量时覆盖原有数据,可选择“忽略”模式——该模式可选择是否显示警告。

手册中的所有导入模式
屏幕截图:选择测量值导入的导入模式

测试与查找错误

仅在测试系统中

每个接口首先会在该处进行配置,并使用匿名化的示例文件进行测试。只有在验证成功后,该接口才会投入生产环境。

检查连接

只需点击一下即可测试 SFTP 或 FTP:可达性、登录凭据和写入权限。在实际数据传输之前,HTTPS 接口会返回 200 或 400 状态码。

将特殊情况纳入测试

缺失的必填字段、未知ID、特殊字符、空值:日常使用中可能出现的问题,都应纳入测试——而不是留到首次正式运行时才发现。

过程与重复

每次导入操作都会被记录,并且可以重复执行。如果出现错误,您可以查看问题出在哪个环节——源文件、密钥、映射还是转换。

设备与系统

我们已经将这些设备和系统进行了集成

而这里未提及的所有内容,都可以通过映射和转换来实现——设备格式仅决定了需要多少前期准备工作。

分析仪器

  • Agilent
  • Bruker
  • Leco
  • Tecan
  • Zwick
  • GC/MS
  • HPLC · IC · MS
  • Waagen · Titratoren

设备软件

ERP 与商品管理

  • SAP
  • SAP Business One
  • Microsoft Dynamics
  • Navision
  • ProAlpha
  • AS/400
  • Salesforce
  • DATEV

诊所与外部实验室

  • Tomedo
  • M1
  • eTermin
  • Caritasnet
  • neolution
  • Novid20
  • HL7 · LDT
您的设备不在列表中? 请向我们发送一个导出文件示例。在接口研讨会上,我们通常能在一次会议内确定是仅需映射即可,还是需要转换代码。
检查导出文件

关于导入接口和设备连接的常见问题

通过导入接口,您可以将分析仪器、测试机、温度记录仪和数据记录仪、外部实验室以及ERP系统与LDB LIMS进行集成。 可选的数据传输方式包括手动上传、SFTP、HTTPS/REST-API、电子邮件接收、自定义表单或用于人工智能助手的MCP。具体采用哪种方式,取决于源系统、您的安全要求以及期望的自动化程度。
是的——这让大多数人感到惊讶。通过同一个界面,还可以管理样品、订单、客户和联系人、检测设备、材料和批次、设备、发票和报价、报告、规格书、配方、模板、任务、备忘录以及工时记录。 总共共有19种数据类型,每种都可以创建或更新。
最常见的是CSV、JSON和XML。在医疗数据交换中,还会用到HL7和LDT;此外,还可以导入PDF、PNG和JPG格式文件,例如色谱图或已签名的报告。Excel同样适用——只需在Excel中将其保存为CSV格式即可。 在创建接口时,请设置字符集、日期格式和小数分隔符;设置错误是导致变音符号显示异常或测量数值被误解的最常见原因。
是的——无需再通过Excel进行中间处理。只需将仪器输出、参数、样品标识和传输路径进行一次匹配,此后测量值就会自动归入对应的样品中。这既适用于气相色谱(GC)或聚合酶链式反应(PCR)系统等设备,也适用于天平和滴定仪。
是的,Zwick试验机可通过相应的导入接口进行集成。 根据具体配置,我们可以导入最大值、平均值、斜率、原始数据或完整的曲线——由您决定其中哪些测量数据实际导入到实验室信息管理系统(LIMS)中。在此过程中,设备和测试仪器将通过固定标识符、序列号或条形码进行唯一标识。
为此,我们提供了移动数据采集功能:拍照、通过iPad或iPhone输入、语音录入或传统的手动输入。 多页测量记录和手写笔记将通过OCR和AI技术进行识别,并转换为结构化的测量数据。采样单也可以通过这种方式导入——系统会据此自动生成任务和样品。
包括SAP、Navision、Microsoft Dynamics和AS/400等系统。 转换规则将ERP数据转换为订单、样品和分配;通常只需客户编号、商品编号和批次号作为最小数据集,其中通过批次号与商品编号的组合实现唯一分配。 理想情况下,您的ERP系统应继续作为客户主数据的权威来源——LIMS会定期进行数据同步,而非建立第二套数据源。发票数据将通过DATEV或直接的ERP接口回传。
可通过具有自动参数映射功能的导入接口进行操作;若样本数量较少,也可通过手动输入完成。可将合作实验室的原始报告附在样本后,以便在审计时能够追溯该数值来源。
这两种传输模式均可实现。传输频率取决于传输方式:定时调用(例如每10分钟一次),或者在REST连接中实现近乎即时的传输。 此外,导入操作既可以手动触发,也可以根据状态值自动触发;状态过滤器和唯一的导入标识符可有效防止重复导入和无限循环。
是的,通过模型上下文协议(MCP)。AI应用会通过您为此开放的特定导入接口传输数据——它们无法获得超出此范围的访问权限。 登录与 LDB 用户绑定,适用该用户的权限,且每次更改都会在审计日志中标注“MCP”字样。因此,病理科的诊断报告可以通过语音口述而非手动输入,或者在外出采集样本时通过语音记录。
是的。您可以创建自己的HTML页面或表单——用于现场采样、供样者使用,或是用于LIMS中尚未存在的数据录入。 提交时,输入的数据将通过HTTPS接收通道直接进入导入接口。不会生成任何需要后续手动上传的文件。
是的。除了单文件上传外,还有针对整个文件夹的多文件上传功能——这是导入历史数据时的常规方式。通过SFTP自动获取数据时,LDB LIMS每10分钟会从服务器获取最多10个文件。 对于数据量较大的情况,则需通过多个周期或提高上传配额来处理。
是的。除了将数据导入LDB LIMS外,还可以将结果、状态信息或ID回传至门户网站、ERP系统或外部实验室。触发回传的具体状态以及回传的字段内容,将根据具体项目进行设定。
在映射过程中,您需要将导入文件中的字段与LIMS中的字段进行映射:客户、订单、样品、采样点、参数、测量值。简单的映射关系可直接在界面中配置。 对于复杂的文件结构、名称不一致或特殊的测量值格式,需要添加转换代码,该代码会在导入前对数据进行转换。实验室管理员可以自行编写和维护该代码;此外,我们也可提供按小时计费的转换服务。 代码编写完成后,应始终使用具有代表性的测试文件进行验证。
是的。人工智能能够识别字段、建议映射关系并生成转换代码——这样,只需点击几下即可完成导入映射,而无需耗费数天时间。不过仍有两条规则需遵守:事先对示例文件进行匿名化处理,并对每个自动生成的映射从业务和技术层面进行复核。
这两种结构均受支持。在水平导入中,参数以列的形式并排排列;在垂直导入中,参数则按行纵向排列——设备导出数据通常采用垂直布局,而ERP导出数据则通常采用水平布局。 关键在于映射必须与源文件的结构相匹配;为此,您无需修改现有的导出文件。
这取决于导入类型。对于测量值,至少需要一个有效的样本、一个可关联的参数以及测量值本身;而对于官方申报,还需包含ID以及运营商或采样点数据。 系统中可以创建缺失的字段,并且可以根据不同地点或检测类型对导入模板进行差异化配置。
关于相同的商品编号和规范的主数据映射。一个检测套餐可以整合多个参数,这些参数共同分配给一个商品编号。只要具备唯一标识特征,即可从单个Excel文件中自动分配并汇总多个批次。
每个数据层都需要一个唯一键:客户编号、订单号、样本号、参数ID、患者ID、设备标识符或条形码。如果缺少该键,您可使用一系列强大的工具——我们会利用所有现有的主数据字段,或将多个字段组合成一个匹配键。
是的。条形码用于识别样品、物料、批次、检测仪器和设备;物料和批次可直接扫描。前提是条形码在源系统和LDB LIMS中的存储信息必须保持一致,并在映射过程中予以考虑。此外,序列号也可作为设备的唯一标识符。
通过唯一标识符、协调一致的匹配规则以及合适的导入模式。标准模式 update 会覆盖现有值,而非创建第二条记录——即使意外再次导入同一文件,也不会产生重复数据。 对于客户、患者、地点和样本而言,主键的定义尤为关键。此外,必填字段和有效性验证机制可有效防止不完整或矛盾的数据被处理。
这两项均可进行配置,且可精确到字段级别:您可以指定导入操作可以覆盖哪些字段,哪些字段保持不变。在此过程中,您应明确测试空值、已存在的内容以及业务上的特殊情况,以确保不会意外覆盖任何内容。
是的。每次导入操作都会获得一个独立的ID,所有相关数据(包括原始数据)均会以该ID为依据进行存储,并可随时调取。因此,可以追溯到何时通过哪个接口导入哪个文件、由此生成了哪些数据记录,以及由谁触发了导入操作。此外,每次导入操作均可重复执行。
每个接口首先会在测试系统中进行配置,并使用具有代表性且尽可能经过匿名处理的示例文件进行测试。测试内容不仅包括标准情况,还特别涵盖了必填字段缺失、未知ID、特殊字符、空值以及业务上的特殊情况。 只有在验证成功后,接口才会部署到生产系统——两个环境将使用独立的登录凭据和链接。
请先检查源文件、所用的键、映射以及转换逻辑;错误日志会显示问题出在哪里。 对于技术支持而言,最有帮助的信息包括:匿名化的导入文件、受影响的接口、样本ID或导入ID、具体的错误信息,以及您预期应得到的结果。这样可以更快速地锁定问题根源。
创建和修改导入接口的权限仅限于管理员角色。对于SFTP和API访问,必须使用安全的访问凭证,并区分测试环境和生产环境的访问权限;同时,明确界定了实验室、IT部门与接口维护团队之间的职责分工。 敏感的测量数据和患者数据仅通过经协调且安全的渠道传输;对于示例文件和基于人工智能的映射,必须进行匿名化处理。
是的。在系统部署过程中,我们会使用这些导入接口来迁移您的历史数据——您无需使用单独的迁移工具。 这样,历史检测结果、客户和参数主数据以及大量旧校准证书(例如来自 Lotus Notes 的数据)就会导入LDB LIMS,随后即可像往常一样用于数据分析。结构化的 CSV 文件最为合适;旧数据的结构越规范,后续需要处理的工作就越少。 其优势在于:用于数据迁移的接口,正是后续日常运营中持续运行的同一接口。
对于测量数据接口,具体操作步骤如下:
  1. 在Excel中打开设备的导出文件,并将其保存为采用UTF-8字符集的CSV文件。
  2. 检查属性行,并将导出文件中的参数名称填入参数主数据字段导入键中。
  3. 在样本 → CSV 导入接口 → 新建接口下创建接口:选择类型测量数据,设置字符集为 UTF-8,并勾选样本导入。
  4. 若缺少属性行或其内容不完整:请补充列标题——列标题必须唯一且不得包含空格——并指定从第几行开始导入。
  5. 上传文件,进行映射并分配数据。
  6. 导航至相应样本,并在该处上传文件。
随后在测试系统中测试错误和特殊情况,先使用少量数据投入生产运行,并逐步扩展自动化和监控功能。 必填字段、状态逻辑、设备格式和匹配规则,我们将通过接口研讨会共同确定。

附带视频的分步指南:导入测量数据。 延伸阅读:导入接口概览、创建CSV测量数据导入接口、 导入测量仪器的结果、其他数据格式的转换代码、 自动FTP/SFTP导入以及导入接口的AI扩展。

是的。每个导入接口都有一个独立的 HTTPS 端点,外部系统可通过 POST 方法向该端点发送数据——登录方式为 Basic Auth 或证书。 如果数据被成功接收,该端点将返回 200 状态码;如果数据已到达但无法处理,则返回 400 状态码;每次尝试都会显示在接口概览中。 在反向方向上,分析报告会提供外部系统或AI助手可调取的数据。手册中详细介绍了其结构和测试调用方法。
是的。管理员可以自行创建新的CSV接口:上传示例文件、选择分隔符和字符集、将列映射到目标字段,然后保存。 只有当需要处理特殊格式而必须编写转换代码时,才需要编程知识——而您的管理员也可以自行编写和维护这些代码。
是的。字符集、日期格式和小数分隔符需根据具体接口分别设置。 这样,使用“.”作为小数分隔符或以 MM/DD/YYYY 格式输出日期的设备,数据就能被正确读取。经验表明,此处设置错误是最常见的导致变音符号乱码和测量数值被误解的原因。
是的,这其实是常见的情况。许多实验室最初会从主数据(客户、参数、阈值)开始迁移,并将结果历史数据暂时保留在旧系统中。在并行运行期间旧系统中新增的数据,您稍后可通过同一导入接口将其导入;进行第二次迁移也并非特例。 具体导入多少历史数据,由您决定。
是的,而且更正过程始终可追溯。审计日志会记录谁在何时修改了哪个数值;同时,最初导入的数值也不会丢失。您可以通过访问权限设置来确定谁有权限进行修改,谁仅限查看。
这并非传统意义上的文件夹监控——实现该功能的方式是SFTP。您的设备或服务器将文件存放在SFTP目录中,LDB LIMS每隔十分钟会自动提取这些文件(每个周期最多十个文件),随后将其移动或删除。 对您的员工来说,结果是一样的:只需将文件存入指定位置即可,无需任何人进行上传操作。
是的。这种连接并非单向的:LDB LIMS可以通过 REST-API 向设备或外部系统发起查询——例如,它发送一个样本编号,设备则会返回该特定样本的检测结果。 如果不想让设备存储文件,或者希望控制何时获取哪些数据,这是一种简洁的方法。至于LDB LIMS应输出哪些数据,您可以通过分析来设定。
是的,两者都有。我们与合作伙伴Splashlake共同实施AnIML,而LDB LIMS已支持SiLA标准。特别是在招标文件中,这两项标准经常被提及——但在实际应用中,大多数数据对接仍通过CSV、设备专用的导出文件以及REST-API来实现。

入职流程:导入接口

自动从设备、外部实验室和ERP系统导入测量值、样品和客户数据

  1. 从CSV文件导入测量值
  2. 访问权限、导入密钥和导入模式
  3. 无需编程知识即可进行AI数据映射
  4. 通过转换代码集成 GC 和 HL7 文件
  5. 通过HTTPS和SFTP实现自动化,与ERP系统对接
  6. 关于该主题的常见问题导入接口和LIMS

LDB 功能

实验室信息管理系统(LIMS)

质量管理模块

简化文档记录,将 ISO 要求融入日常工作