任务自定义触发器

 

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

 

 

配置新操作

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

  • 单击“新建操作”。

  • 输入该操作的名称和说明,并选择必须执行该操作的时间。

 

 

 

 

  • 设置任务在何种条件下必须执行该操作。您可以通过单击 + 图标添加多个条件。根据需要在条件之间切换 AND 和 OR 运算符。

 

 

  • 选择操作类型(自定义函数/脚本),并指向包含要触发脚本的相应文本文件。


在“执行操作”下,选择您要执行脚本还是自定义函数,并根据以下提示进行配置:

  • 脚本:指定包含脚本的文件名。例如,addcomments.txt。

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

  • 支持的返回操作:UPDATE_TASK、ADD_COMMENTS 和 ADD_WORKLOG

 

 

请确保您为“新建操作”输入唯一名称,以免与现有“操作”名称冲突。

请确保包含脚本的文本文件仅存储在指定位置。请按如下目录进行存储:[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

表示任务所使用的模板