assignRole

Assigns a role to users (including the user who runs this command) whose login IDs are included in an ANSI or UTF-8 encoded CSV file. Use this command to assign users to a predefined role or to an application role.

Before using this command, use the uploadFile command to upload files to an environment. The file format is as follows:

User Login
[e-mail]
jdoe

See Assigning One Role to Many Users in Getting Started with Oracle Cloud.

Note:

• User Login values included in the file are not case-sensitive.
• Use double quotation marks to enclose role names that contain space character.

When the command execution finishes, EPM Automate prints information about each failed entry to the console. Review this information to understand why the command execution failed for some entries in the CSV file.

Applies to

Planning, Planning Modules, 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, and Sales Planning.

Required Roles

To assign predefined roles:

• Classic environments: Identity Domain Administrator and any predefined role (Service Administrator, Power User, User, or Viewer)
• OCI environments: Service Administrator, or Identity Domain Administrator and any predefined role (Service Administrator, Power User, User, or Viewer)

To assign application roles: Service Administrator or Access Control - Manage

Usage

epmautomate assignRole FILE_NAME ROLE where:

• FILE_NAME is the name of a CSV file containing user login IDs. Specify the CSV extension in lower case.
• ROLE is one of the following. This value is not case-sensitive:
  • If you are assigning users to predefined identity domain roles, ROLE should identify a predefined role applicable to the service. See Understanding Predefined Roles in Getting Started with Oracle Enterprise Performance Management Cloud for Administrators.

    For a description of these roles, see Managing Role Assignments at the Application Level in Administering Access Control for Oracle Enterprise Performance Management Cloud

  • If you are assigning users to application roles, ROLE should identify a role belonging to the application in the current environment. Application roles are listed in the Roles tab of Access Control. For a description of application roles for each business process, see these topics in Administering Access Control for Oracle Enterprise Performance Management Cloud:

    • Account Reconciliation
    • Enterprise Profitability and Cost Management
    • Planning, FreeForm, Financial Consolidation and Close, and Tax Reporting
    • Profitability and Cost Management
    • Oracle Enterprise Data Management
    • Narrative Reporting

Examples

• Assign users to a predefined identity domain role:

  epmautomate assignRole admin_role_file.csv "Service Administrator"

• Assign users to an application role:

  epmautomate assignRole example_file.csv "Task List Access Manager"