importSnapshot

Importiert die Inhalte eines Snapshots in die Serviceumgebung. Die importierten Snapshots müssen am Standardspeicherort zum Hochladen verfügbar sein.

Verwenden Sie den Befehl uploadFile, um einen Snapshot hochzuladen, oder den Befehl copySnapshotFromInstance, um ihn aus einer anderen Instanz zu kopieren.

  • Folgende Daten sind nicht Teil der Anwendungs-Snapshots für Planning, Planning Modules und FreeForm:
    • Auditdaten
    • Daten der Jobkonsole
    Verwenden Sie den Befehl cloneEnvironment oder das Feature "Umgebung klonen", wenn Sie Audit- und Jobkonsolendaten in die Zielumgebung kopieren möchten.

    Der Snapshot-Import kann unter Umständen nicht erfolgreich verlaufen, wenn der Planning-Geschäftsprozess ein umbenanntes vordefiniertes Periodenelement enthält, das durch ein benutzerdefiniertes Periodenelement ersetzt wurde. Beispiel: Sie haben das vordefinierte Periodenelement YearTotal in unused_YearTotal umbenannt und dann ein Periodenelement mit einem anderen Typ mit dem ursprünglichen vordefinierten Elementnamen (in diesem Beispiel YearTotal) hinzugefügt. In diesem Szenario kann es vorkommen, dass der Import des Snapshots nicht erfolgreich verläuft.

  • Snapshots enthalten nicht die Staging-Tabellendaten für die Komponente Datenmanagement. Um diese Daten zu importieren, verwenden Sie die Befehle exportDataManagement und importDataManagement oder die Schnittstelle für Systemwartungsskripte der Komponente Datenmanagement. Sie können den Befehl cloneEnvironment oder das Feature "Umgebung klonen" verwenden, um eine identische Kopie der Umgebung zu erstellen, einschließlich der Staging-Tabellendaten für die Komponente Datenmanagement.

Die Aktivitäten, die Sie mit diesem Befehl ausführen können, hängen von Ihrer Rolle ab.

  • Serviceadministratoren können nur Anwendungsartefakte in eine Umgebung importieren.
  • Sie benötigen die Rolle Serviceadministrator und die Rolle Identitätsdomainadministrator, um Anwendungsinhalt in die Serviceumgebung und Identitätsdomainartefakte (Benutzer und deren vordefinierte Rollenzuweisungen) in die Identitätsdomain der Umgebung zu importieren.

    Wenn ein Benutzer, der nicht in der Identitätsdomain enthalten ist, in dem Snapshot referenziert wird, der importiert wird, erstellt EPM Automate einen Benutzer in der Identitätsdomain und weist das Standardkennwort zu, das Sie in dem Befehl angeben. Alternativ wird jedem Benutzer ein temporäres, eindeutiges Kennwort zugewiesen, wenn Sie in dem Befehl kein Kennwort angeben. Standardmäßig muss der Benutzer das Kennwort bei der ersten Anmeldung neu festlegen.

Hinweis:

  • Geschäftsprozesse außer Account Reconciliation, Profitability and Cost Management und Oracle Enterprise Data Management Cloud: Beim Laden von Metadaten kann Oracle Enterprise Performance Management Cloud mehrere Ladedurchgänge vornehmen, wenn der vorherige Versuch zu abgelehnten Datensätzen geführt hat, da gemeinsame Elemente vor Basiselementen in der Modellstruktur stehen. Diese Versuche können die Befehlsverarbeitungszeit verlängern.
  • Benutzer, die Mitglieder von Gruppen in Zugriffskontrolle sind, müssen einer vordefinierten Rolle zugewiesen sein. Der Versuch, einen Benutzer, der keiner vordefinierten Rolle zugewiesen ist, einer Gruppe zuzuweisen, ist nicht zulässig.

Gilt für

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, Sales Planning und Strategische Personalplanung.

Erforderliche Rollen

Serviceadministrator, Poweruser, die der Anwendungsrolle Migrationsadministrator zugewiesen sind

Die Rolle Identitätsdomainadministrator ist zum Importieren von Benutzern und Zuweisungen von vordefinierten Rollen erforderlich.

Verwendung

