文档变更历史
- 2024-12-02: 增加测试设备扫SN自动传送测试结果及报工处理接口;增加SN校验方式参数
- 2024-12-12: 增加 料品关联文件名称列表接口
- 2024-12-12: 增加 下载料品关联文件接口
- 2025-01-14: 增加帐套参数dbmapId，支持多帐套处理测试结果及报工
测试设备扫SN自动传送测试结果及报工处理
接口地址
http://MES服务器:8003/api/impl/autoTestQcRecordAndProReport
http://MES服务器:8003/api/impl/autoTestQcRecordAndProReport/{dbmapId}
将MES服务器替换为实际的MES地址和端口号
调用方式
POST
身份验证
客户端暂时无需配置身份验证
接口说明
- 通过请求的Body传递json数组
- 参数 dbmapId 表示第几个帐套，第一个帐套参数为0 或不传参数，第二个帐套参数为 1，以此类推; 帐套信息在配置文件appsettings.json中设置
- 属性首字符小写
[
{
"serialNo": "序列号1" ,//序列号, 字符串 ,不能为空
"deviceNo": "设备编码" ,//测试设备编码, 字符串 ,不能为空
"proNo": "工序编码" ,//工序编码, 字符串 ,不能为空
"qcPass": "1" , //测试结果, 0:不合格, 1:合格, 字符串 ,不能为空
"qcDate": "2024-12-02 10:05:10" //测试时间, 字符串 ,不能为空,格式 : yyyy-MM-dd HH:mm:ss
"snCheckSta": "1" //SN校验方式 , 字符串 ,默认为null, "1":表示要校验标签是否在标签库中、上工序是否合格，返回结果中记录不在库或上工序不合格的标签
},
{
"serialNo": "序列号2" ,//序列号, 字符串 ,不能为空
"deviceNo": "设备编码" ,//测试设备编码, 字符串 ,不能为空
"proNo": "工序编码" ,//工序编码, 字符串 ,不能为空
"qcPass": "0" , //测试结果, 0:不合格, 1:合格, 字符串 ,不能为空
"qcDate": "2024-12-02 10:06:15" //测试时间, 字符串 ,不能为空,格式 : yyyy-MM-dd HH:mm:ss
"snCheckSta": "1" //SN校验方式 , 字符串 ,默认为null, "1":表示要校验标签是否在标签库中、上工序是否合格，返回结果中记录不在库或上工序不合格的标签
}
]
返回结果
- 所有传入的序列号都不在标签库中时，直接返回 -1， 提示错误信息
{
"resultCode": 1 , //1: 成功 ,-1: 失败
"resultText": "错误信息" ,//失败时返回错误信息
"resultNote": //默认空字符, 有不符合的标签时，返回到json中
{
[
{
"serialNo": "序列号1" //序列号, 字符串 ,不能为空
"errorMsg": "错误信息" // 字符串
},
{
"serialNo": "序列号2" //序列号, 字符串 ,不能为空
"errorMsg": "错误信息" // 字符串
}
]
}
}
注意事项
需要考虑设备离线的情况; 每次调用接口时每个序列号的snCheckSta参数必须相同，不同时要分开调用接口
ERP中《料品资料维护》里面图纸上传功能
- 通过 料品关联文件名称列表接口、下载料品关联文件接口 来实现。
- 先调用料品关联文件名称列表接口，获得料品对应的文件id，再通过文件id 调用 下载料品关联文件接口 来获到料品图纸文件。
料品关联文件名称列表
接口地址
将MES服务器替换为实际的MES地址和端口号
调用方式
POST
身份验证
客户端暂时无需配置身份验证
接口说明
- 通过请求的Body传递json数组
[
"料品编码1"，
"料品编码2"
]
返回结果
{
"resultCode": 1 , //1: 成功 ,-1: 失败
"resultText": "错误信息" ,//成功时返回空字符串，失败时返回错误信息
"resultNote":
{
[
{
"id": "文件id1" //唯一值, 没有对应的文件时，返回空字符串
"partItemNo": "料品编码1" ,
"fileName": "文件名称1" // 包含文件扩展名; 没有对应的文件时，返回空字符串
},
{
"id": "文件id2" //唯一值, 没有对应的文件时，返回空字符串
"partItemNo": "料品编码1" ,
"fileName": "文件名称2" // 包含文件扩展名; 没有对应的文件时，返回空字符串
},
{
"id": "文件id3" //唯一值, 没有对应的文件时，返回空字符串
"partItemNo": "料品编码2" ,
"fileName": "文件名称3" // 包含文件扩展名; 没有对应的文件时，返回空字符串
}
]
}
}
下载料品关联文件
接口地址
将MES服务器替换为实际的MES地址和端口号
调用方式
GET
身份验证
客户端暂时无需配置身份验证
接口说明
- 使用料品关联文件名称列表接口获得的 文件id 替换接口地址 {fileId}
返回结果
返回下载文件
注意事项
一次下载一个文件，当料品对应多个文件时，按 文件id 多次下载