【cognos 8教程第十六讲】URL后参数的含义

来源：互联网发布：金山打字mac 编辑：程序博客网时间：2024/04/29 17:17

启动报表的方法有两种：

1：通过url的方式：

http://server/cognos8/cgi-bin/cognos.cgi?b_action=xts.run&m=portal/launch.xts&ui.tool=CognosViewer&ui.action=run&ui.object=/content/package[@name='GOSales and etailers']/folder[@name='Report Studio Report Samples']/report[@name='Banded Report']

2：通过cognosLaunch函数

cognosLaunch("ui.gateway","http://server/cognos8/cgi-bin/cognos.cgi","ui.tool","CognosViewer","ui.action"
,"run","ui.object","/content/package[@name=\'GO Sales and Retailers\']/report[@name=\'Banded Report\']")

使用这个方法的时候必须先吧js文件引入进来：

url方式中的重点：

如果你想使用url的方式，必须带上下面两种方式中的参数。

如果你想启动Cognos Connection请使用以下的url方式：

http://server/cognos8/cgi-bin/cognos.cgi?b_action=xts.run&m=portal/cc.xts

如果你想启动的是其他的任何组件，如Report Studio等，使用以下的url：

http://server/cognos8/cgi-bin/cognos.cgi?b_action=xts.run&m=portal/launch.xts&接下来的就是其他具体组件的参数，在下面会介绍。还有m=portal/report-viewer.xts是报表的

基本参数有下面几种：

gateway：必须的，cognos8的网关地址，这里是http://server/cognos8/cgi-bin/cognos.cgi?.

b_action=xts.run：必须的，

m=portal/component_name.xts：必须的，不同的组件有不同的名称

m_object=defaultOutput(<report_search_path>)：指定保存在内容存储库中的报表的路径。(这个还没确定，没看见有使用的地方，还没测试)

登录时的url方式：

?b_action=xts.run&m=portal/main.xts&h_CAM_action=logonAs&CAMUsername=Administrator&CAMPassword=

退出时的参数

?b_action=xts.run&;m=portal/logoff.xts&h_CAM_action=logoff

cognosLaunch函数方式的重点：

如果想使用函数的方式来启动，就要使用如下的方法：

cognosLaunch("ui.gateway"," gateway ","ui.tool","component")；

ui.gateway：cognos的网关。例如http://server/cognos8/cgi-bin/cognos.cgi?

ui.tool：指定要打开哪个组件，上面的例子是CognosViewer。还有ReportStudio，QueryStudio，AnalysisStudio，MetricStudio，EventStudio，PowerplayStudio（在url中也用）

ui.object：指定要打开的报表等组件的搜索路径。（在url中也用）

其他一些共通的参数

ui.backURL：指定进入报表后的“返回”按钮链接的地址，这个地址只能是cognos同个域名里的地址，例如不能链接到www.baidu.com。还有在等待报表打开的时候，点这个按钮，返回的也是指定的这个地址。

ui.folder：指定目标文件夹。可能的值是content manager中的查询路径或store ID。（没测出来具体的应用，可能是制定报表保存的默认路径，还有一个可能是打开指定的文件夹，用处不是特别大）

ui.action：指定采取的行动。可接受的值是new或edit，默认是new，new是新建一个报表，edit是编辑一个已经存在的报表，当设置为new的时候，即使指定了ui.object也还是会打开新的Report Studio。对cognos view来说可能的值是run和view。默认值是view。这参数对Event Studio.来说是必须的，但你不能把他使用在Metric Studio中。（还看不出有什么区别）

ui.drillThroughTargetParameterValues：

m_path:指定打开的文件夹，但要注意m=portal/cc.xts，不能是m=launch.xt

开始report Studio

http://server/Cognos8/cgi-bin/cognos.cgi?b_action=xts.run&m=portal/launch.xts&ui.gateway=http://server/Cognos8/cgi-bin/cognos.cgi&ui.tool=ReportStudio&ui.object=/content&ui.action=new

上面这个url的含义是创建一个新的report Studio，这里的ui.gateway是必不可少的，ui.action表示打开一个新的，当设置为new的时候，即使指定了ui.object也还是会打开新的Report Studio。

指定一个包：

在report Studio中编辑

http://server/Cognos8/cgi-bin/cognos.cgi?b_action=xts.run&m=portal/launch.xts&ui.gateway=http://server/Cognos8/cgi-bin/cognos.cgi&ui.tool=ReportStudio&ui.object=/content&ui.action=edit&ui.object=/content/package[@name='GO Sales and Retailers']/folder[@name='Report Studio ReportSamples']/report[@name='Banded Report']")

开始Query studio

http://server/Cognos8/cgi-bin/cognos.cgi?b_action=xts.run&m=portal/launch.xts&ui.tool=QueryStudio&ui.object=/content&ui.action=new

打开一个新的Query studio

其他可选的参数

ui. header: 指定是否显示头部，可能的值是false或true。False：把头部的蓝条去掉了，上面有回到主页等链接。

ui.spec：

run.outputLocale：指定输出的语言。格式为：language-region，是RFC3066标准，默认的值是en-us。

run.prompt：可以的值是false或true。Specifies whether the report service issues prompts, so you can enter report option values.

Use the following parameters for debugging purposes only:（使用下面的参数是为了调试）：

run.outputFormat：指定输出格式，输出格式有：CSV, HTML, HTMLFragment, MHT, PDF, singleXLS, XHTML, XLS, XLWA, and XML.

run.xslURL：

run.outputEncapsulation：

async.attachmentEncoding：

async.primaryWaitThreshold：

async.secondaryWaitThreshold：

打开报表时指定包：

http://server/Cognos8/cgi-bin/cognos.cgi?b_action=xts.run&m=portal/launch.xts&ui.tool=QueryStudio&ui.object=/content/package[@name='GOSales and Retailers']&ui.action=new

打开一个指定的Query Studio

http://server/Cognos8/cgi-bin/cognos.cgi?b_action=xts.run&m=portal/launch.xts&ui.tool=QueryStudio&ui.object=/content/package[@name='GOSales and Retailers']/folder[@name='New Reports']/query[@name='A Report by Product Type']&ui.action=edit

开始Analysis Studio还有MetricStudio ，EventStudio。

你可以再Analisis Studio中打开指定的报表。例子：

http://server/Cognos8/cgi-bin/cognos.cgi?b_action=xts.run&m=portal/launch.xts&ui.gateway=http://server/Cognos8/cgi-bin/cognos.cgi&ui.tool=AnalysisStudio&ui.object=/content&ui.action=new

指定包新建

打开指定的Analysis Studio还有MetricStudio ，EventStudio。

开始Cognos Viewer

http://server/Cognos8/cgi-bin/cognos.cgi?b_action=xts.run&m=portal/launch.xts&ui.tool=CognosViewer&ui.action=view&ui.object=defaultOutput(/content/package[@name='GO Sales and tailers']/folder[@name='Report Studio Report Samples']/report[@name='Banded Report'])

还有一种方案是：

?ui.action=run&cv.toolbar=false&cv.header=false&b_action=xts.run&m=portal/report-viewer.xts&method=execute&m_obj=