BOE中opendocument的使用

BusinessObjects Enterprise XI

如何使用<openDocument -- URL命令参数>

-----------------------------------------------------------------------------------------------------

 概述

这个文档包含如何使用<openDocument -- URL命令参数>去调用已经发布到BusinessObjects Enterprise XI 系统的报表。使用URL命令参数可以很容易地将Enterprise XI 集成到Web应用程序和门户网站中，而不必深入了解 底层的 软件开发套件（the underlying SDK）.

-------------------------------------------------------------------------------------------------------

目录

 介绍 ----------------------------------------------------------------------------------2

         背景---------------------------------------------------------------------------2

 确定平台信息---------------------------------------------------------------------------2

         查询生成器---------------------------------------------------------------------2

 openDocument参数-----------------------------------------------------------------------4

         没有文档化的openDocument参数 --------------------------------------------------4

                单点登录----------------------------------------------------------------4

         平台参数  ---------------------------------------------------------------------4

         已经废弃的参数 ----------------------------------------------------------------6

  输入参数------------------------------------------------------------------------------6

         为OLAP Intelligence report targets指定提示信息---------------------------------11

         理解OLAP上下文 ----------------------------------------------------------------11

         OLAP Intelligence中使用的约定--------------------------------------------------12

                    成员参数的语法 -----------------------------------------------------12

                    成员集参数的语法 ---------------------------------------------------12

                    cube参数语法 -------------------------------------------------------13

                    page参数的语法 -----------------------------------------------------13

  输出参数 -----------------------------------------------------------------------------14

  最佳实践 -----------------------------------------------------------------------------15

           集成Universes ---------------------------------------------------------------15

           使用库自定义函数 ------------------------------------------------------------15

  了解更多信息 -------------------------------------------------------------------------16

--------------------------------------------------------------------------------------------------------

介绍

 这个文档列出了openDocument命令参数以及这些命令参数如何使用。它也说明了一些最佳实践，并且显示了和这个技术相关的帮助文档的地方。

 

典型的URL语法是;

JAVA-

http://<hostname>:<port>/businessobjects/enterprise11/desktoplaunch/opendoc/openDocument.jsp

COM- 

http://<hostname>:<port>/businessobjects/enterprise11/InfoView/scripts/opendocument.aspx

默认情况下，Enterprise XI使用<主机名>作为服务器名。Tomcat Web服务器端口号为8080，IIS Web服务器端口号为80(90是默认的HTTP端口，可以省略)。

 

例如：服务器名为“paris”的URLs:

TOMCAT- 

http://paris:8080/businessobjects/enterprise11/desktoplaunch/opendoc/openDocument.jsp

IIS- 

http://paris/businessobjects/enterprise11/InfoView/scripts/opendocument.aspx

重要提示	在本文档余下的部分，都会以“openDocument.jsp”来代替完成URL路径

 

背景

在BusinessObjects Enterprise XI中，你能够使用<openDocument URL命令参数>去生成展现报表和其它已经发布到Enterprise XI系统的文档。

 

<openDocument command>替换了用于之前版本中viewrpt.cwr。

 

确定平台信息 

        查询生成器

        Enterprise XI存储了大量信息。这个为什么Enterprise XI包括了Web应用，查询生成器(Query Builder)(是一个查询平台)。这个应用能在“Enterprise XI管理启动板”的左侧找到。查询生成器能帮助你确定哪些值，那些值呢?那些你用于构建完整的openDocument URL所需要的值。

 

        下图，图1，展示一个用典型的查询语句输入到它里面的查询生成器的外观。

图1：查询生成器

在上图中，查询返回已经发布到Enterprise XI系统的Web Intelligence文档的Name, ID, Cluster ID和Package ID。

 

select SI_NAME, SI_ID, SI_CUID, SI_RUID FROM CI_INFOOBJECTS WHERE SI_KIND = 'Webi' 

 

在BusinessObjects Enterprise XI SDK"Query Language Reference"章节中，详细说明了完整的语法。

可以在下面的"Finding more information"部分找到引用。

 

openDocument参数

没有文档化的openDocument参数

下列参数被openDocument支持，但是在Enterprise XI相关的文档中没有写

 

单点登录

OpenDdocument 支持单点登录(SSO)。为了实现SSO,openDocument 首先会检查 被称为ISEnterpriseSession的会话(session)变量是否有效(这个变量包含Enterprise XI 会话(session))。如果这个HTTP会话变量不可用,那么openDocument将检查新的token参数(token参数往往用于传递会话标识符的token)。当Session被创建或者通过ILogonTokenMgr.getDefaultToken()API，这令牌被返回。

参数名	参数说明	是否必须	参数接受的值
token	包含用户会话标记，当前CMS 会话的有效登录标记。	否	当前CMS 会话的登录标记。

 

平台参数

Enterprise XI提供了两个选项引用资源：

Enterprise XI 平台资源的ID

Enterprise XI平台资源的名字(资源名和文件夹路径连接到一起可以消除分歧，eg，避免同名资源名)

openDocument介绍了一种新的方法来识别目标文件。在BusinessObjects Enterprise 6.x中,是使用目标文档名称、标识符ID和存储库类型的组合来指向正确的文档。在Enterprise XI中,名称识别(name identification)仍然可用,但是一个更灵活的方式引来用文档是基于已经介绍过的Enterprise XI InfoObject标识符(identifier)。

• Identifier(ID)
• Cluster identifier(CUID)
• Package identifier(RUID)
• Global identifier(GUID)

(The choice is dependant on your deployment)选择取决于您的部署。无论如何，当以编程的方式生成URLs,资源名字是不健壮的

参数名称	说  明	是否必须	值
token	包含用户Session认证的token文本	否	Token文本
iDocID	文档的ID	是，但可以用sDocName来代替	文档ID (InfoObjectID)
sIDType	CMS对象ID类型	是，如果不使用默认文档ID(InfoObjectID)	GUID RUID InfoObjectID(默认)
sType	目标文档或报表的类型	是。但对于未知的文件类型忽略(xls, doc, txt,等)	wid rpt car
sPath	包含目标文档的目录和子目录的名字 本参数是与sDocName一起使用的	否	目录和子目录
sDocName	不带有扩展名的文档名称 这个参数与sPath一起使用	否
sReportName	在一个文档中包含多个报表的时候决定那一个报表打开（默认的时候处于激活的报表优先打开）	否
lsS[NAME]	指定提示的单个值。[NAME] 是提示的文本	否	一个单值参数的值
lsM[NAME]	指定提示的多个值。[NAME] 是提示的文本。	否	多只参数的各个值用逗号“,”分开。