请上传宽度大于 1200px,高度大于 164px 的封面图片
    调整图片尺寸与位置
    滚轮可以放大缩小图片尺寸,按住图片拖动可调整位置,多余的会自动被裁剪掉
取消
知识库(uid:567266)
职业资格认证:尚未取得认证
【已下架插件文档】移动端横向布局插件
该插件目前已下架帆软市场,本文档仅提供给历史使用了该插件的客户,帆软目前不再提供该插件的任何获取渠道。   1. 概述 1.1 版本 报表服务器版本 JAR 包版本 App 版本 HTML5 移动端展现插件 移动端横向布局插件 功能变动 10.0 2020-07-08 V10.4.80 V10.4.80 V10.4.80 - V10.4.975 优化拖拽逻辑,现在跟决策报表自适应布局拖拽逻辑保持一致 1.2 应用场景 仅决策报表支持此功能。 由于移动端「保留布局」时,组件的大小设置和调整十分复杂,且不支持很多新功能,例如数据点提示、冻结、展开收起等。因此用户在移动端预览决策报表时,常常使用「移动端重布局」,使得组件排列更加美观。 但是移动端模板中经常存在「组件并列」的情况,重布局下必须拖入「绝对画布块」方可实现该效果。绝对画布块又存在背景不统一、间距调整复杂的问题。 那么如何在「移动端重布局」下,方便快捷的制作「组件并列」的移动端模板呢?如下图所示: 1.3 功能描述 帆软提供「移动端横向布局插件」,快速拖拽组件,实现「移动端重布局」模板中,可「自动」、「等距」、「等长」、「并列」组件。 2. 插件介绍 2.2 应用范围 JAR 包在 「2020-07-08」 及之后,且 App/HTML5 插件版本在 「V10.4.80」 及之后,可使用横向布局容器插件。 报表类型 预览方式 是否支持横向布局容器 支持添加的组件 普通报表 - 不支持 - 决策报表 PC端预览 移动端预览 支持 可将横向布局容器添加在「body」、「绝对画布块」、「Tab 块」中 支持 可在横向布局容器中添加「报表块」、「图表块」、「控件组件」 2.3 界面添加横向布局容器 2.3.1 添加方法 插件安装完成后,在决策报表中新增一个空白块种类:「横向布局容器」。 选中横向布局容器,可拖拽插入 「body」、「绝对画布块」、「Tab 块」中。如下图所示: 2.3.2 容器属性 1)用户可自定义横向布局容器容器的名称、样式和组件大小。具体属性设置如下图所示: 注:body 自适应布局下:      如果横向布局容器拖入后,占满一行,容器宽度=画布宽度,宽度无法调整,调整时会进行提示      如果横向布局容器和其他组件并列,那么容器宽度可以调整,最大为画布宽度 2)用户可设置横向布局容器移动端展示时是否使用导航、容器内边距和容器内组件间隔。如下图所示: 注1:横向布局容器不支持「选中、全屏」,容器内组件支持。横屏时,整个容器作为整体,一屏显示。 注2:若在 body 的移动端设置中「冻结」了横向布局容器,则无法「使用导航」。         若横向布局容器使用了导航,则body移动端冻结设置中无该容器。         如下图所示: 2.4 横向布局容器添加组件 2.4.1 添加方法 点击横向布局容器的编辑按钮,可拖拽「报表块」、「图表块」、「控件组件」进入横向布局容器中。 组件「均分」横向布局容器的宽度,高度与横向布局容器的「高度一致」。 如下图所示: 2.4.2 组件属性 组件类型 属性 报表块/图表块 导航功能请参见:组件自动定位 自适应属性请参见:移动端自适应 全屏设置请参见: 组件全屏开关控制 组件选中设置请参见: 组件激活  「手机显示限制高度」设置不生效 控件 导航功能请参见:组件自动定位 自适应属性请参见:控件默认高度 注:若横向布局容器未勾选导航功能,容器内组件勾选了导航功能,该设置不生效。    
【已下架插件文档】[通用]手写签名插件
该插件目前已下架帆软市场,本文档仅提供给历史使用了该插件的客户,帆软目前不再提供该插件的任何获取渠道。   1. 概述 1.1 版本 报表服务器版本 App 版本 HTML5 移动端展现插件版本 手写签名插件版本 功能变动 11.0 V11.0 V11.0 V11.0 - 1.2 应用场景 库存巡检、银行、保险公司等场景下会有网签需求,需要手写签名。 手写签名插件支持手写签名,并支持将生成的 PNG 格式签名图片提交至数据库或上传到指定的磁盘路径下。 注1:该插件只支持决策报表。 注2:在模板中使用手写签名插件时,必须确保用户已登录FineReport数据决策系统,否则将出现报错。 2. 插件介绍 2.2 功能入口 插件安装后,决策报表的控件管理面板新增「手写签名」插件,可拖入 body 中使用,如下图所示: 2.3 功能简介 2.3.1 属性 选中右侧的「signature0」,点击「属性」,如下图所示: 各设置项及说明如下表所示: 设置项 说明 基本 控件名 支持设置控件名 手动输入,通常与参数结合使用,如通过控件名获取控件后将控件值传递给对应参数,默认为「signature+数字」 可用 支持设置控件是否可用 勾选后,控件可编辑;不勾选,控件灰化不可编辑;默认勾选 可见 支持设置控件是否可见 勾选后,填报时页面显示控件;不勾选,填报时页面不显示控件;默认勾选 校验 允许为空 支持设置控件是否允许为空 勾选后,允许控件为空值;不勾选,控件为空值时填报校验和提交时会提示「不可为空」;默认勾选 坐标 · 尺寸 控件大小 支持设置控件大小 可通过设置「宽度」、「高度」调整,也可通过拖拽控件调整 2.3.2 移动端 选中右侧的「signature0」,点击「移动端」,移动端面板的设置项与 body 是否勾选「手机重布局」有关,如下图所示: 各设置项及说明如下表所示:   设置项 说明 样式模板 支持设置移动端样式模板,详情参见:决策报表控件移动端默认样式模板 导航 使用导航 仅重布局下支持设置是否使用导航,详情参见:组件导航快速定位 3. 示例一:提交入库 3.1 新建模板 1)点击菜单栏「文件>新建其他模板>新建决策报表」,点击「新建空白模板」,点击「确定」,如下图所示: 2)将上方的按钮控件和手写签名控件拖拽到 body 中,如下图所示: 3)选中右侧的「button0」,点击「属性」,按钮名字设置为「提交」,如下图所示: 3.2 新建表 在 FRDemo 中新建表「手写签名」,数据类型设置为「BLOB」类型,如下图所示: 3.3 设置提交入库 1)选中右侧的「button0」,点击「事件」,点击「+」按钮添加「点击」事件。 2)选择「提交入库」,数据库选择「FRDemo」,表选择「手写签名」,点击「智能添加字段」。 3)添加「手写签名」列,值选择公式,为 $signature0 ,$ 表示获取值,signature0 为手写签名控件名,如下图所示: 注:添加值的方式,只能通过公式来绑定控件,不能通过下图控件的方式,控件方式识别不出手写签名插件。 3.4 设置回调函数 使用按钮设置提交入库时,默认没有成功和失败提示。故需设置回调函数,提示用户填报成功与否,如下图所示: JavaScript 代码如下: 注:success 只表示后台程序执行没有异常,最终入库结果会受到设置的影响,可能和预期的不一致。   if (fr_submitinfo.success) { FR.Msg.toast('提交成功');} else { FR.Msg.toast('提交失败,错误信息为:' + fr_submitinfo.failinfo);} 3.5 效果预览 移动端预览,以 App 为例,点击「添加签名」,在编辑区手写签名后,点击「确定」,再点击「提交」,生成的签名图片即可入库,如下图所示: 签名图片以 base64 编码的形式保存到数据库表字段下,如下图所示: 4. 示例二:文件上传 注:上传下载文件插件的使用,详情参见:上传下载文件插件 。 4.1 新建模板 同 3.1 节。 4.2 设置文件上传 1)选中右侧的「button0」,点击「事件」,点击「+」按钮添加「点击」事件。 2)选择「文件上传」,选择类型为「上传至服务器」。 3)磁盘路径、文件、文件名请参照下图的写法,如下图所示: 注1:磁盘路径为文件保存位置,请勿丢弃双引号。 注2:文件通过公式绑定手写签名控件,$ 表示获取值,signature0 为手写签名控件名。 注3:文件名支持自定义或者使用公式生成文件名,支持为空。文件名自定义时,请勿丢弃双引号。 4.3 效果预览 移动端预览,以 App 为例,点击「添加签名」,在编辑区手写签名后,点击「确定」,再点击「提交」,生成的签名图片即可上传至设置的磁盘路径,如下图所示: 签名图片上传至设置的磁盘路径下,如下图所示:  
【已下架插件文档】视频播放控件插件
该插件目前已下架帆软市场,本文档仅提供给历史使用了该插件的客户,帆软目前不再提供该插件的任何获取渠道。   1. 概述 1.1 版本 报表服务器版本 插件版本 App  HTML5移动端展现 11.0 11.0.37 10.4.69 V10.4.69 1.2 应用场景 在现在越来越多的大屏展示需求背景下,表格数据、图表混合着视频一同展现在同一个屏幕下的需求比较常见。 用户可安装「视频播放控件插件」,实现模板中播放视频的效果。 1.3 功能描述 在决策报表中可以添加视频控件用于播放在线视频或本地视频。 在移动端模板中不支持全屏、不支持组件选中、不支持绝对画布块;支持设置导航书签、支持冻结在移动端模板顶部。 注:该插件使用的是 HTML 的视频播放技术,因此仅支持谷歌浏览器、火狐浏览器、Safari 浏览器以及 IE11+ 的浏览器,如果需要支持 IE11 以下的的浏览器,可以使用 Flash 播放技术,自行使用源码修改。 MP4 视频编码只支持 AVC(H264) ,如果无法播放请您检查编码后转码。 2. 示例 2.1 安装插件 点击下载插件:视频播放控件插件 设计器插件安装方法参照:设计器插件管理 服务器安装插件方法参照:服务器插件管理 2.2 添加控件 在 FineReport 设计器中新建决策报表,在控件处点击「下拉」箭头,将「Video」控件拖入到决策报表中即可使用,如下图所示: 2.3 设置控件 2.3.1 准备视频 示例视频地址为「本地资源」,点击下载示例视频:测试.mp4 将压缩包解压后,将视频放在%FR_HOME%\webapps\webroot文件夹下,如下图所示: 注:本地资源仅支持 %FR_HOME%\webapps\webroot 目录以及其子目录(但不支持 WEB-INF 目录)下的视频资源。 2.3.2 添加视频地址 1)本地资源:仅支持 %FR_HOME%\webapps\webroot 目录以及其子目录(但不支持 WEB-INF 目录)下的视频资源。 支持的视频格式如下: 移动端Android系统:mp4、mkv 移动端 iOS 系统:mp4 PC 端支持视频格式:mp4 注:MP4 视频编码只支持 AVC(H264) ,如果无法播放请您检查编码后转码。 2)远程资源:仅支持 .mp4 格式的视频资源,直接在地址框中输入地址即可。 注: 如果输入资源地址,或使用地址拼接URL参数,不要点击右边的 F(x) 按钮。 如果需要使用 IF 等函数判断最终资源地址,可点击右边的 F(x) 按钮,输入公式。 2.3.3 设置属性 各设置项的属性介绍如下表所示: 设置项 说明 可见 勾选:模板预览时该控件可见 未勾选:模板预览时不可见 可用 未勾选该按钮,移动端使用该插件播放视频时无影响 自动播放   勾选:可自动播放视频,若添加多个控件视频,则预览时可同时自动播放 未勾选:不自动播放,点击播放按钮后,从默认状态到播放状态 注1:PC 端在Chrome浏览器(以及所有以Chromium为内核的浏览器)中,不允许自动播放音频和视频。此时勾选「静音」才能自动播放视频 注2:App 端单个视频可自动播放,多个视频时仅随机播放某一个或几个视频 注3:不支持 HTML5 端自动播放 显示控制器 勾选: 移动端:视频播放时可暂停视频、快进视频、调节音量 PC 端:视频播放时可暂停视频、快进视频、调节音量、全屏显示、下载视频 未勾选:视频播放时不能对视频进行操作 循环播放 勾选:视频播放完毕自动进入下一轮播放 未勾选:视频播放完毕后即停止 静音 勾选:喇叭图标关闭,即使播放也默认静音 未勾选:声音大小跟随手机系统声音,大小可调节 预加载 勾选:暂停播放后,断开网络,可继续播放 未勾选:暂停播放,断开网络,点击播放显示网络错误 2.4 效果预览 2.4.1 PC 端 PC 端效果如下图所示: 2.4.2 移动端 注:HTML5 端不支持「自动播放」。 以 App 效果为例,如下图所示:  
【已下架插件文档】[旧]决策报表导出插件
该插件目前已下架帆软市场,本文档仅提供给历史使用了该插件的客户,帆软目前不再提供该插件的任何获取渠道。   1. 概述 1.1 版本 报表服务器版本 决策报表导出插件版本 11.0 V3.8.4 1.2 应用场景 FineReport 11.0 中支持将决策报表「转换至旧版」,与本身的决策报表主要的区别在于 自适应属性 的不同。 决策报表导出 文档中主要介绍了 11.0 默认的决策报表的导出方式,实际上「旧决策报表」的导出接口、使用方式等均与其相同,但是旧决策报表必须下载安装「决策报表导出插件」后,才能实现导出。 1.3 功能简介 「决策报表导出插件」支持将决策报表整体导出为 Excel、PDF 、Word 和图片(png、jpg、gif、bmp)格式。 1)普通决策报表导出接口为 &op=export&format=xxx,xxx 代表导出文件格式对应的参数,xxx 值可为:excel、word、pdf、image;其中,xxx 值为 image 时,可使用&op=export&format=image&extype=aa设置文件格式,aa 值可为 png、jpg、gif、bmp。 2)带参决策报表需在导出后缀中加上 sessionID,即 &op=export&format=xxx&sessionID=***,具体示例可参见:带参决策报表导出 3)导出时可修改文件名,在后缀末尾再添加参数 &__filename__=文件名 注:如需导出决策报表为 PPT 格式,请参见 报表多类型导出插件 。 1.4 注意事项 不支持导出控件。 不支持导出 body 背景;不支持导出组件在「样式」处设置的背景和边框。 不支持决策报表存在重叠的图表块或报表块。 Tab 组件只导出第一个 Tab 页;翻页只导出当前页。 不可与同类型插件同时启用,如:决策报表导出 Plus 插件、决策报表多标签页导出插件。 不支持移动端。 仅 PDF 支持导出水印。 3. 操作说明 因为旧决策报表导出的设置方式均和 FineReport 11.0 本身的 决策报表导出 方式相同,只是需要安装插件,所以本文不再展示示例,仅说明不同之处。 3.1 转换至旧版 点击决策报表顶部工具栏处「转换至旧版」,可将决策报表转换为旧版决策报表。如下图所示: 3.2 JS 实现点击按钮导出带参决策报表   旧决策报表使用 JS 实现点击按钮导出带参决策报表时,代码有些许不同,其余设置均相同。JavaScript 代码需修改为: var REPORT_URL = '${servletURL}?viewlet=doc/frm/决策报表入门.frm&op=export&format=excel&sessionID=' + aaa;window.location = encodeURI(REPORT_URL);  
【已下架插件文档】组件加载动画插件
该插件目前已下架帆软市场,本文档仅提供给历史使用了该插件的客户,帆软目前不再提供该插件的任何获取渠道。   1. 概述 1.1 版本 报表服务器版本 插件版本 11.0 V1.3 1.2 应用场景 这是一款可以给决策报表组件添加加载动画的插件,类似于 PPT 中的进场动画,目前只支持决策报表中的图表块,报表块这两个组件。 1.3 功能介绍 目前插件只支持2个选项的设置,分别为:动画加载效果、动画效果持续时间。 1)动画加载效果 插件内置了16种组件加载动画,包括:清除动效(无特效)、滑动、弹跳、拉伸、脉动、摆动、轻弹、缩放。动画效果如下图所示: 2)动画效果持续时间 动画效果只能通过下拉框选择,用户无法自定义,持续时间选项有:1s、2s、3s、4s、6s、8s、10s。默认为 3s。对比效果如下图所示: 注1:动画特效是通过 CSS3 实现的,因而不支持 IE8 及以下版本的浏览器。 注2:插件是在组件内容请求结束后执行动画,因此不会阻塞加载或者导致加载慢。 2. 示例 2.1 安装插件 2.2 设置加载动画 1)点击下载模板:HOMEpage.frm 后在设计器中打开。 2)选中决策报表地图组件 chart0,菜单栏点击模板>加载动效,打开组件动效设置对话框。 3)在打开的组件动效设置对话框中进行如下图所示的设置: 4)其他组件同理设置,只是选择不同的动画效果。 2.3 效果预览 PC端预览效果如下图所示: 注:不支持移动端。 3. 模板下载 点击下载模板:HOMEpage.rar (36.97 K) 4. 其他应用 1)动画与刷新插件组合使用 可以将加载动画和 决策报表内报表块刷新插件 组合使用,实现决策报表内数据实时动态刷新及动画载入效果。 注1:动画默认是闭环的,也就是新的数据从左到右出现,老的数据从左到右消失,从上到下同理。 注2:刷新插件需要更新至1.2.6或更高版本。 下图示例组件中设置了刷新公式=now(),隔几秒刷新一次。 2)实现图片动画特效 通过 WebImage 嵌入 gif 或者图片后,指定运动方向,可以带来更多的动画效果。如下图所示:  
【已下架插件文档】数字时钟控件插件
该插件目前已下架帆软市场,本文档仅提供给历史使用了该插件的客户,帆软目前不再提供该插件的任何获取渠道。   1. 概述 1.1 版本 报表服务器版本  插件版本  11.0 V1.2.0 注:该插件只有决策报表可以使用,不支持移动端使用。 1.3 应用场景 该插件能够实时展示当前时间。效果如下图所示: 注1:数字时钟控件展示的是当前设备/浏览器的时间。 注2:也可以通过 JS 来实现此功能,详情参见文档:JS显示即时或实时时间,但这样频繁地刷新会对系统性能有潜在影响。 2. 插件设置 2.1 操作方法 安装插件后,在决策报表的控件管理面板中,将数字时钟这个控件拖入决策报表设计主体中。 2.2 属性设置 选中该控件后,可以在右下方属性面板对控件的内容和属性进行设置,控件可以设置的属性项有: 下面对每个属性作详细介绍: 1)样式:设置数字时钟的显示样式,一共有三种。 样式一:日期数字间采用中文年月日连接,日期/时间/星期横向并排显示,中间以空格分隔开。 样式二:日期数字间采用符号“—“连接,日期/时间/星期垂直并排显示。 样式三:日期数字间采用符号“/”连接,日期/时间/星期混排显示。 注:控件能实现年月日、时分秒、星期的动态展示,暂不支持显示农历、节假日等。 2)背景:设置数字时钟背景色。 3)字体设置:包括字体、字样、颜色、倾斜、加粗、对齐等。根据需求自定义设置就好。  
【已下架插件文档】滚动消息控件插件
该插件目前已下架帆软市场,本文档仅提供给历史使用了该插件的客户,帆软目前不再提供该插件的任何获取渠道。   1. 概述 1.1 版本 报表服务器版本 插件版本 App 版本 HTML5 移动端展现插件版本 11.0 V1.5.3 10.4.97 10.4.97 1.2 应用场景 在大屏宣传展示和一般的会议演示汇报过程中,滚动消息一直是比较普遍的需求,但是用户自己通过代码和现有的控件实现起来还是比较麻烦的。那么通过安装滚动消息控件插件即可便捷地实现滚动字幕的效果。 预期效果如下图所示: 1.3 功能简介   插件要求 JDK 版本为 JDK 1.8 且小版本需在 JDK8u102 以上。 该插件仅支持决策报表。 PC 端鼠标悬停在滚动字幕上,该字幕会暂停,移动端不支持暂停。 2. 插件介绍 2.1 插件安装 点击下载插件:滚动消息控件 设计器插件安装方法参照 设计器插件管理 服务器安装插件方法参照 服务器插件管理 2.2 操作方法 安装插件后,在决策报表的控件管理面板中,将「滚动字幕」这个控件拖入决策报表设计主体中。 2.3 属性设置 控件属性设置面板如下图所示,可以在此添加字幕和调整样式。 2.3.1 样式 点击样式右侧设置按钮,弹出样式设置框。可以设置滚动字幕的样式,包括渲染风格、边框属性、主体背景等。如下图所示: 注:渲染风格移动端只支持普通。 2.3.2 控件值 点击控件值右侧设置按钮,弹出富文本编辑器。用于编写滚动字幕的内容,直接输入即可。如下图所示: 控件值还支持动态获取数据,如下图所示: 图中公式为:sum(report0~B1)  ,即引用报表块中单元格数据并求和。 2.3.3 滚动方向 一共有四个方向,默认「向左」。如下图所示: 2.3.4 滚动速度和滚动间隔 字幕的滚动速度和不同消息之间滚动的间隔距离,均可自定义。 滚动间隔默认为 0,此时消息滚动完毕后,再重复滚动。效果如下图所示: 若设置滚动间隔为 50 像素,那么文本间隔 50 像素重复滚动。效果如下图所示: 3. 示例 3.1 准备模板 点击下载模板:零售集团实时监控-phone.frm 后在设计器中打开。 3.2 添加控件 将滚动消息控件插入到报表块 report1 和图表块 chart0 之间,如下图所示: 3.3 添加字幕 点击控件值右侧设置按钮,在富文本编辑器中输入字幕:最新动态:双十一预售活动盛大开启,预付定金立享大额优惠!,字体设置为微软雅黑,字号为12,如下图所示: 3.4 设置控件样式 点击样式设置按钮,将控件主体背景填充设置为「颜色>天蓝色」。如下图所示: 3.5 修改组件显示顺序 原模板是设置了组件顺序的,也就是移动端预览时只按照这个顺序显示组件,所以要把滚动消息控件调到第二位,如下图所示: 3.6 效果预览 保存报表,点击「移动端预览」,字幕效果如下图所示: 4. 模板下载 点击下载模板:移动端滚动字幕-phone.rar (28.52 K)  
【已下架插件文档】决策报表内报表块刷新插件
该插件目前已下架帆软市场,本文档仅提供给历史使用了该插件的客户,帆软目前不再提供该插件的任何获取渠道。   1. 概述 1.1 版本 设计器版本 插件版本 11.0 V1.5.4 注1:不支持移动端。 注2:使用 跑马灯接口 后,不支持通过「决策报表内报表块刷新插件」实现刷新。 1.2 功能介绍 官方提供了报表块刷新插件,可以直接通过插件进行刷新设置。 2. 插件介绍 2.2 定期刷新 选择报表块,点击属性面板的刷新编辑按钮,弹出报表块刷新设置界面,选择定期刷新并设置好刷新间隔时间即可,如下图所示: 2.3 监控刷新 选择监控刷新后,每隔一段时间后,就会查看监控的内容,如果有变化就刷新报表块。可以监控报表块单元格;也可以通过自定义类监控其他内容。 刷新间隔:刷新监控的时间间隔 自定义类:可通过 编译Java 实现 ExecuteCondition 接口来返回是否需要刷新报表块。返回 true 则刷新;返回 false 则不刷新。ExecuteCondition 接口如何实现可以查看 定时任务执行条件之自定义类判断 中自定义类判断的示例。勾选后需要配置自定义类,将编译好后的 class 类放置在工程%FR_HOME%\webapps\webroot\WEB-INF\classes目录合适的位置后,此处按提示格式配置路径名称即可。 比如通过自定义实现监控星期,每周星期二刷新。 监控区域:监控的报表块单元格,可以是单个单元格如 A1,也可以是多个单元格如 C2:C12 如下实现监控报表块 A1 单元格,监控频率为 3 秒。  
【已下架插件文档】决策报表动态背景插件
该插件目前已下架帆软市场,本文档仅提供给历史使用了该插件的客户,帆软目前不再提供该插件的任何获取渠道。   1. 概述 1.1 版本 报表服务器版本 插件版本 11.0 V4.0.2 1.2 应用场景 本插件添加了十种动态背景,可供用户设计决策报表时选择。 此插件不支持IE浏览器,强烈建议使用Firefox,Chrome,Edge,Safari等最新版本浏览器。 1.3 功能介绍 只支持决策报表,且只能在 body 组件的样式中设置动态背景,九种动态背景的效果如下: 1)动态数字波浪背景 2)动态漂浮方块背景 3)动态代码雨背景 4)动态圆形气泡背景 5)动态点线相交背景 6)动态棱形背景 7)动态四叶草背景 8)动态粒子背景 9)动态星空背景 10)动态加载图片 动态加载报表服务器上的图片和网络图片 2. 插件介绍 2.2 操作方法 1)安装好插件后,可点击 body 组件的「属性>样式」,进入设置界面,如下图所示: 2)样式设置界面的「填充」设置项,可下拉选择插件的动态背景,如下图所示: 3)<动态加载图片>设置 (1)选择<动态加载图片>,会出现下图所示界面 (2)点击上一步骤中的<图片设置>按钮,会显示设置界面,如下图所示 图片布局:包括默认,平铺,拉伸和适应 加载方式:按路径加载为加载报表服务器上的图片;按链接加载为加载网络图片 图片路径:加载图片的路径,加载方式为按路径加载时,填写报表服务器上的图片路径;加载方式为按链接加载时,填写网络图片链接 缓存图片:是否缓存图片,加载方式为按路径加载时生效   注:目前只有 body 组件支持背景主题设置,其他图表或 Tab 块虽然也有样式设置,但设置后无效。  
【已下架插件文档】ckplayer视频播放控件
该插件目前已下架帆软市场,本文档仅提供给历史使用了该插件的客户,帆软目前不再提供该插件的任何获取渠道。   1. 概述 1.1 版本 报表服务器版本 插件版本 11.0 V1.7 1.2 应用场景 适用于一些公司大屏需要以视频形式展示公司文化或会议观点的场合,视频更具传染力,更便于表达,该插件便提供了视频播放的功能,大概效果如下所示: 1.3 功能介绍 该插件集成了流行的播放器 ckplayer 的解决方案,解决了众多平台中的播放问题。支持更多的浏览器(比如在低版本 IE 下自动 fallback 到 flash )。 仅支持 MP4 视频格式的控制,建议用户使用 MP4 视频文件,其他格式的视频可以转成 MP4 格式。 支持添加多个视频。支持添加、修改和删除,并且可以通过上移下移调整视频播放的顺序。 不支持移动端。 2. 插件介绍 2.2 操作步骤 下载安装好插件后可以在控件栏看到ckplayer插件,将其拖入决策报表即可使用。 2.3 属性介绍 1)属性 各设置项的属性介绍如下表所示: 设置项 说明 可见 勾选:模板预览时该控件可见 未勾选:模板预览时不可见 可用 未勾选时,该控件会被蒙上一层灰色蒙版,但不影响视频点击与播放 视频地址 支持添加本地资源和远程资源,可同时添加多个视频,只支持.mp4格式 注:本地资源仅支持 %FR_HOME%\webapps\webroot 目录以及其子目录(但不支持 WEB-INF 目录)下的视频资源 自动播放 勾选:可自动播放视频,多个视频时可同时播放 注:在Chrome浏览器(以及所有以Chromium为内核的浏览器)中,不允许自动播放音频和视频。此时勾选「静音」才能自动播放视频 未勾选:不自动播放,点击播放按钮后,从默认状态到播放状态 显示控制器 勾选:视频播放时可暂停视频、快进视频、调节音量、全屏显示、下载视频 未勾选:不能对视频进行操作 循环播放 添加一个视频时: 勾选与未勾选视频播放完毕都会自动进入下一轮播放 添加多个视频时: 勾选:视频只循环播放第一个视频 未勾选:多个视频按顺序播放完毕后再从第一个视频继续播放   静音 勾选:喇叭图标关闭,即使播放也默认静音 未勾选:声音大小跟随手机系统声音,大小可调节 预加载 勾选:暂停播放后,断开网络,可继续播放 未勾选:暂停播放,断开网络,点击播放显示网络错误 视频地址详情页:可以增加,删除,移动视频。 注1:上图红框处提示有错误,如果视频文件放在 WEB-INF 目录下,预览时会提示播放错误。本地资源仅支持 %FR_HOME%\webapps\webroot 目录以及其子目录(但不支持 WEB-INF 目录)下的视频资源。 注2:当前视频大小无法自适应,需要自己根据报表大小调节。 2)事件 可以添加 JS 事件。 3. 示例           3.1 报表设计 1)下载安装好插件:视频播放插件 和 图片控件设计器。如下图所示:   2)新建决策报表,body 组件中拖入图片控件,将 客厅电视背景墙.jpg 以适应模式插入到决策报表中,如下图所示: 3)将视频播放控件拖入到 body 中,调整大小正好覆盖图片中的电视机,如下图所示: 4)自定义视频播放控件的属性,如下图所示: 将 高清中国风清明节气.mp4 存放到%FR_HOME%\webapps\webroot\help\路径下,将视频插入到控件中,如下图所示: 3.2 效果预览 保存报表,点击PC端预览,效果如应用场景中所示。 注:不支持移动端。 4. 模板下载 点击下载模板:下载.rar (4.38 M)    
【已下架插件文档】数字滚动器
该插件目前已下架帆软市场,本文档仅提供给历史使用了该插件的客户,帆软目前不再提供该插件的任何获取渠道。   1. 概述   1.1 版本 报表服务器版本 插件版本 11.0 V1.6 1.2 应用场景 大屏场景下,报表设计者经常会遇到需要显示数字的情况,因而开发了这款插件用于实现数字滚动显示效果。 注:该插件只适用于决策报表。   1.3 功能介绍 决策报表控件管理面板新增控件类型:数字滚动插件 用户可自定义数据来源、大小、颜色、动画间隔时间等 效果如下: 注:不支持移动端。 2. 插件介绍   2.2 操作方法 安装插件后,在决策报表的控件管理面板中,将数字滚动这个控件拖入决策报表设计主体中。 2.3 属性设置 选中该控件后,可以在右下方属性面板对控件的内容和属性进行设置,如下图所示: 1)数据源 数据格式为数字,或者可以转换为数字的字符串。 否则,内容只是被原样显示出来。 2)持续时间 从一个数字滚动到另一个数字的持续时间。 3)暂停时间 一个数字保持不动的显示时间。 4)前、后缀 显示在数字的前面和后面的字符串。 例如:¥1000   1000元 5)文字大小,颜色,背景 6)分组 未勾选分组:10000 勾选分组:10,000 7)小数位数 设置需要显示的小数位数 3. 模板下载 点击下载模板:数字滚动.rar (1.3 K)  
【已下架插件文档】幻灯片
该插件目前已下架帆软市场,本文档仅提供给历史使用了该插件的客户,帆软目前不再提供该插件的任何获取渠道。   1. 概述 1.1 版本 报表服务器版本 插件版本 11.0 V1.5 1.2 应用场景 大屏场景下,报表设计者经常会遇到需要通过幻灯片的形式展示内容的情况,因而开发了这款插件用于实现幻灯片效果。 注:该插件只适用于决策报表。 1.3 功能介绍 决策报表控件管理面板新增控件类型:超酷幻灯片 用户可自定义幻灯片的数据来源、幻灯片大小,模板样式、颜色、自动播放间隔时间等 幻灯片中每一页的数据可以自定义内容和格式。格式可以参考html。 例如<div font-size=“50” align="center">您好!</div> 超酷幻灯片的示例效果如下图所示: 像下面这样,把报表链接加入数据集,就可以在幻灯片中显示报表啦: 2. 插件介绍 2.2 操作方法 安装插件后,在决策报表的控件管理面板中,将幻灯片这个控件拖入决策报表设计主体中。 2.3 属性设置 选中该控件后,可以在右下方属性面板对控件的内容和属性进行设置,如下图所示: 每个设置项的详细介绍如下: 设置项 简介 数据源 幻灯片的显示内容的来源,选择一列数据即可,每一行的内容对应于幻灯片的一个页面。 数据源的内容的格式: 纯文本或者数字,例如:“2020年”。显示在幻灯片中没有格式,只是原样显示出来。 其他报表的url。在幻灯片中显示其他报表的内容。 带有html标签,例如:“<h1>2020年</h1>”。在幻灯片中的显示格式与浏览器中格式一样。通过灵活运用html的标签,即可以达到显示内容的格式化。 幻灯片样式 即幻灯片的播放样式,目前包含以下几种: 水平移动 (适合于幻灯片左右没有其他控件的场景) 上下移动 (适合于幻灯片上下没有其他控件的场景) 远近移动 3D旋转 切换(幻灯片只在原地切换,没有其他动画效果,也不会越出边界,适合屏幕中某个区域展示的场景) 颜色 可以对幻灯片的背景和文字进行颜色选择。 自动播放、播放时间间隔 勾选自动播放。幻灯片将按照输入的播放时间间隔(默认是5秒)进行自动播放。 不勾选自动播放。通过“空格键”或者鼠标点击右下角的“播放按钮”进行播放。 工具条 勾选以后会在右下角显示工具栏,其中包括自动播放按钮,跳转选项等。建议勾上。 进度条和进度 勾选以后,会在底部显示页码和进度条。 宽度,高度 调整幻灯片背景的宽高。 注:这里的宽高不是实际像素,使用时通过尝试的方式,可很快找到合适的大小。 X轴,Y轴边距 调整幻灯片页面的内边距 注:这里的边距不是实际像素,使用时通过尝试的方式,可很快找到合适的大小 圆角半径 调整幻灯片页面四周的圆角弧度 3. 模板下载 点击下载模板:slides.rar (2.1 K) 4. 注意事项 目前暂时不支持一个报表中,同时显示多个幻灯片。 建议幻灯片的数据源行数不要过多,例如数千行数据。太多的页面可能导致显示卡顿。根据设备配置测试效果决定。 不支持IE浏览器。 极端分辨率的情况下,如果幻灯片出现重叠显示,可以通过在幻灯片控件旁边添加其他控件的方式,来调节幻灯片大小。 目前,幻灯片插件的实现方式决定了,同页面的其他控件的事件会被屏蔽,所以使用幻灯片插件的同时,建议不要在同一页面使用按钮,超链接等功能。 不支持添加控件事件。 此插件只用于决策报表。 不支持移动端。  
【已下架插件文档】超酷3D翻页式计数器
该插件目前已下架帆软市场,本文档仅提供给历史使用了该插件的客户,帆软目前不再提供该插件的任何获取渠道。   1. 概述 1.1 版本 报表服务器版本 插件版本 11.0 V7.04 1.2 应用场景 大屏场景下,报表设计者经常会遇到需要快速变动刷新数字的情况,用简单文字的实现方式会显得比较粗糙,因而开发了这款插件用于实现翻页式计数效果。 注:该插件只适用于决策报表。 1.3 功能介绍 决策报表控件管理面板新增控件类型:翻页计数器 用户可自定义翻页计数器的数据来源、刷新频率、字体、颜色等 不支持添加控件事件 翻页计数器的示例效果如下图所示: 2. 插件介绍 安装插件后,在决策报表的控件管理面板中,将「翻页计数器」这个控件拖入决策报表设计主体中。 2.3 属性设置 选中该控件后,可以在右下方属性面板对控件的内容和属性进行设置,如下图所示: 每个设置项的详细介绍如下: 1)数据源 翻页计数器的数据来源,作为控件的显示值,共有三种类型: 注:数据源的数据需要是数值类型的,且数值类型中不支持小数。 空值:即无值,展示时无数据刷新 公式:通过公式计算得到控件的显示值 字段:绑定服务器数据集的数据,前端展示的数据可以跟随数据库表中数据变化而变化,从而实现动态展示的效果 2)对齐方式 翻页计数器展示时所处的位置,共有三种对齐方式: 左对齐:翻页计数器显示在左上角 居中对齐:翻页计数器显示在正中间 右对齐:翻页计数器显示在右上角 3)刷新频率 数据的刷新频率,单位为秒,设置为0时,数据不刷新。 注:设置刷新频率后需要回车保存,点击空白处是不会自动保存的。 4)字体 字体大小 字体颜色 字体透明度 5)背景 背景颜色 横线颜色 背景透明度 3. 示例 3.1 设计报表 新建决策报表,将翻页计数器控件拖到报表设计主体中,设置数据源为公式:second(now()),刷新频率为 1 秒,其余保持默认设置。 注:公式表示实时显示当前时间的秒数。 3.2 效果预览 保存报表,点击PC端预览,实时展示当前时间秒数的效果如下图所示: 注:不支持移动端。 4. 模板下载 点击下载模板:翻页计数器.rar (1.05 K) 5. 注意事项 5.1 无法获取计数器数据 1)问题描述 其他按钮通过 JS 获取翻页计数器控件的值时。 无法获取数据,且有如下报错信息: 2)原因分析 目前插件不支持 getvalue 这个属性,所以获取不到数据。  
【已下架插件文档】Tab轮播特效插件
该插件目前已下架帆软市场,本文档仅提供给历史使用了该插件的客户,帆软目前不再提供该插件的任何获取渠道。   1. 概述 1.1 版本 报表服务器版本 JAR 包版本 插件版本 11.0 2021/10/19 V1.1.7 1.2 应用场景 目前决策报表tab块默认的轮播效果是渐变切换,比较单一。 此插件功能为决策报表tab块增强,提供轮播效果配置项,实现报表tab多种展示效果,例如横向滚动效果、上下滚动等轮播效果。 1.3 功能介绍 此插件功能为实现tab轮播特效功能。通过控件配置选项,实现报表中tab块轮播效果的变更。 功能描述如下: 在设计器的决策报表工具栏中新增一项“tab块”组件。 控件设置画面,增加“轮播特效”配置项。 报表预览实现横向滚动、上下滚动、3D翻转等效果。注意:在tab标签第一次轮播后,特效会展示。 2. 插件介绍 2.1 添加组件 安装好插件后,在设计器打开对应报表文件,决策报表工具栏中新增一项“Tab块增强”组件。决策报表设计时,将 Tab 块增强组件拖拽至决策报表主体中。 注意:安装完插件后,同步在工具栏控件增加一个“tab块布局”控件,此项无需使用。(仅用于tab块组件嵌套)。 2.2 参数配置 插件安装后,报表控件设置画面,已增加“轮播特效”配置项,需要设置特效选项。 点击左侧控件设置,打开tab布局属性界面,如下图: 先勾选“开启轮播”,在“轮播特效”选项,可以设定各种报表展示效果。包括渐变切换、横向滚动、上下滚动、3D翻转效果。 预览报表即可看到展示效果。注意:在tab标签第一次轮播后,特效会展示。 3. 示例 3.1 报表设计 1)点击下载模板:tab标签.rar (70.04 K)后在设计器中打开。 将 Tab块增强 拖入body中,将原来Tab中的组件复制到 Tab块增强中。 2)设置轮播特效   4. 模板下载 点击下载模板:Tab轮播特效插件.rar (98.03 K)   5. 注意事项 在tab标签第一次轮播后,特效才会展示。 IE8及以下版本,不支持轮播特效显示(和整体产品保持一致)。 插件V11版本,支持FR11决策模板预览。不支持FR10旧版预览。  
【已下架插件文档】决策报表多标签页导出
该插件目前已下架帆软市场,本文档仅提供给历史使用了该插件的客户,帆软目前不再提供该插件的任何获取渠道。   1. 概述 1.1 版本 报表服务器版本 JAR 包版本 插件版本 11.0.10 2022-11-16 V1.2 1.2 应用场景 通过 决策报表导出插件,用户可以将决策报表整体导出为 Excel、PDF 或 Word,但是不支持多标签页导出。 用户可通过 决策报表多标签页导出 插件,实现决策报表多标签页导出功能。 决策报表导出多标签 Excel 的效果,如下图所示: 1.3 功能描述 1)支持多标签页导出功能,支持导出 Excel、PDF 及 Word 格式, 多个 Tab 页导出 Excel 后,显示为多个 Sheet 页。 多个 Tab 页导出 Doc 或 PDF 格式后,显示为多页。 2)访问任意决策报表, 后缀加上&op=export&format=excel即可导出 Excel,通过修改 format 参数,可以改变导出的文件类型。 注1:不能与决策报表导出插件同时安装。 注2:不能与决策报表导出plus插件同时安装。 注2:多标签页的各个标题名称不能重复。 2. 插件介绍 2.1 插件安装 注1:不能与决策报表导出插件同时安装。 注2:不能与决策报表导出plus插件同时安装。 注3:JDK 1.8 且小版本需在 JDK8u102 以上。 注4:该插件适配 2020-01-05 及之后的 JAR 包。安装插件时如要求更新设计器,可以点击菜单栏「帮助>更新升级」进行升级,如下图所示: 2.2 操作方法 插件安装后,使用PC端预览多 Tab 页的决策报表。 预览后,在链接后缀加上&op=export&format=excel,点击回车,即可开始导出,如下图所示: 注:通过修改 format 参数,可以改变导出的文件类型,目前支持 Excel、PDF 及 Word 格式。 3. 示例 3.1 设计报表 1)添加 Tab 块 新建决策报表,添加 Tab 块,添加 5 个 Tab 页,分别命名为:财务报表封面,资产表,利润表,现金流表,销售利润表 如下图所示: 注:多标签页的各个标题名称不能重复。 2)添加报表块 向每个 Tab 块加入报表块。 复制%FR_HOME%\webapps\webroot\WEB-INF\reportlets\demo\form\集团财务报表.cpt的数据至每个报表块。 3.2 效果预览 保存报表,点击PC端预览,在链接尾部加入后缀&op=export&format=excel,导出的 Excel 效果如应用场景中所示。 注1:用户需先预览模板,再添加后缀下载。            如不预览,直接使用「链接+后缀」下载,导出的文件与模板预览效果会大相径庭。 注2:不支持移动端。 4. 模板下载 点击下载模板:决策报表多标签页导出.rar (7.73 K)    
FineDataLink实战案例分享【2025-04-28周】
1、数据上云且触发智能助手 1.1 应用场景 设备异常处理场景中,多为现场工作人员或 IOT 平台人员发现设备异常,再人工通知维修部进行工单分配,多环节均效率低下。 FineDataLink 可基于IOT→FineDataLink→简道云的及时数据链路,实现设备数据和工单分配的完全打通,并实现设备异常的及时处理。 1.2 实现思路 FineDataLink 中处理数据,获取最新设备状态数据,使用「简道云输出」算子输出到简道云表单后,触发智能助手,智能助手触发异常设备检修流程,分配工单,及时处理设备异常。 1.3 任务展示 访问 https://demo.finedatalink.com/ ,点击「demo中心>价值场景演示」,查看「与简道云组合应用>设备维修工单分配」Demo。 1.4 参考文档 详情请参见:数据上云且触发智能助手 2、dbf文件批量自动同步 2.1 应用场景 希望将二进制的 dbf 文件处理成二维表并定时自动同步,可使用本文方案,为企业降本增效。 2.2 参考文档 详情请参见:dbf 文件批量自动同步 3、数据处理-按编号和日期汇总顺序拼接数据 3.1 应用场景 某公司的闸机系统会按照人员编号、通行门禁除、通信时间3个字段,记录每一个人员,经过每一处门禁,具体经过的时间。 希望可以将原始通行明细数据,汇总成按:每人每天一条汇总通行详情,且通行详情需要按照时间先后排序。 例如原始数据如下图所示: 期望数据处理后的结果: 3.2 参考文档 详情请参见:数据处理-按编号和日期汇总顺序拼接数据 4、API取数-获取美团企业版数据 4.1 应用场景 用户需要将美团企业版的接口数据取出,例如希望将 订单列表查询 中的数据取出,如下图所示: 而「美团企业版」的所有接口调用需要对请求参数进行加密,响应参数进行解密,详情参见:签名实例 4.2 参考文档 详情请参见:API取数-获取美团企业版数据 5、单个简道云子表单输出 5.1 应用场景 用户想要将数据库系统数据输出到简道云子表单中,实现子表单数据的新增、更新和删除。 5.2 参考文档 详情请参见:单个简道云子表单输出 6、功能使用指导 6.1 调度配置方案 用户在开发完多个定时任务后,希望对存在业务上下游关联的定时任务设置调度策略。 文章将详细介绍根据不同的任务运行要求,如何通过「定时调度」和「事件调度」保证多个定时任务的协调运行。 参考文档: Ø 详情请参见:调度配置方案 6.2 定时任务排队问题排查方案 用户在手动触发任务或者调度触发任务过程中,FineDataLink 工程中可能会出现由于内存不足、并发不足等问题导致的任务卡住、任务排队的问题,问题原因各不相同。 想知道如何对部分定时任务运行排队问题进行排查。 参考文档: Ø 详情请参见:定时任务排队问题排查方案
FineDataLink实战案例分享【2024-12-30周】
1. 大数据量分区分页并发查询增量同步 1.1 应用场景 用户从吉客云读取一张 1300W 数据量的表存储到阿里云的 ApsaraDB for MySQL。 「数据转换」节点中处理数据时,由于数据量过大,数据读取的时间超过了数据库允许 SQL 执行的最大时间(最大时间为 30 分钟);面对如此大的数据量,单纯的增加数据库查询等待时间解决不了问题,并且单并发的数据同步也满足不了数据同步的时间要求。 1.2 实现思路 具体实现步骤分为两个阶段: 初始化全量阶段 根据日期字段将数据分区: 以取出 2024-01 月数据为例: 1)每次取出 100000,计算取出次数,并输出为参数 fenye。 2)循环容器执行条件设置为 ${loopTimes}<=${fenye}: 分页查询来源表中 2024 年 1 月的数据,每页查询最多 100000 条记录,并根据 ${loopTimes} 变量动态调整查询的起始位置,实现分页效果。 数据取出后,用户可根据实际情况,进行JSON解析、过滤等操作。 将处理后的数据落库。 增量阶段 1)根据目标表最大时间筛选出来源表新增数据,新增的数据按每页 500 条计算页数,将页数输出为参数 fenye。 2)循环容器执行条件设置为 ${loopTimes}<=${fenye}: 获取每批 500 条的主键并作为参数输出。 根据主键参数,删除目标表中历史数据。 将本批新增数据处理后落库。 1.2 参考文档 详情请参见:大数据量分区分页并发查询增量同步 1.3 注意事项 本文方案中的 SQL 语句只适用于 ApsaraDB for MySQL 数据库,其他数据库需要自行调整 SQL 语句。 本文方案只适用于大数据量场景&数据只存在新增的场景。 2. 简道云表单调用定时任务接口示例 2.1 应用场景 用户简道云流程流转中,下游表单需要使用上游表单经过 FDL处理后的数据。 用户希望 FDL 可以代替简道云的数据工厂进行数据处理。 2.2 实现思路 简道云表单中可调用执行定时任务的接口,实现使用 FDL 处理数据的目的。 2.3 参考文档 详情请参见:简道云表单调用定时任务接口示例 3. 数据上云且触发智能助手 3.1 应用场景 设备异常处理场景中,多为现场工作人员或 IOT 平台人员发现设备异常,再人工通知维修部进行工单分配,多环节均效率低下。 FineDataLink 可基于IOT→FineDataLink→简道云的及时数据链路,实现设备数据和工单分配的完全打通,并实现设备异常的及时处理。 3.2 实现思路 FineDataLink 中处理数据,获取最新设备状态数据,使用「简道云输出」算子输出到简道云表单后,触发智能助手,智能助手触发异常设备检修流程,分配工单,及时处理设备异常。 3.3 参考文档 详情请参见:数据上云且触发智能助手 4. 读取飞书多Sheet表格数据 4.1 应用场景 公司通过飞书多维表格设计了一套数据填报应用,但数据均在云上,需要通过API接口进行下载数据,并关联目前的应用数据等。 4.2 参考文档 详情请参见:读取飞书多Sheet表格数据 5. 解析并关联多个JSON数组字段(4.1.6.2及其后版本) 5.1 应用场景 用户的 JSON 数据中包含多个数组字段,如下图所示: 希望解析数组字段,且解析后的字段一一对应。如下图所示: 5.2 参考文档 详情请参见:解析并关联多个JSON数组字段(4.1.6.2及其后版本)
FineDataLink实战案例分享【2024-11-18周】
1、FDL最佳实践 1.1 使用偏移量从XML接口取数 1)应用场景 用户有一接口返回 XML 格式数据(数据量较多),希望从该接口中取出所有数据。 存在问题如下: 需要循环取数,但接口没有分页结束标识。 API输入-分页取数 功能目前不支持 xpath 路径。 2)实现思路 使用「循环容器」节点自带的 loopTimes 参数构建偏移量,从 API 取数,并将接口非空的字段进行参数输出。 「循环容器」节点设置执行方式为条件执行,执行条件为该参数值不为空,即可实现循环取数,直至参数值为空,说明数据以全部取完,循环结束。 3)参考文档 详情请参见:使用偏移量从XML接口取数 1.2 解析多层嵌套JSON并实现1:n关系 1)应用场景 用户的 JSON 数据结构是多层数组嵌套,如下图所示: 现需要解析上层数组元素和下层数组元素,实现 1:n 的关系。 例如:希望 titles 数组中的字段,能与 items 数组中(items 数组又包含 drivers 数组)的字段关联起来。如下图所示: titles 中的字段,与 items 中 drivers 包含的元素是 1:n 关系。 2)参考文档 详情请参见:解析多层嵌套JSON并实现1:n关系 1.3 SAP RFC:日期+偏移量双重循环取数 1)应用场景 SAP RFC 一次性取数过大时,驱动可能会崩溃,FDL 也可能会宕机。部分 RFC 函数提供了 ROWCOUNT、ROWSKIPS 和 date 参数,分别用于控制每次取多少行、从第几行开始取,以及按日期过滤数据。这些参数的逻辑与 API 获取数据时的偏移量类似。 然而,「SAP ERP输入」 并没有像「API 输入」算子那样提供高级设置来自动实现偏移量。 2)参考文档 详情请参见:SAP RFC:日期+偏移量双重循环取数 1.4 加密函数实现摘要签名认证方式 1)应用场景 Java代码实现摘要签名认证方式 文档使用 Java 代码实现摘要签名认证方式,但存在一定操作难度。 2)参考文档 将 Java代码实现摘要签名认证方式 文档中的 Java 代码函数化,FDL 中调用函数就能生成签名。 详情请参见:加密函数实现摘要签名认证方式 1.5 大数据量分区分页并发查询增量同步 1)应用场景 用户从吉客云读取一张 1300W 数据量的表存储到阿里云的 ApsaraDB for MySQL。 「数据转换」节点中处理数据时,由于数据量过大,数据读取的时间超过了数据库允许 SQL 执行的最大时间(最大时间为 30 分钟);面对如此大的数据量,单纯的增加数据库查询等待时间解决不了问题,并且单并发的数据同步也满足不了数据同步的时间要求。 2)参考文档 详情请参见:大数据量分区分页并发查询增量同步   2. 功能使用指导 2.1 FDL工程运维说明  部署好 FDL 后,我们还需配置项目,让平台完成自动运维。 对于关键项目要定期手动检查,平台出现异常项时,及时进行处理,保证工程的健康运行。 详情请参见:FDL工程运维说明 2.2 工程备份还原 迁移/升级前,手动对工程进行整体异机备份,便于迁移/升级失败后快速回退。 若服务器资源不足,webroot 文件夹过大,给出必要备份的文件说明。 详情请参见:工程备份还原      
FineDataLink实战案例分享【2024-09-19周】
1、FDL最佳实践 1.1 获取目录下符合条件的文件,按写入方式读取入库并记录状 1)应用场景 用户业务流程中下发的文件,有特定的文件生成则代表下发完成。比如:文件下发完成后,目录下会生成与文件同名的 .ok 文件(用来判断文件是否下发完成)、.del 文件(根据值的不同判断写入方式)、.sql 文件。 现需要将已经下发完成(生成 .ok 文件)的 csv 文件按照 .del 记录的方式进行读取入库,并且读取文件后,需要记录已经读取完成的文件,以便在任务异常重启时避免重复写入。 2)实现思路 1)将需要遍历的目录生成参数,「Shell 脚本」节点使用该参数获取指定目录下的 .ok、.sql、.del 文件,将文件名和文件路径输入到 output.csv 中,然后根据 output.csv 文件数据,拼接出待读取的 csv 文件路径,将数据保存到到数据库表中。 2)根据第一步输出的数据库表,将 .del 文件(需要根据该文件判断写入方式)路径、待读取 csv 文件路径输出为参数。 3)遍历第二步的参数,执行以下步骤: 判断文件是否已读取,若未读取,执行下面步骤。 读取 del 文件数据并输出为参数,根据参数值的不同,判断写入方式,根据不同的写入方式,将数据写入不同的表中。 记录已写入 csv 文件的路径、写入表、写入时间。 3)参考文档 详情请参见:获取目录下符合条件的文件,按写入方式读取入库并记录状态 1.2 FTP服务器中白名单文件自动传输与解压 1)应用场景 用户的业务数据以压缩包的形式每日进行下发,存储在 FTP 文件服务器对应的日期目录下,已经下发完成的压缩包文件会生成同名的 .ok 文件。 用户需要将部分压缩包文件传输到另外一个位置,并进行解压,希望已经传输成功的文件,下次任务运行时不会再重复传输。 2)参考文档 详情请参见:FTP服务器中白名单文件自动传输与解压 2、功能使用指导 2.1 如何打堆栈 用户在使用 FDL 时,可能会出现宕机而导致无法使用的情况,此时可以打堆栈进行排查,本文将说明如何打堆栈。 详情请参见:如何打堆栈 2.2 不同写入方式效果说明 1)应用场景 数据同步-写入方式 文档中,介绍了三种写入方式:直接将数据写入目标表、清空目标表,再写入数据、基于标识字段,新增/修改/删除数据。 本文为您展示这三种写入方式的实际效果。 2)参考文档 详情请参见:不同写入方式效果说明 2.3 新增计算列算子中获取当月天数 1)应用场景 用户想使用 新增计算列 算子,获取当月天数。 2)参考文档 详情请参见:新增计算列获取当月天数          
FineDataLink实战案例分享【2024-08-27周】
1、FDL最佳实践 1.1 PI数据库API循环取数 1)什么是PI数据库 PI 数据库是由美国 OSIsoft 公司开发的一种适用于实时数据管理的系统。它提供了高性能的数据采集、存储和检索服务,通常用于工业自动化、过程控制、能源管理等领域。 2)取数方式 PI Web API 是 PI System 提供的基于 Web 的应用程序编程接口(API),允许开发人员通过网络请求的方式访问 PI 数据,并与 PI System 进行集成。 PI Web API 支持常见的网络协议,如 HTTP 和 HTTPS,可以使用各种编程语言和开发框架来发出请求并处理响应。使用 PI Web API 时,开发人员可以使用认证方式获得对 PI 系统的访问权限,并通过发送适当的 HTTP 请求来获取数据、执行操作或执行其他功能。 PI Web API 的返回结果通常以常见的数据格式,如 XML 或 JSON 格式进行表示,以便可以轻松地进行解析和处理。 3)取数思路 在 PI 系统中,每个装置都有对应的位号,位号不能直接取值,需要用位号获取对应的 web_id ,再用 web_id 通过 API 取数的方式,返回需要的值。 注:装置对应的位号与 WEBID 可能存在变化,所以每次取数前需要进行更新。 4)参考文档 详情请参见:PI数据库API循环取数 1.2 多个逗号分隔的字段按照分组顺序匹配 应用场景: 从接口取数后,数据保存格式为:{{主数据},{子数据1,子数据2}{子数据a,子数据b}};其中,子数据中包含多个字段,以逗号分割存储。如下图所示: 实际业务场景中,每个子数据相当于一个分组,希望所有子数据按照分组内的数据顺序进行匹配(上图相同颜色的在同行展示)。希望得到的数据如下图所示: 使用两个「字段拆行」算子分别拆分职务、分公司字段时,出现笛卡尔积。如下图所示: 黄色标记的字段非实际需要数据。 参考文档: 详情请参见:多个逗号分隔的字段按照分组顺序匹配 2、功能使用指导 2.1 FineDataLink与Kettle的区别 很多新手用户使用 FDL 前,想了解 FDL 与 Kettle 的区别,可参见文档:FineDataLink与Kettle的区别 2.2 「包含」和「属于」的区别 应用场景: 条件判断逻辑说明 文档中,简单介绍了属于、不属于、包含、不包含这四种条件判断逻辑;很多用户不清楚属于与包含、不属于与不包含的区别,本文将对此进行详细解释。 参考文档: 详情请参见:「包含」和「属于」的区别 2.3 不同写入方式效果说明 应用场景: 数据同步-写入方式 文档中,介绍了三种写入方式:直接将数据写入目标表、清空目标表,再写入数据、基于标识字段,新增/修改/删除数据。 本文为您展示这三种写入方式的实际效果。 参考文档: 详情请参见:不同写入方式效果说明          
123下一页
个人成就
内容被浏览461,912
加入社区4年210天
返回顶部