IBM Cognos 最佳实践: 在 IBM Cognos Express Report Studio 中启用 Browsing for Images

文档性质:技巧或技术;产品;IBM Cognos Express;关注领域:基础架构

本文档的目标是:概括介绍通过启用 WebDAV HTTP 扩展来使用 IBM Cognos Express Report Studio 中的 “Browsing for Images” 特性的几种不同方法。

Cognos Proven Practices Team, Cognos 最佳实践团队, IBM

Cognos 最佳实践团队。



2012 年 5 月 10 日

免费下载:IBM® Cognos® Express V9.5 或者 Cognos® 8 Business Intelligence Developer Edition V8.4 试用版
下载更多的 IBM 软件试用版,并加入 IBM 软件下载与技术交流群组,参与在线交流。

简介

目的

本文档的目标是:概括介绍通过启用 WebDAV HTTP 扩展来使用 IBM Cognos Express Report Studio 中的 “Browsing for Images” 特性的几种不同方法。

适用性

本文档适用于 IBM Cognos Express version 9.0 和 9.5。


背景知识

IBM Cognos Express Report Studio 中的 Browsing for images 特性需要一项名为 WebDAV 的技术支持,才能在 IBM Cognos Express 终端(应用程序服务器或 Web 服务器)上使用。

术语 Web-based Distributed Authoring and Versioning (WebDAV) 指的是对 Hypertext Transfer Protocol (HTTP) 的一系列扩展,充许您以协作方式管理远程 Web 服务器(如 IBM HTTP Server、Microsoft 的 Internet Information Server (IIS) 和 Apache Tomcat 应用程序服务器)上的文件。在本质上它为用户提供了一个框架,允许创建、更改和移动文件。关于该主题的更多技术信息,已超出本文档范围,请参考 RFC 4918。

在 IBM Cognos Express 中,WebDAV 作为 IBM Cognos Express Report Studio 中的一项特性,它能让 Report Authors 对想要插入报告中的所有图片进行简单的 “单击浏览” 操作,就像在文件系统中浏览一样。这样做的好处是,作者不必担心会留下很长的 URL。

据上所述,需要在使用 IBM Cognos Express 的终端上启用这些扩展。在默认情况下,终端就是 Express Core 发送者,尽管在需要将 Single Sign-On (SSO) 与 Active Directory 服务器进行集成时,可将它变为 Web 服务器。

根据终端需求的不同,该文档描述了要让终端用户能成功浏览图片所需要采取的步骤。


启用 WebDAV for IIS

Windows 2003 (IIS 6) 上的 IBM Cognos Express 9.0 和 9.5

  1. Enabling Kerberos SSO in IBM Cognos Express on Windows Server 2003 文档中的 Setting up the Express Gateway 一节安装 IBM Cognos Express 网关。
  2. 如果已安装 IBM Cognos Express Sample,那么将 <express_installation_location>/webapps/p2pd/samples/images 文件夹复制到 <express_gateway_location>/webcontent/samples 文件夹。否则创建一个空的 <express_gateway_location>/webcontent/samples 文件夹
  3. 打开 IIS Manager 并右键单击 IBMCognosExpress 虚拟目录。在 New 菜单项下方,选择 Virtual Directory
  4. 接下来跟随向导配置新的虚拟目录,如下所示:
    alias: samples
    Path:<express_gateway_location>/webcontent/samples
    Permissions: check the Read and Browse boxes
  5. 在 IIS Manager 中,选择 Web Service Extensions 并确保 WebDAV Service Extension 设置为 Allowed
    图 1:IIS Manager 中的 Web Service Extensions 视图显示 WebDAV 已允许
    图 1:IIS Manager 中的 Web Service Extensions 视图显示 WebDAV 已允许
  6. 在 IBM Cognos Express Report Studio 中,您现在可以使用以下 URI 在 Image Browser 对话框中浏览图片:
    http://<express_gateway>/IBMCognosExpress/samples/images
    图 2:使用已配置 URL 的 Image Browser 对话框
    图 2:使用已配置 URL 的 Image Browser 对话框

