自定义 Oracle 身份管理器管理控制台
自定义 Oracle 身份管理器管理控制台 本 OBE 教程将向您介绍和演示如何利用 Oracle 身份管理器来自定义其管理控制台。学完本教程之后，您将能够根据您公司的需要调整此控制台。 大约 2 个小时
本 OBE 教程包括下列主题：  将鼠标置于此图标上以加载和查看本教程的所有屏幕截图。（警告：此操作会同时加载所有屏幕截图，网速较慢时，响应时间可能会比较长。）
注：此外，您还可以在下列步骤中将鼠标放在每个单独的图标上，从而仅加载和查看与该步骤相关的屏幕截图。 屏幕截图不会反映您使用的特定环境。它们只是让您了解应该在哪里查找 Oracle 身份管理器的特定功能。
Oracle 身份管理器是一个具有高度灵活性和可伸缩性的企业身份管理系统，用于在企业 IT 资源内集中控制用户帐户和访问权限。它提供了供应、身份和角色管理、审批和请求管理、基于策略的权限管理、技术集成以及自动化审计和合规性等功能。 Oracle 身份管理器的特性和优点包括身份及角色管理（用户和组管理、针对用户的自助服务功能和委托管理）、供应（审批与请求管理和可配置的工作流模型）、基于策略的权限、协调以及证明支持（用于审计和合规性目的）。 返回主题列表
Linda 是 Mydo Main Corporation 的网络管理员。在该公司，Linda 负责执行对机构内各种用户的身份和访问进行管理的任务。其中包括自定义为 Mydo Main 安装和配置的 Oracle 身份管理器环境的管理控制台。这样，她能够根据其公司的需要调整此控制台。 利用该管理控制台，Linda 可以执行两个级别的自定义： - 修改控制台的外观（即，对其进行品牌化）
- 在不 修改 Oracle 身份管理器代码的情况下更改控制台的功能
Linda 可以通过不同方法对管理控制台进行品牌化，包括：
- 自定义控制台 Web 页面的整体布局
- 将 Mydo Main 的公司徽标添加到控制台
- 修改控制台 Web 页面上所显示的描述文本和标签
- 更改控制台中文本的颜色、字体和对齐方式
Linda 还可以通过各种不同的方法在不修改代码的情况下更改管理控制台的功能。这些方法包括：
- 自定义控制台 Web 页面上所显示的表单域的行为
- 自定义控制台的搜索页面
在此 OBE 中，Linda 利用本部分所列的方法为 Mydo Main Corporation 自定义 Oracle 身份管理器管理控制台。 返回主题列表
开始本教程之前，您应该： 返回主题列表
Linda 想为 Mydo Main Corporation 自定义 Oracle 身份管理器管理控制台。不过，在执行此操作之前，她必须配置其公司的环境以便控制台能够 得到修改。这包括对同以下产品一起打包的两个 Oracle 身份管理器文件进行修改：XellerateFull.ear 和 xlWebApp.war。 要配置 Oracle 身份管理器环境，执行以下步骤：
| 1. | 关闭您的 Oracle 身份管理器服务器、管理控制台和设计控制台。 注：有关停止 Oracle 身份管理器的更多信息，请参考标题为“安装 Oracle 身份管理器”的 OBE。 |
| 2. | 在 Windows Explorer 中创建以下目录： - E:\jboss-4.0.2_ear
- E:\jboss-4.0.2_war
|
| 3. |
剪切位于 E:\jboss-4.0.2\server\default\deploy 目录中的 XellerateFull.ear 文件，将其粘贴到 E:\jboss-4.0.2_ear 目录中。 |
| 4. | 在 E:\jboss-4.0.2\server\default\deploy 目录中创建 XellerateFull.ear 文件夹。
|
| 5. |
将 XellerateFull.ear 文件的内容解压缩到 E:\jboss-4.0.2\server\default\deploy\XellerateFull.ear 目录中。 |
| 6. |
剪切位于 E:\jboss-4.0.2\server\default\deploy\XellerateFull.ear 目录中的 xlWebApp.war 文件，将其粘贴到 E:\jboss-4.0.2_war 目录中。 |
| 7. |
在 E:\jboss-4.0.2\server\default\deploy\XellerateFull.ear 目录中创建 xlWebApp.war 文件夹。
|
| 8. | 将 E:\oracle\oim_server\xellerate\webapp 目录中的 xlWebApp.war 文件的内容解压缩到 E:\jboss-4.0.2\server\default\deploy\XellerateFull.ear\xlWebApp.war 目录中。
重要事项：E:\oracle\oim_server\xellerate\webapp 目录中的 xlWebApp.war 文件包含专门针对 Oracle 身份管理器的文件。因此，Linda 要提取该文件（与 E:\jboss-4.0.2_war 目录中的文件相对）。 |
| 9. |
按照本 OBE 其余过程的相关说明修改所需的文件。 重要事项： 在对 xlWebApp.war 文件中所包含的任何文件进行修改之前，Linda 都应该对其进行备份。她编辑的文件同她能够利用管理控制台执行的特殊类型的自定义相对应。 例如，xlWebAdmin.properties 文件包含管理控制台中所显示的文本及标签，而 Xellerate.css 文件是一个样式表，它控制这些文本和标签的颜色、字体、磅值和对齐方式。 有关对哪些 文件进行修改的更多信息，请参考本 OBE 中的过程。 Linda 为 Mydo Main Corporation 配置了 Oracle 身份管理器环境。因此，她现在可以为其公司自定义管理控制台了。 Linda 现已为品牌化管理控制台做好了准备。品牌化本控制台可通过自定义其 Web 页面的整体布局来实现。这可以包括修改横幅的宽度、改变图像的对齐方式和方向以及添加链接（例如，将企业徽标链接插入 Mydo Main 的主页中）。 在本 OBE 接下来的部分，Linda 将学习如何通过在页眉横幅的右侧显示 Oracle 身份管理器的产品徽标来自定义 Web 页面的总体布局。 |
返回主题列表
在本 OBE 的前一部分，Linda 为 Mydo Main Corporation 配置了 Oracle 身份管理器环境，因而能够自定义管理控制台。现在，Linda 已为修改本控制台的外观做好了准备（即，对它进行品牌化）。品牌化本控制台可通过自定义其 Web 页面的整体布局来实现。 在本部分，Linda 将自定义 Web 页面的整体布局，以便将 Oracle 身份管理器的产品徽标显示在页眉横幅的右侧。要执行该操作，她必须访问 tjspHeader.jsp 文件。然后，她需要交换对产品徽标（即 global.image.clientlogo）的引用和对空格（或在页眉横幅中占据了指定数量的水平空间从而将产品徽标推到右边的图形）的引用。对该空格的引用为 global.image.xelleratelogo。
要自定义 Web 页面的整体布局，执行以下步骤：
| 1. | 使用文本编辑器打开 tjspHeader.jsp 文件。该文件位于 E:\jboss-4.0.2\server\ default\deploy\XellerateFull.ear\xlWebApp.war\tiles\common 目录中。
显示 tjspHeader.jsp 文件。
| | 2. | 在本文件中，找到对产品徽标的引用 (global.image.clientlogo)。 |
| 3. | 将该引用替换为对空格（或在页眉横幅中占据了指定数量的水平空间从而将产品徽标推到右边的图形）的引用。对该空格的引用为 global.image.xelleratelogo。
|
| 4. | 重复第 2 和第 3 步，将空格替换为产品徽标。
|
| 5. |
保存对 tjspHeader.jsp 文件的更改。关闭该文件。 | |
6. | 重新启动 Oracle 身份管理器服务器和管理控制台。显示控制台的主页，产品徽标现在显示在页眉横幅的右侧。
注：有关启动 Oracle 身份管理器的更多信息，请参考标题为“安装 Oracle 身份管理器”的 OBE。
Linda 自定义了 Web 页面的总体布局，从而使 Oracle 身份管理器的产品徽标显示在页眉横幅的右侧。
在本 OBE 接下来的部分，Linda 将学习用另一种方法品牌化管理控制台。她要将一个徽标添加到本控制台的页眉横幅。该徽标代表 Mydo Main Corporation 的公司徽标。 | 返回主题列表
在本 OBE 的前一部分，Linda 自定义了 Web 页面的整体布局，从而使 Oracle 身份管理器的产品徽标显示在页眉横幅的右侧。 现在，Linda 将用另一种方法品牌化管理控制台。对于本 OBE，她要将一个徽标添加到本控制台的页眉横幅。该徽标代表 Mydo Main Corporation 的公司徽标。对该徽标的引用为 mydomain.gif。 要执行该操作，她必须访问 xlWebAdmin.properties 文件。然后，她需要将公司徽标指定给代表空格（即 global.image.xelleratelogo）的属性。 要将一个徽标添加到管理控制台，执行以下步骤：
| 1. | 关闭您的 Oracle 身份管理器服务器和管理控制台。 |
| 2. | 从桌面复制 mydomain.gif 文件（代表 Mydo Main Corporation 的公司徽标）。
|
| 3. | 将该文件粘贴到 E:\jboss-4.0.2\server\default\deploy\XellerateFull.ear\xlWebApp.war\images 目录中。
|
| 4. | 使用文本编辑器打开 xlWebAdmin.properties 文件。该文件位于 E:\jboss-4.0.2\server\default\deploy\XellerateFull.ear\xlWebApp.war\WEB-INF\classes 目录中。
显示 xlWebAdmin.properties 文件。
| | 5. |
在本文件中找到 GLOBAL images 部分。 |
| 6. |
找到 global.image.xelleratelogo 属性。然后，将该属性的值设置为包含 Mydo Main Corporation 公司徽标（即 /images/mydomain.gif）的图像文件的完整路径和名称。 |
| 7. |
保存对 xlWebAdmin.properties 文件的更改。关闭该文件。 | | 8. |
重新启动 Oracle 身份管理器服务器和管理控制台。Mydo Main Corporation 的公司徽标显示在控制台的主页上。 Linda 将 Mydo Main Corporation 的公司徽标添加到了管理控制台的页眉横幅。在本 OBE 接下来的部分，Linda 将学习用另一种方法品牌化该控制台。她要修改其文本和标签。 | 返回主题列表
在本 OBE 的前一部分，Linda 将 Mydo Main Corporation 的公司徽标添加到了管理控制台的页眉横幅。 现在，Linda 将用另一种方法品牌化该控制台。对于本 OBE，她将修改 Search User 按钮的说明性文本和标签，该按钮显示在管理控制台的 Manage User 表单上。 要执行该操作，她必须访问 xlWebAdmin.properties 文件。该文件包含管理控制台中显示的所有文本和标签。然后，她需要为代表 Manage User 表单上显示的 Search User 按钮的说明性文本和标签的属性指定新的值。这些属性可在 xlWebAdmin.properties 文件的标题为Start of MANAGE USER Properties 的部分中找到。 要修改管理控制台的文本和标签，执行以下步骤：
| 1. | 关闭您的 Oracle 身份管理器服务器和管理控制台。 |
| 2. | 使用文本编辑器打开 xlWebAdmin.properties 文件。
| | 3. |
在该文件中找到 Start of MANAGE USER Properties 部分。 |
| 4. |
修改管理控制台的 Manage User 表单上显示的 Search User 按钮的说明性文本和标签，如下所示： | 属性 | 旧值 | 新值 | | manageUser.message.searchUserDesc | Please type in search criteria to search for users. | Here, you can enter what you need to find whom you need. | | manageUser.button.searchUser | Search User | Search Oracle User | xlWebAdmin.properties 文件的 Start of MANAGE USER Properties 部分应如下所示：
| | 5. | 保存对 xlWebAdmin.properties 文件的更改。关闭该文件。 | | 6. |
重新启动 Oracle 身份管理器服务器和管理控制台。 | 7. | 使用 Oracle 身份管理器的“超级用户”帐户登录到管理控制台（即，在 User ID 域中输入 xelsysadm，在 Password 域中输入 abcd1234）。 |
8. | 打开 Users 文件夹中的 Manage User 表单。 显示 Manage User 表单。 该表单中显示的 Search User 按钮的标签和说明性文本现在反映了 Linda 对 xlWebAdmin.properties 文件所作的更改。因此，她修改了管理控制台的文本和标签。 在本 OBE 接下来的部分，Linda 将学习用另一种方法品牌化该控制台。她将自定义管理控制台内显示的文本的颜色、字体和对齐方式。 | 返回主题列表
在本 OBE 的前一部分，Linda 修改了管理控制台的说明性文本和一个按钮标签。 现在，Linda 将用另一种方法品牌化该控制台。对于本 OBE，她将自定义管理控制台页脚横幅内显示的文本的颜色、字体和对齐方式。 要执行该操作，她必须访问 Xellerate.css 文件。该文件是一个控制管理控制台中显示的文本的属性（如文本的颜色、字体和对齐方式）的样式表。由于 Linda 要修改页脚横幅内所显示的文本，因此她需要访问 Xellerate.css 文件的 FOOTER 部分。 要自定义管理控制台内文本的颜色、字体和对齐方式，执行以下步骤：
1. | 关闭您的 Oracle 身份管理器服务器和管理控制台。 |
2. | 使用文本编辑器打开 Xellerate.css文件。该文件位于 E:\jboss-4.0.2\server\default\deploy\XellerateFull.ear\xlWebApp.war\css 目录中。
显示 Xellerate.css 文件。
| | 3. | 在该文件中找到 FOOTER 部分。 |
| 4. |
修改管理控制台页脚横幅中显示的文本，如下所示： | 属性 | 旧值 | 新值 | | Color | 白色 | 黄色（用十六进制代码 ffff00 表示） |
| Font Face | Arial | Times New Roman | | Alignment | Right | Left |
Xellerate.css 文件的 FOOTER 部分应如下所示：
| | 5. | 保存对 Xellerate.css 文件的更改。关闭该文件。 | | 6. |
重新启动 Oracle 身份管理器服务器和管理控制台。该控制台页脚横幅中显示的文本反映了 Linda 对 Xellerate.css 文件所作的更改。 Linda 自定义了管理控制台页脚横幅内显示的文本的颜色、字体和对齐方式。 在本 OBE 接下来的部分，她将学习利用该控制台可以执行的其他级别的自定义（即，在不 更改 Oracle 身份管理器代码的情况下更改管理控制台的功能）。具体来讲，她将自定义本控制台 Web 页面上显示的一个表单域的行为。 | 返回主题列表
在本 OBE 的前一部分，Linda 自定义了管理控制台页脚横幅内显示的文本的颜色、字体和对齐方式。 现在，Linda 将学习利用该控制台可以执行的其他级别的自定义（即，在不 修改 Oracle 身份管理器代码的情况下更改管理控制台的功能）。 对于本 OBE，她将把 Create User 表单中的 Email Address 域设置为必填项。也就是说，必须 填充该域才能使相应的的用户记录保存到数据库。因此，通过这一部分的学习，她将能够对管理控制台的 Web 页面上显示的任何表单域的行为进行调整以满足其公司的需要。 要执行该操作，她必须访问 FormMetaData.xml 文件。该文件控制组成管理控制台 Web 页面的所有域的行为。由于 Linda 要将 Create User 表单的 Email Address 域设置为必填项，因此她需要访问 FormMetaData.xml 文件的 User Management 部分。 要自定义管理控制台内表单域的行为，执行以下步骤：
1. | 关闭您的 Oracle 身份管理器服务器和管理控制台。 |
2. | 使用文本编辑器打开 FormMetaData.xml 文件。该文件位于 E:\oracle\oim_server\xellerate\config 目录中。
显示 FormMetaData.xml 文件。
| | 3. | 在该文件中找到 User Management 部分。 |
| 4. |
对于本 OBE，Linda 将 Create User 表单的 Email Address 域设置为必填项。因此，按如下所示修改本域的代码： | 域 | 属性 | 旧值 | 新值 | | Email | optional | true | false |
注：通过将 optional 参数设置为 false，必须 填充 Create User 表单的 Email Address 域才能使相关的用户记录保存到数据库。 FormMetaData.xml 文件的 User Management 部分应如下所示：
| | 5. | 保存对 FormMetaData.xml 文件的更改。关闭该文件。 | | 6. |
重新启动 Oracle 身份管理器服务器和管理控制台。 | 7. | 使用 Oracle 身份管理器的“超级用户”帐户登录到管理控制台（即，在 User ID 域中输入 xelsysadm，在 Password 域中输入 abcd1234）。 |
8. | 打开 Users 文件夹中的 Create User 表单。 显示 Create User 表单。 Create User 表单的 Email Address 域现在为必填项。Linda 对 FormMetaData.xml 文件的更改反映在表单中。因此，她自定义了该表单域的行为。 在本 OBE 接下来的部分，Linda 将学习用另一种方法在不修改 Oracle 下更改管理控制台的功能。她将自定义该控制台的搜索页面。 | 返回主题列表
在本 OBE 的前一部分，Linda 自定义了管理控制台内表单域的行为。 现在，Linda 将用另一种方法更改该控制台的功能。对于本 OBE，她将自定义其搜索页面。具体来讲，她将增加管理控制台 Web 页面上显示的搜索结果的最大数量 — 从 10 个增加到 15个。 要执行该操作，Linda 必须访问 xlWebAdmin.properties 文件。她要将搜索结果的最大数量从 10 个增加为 15 个。因此，她需要对控制该设置的 global.displayrecordNum.value 属性的值进行修改（即，将该值由 10 改为 15）。 要自定义管理控制台的搜索页面，执行以下步骤：
1. | 关闭您的 Oracle 身份管理器服务器和管理控制台。 |
2. | 使用文本编辑器打开 xlWebAdmin.properties 文件。
| | 3. | 在该文件中找到 global.displayrecordNum.value 属性。 注：global.displayrecordNum.value 属性的当前值设置为 10。该值代表默认情况下管理控制台 Web 页面上所能显示的搜索结果的数量。 | | 4. |
对于本 OBE，Linda 将把管理控制台 Web 页面上所能显示的搜索结果的最大数量从 10 个增加到 15 个。因此，按如下所示修改 global.displayrecordNum.value 属性的值： | 属性 | 旧值 | 新值 | | global.displayrecordNum.value | 10 | 15 |
xlWebAdmin.properties 文件的 global.displayrecordNum.value 属性应如下所示：
| | 5. | 将所作更改保存到 xlWebAdmin.properties 文件。关闭该文件。 | | 6. |
重新启动 Oracle 身份管理器服务器和管理控制台。 | 7. | 使用 Oracle 身份管理器的“超级用户”帐户登录到管理控制台（即，在 User ID 域中输入 xelsysadm，在 Password 域中输入 abcd1234）。 |
8. | 打开 Users 文件夹中的 Manage User 表单。 显示 Manage User 表单。 注： Linda 打开 Manage User 表单，因为该表单所包含的记录多于单个 Web 页面上所能显示的记录。也就是说，记录的数量大于 Linda 为 global.displayrecordNum.value 属性设置的值。 Linda 现在将针对该表单执行一个查询。这样，她可以确信她对 global.displayrecordNum.value 属性所作的修改在 Manage User 表单中得到反映。 |
9. |
从该表单内显示的组合框中选择 User ID。然后，在组合框右侧显示的文本框中输入 *。这个值代表一个“通配符”。最后，单击 Search Oracle User。 显示 Linda 查询的结果。 对 global.displayrecordNum.value 属性所作的修改在 Manage User 表单内得到了反映。也就是说，该 Web 页面上显示的搜索结果的最大数量现在为 15 个，而非 10 个。因此，Linda 自定义了管理控制台的搜索页面。
| 返回主题列表 在本教程中，您学习了如何：
 | 配置 Oracle 身份管理器环境 | | 自定义 Web 页面的总体布局 | | 将徽标添加到管理控制台 | | 修改管理控制台的文本和标签 |
| 自定义管理控制台内文本的颜色、字体和对齐方式 |
| 自定义表单域的行为 | | 自定义搜索页面 | 返回主题列表 | 有关本 OBE 教程的问题，请在 OBE 论坛上发布查询。 | 返回主题列表 将鼠标置于该图标上可以隐藏所有的屏幕截图。
| 
书签