资源调用

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

 

用户ID

 

pwdpw

 

密码.采用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地址的参数时,特殊字符要转义。

附件列表

8

文档内容仅供参考
如果您需要解决具体问题,还可以登录亿信社区
在提问求助板块提问,30分钟内帮您解决问题

如果您认为本词条还有待完善,请编辑

上一篇如何实现i从BI取数

下一篇i与第三方系统用户同步

请先登录