Windows 2008 (IIS 7) 上的 IBM Cognos Express 9.5

  1. Enabling Kerberos SSO in IBM Cognos Express on Windows Server 2008 文档中 Setting up the Express Gateway 一节安装 IBM Cognos Express 网关。
  2. 如果已安装 IBM Cognos Express Samples,那么将 <express_installation_location>/webapps/p2pd/samples/images 文件夹复制到 <express_gateway_location>/webcontent/samples 文件夹。否则创建一个空的 <express_gateway_location>/webcontent/samples 文件夹。
  3. 打开 IIS Manager,右键单击 IBMCognosExpress 虚拟目录,并选择 Add Virtual Directory
  4. 接下来跟随向导配置新的虚拟目录,如下所示:
    alias: samples
    Path:<express_gateway_location>/webcontent/samples
  5. 确保 WebDAV PublishingDirectory Browsing 角色已安装在 Server Manager 中。
    图 3:IIS Server Manager 显示各种角色服务,其中包括 WebDAV Publishing
    图 3:IIS Server Manager 显示各种角色服务,其中包括 WebDAV Publishing
  6. 打开 IIS Manager,并选择第 4 步中创建的 samples 虚拟目录。在 Features View 中,双击 Directory Browsing,并单击 Enable
  7. 选择 Default Web Site,双击 Features View 中的 WebDAV Authoring Rules,并单击 Enable WebDAV
  8. 选择 samples 虚拟目录,双击 Features View 中的 WebDAV Authoring Rules,并单击 Add Authoring Rule。在 Add Authoring Rule 对话框中,创建以下的创作规则:
    Allow access to: 区域,单击 All content 单选按钮。
    Allow access to this content to: 区域,单击 All users 单选按钮。
    Permissions 区域,选中 Read 复选框。
    图 4:Add Authoring Rule 对话框中显示所需的访问设置和许可
    图 4:Add Authoring Rule 对话框中显示所需的访问设置和许可请注意:如果 samples 虚拟目录中有子目录,那么要对于所有包含要在 IBM Cognos Express Report Studio 中浏览图片的子目录重复此步骤。
  9. 在 IBM Cognos Express Report Studio 中,您现在可以使用以下 URI 在 Image Browser 对话框中浏览图片:
    http://<express_gateway>/IBMCognosExpress/samples/images
    图 5:使用已配置 URL 的 Image Browser 对话框
    图 5:使用已配置 URL 的 Image Browser 对话框

启用 WebDAV for Apache Tomcat

启用默认的 WebDAV Servlet

随 IBM Cognos Express 一起交付的 Apache Tomcat 应用服务器也能响应 WebDAV HTTP 请求。尽管如此,默认情况下不启用该功能。以下列出的步骤描述了如何启用随 Apache Tomcat 交付的默认 WebdavServlet。

  1. 验证 <express_installation_location>/webapps/p2pd/samples 文件夹是否存在。如果不存在,请根据如上所述重新构建文件夹结构。
  2. 转到 <express_installation_location>/webapps/p2pd/WEB-INF 文件夹。
  3. 对此文件夹中的 web.xml 文件做一个备份。
  4. 打开原先的 web.xml 文件,查找 <servlet-mapping> 标记。
  5. <servlet-mapping> 标记之前,添加如下 XML:
    <!-- WebDAV enable the app --> 
      <servlet> 
        <servlet-name>webdav</servlet-name> 
        <servlet-class>org.apache.catalina.servlets.WebdavServlet</servlet-class> 
        <init-param> 
          <param-name>debug</param-name> 
          <param-value>0</param-value> 
        </init-param> 
        <init-param> 
          <param-name>listings</param-name> 
          <param-value>true</param-value> 
        </init-param> 
        <init-param> 
          <param-name>readonly</param-name> 
          <param-value>true</param-value> 
        </init-param> 
        <!--load-on-startup>1</load-on-startup--> 
      </servlet> 
    
      <!-- The mapping for the WebDAV servlet --> 
      <servlet-mapping> 
        <servlet-name>webdav</servlet-name> 
        <url-pattern>/samples/images/</url-pattern> 
      </servlet-mapping>
  6. 保存修改,并重启 IBM Cognos Express 服务。
  7. 如果映射成功,那么能在浏览器中使用以下 URL 列出样例文件夹的内容:
    http://express_server:express_port/p2pd/samples/images

