关于创建指向仪表盘页的链接

其他人可以使用指向仪表盘页的链接轻松地访问数据。

如果组织允许,可以创建指向仪表盘页的链接。这样您便可以完成一些操作,例如将链接另存为书签,或者复制链接并将其通过电子邮件发送给其他用户。

可以创建两种类型的链接:书签链接和提示链接。以下部分介绍了这两种链接:

有关如何创建指向仪表盘页的链接的信息,请参阅创建指向仪表盘页的链接

什么是书签链接?

您可以创建指向仪表盘页及其状态的链接。

书签链接是一个 URL,捕获仪表盘页的路径以及页状态的所有方面,例如:

http://localhost/10.1.3.2/saw.dll?Dashboard&_scid=7ndOC-SjmWo&PortalPath=%2Fusers%2Fadministrator%2F_portal&Page=p2&PageIdentifier=7fsg0r2sdssvgen4&BookmarkState=r78an1mbj0fj4lmqhdjfndvvai

创建书签链接之后,可以执行以下操作:

  • 将链接另存为书签,这样可以在以后返回到完全相同的页内容。

  • 复制链接并将其发送给其他用户,这样他们可以与您查看完全相同的内容,前提是这些用户与您具有相同的权限且可以访问该页。

创建书签链接时,仪表盘页的状态将作为隐藏书签对象在目录中保存组织指定的时间长度。默认值为 30 天。有关组织指定的时间长度,请咨询管理员。由于仪表盘页的状态在您创建书签链接时即会保存,因此您在创建该链接后可以继续修改仪表盘页的内容。

什么是提示链接?

提示链接指向简化的仪表盘表示形式。

提示链接可以捕获仪表盘页的路径以及仪表盘提示的简化表示形式,例如:

<内容路径>&Action=Navigate&col1="Products"."P1 Product"&val1="Bluetooth Adaptor"&psa1="A - Sample Sales"

创建提示链接时,可以手动或通过编程方式处理该链接,例如为提示添加不同值。请注意,使用提示链接,不能如使用书签链接一样捕获页状态的所有方面。这是因为您不能复制非提示参数的准确状态。

对于捕获仪表盘页的路径以及仪表盘提示的简化表示形式的 URL,也可以手动构造而不是通过提示链接创建。有关详细信息,请参阅 Oracle Business Intelligence Enterprise Edition 集成指南.

有关操纵提示链接的详细信息,请参阅以下主题:

提示链接的基本语法

提示链接必须遵守所述的基本语法规则。

提示链接的基本语法如下所示:

<Content Path>&Action=Navigate&col1&op1&val1&col2&op2&val2&var3&op3&val3…

其中,内容路径为以下任何基础 URL:

http://<obiee url path>/saw.dll?Dashboard&PortalPath=<dashboard path> http://<obiee url path>/saw.dll?Dashboard&PortalPath=<dashboard path>&Page=<page name> http://<obiee url path>/saw.dll?PortalGo&path=<analysis or prompt path> http://<obiee url path>/saw.dll?Go&path=<analysis or prompt path>

提示链接的参数

可以使用参数来更改提示链接。

