Page History

OEM的原理是让定制开发的项目的AppDelegate继承FR移动端的AppDelegate（FineSoft/IFAppDelegate.h），在启动App前完成定制，可参考如下代码：

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { [IFOEMUtils setCopyright:@"test"]; [IFOEMUtils removeDemoServer]; [IFOEMUtils addServerWithName:@"MyServer" andURL:@"http://www.finereporthelp.com:8889/app/ReportServer" addUsername:@"demo" addPassword:@"123"]; [super application:application didFinishLaunchingWithOptions:launchOptions]; return YES; }

示例

以上说明都可以在FRDemo工程中看到示例，在main.m类中，更改Delegate可以切换一般集成（AppDelegate）和OEM集成（AppDelegate4OEM）。

常见问题

1. 如何根据报表路径创建带有参数的报表？

[IFEntryViewController initWithPath:(NSString *)reportPath serverUrl:(NSString *)serverUrl viewType:(IFEntryViewType)viewType parameters:(NSDictionary *) params];

其中：
	reportPath为报表的磁盘路径，如@"mobile/test.cpt"；
	serverUrl为报表所在服务器路径；viewType为报表类型，可分为IFEntryViewTypePage（分页）和IFEntryViewTypeWrite（填报），如果是表单可传nil；
	params为需要传递的参数，可为nil。

2. 如果购买了决策系统，在移动端想查看决策系统的报表，又不想用FR默认的目录树结构，如何定制自己的目录树？

//第一步，登录服务器
[IFIntegrationUtils logInto:DEFAULT_SERVERNAME serverUrl:url withUsername:username andPassword:password success:^{
    //第二步，登录成功，加载目录树
    [IFIntegrationUtils loadReportTree:^(NSArray *reportsArray) {
        //第三步，根据目录树和报表的树结构数组，创建自定义目录树，关于返回的数据结构在下面详细介绍。
    } failure:^(NSString *msg) {
    } isObj:YES];
} failure:^(NSString *msg) {
	//登录失败的处理
}];
下面详细介绍下服务器返回的目录树结构数组reportsArray：
reportsArray数组里的元素类型都是IFEntryNode；
IFEntryNode可以是文件夹，也可以是具体报表，可以通过方法[node isFolder]来判断；
如果node是文件夹，可以通过[node children]方法来获取文件夹下的子元素数组，仍然为IFEntryNode的数组对象；
如果node是报表类型，可以通过[[IFEntryViewController alloc] initWithEntry:node]的方式创建出报表视图控制器，并展示报表。

3. 如何获取决策系统里已经收藏的报表？

//第一步，登录服务器
[IFIntegrationUtils logInto:DEFAULT_SERVERNAME serverUrl:url withUsername:username andPassword:password success:^{
    //第二步，登录成功，获取收藏夹报表数组
    [IFIntegrationUtils favorites:^(NSMutableArray *favorites) {
    	//第三步，根据收藏夹报表自定义展示页面
    } failure:^(NSString *message) {
    }];
} failure:^(NSString *msg) {
}];
获取的收藏夹报表数组，一样全是IFEntryNode对象，可以采取一样的方式展示报表。

4. 如何在集成的App里使用微信分享功能？

可参考微信开放平台中的iOS接入指南：

5. 怎么登出服务器？

[IFIntegrationUtils logout];

6. OEM定制的App，都支持定制哪些内容？

a. 因为OEM是一个新的工程，可以设置App的图标和名称，因此不需要调用额外的接口就能达到修改App图标和名称的目的；

b. 第一次打开App时，默认服务器列表的定制：

1.	删除FR的默认服务器：

		[IFOEMUtils removeDemoServer];
2.	增加一个默认服务器：

		[IFOEMUtils addServerWithName:(NSString *)serverName andURL:(NSString *)serverURL addUsername:(NSString *)username addPassword:(NSString *)password userEditable:(BOOL)userEditable];

		serverName：服务器名称；			

		serverURL：服务器地址；

		username：默认用户名（可为空）；

		password：默认密码（可为空）；

		userEditable：用户名，密码，以及服务器名称地址是否允许用户修改。

c. 关于页面的定制：

...

h），在启动App前完成定制，

1.oem集成的主界面与app的主界面一致，有服务器列表

Image Added

2.oem集成定制服务器列表等等。在AppDelegate4OEM.m文件里面完成，如下图

Image Added

开放的oem接口在IFOEMUtils.h文件中均可以查看到.

3.一些接口:

Code Block

/*
 增加服务器，如果同名服务器存在不会添加
 @param serverName 服务器名称
 @param serverURL 服务器地址
 @param username 用户名
 @param password 密码
 @param userEditable 默认用户是否可以编辑 默认为YES
*/
+ (void) addServerWithName:(NSString *)serverName andURL:(NSString *)serverURL addUsername:(NSString *)username addPassword:(NSString *)password userEditable:(BOOL)userEditable;

