功能介绍

# Flying 功能介绍

依据Flying使用手册之界面介绍，列举每个功能详细使用说明。

# 1. 功能菜单

工具栏菜单包括：服务、设置、帮助。

服务： 点击后会出现下拉菜单。
- 启动服务： 启动 Flying 服务。
- 停止服务： 停止 Flying 服务。
- 退出： 停止 Flying 运行并退出程序。
设置： 点击后会出现下拉菜单。
- 选择语言： 进行Flying界面语言的选择。可选择的语言类型有简体中文、繁体中文和英语。
- 语言配置： 可设置不同语言显示的文本内容。
帮助： 点击后会出现下拉菜单。

点击[关于]，可查看产品的版本信息内容。点击[注册]，进入注册对话框。
启动、停止服务

Flying菜单栏下方的图标按钮可通过单击来切换服务的启动与停止状态。当图标显示如上图时，单击图标可停止Flying服务。

当图标显示如上图时，单击图标可恢复Flying服务。

# 2. 功能说明

# 2.1. 系统日志

系统日志界面用于显示服务的运行情况以及客户端访问服务端的日志信息。

打开：打开日志文件夹。
复制：复制日志信息。
清空：清空所有的日志信息。
滚动：启用滚动日志查看模式。
查看：查看详细日志信息。

# 2.2. 打印设置

打印设置界面包含基本设置、HTTP打印、MQTT打印、报表设计、邮箱设置功能。

# 2.2.1. 基本设置

报表
- 报表模板路径（为空默认 report目录）：报表模板文件的存放目录，当此项为空时将使用Flying默认的目录。
- 导出文件路径（为空默认 export目录）：报表输出文件的存储目录，如输入pdf，jpg等格式，当此项为空时将使用Flying默认的目录。
- 导出文件格式（为空默认 pdf格式）：报表输出文件的格式类型。分别是：pdf、pg、xls、txt、htm、rtf、csv。
- 打印/输出：报表的输出类型选项，打印表示为启用报表打印，输出表示为输出报表为pdf，不进行打印。
日志
- 日志保存路径（为空默认log目录）：客户端请求报表打印或输出时的日志文件存放目录。
- 启动时清空日志：当Flying启动时，清空日志。
- 退出时清空日志：当Flying退出时，清空日志。
- 运行中，每隔分钟，清空一次：当Flying运行中时，每隔多少分钟（设定值）清空一次日志。
- 随 Windows 启动：设置 Flying 是否跟随Windows 进行自动启动。
令牌

为了防止连接被冒用，Flying提供了Token令牌，如果启用了此功能，每个客户端在访问Flying时需携带Token列表中一个的令牌，并以此作为身份认证。
- 启用Token：是否启用Token令牌功能。
- Token列表（一行一个，类似白名单）：可作为Token令牌使用的列表。每一个令牌都需要单独换行。

# 2.2.2. HTTP打印

HTTP打印服务的相关设置。

选项
- 主机：HTTP / WebSocket 打印服务的地址。在输出打印文件时将以这个地址进行输出。
- 端口：设置打印服务的监听端口，HTTP / WebSocket 使用同一端口进行监听。
- 远程主机：用于Flying服务器远程维护的地址，可通过设置远程地址来实现远端Flying服务的维护。远程主机地址为HTTP服务地址，比如 http://192.168.0.142:8801。
- SSL：启用以允许安全连接：是否启用SSL模式。如启用SSL则需设置SSL选项。
- SSL：SSL监听的端口号信息。
- 压缩：启用以允许压缩数据：压缩数据信息。
- 身份认证：启用用户身份认证：启用用户的身份认证信息。
- URL：WebSocket 服务的地址信息。
- 用户名：WebSocket 用户的身份认证用户名。
- 密码：WebSocket 用户的身份认证密码。
SSL选项
- 证书文件：SSL 证书所在的地址。
- 密钥文件：SSL 私钥文件所在的地址。
- 根证书文件：SSL 的根证书文件所在的地址。
- 密码：SSL证书的密码(如有设置请对照填写)。

# 2.2.3. MQTT打印

MQTT打印服务的相关设置。

启用MQTT：勾选以启用MQTT打印服务。
SSL：设置是否启用 SSL 保护 MQTT 连接。
地址：MQTT服务器连接的地址，默认为本机地址。
端口：MQTT服务器连接的端口号。
用户名：MQTT服务器的登录用户名。
密码：MQTT服务器的登录密码。
本机识别码：MQTT服务器的本机识别码(对应于MQTT的主题)，远程登录时会发送信息至客户端。
本机验证码：MQTT服务器的验证码，远程登录时客户端需提供该信息。
发布主题：设置打印输出时发送消息的订阅主题名称。

