天气预报查询插件
1. 简介
1.1 插件简介
天气预报查询插件支持定时查询当日、近 7 日天气预报,并同步至简道云表单中。
1.2 应用场景
该插件常用于工程施工等需关注天气预报的行业,根据天气数据进行关联的业务判断和预警、仪表盘天气预报展示等。
1.3 预期效果
开启天气预报查询插件,在「天气预报查询」表单中设置智能助手定时任务后,自动同步天气预报数据到表单。效果如下所示:
1.4 使用说明
1)该插件需要具有 API 权限才能使用。
2)天气预报查询为付费插件,请联系我们进行增购。插件购买流程如下所示:
注:插件购买期限需要和简道云版本期限保持一致。
2. 插件安装及配置
2.1 安装插件
1)直接安装
2)插件市场处安装
在简道云「插件市场」处,安装「数据库同步至表单」插件。插件市场处安装方法可参见文档:插件市场中【2.3 插件安装】。
2.2 配置插件
安装后,在「插件管理」处,点击插件右侧的「设置」按钮,将「简道云API Key」信息配置进去,配置完成后点击确定。
简道云的API Key 可在「密钥管理 >> API Key」处获取。
2.3 启用插件
在插件管理中,打开「天气预报查询」插件右侧开关,启用插件。
3. 表单搭建
插件使用体验可先安装:天气预报查询模板表单。本文将按照示例表单进行讲解。
3.1 创建表单
新建「天气预报」表单,字段设置如下所示:
字段名称 | 字段类型 | 字段说明 |
城市 | 单行文本 | —— |
日期 | 日期时间 | 在「字段属性 >> 类型」处设置为「年-月-日」 |
今日天气 | 单行文本 | —— |
今日温度 | ||
今日湿度 | ||
今日降水量 | ||
今日气压 | ||
今日风向 | ||
今日风力 | ||
今日空气质量 | ||
今日空气指数 | ||
预警类型 | ||
预警级别 | ||
预警描述 | ||
近 7 日天气预报.日期 | 日期时间 | 在「字段属性 >> 类型」处设置为「年-月-日」 |
近7日天气预报.最低温度 | 单行文本 | —— |
近7日天气预报.最高温度 | ||
近7日天气预报.白天天气 | ||
近7日天气预报.白天风向 | ||
近7日天气预报.白天风力 | ||
近7日天气预报.夜间天气 | ||
近7日天气预报.夜间风向 | ||
近7日天气预报.夜间风力 |
注:根据使用需求,建立相应的字段即可,上标中所建立的字段是能查询到的所有天气预报信息的字段。
3.2 设置字段别名
进入「扩展功能 >> 数据推送」中,点击设置字段别名,依次将字段别名设置为对应字段的名称,设置完成后,点击「保存」按钮。设置如下所示:
字段名称 | 字段别名 |
城市 | city |
日期 | date |
今日天气 | weather |
今日温度 | degree |
今日湿度 | humidity |
今日降水量 | precipitation |
今日气压 | pressure |
今日风向 | wind_direction |
今日风力 | wind_power |
今日空气质量 | aqi |
今日空气指数 | aqi_name |
天气预警 | alarm |
预警类型 | type_name |
预警级别 | level_name |
预警描述 | detail |
近7日天气预报 | day_weathers |
近 7 日天气预报.日期 | time |
近7日天气预报.最低温度 | min_degree |
近7日天气预报.最高温度 | max_degree |
近7日天气预报.白天天气 | day_weather |
近7日天气预报.白天风向 | day_wind_direction |
近7日天气预报.白天风力 | day_wind_power |
近7日天气预报.夜间天气 | night_weather |
近7日天气预报.夜间风向 | night_wind_direction |
近7日天气预报.夜间风力 | night_wind_power |
注:
1)根据使用需求,设置相应的字段别名即可,本篇文档中所设置的字段是能查询到的所有天气预报信息的字段。
2)需要查询的天气信息,必须设置字段别名,且别名必须设置为上表中的别名。
4. 智能助手配置
4.1 添加智能助手
设计完表单后,在「扩展功能」处添加「智能助手」,并修改智能助手名称为「天气预报查询」。
4.2 设置触发动作
1)由于需要每日触发智能助手同步查询天气预报,故触发动作设置如下:
- 触发动作:选择选择「定时重复」;
- 触发时间:如设置为 2023-09-18 06:00:00 开始同步;
- 重复类型:设置为「每天」;
- 重复触发结束时间:如设置为 2030-09-30 23:59:59 结束同步。
4.3 设置执行动作
由于要执行「天气预报查询」插件,故执行动作设置如下:
- 执行动作:选择「天气预报查询」插件;
- 执行表单:选择「天气预报查询」表单;
- 应用 ID:设置为「字段值」,并在下拉框中选择应用 ID;
- 表单 ID:设置为「字段值」,并在下拉框中选择表单 ID;
- 城市:设置为「自定义」,如自定义城市为无锡。
注:自定义城市时,可以填写某某市,也可以填写某某区。
4.4 效果演示
效果参见本文【1.3 预期效果】。
5. 当日天气定时更新说明
借助流程表单的插件节点,配合流程节点的自动提交功能,实现当日天气定时更新。
- 流程节点设置延时自动提交,根据企业自身需求设置延时时间,可以半个小时、1 个小时等,延时时间至少 10 分钟以上;
- 每个流程节点延时自动提交之后都设置插件节点,然后配置插件参数,流程到达该插件节点后,插件会去自动检测该城市当日是否有数据,没有数据就新增数据,有数据更新该数据的天气预报信息。
注:因兼顾流程属性,因此定时任务创建的数据,流程表单与普通表单区别如下所示:
1)如果是流程表单,会同时触发流程,这样就可以当日按照设置的流程规则定时触发更新当日的天气预报;
2)如果是普通表单,则无流程,且当日仅新增一条数据,数据再当日不会再更新。
6. 联系方式
该插件为官方合作的服务商开发,若您在使用过程中有任何疑问,可通过以下方式咨询:
- 公司:成都轻如燕企业服务有限公司
- 联系人:赵鹏
- 联系电话:18583980516(微信同号)