Cognos学习之五：前端与服务器参数传递

前端与服务器参数传递
Cognos的内容一般作为网页中某一特定的帧或者一个新开的窗口来展现的。我们可以在外部统一的用户交互界面中收集用户递交的查询条件（一般用JSP实现），在检查完用户输入的有效性之后，把这些参数按照Cognos约定的标准，以POST（或者GET）的方式传到某一帧中的Cognos的网关。Cognos网关就会把用户查询的结果返回到该帧中。
根据后端服务器的不同（PPES和IWR），有两种参数传递的规则。
调用PPES上的内容（CUBE/PPX）
        主要用到的参数变量有
参数名称        解释
DC        报表的展示方式，Q为动态HTML，R为PDF
E        访问内容在PPES上的发布位置
DM        需要过滤的维度Code值
FC        过滤的维度对应过滤值的category code
ZZ        表示参数传递结束

下面是一个接口调用的实例：
        假设服务器名称为：servername
        ppx报表发布到enterprise server之后在enterprise server的根目录下，名称为：testreport
        如果我们要对这个报表进行访问，可通过如下url对报表进行调用：http://test/cognos/ cgi-bin/ppdscgi.exe?DC=R&E=%2Ftestreport
如果用户要求访问的是一个可动态分析的cube，那么相应的url为
http://test/cognos/ cgi-bin/ppdscgi.exe?DC=Q&E=%2Fcubename
其中：%2F是一个URL使用的转意符，它的原型是符号“/”。
如果报表或Cube是发布于一个文件夹test中的，那么相应的url为：
http://test/cognos/ cgi-bin/ppdscgi.exe?DC=R&E=%2Ftest%2Ftestreport

通过以上的接口可以访问到任意发布到Powerplay Enterprise Server的报表或Cube。如果要向报表或Cube传递过滤条件，可采用下面的调用标准。
        例如在Enterprise Server发布有报表ICBC，该报表开放了四个传参接口（Years，Products，Locations，Channles）。用户可以选择向其中的某几个接口传参。
        如果选择“Products”为“Outdoor Products”则调用
        http://test/cognos/cgi-bin/ppdsc ... 20Products&ZZ=X
        其中&DM=Products                                                          //表示要过滤维度Products
&FC=0%09Outdoor%20Products                                        //表示维度Products的过滤值
               
        如果是过滤两个维度，例如过滤“Products”和“Locations”则调用
http://info/cognos/cgi-bin/ppdsc ... 1%09Europe&ZZ=X
其中&DM=Products%09Locations                                        //维度间用%09分开
&FC=0%09Outdoor%20Products%091%09Europe        //维度值从0开始标号

如果是过滤三个维度，例如过滤“Products”和“Locations”及“Channels”则调用
http://info/cognos/cgi-bin/ppdsc ... ndependent&ZZ=X
其中&DM=Products%09Locations%09Channels                        //维度间用%09分开
&FC=0%09Outdoor%20Products%091%09Europe%092%09Independent
//维度值从0开始标号
在每条Url后添加&ZZ=X,表示参数传递结束。
注意：维度名称和维度过滤值都必须用各自的code属性，而不是name属性。
调用IWR上的内容
        IWR接受参数的网关是/cognos/cgi-bin/imrap.cgi，接受的参数可分为两类：
1）        报表参数：主要是指定IWR服务器，报表编号等
2）        条件参数：主要传递用户的过滤条件。

报表参数有
参数名称        解释
RID        这是 Report 的序号，从 IWR Server Admin 中可以查到
IU        这是保留参数，固定取值 IMRAP
CD        这是报表展现方式，R 是 Run，V 是 View
PSRV        这是保留字符串，可以从任意报表的 URL 中获得
       
条件参数一般根据IWR报表的用户prompt来订，一般需要和cognos PowerPrompts中Script Manager中的设定一致。

例如上面的Script Editor中<%GetUserVar(“t10”)%>，表示要向网关imrap.cgi传递条件参数t10，然后这个参数值会作为报表的Promptu值（通过语句SetPromptValue）来过滤报表的数据。
        下面是一个IWR参数传递的例子，为了说明问题，用一个HTML来传递需要的参数，实际环境中，往往是用JSP动态决定需要传递的参数。