assignRole

將角色指派給 ANSI 或 UTF-8 編碼的 CSV 檔案中包含其登入 ID 的使用者 (包含執行此命令的使用者)。使用此命令將使用者指派給預先定義的角色或屬於 Planning、Financial Consolidation and Close、Tax Reporting、Account Reconciliation 或 Oracle Enterprise Data Management Cloud 應用程式的應用程式角色。

註：

您無法使用此命令將應用程式角色指派給 Profitability and Cost Management 和 Narrative Reporting 應用程式，這些應用程式不支援指派應用程式角色至使用者。

使用此命令之前，使用 uploadFile 命令將檔案上傳至環境。檔案格式如下：

User Login
jane.doe@example.com
jdoe

請參閱 Oracle Cloud 快速入門中的指派一個角色給多個使用者。

註：

檔案中所含的使用者登入值不區分大小寫。
使用雙引號括住包含空格字元的角色名稱。

當命令執行完成時，EPM Automate 會在主控台列印每個失敗項目的相關資訊。請複查此資訊以瞭解 CSV 檔案中部分項目命令執行失敗的原因。

適用於

Planning、Planning 模組、FreeForm、Financial Consolidation and Close、Tax Reporting、Account Reconciliation、Profitability and Cost Management、Enterprise Profitability and Cost Management、Oracle Enterprise Data Management Cloud、Narrative Reporting、Strategic Workforce Planning 及 Sales Planning。

必要角色

若要指派預先定義的角色：

傳統環境：識別網域管理員和任何預先定義的角色 (服務管理員、超級使用者、使用者或檢視者)
OCI 環境：服務管理員或識別網域管理員及任何預先定義的角色 (服務管理員、超級使用者、使用者或檢視者)

若要指派應用程式角色：服務管理員或「存取控制管理員」

用法

epmautomate assignRole FILE_NAME ROLE，其中：

FILE_NAME 是包含使用者登入 ID 的 CSV 檔案名稱。指定小寫的 CSV 副檔名。
ROLE 為下列其中一項。此值不區分大小寫：
- 如果您要將使用者指派給預先定義的識別網域角色，ROLE 應該識別適用於服務的預先定義角色。請參閱管理員適用的 Oracle Enterprise Performance Management Cloud 快速入門中的瞭解預先定義的角色。
  如需這些角色的描述，請參閱管理 Oracle Enterprise Performance Management Cloud 的存取控制中的管理應用程式層級的角色指派
- 如果您要將使用者指派給應用程式角色，ROLE 應該識別屬於目前環境中應用程式的角色。應用程式角色列在存取控制的角色頁籤中。如需每個商業程序的應用程式角色描述，請參閱管理 Oracle Enterprise Performance Management Cloud 的存取控制中的以下主題：

範例

將使用者指派給預先定義的識別網域角色：
epmautomate assignRole admin_role_file.csv "Service Administrator"
將使用者指派給應用程式角色：
epmautomate assignRole example_file.csv "Task List Access Manager"