02-Birt工具图形报表开发手册

Birt图形报表开发手册1.图表制作总体步骤Birt提供了丰富的图表元素，图表是数据或数据集之间关系的图形表示法。图表采用易于理解的格式显示复杂数据。完全可以将图表作为报告使用，也可以将报告与其他报告元素组合以增强或突出显示相关信息。图表的配置一般包含如下步骤：a)准备数据源与数据报表的数据源集数据集准备一样，大部分多维的图表的制作也需要依赖于多维数据集。如需要使用数据集，请参考《Birt数据报表开发手册》的数据源和数据集的创建与使用部分。b)选择图表类型选择组件板，然后将该组件板中的图表元素拖到报告中，或者在报表正文的放置图表位置右击鼠标，选择插入图表：弹出图表配置对话框，首先根据报表需求选择图表类型和子类：设置图表的指标维度个数，已经图表的输出类型格式等，从而确定图表的大体样式。c)关联展示数据集类型选择完成后，针对图表的特点和属性进行数据的绑定关联：首先选择图表展现的数据来源，也就是报表中已经存在的数据集。根据图表的需要设置系列，维度指标，是否分组等。可以使用不同的方法来提供图表中的数据表达式：指定要使用的数据的最简单方法是将“数据预览”中的列拖拽至图表的元素中，或通过选中数据集的字段右击鼠标，选择相应的元素加入也可以输入表达式或使用表达式构建器来创建表达式。在设计图表时，预览窗口将向您指示您的进度。例如，如果更改线图的X，Y轴的显示信息，分组信息等，则预览窗口将反映您所作的更改。d)设置图表格式数据绑定后，就可以根据需求和图表本身的属性，对图表的展现格式进行设置，设置完成后，就可在工具和页面中预览。柱线图预览结果:图表数据的方式通常与在Birt中的其他数据展现的方式不同。一个重要的差别是为图表创建的数据集，图表不会聚集数据。要在图表中使用总计，必须创建返回总计信息的数据集。下面我们将按照不同的图表来全量了解图表的制作。2.柱状图系列在Birt的图表设置中，柱状图，折线图，面积图，散点图，气泡图，股票图，管，锥，棱形图，差异图等趋势展现类图表，只是展现图表的形状和元素，样式有差异。他们的配置流程和设置方法，附加的布局属性等都是一样的，因此这里只用柱状图制作和设置作为蓝本，其他趋势性的图表设置都可参考柱状图。a)选择图表类型在图表类型中选择条形图，子类的选择有并列，纵向堆积和按百分比的堆栈，如：选择最基础的并列柱图。图表维数的选择上，根据图表的需求，选择对应类型。设置图表的输出格式：还可根据需要是否翻转坐标轴，及图表系列类型等：图表的整体样式确定后，就可以根据确定的类型来绑定数据，点击下一步:b)关联数据集首先为图表选择展示数据的源，在选择数据区域选择使用以下来源的数据，Birt将报表中已经创建的所有数据集和多维数据集列举供用户选择。通过显示数据预览可选框选定预览方式，在数据预览区展现数据集的字段或明细数据。并可通过筛选器，数据绑定按钮等对数据集进行再次筛选和绑定。筛选或绑定方法与数据报表中的方法一致。下图是字段式的预览方式：明细数据式预览：数据完成后，开始按顺序设置图表各元素与数据的绑定关系，先设置X轴：可以直接在数据预览中选择字段或明细数据列，右击鼠标，选择用作类别X轴；或者将要作为X轴类别的字段拖入对应框中：也可在图表预览中，为类别X系列通过表达式的编辑来设置X轴：输入或通过选择函数，数据等方式来编辑表达式：并可设定其排序内方式方法：柱图的X轴一般为时间，区域，品牌等关键维度，不需要设置其聚合的方式。按同样的方法设置Y轴系列；柱图的Y轴一般是展现指标用，如果图表报表存在多个指标，可以在Y轴的设置中添加系列的个数：设置两个系列后的预览图：X,Y轴设置完成后，按同样的方法可选设置Y轴系列分组，通过在预览区选择分组字段，或编辑分组字段的表达式。所有系列的数据设置完成后，点击下一步，开始图表布局格式设置。c)设置图表格式下图是图表布局格式设置的总体界面，左边选择图表元素，右边将元素的可设置属性列举，方便设置，如：Y轴的系列设置如下根据图表需要分别设置系列的属性，如颜色，标签等。设置标签的属性：曲线拟合线的设置和显示：对于图标，同样可以设置前台操作时的事件和对应的其响应方式：设置图表正文区域的属性，基本的属性包括背景色，样式，墙纸等颜色。并可以选择如果图表的数据集未返回结果时的显示方式：接下来设置X，Y轴坐标轴的总体格式：X轴的分项格式设置：重点关注和设置X轴的标题编辑，标签的显示方式，网格的显示方式等。对于标签的设置，可以通过点击后面的”A”字按钮,在弹出的对话框中通过拖动指针来设置标签文字的显示方向；同样提供了X轴的事件类型和对应的其响应方式设置。Y轴的分项格式设置与X轴的基本一致，区别在于X轴可设置是否可反转类别。图表区域中的标题，图形，图例的设置是所有图表设置的公共部分。其中图表区域是对整个图表显示的设置，如背景色，样式及未数据集未返回结果时的显示设置等。标题部分是针对图表的标题的设置；图形部分是设置除图例之外的所有区域的格式设置；图例部分则是设置图表中展示数据的样例的显示，排序，伸展等属性。图表标题的设置相对比较简单，只需要设置标题是否显示，显示名称，字体大小等属性即可。图形区域部分的设置，包含除图例之外的所有区域和坐标轴内的区域两部分，只需分别设置背景颜色和边框是否可见即可：图例部分的设置，需要关注和设置有图例是否显示，显示位置，排列和伸展的方向，是否有边框，以及分组图例的排列和伸展方向等。下图是图例和标题的可见性，突出显示设置：设置位置，排列，伸展，边框等属性，点击布局按钮，在弹出的对话框中分别设置即可。以上设置的最终展现结果如下：完成图表配置后，保存报表的配置以保存图表的配置。3.饼图a)选择图表类型饼图的制作流程与柱状图系列大体相同，不同的是饼图由于本身的图表特点，在图表分类和格式的设置相对简单。在大小类的选择上，饼图只有最基本的多扇面显示，维度的个数也只有二维和深度二维两种，如下图所示，根据需求选择饼图的类型，点击下一步：b)关联数据集饼图的数据来源选择与其他图表一样，这里就不再重复。需要设置如下内容：扇面大小定义：根据指标的汇总计算结果来展示饼图中大小不同的扇面；类别的定义：指定单个饼图分扇的依据，如下图是指定按品牌来进行分扇面；可选分组：指定多个饼图的分饼依据，可以按月份或地市分多个饼图；c)设置图表格式饼图的格式设置图表区域的设置与柱状图系列的设置一样，因此只需要设置系列部分的布局。设置图表的着色依据，和系列的标题等：系列选项板可以设置饼图中系列的颜色层次，如选择渐变颜色：类别系列都是通过绑定数据集里的指标计算结果占比自动分配的，当类别过多时，设置一个过滤条件，将满足这个条件的所有扇面合并为一个扇面，并指定扇面的显示标签。如下图设置的是占比小于25%的所有扇面合并为一个，显示为”其他”:饼图的值系列中可设置饼图的引线，饼图的大小，垂直方向的选择角度及扇面与饼的分离条件，饼图的边框是否显示等格式：按柱状图中的设置方法，设置图表区域背景，样式，可见性等：以下是图表标题的设置，输入标题名称，选择字体和大小即可:图形部分的分绘图区(图表中的饼状图显示区域)和客户区域的背景，颜色，边框设置：图例的位置，排列，伸展等属性的设置。设置完成后，保存布局设置并预览：4.仪表盘a)选择图表类型选择图表类型为仪表图，并根据需求选择子类。仪表图的子类包含一个指针和多个指针两种。b)关联数据集仪表值是设置仪表图中指针指向的位置，可以通过编辑表达式或在数据集预览结果中选择；类别定义是指定多指针仪表图时的分指针的依据，如每种品牌一个指针；可选分组是指定多个仪表图的分图的依据，如每天或每月或每个地区一个仪表图。c)设置图表格式系列的总体项是设置仪表图展示的数据内容描述，及这个设置的可见性。值系列的设置部分，首先主页面可设置仪表图的半径值来调整仪表图的小，起始和结束的角度值用来设置扇面的大小。填充颜色用来设置整个仪表图的背景颜色。将扇面上述属性设置完成后，可以预览到仪表图的底色调整为之前设置的颜色。接下来可调整刻度标签的属性，如是否可显示，字体，背景，显示样式，内嵌的点的样式等。扇面区域的设置，可任意添加区域的个数，起始值，结束之，颜色，边框等。以告警分析的仪表图为例，需要设置三个区域，绿色区域标识正常的数据范围，黄色区域标识预警范围，红色区域标识告警范围，设置第一区域0-500范围，填充颜色为红色表示告警设置第二区域500-100范围，填充颜色为黄色表示预警设置第三区域100-5000范围，填充颜色为绿色表示正常数据设置后仪表图样式如下：设置附加属性中的主，次刻度线的显示颜色，样式，和主刻度中的此刻度线个数等。调整仪表图中的最大值和最小值，即可最终完成仪表图的值系列部分的布局。根据图表需要调整仪表图中的指针的颜色，样式，宽度等。其他公共的属性设置可以参考柱状图的设置方法。设置完成后保存配置，并在工具或页面中预览仪表图的展现。5.甘特图a)选择图表类型选择图表类型为甘特图，甘特图只有一种图形，所以并不需要选择子类。但是可以添加多个Y轴的展现，以单个Y轴的设置为例，图表选择的页面如下：b)关联数据集甘特图的图表要求两个或以上的Date型字段作为X轴时间，因此数据集的定义中必须有两个Date型字段。设置开始和结束日期对应的数据集字段；指定任务标题，也就是要展现的指标，通过选择或编辑表达式来设置；设置类别X系列，也就是甘特图中常说的项目或工程阶段对应的字段设置可选的Y系列分组绑定，本例中没有设置分组。c)设置图表格式按柱状图中的方法设置类别的标题和分组依据等属性：设置值的显示样式，颜色，标签等，如果有多个Y轴，就需要多次分别设置。多Y轴设置时，建议每个Y轴颜色不要太接近，否则会影响展现效果。设置系列标签的显示内容和格式,选中需要添加的项目，点击添加，将想添加的内容加入到值中：设置任务标签的显示属性，如位置，背景，边框，内嵌点的属性等：Y轴值设置完成后，图表区域总体设置与柱状图一样。坐标轴的设置中，类型建议可采用其默认设置，可以调整颜色和可见性等附加属性。X轴的设置除了可设置X轴的标题，数据的显示格式外，还可以设置标签文字的排列的方向，点击标签后的“A”字行按钮,在弹出的窗口中，通过拖动指针来调整方向：Y轴的设置与X轴一样，比X轴少一个是否为反转类别的设置。这里可以设置图表中的网格线，轴线的颜色，主次网格，刻度的显示，样式，颜色等完成配置后，保存设置并在工具或浏览器中预览效果如下：6.组合图形图形的组合是指在同一张图中，使用不同的图表类型展示数据，以柱线图为例，其中一个系列采取柱图展现预计收入，另一个系列采用折线图展现实际的收入。这就要求在数据源的选择方面必须选取多维度，多指标数据集，才能通过不同的图表来显示。a)选择图表类型数据源准备完成后，在图表类型的选择上，先选择大类为柱状图。可以通过多Y轴和多系列两种方式来实现柱线图，如多Y轴的在这里选择多个Y轴，设置次Y轴的图表类型为折线图b)关联数据集关联数据集的方法与柱状图的方式一样，通过编辑表达式，鼠标右键或者拖动字段的方式将数据集中的字段设置到对应的位置。如果是多Y轴的方式，则需要分别设置每个Y轴下的系列的表达式如果是多系列的方式，则只需要添加多个系列，再分别编辑其表达式即可c)设置图表格式在图表格式的设置上，如果是多Y轴的方式，需要设置每个Y轴的和系列属性而多系列的方式则只需要设置默认的Y轴系列属性先按照柱状图中介绍的方法设置每个系列的属性:设置每个Y轴的属性：设置完成后，保存设置信息，并在工具或浏览器中预览。下图是多Y轴的柱线图预览结果：注意：组合图可以通过多Y轴或者多系列两种方式来实现，两者的不同之处是：多Y轴的实现方式将柱和线作为两个Y轴展现，可在布局的设置中分别设置两个轴和轴下的系列的属性，同时在图表展示时会将两个Y轴的刻度在左右分别展示。多系列的方式是同一个Y轴中的多个系列，因此可设置的Y轴属性只有一个，且展示时只有一个Y轴的刻度会按设置的方式展现。