addUsers

使用上傳到環境之 ANSI 或 UTF-8 編碼的逗號分隔值 (CSV) 檔案，在識別網域中，建立一批使用者。同時通知新使用者其使用者名稱與臨時密碼。

您可以使用 uploadFile 命令將檔案上傳至環境。CSV 檔案中的所有欄都是必要欄。此命令會驗證定義中每個欄的值，並顯示用以識別每個遺漏或無效值的錯誤訊息。CSV 檔案格式如下：

First Name,Last Name,Email,User Login
Jane,Doe,jane.doe@example.com,jdoe
John,Doe,john.doe@example.com,john.doe@example.com

如需 CSV 檔案格式的詳細描述，請參閱 Oracle Cloud 快速入門 中的批次匯入使用者帳戶。

匯入檔案中指定的 User Login 值不區分大小寫。例如，值 John.doe@example.com 會視為與 John.Doe@example.com 或其任何大小寫變化相同。

如果 CSV 檔案中的使用者定義符合識別網域中存在的使用者帳戶，則不會對現有使用者帳戶進行任何變更。此命令僅為帳戶資訊包含在檔案中的新使用者建立帳戶。由於使用者帳戶對於識別網域支援的所有環境皆通用，因此，新使用者適用於所有共用識別網域的環境。

當命令執行完成時，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。

必要角色

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

用法

epmautomate addUsers FILE_NAME [userPassword=PASSWORD] [resetPassword=true|false]，其中：

  • FILE_NAME 是包含使用者資訊的 CSV 檔案名稱。包含多位元組字元的輸入檔案必須使用 UTF-8 字元編碼。使用 ANSI 編碼會造成使用者資訊在「我的服務」畫面中的顯示方式出現問題。
  • userPassword (選擇性) 表示識別網域中建立之所有新使用者的預設密碼。如果已指定，此密碼必須符合最低識別網域密碼需求。如果未指定參數，則會對每個使用者指派唯一的臨時密碼。

    如果已指定，則會將 userPassword 參數值用作 CSV 檔案中所有指定使用者的密碼。如果您建立使用者單純是為了進行測試，則您可能會想要指派相同密碼給所有使用者。如果您要建立實際 Oracle Enterprise Performance Management Cloud 使用者並要對每個使用者指派特定密碼，可使用此命令而無需指定 userPassword 選擇性參數值。

  • resetPassword (選擇性) 可指示新使用者第一次登入時是否必須變更密碼。預設值為 true。除非此參數設為 false，否則會強制新使用者在第一次登入時變更密碼。

    如果 resetPassword 設定為 true，此命令會向每個新使用者傳送一封電子郵件，裡面會有帳戶詳細資料 (使用者名稱和密碼)。如果 resetPassword 設定為 false，則不會傳送電子郵件。如果將 resetPassword 設定為 false，則必須指定 userPassword。要不然，就得為每位使用者指派一個唯一的臨時密碼，但由於未傳送電子郵件，使用者也就無法得知密碼，也因此無法登入了。

範例

  • 在識別網域新增具有相同密碼的測試使用者，且不要求他們變更密碼：

    epmautomate addUsers user_file.CSV userPassword=Example@Pwd12 resetPassword=false

  • 將使用臨時密碼的使用者新增至識別網域，並要求他們變更密碼：

    epmautomate addUsers user_file.CSV