# 2.2.4. 报表设计

报表设计界面提供了报表设计的相关设置。

在报表列表中右键鼠标，将会打开报表设置选项。包含新建报表、修改标题、删除、数据构造、下载报表、上传报表、刷新选项。

以上选项的说明如下。

新建报表

在弹出的对话框中输入新建的报表名称，输入完毕后点击[OK]即可。
修改标题

选择需要修改名称的报表选项，右键选择该选项进入修改对话框。输入要修改的名称，输入完毕后点击[OK]即可。
删除

选择需要删除的报表选项，右键选择该选项即可删除该报表。
数据构造

该功能用于生成在设计报表格式时使用的测试数据集，以更好展现报表设计和预览效果。目前SQL最多支持10个数据集的报表。
- [服务器]：连接的TARS服务端地址。
- [端口]：连接的TARS服务端端口号。
- [帐套]：连接的TARS服务端的连接设置名称。
- [SecureKey]：连接TARS服务端设置的安全码。
- [加密]：是否启用加密连接，该选项需与TARS服务端的设置一致。
- [连接]：启用与TARS服务端的连接，连接成功后该按钮变为灰色。
- [SQL]：填写用于构造报表数据集的SQL语句。
- [执行SQL]：向数据库提交填写的SQL用以执行。
- [JSON]：该栏目中显示被转换的数据集结果。
- [应用]：设置应用数据构造的选项。
除此之外，双击需要进行报表设计的模块，可进入报表设计界面。关于报表设计界面的详细说明请参考Flying学习手册报表设计的内容。
下载报表

将远程Flying服务器模板报表格式文件下载至本机模板目录中。

上传报表

将报表格式文件(*.fr3)或模板数据文件(*.data)上传至远程地址的Flying服务器。

刷新

当报表的目录结构发生变化时，使用此选项以刷新显示最新的目录状态。

# 2.2.5. 邮箱设置

显示邮箱设置的相关选项，配置邮箱后，打印输出的文件将会被发送至指定的邮箱。

邮件配置
- [启用EMail]：启用邮件发送服务。
- [邮件服务器]：邮件发送使用的邮件服务器。
- [端口]：邮件服务的端口，通常为25。如使用STARTTLS协议来发送邮件，请将端口设置为587；如使用SSL/TLS协议来发送邮件，请将端口设置为465。
- [发送人]：邮件的发送者邮箱地址。
- [密码]：邮件的发送者邮箱密码。
- [收件人]：邮件的接收者邮箱地址。

# 2.2.6. 打印记录

在当前页面中，选择对应的日期，点击[查询]可查询打印服务器的打印/输出记录。左侧的列表显示全部的打印记录，右侧显示打印输出的文档的预览界面或者对应的日志信息。

# 2.2.7. 小工具

本程序提供了两种实用工具，可供调试测试使用。

URL编码/解码

一般来说，URL只能使用英文字母、阿拉伯数字和某些标点符号，不能使用其他文字和符号。比如，世界上有英文字母的网址"http://www.abc.com"，但是没有希腊字母的网址"http://www.aβγ.com"（读作阿尔法-贝塔-伽玛.com）。这是因为网络标准RFC 1738 (opens new window)做了硬性规定，只有字母和数字[0-9a-zA-Z]、一些特殊符号$-_.+!*'(),、以及某些保留字，才可以不经过编码直接用于URL，这意味着，如果URL中有汉字或者其他不在范围内的字符要置入URL，就必须经过编码后才能使用。

上图中上侧的编辑框由于填写或显示原始的字符信息，下侧的编辑库用于显示或输入经过URL编码的字符信息。图中的按钮说明如下。
[UrlEncode编码↓↓]：将原始的字符串进行URL编码。
[UrlDecode解码↑↑]：将经过编码的字符串进行解码操作，恢复原始的字符串信息。
Base64图片转换

Base64是一种用64个字符来表示任意二进制数据的方法，它可以将图片、视频、音频等二进制数据转换成文本编辑器可查看的字符串，以便于使用网络进行传输。想了解Base64请点这里 (opens new window)。

图中的按钮说明如下。
- [选择一张图片(png,jpg,bmp,ico)]：点击此按钮打开选择图片对话框，选择图片后，在编辑框中显示选择的图片经过Base64编码后的字符串信息。
- [Base64转换为图片]：将经过编码的Base64字符串放置于编辑框中，点击此按钮进行解码并显示图片。
- [复制]：将获取到的Base64字符串复制至系统剪切板。
- [粘贴]：将截切版中的字符粘贴至编辑框中。