FusionCharts导出设置.doc

1导出为PDF或图像“服务器端出口榜单下载导出的选举作为输出当返回导出的输出下载到浏览器（图像/ PDF格式），整个流程看起来下：1. 在您的Web页的图表中读取XML数据，并呈现。此XML数据包含的参数，帮助您配置的出口参数。2. 当用户在图表上点击右键并选择菜单项的出口图表，图表中的数据发送到服务器（其中FusionCharts的出口采取行动来处理程序）。3. 服务器端处理程序接受来自图表导出此位图数据，以及其他参数，生成图像/ PDF和返回回浏览器。让我们快速了解如何配置整个安装。设置服务器端的出口处理首先，你需要复制粘贴所需的服务器端处理程序导出下载包“ ExportHandlers文件夹到您的服务器。对于这个例子，我们的PHP文件复制到/FusionCharts/ExportHandlers/PHP。确保你已经复制了相应的文件夹的所有文件。这就完成了例行的出口下载服务器端设置。下一步，我们将配置参数的XML的出口。我们的出口在几种语言处理一些如其他图书馆取决于PHP的GD和GZip压缩处理程序需要在服务器上安装。同样，Ruby on Rails的需要RMagick和zlib加入到你的服务器上。请确保你已经正确安装这些依赖。出口参数添加到XML现在，你需要设置图表允许出口。这是使用：如果exportEnabled设置为0，图表不能启动导出过程中，不论扳机。接下来，您需要设置出口处理程序，它是处理程序的路径到服务器端的出口。对于我们的例子中，我们已经设置为路径/FusionCharts/ExportHandlers/PHP-所以现在看起来的XML：现在，既然我们打算使用服务器端的出口，我们设置最后，使用服务器端出口处理程序中，我们打算有导出文件下载到用户的机器上。所以，我们设置：这个例子的最终XML看起来下： 当您现在运行图，并选择“另存为JPEG图像”，从上下文菜单，图表将首先捕获过程如下所示：拍照后，该图表的数据发送到出口处理程序（PHP在这种情况下），这反过来流程，下载并返回一个输出图像如下图所示：请注意，在上面的图片的对话框显示来自：。当PHP档案托管在您的服务器，这将反映您的域名。设置目标窗口下载正如你可以在上面看到默认情况下，出口图表返回同一浏览器窗口的形象。但是，如果您要指定为导出的图像，您可以设置新的浏览器窗口：这将打开一个新的浏览器窗口中输出图像。导出的配置文件的文件名此外，返回文件名，默认命名为FusionCharts的（。JPG格式/，巴/ .pdf）。您可以通过设置这样的：请注意，您不必提供扩展在这里，因为这是延长在图表的过程中选择导出格式而定。这将导致：它的所有服务器端的下载程序。下一步，我们将看到如何对服务器硬盘保存这些图片，而不是下载它们。1.2导出为PDF或图像“服务器端出口榜单保存导出的服务器磁盘输出如果您不希望导出的图像发送回浏览器，而是希望它在服务器上保存，你需要从前面的例子，那里的文件被下载了以下变化：1. 打开服务器端处理程序和配置出口的可写文件夹的路径中，图像将被保存，以及设置HTTP的URL，在代码文件夹的代表性。该处理器还允许有关文件命名一些先进的配置。2. 更改exportAction =保存在XML3. 删除exportTargetWindowXML属性从您的。由于没有下载回来，毫无疑问是哪一个窗口，返回它4. 创建一个Web页面中的JavaScript方法一旦被调用的图像已被保存在服务器上。指定的名称，这个功能exportCallbackXML的属性。如果你不指定任何名字在这里，默认情况下，一个JavaScript函数名为FC_Exported被调用。让我们从第1步，第一次启动，可以配置您的服务器上保存临时文件夹路径，并设置为相同的HTTP参考。配置服务器端处理出口在出口的处理程序，你需要配置以下内容： 配置您的服务器上的图像文件夹/ PDF文件将被保存。请确保此文件夹中有适当的写权限，否则出口处理程序将无法写入文件系统。负责检查和设置在服务器上的安全设置，请在Web服务器的文档（即，IIS和Apache的文档等） 你需要指定的文件夹路径的HTTP映射如此，如果你需要你的JavaScript函数，直接访问这个保存的图像。例如，假设你的服务器上保存的图像在： inetpub wwwroot的 yoursite 温度（或/用户/ 你 / WWW的/温度），图像保存在这里可以通过达成http:/www。 /温度，你需要指定网址“/temp路径“这个文件夹映射为HTTP的网址。 配置文件名设置 - 默认情况下，FusionCharts的处理程序使用的GUID出口自动文件名生成。截至今年年底，你可以选择追加当前的时间戳服务器，或一个随机数字，以避免压倒一切的任何文件（成千上万的并发文件在给定的情况下被第二次保存）。您还可以配置文件是否会被覆盖在该文件夹或没有（这是默认值）。其中，出口取决于你使用的处理程序，请按照下列步骤进行：如果PHP：打开FCExporter.php，向下滚动，并以下线的变化：/ * -导出路径和URI的- - * / / * *重要：你需要更改的文件夹位置 *导出的图表图形/ PDF文件将被保存在您的 *服务器。 请指定一个文件夹的路径与 *写在不断SAVE_PATH下面的权限。 * / 定义 （ “SAVE_PATH” ， “/”。 ）; / *请将您的文件夹路径在这里.* / / * *注意：此常数HTTP_URI商店的HTTP引用 *把在出口图表将被保存的文件夹。 *请输入该文件夹的HTTP的代表性 *在此常数如/images/ * / 定义 （ “HTTP_URI” ， “/images/” ）; / *定义你的HTTP映射URL这里。 * / / * OVERWRITEFILE设置是否出口处理程序将覆盖现有文件 *新创建的导出的文件。 如果它被设置为false的处理程序将出口*未覆盖。 在这种情况下，如果设置为true INTELLIGENTFILENAMING处理程序*会增加一个新的文件后缀名。 后缀是一个随机生成的UUID。*此外，添加一个时间戳或其他后缀的随机数。* * /定义 （ “OVERWRITEFILE” ， 假的 ）;定义 （ “INTELLIGENTFILENAMING” ， 真实 ）; 定义 （ “FILESUFFIXFORMAT” ， “时间戳” ） ; / /可以TIMESTAMP或随机/ *定义文件在写，自动命名和命名后缀配置这里。* /如果ASP.NET：打开FCExporter.aspx.cs并编辑如下：/ / / / / /注意：您需要更改文件夹的位置 / / /导出的图表图形/ PDF文件将被保存在您的 / / /服务器。 请指定一个文件夹的路径与 / / /写在不断SAVE_PATH下面的权限。 / / / / / /请按提供的ASP.NET路径约定路径。 / / /你可以使用相对或绝对路径。 / / / / / /特殊情况： / / /是指wwwroot目录。 / / /。 /（不含空间后。）是目录下的FCExporter.aspx文件所在。 / / / / / /绝对路径： / / / / / /可以是这样的内容：“C： myFolders myImages” / / /（请千万不要使用单个反斜杠，因为这样会立刻停止执行的代码） / / /或“C：/ myFolders / myImages” / / / / / /你可能有一个/ /或月底的内容：“C： myFolders myImages ”或“C：/ myFolders / myImages /” / / / / / /你也可以混合斜线内容：“C： myFolders / myImages” / / / / / / / / / / / /目录下的文件所在FCExporter.aspx 私人 常量 字符串 SAVE_PATH = “/”。 ; / *请将您的文件夹路径在这里.* / / / / / / /注意：此常数HTTP_URI商店的HTTP引用 / / /将在出口图表将被保存的文件夹。 / / /请输入该文件夹的HTTP的代表性 / / /在此常数如/images/ / / / 私人 常量 字符串 HTTP_URI = “/images/” ; / *定义你的HTTP映射URL这里。 * / / / / / / / OVERWRITEFILE设置是否出口处理程序将覆盖现有文件 / / /新创建的导出的文件。 如果它被设置为false的处理程序将出口 / / /不会覆盖。 在这种情况下，如果设置为true INTELLIGENTFILENAMING处理程序 / / /将添加一个新的文件后缀名。 后缀是一个随机生成的GUID。 / / /此外，您添加一个额外的时间戳或作为后缀的随机数。 / / / 私人 布尔 OVERWRITEFILE = 虚假 ; 私人 布尔 INTELLIGENTFILENAMING = 真实 ; 私人 串 FILESUFFIXFORMAT = “时间戳” ; / /值可以是TIMESTAMP的或随机/ *定义文件在写，自动命名和命名后缀配置这里。* /如果J2EE的：打开fusioncharts_perties文件存在于类目录下，并有下列值的变化。请指定到一个文件夹有写权限相对web应用的根SAVEPATH = 。 /影像/这个常数HTTP_URI商店的HTTP引用 中在出口图表将被保存的文件夹。 请输入该文件夹的HTTP的代表性 在此常数如/images/HTTP_URI = 的HTTP ： / / /images/OVERWRITEFILE设置是否出口处理程序将覆盖现有文件 新创建的导出的文件。 如果它被设置为false的处理程序将出口不覆盖。 在这种情况下，如果设置为true INTELLIGENTFILENAMING处理程序会增加一个新的文件后缀名。 后缀是一个随机生成的UUID。此外，您可以添加额外的前缀作为时间戳或随机数。OVERWRITEFILE = 假INTELLIGENTFILENAMING = 真FILESUFFIXFORMAT = TIMESTAMP的如果在Rails上的Ruby：打开库/ FusionCharts的/出口商/ properties.rb和价值观有更改以下研究。 注意：您需要更改的文件夹位置 导出的图表图形/ PDF文件将被保存在您的 服务器。 请指定一个文件夹的路径与写在不断SAVE_PATH下面的权限。 此路径是相对于Web应用程序根 SAVEPATH = “。/图片/”用来作为消息显示在SWF这个常数HTTP_URI商店的HTTP引用 中在出口图表将被保存的文件夹。 请输入该文件夹的HTTP的代表性 在此常数如/images/ HTTP_URI = “/images/”= 开始 - 出口 设置 - - OVERWRITEFILE设置是否 出口 处理程序将覆盖现有文件 新创建的导出文件 。 如果 它 是 一套 以 虚假 的 出口 处理程序将 不 覆盖 。 在 此 情况下 ，如果 INTELLIGENTFILENAMING 是 设置 到 真正 的处理程序 会增加一个后缀为 新的 文件名 。 的 后缀 是 一个随机生成的UUID 。 此外 ， 添加时间戳 或 随机数 作为 额外的后缀 。 = 结束 值可以是真的还是假 OVERWRITEFILE = 假 值可以是真的还是假 INTELLIGENTFILENAMING = 真 值可以是“时间戳”或“随机” FILESUFFIXFORMAT = “时间戳”配置数据如前所述，我们只需要做的XML的以下变化： 这指示图表保存在服务器上导出的图像。请注意，我们还没有在这里提供一个文件名。如果没有提供，它采用FusionCharts的“默认值”。您可以但是，指定您的文件名称使用exportFileName属性元素。然而，因为在这种情况下，服务器路径可能已经有另外一个同名的文件名与中，发生以下条件的逻辑： 如果在服务器上的文件夹路径指定不有一个文件名称符合这个文件，图像/ PDF格式是使用这个文件的名称。 但是，如果另一个具有相同名称的文件存在，过写作是你是否已经改变了过度写在你的服务器端处理出口标志（如上所述）而定。o 如果你将其设置为yes，出口盲目处理过的旧文件写入。o 如果你没有设置，新的名称取决于您是否已经为智能自动命名选择。 如果是的话，新的名称是结合您的具体文件名决定的GUID + +时间戳或随机值（按价值选择） 如果自动命名设置为OFF（当过写设置为关闭也是），出口处理程序抛出一个错误，因为它没有任何选择了。设置回调处理程序现在，一切是设置，唯一剩下的就是定义一个JavaScript回调函数处理程序。此回调函数被调用时得到的图表从服务器发回一个响应 - 在成功和失败的案例。要指定你的回调函数，图表，您需要指定名称，功能exportCallback属性根据元素为：和您然后需要定义这个函数的JavaScript代码在您的。不过，如果你没有定义任何回调函数的功能在你的XML，默认回调FC_Exported被调用。在任何情况下，一个对象传递到与功能FC_Exported（objRtn）或myCallBackFunction（objRtn）， 其中包含以下参数（服务器返回）： 的StatusCode-有成功案例的价值在1和0的情况下失败。 statusMessage-在失败案件，这个参数包含了一个错误字符串描述（服务器返回） 文件名-如果储蓄是成功的，这个参数包含HTTP参考图像/ PDF文件保存在服务器 宽度和高度-如果储蓄是成功的，这些参数包含的宽度/图像高度的保存。否则，它们含有0。 DOMId- DOMId导出的图表成功。让我们快速看一个例子代码，其中一个回调函数已经落实。在这个例子中，一旦我们收到来自服务器的确认，我们只是表明它在一个JavaScript警告。 / /回调处理方法，该方法调用后图表已保存在服务器映像。 功能 FC_Exported （ objRtn ） 如果 （ objRtn 。 的StatusCode = “1” ） 警报 （ “图表是成功地保存在服务器的。访问的文件可以是” + objRtn 。 文件名 ）; 否则 警报 （ “图无法保存。在服务器上有一个错误：。描述” + objRtn 。 statusMessage ）; 图表将出现在这个div。 这些文字将取代图。 / /创建图表。 确保registerWithJS设置为1，否则回调不可能发生。 风险 myChart = 新 FusionCharts的 （ ././ FusionCharts/Column2D.swf“ ， “myChartId” ， “400” ， “300” ， “0” ， “1” ）; myChart 。 setXMLUrl （ “SaveData.xml” ）; myChart 。 渲染 （ “chartdiv” ）; 在上面的代码，注意默认FC_Exported方法被调用一次侧出口图表服务器完成。当您运行此代码，你会得到下面的输出。在这里，因为我们已经在网页只是一个图表，我们没有提出任何的if - then块检查DOMId的图表。不过，如果你在一个页面多个图表，您可以使用IF - THEN语句（字符串匹配的基础上DOMId）采取的行动不同的课程时，在每一页的图表已保存。1.3为PDF /映像“配置和上下文菜单的输出格式导出图表当您通过设置图表出口，图表上下文菜单显示所有可能的出口格式- JPEG，PNG和PDF格式，如下所示：但是如果你只需要选择显示格式或更改菜单项的标签，你可以根据它：属性格式，这是文件类型= Menu_Item_Label | File_Type2 = Menu_Item_Label2（项目相隔|字符;管道字符）。可能的文件类型的JPG，PNG和PDF格式。命令属性的值在指定的项目反映在菜单以及。上面的XML生成以下菜单（请注意更改或菜单项的顺序和名称）：隐藏的上下文菜单项如果你不希望出现任何相关的上下文菜单出口物品（例如，如果你只是想有出口触发使用的JavaScript），你可以设定：这将删除所有从上下文菜单中选择导出相关的项目。1.4为PDF /映像“配置对话框化妆品出口导出图表当图表中捕获的阶段，它显示了出口对话框如下图所示：此对话框可定制的化妆品使用以下属性：属性名称类型说明showExportDialog布尔（0 / 1）是否显示在捕获阶段导出对话框。如果不是，图表开始捕获过程中没有明显的对话。exportDialogMessage串该消息显示在对话框中。默认为“捕捉数据：”exportDialogColor十六进制颜色背景颜色对话框。exportDialogBorderColor十六进制颜色对话框的边框颜色。exportDialogFontColor十六进制颜色字体颜色将用于在对话框的文本。exportDialogPBColor十六进制颜色颜色对话框中的进度条。一个例子下面显示的是一个定制对话框：它在XML中的下列参数：2.图表导出为PDF或映像“客户端导出”概述出口过程中，当使用客户端导出处理程序，可以看作下：要素参与启用，在客户端的图表出口，我们需要组装下列内容：图表本身使用FusionCharts的嵌入式JavaScript类（FusionCharts.js）。在这里，我们假设你已经能够生成页面为您的图表。如果没有，请参考我们的文件的有关章节。FusionCharts的导出组件-这是名为FCExporter.swf，并在本下载包“图表。您需要复制粘贴此SWF到服务器。良好的地理位置将是此SWF主权财富基金的地方图表随着你。FusionCharts的导出组件JavaScript类-这个JavaScript类名为FusionChartsExportComponent.js，并在本下载包“ JSClass。的地位，它可以在放置在您的网站FusionCharts.js（虽然不是必要的，但是这可以帮助您集中所有FusionCharts的相关JS文件）因此，让我们很快上手，并设置一个简单的例子，出口作为在客户端图像图表。2.1图表导出为PDF或映像“客户端导出”简单的例子在这里，我们将讨论设立客户端的图表输出的例子。我们将首先从最简单的例子，然后将提前通过配置各种参数。在开始之前，您需要遵循以下步骤：1. 复制FusionChartsExportComponent.js从JSClass下载包“您的服务器。良好的地理位置是您放置FusionCharts.js2. 复制FCExporter.swf从图表下载包“您的服务器。良好的地理位置是您放置的SWF文件的其他图表。与该做，我们的下几个步骤是：1. 包括对出口商在你的网页组件的实例2. 配置图（XML）将通过指定它在这个出口的HTML组件的实例3. 开始出口让我们来看看如何实现他们在每一个细节。在网页中创建的导出组件的实例该组件实例的出口可以创建在你的网页很容易使用我们的FusionChartsExportComponentJavaScript类。所以，你首先需要根据包括在您的JavaScript类页面。确保包括这之后，页面FusionCharts.js中，为对象定义了一些这方面的参考文献类FusionCharts.js。这个包含顺序是很重要的。的 现在，使用这个类，你需要创建一个在您的页面组件的实例。为此，首先要定义一个空的DIV和命名，如下所示下：“ FusionCharts的出口id=fcexpDiv处理程序组件正如你可以看到上面的DIV被命名为fcexpDiv。请注意，您可以将这个div在页面的任何地方 - 它没有必要把它旁边的图表。然而，由于这种出口组件的用户界面显示一个按钮，启动出口，最好把附近的图表，以便用户可以识别它的某个地方。最后，你创建一个导出组件在页面的实例使用以下JavaScript代码：/ /注意：fcExporter1是DIV的ID和DOM的应作为exportHandler值指定/ /属性的图表的XML。风险myExportComponent =新FusionChartsExportObject（“fcExporter1”，././ FusionCharts的/ FCExporter.swf“）;/ /呈现在我们的DIV fcexpDiv出口的SWFmyExportComponent.Render（“fcexpDiv”）;在这里，我们首先创建一个实例FusionChartsExportObject，这是FusionCharts的导出组件JavaScript类的表示。对此，我们指定导出组件的实例DOM的标识本-fcExporter1在这种情况下。我们还指定参数位置的第二个组件的SWF文件作为。最后，我们调用渲染参数方法的类ID为我们的核实。这将生成一个实例的时候指定的DIV出口商组件在运行。虽然有更多的参数，你可以在此构造提供定制的化妆品和导出组件功能的行为，我们会到它们。页面的最终代码看起来下：的 id=chartdiv图表将出现在这个div。这些文字将取代图。/ /创建图表。/ /请注意，您一定要设置为1 registerWithJS属性，如用于客户端JavaScript是二手/ /之间的图表和FusionCharts的出口商组件端通信。风险myChart = (././ FusionCharts/Column2D.swf“，”myChartId新FusionCharts的“，”500“，”300“，”0“，”1“）;myChart.setXMLUrl（“SimpleExample.xml”）;myChart.render（“chartdiv”）;“ FusionCharts的出口id=fcexpDiv处理程序组件/ /呈现在这个导出组件/ /注意：fcExporter1是DIV的ID和DOM的应作为exportHandler值指定/ /属性的图表的XML。风险myExportComponent =新FusionChartsExportObject（“fcExporter1”，././ FusionCharts的/ FCExporter.swf“）;/ /呈现在我们的DIV fcexpDiv出口的SWFmyExportComponent.Render（“fcexpDiv”）;这就完成了在你的HTML所需要的代码。现在，我们只需要配置XML数据图表使用此出口的组成部分。配置的XML的客户端出口在XML，你需要做三件事情： 启用出口图表（使用exportEnabled属性） 将它设置为使用客户端出口（使用exportAtClient属性） 提供参考（DOM的ID）的组件创建的出口在使用你的HTML页面（即你exportHandler属性）下面的XML片段展示了如何实现这些： 当您现在火了你的HTML页面，您会看到根据屏幕。看，这是生活！屏幕由一个图表和一个小的等待它的按钮如下。这个按钮是UI组件出口的FusionCharts。默认情况下，它的启用，图表尚未出口的数据导出组件。出口的UI组件可以有两种模式-紧凑型或完整。你在这里看到的是紧凑模式按钮只用。我们将讨论定制这种模式下，数节和全模式研究。要在图表上点击开始出口，权利和选择“保存为JPEG“。你会看到图进入捕获阶段。一旦捕获阶段完成后，通过这个图表数据导出组件，从而对其进行处理，并使其可供下载。在此状态下，改变按钮的标题为“保存”，它得到启用，如下所示。当您单击此按钮现在，浏览器显示“另存为”对话框，允许您保存在您的硬盘驱动器出口图表输出。正如你可以在上面看到，下载为“图表FusionCharts.jpg“。如果你想改变的文件名，你可以指定它，在你的XML：请注意，您不必提供扩展在这里，因为这是延长在图表的过程中选择导出格式而定。现在，如果你想知道为什么出口组件需要一个单独的SWF文件，为什么它需要有一个用户界面，让我们的理解是一样的。FusionCharts的导出组件 - 为什么一个单独的用户界面？FusionCharts是在Flash 8中命中（AS2的）不支持字节流和文件下载。但是，Flash 10（AS3的）不支持相同。因此，要获得两全其美，出口组件已在Flash 10编码（AS3的）能够处理图像/ PDF格式建设（使用字节流），并允许在相同的下载。图表之间的桥梁和出口FusionCharts的组件是JavaScript。因此，我们始终要求您设置registerWithJS为一图表，并运行服务器）文件从一个服务器（无论是本地主机，或远程，为Flash播放器，默认情况下，块JavaScript通讯文件系统运行时从当地。现在，如果你想知道为什么我们不能启动图像自动下载/ PDF格式的导出组件，而不需要点击一个按钮，让我们解释一下。在Flash播放器，以允许文件下载，最终用户需要一定的Flash互动电影，启动下载。这样做是为了避免做任何痛苦，“恶”的网络电影。因此，出口组件提供了一个按钮，点击，从而启动下载。正如我们前面提到的，导出组件有两种模式 - 紧凑和完整模式。完整的模式有一个大大提高用户界面，其中你可以选择每个图表格式，或者作为一个单一的下载文件中的所有图表。稍后我们将介绍在批量导出部分。在此之前，让我们快速通过为紧凑模式自定义选项一目了然。自定义导出组件的用户界面出口组件提供广泛的UI自定义选项。在这里，我们将看到一些选项的基本配置。整个名单中可以找到部分组件的用户界面定制。考虑下面的代码：“ FusionCharts的出口id=fcexpDiv处理程序组件/ /呈现在这个导出组件/ /注意：fcExporter1是DIV的ID和DOM的应作为exportHandler值指定/ /属性的图表的XML。风险myExportComponent =新FusionChartsExportObject（“fcExporter1”，././ FusionCharts的/ FCExporter.swf“）;/ /自定义组件的属性/ /宽度和高度myExportCponentAttributes.width = 400;myExportCponentAttributes.height = 60;/ /背景颜色myExportCponentAttributes.bgColor =ffffdd;/ /边框属性myExportCponentAttributes.borderThickness = 2;myExportCponentAttributes.borderColor = 0372AB;/ /字体属性myExportCponentAttributes.fontFace =宋体;myExportCponentAttributes.fontColor = 0372AB;myExportCponentAttributes.fontSize = 12;/ /消息 - 标题的导出组件myExportCponentAttributes.showMessage = 1;myExportCponentAttributes.message =导出图表，然后再点击这个按钮来保存;/ /按钮的视觉配置myExportCponentAttributes.btnWidth = 200;myExportCponentAttributes.btnHeight = 25;myExportCponentAttributes.btnColor =E1f5ff;myExportCponentAttributes.btnBorderColor = 0372AB;/ /按钮字体属性myExportCponentAttributes.btnFontFace =宋体;myExportCponentAttributes.btnFontColor = 0372AB;myExportCponentAttributes.btnFontSize = 15;/ /标题的按钮myExportCponentAttributes.btnsavetitle =保存图表的myExportCponentAttributes.btndisabledtit