可用于修改提示链接的参数如下所示:

  • &Action= - 指定提示链接要执行的操作。有效值为:

    • 导航 - 导航到仪表盘页。

    • 打印 - 设置结果的格式以打印到 PDF,而不使用分页控件、热链接等。

    • 下载 - 将结果下载到 Microsoft Excel。

    如果存在 viewState 参数,则无法使用打印下载。有关详细信息,请参阅 Oracle Business Intelligence Enterprise Edition 集成指南

  • &col#= - 标识在列提示中使用的列。

    示例:

    &col1="EASTERN REGION"
    
  • &var#= - 标识在变量提示中使用的变量或由列提示设置的变量。

    默认情况下,所有变量的作用域均为仪表盘页,除非您显式引用变量。

    示例:使用由可选参数 &P1= 控制的默认作用域:

    &var1="myRegion"
    

    显式设置仪表盘作用域的示例:

    &var1=dashboard.variables['myRegion']
    

    显式设置仪表盘页作用域的示例:

    &var1=dashboard.currentPage.variables['myRegion']
    

    如果需要设置仪表盘作用域和仪表盘页作用域,请在 URL 中同时包括两个变量。

    无法使用此参数设置会话变量。但是,您可以通过设置请求变量来覆盖会话变量。例如,您可以通过设置以下请求变量来覆盖 NQ_SESSION.REGION_VAR:

    &var1=requestVariables['REGION_VAR']
    
  • 这些值参数:

    • &val#= - 指定提示的值。

      示例:

      &val1="EASTERN REGION"
      
    • &valgrp#= - 将提示值设置为定制组的目录路径。

      示例:

      &valgrp1="/shared/folder/myCustomGroup"
      
    • &valsv#= - 将提示值设置为服务器变量。

      示例:

      &valsv1="SALESREGION"
      

    val# 和 valgrp# 参数相互可以共存,但不能与 valsv# 参数共存。换句话说,提示可以具有 val# 和 valgrp# 的任意组合,但不能同时具有 valsv# 和 val#。

  • &cov#= - 设置列提示的变量,该变量同时也设置一个变量。

    示例:

    &var1=myRegion&cov1="Markets"."Region"&val1="EASTERN.REGION"+"WESTERN REGION"
    
  • &op#= - (可选) 指定运算符,例如,等于。

    使用与 Go URL 相同的运算符。有关这些运算符的列表,请参阅 Oracle Business Intelligence Enterprise Edition 集成指南中的导航参数

    示例:

    &col1="Markets"."Region"&val1="EASTERN REGION"+"WESTERN REGION"&op1=in
    
  • &psa#= - (可选) 标识提示的主要主题区域。

    如果提示要求由主题区域正确标识值的数据类型,则使用此参数。

    示例:

    &var1=myRegion&cov1="Markets"."Region"&val1="EASTERN REGION"+"WESTERN REGION"&psa1=Paint
    

    如果提示链接包括多个主题区域,请指定不首先标识主题区域的提示 (例如,&psa1="Products"."P1 Products") 和最后标识主题区域的提示 (例如,&psa2="B-Sample Target"."Products"."P1 Products")。

  • &formulause#= - 确定提示值是代码值还是显示值 (在配置使用双列功能的资料档案库中)。

    如果不使用此参数,则假定该值是显示值。

    示例:

    &var1=myRegion&cov1="Markets"."Region"&val1="2"+"3"&formulause1=code
    
  • 对于使用分层列的提示:

    • &hierid#= - (必需) 标识层次 ID。

    • &dimid#= - (必需) 标识维 ID。

    • &tblnm#= - (必需) 标识表名称。

    示例:

    &col1="Products"."Products Hierarchy"&hierid1=Products Hierarchy&dimid1=H1 Products&tblnm1="Products"&val1="*"+"all"&psa1="A - Sample Sales"
    

    如果有多个值跨多个级别,则需要扩展值的语法。有关方法,请参阅扩展值的语法

  • &P1= - 定义所有提示链接参数的作用域。有效值为:

    • dashboard

    • dashboardPage (未提供作用域时的默认值)

    • report

    此参数影响提示链接的过滤器和变量。

    示例:

    &P1=dashboard
    

扩展值的语法

在包括分层列的提示链接中,如果有多个值跨多个级别,则需要扩展值的语法。

要扩展值的语法,请执行以下操作:

  1. 根据值的 levelID 对值进行分组。
  2. 将属于同一级别的所有值放入一个数组中,并将相应的 levelID 添加到每个数组前面,如下所示:
    "Detail Product"+"7"+"4"
    
  3. 连接各个数组并用 +* 分隔它们。
  4. 将整个连接字符串放入 &val#= 参数中。例如:
    &col1="Products"."Products Hierarchy"&hierid1=Products Hierarchy&dimid1=H1 Products&tblnm1="Products"&val1="LOB"+"Digital"+*"Brand"+"HomeView"+*"Detail Product"+"7"+"4"&psa1="A - Sample Sales"
    

有关操纵提示链接的准则

可以用若干方式更改提示链接。

有关操纵提示链接的准则如下所示:

  • 使用 &col#= 和 &var#= 的任意组合,但为它们指定从 1 到 N 的连续编号。例如,可以使用 var1、col2、col3,也可以使用 col1、var2、col3。

  • 使用加号 (+) 来分隔值。

  • 对日期、时间和时间戳使用下面独立于区域设置的格式:

    对于日期格式:

    YYYY-MM-DD
    

    对于时间格式:

    hh24:mm:ss
    

    对于时间戳格式 (预期时区是 UTC):

    YYYY-MM-DD hh24:mm:ss
    
  • 确保您正确编码 URL。并非所有浏览器或平台都允许未转义的 URL。例如,将双引号 (") 编码为 %22,将空格字符编码为 %20,等等。

  • 请注意,浏览器支持的 URL 字符长度因浏览器不同而异。如果一个 URL 长于支持的长度,则它将被截断。解决方法是使用书签链接或另一个支持更长长度的浏览器。

  • 如果值中不包含空格,则可以选择性地忽略双引号。

提示:

要以手动方式快速准确地构造提示 URL,请使用相应的提示导航到仪表盘页,应用所需的提示值,创建提示链接以生成提示 URL,然后使用该 URL 作为模板。