FastReport Online Designer工作原理

Online Designer可以與FastReport.Net的Win+Web版，專(zhuān)業(yè)版，企業(yè)版中的FastReport.Net WebReport對(duì)象一起使用。
在線設(shè)計(jì)器可以改變報(bào)表的報(bào)告和事件處理程序的腳本，但默認(rèn)情況下，出于安全原因，該選項(xiàng)被禁用。該功能可在WebReport對(duì)象的屬性中來(lái)啟用。當(dāng)這個(gè)選項(xiàng)在腳本內(nèi)容中被禁用，之后的設(shè)計(jì)將被忽略被原來(lái)的文本替換。此外，為了安全起見(jiàn)，我們不發(fā)送Designer中內(nèi)置的連接字符串。

1.  WebReport對(duì)象在ASP.NET頁(yè)面加載。
2. WebReport發(fā)送一個(gè)Ajax請(qǐng)求到FastReport的處理程序，以獲得在iframe環(huán)境的在線設(shè)計(jì)器容器（報(bào)表設(shè)計(jì)器的代碼被放置在應(yīng)用程序站點(diǎn)的一個(gè)單獨(dú)的文件夾里）。
3.  當(dāng)在線設(shè)計(jì)器在瀏覽器中加載，它發(fā)送AJAX查詢到處理程序以獲取報(bào)表模板（getReportByUUIDFrom）。
4. 服務(wù)器應(yīng)用程序準(zhǔn)備并發(fā)送一個(gè)報(bào)表模板到在線設(shè)計(jì)器。
5. 設(shè)計(jì)器可以請(qǐng)求預(yù)覽當(dāng)前報(bào)表，通過(guò)發(fā)送請(qǐng)求到服務(wù)器中的處理器（makePreviewByUUID）。服務(wù)器應(yīng)用程序運(yùn)行收到的報(bào)表，并以html返回結(jié)果。然后設(shè)計(jì)器在預(yù)覽窗口顯示出來(lái)，該預(yù)覽可以打印或以多種格式導(dǎo)出。
6. 設(shè)計(jì)器可以通過(guò)帶有報(bào)表內(nèi)容的AJAX查詢（saveReportByUUIDTo）將報(bào)表保存在服務(wù)器中。服務(wù)器應(yīng)用程序準(zhǔn)備接收數(shù)據(jù)并發(fā)送請(qǐng)求到應(yīng)用程序的回?fù)茼?yè)面。

WebReport對(duì)象存在服務(wù)器緩存中的時(shí)間有限，然后從存儲(chǔ)器中被刪除。對(duì)象在內(nèi)存中的保存時(shí)間由WebReport.CacheDelay屬性決定，以分鐘計(jì)算（默認(rèn)情況下是60）。

>>FastREport Online Designer立即在線體驗(yàn)   

Online Designer的設(shè)置指南：

1. 首先，從安裝路徑復(fù)制帶有在線設(shè)計(jì)器的文件夾（默認(rèn)：WebReportDesigner）到Web應(yīng)用程序根的目錄。

2.然后檢查WebReport功能所需的處理程序設(shè)置文件web.config：
IIS6:

< system.web>
…
< httpHandlers>
< add path="FastReport.Export.axd" verb="*" type="FastReport.Web.Handlers.WebExport"/>
< /httpHandlers>
< /system.web>

IIS7:

< system.webServer>
< handlers>
< add name="FastReportHandler" path="FastReport.Export.axd" verb="*"
type="FastReport.Web.Handlers.WebExport"/>
< /handlers>
< /system.webServer>

3.然后檢查Web/ ReportDesigner/scripts/ cofig-data.js文件中的報(bào)表設(shè)計(jì)器的設(shè)置：

'getReportByUUIDFrom': '/FastReport.Export.axd?getReport=',
'saveReportByUUIDTo': '/FastReport.Export.axd?putReport=',
'makePreviewByUUID': '/FastReport.Export.axd?makePreview=',

這些參數(shù)應(yīng)包含F(xiàn)astReport處理器相對(duì)于網(wǎng)站的根目錄的路徑。如果路徑與所寫(xiě)不同，必須要糾正，例如：

'getReportByUUIDFrom': '/oursite/FastReport.Export.axd?getReport=',

4. 當(dāng)WebReport用于ASPX標(biāo)記中，你需要將對(duì)象拖拽到頁(yè)面上并設(shè)置其屬性。對(duì)于MVC，你需要在控制器中寫(xiě)入代碼：

4.1. 啟用報(bào)表的編輯功能：

webReport.DesignReport = true;

4.2. 設(shè)置的唯一對(duì)象名稱(chēng)WebReport，必要時(shí)可以在回調(diào)頁(yè)面設(shè)置可進(jìn)一步可區(qū)分的對(duì)象名稱(chēng)：

webReport.ID = "MyDesignReport1";

4.3. 在在線設(shè)計(jì)器中禁止報(bào)表的腳本編輯，或者如果你想啟用編輯功能 - 設(shè)置為true即可：

