Shared Services Native Directory 迁移选项

迁移导入选项

以下列表介绍了 Oracle Hyperion Shared Services 导入选项:

  • 导入操作 - 选择一个选项:

    • 创建 - 如果目标中没有用户、组和角色,则创建这些对象。如果目标中有这些对象,则创建操作会失败。增加组、角色和设置关系。

    • 更新 - 更新用户、组和角色。替换组、角色和设置关系。

    • 创建/更新 - 在文件中的每个实体上尝试执行创建操作。如果创建操作失败,则尝试执行更新操作。

    • 删除 - 删除即将导入的用户、组和角色。删除组、角色和设置关系。

      注:

      要删除禁用的用户,必须先激活该用户,然后才能将其删除。

      注:

      • 将 Shared Services 数据从源迁移到目标时,确保在与源相同的应用程序组下注册应用程序。

      • 选择创建更新选项从源迁移到目标时,将创建或更新数据,但不删除数据。

      有关详细信息,请参阅“使用应用程序组和应用程序”。
  • 停止导入前的最大错误数 - 指定在导入过程停止前允许的错误数。

CSV 文件

导入源文件是 CSV 文件。

CSV 文件格式是一种表格式数据格式,包含用逗号分隔并括在双引号中的字段。Oracle Hyperion Enterprise Performance Management System 生命周期管理仅支持遵循 Excel 标准的 CSV 文件。Excel 输出的 CSV 文件与标准 CSV 文件有以下区别:

  • 前导和尾部空格有意义。

  • 反斜杠不是特殊字符,不会转义任何内容。

  • 带引号的字符串内的引号使用双引号而非反斜杠进行转义。

Excel 在将数据输出为 CSV 格式之前可能会先转换数据。

Excel 对 CSV 文件执行的转换:

  • 制表符转换为一个空格。

  • 新行始终表示为 "\n"。

  • 大于 12 位数的数字以分隔的科学计数形式表示。

以下各实体有单独的 CSV 文件:

  • 用户

  • 角色

  • 设置信息

  • 授权列表

CSV 文件中的每一节都由两个必要行标识:实体和标题。实体行由以 # 字符开头的预定义实体名称标识。标题行跟在实体行之后。标题行是以逗号分隔的实体预定义属性列表。

标题行中的属性顺序并不重要。但是,标题行之后的数据行,必须以标题行显示属性的顺序来显示数据。如果不需要指定数据,可使用逗号指示不需要设定的值。处理过程所需的信息由实体行、标题行及数据行三者共同提供。

对 CSV 文件执行创建、更新或删除操作时,请注意以下限制:

  • 一次只能处理一个数据行的用户、组和角色。

  • 同一个标题、同一个父代组下的多个数据行的组成员同时处理。

  • 同一个标题、同一个父代角色下的多个数据行的角色成员同时处理。

  • 同一个标题、同一个组或用户下的多个数据行的用户设置同时处理。

错误处理基于上述处理限制。处理限制中每个失败计为一个错误。

有关 CSV 示例文件及属性信息,请参阅以下部分:

用户 CSV 文件

用户 CSV 示例文件
#user
id,provider,login_name,first_name,last_name,description,email,internal_id,password,active
admin,Native Directory,admin,administrator,user,hss admin user,admin@hyperion.com,"native://DN=cn=911,ou=People,dc=css,dc=hyperion,dc=com?USER",{SHA}W6ph5Mm5Pz8GgiULbPgzG37mj9g=,true

在本示例中,用户 CSV 文件用于在 Native Directory 中创建 admin 用户,其登录名为 admin,名字为 administrator,姓氏为 user,说明为 hss admin user,电子邮件 ID 为 admin@hyperion.com,内部 ID 为 "native://DN=cn=911,ou=People,dc=css,dc=hyperion,dc=com?USER",加密密码为 {SHA}W6ph5Mm5Pz8GgiULbPgzG37mj9g=,活动状态为 true

注:

CSV 文件中指定的纯文本密码是经过加密的。

表 J-3 用户实体属性

属性 说明和示例
id
用户的 ID

示例:admin

provider
可选:源用户目录的名称

示例:

login_name
用户的登录名