/*
 增加服务器，如果同名服务器存在不会添加
 @param serverName 服务器名称
 @param serverURL 服务器地址
 @param username 用户名
 @param password 密码
*/
+ (void) addServerWithName:(NSString *) serverName andURL:(NSString *) serverURL addUsername:(NSString *) username addPassword:(NSString *) password;

/*
 根据服务器名称和服务器地址删除服务器
 @param serverName 服务器名称
 @param serverURL 服务器地址
*/
+ (void) removeServer:(NSString *) serverName serverURL:(NSString *) serverURL;

/*
 删除FR内置的Demo服务器
*/
+ (void) removeDemoServer;

/*
 去掉关于页面
*/
+ (void) removeAbout;

/*
 设置App的版本，会显示在关于界面
*/
+ (void) setAppVersion:(NSString *) version

...

;

/*
 设置版权信息
*/

...


+ (void) setCopyright:(NSString *) copyRight

...

;

/*
 设置关于界面里展示的图片名字
*/

...


+ (void) setAppIconName:(NSString *) iconName

...

;

/

...

d. App内默认消息提醒样式的定制：FR内默认消息提醒采用顶部出现会自动消失的蓝色（正常提示消息）或红色（错误/警告消息）提醒消息。如果想使用符合自己App风格的提示消息，可以使用：

...

**
 * 设置处理通知消息的方法
 */
+ (void) setMessageHandler:(void (^) (NSString *message, BOOL isSuccess)) handler

...

e. App右上角为设置按钮，支持放置自定义按钮：

	[IFOEMUtils setAppSettingBarButtonItem:(UIBarButtonItem *) settingItem];
	settingItem：设置按钮。

7. 集成时如何支持报表离线预览

首先，在AppDelegate中的didFinishLaunchingWithOptions方法创建离线所需要的数据库表：

[IFIntegrationUtils createTable];

然后，使用第6个问题中，自定义右上角设置按钮的方式，创建自定义的设置按钮，点击事件打开FR内置的设置界面

IFFrameAppSettingViewController *settingViewController = [[IFFrameAppSettingViewController alloc] initWithCustomItems:customItems];
customItems:是个二维数组，设置界面中除了离线相关的按钮外，还可以自己添加按钮，元素类型为一组关联的设置按钮组，按钮类型为：IFFrameAppSettingItem。
例如：添加一个注销按钮：
IFFrameAppSettingItem *logoutItem = [[IFFrameAppSettingItem alloc] initWithTitle:@"注销" andAction:^(UITableViewCell *selectedCell) {
    [IFIntegrationUtils logOut];
    [self dismissViewControllerAnimated:YES completion:nil];
}];
NSArray *logOutSection = [[NSArray alloc] initWithObjects:logoutItem, nil];
NSArray *customItems = [[NSArray alloc] initWithObjects:logOutSection, nil];
IFFrameAppSettingViewController *settingViewController = [[IFFrameAppSettingViewController alloc] initWithCustomItems:customItems];

8. 如何让App支持修改密码

说明：如果用户是管理员，则任何时候可修改密码；如果服务器是同步数据集或者开启了http认证/ldap认证，则是不支持修改密码的。符合条件后，可以通过如下方式修改密码：

//首先登录
[IFIntegrationUtils logInto:DEFAULT_SERVERNAME serverUrl:url withUsername:username andPassword:password success:^{
	//登录成功后通过此方法获知服务器是否支持修改密码
    if([IFIntegrationUtils canChangePassword]) {
    	//这时候，需要2个参数，原始密码和新密码；这边可以写自己的修改密码让用户输入，比对2次输入是否相同等。假如这边已经拿到原始密码originalPassword和新密码newPassword，则调用
    	[IFIntegrationUtils changePassword:originalPassword newPassword:newPassword success:^{
    		//修改成功
		} failure:^(NSString *message) {
			//修改失败，旧密码有误
		}];
    } else {
    	//服务器不支持修改密码
    }
} failure:^(NSString *msg) {
	//登录失败
}];

9. 如何在集成的App里支持信鸽推送？

首先需要到信鸽开发中心上注册自己的App，关于证书和程序绑定，上面都会有详细的教程。

注册完成后，会得到三个和App相关的参数：ACCESS ID，ACCESS KEY，SECRET KEY。

客户端需要调用接口来注册程序的ACCESSID和ACESSKEY

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
	[IFOEMUtils setXinGeAppId:123456788];	//access id
	[IFOEMUtils setXinGeAppKey:@"ISHGJ5A7342D"];//accesskey
	//do somethigs
	return YES;
}

如果是OEM集成，客户端做这些就可以了。如果是一般集成，在AppDelegate中还需要做如下注册信鸽的设置：

