目标 目标
本教程的目的是使用复制与 Jeedom 上的 Synology Security Advisor 相对应的瓷砖的借口来解释如何使用 Synology-API 插件。

重要: 本教程分为两部分
根据您想要做什么和/或了解Synology API的使用以及Synology-API插件如何工作,您有两个选项:
- 要么你读了 第一 部分 这向你解释了,一步一步地以最教学的方式可能你做什么。
- 要么你直接读 第2 部分 谁将为您提供,交钥匙您的设备的瓦片,与已经编程的命令和信息
硬件、软件
- 所有Synology设备都配备了一名安全顾问,他将使用:

- 在 Jeedom 侧,您需要称为 Jeedom-Synology 的链接。 Synology-API 的
![]()
第1部分: 教学美德的完整解释,一步一步
向 Syno 发送订单
查找要发送到路由器的命令
在 图托 通过 Jeedom 从我的网络启用/禁用 WIFI, 它解释了如何找到要发送的命令。
对于本教程,在安全顾问中发送启动分析的命令是:
- API 名称: Core.SecurityScan.Operation
- 要使用的方法: 开始 开始
作为参数:
- &items=ALL
将此命令添加到 Jeedom
要从 Syno 发送命令,您必须在 Synology-API 插件中添加操作命令。
- 启动 Synology-API 并点击 + 启动向导

- 在 使用 API, 选择 Core.SecurityScan.Operation
- 在 要使用的方法, 选择 开始 开始
- 在其他设置中,添加 &项目=全部
- 注意不要忘记&在开始时。
- 点击 Launch Query。
助理回答: 请求发送并成功执行! 这是因为它奏效了,Syno回答说请求被执行了。
就在下面,向导建议保存这个命令,以便能够直接或通过场景重用它。 填写表单并验证订单的添加

从 Syno 中恢复信息
根据先前查询的原则,Syno可以询问信息。 为了尊重 Jeedom 语言,我们将这些查询称为『信息命令』。
延续目前的例子,我们将质疑Syno以检索安全顾问的分析结果。
找到这些信息的操作与之前的解释相同。
以下是要使用的API:
- API : SYNO.Core.SecurityScan.Status
- 要使用的方法: 系统 获取
此请求返回以下回复:

滴答:
- 每个部分中的所有 failSeverity 框
- LastScanTime 的
- sysProgress 的
添加包含所有命令的新 Jeedom 设备后,您可以重命名命令以更好地理解。

请注意,使用『计算』框将API提供的信息转换为日期/时间是有用的。
例如: 日期('d-m-Y H:i',#值 值#)
改进 Widget(v1)
failSeverity 字段以对应于状态的单词格式提供信息: 例如,安全、风险、过时……
有必要创建一个 Jeedom 部件将此状态转换为徽标,这就是我建议创建一个 Widget 的内容:

我选择做三个测试:
- #值 值#== "safe",显示fa-check-circle icon_green
- #值 值#== 显示 fa-exclamation-clamation-circle icon_red 的『风险』
- #值 值#=="outofdate"显示fa-exclamation-clamation-circle icon_orange
- #值 值#显示 fa-exclamation-clamation-circle icon_orange 的『警告』
- #值 值#== »info » 显示 fa-exclamation-clamation-circle icon_blue
因此,此小部件被分配给所有 failSeverity 值
改进 Widget(v2)
我离开了上一段,因为它具有解释小部件的教学美德,但从那时起,我已经将小部件集成到插件中。
只需为每个 info 命令选择 Synologyapi/Safe_Risk 部件即可:

将两个设备合并成一个
Synology-API插件能够合并两个设备,以便在同一个设备上拥有Jeedom命令和信息。
所有你需要做的就是跟随融合向导。

奖金 : 实时更新安全顾问的结果
命令 , 启动分析 要求Synology触发分析。
此命令启动后,必须立即添加一个命令的启动。 刷新 要更新瓷砖,这是通过点击命令末尾右侧的齿轮来完成的。
![]()
然后配置选项卡,添加刷新

这将启动第一个Refresh,其余的,你必须使用一个场景。
情景将是:

这种情况将由以下因素触发:

该场景的内容将是:

结果 , 结果
第2部分: 直接导入设备模型
如果你没有计算机科学家的灵魂,不想了解你在做什么,直接使用第二部分,这给你的设备模型。
因此,您将直接获得将预先编程的命令和信息,即使是小部件也包含在内,从而立即为您提供干净和可用的瓷砖。
导入设备模型
Synology-API插件集成了一个导入功能,您只需点击按钮即可。 导入模型, 仅以相关合成设备的名义:
![]()
对于这个"WiFi"设备,这里是要导入的JSON文件。
- http://jeedom.sigalou-domotique.fr/documentssigalou/Conseiller_de_securite.json
- 或者用zip格式: http://jeedom.sigalou-domotique.fr/documentssigalou/Conseiller_de_securite.zip
一旦导入了 widget,它就会启动并运行。

为了让 widget 更新,您必须添加 第一部分的奖金,遵循此链接 添加瓷砖刷新自动化。
