自定义计划

自定义计划使您能够访问 ServiceDesk Plus 中的任何数据，并安排定期执行自定义操作，例如发送通知、重新打开请求或更新资产详细信息。您还可以将 ServiceDesk Plus 数据与其他第三方application同步，以执行各种操作，例如定期向请求人发送邮件营销活动。

所需角色：SDAdmin

ServiceDesk Plus 中的自定义操作是如何安排的？

通过查询报表以查询形式访问所需数据。
使用任意脚本语言创建脚本并将其保存在您的设备上。或者，您也可以在“自定义计划函数”中使用 DELUGE 创建脚本。
将查询报表中的数据作为参数传递给自定义脚本文件。
安排执行自定义操作的时间。
脚本文件中指定的操作将按固定时间间隔自动执行。

配置自定义计划

转到 管理 > 自动化（旧 UI 中为“常规设置”）> 自定义计划，然后单击新建。

系统将显示“新建自定义计划”表单。请参考以下要点配置自定义计划：

第 1 步：填写自定义计划详细信息

输入计划名称。这是必填字段。
为自定义计划添加说明。
您可以使用“计划名称”字段旁边的复选框启用或禁用该自定义计划。

第 2 步：配置操作

在执行器下拉列表中，您可以通过以下两种方式配置要执行的操作：
- 执行脚本 - 使用任意脚本语言创建脚本。将脚本作为文本文件保存在 [SDP_Home]/integration/custom_scripts/executor_files 文件夹下。在文本字段中指定文件名。application会获取该脚本并执行。示例
- 执行函数 - 在“自定义计划函数”中使用 Deluge 创建并保存您自己的脚本。从下拉列表中选择相关脚本。您也可以直接从下拉列表中创建自定义计划函数。单击此处了解更多。
从“参数”下拉列表中选择要作为参数传递的查询报表。最多可以传递 3 个查询报表作为参数。

查询报表的可见性必须设置为公开。私有报表无法提取到自定义计划中。

第 3 步：配置计划信息

在“开始日期和时间”字段中指定您希望运行自定义计划的频率。
从“重复”下拉列表中选择自定义计划的重复频率。自定义计划将不受工作时间限制而执行。

查询报表如何转换为参数？

假设查询报表 高优先级 SLA 违约请求 返回以下结果：

请求 ID	主题	技术员
47	无法获取邮件	Heather Graham
128	无法连接到 MSSQL 服务器	Shawn Adams

执行脚本时

当计划开始时，查询报表结果将作为单独的 JSON 文件保存在 [SDP_Home]/integration/custom_schedule_reports/ 目录下。结果 JSON 是一个 JSON 对象数组，每一行对应一个 JSON 对象。每个 JSON 对象都以列名作为键，以对应数据作为值，如下所示：

[
    {
        "Request ID":"47",
        "Subject":"Unable to fetch mails",
        "Technician":"Heather Graham"
    },
    {
        "Request ID":"128",
        "Subject":"Cannot connect to MSSQL server",
        "Technician":"Shawn Adams"
    }
]

报表的 JSON 文件路径将作为参数传递给自定义计划执行器。操作执行完成后，该 JSON 文件将被删除。

执行自定义计划函数时

当计划开始时，将生成关联的查询报表。

可以使用 reportObj.get("Report_Name"); 命令将报表提取到自定义计划函数中。要提取报表数据，请使用以下命令：dataObj = reportObj.get("Report_name");

如果报表包含多列，则可以使用循环提取报表列，如下所示：

for each data in dataObj{
column_name = data.get("column_name");
}

然后，您可以指定 API 调用以执行某项操作，例如关闭请求。执行自定义计划时，自定义计划函数会获取报表，并对数据对象中的报表数据执行 API 函数。

查看自定义计划结果

“自定义计划”列表视图将显示如下配置详细信息：

结果列会显示相应操作的最新输出。

已执行操作的详细结果可在“快速操作”下的 系统日志查看器 中查看，也可从“社区”选项卡中查看。