importSnapshot

将快照的内容导入服务环境中。导入的快照必须位于默认上传位置中。

使用 uploadFile 命令上传快照或使用 copySnapshotFromInstance 命令从其他实例复制该快照。

  • 以下内容不属于 Planning、Planning 模块和自由形式应用程序快照的一部分：
    • 审核数据
    • 作业控制台数据
    如果要将审核和作业控制台数据复制到目标环境，请使用 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 模块、自由形式、Financial Consolidation and Close、Tax Reporting、Account Reconciliation、Profitability and Cost Management、Enterprise Profitability and Cost Management、Oracle Enterprise Data Management Cloud、销售规划 和战略性人员规划。

所需角色

服务管理员、分配了迁移管理员应用程序角色的超级用户

身份域管理员角色是导入用户和预定义角色分配所必需的。

用法

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: Failed to find user during assigned roles import)。
    • 对用户预定义角色的更改将根据源快照中分配的角色进行更新。但是，不会为了匹配源快照中的角色分配而删除目标中的角色分配。例如，假设 jdoe 分配给目标环境中的超级用户预定义角色，但在源快照中只有用户角色。在这种情况下，此命令会将 jdoe 分配给用户角色，并且不会删除目标环境中的超级用户角色分配。
    • 如果源快照中不存在现有用户，此命令不会从目标环境中删除这些用户。例如，jdoe 在目标环境中有一个帐户，但此帐户在源快照中不存在。在这种情况下，目标环境中 jdoe 的该帐户不会被删除。
    • 此命令添加目标环境中不存在的用户；它不会更新目标环境中的当前用户属性，即使源快照中的这些属性不同。例如，如果源快照中 jdoe 的姓氏在目标环境中拼写不同，则不会在目标环境中进行更改。
    • 此命令不会更改目标环境中现有用户的密码，即使它在源快照中有所不同。
  • userPassword（可选）指示要分配给在身份域中创建的新用户的默认密码。您指定的密码必须符合密码的最低要求。如果没有为该参数指定值，则会为每个用户分配一个唯一的临时密码。
  • resetPassword（可选）指示新用户是否必须在首次登录时更改密码。默认值为 true，要求新用户在首次登录时更改密码。如果此值设置为 true，则新用户将收到提示其更改密码的帐户激活电子邮件。

示例

  • 仅导入应用程序对象：epmautomate importSnapshot April16FullApp
  • 导入应用程序和身份域对象（需要服务管理员和身份域管理员角色）：
    • 为每个新用户分配一个唯一的临时密码，并强制新用户在首次登录之后重置其密码：

      epmautomate importSnapshot April16FullApp importUsers=true

    • 分配特定的密码并允许用户不更改密码（如果他们选择这样做）。对于向生产环境的导入，不建议使用此方式：

      epmautomate importSnapshot April16FullApp importUsers=true userPassword=P@ssw0rd1 resetPassword=false