当TASKCTL作业或系统发生异常时,系统会自动生成消息。如果你设置了短信邮件相关信息,系统会自动将异常信息以短信或邮件的方式发送到指定的手机或邮箱。
短信与邮件发送的使用方法与步骤为:
- 定义用户
- 短信或邮件发送接口程序的开发
- 测试接口程序
- 接口程序部署以及配置
定义用户
从6.0版本开始,调度异常短信邮件接收,需要通过客户端组件admin创建独立的用户。每个用户包含用户ID,姓名、电话号码、邮件地址、以及用户权限组信息等。
当然,用户的定义,不是因需接收短信才定义,而是使用TASKCTL的良好习惯。
短信或邮件发送接口程序的开发
接口程序的作用
每个用户企业内,邮件短信的发送方式以及接口均不同,因此,TASKCTL需要你开发自定的发送接口程序。通过接口程序,你可以将指定的内容发送到指定的手机或邮箱。
支持的接口程序类型
TASKCTL6.0及以上版本可以支持的接口程序类型包括:shell程序、可执行命令程序、java程序、python程序四种。
接口程序的入口参数
- 短信发送接口程序的入口参数为: 电话号码,消息内容的文件名称
- 邮件发送接口程序的入口参数为: 邮件地址,消息内容的文件名称
接口程序的正确返回值,一定要设置为4
比如:如果你的接口程序为shell脚本,最后应该添加exit 4;
测试你的接口程序
- 构建一个即将发送内容的文件
- 短信接口测试(shell方式) sh [接口程序] [电话号码] [信息文件名] 如果通过运行以上命令,能发送短信,就表示接口程序测试通过。
- 邮件接口测试(shell方式) sh [接口程序] [邮件地址] [信息文件名] 如果通过运行以上命令,能发送邮件,就表示接口程序测试通过。
接口程序部署以及设置
1.程序部署
将相应接口程序上传到调度服务器安装用户环境。目录你可自己指定。如果是可执行程序,记住赋予执行权限。
2.信息设置
程序部署完后,用admin超级用户登录Admin客户端组件,进入短信邮件设置界面。设置界面如下:
- 发送程序名称:你部署接口程序的全路径
- 程序类型:接口程序的类型
- 编码:你邮件服务器或短信服务的具体编码
关于编码容易犯的错误:你的接口程序中添加中文内容(比如短信头信息),编码一定与该配置编码相同。
经过以上步骤,你的短信邮件配置就算完成了。