- (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken { 
	NSString * deviceTokenStr = [XGPush registerDevice:deviceToken];
	[XGPush registerDevice:deviceToken];
	[IFIntegrationUtils setDeviceToken:deviceTokenStr];//必须，在程序里记录设备。
}
- (void)application:(UIApplication *)application didRegisterUserNotificationSettings:(UIUserNotificationSettings *)notificationSettings
{
	[application registerForRemoteNotifications];
}
- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo{
	// 处理推送消息
}

服务器端也需要借助信鸽推送插件来做相应的设置，设置好scretKey和accessId。

完成这些后，定时任务发送的推送即可被集成App收到。

10. 如何获取报表在服务器端配置的封面图？

在通过IFIntegrationUtils loadReportTree方法获取到IFEntryNode数组后，对每一个entryNode，使用

[IFIntegrationUtils readEntryImage:entryNode.entryId coverId:entryNode.coverId sucess:^(UIImage *image) {
        //image就是服务器端配置的缩略图，这个方法是做过缓存处理的，不用担心每次都会向服务器发请求。
}];

11. 如何展示非全屏的报表 说明：目前不支持填报报表的非全屏展现，只支持单页分页/表单的展现

IFEntryView *entryView = [[IFEntryView alloc] initWithPath:@"app/DetailedDrillA-phone.cpt" serverUrl:@"http://www.finereporthelp.com:8889/app/ReportServer" viewType:IFEntryViewTypePage parameters:nil];
[entryView setFrame:CGRectMake(0, 64, 800, 600)];
entryView.entryViewDelegate = self;
[self.view addSubview:entryView];
[entryView doLoad];	//加载报表

使用报表视图的对象，需要实现IFEntryViewDelegate中的方法，让报表正常展示

-(void)pushHyperLink:(UIViewController *)viewController withAnimate:(BOOL)animate {

//处理报表View超级链接产生的视图控制器。

}

12. 如何支持国际化

1.打开工程，supporting files目录下新建Localizable.strings国际化基础文件，(demo里面的目前仅支持中文简体，中文繁体及英文语言环境(chinese simple,chinese traditional,english))。详细教程见:http://blog.sina.com.cn/s/blog_7b9d64af0101jncz.html或者网上搜索ios如何国际化.

2.需要支持国际化的东西，则在对应语言里写上key和翻译就可以。例如:

NSString * myKey = NSLocalizedString(@"MY_KEY",nil);

此时，myKey这个字符串在不同语言环境下的key就是"MYKEY".然后去Localizable.strings(english)文件中添加一行"MYKEY"="my key";在Localizable.strings(chinese(simple))文件中添加一行"MYKEY"="我的关键词";同理在繁体文件中添加key对应的翻译。在不同的语言环境下，myKey显示的文字就是"MYKEY"对应的翻译

13. 集成时APP名称怎么支持国际化

...

/**
 * 自定义app设置按钮
 */
+ (void) setAppSettingBarButtonItem:(UIBarButtonItem *) settingItem;

/**
 保持Pad上一级目录树菜单始终显示在左侧
 */
+ (void) keepFolderLeftOnPad;

/**
 把首页放置到一级目录树上显示
 @param image:首页的缩略图
 */
+ (void) putHomePageOnFolderWithImage:(UIImage *) image;

/**
 * 设置是否需要报表缩略图
 */
+ (void) setNeedReportScreenshot:(BOOL) needReportScreenshot;

//设置信鸽推送中使用到的appId
+ (void) setXinGeAppId:(uint32_t) appId;

//设置信鸽推送中使用到的appKey
+ (void) setXinGeAppKey:(NSString *) appKey;

//一级目录上自定义快捷方式
+ (void) addNodeOnFolder:(NSString *) nodeName withImage:(UIImage *) image andUrl:(NSString *) url serverURL:(NSString *) serverUrl;

//是否支持收藏
+ (void) setSupportFavorite:(BOOL) isSupportFavorite;

//设置是否显示主目录下左上角的返回按钮
+ (void)setShowMainMenuLeftBackButton:(BOOL)show;
 
//设置是否开启更新检测
+ (void)setUpdateEnable:(BOOL)enable;

/**
 * 设置获取版本信息json的url
 * json格式:
 * {
 *      "version":2,
 *      "url":"itms-services://?action=download-manifest&url=http://xxxxxx.plist"
 *      "description":"xxxxxxx" // 描述内容
 * }
 * @param url
 */
+ (void)setOEMCheckVersionUrl:(NSString *)url;
 
/**
 * 设置登录超时接口
 * @param timeoutHandler 登录超时回调函数，通过返回的BOOL判断是否消费此次事件
 *
 */
+ (void)setTimeOutHandler:(BOOL (^)(NSString *message, NSString *exception))timeoutHandler;
 
/**
 * 屏蔽暂存功能接口,默认是开启的
 */
+ (void)removeTemporaryStorage;

Page tree

Versions Compared

Old Version 2

New Version Current

Key

示例

常见问题