常见问题

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

[IFIntegrationUtils logInto:DEFAULT_SERVERNAME serverUrl:url withUsername:username andPassword:password success:^{
    //第二步，登录成功，加载目录树
    [IFIntegrationUtils loadReportTree:^(NSArray *reportsArray) {
        //第三步，根据目录树和报表的树结构数组，创建自定义目录树，关于返回的数据结构在下面详细介绍。
    } failure:^(NSString *msg) {
    } isObj:YES];
} failure:^(NSString *msg) {
	//登录失败的处理
}];

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

[IFIntegrationUtils logout];

[IFOEMUtils removeDemoServer];

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

[IFOEMUtils removeAbout];

[IFOEMUtils setAppVersion:(NSString *) version];//设置版本号
		[IFOEMUtils setCopyright:(NSString *) copyRight];//设置版权信息
		[IFOEMUtils setAppIconName:(NSString *) iconName];//设置关于页面里的图标。

[IFOEMUtils setMessageHandler:(void (^) (NSString *message, BOOL isSuccess)) handler];

[IFOEMUtils setAppSettingBarButtonItem:(UIBarButtonItem *) settingItem];

[IFIntegrationUtils createTable];

IFFrameAppSettingViewController *settingViewController = [[IFFrameAppSettingViewController alloc] initWithCustomItems:customItems];

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];

//首先登录
[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) {
	//登录失败
}];

//AppDelegate.m
//App启动的时候，设置好本机信鸽的access id、access key(第一步中拿到的)
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
	[IFOEMUtils setXinGeAppId:123456788];	//access id
	[IFOEMUtils setXinGeAppKey:@"ISHGJ5A7342D"];//accesskey
	//do somethigs
	return YES;
}

- (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{
	// 处理推送消息
}

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

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];	//加载报表

-(void)pushHyperLink:(UIViewController *)viewController withAnimate:(BOOL)animate {
//处理报表View超级链接产生的视图控制器。
}

//注意，如果url里有中文或者//这种特殊字符，需要在生成URL之前，做一次encode（[string stringByAddingPercentEscapesUsingEncoding:NSUTF8StringEncoding]）
NSURL *url = [NSURL URLWithString:@"FineReport://"];
//NSURL *url = [NSURL URLWithString:@"com.fr.FineReport://"]; //也可以这样写
//NSURL *url = [NSURL URLWithString:@"com.fr.FineReport://?serverName=test&serverUrl=xxxxxx&fr_username=a&fr_password=123"]; //传递服务器地址、服务器名、用户名、密码, 注意url特殊字符要encode
//以上参数也可以通过JSON传递，如下
//NSURL *url = [NSURL URLWithString:@"com.fr.FineReport://{\"serverName\":\"xxxxx\", \"serverUrl\":\"http://xxxxx\", \"fr_username\":\"a\", \"fr_password\":\"123\"}"]
//需要注意以下三种情况
//1. serverName已存在，并且serverUrl相同，则使用提供的用户名密码登陆
//2. serverName已存在, 但是serverUrl不同，则会提示"服务器同名"
//3. serverName不存在, 会添加该服务器，并且登陆

[[UIApplication sharedApplication] openURL:url];
 

UIBarButtonItem *setting = [[UIBarButtonItem alloc] initWithTitle:@"设置" style:UIBarButtonItemStylePlain target:self action:@selector(setting)];  
 
[IFOEMUtils setAppSettingBarButtonItem:setting];

- (void) setting {
  //定义一个注销按钮
  IFFrameAppSettingItem *logoutItem = [[IFFrameAppSettingItem alloc] initWithTitle:@"注销" andAction:^(UITableViewCell *selectedCell) {
    //注销
    [IFIntegrationUtils logOut];
    //让页面消失，这里需要写一个获取当前最前端视图（当前就是设置界面）的方法，后面会有示例，也可以把设置页面在类里定义成变量能引用到。
    [[self topViewControllerWithRootViewController:[UIApplication sharedApplication].delegate.window.rootViewController] dismissViewControllerAnimated:YES   completion:nil];
  }];
 
  //把自定义注销按钮放在数组里，后面给创建设置页面使用
  NSArray *logOutSection = [[NSArray alloc] initWithObjects:logoutItem, nil];
  NSArray *customItems = [[NSArray alloc] initWithObjects:logOutSection, nil];
 
  //定义设置页面
  IIFFrameAppSettingViewController *settingViewController; = [[IFFrameAppSettingViewController alloc] initWithCustomItems:customItems];
  
  //根据手机/Pad设置不同的弹出方式
  BOOL isPhone = [[UIDevice currentDevice] userInterfaceIdiom] == UIUserInterfaceIdiomPhone;
  UIViewController *topViewController = [self topViewControllerWithRootViewController:[UIApplication sharedApplication].delegate.window.rootViewController];
  if(isPhone) {
    [topViewController.navigationController pushViewController:settingViewController animated:YES];
  } else {
    UINavigationController *navigationController = [[UINavigationController alloc] initWithRootViewController:settingViewController];
    navigationController.modalPresentationStyle = UIModalPresentationFormSheet;
    [topViewController presentViewController:navigationController animated:YES completion:nil];
  }
}
//获取当前顶部视图
- (UIViewController*)topViewControllerWithRootViewController:(UIViewController*)rootViewController {
  if ([rootViewController isKindOfClass:[UITabBarController class]]) {
    UITabBarController* tabBarController = (UITabBarController*)rootViewController;
    return [self topViewControllerWithRootViewController:tabBarController.selectedViewController];
  } else if ([rootViewController isKindOfClass:[UINavigationController class]]) {
    UINavigationController* nav = (UINavigationController*)rootViewController;
    return [self topViewControllerWithRootViewController:nav.topViewController];
  } else if (rootViewController.presentedViewController) {
    UIViewController* presentedViewController = rootViewController.presentedViewController;
    if([presentedViewController isKindOfClass:[UIAlertController class]]) {
      return rootViewController;
    }
    return [self topViewControllerWithRootViewController:presentedViewController];
  } else {
    return rootViewController;
  }
}