1. 登录接口
通过此登录接口可完成登录并直达指定功能界面的功能
适用版本：4.1.x-4.2.x, 具体参数对应的版本文档中有说明。
1.1 调用接口
<SERVERURL>/oemlogin.do?id=<ID>&pw=<PW>&target=<TARGET> 其中serverurl是i@Report服务器的访问路径。例如：
服务器访问地址是：
http://192.168.1.199:8080/irpt/i/main.jsp
则接口地址为：
http://192.168.1.199:8080/irpt/oemlogin.do
1.2 接口参数
本接口的参数如下表：
参数名 | 取值 | 说明 | 支持版本 |
|---|---|---|---|
id |
| 用户ＩＤ |
|
pwd或pw |
| 密码.采用MD5值的密文方式。(明文也行) |
|
target | 支持以下参数值 |
|
|
| server | 表示登录服务器，转向"服务器管理"页面 |
|
| logs | 表示登录后转向日志管理 |
|
| users | 表示登录后转向服务器用户管理 |
|
| msg | 表示登录后转向通知管理 |
|
| taskgroups | 表示登录后转向任务组管理 |
|
| taskgroup | 表示登录grp参数指定的任务组 |
|
| task | 表示登录task参数指定的任务 |
|
| rpts | 表示登录task参数指定的任务，并直接打开bbq参指定的报表期数据．要想打开数据不允许修改，传递readolny=true；打开指定的报表，传递参数rpts，例 如：rpts=XXB,B0表示只显示XXB和B0表 | i4.2.2开始，该功能由target=task替代 |
| bbs | 表示登录后跳转到在线交流页面 | i4.2.x, build 17094开始支持 |
| bullet | 表示登录后跳转到公告页面 | i4.2.x, build 17094开始支持 |
| bbhlist | 表示登录后跳转到报表户管理页面 | I4.2.2BUILD30187及i4.3, build 20524开始支持 |
proc |
| 存储过程名，在登录后，跳转到相应页面前执行存储过程，为空不执行存储过程 详情参考： | I4.2.2BUILD_27270开始支持 |
grp |
| 任务组代码. 适用于有taskgroup参数时 |
|
task |
| 任务ID或GUID . 适用于有task参数时 |
|
bbq |
| 报表期。只有在task参数存在时才有效。 必须是合法的8位报表期字串。传递此参数时，会自动打开插件查看对应报表户的数据 |
|
curbbhid |
| 当前登录户的报表户id。只有在task参数存在时才有效。 如果无此参数，则取当前登录者代表的当前报表户。 当登录用户对某个任务有多个报表户身份时，需要指定此参数 |
|
curbbhtype |
| 当前登录户的报表户类型。只有在task参数存在时才有效。 如果无此参数，默认为0。 |
|
userid |
| 要查看的报表户id。只有在task参数存在时才有效。 如果无此参数，则取当前登录者代表的报表户。 如果当前登录户为汇总户，需要打开一户基层户数据，需要指定此参数。 | I4.2.2BUILD27287 |
btype |
| 要查看的报表户类型。只有在task参数存在时才有效。 如果无此参数，则取当前登录者的报表户类型。 | I4.2.2BUILD27287 |
upid |
| 只有在userid,btype存在时有效，当指定打开户不在报表户列表中时，且上级不是当前报表户时，需要指定该参数 | I4.2.2BUILD27287 |
bbhlistname |
| 是任务组名或任务ID．只有在target=bbhlist时此参数才可用 | I4.2.2BUILD30187-i4.3 |
listbbq | true|false | 是否进入数据填报户界面。只对汇总户有效。 当指定了bbq参数，又想查看指定bbq下所有的填报户情况，可以使用此参数为true。 |
|
readonly | true|false | 只有bbq参数存在且没有listbbh参数时才有效。 以只读方式打开插件查看数据 | |
forcelogin | true|false | 表示是否总是登录。 通常，通过oemlogin登录后，不会再重新登录，以提高响应速度。指定此参数后，则每次访问oemlogin都再重新登录一下 |
|
dataset | 数据集名 | 指定允许访问的数据集名，用逗号分隔，且当前数据集为指定的第一个数据集. 如果为空，则默认当前数据集为main，且有权限访问其它数据集。例如：dataset=main,GS表示有权限访问主数据集和国税数据集，且当前数据 集为main. | i4.2.x, i4.3 |
showtab | 汇总户页面指定显示的TAB | 进入汇总户页面专用。showtab=1为列表显示，showtab=2为树型显示，如果不设置，按任务的属性设置来显示 | i4.2.2_BUILD27975 |
jscmd | 汇总户树型页面调用的JS命令 | 如果任务未设置默认显示树型，需要配合参数showtab=2使用。暂时仅支持jscmd=locateBbh("xxx","x")，执行在树型上定位到某一户，并打开该户数据，如定位到汇总户110000,设置jscmd=locateBbh("110000","9") | i4.2.2_BUILD27975 |
noframe | true|false | -禁用框架包裹界面。 (--本参数在build 26882以上版本作废)- | <build 26881 |
* 没有注明支持版本的参数，默认支持的所有i版本．
* 对于BI为主I为辅的单点登录环境，id和pw可以不用传，但要forcelogin=false. 这样只需要在BI中登录就行了。
1.3 应用示例
要登录后显示任务组列表界面，
http://192.168.1.199:8080/irpt/oemlogin.do?id=xx&pw=yy&target=taskgroups 要想登录后显示任务列表界面，
http://192.168.1.199:8080/irpt/oemlogin.do?id=xx&pw=yy&target=taskgroup&grp=ZDSY 要想登录后进入任务界面，
http://192.168.1.199:8080/irpt/oemlogin.do?id=xx&pw=yy&target=task&task={EE311463-E596-425E-9288-F14507A2B015}.dbfbdeb331c76d8233e78379af54dc22] 要想登录后打开指定报表期的数据，
http://192.168.1.199:8080/irpt/oemlogin.do?id=xx&pw=yy&target=task&task={EE311463-E596-425E-9288-F14507A2B015}.dbfbdeb331c76d8233e78379af54dc22&bbq=200802-- 要想登录后直接进入插件页面查看数据，该链接与上一个链接的区别在于，该链接主要是用于查询数据的功能，设置readonly=true后，插件菜单不显示，即使不设置readonly参数，也只能执行插件修改数据、上报等基本功能。如果需要全面使用报表户对数据管理的功能，需要使用上面的链接（target=task）,bbq参数不指定时，默认显示任务的最佳报表期。showmenu=true表示默认展开插件菜单
http://192.168.1.199:8080/irpt/oemlogin.do?id=xx&pw=yy&target=rpts&task={EE311463-E596-425E-9288-F14507A2B015}.dbfbdeb331c76d8233e78379af54dc22&bbq=200802-- 如果登录才是服务器用户或汇总户，要想登录后打开指定报表户指定报表期的数据，
http://192.168.1.199:8080/irpt/oemlogin.do?id=xx&pw=yy&target=task&task={EE311463-E596-425E-9288-F14507A2B015}.dbfbdeb331c76d8233e78379af54dc22&userid=2300043434&btype=0&bbq=200802-- 要想登录后自动进入组织机构与用户权限管理界面，
http://192.168.1.199:8080/irpt/oemlogin.do?id=xx&pw=yy&target=users 要想登录后自动进入在线交流：
http://192.168.1.199:8080/irpt/oemlogin.do?id=xx&pw=yy&target=bbs 要想登录后自动进入公告：
http://192.168.1.199:8080/irpt/oemlogin.do?id=xx&pw=yy&target=bullet 要想登录后自动进入报表户管理界面：
http://192.168.1.199:8080/irpt/oemlogin.do?id=xx&pw=yy&target=bbhlist&bbhlistname=ZDSY 要想登录后自动进入汇总户界面树型显示并定位到某一户：
http://192.168.1.199:8080/irpt/oemlogin.do?id=xx&pw=yy&target=task&task={EE311463-E596-425E-9288-F14507A2B015}.dbfbdeb331c76d8233e78379af54dc22&bbq=201106--&listbbq=true&showtab=2&jscmd=locateBbh("410802X15028102","0") 2 任务列表界面接口
采用此接口可直接进入任务组显示任务列表。
适用版本：4.2.2
2.1 调用接口
<SERVERURL>/i/tras/tasklist.do?grpName=<GROUP> 注意：此URL接口使用前需要登录
2.2 接口参数
url中<GROUP>参数是指定任务组标识。
2.3 应用举例
例如，要使用户登录后直接进入某任务组的任务列表界面，则在"服务器管理"下的"服务器首页"设置中，设置首页地址为：
main/index.jsp?curl=tras/tasklist.do%3FgrpName=ZDSYRWZ 其中，tasklist.do后面的?号要转义成%3F。当一个url作为另一个url地址的参数时，特殊字符要转义。
3 填报界面接口
采用此url接口可直达填报界面。
适用版本：4.2.2
3.1 调用接口
<SERVERURL>/i/main/listbbq.do?taskId=<TASKID> 注意：此URL接口使用前需要登录
3.2 接口参数
url中<TASKID>参数是具体填报任务的taskid值或guid值（guid需要build30186支持）。
3.3 应用举例
例如，要使用户登录后直接进入某任务的填报界面，则在"服务器管理"下的"服务器首页"设置中，设置首页地址为：
main/index.jsp?curl=main/listbbq.do%3FtaskId={B18E3DC6-B494-4D0E-82FC-DDA3EF34AF8D}.d2381a21552a34159c262cb2a76263ad 其中，listrbbq.do后面的?号要转义成%3F。当一个url作为另一个url地址的参数时，特殊字符要转义。
请先登录