项目自定义触发器

项目自定义触发器

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

 

配置一个新的动作

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

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

  • 单击新建动作。

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



 

 

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


 

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


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


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

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

  • 支持的返回动作： 更新项目和添加注释

  • 取消选择停止处理后续动作复选框，即使在项目上应用了动作规则，也会执行后续动作。

 

 

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

 

 

脚本参数

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


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

 

PARAMETER

描述

$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表示项目使用的模板