FR模板调用定时任务接口示例

本文介绍 FR 模板调用定时任务接口的示例。

查看本文档前，请先查看以下两篇文档，了解更多调用接口相关知识：

• 开放平台-FineDataLink接口插件

• 调用FineDataLink接口说明

注：本文方案不适用于移动端。

本章示例：FR 模板中调用 基于任务ID运行任务 接口。

2.1 插件准备

请参见：调用定时任务相关接口说明 第二章内容。

2.2 FDL 工程新建应用

1）进入 FDL 工程，点击「管理系统>开放平台>应用管理>增加」，新建应用，备选认证选择「AkSk认证」。如下图所示：

注：FR、FDL为独立部署时，推荐使用AkSk直接认证、摘要签名认证。

2）点击新建应用右侧的编辑按钮，记住「应用ID」与「密钥」的值。如下图所示：

2.3 为新建应用开放权限

点击「权限管理>API」，本次示例选定API为「基于任务ID运行任务」，为其开放 2.2 节新建应用的权限。如下图所示：

2.4 记录被调用任务ID

在「数据开发」中找到希望被调用的定时任务，复制任务ID，记录下任务ID。如下图所示：

注：若调用的接口是根据实例ID查询实例信息 ，实例信息获取请参见：获取实例信息

2.5 FR 工程设置转发FDL接口配置项

进入 FR 平台，点击「管理系统>系统管理>常规」，设置「转发FDL接口配置」项。如下图所示：

2.6 FR 模板调用接口

FR 中打开 GettingStarted.cpt 模板，在参数面板中添加「点击按钮」，为「点击按钮」添加「点击事件」。如下图所示：

JS 代码：

注：用户根据实际情况修改 workId（本文 2.4 节的任务ID）值。

FR.ExecuteWorkByWorkId(
    {
        workId: "e10f1f1a-d567-4058-98bb-b71204154f8b",
        params: {
            paramName: "paramValue",
        },
        waitForResponse: "true",
        waitTime: 10000,
    },
    function (error, response) {
        if (error) {
            console.error("请求失败：" + error);
        } else {
            console.log("请求成功，响应数据：" + JSON.stringify(response));
        }
    }
);

2.7 效果查看

预览模板，点击按钮。如下图所示：

在 FDL 工程中，点击「任务运维>运行记录」，可看到被调用任务的最新运行记录。如下图所示：

注：本章示例中，FDL 是独立部署；使用的接口是：基于任务ID运行任务

实现效果：FR 模板下拉框中选择地区、省份后，将选择的值传给定时任务，并运行定时任务。

3.1 准备工作

参见本文 2.1、2.2、2.3、2.5 节内容。

3.2 定时任务和 FR 模板准备

1）FDL 定时任务中，使用了两个参数 area 和 province。如下图所示：

为方便调试，可为参数设置默认值。如下图所示：

2）FR 模板中，有两个下拉框控件，名称分别为 area、province 。如下图所示：

3.3 FR 模板调用接口

1）参考本文 2.4 节，记录下任务ID。

2）FR 模板中，参数面板中添加「点击按钮」，为「点击按钮」添加「点击事件」。如下图所示：

JS 代码：

注：getWidgetByName、alert 括号中为 FR 模板中设置的参数名；params 中格式为「定时任务中参数名:FR模板要传递的参数名」；workId 为定时任务 ID，可参考本文 2.4 节获取。

var area=_g().getParameterContainer().getWidgetByName("area").getValue();
alert(area);
var province=_g().getParameterContainer().getWidgetByName("province").getValue();
alert(province);
FR.ExecuteWorkByWorkId(
    {   
        workId: "cc73e0f9-1244-48f6-a4d5-0f06e27e641e",
        params: {
            area:area,
            province:province,
        },
        waitForResponse: "true",
        waitTime: 10000,
    },
    function (error, response) {
        if (error) {
            console.error("请求失败：" + error);
        } else {
            console.log("请求成功，响应数据：" + JSON.stringify(response));
        }
    }
);

3.4 效果查看

1）预览模板，点击按钮。如下图所示：

2）在 FDL 工程中，点击「任务运维>运行记录」，可看到被调用任务的最新运行记录。目标表数据如下图所示：