原子能院接口提资业务在SmartPlant® Foundation的应用

禹童威（鹰图软件技术（青岛）有限公司）

摘 要： 接口提资业务是原子能院的一项重要业务流程，本文介绍使用SmartPlant Foundation的配置和开发来实现原子能院接口提资业务的需求。

涉及的海克斯康数字智能产品：SmartPlant Foundation

1. 接口提资需求分析

1.1 接口提资术语定义

1.1.1 设计接口

是指一个单位、工作组或个人的设计责任和设计活动与其他单位、小组或个人的设计责任和设计活动之间的分界。设计接口分为内部接口和外部接口。

1.1.2 内部接口

核工程设计研究所各设计室或各专业之间的设计接口。

1.1.3 内部接口信息传递单

用于内部接口交换的接口文件。

1.1.4 接口状态

指接口交换所处的状态，分为PRE和FIN。PRE指接口处于初版交换状态，FIN指接口处于终版交换状态。

1.2 接口提资工作程序和要求

1.2.1 内部接口信息传递单

内部接口走完流程后按照要求生成的信息传递单据。

1.2.2 内部接口交换工作流程

设计人员根据内部接口手册规定的时间在数字化工厂平台通过《内部接口信息传递单》进行提资，必要时应附以图纸或文件作为附件。

接口发布方应在提资前主动与接口接收方就提资内容进行沟通，避免重复工作。在提资过程中，接口发布方应跟踪《内部接口信息传递单》的签批流程，及时提醒相关审批人员完

成签字。

在《内部接口信息传递单》审签过程中，数字化平台应具备提醒功能，如48小时内未完成批准或退回，应通过弹窗等形式进行提醒。

内部接口关闭的标志为FIN版《内部接口信息传递单》完成全部审批流程。

1.2.3 内部接口重新打开

对于需要重新打开的内部接口，申请打开接口的一方（可以是接口发布方或接收方）应主动与另一方沟通，并填写《内部接口新增、变更和重新打开申请单》。该申请单完成全部审批流程后，接口发布方应在5个工作日内完成接口升版工作。

接口工程师收到《内部接口新增、变更和重新打开申请单》后，在数字化平台将相关内部接口设置为打开状态，平台应具备提醒功能，如72小时内未升版接口，平台应通过弹窗等形式进行提醒。

1.3 接口提资开发要求

1.3.1 基本功能

《内部接口信息传递单》所有审批签字均为电子签名，自动添加签字日期。

接口手册以Excel文件形式导入数字化平台，并具备修改、删除和检索功能。接口手册中除序号以外其他内容均可以在后期修改，接口条目可以删除。修改和删除权限仅限于管理员账户。所有账户均可对内、外部接口手册每一列内容进行针对性检索。

《内部接口信息传递单》与接口手册进行数据关联，编辑接口单时输入接口序号，其它内容自动录入。接口单完成全部审批流程后由数字化平台自动分发给相关人员。

数字化平台自动记录接口交换过程，生成接口交换跟踪记录表，跟踪记录表可以Excel格式下载。

数字化平台自动生成接口报表。

《内部接口信息传递单》在审签过程中对非技术性内容可以进行修改，具体规则如下：

1.3.3 管理权限

接口管理权限分为普通用户和管理员。普通用户具备编制接口单、查阅接口手册和接口报表的权限；管理员在普通用户权限基础上，增加接口手册上传、修改和删除接口条目、修改接口单非技术内容、下载成品接口文件等权限。

2. 接口提资开发

2.1 文档类型定制：

文档类型的定制，按照接口提资的需求，将每个接口自定义一种文档类型，在SmartPlant Foundation中定制所需的文档类型数据结构。

内部接口提资文档定义为CIAEInnerJKDocMaster、CIAEInnerJKDocRevision、CIAEInnerJKDocVersion类型文档。

2.2 文档属性定制

增加接口提资需要自定义各种属性，在S m a r t P l a n tFoundation文档的Master、Revision和Version进行添加。比如接口固有属性序号、第1方、第2方、类型、流水号、发布方、接收方、接口详细描述、责任室、初版交换日期、终版交换日期、计划关闭时间、发布专业、发布方责任人、发布责任总师、接收专业、接收方责任人、接收责任总师、发布方责任设总、接收方责任设总、要完成的文件图纸名称（接收方填写）、要完成的文件图纸日期（接收方填写）、所属系统代码（发布方）、所属子项代码（发布方）、生成模板等，可以在Master上添加属性。和传送单有关的信息，可以在Revision上创建属性来记录。

定制接口提资文档类型属性：

导入的Master及Revision的属性在SmartPlant Foundation中查看：

2.3 定制Form

配置文档属性的查看页面，可依据用户的权限对文档属性随时进行点选查看的基本操作。定制SmartPlant Foundation中接口提资文档属性的查看页面：

2.4 版本定制

文档版本的定制。需要根据原子能院文档版本的要求在SmartPlant Foundation中定制主版本和工作版本，示例如下：

原子能接口提资模板定制，增加PRE、FIN版本，其中小版本均为A到Z。

版本导入后在SmartPlant Foundation中可以查询到版本。

2.5 文档模板管理

通过SmartPlant Foundation建立原子能文档模板管理，可以将模板文件按版本进行统一的管理，模板主要指接口提资文件模板。

将所有空模板上传至SmartPlant Foundation某一目录下，供所有提资人员进行下载后填写，从而形成接口提资的附件，以下以管线一览表为例。

当客户进行接口提资申请时，选择一接口提资项目，比如2538，SmartPlant Foundation会自动在数据库中获取数据生成管线一览表，省去了上传附件的过程。

2.6 文件检索配置

文件检索的约束配置，配置SmartPlant Foundation的WebClient检索功能以及检索条件，提供多种文档检索方式，如目录方式、编码快速查询、属性查询、全文检索等。

SmartPlant Foundation中的查询可通过配置ColumnSet实现，一个ColumnSet由多个Columnitem组成。

例如我的接口提资ColumnSet。

2.7 权限管理配置

权限管理的配置开发，根据原子能院专业人员的资质，建立各种专业组，结合SmartPlant Foundation的权限矩阵的配置功能，对SmartPlant Foundation的权限矩阵进行配置，以满足相应人员登录SmartPlant Foundation的各种满足权限的操作，或操作工作流的需求。

2.8 工作流程的定义

按照接口提资的校审流程定制相应的工作流程，其中JKTransferGenerate工作流程为开发生成接口传送单的流程。

2.9 接口提资申请界面

用户可以选择相应代码的接口进行提资，申请接口提资后，在Web Client中进入如下界面：

点击确定后，相应的接口提资文档进入工作流程，每级校审人员的代办事项需要进行批准或打回的处理。最终走完流程后，生成接口传送单，同时接口传送单的相关属性值回写进入Revision下的属性中供后期进行查看。

2.10 接口提资的升版

对已经走完流程是Signoff状态的接口文档，需要管理员进行该文档的Revise，才可以进行该接口文档的重新打开，供用户对该接口再次进行申请操作。重新申请的接口提资单据，小版本由A到Z排序，例如之前的接口提资版本是PRE/A版本，后续版本是PRE/B或FIN/B，由申请界面控制版本的升版规则。