Shared Services 原生目錄移轉選項

移轉匯入選項

下列清單是 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 檔案是用來建立「原生目錄」中的使用者 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
系統自動為使用者產生的內部 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 檔案是用來建立「原生目錄」中的 WORLD 群組,其中群組 ID 是 WORLD、群組的說明是 Contains all users,而內部 ID 是 611

表格 J-4 群組實體屬性

屬性 說明與範例
id
群組識別碼

範例:WORLD

provider
選擇性:群組的來源使用者目錄

範例:

name
群組名稱

範例:WORLD

description
選用:群組的說明

範例:包含所有使用者

internal_id
系統自動為群組產生的內部 ID

範例:611

注意:請勿修改已匯出內容之內部 ID 欄中的資訊。

適用於角色的 CSV 檔案

適用於角色的 CSV 檔案範例

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

在此範例中,角色 CSV 檔案是用來建立「原生目錄」中的彙總角色,其中角色 ID 是 Viewer,且該角色隸屬於產品 HP–11.1.1 (Oracle Hyperion Planning,版本 11.1.1);角色名稱則是 Viewer,而說明是 Viewer。產品類型會指出彙總角色所屬的產品。

表格 J-5 角色實體屬性

屬性 說明與範例
id
角色識別碼

範例:Designer_rep

product_type
角色所屬的產品類型 (指定為 product code-product version)

範例: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。在「原生目錄」中定義的使用者 admin 是這個清單的委派管理員,他能允許 admin 管理在「原生目錄」中定義的 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