项目自定义触发器

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

 

配置新操作

要为项目创建新的自定义触发器

  • 转到 管理 > 自动化 > 自定义触发器,然后选择 项目

  • 单击“新建操作”。

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

 

 

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

 

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


在“执行操作”下,选择您是要执行脚本还是自定义函数,并按照以下说明进行配置:

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

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

  • 支持的返回操作:UPDATE_PROJECT 和 ADD_COMMENTS

  • 取消选中“停止处理后续操作”复选框后,即使某个操作规则已应用于项目,也会继续执行后续操作。

 

 

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

请确保脚本文件仅存储在指定位置。请按如下目录存储:[SDP_Home]/integration/custom_scripts/executor_files

默认情况下,“停止处理后续操作”始终处于启用状态,操作将按照“操作规则顺序”执行。

列表视图中的“整理操作”允许您重新排列操作的执行顺序。

在脚本中,您可以将 API 参数作为参数传递,例如 py addComments.py $TITLE $TYPE。

projectObj 和 context 是自定义函数中支持的参数。

 

 

脚本参数

我们还可以为自定义脚本传递参数。下表显示了项目自定义触发器中脚本可用的参数。

项目自定义触发器中脚本的可用参数

 

参数

说明

$TITLE

表示项目标题

$ID

提供为项目生成的唯一 ID

$CODE

提供分配给项目的唯一代码

$PRIORITY

表示项目的优先级别

$STATUS

表示项目状态

$TYPE

表示项目类型

$ESTIMATED_HOURS

提供项目完成的预计工时

$ACTUAL_HOURS

提供项目完成所花费的实际工时

$ESTIMATED_COST

提供项目完成的预计成本

$ACTUAL_COST

提供项目的实际成本

$CREATED_BY

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

$CREATED_TIME

提供项目创建的时间

$SCHEDULED_START_TIME

提供项目的计划开始时间

$SCHEDULED_END_TIME

提供项目的计划结束时间

$ACTUAL_START_TIME

提供项目的实际开始时间

$ACTUAL_END_TIME

提供项目的实际结束时间

$PROJECTED_END_TIME

提供项目的预计结束时间

$OWNER

表示分配给项目的所有者

$DEPARTMENT

表示项目所属的部门

$REQUESTER

表示请求此项目的用户

$SITE

表示项目所属的站点

$TEMPLATE表示项目使用的模板