客戶有自己的app,希望把我們的移動端功能集成到他們的app裡面去,而不需要安裝兩個app。Android端和IOS端的集成接口是不一樣的,下面就通過圖表(長尾)FineReport來簡單介紹一下。
工具/原料
圖表(長尾)FineReport7.1.1
大小:148.2M 適用平臺:windows/linux
IOS端集成App
資源準備
準備好IOS端集成FineReport App的資源文件,包括自己的IOS工程、FineReport提供的資源包。
點擊IOS.zip下載FineReport提供的集成資源包,解壓至文件夾中,可以看到如下圖所示的文件:
其中FRDemo和FRDemo_目錄樹是示例demo,說明文件夾中是使用說明,剩下的三個文件夾才是集成時需要依賴的資源包。
framework&bundle:裡面包含了真機和模擬器集成時所需要的framework和bundle資源文件,圖片資源(IFImages.xcassets);
WeiXinSDK:微信的SDK;
BaiduMap:百度地圖的SDK
FRDemo:集成示例,可以通過設置服務器地址,報表路徑,加載報表,即直接通過URL訪問報表;
FRDemo_目錄樹:集成示例2,可以登錄服務器,展示目錄樹,即通過發送用戶名密碼進行驗證,驗證成功之後直接顯示FineReport的主頁或者目錄樹。
資源導入
在自己的項目中導入資源文件framework&bundle\模擬器\FineResource.bundle,添加framework&bundle\IFImages.xcassets到項目中,並在Build Phases——Link Binary With Libraries中添加下圖所示的lib包:
其中FineSoft.framework是FineReport提供的資源文件,在解壓文件夾的framework&bundle\真機\FineSoft.framework目錄下。
同時,在項目中添加前面下載資源中的微信SDK和百度SDK,如下圖:
集成使用FineReport App
資源都導入配置完成之後,就需要集成App了,IOS端集成App有兩張方式,一個是直接通過URL集成服務器上的模板,另外一個是通過發送用戶名密碼至服務器,驗證通過之後,顯示FineReport目錄樹。
直接URL集成
直接URL集成報表,就是通過URL鏈接直接訪問FineReport服務器上的報表。
在項目中使用IFEntryViewController加載報表,根據報表路徑,服務器路徑,預覽類型創建IFEntryViewController對象。
引入頭文件:
#import
根據服務器地址和報表路徑生成IFEntryViewController:IFEntryViewController *entryVC = [[IFEntryViewController al-loc] initWithPath:path ServerUrl:url]:
reportPath:報表路徑,如app/DetailedDrillA-phone.cpt;
serverUrl:服務器地址,如http://192.168.1.100:8075/WebReport/ReportServer;
viewType:預覽類型,可選值有IFEntryViewTypePage(分頁預覽),IFEntryViewTypeWrite(填報預覽),可選用,默認為分頁預覽;
parameters:報表傳遞的參數,可選用;
如果上述四個接口全部使用,則其使用方法為:- (id)initWithPath:(NSString *)reportPath serverUrl:(NSString *)serverUrl viewType:(IFEntryViewType)viewType parameters:(NSDictionary *) params;
比如說URL集成一張在線app demo下的表單,直接預覽,不傳遞參數,代碼如下:
IFEntryViewController *entryVC = [[IFEntryViewController alloc] initWithPath:@"app/sales/orders.frm" serverUrl:@";];
集成目錄樹查看模板
集成目錄樹,就是指發送用戶名密碼至服務器驗證之後,訪問系統的目錄樹,查看系統下的所有模板。
在項目中使用IFEntryViewController加載報表。
其接口代碼如下:
引入頭文件
#import
#import
登錄服務器
[IFFrameUtils logInto:DEFAULT_SERVERNAME serverUrl:url withUsername:username andPassword:password success:^{
//登錄成功,加載目錄樹
[IFFrameUtils loadReportTree:^(NSMutableArray *reportsArray) {
//加載成功,展示目錄樹
IFFrameDirectoryViewController *directoryVC = [[IFFrameDirectoryViewController alloc] initWithReportsArray:reportsArray];
[self.navigationController presentViewController:directoryVC animated:YES comple-tion:nil];
} failure:^(NSString *) {
}];
} failure:^(NSString *) {
}];
登錄服務器的各個參數含義:
serverName:服務器名稱,如Demo服務器;
serverUrl:服務器地址,如http://192.168.1.100:8075/WebReport/ReportServer;
username:用戶名;
password:密碼;
success:登錄成功的回調函數(一般是加載目錄樹);
failure:登錄失敗的回調函數。
其各個參數的使用方法為:+ (void)logInto:(NSString *) serverName serverUrl:(NSString *)serverUrl withUsername:(NSString *)username andPassword:(NSString *)password success:(void (^)())success failure:(void (^)(NSString *))failure;
比如說集成在線app demo工程的目錄樹,代碼如下:
#import
#import
//登錄服務器
[IFFrameUtils logInto:@"Demo服務器" serv-erUrl:@"; withUsername:@"demo" andPassword:@"demo" success:^{
//登錄成功,加載目錄樹
[IFFrameUtils loadReportTree:^(NSMutableArray *reportsArray) {
//加載成功,展示目錄樹
IFFrameDirectoryViewController *directoryVC = [[IFFrameDirectoryViewController alloc] initWithReportsArray:reportsArray];
[self.navigationController presentViewController:directoryVC animated:YES comple-tion:nil];
} failure:^(NSString *) {
}];
} failure:^(NSString *) {
}];
注意事項
1、需要配合FR7.1.1版本使用;
2、提供的示例FRDemo只能在真機上運行,如需在模擬器上運行,請替換framework&bundle/模擬器中的framework和bundle文件;
3、如果遇到百度地圖的集成c文件衝突報錯,可以將other linker flags中的-all_load改為-ObjC。
webView裡打開原生報表
如果集成的方式是從webView上的html元素事件觸發,打開原生報表,那麼需要自定義WebView繼承UIWebView,並重寫- (BOOL) webView:(UIWebView *)webViewT shouldStartLoadWithRequest:(NSURLRequest *)request navigationType:(UIWebViewNavigationType)navigationType方法來實現。原理就是分析url,如果url是報表類型,就用EntryViewController打開報表。
示例可見:
- (BOOL) webView:(UIWebView *)webViewT shouldStartLoadWithRequest:(NSURLRequest *)request navigationType:(UIWebViewNavigationType)navigationType {
if(navigationType != UIWebViewNavigationTypeLinkClicked) {
return YES;
}
NSString *urlString = [[request URL] absoluteString];
NSMutableDictionary *urlDict = [IFFrameUtils analysisUrl:urlString];
if([urlDict contain:KEY_URL]) {
//說明是普通超鏈
IFWebViewController *toWebView = [[IFWebViewController alloc] initWithUrl:[urlDict objectForKey:KEY_URL]];
toWebView.title = @"鏈接";
[self iFPushVC:toWebView animated:YES];
} else {
//說明是報表類型的超鏈
IFEntryViewType viewType = IFEntryViewTypePage;
if([[urlDict objectForKey:KEY_OP] isEqualToString:KEY_VIEWTYPE_WRITE]) {
viewType = IFEntryViewTypeWrite;
}
IFEntryViewController *entryVC = [[IFEntryViewController alloc] initWithPath:[urlDict objectForKey:KEY_PATH] serverUrl:[urlDict objectForKey:SERVERURL_KEY] viewType:viewType];
entryVC.title = urlDict[KEY_PATH];
[self iFPushVC:entryVC animated:YES];
}
return NO;
}
測試
FineReport提供一個Demo地址供測試。
服務器地址:www.finereporthelp.com:8889/app/ReportServer;
用戶名:demo;
密碼:demo;
可用報表路徑:app/DetailedDrillA-phone.cpt app/para-phone.cpt app/DetailedDrill-pad.cpt app/parapad.cpt app/sales/sales.frm app/sales/map.frm app/sales/saleseffects.frm app/sales/TOP6-pad.frm app/sales/product.frm app/sales/SWOT.frm app/sales/orders.frm app/sales/abc.frm app/financial/FinaceStatistic.frm app/Operations/area.frm
如想查看更多示例效果,可聯繫相關集成人員。
Android集成app
資源準備
準備好需要集成FineReport App的Android工程,並下載FineReport提供的集成資源包。
點擊android.zip,下載資源包,將其解壓,得到如下圖所示幾個文件:
將解壓出來的libs目錄和res目錄拷貝需要集成的Android工程項目中,並將libs目錄下的JAR包和armeabi目錄作為依賴庫引用到Android開發工程中,如下圖:
修改AndroidManifest.xml文件
打開自己工程下的AndroidManifest.xml文件,並將解壓出來的FineReport提供的AndroidManifest.xml中的內容寫入到自己工程下的配置文件中
集成使用FineReport App
FineReport Android App提供了2種類型的接口:直接使用url訪問服務器上的模板,以連接的形式集成至自己的App當中,另外一種是使用目錄入口集成,即通過驗證用戶名密碼,登錄到FineReport App的主頁或者目錄頁。
URL直接集成
使用URL集成. 直接使用URL訪問服務器工程模板,比如說我們想要集成服務器下的WorkBook2.cpt模板,並且是填報的形式,那麼,代碼如下:
Intent intent = new Intent();
intent.putExtra("url",";op=write");
intent.setClass(this, IntegrationActivity.class);
startActivity(intent);
注:op=write表示參數op為write填報模式,正常預覽模板,不需要添加op參數。
使用目錄歡迎入口集成
使用目錄歡迎入口集成,直接登陸報表主頁或者目錄就相當於將FineReport的App嵌入到自己的App當中,當需要進入到FineReport App的時候,只需要發送相應的用戶名密碼驗證即可登錄到FineReport App的主頁或者目錄頁當中,接口如下:
Intent welcomeIntent = new Intent(this, LoadAppFromWelcomeActivity.class);
welcomeIntent.putExtra("username", "demo"); // 數據決策系統 用戶名
welcomeIntent.putExtra("password", "demo"); // 數據決策系統 用戶密碼
welcomeIntent.putExtra("serverIp", ";); // 數據決策系統 地址ip
welcomeIntent.putExtra("serverName", "demo服務器"); // 數據決策系統 名稱
startActivity(welcomeIntent);
注:如果服務器系統中設置了主頁,那麼登錄完成之後就跳轉到主頁,如果沒有設置主頁,就直接顯示目錄頁。