系统管理-扩展模块-到期通知
本帖最后由 adminlily 于 2020-12-11 10:09 编辑到期通知名称：到期通知
描述：即将到达日期时，获取通知
版本:1.0.1
发布:2019-02-18
itop-version-min：2.3.0
下载：[ ttps://store.itophub.io/en_US/products/combodo-notify-on-expiration]https://store.itophub.io/en_US/products/combodo-notify-on-expiration
代码：combodo-notify-on-expiration
状态：稳定
特征
当即将到达到期日期时，此扩展名允许触发器通知使用。
[*]您可以定义各种到期规则，以用于不同的用途。针对合同和许可证到期，它可以与日期为属性的任何类一起使用。
[*]您可以为同一类别设置多个规则，并具有不同的通知期限，例如，时限的“提前3个月”和另一个“提前1个月”。如果需要，您甚至可以在时限之后的“ 5天”创建第三个。
[*]除非配置不同，否则到达到期的特定对象的通知仅会发生一次。
[*]通知消息可配置为任何标准触发动作。
[*]如果需要高级，则可以使用OQL在通知的范围中定义对象。
局限性
[*]到期通知仅每天发生一次。
[*]它不是为处理时间而设计的，仅用于日期。
要求
iTop 2.3.0或以上
修订记录
日期版本描述
2019-02-181.0.1修复菜单丢失和改进时间格式的鲁棒性
2019-01-101.0.0首个正式版本-已弃用
2018-03-280.1.0第一个发布
安装
使用标准安装流程file:///G:\wiki\page%3fid=extensions:installation 对于此扩展。
配置
一旦安装了新模块，请编辑配置文件config-itop.php并查找以下新部分：
'combodo-notify-on-expiration' =>(
'time' => '03:00',
'enabled' => true,
'debug' => false,
),
以下设置可用于配置模块：
参数类型描述默认价值
时间小时：分钟流程应该启动的一天中的时间。03:00
已启用布尔值流程应该运行吗？true
调试布尔值CRON日志是否应包含调试信息？false
服务ron.php每天处理到期上的通知。确保计划将其运行在系统上。有关本章的更多信息后台任务.
要检查此服务的状况，请使用以下命令：
php webservices/cron.php --auth_user=admin --auth_pwd=admin --status_only=1
如果自安装扩展以来CRON至少没有运行过一次，则任务NotifyOnExpiration不会在此处列出。
用法
示例：在许可证过期前20天设置通知
[*]创建一个到期规则
[*]创建一个触发器
[*]创建一个通知
到期规则
该扩展在“服务管理”类别中引入了新的菜单项到期规则
要创建一个新的：
[*]给它任何你喜欢的名字，
[*]定义将在其上应用规则的类，期望使用类代码，例如。客户合同
[*]给它一个状况：激活以使cron在后台任务中执行此到期规则。
[*]通过在…选项1（简单）或…选项2（高级）字段集中填写字段来选择“已应用”选项：
简单
[*]定义要检查的日期，该日期必须是日期属性的代码，而不是标签。
[*]通知期限是可配置的，它通过指定时限之前的天数来说明何时向触发器发送通知，
https://www.itophub.io/wiki/media?media=extensions%3Aexpirationrulesimple.png
示例：设置 Class=Licence, Date to check=end_date 和“ Term of notice=20，则最终的OQL将为：
SELECT Licence WHERE end_date = DATE_ADD(CURRENT_DATE(), INTERVAL 20 DAY)
高级
[*]使用OQL查询定义OQL范围，以返回要在其上应用触发器的对象。输入OQL后，即使还记录了简单的选项，也将使用高级选项。
[*]使用高级模式，您可以在日期后使用触发器通知，这在简单模式下是不可能的。
https://www.itophub.io/wiki/media?media=extensions%3Aexpirationruledetails.png
您可以为许可证，客户合同创建任意数量的到期规则，甚至可以为同一类创建多个规则，但使用不同的通知期限
预习
[*]如果运行到期规则，则可以随时检查哪些对象将是触发器。
https://www.itophub.io/wiki/media?media=extensions%3Aexpirationrulepreview.png
触发器
使用添加的扩展名创建触发器：触发器（在到期上）
https://www.itophub.io/wiki/media?w=600&tok=e658fa&media=extensions%3Aexpirationtrigger.png
您可以使用OQL进一步过滤器：
SELECT Licence WHERE perpetual='no'
如果您有大量对象，则在到期规则中尽可能地提高过滤器的效率
通知
创建一个通知，定义谁应该接收它以及消息的正文
在标准之上占位符，此扩展程序还带来了：
占位符目的
$rule->name$到期规则的名称，该规则具有触发器此通知
$rule->description$到期的到期规则的描述
$rule->term_of_notice$到期规则定义的通知期限，该规则具有触发器和通知
https://www.itophub.io/wiki/media?media=extensions%3Aexpirationnotification.png
将通知链接到上面创建的触发器。
常见问题解答
问：子菜单到期规则未出现在服务管理下
答：同样，尚不了解此问题的根因，如果没有该菜单，有很多创建到期规则的可能性。
[*]在类ExpirationRule上，将仪表盘徽章添加到您的仪表板中：它提供了一种创建新规则并列出现有规则的方法。
[*]使用菜单管理工具下的运行查询子菜单：SELECT ExpirationRule，它应该为您建议一个链接来创建一个新链接。
[*]在菜单管理工具下，将子菜单全局搜索和搜索用于ExpirationRule类，它将列出现有规则，并列出供应以使用“新建”菜单创建一个规则
页:
[1]