importSnapshot

將快照的內容匯入至服務環境。您匯入的快照必須存在預設上傳位置。

使用 uploadFile 命令上傳快照，或使用 copySnapshotFromInstance 命令從另一個例項進行複製。

以下不屬於 Planning、Planning 模組和 FreeForm 應用程式快照：
- 稽核資料
- 工作主控台資料
若要將稽核和工作主控台資料複製到目標環境，請使用 cloneEnvironment 命令或「複製環境」功能。
如果 Planning 商業程序包含已重新命名並被自訂期間成員取代的內建期間成員，則快照匯入可能會失敗。例如，您將內建的 YearTotal 期間成員重新命名為 unused_YearTotal，然後新增具有原始內建成員名稱 (在此範例中為 YearTotal) 的替代類型期間成員。在此情況下，匯入快照時可能會失敗。
快照不會包含資料管理臨時資料表資料。若要匯入此資料，請使用 exportDataManagement 和 importDataManagement 命令，或資料管理系統維護指令碼介面。您可以使用 cloneEnvironment 命令或「複製環境」功能，建立包含資料管理臨時資料表資料的相同環境複本。

您可以使用此命令完成的活動視您的角色而定。

服務管理員只能將應用程式物件匯入至環境。
您需要服務管理員和識別網域管理員角色，才能將應用程式內容匯入至服務環境，以及將識別網域物件 (使用者及其預先定義角色指派) 匯入至環境的識別網域。
如果匯入的快照中參照不在識別網域中的使用者，則 EPM Automate 會建立在識別網域中的使用者，並對每個使用者指派您在命令中指定的預設密碼或臨時的唯一密碼 (如果您在命令中未指定密碼)。依預設，使用者需要在第一次登入時重設密碼。

註：

若為 Account Reconciliation、Profitability and Cost Management 和 Oracle Enterprise Data Management Cloud 以外的業務流程：載入中繼資料時，如果上一次嘗試因為共用成員位於大綱中的基礎成員之前而產生拒絕的記錄，Oracle Enterprise Performance Management Cloud 可能會進行多次載入傳送。這類嘗試可能會增加命令處理時間。
必須將存取控制中群組成員的使用者指派給預先定義的角色。不允許嘗試將未指派給預先定義角色的使用者指派給群組。

適用於

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、Sales Planning 及 Strategic Workforce Planning。

必要角色

服務管理員、指派給「移轉管理員」應用程式角色的超級使用者

必須具備識別網域管理員角色才能匯入使用者與預先定義角色指派。

用法

epmautomate importSnapshot SNAPSHOT_NAME [importUsers=true|false] [userPassword=DEFAULT_PASSWORD] [resetPassword=true|false]

，其中：

SNAPSHOT_NAME 是預設上傳位置中的快照名稱。
importUsers (選擇性) 指定是否從快照匯入使用者和其預先定義的角色指派。預設值為 false。如果來源快照包含新使用者的資料，或已將新角色指派給目前使用者，請使用 importUsers=true 將使用者與預先定義角色指派匯入識別網域中。
使用者登入值不區分大小寫。例如，使用者登入值 jane.doe@example.com 會視為與 Jane.Doe@Example.com 或其任何大小寫變化相同。如有任何變化與識別網域中現有的使用者登入相符，此命令便不會從快照匯入該使用者。
註：
- 如果有不是識別網域管理員的使用者執行匯入作業，則使用者及其預先定義角色的匯入作業會失敗。系統會將下列錯誤訊息記錄在「移轉狀態報表」中：無法匯入外部目錄物件 ARTIFACT_NAME。未授權使用者 USER_NAME 執行此作業。該使用者必須擁有「識別網域管理員」角色，才能執行此作業。
- 如果您不是在匯入使用者，且來源快照中的使用者沒有被指派給目標環境上的預先定義角色，便會顯示錯誤 (EPMIE-00070：匯入指派的角色期間找不到使用者。)。
- 對使用者預先定義角色的變更將根據來源快照中指派的角色更新。但是，將不會移除目標中的角色指派來符合來源快照中的角色指派。例如，假設已將 jdoe 指派至目標環境中的超級使用者預先定義角色，但是在來源快照中只有使用者角色。在此情況下，此命令會將 jdoe 指派至使用者角色，而不會移除目標環境中的超級使用者角色指派。
- 如果現有使用者不存在於來源快照中，此命令不會從目標環境刪除現有的使用者。例如，jdoe 在目標環境中有一個帳戶，但是在來源快照中並沒有此帳戶。在此情況下，不會刪除目標環境中 jdoe 的帳戶。
- 此命令會新增目標環境中不存在的使用者；但即使與來源快照有所不同，也不會更新目標環境中目前的使用者特性。例如，如果 jdoe 的姓氏在來源快照中的拼字與目標環境中不同，將不會在目標環境變更其姓氏。
- 如果現有使用者的密碼與來源快照不同，此命令不會變更目標環境中現有使用者的密碼。
userPassword (選擇性) 表示要指派給識別網域中建立之新使用者的預設密碼。您指定的密碼必須符合最低密碼需求。如果您未指定此參數值，則會對每個使用者指派唯一的臨時密碼。
resetPassword (選擇性) 指出新使用者第一次登入時是否必須變更密碼。預設值為真，需要新使用者在第一次登入時變更密碼。若此值設為 true，則新使用者將會收到一封啟用帳戶電子郵件，其中會提示變更密碼。

範例

僅匯入應用程式物件：epmautomate importSnapshot April16FullApp
匯入應用程式和識別網域物件 (需要服務管理員與識別網域管理員角色)：
- 對每個新使用者指派唯一的臨時密碼，並強制他們在第一次登入之後重設密碼：
  epmautomate importSnapshot April16FullApp importUsers=true
- 指派特定密碼並允許使用者選擇不變更該密碼。不建議用於匯入至生產環境：
  epmautomate importSnapshot April16FullApp importUsers=true userPassword=P@ssw0rd1 resetPassword=false