epmautomate importSnapshot SNAPSHOT_NAME [importUsers=true|false] [userPassword=DEFAULT_PASSWORD] [resetPassword=true|false], wobei Folgendes gilt:
  • SNAPSHOT_NAME ist der Name eines Snapshots am Standardspeicherort zum Hochladen.
  • importUsers (optional) gibt an, ob Benutzer und die zugehörigen vordefinierten Rollenzuweisungen aus dem Snapshot importiert werden sollen. Der Standardwert ist false. Mit importUsers=true können Sie Benutzer und vordefinierte Rollenzuweisungen in die Identitätsdomain importieren, wenn der Quell-Snapshot Daten zu neuen Benutzern enthält oder wenn aktuellen Benutzern neue Rollen zugewiesen wurden.

    Bei Benutzeranmeldewerten wird nicht zwischen Groß- und Kleinschreibung unterschieden. Beispiel: Der Benutzeranmeldewert jane.doe@example.com wird genauso wie Jane.Doe@Example.com oder jede andere Variation der Groß-/Kleinschreibung behandelt. Wenn eine Variation mit einer vorhandenen Benutzeranmeldung in der Identitätsdomain übereinstimmt, wird der Benutzer mit diesem Befehl nicht aus dem Snapshot importiert.

    Hinweis:

    • Der Import von Benutzern und ihren vordefinierten Rollen verläuft nicht erfolgreich, wenn ein Benutzer, der kein Identitätsdomainadministrator ist, den Importvorgang ausführt. Ein Fehler wie der Folgende wird im Migrationsstatusbericht aufgezeichnet: Externes Verzeichnisartefakt ARTIFACT_NAME konnte nicht exportiert werden. Benutzer USER_NAME ist nicht zur Ausführung dieses Vorgangs autorisiert. Der Benutzer muss über die Rolle "Identitätsdomainadministrator" verfügen, um diesen Vorgang auszuführen.
    • Wenn Sie keine Benutzer importieren, und ein Benutzer im Quell-Snapshot nicht zu einer vordefinierten Rolle in der Zielumgebung zugewiesen ist, wird ein Fehler (EPMIE-00070: Benutzer konnte beim Import von zugewiesenen Rollen nicht gefunden werden) angezeigt.
    • Änderungen an den vordefinierten Rollen des Benutzers werden basierend auf den im Quell-Snapshot zugewiesenen Rollen aktualisiert. Rollenzuweisungen im Ziel werden jedoch nicht entfernt, damit sie denen im Quell-Snapshot entsprechen. Beispiel: jdoe ist der vordefinierten Rolle Poweruser in der Zielumgebung zugewiesen, hat aber nur die Rolle Benutzer im Quell-Snapshot. In dieser Situation weist dieser Befehl jdoe der Rolle Benutzer zu und entfernt nicht die Zuweisung der Rolle Poweruser in der Zielumgebung.
    • Mit diesem Befehl werden Benutzer, die nicht im Quell-Snapshot vorhanden sind, nicht aus der Zielumgebung gelöscht. Beispiel: jdoe hat einen Account in der Zielumgebung, der aber nicht im Quell-Snapshot vorhanden ist. In dieser Situation wird der Account von jdoe nicht aus der Zielumgebung gelöscht.
    • Mit diesem Befehl werden Benutzer hinzugefügt, die nicht in der Zielumgebung vorhanden sind. Aktuelle Benutzereigenschaften werden nicht in der Zielumgebung aktualisiert, selbst wenn sie sich von denen im Quell-Snapshot unterscheiden. Beispiel: Der Nachname von jdoe ist im Quell-Snapshot anders geschrieben als in der Zielumgebung. Diese Änderung wird nicht in der Zielumgebung vorgenommen.
    • Mit diesem Befehl werden Benutzerkennwörter in der Zielumgebung nicht geändert, selbst wenn sie im Quell-Snapshot anders lauten.
  • userPassword (optional) gibt das Standardkennwort an, um neue Benutzer zuzuweisen, die in der Identitätsdomain erstellt werden. Das angegebene Kennwort muss die Mindestanforderungen für Kennwörtert erfüllen. Wenn Sie für diesen Parameter keinen Wert angeben, wird jedem Benutzer ein eindeutiges temporäres Kennwort zugewiesen.
  • resetPassword (optional) gibt an, ob der neue Benutzer das Kennwort bei der ersten Anmeldung ändern muss. Der Standardwert ist true. Wenn dieser Wert angegeben ist, müssen neue Benutzer das Kennwort bei der ersten Anmeldung ändern. Wenn Sie diesen Wert auf true setzen, erhalten neue Benutzer E-Mails zur Accountaktivierung, in denen sie aufgefordert werden, das Kennwort zu ändern.

Beispiele

  • So importieren Sie ausschließlich Anwendungsartefakte: epmautomate importSnapshot April16FullApp
  • So importieren Sie Anwendungs- und Identitätsdomainartefakte (hierfür sind die Rollen Serviceadministrator und Identitätsdomainadministrator erforderlich):
    • So weisen Sie jedem neuen Benutzer ein eindeutiges temporäres Kennwort zu und erzwingen, dass die Benutzer ihr Kennwort nach der ersten Anmeldung neu festlegen:

      epmautomate importSnapshot April16FullApp importUsers=true

    • So weisen Sie ein spezifisches Kennwort zu und verhindern, dass Benutzer dieses bei Bedarf ändern. Nicht für Importvorgänge in Produktionsumgebungen empfohlen:

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