示例:admin

first_name
可选:用户的名字

示例:administrator

last_name
可选:用户的姓氏

示例:user

description
可选:用户说明

示例: hss admin user

email
可选:用户的电子邮件地址

示例:admin@example.com

internal_id
为用户自动生成的内部标识

示例:"native://DN=cn=911,ou=People,dc=css,dc=hyperion,dc=com?USER"

password
用户的密码

示例:{SHA}W6ph5Mm5Pz8GgiULbPgzG37mj9g=

active
表示用户是 (true) 否 (false) 处于活动状态

示例:true

组 CSV 文件

组 CSV 示例文件

#group
id,provider,name,description, internal_id
WORLD,Native Directory,WORLD,Contains all users,611

在本示例中,使用组 CSV 文件在 Native Directory 中创建 WORLD 组,组 ID 为 WORLD,说明为 Contains all users,内部 ID 为 611

表 J-4 组实体属性

属性 说明和示例
id
组标识符

示例:WORLD

provider
可选:组的源用户目录

示例:

name
组名

示例:WORLD

description
可选:组说明

示例:Contains all users

internal_id
为组自动生成的内部标识

示例:611

注意:请勿在导出的内容中修改内部 ID 列数据。

角色 CSV 文件

角色 CSV 示例文件

#role
id,product_type,name,description
Viewer,hp–11.1.1,Viewer,Viewer

在本示例中,使用角色 CSV 文件为产品 HP–11.1.1Oracle Hyperion Planning 11.1.1 版)创建聚合角色,角色 ID 为 Viewer,角色名称为 Viewer,说明为 Viewer。产品类型表示聚合角色所属的产品。

表 J-5 角色实体属性

属性 说明和示例
id
角色标识符

示例:Designer_rep

product_type
角色所属的产品类型(以产品代码-产品版本表示)

示例:HP–11.1.1

name
角色名称

示例:Viewer

description
可选:角色说明

示例:Viewer

设置 CSV 文件

设置 CSV 示例文件

#provisioning
app_id,product_type,role_id,user_id,group_id
Planning,hp–11.1.1,Provisioning Manager,pturner,testgroup

在本示例中,使用设置 CSV 文件为 Planning 应用程序创建角色分配。角色 ID 为 Provisioning Manager,属于 HP–11.1.1 产品类型。为用户 pturner 和组 testgroup 设置了此角色。

表 J-6 设置实体属性

属性 说明和示例
app_id
角色所属的应用程序

示例:Planning

product_type
角色所属的产品类型(以产品代码-产品版本表示)

示例:hp–11.1.1

role_id
唯一的角色标识符

示例: native://DN=cn=HUB:2,ou=HUB,ou=Roles,dc=css,dc=hyperion,dc=com?ROLE

user_id
设置了角色的用户的唯一标识符

示例:pturner

group_id
设置了角色的组的唯一标识符

示例:testgroup

授权列表 CSV 文件

授权列表 CSV 示例文件

#delegated list
id,name,description,manager_id,manager_provider,user_id,user_provider,group_id,group_provider
testlist,testlist,my_list,admin,Native Directory,,testGroup,NativeDirectory
在本示例中,授权列表 CSV 文件用于创建授权列表,其列表 ID 和名称为 testlist,说明为 my_list。Native Directory 中定义的 admin 用户是此列表的授权管理员,允许 admin 管理 Native Directory 中定义的 testGroup

表 J-7 授权列表实体属性

属性 说明和示例
id
列表标识符,通常与列表名称相同

示例:testlist

name
授权列表的名称

示例:testlist

description
授权列表的说明

示例:my_list

manager_id
管理列表的用户或组的唯一标识符。每位管理员必须以单独的定义进行标识。

示例:admin

manager_provider
存储管理员帐户的用户目录

示例:Native Directory

user_id
列表用户成员的唯一标识符。每位成员必须以单独的定义进行标识。

示例:admin

user_provider
存储用户成员帐户的用户目录。

示例:Native Directory

group_id
作为列表成员的组的唯一标识符。每位成员必须以单独的定义进行标识。

示例:myGroup

group_provider
存储组帐户的用户目录

示例:Native Directory