07- V15 ESOP插件使用说明 - OrDroid APP 相关

# 一、背景与目的
电子作业指导书（ESOP），是作业指导者对作业者进行标准作业的正确指导的基准。作业指导书基于零件能力表、作业组合单而制成。是随着作业的顺序，对符合每个生产线的生产数量的每个人的作业内容及安全、品质的要点进行明示。而E-SOP系统实现作业指导书电子化，并统一管理和集中控制的一套管理信息平台。
# 二、OrDroid-ESOP插件配置及界面简介
2.1 OrDroid-ESOP插件配置
![](/media//202212/2022-12-15_170359.png)
2.1.1 插件文件名:OrDroidESOP.apk
2.1.2 自定义APP包名:com.ordroid.plugin.esop
2.1.3 自定义APP启动类路径:com.ordroid.plugin.esop.ui.activity.MainActivity
2.2 下载安装和权限设置
2.2.1 下载安装
APP插件可从PKM中下，从"产品"分组中打开"软件版本管理"元对象插件，选择"012 OrDroid APP 软件 V15.2（推荐使用）"，在"文件列表"中找到"OrDroidESOP.apk"下载，如图。
![](/media//202212/2022-12-16_105529.png)
2.2.2 权限设置
APP安装完成后，还需设置权限方可使用，如图。
![](/media//202212/2022-12-16_105423.png)
# 三、OrDroid-ESOP使用
3.1 选择用户所在的工作中心与工位
![](/media//202308/2023-08-10_105325.png)
3.2 选择需要查阅的SOP文件(当SOP列表只有1个SOP文件时，将会默认打开)
![](/media//202308/2023-08-10_105629.png)
3.3 文件查阅效果
![](/media//202308/2023-08-10_105754.png)
3.4 SOP下载
程序将会自动调用存储过程OrDroid_FtpFileGet获取Ftp下载关键字段，如Ftp地址、Ftp账号、Ftp密码、Ftp主目录、Ftp子目录、下载文件名称等关键字段(所以用户在上传前必须检查Ftp地址、Ftp账号、Ftp密码、Ftp路径、下载文件名称是否正确，否则将无法下载文件),然后程序根据获取到的Ftp路径、文件名将图片下载到移动端。

# 四、刷新工作中心列表
4.1 手动刷新工作中心列表
4.1.1 下拉刷新工作中心列表
![](/media//202308/2023-08-10_111234.png)
4.1.2 上拉刷新工作中心列表
![](/media//202308/2023-08-10_111323.png)

# 五、刷新SOP文件列表
5.1 手动刷新文件列表
5.1.1 下拉刷新
![](/media//202308/2023-08-10_110234.png)
5.1.2 上拉刷新
![](/media//202308/2023-08-10_111604.png)
5.2 定时刷新文件列表
5.1 在系统参数增加[OrDroid ESOP Refresh Time Interval]参数
![](/media//202308/2023-08-10_111747.png)
5.1.2 增加存储过程OrDroid_GetSysParameter
```sql
-- =============================================
-- Author：		<OrBit Team Administrator>
-- Create date： <2021.11.01>
-- Description： OrDroid 一次获取OrDroid相关系统参数
-- =============================================
ALTER PROCEDURE [dbo].[OrDroid_GetSysParameter]
@I_Sender nvarchar(200)='', --客户端执行按钮
@I_ReturnMessage nvarchar(max)='' output,  --返回的信息,支持多语言
@I_ExceptionFieldName nvarchar(100)='' output, --向客户端报告引起冲突的字段
@I_LanguageId char(1)='1',				--客户端传入的语言ID
@I_PlugInCommand varchar(5)='',		--插件命令
@I_OrBitUserId char(12)='',			--用户ID
@I_OrBitUserName nvarchar(100)='',	--用户名
@I_ResourceId	char(12)='',		--资源ID(如果资源不在资源清单中，那么它将是空的)
@I_ResourceName nvarchar(100)='',	--资源名
@I_PKid char(12) ='',				--主键
@I_ParentPKId char(12)='',			--父级主键
@I_Parameter nvarchar(100)=''		--插件参数
--以上变量为系统服务固定接口参数，必须在每一个DoEvent过程中实现.

AS
BEGIN
	-- SET NOCOUNT ON added to prevent extra result sets from
	-- interfering with SELECT statements.
	SET NOCOUNT ON;
	SET TRANSACTION ISOLATION LEVEL READ UNCOMMITTED

select 
		ParameterId,
		ParameterName,
		ParameterDescription,
		ParameterValue,
		ParameterValueEx 
	from SysParameter 
	where parametername like '%[OrDroid %'
	order by ParameterName

RETURN 0
	
END
```

# 六、SOP文件循环播放
6.1 增加SOP表字段PlayTime
![](/media//202308/2023-08-10_112631.png)
6.2 增加元对象SOP元字段PlayTime，为SOP文件设置播放时间
![](/media//202308/2023-08-10_141351.png)
6.3 修改存储过程OrDroid_GetESOP，在最后返回字段中增加PlayTime字段，如下图。
![](/media//202308/2023-08-10_141627.png)

# 七、备注
7.1 当用户同时设置定时刷新SOP文件列表和SOP文件播放时间时，在循环播放文件过程中，当定时刷新SOP文件列表时间满足后，将会中断当前播放，返回SOP文件列表UI刷新SOP文件列表。
7.2 当用户设置当前SOP文件播放时间为0时，则会暂停循环播放，一直停留在当前SOP文件中。
7.3 获取工作中心存储过程OrDroid_GetWorkcenter
7.4 获取工位存储过程OrDroid_GetStation