修改 IBM Cognos Express Report Studio

由于默认的 WebdavServlet 实现的某些基本特点,需要对 IBM Cognos Express Report Studio 做一些修改,然后才能在此集成工具中使用 servlet。

  1. 转到 <express_installation_location>/webapps/p2pd/pat/hal/ 文件夹。
  2. 根据您所使用的 IBM Cognos Express 版本,备份以下文件:
    • 对于 IBM Cognos Express 9.0:_FK1.js
    • 对于 IBM Cognos Express 9.5:_NK1js
  3. 打开原来的文件,找到以下小节
    • 对于 IBM Cognos Express 9.0:
      var _2H9='<D:propfind xmlns:D="DAV:">';if(_ZD6){for(var i=0;
      i<_ZD6.length;i++){_2H9 += '<D:prop><D:'+ _ZD6[i] + 
      '/></D:prop>';}}else{_2H9+= '<D:allprop/>';
    • 对于 IBM Cognos Express 9.5:
      var _NI9='<D:propfind xmlns:D="DAV:">';if(_IE6){for(var i=0;
      i<_IE6.length;i++){_NI9 += '<D:prop><D:'+ _IE6[i] + 
      '/></D:prop>';}}else{_NI9+= '<D:allprop/>';
  4. 修改以上小节,如下示例所示:
    • 对于 IBM Cognos Express 9.0:
      var _2H9='<D:propfind xmlns:D="DAV:"><D:prop>';if(_ZD6){for(var i=0;
      i<_ZD6.length;i++){_2H9 += '<D:'+ _ZD6[i] + 
      '/>';}}else{_2H9+= '</D:prop><D:allprop/>';
    • 对于 IBM Cognos Express 9.5:
      var _NI9='<D:propfind xmlns:D="DAV:"><D:prop>';if(_IE6){for(var i=0;
      i<_IE6.length;i++){_NI9 += '<D:'+ _IE6[i] + 
      '/>';}}else{_NI9+= '</D:prop><D:allprop/>';
    请注意:在以上的两个示例中,需要修改的部分以黑体表示。
  5. 保存文件,并重启 IBM Cognos Express Report Studio。
  6. 在 IBM Cognos Express Report Studio 中,您现在可以使用以下 URI 在 Image Browser 对话框中浏览图片:
    http://<express_server>:<express_port>/p2pd/samples/images/
    图 6:使用已配置 URL 的 Image Browser 对话框
    图 6:使用已配置 URL 的 Image Browser 对话框

参考资料

学习

获得产品和技术

讨论

  • 参与 developerWorks 博客 并加入 developerWorks 中文社区,developerWorks 社区是一个面向全球 IT 专业人员,可以提供博客、书签、wiki、群组、联系、共享和协作等社区功能的专业社交网络社区。

条评论

developerWorks: 登录

标有星(*)号的字段是必填字段。


需要一个 IBM ID?
忘记 IBM ID?


忘记密码?
更改您的密码

单击提交则表示您同意developerWorks 的条款和条件。 查看条款和条件

 


在您首次登录 developerWorks 时,会为您创建一份个人概要。您的个人概要中的信息(您的姓名、国家/地区,以及公司名称)是公开显示的,而且会随着您发布的任何内容一起显示,除非您选择隐藏您的公司名称。您可以随时更新您的 IBM 帐户。

所有提交的信息确保安全。

选择您的昵称



当您初次登录到 developerWorks 时,将会为您创建一份概要信息,您需要指定一个昵称。您的昵称将和您在 developerWorks 发布的内容显示在一起。

昵称长度在 3 至 31 个字符之间。 您的昵称在 developerWorks 社区中必须是唯一的,并且出于隐私保护的原因,不能是您的电子邮件地址。

标有星(*)号的字段是必填字段。

(昵称长度在 3 至 31 个字符之间)

单击提交则表示您同意developerWorks 的条款和条件。 查看条款和条件.

 


所有提交的信息确保安全。


static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=10
Zone=Information Management
ArticleID=810379
ArticleTitle=IBM Cognos 最佳实践: 在 IBM Cognos Express Report Studio 中启用 Browsing for Images
publish-date=05102012