webReport.DesignScriptCode = false;

4.4. 指定報(bào)表設(shè)計(jì)器的主文件的路徑，將帶有設(shè)計(jì)器的文件夾復(fù)制到網(wǎng)頁(yè)應(yīng)用程序的適當(dāng)位置：

webReport.DesignerPath = "~/WebReportDesigner/index.html";

4.5. 設(shè)置網(wǎng)頁(yè)上的回調(diào)頁(yè)面路徑，該調(diào)用在報(bào)表被保存到臨時(shí)文件夾后執(zhí)行。例如：MVC的視圖路徑（你需要專(zhuān)門(mén)在控制器中創(chuàng)建一個(gè)新的相同名稱(chēng)的空白視圖來(lái)執(zhí)行回調(diào)）：

webReport.DesignerSaveCallBack = "~/Home/SaveDesignedReport";

或ASPX示例:

webReport.DesignerSaveCallBack = "~/DesignerCallBack.aspx";

下面是GET請(qǐng)求發(fā)送的參數(shù)：

reportID="here is webReport.ID"&reportUUID="here is saved report file name"

在這兒的reportID對(duì)應(yīng)WebReport.ID對(duì)象，并且名為reportUUID的文件被存儲(chǔ)在臨時(shí)文件夾中。開(kāi)發(fā)人員執(zhí)行進(jìn)一步的操作，將報(bào)表保存到磁盤(pán)，數(shù)據(jù)庫(kù)或云存儲(chǔ)中。在保存后，名為reportUUID的臨時(shí)文件必須從臨時(shí)文件夾刪除。也可以使用POST查詢來(lái)回調(diào)報(bào)表文件的回?fù)苻D(zhuǎn)移，性情見(jiàn)下面的4.6。
回調(diào)頁(yè)的示例代碼如下。

4.6設(shè)置在執(zhí)行回調(diào)前用來(lái)保存編輯后的報(bào)表的臨時(shí)文件夾的路徑，該文件夾必須設(shè)置寫(xiě)入權(quán)限：

webReport.DesignerSavePath = "~/App_Data/DesignedReports";

你也可以設(shè)置屬性webReport.DesignerSavePath為空字符串以激活POST模式。

4.7. 在服務(wù)器緩存中設(shè)置WebReport對(duì)象的生命周期，以分為單位，默認(rèn)時(shí)間為60：

webReport.CacheDelay = 120;

5.創(chuàng)建一個(gè)回調(diào)頁(yè)面來(lái)保存編輯后的報(bào)表。

5.1. 如果你使用的是ASPX布局，你需要在Page_Load事件處理程序添加以下代碼：

protected void Page_Load(object sender, EventArgs e)
{
string reportID = Request.QueryString["reportID"];
string reportUUID = Request.QueryString["reportUUID"];
// 1. ReportID value identifies the object that caused the designer. The value
corresponds to the property webReport.ID, which was filled by a call of the designer.
// 2. Combining the path that we have filled in the property webReport.DesignerSavePath,
and the resulting reportUUID, we get the path to the temporary file with edited report.
// 3. This file can be opened and saved in the right place for us to drive or the cloud
or in a database.
// 4. The temporary file must be deleted after saving.
}

5.2. 在MVC標(biāo)記中，你需要在控制器和空視圖中創(chuàng)建一個(gè)方法。控制器中的代碼如下：

public ActionResult SaveDesignedReport(string reportID, string reportUUID)
{
// 1. ReportID value identifies the object that caused the designer. The value
corresponds to the property webReport.ID, which was filled by a call of the designer.
// 2. Combining the path that we have filled in the property webReport.DesignerSavePath,
and the resulting reportUUID, we get the path to the temporary file with edited report.
// 3. This file can be opened and saved in the right place for us to drive or the cloud
or in a database.
// 4. The temporary file must be deleted after saving.
return View();
}

在處理POST傳送時(shí)需要在控制器前添加[HttpPost] ，如下：

[HttpPost]
 public ActionResult SaveDesignedReport(string reportID, string reportUUID)
{
...
}

5.3. 你可以通過(guò)webReport.DesignerLocale=“EN”屬性使用在線設(shè)計(jì)器的任何本地化版本; （"en" 可以更改為其它任何支持的語(yǔ)言，支持的語(yǔ)言的完整列表存放在設(shè)計(jì)器分發(fā)包中的文件中）。
當(dāng)創(chuàng)建回調(diào)頁(yè)保存報(bào)表的處理器時(shí)應(yīng)特別注意過(guò)濾和檢查收到的Get請(qǐng)求的參數(shù)。務(wù)必確認(rèn)它們?yōu)閚ull。
在線設(shè)計(jì)器對(duì)象的最好放置地方是在頁(yè)面的底部。推薦的寬度為100％或至少930px像素。對(duì)象的高度建議設(shè)置至少600px。

如有任何疑問(wèn)請(qǐng)咨詢""。