山东省粮油仓储管理系统（云平台）.docVIP

附件1 山东省粮油仓储管理系统（云平台）数据接口规范 1 规范说明： 本规范主要用于确保我省粮食仓储企业建设数字粮库或购销存管理系统时，与省粮油仓储管理系统（云平台）之间互联互通，系统间的数据传输通讯采用TCP协议、短连接方式，省粮油仓储管理系统（云平台）为服务器方，TCP监听端口为6888。 2 接口地址： 当前数据接口地址为：124.128.83.156:6888；升级至云平台模式后，地址另行公布。 3 数据同步： 云平台采用分布式数据库设计，并设计开发同步服务程序。粮油仓储企业建设的信息化系统，应执行本标准并与省粮油仓储管理系统（云平台）之间的进行数据定时同步，同步区间默认为一天一次，凌晨执行。同步频率可根据需要灵活调整。数据同步过程对用户是透明的。 云平台使用WebService接口，允许其他系统获取备案系统中的基础数据，并允许其他系统上传业务数据。上传接口支持多种数据方式。具体可参见相关接口说明。 获取库区:GetKuQu 方法说明：获取本单位在省粮油仓储管理系统（云平台）中的所有库区信息。 Public DataTable GetKuQu (string str用户名,string str密码) 参数说明： 参数 描述 Str用户名 省粮油仓储管理系统（云平台）中的登录单位用户名 Str密码 省粮油仓储管理系统（云平台）中的登录单位密码 返回值 返回库区列表的数据集 获取仓房:GetCangFangByKuQu 方法说明：获取本单位在省粮油仓储管理系统（云平台）中的所有仓房信息。 Public DataTable GetCangFangByKuQu (string str用户名,string str密码，int 库区ID) 参数说明： 参数 描述 str用户名 省粮油仓储管理系统（云平台）中的登录单位用户名 str密码 省粮油仓储管理系统（云平台）中的登录单位密码 int 库区ID 省粮油仓储管理系统（云平台）中的库区ID 返回值 返回仓房列表的的数据集 上传数据:UpdateData 方法说明：上传业务数据。 Public string UpdateData(string str命令,string str表名，string str备注,DataTable dt数据) 参数说明： 参数 描述 str命令 上传命令。说明上传的是数据处理方式 str表名 要上传的业务表名 str备注 上传备注信息 Dt数据 上传数据内容 返回值 上传是否成功。成功返回1，失败返回0或者相关错误信息。 上传粮情数据:UpdateLiangQing 方法说明：上传一栋仓房的一次测温结果数据。服务方不对上传数据是否重复进行验证。 Public string UpdateLiangQing (DataTable dt粮情数据) 参数说明： 参数 描述 dt粮情数据 粮情数据。粮情数据应按照粮情表格要求提供，并确保相关货位数据已上传。 返回值 上传是否成功。成功返回1，失败返回0或者相关错误信息。 上传数据:UpdateFile 方法说明：上传识别代码文件、购销系统数据文件或者其他类型文件型数据。 Public string UpdateFile(string str命令,string str文件名，string str备注,byte[] b文件) 参数说明： 参数 描述 str命令 上传命令。说明上传的是识别代码文件或者购销存数据文件或者其他文件 str文件名 要上传的文件名 str备注 上传备注信息 b文件 上传文件流 返回值 上传是否成功。成功返回1，失败返回0或者相关错误信息。 4 调用过程说明 在上传本单位业务数据结果前，应首先获取本单位信息、库区信息、仓房信息，并确保相关业务信息的外键ID与省粮油仓储管理系统（云平台）中的数据一致，然后根据业务顺序，逐表上传数据。上传业务数据时，应确保关联信息（如客户、货位等基础信息）已上传。数据上传失败后，应按照错误提示重新进行上传。 5 主要业务表结构 货位表 名称 标准平台字段名称 标准化文档字段名称（英文） 数据格式 ID ID GUID ID_主管单位 ID_ZhuGuanDanWei n ID_粮油性质 ID_LiangYouXingZhi GUID ID_仓房 ID_CangFang GUID ID_等级 ID_DengJi GUID ID_储存方式 ID_ChuCunFangShi GUID ID_粮油品种 ID_LiangYouPinZhong GUID ID_管理方式 ID_GuanLiFangShi GUID 货位名称 HuoWeiMingCheng a..50 粮权归属 LiangQ