OBIEE 12c用户页面客制化之一修改LOGO

1 问题描述

OBIEE的原生页面logo是oracle的logo图片，标题是Business Intelligence,如下图：

需要按照换成企业自己的logo

2 系统版本

OBIEE: 12.2.1.4

3 参考文档

https://gianniceresa.com/2017/02/obiee-12c-custom-style-using-shared-folder/

https://support.oracle.com/epmos/faces/DocumentDisplay?_afrLoop=100203833276918&id=2262460.1&_adf.ctrl-state=nqzm0yfgz_29

4 解决方法

4.1方法综述

更换logo实际上是官方文档中提到的“修改展示层服务（Presentation Service）的用户界面风格”里的一项内容。官方文档中提到了两种方式，一种是通过修改部署bicustom.ear实现，第二种是部署自己的文件。本文采用的是第二种方法。
总的步骤是：
1 准备好新的皮肤和主题文件夹
2 部署文件夹
3 修改instanceconfig.xml文件，重启服务
3 查看logo是否改变

4.2 准备好文件夹

Oracle提供了皮肤和主题文件夹模板，System Administrator’s Guide的说明是从ORACLE_HOME/bi/bifoundation/jee/bicustom-template.ear 解压获得，但实际上产品安装目录自带的这个模板是旧的Skyros风格的，而12c一般缺省采用的是Alta风格的，因此建议采用MOS OBIEE 12c: How To Create a New Customization Based on the Alta Skin? (Doc ID 2262460.1)中提供的模板创建自己的文件夹。
1 从MOS OBIEE 12c: How To Create a New Customization Based on the Alta Skin? (Doc ID 2262460.1)下载模板
2 解压bicustom-altatemplate.ear至一临时文件夹
3 解压bicustom.war至一临时文件夹
4 创建自己文件夹，路径和名称随意，例如我创建的是/oracle/customSkin

5 将bicustom.war解压出来的两个子文件夹res和WEB-INF拷贝到自己的文件夹下,注意别拷贝META-INF，例如这时我创建的customSkin文件夹下的内容如下

6 进入res文件夹，打开filemap.xml文件，看到如下内容

<FileMap>

   <!-- The style name should exactly match the name of the folder, including case -->
   <Styles Default="s_blafp">
      <Hierarchy>s_Skyros / s_Custom</Hierarchy>
      <Hierarchy>s_Alta / s_CustomAlta</Hierarchy>
   </Styles>

   <!-- The style name should exactly match the name of the folder, including case-->
   <Skins Default="sk_blafp">
      <Hierarchy>sk_Skyros / sk_Custom</Hierarchy>
      <Hierarchy>sk_Alta / sk_CustomAlta</Hierarchy>
   </Skins>

</FileMap>

注意：

• s_Alta / s_CustomAlta表示父亲样式名称是Alta,子样式名称是CustomAlta，CustomAlta继承了Alta的所有风格，在Alta基础之上做修改。
• s_CustomAlta实际上是文件夹名称，在后面修改instanceconfig.xml文件时用的应该是样式名称，例如res文件夹下的内容如下
• 

7 将企业自己的logo图片文件改成oracle_logo.png，图片要求像素为136*17是最合适，并且底色是透明的。

8 将新的oracle_logo.png文件拷贝到目录res/s_CustomAlta/master下，覆盖原来的文件。

4.3 部署文件夹

到目前位置文件夹已经准备好，可以开始部署文件夹了。方法请参考OBIEE 12C集成ECHART生成统计地图之一中的部署echarts插件步骤，这里就不详细描述了。

4.4 修改配置文件

1 修改<DOMAIN_HOME>/config/fmwconfig/biconfig/OBIPS/instanceconfig.xml文件，找到部分，将以下内容

<UI>
	<DefaultSkin>Alta</DefaultSkin>
	<DefaultStyle>Alta</DefaultStyle>
	<SkinMappings>
		<skinMapping>
			<biadfSkinFamily>bi-alta</biadfSkinFamily>
			<biSkin>AltaBitech</biSkin>
		</skinMapping>
	</SkinMappings>
</UI>

替换成

<UI>
	<DefaultSkin>CustomAlta</DefaultSkin>
	<DefaultStyle>CustomAlta</DefaultStyle>
	<SkinMappings>
		<skinMapping>
			<biadfSkinFamily>bi-alta</biadfSkinFamily>
			<biSkin>AltaBitech</biSkin>
		</skinMapping>
	</SkinMappings>
</UI>

<URL>
    <CustomerResourcePhysicalPath>/home/biee/Oracle/customSkin/res</CustomerResourcePhysicalPath>
    <CustomerResourceVirtualPath>/customSkin/res</CustomerResourceVirtualPath>
</URL>

注意：

• CustomerResourcePhysicalPath标签里填写的是res文件夹所在的绝对路径

• CustomerResourceVirtualPath标签里填写的是访问res目录时的链接路径

2 在em中重启 OBIPS服务

4.5 查看logo是否改变

1 清除浏览器缓存
2 进入系统查看logo是否已经更改