任务自定义触发器

任务自定义触发器

使用任务触发器可通过脚本文件或自定义函数自动触发任务上的任何动作。 您可以定义规则，并对符合这些规则的任务应用预定义的动作。 在其他模块或第三方应用程序中执行动作时，触发器非常有用。

 

 

创建新动作

要为任务创建新的自定义触发器

  • 点击新建动作。

  • 输入动作名称和说明，并选择执行动作的时间。

 


 

 

 

  • 设置必须在项目上执行动作的条件。 点击 + 图标可添加多个条件。 根据需要在条件之间切换 AND 和 OR 运算符。


 

  • 选择动作类型（自定义函数/脚本），并指向需要触发的相应脚本文件。

在执行动作下，选择要执行脚本还是自定义函数，并使用以下指引进行配置：

  • 脚本： 指定脚本文件的名称。例如，addComments.txt。

  • 自定义函数： 通过执行自定义函数，您可以在 ServiceDesk Plus 和其他外部应用程序中添加的动作数据。选择所需的自定义函数或添加新函数。

  • 支持的返回动作： 更新任务、添加注释和添加工作日志

 

 

确保为新添的动作输入唯一的名称，以免与现有的动作名称冲突。
确保脚本文件只存储在指定位置。存储在如下目录中： [SDP_Home]/integration/custom_scripts/executor_files
默认情况下，停止处理后续动作始终处于启用状态，动作将按照动作规则顺序执行。
通过列表视图中的组织动作，可以重新排列动作的执行顺序。
在脚本中，可以将 API 参数作为参数传递，例如 py addComments.py $TITLE $TYPE。
taskObj 和 context 是自定义函数中支持的参数。 

脚本参数

我们还可以为自定义脚本传递参数。 下表列出了任务自定义触发器中脚本的可能参数。


任务自定义触发器中脚本的可能参数

 

参数

描述

$TITLE

表示任务标题

$ID

提供为任务生成的唯一 ID

$PRIORITY

表示任务的优先级

$STATUS

表示任务的状态

$TYPE

表示任务类型

$ASSOCIATED_ENTITY

表示任务的父级

$PERCENTAGE_COMPLETION

提供任务完成百分比

$ESTIMATED_EFFORT

以天、小时和分钟为单位提供估计工作量

$ADDITIONAL_COST

提供任务的额外费用

$CREATED_BY

提供创建此任务的用户/技术人员的详细信息。

$CREATED_TIME

提供创建任务的时间

$SCHEDULED_START_TIME

提供任务的预定开始时间

$SCHEDULED_END_TIME

提供任务的预定结束时间

$ACTUAL_START_TIME

提供任务的实际开始时间

$ACTUAL_END_TIME

提供任务的实际结束时间

$ISOVERDUE

表示任务是否逾期

$OWNER

表示为任务指派的所有者

$GROUP

表示指派任务的组别（不适用于常规任务、项目任务和里程碑任务）

$MARKED_OWNER

表示为任务标记的所有者

$MARKED_GROUP

表示任务标记的组别（不适用于一般任务、项目任务和里程碑任务）

$TEMPLATE

表示任务使用的模板