simulateConcurrentUsage

Führt verschiedene gleichzeitige Vorgänge in einer Umgebung aus, wobei Benutzer simuliert werden.

Mit diesem Befehl kann die Performance der Umgebung validiert werden, um zu prüfen, ob die Antwortzeit akzeptabel ist, wenn der Service während bestimmter Vorgänge belastet ist, die von einer bestimmten Anzahl von Benutzern ausgeführt werden. Dieser Befehl kann zum Beispiel verwendet werden, um die Performance zu messen, wenn 50 Benutzer unter Verwendung verschiedener POVs gleichzeitig ein Formular öffnen. Damit werden Selfservice-Belastungstests für Umgebungen ermöglicht.

Mit diesem Befehl wird die Simulation ausgeführt, indem die angegebenen Vorgänge für eine bestimmte Anzahl von Benutzern und Iterationen ausgeführt werden. Dabei werden mehrere Iterationen ausgeführt, um die Mindestdauer, die Höchstdauer und die Durchschnittsdauer eines bestimmten Vorgangs zu berechnen. Der Befehl unterstützt die folgenden Vorgänge zur Ausführung von Belastungstests für die gleichzeitige Verwendung:

  • Formulare öffnen
  • Formulare speichern
  • Geschäftsregeln ausführen
  • Datenregeln ausführen
  • Ad-hoc-Raster öffnen
  • Berichte ausführen
  • Bücher ausführen

Note:

Dieser Befehl unterstützt keine Financial Reporting-Berichte und -Bücher, sondern nur Bücher und Berichte aus der Funktion "Berichte" (früherer Name: "Managementberichte").

Dieser Befehl akzeptiert als Eingabe eine ZIP-Datei, die bereits in die Inbox der Umgebung hochgeladen worden sein muss. Die ZIP-Datei muss eine requirement.csv-Datei und die Eingabedateien enthalten, die die in der requirement.csv-Datei enthaltenen Anwendungsfälle unterstützen. Der Befehl simuliert anschließend die Anwendungsfälle und erstellt einen Bericht, der per E-Mail an einen oder mehrere Empfänger gesendet werden kann.

Verwendungsszenario 1: Akzeptanztest der Anwendungsperformance für 50 Benutzer, die ein Formular gleichzeitig öffnen.

Lösung:

  1. Erstellen Sie die Datei requirement.csv mit Einträgen ähnlich den folgenden. Es wird angenommen, dass Sie ein Formular namens Exchange Rates öffnen möchten, das im Ordner Library/Global Assumption/ gespeichert ist: 
    # Type of Operation,Artifact Name,Number of Users,Input File,Additional Info
Open Form, Library/Global Assumption/Exchange Rates,50,open_form_input.csv,
  2. Erstellen Sie die Datei open_form_input.csv mit dem unter Eingabedatei für Formulare öffnen angegebenen Format. Die Datei enthält einen Eintrag, der 50 Mal verwendet wird. Wenn Sie dasselbe Formular mit verschiedenen POVs öffnen möchten, muss die Datei so viele Einträge wie die Anzahl der zu verwendenden POVs enthalten.
  3. Erstellen Sie die Datei userVarMemberMapping.csv mit dem unter Datei "UserVarMemberMapping.csv" erstellen angegebenen Format.
  4. Erstellen Sie eine ZIP-Datei, die die Dateien aus den vorherigen Schritten enthält, und laden Sie sie in die Inbox hoch.
  5. Führen Sie den Befehl simulateConcurrentUsage aus, wobei Sie die in den vorherigen Schritten erstellte ZIP-Datei als Eingabedatei verwenden.

Verwendungsszenario 2: Simulation der Performance bei Anstieg der saisonalen Verwendung, z.B. am Ende des Finanzjahrs. Annahme: 100 Benutzer speichern ein Formular mit einer Verzögerung von sechzig Sekunden zwischen den einzelnen Benutzern.

Lösung:

  1. Erstellen Sie die Datei requirement.csv mit Einträgen ähnlich den folgenden. Es wird angenommen, dass Sie ein Formular namens Accessories Revenue speichern möchten, das im Ordner Library/Dashboards/ gespeichert ist: 
    # Type of Operation,Artifact Name,Number of Users,Input File,Additional Info
Save Form, Library/Dashboards/Accessories Revenue,100,save_form_input.csv,
  2. Erstellen Sie die Datei save_form_input.csv mit dem unter Eingabedatei für Formulare speichern angegebenen Format.
  3. Erstellen Sie die Datei userVarMemberMapping.csv mit dem unter Datei "UserVarMemberMapping.csv" erstellen angegebenen Format.
  4. Erstellen Sie eine ZIP-Datei, die die Dateien aus den vorherigen Schritten enthält, und laden Sie sie in die Inbox hoch.
  5. Führen Sie den Befehl simulateConcurrentUsage aus, wobei Sie die in den vorherigen Schritten erstellte ZIP-Datei als Eingabedatei und die folgenden Eigenschaftswerte verwenden: iteration=1 und lagTime=6.

Gilt für

Planning, Planning Modules, FreeForm, Financial Consolidation and Close, Tax Reporting, Strategic Workforce Planning und Sales Planning.

Erforderliche Rollen

Serviceadministrator. Zur Verwendung der testModes 0, 1 und 2 benötigen Sie außerdem die Rolle Identitätsdomainadministrator.

Verwendung

epmautomate simulateConcurrentUsage INPUT_FILE.zip [iterations=COUNT] [notificationEmails="EMAIL_ADDRESS"] [testMode=0|1|2|3] [lagTime=LAG_TIME], wobei Folgendes gilt:

  • INPUT_FILE.zip ist der Name einer ZIP-Datei, in der Ihre Anwendungsfälle identifiziert werden. Bevor Sie diesen Befehl ausführen, verwenden Sie den Befehl uploadFile (Beispielbefehlssyntax: epmautomate uploadFile "C:/uploads/INPUT_FILE.zip" inbox), um diese Datei in die Inbox hochzuladen. Diese ZIP-Datei muss die folgenden Dateien enthalten:
  • iterations ist eine positive Zahl, die die Anzahl der Wiederholungen angibt, für die ein in der Datei requirement.csv angegebener Anwendungsfall ausgeführt werden soll, um die Antwortzeit zu messen. Wenn kein Wert angegeben ist, wird der Vorgang nur einmal ausgeführt.
  • notificationEmails (optional) gibt die E-Mail-Adressen an, an die die Ergebnisse dieser Befehle gesendet werden. Bei Angabe mehrerer E-Mail-Adressen trennen Sie diese durch ein Semikolon. Schließen Sie die Adressliste außerdem in doppelte Anführungszeichen ein. Wenn kein Wert angegeben ist, werden die Ergebnisse nur an den Benutzer gesendet, der den Befehl initiiert hat. Ausführliche Informationen zu diesem Bericht finden Sie unter Beispiel für einen Bericht zur Simulation der gleichzeitigen Verwendung.
  • [testMode] (optional) gibt den Simulationsmodus für die gleichzeitige Verwendung an. Der Standardwert ist 0.

    Führen Sie den Befehl anschließend mit Modus 3 aus, um die Simulation so oft wie nötig auszuführen. Führen Sie den Befehl schließlich mit Modus 2 aus, um die simulierten Benutzer zu löschen.

    Folgende Werte werden akzeptiert:
    • 0: Der Standardsimulationsmodus, in dem der Umgebung simulierte Benutzer hinzugefügt werden, denen die Rolle Serviceadministrator zugewiesen wird. Anschließend wird die Simulation ausgeführt, und die simulierten Benutzer werden gelöscht. Dieser Modus ist nützlich, wenn Sie den Test nur einmal durchführen möchten.

      Die simulierten Benutzer haben die folgenden Eigenschaften:

      Vorname: testuser1, testuser2 usw.

      Nachname: testuser1, testuser2 usw.

      E-Mail-Adresse: testuser1@discard.oracle.com, testuser2@discard.oracle.com usw.

      Benutzername: testuser1, testuser2 usw.

    • 1: Der Umgebung werden simulierte Benutzer hinzugefügt, denen die Rolle Serviceadministrator zugewiesen wird. Die Simulation wird nicht ausgeführt, und die Benutzer werden nicht gelöscht.
    • 2: Simulierte Benutzer werden gelöscht. Es werden keine Benutzer erstellt, und die Simulation wird nicht ausgeführt.
    • 3: Die Simulation wird unter Verwendung der bereits vorhandenen simulierten Benutzer ausgeführt. Es werden keine Benutzer hinzugefügt oder gelöscht.

    Wenn Sie die gleichzeitige Verwendung nur einmal ausführen möchten, verwenden Sie testMode=0. So führen Sie eine Reihe von Tests aus:

    • Führen Sie den Befehl zunächst mit testMode=1 aus, um die simulierten Benutzer hinzuzufügen, und weisen Sie ihnen die Rolle Serviceadministrator zu.
    • Führen Sie den Befehl anschließend mit testMode=3 aus, um die Simulation so oft wie nötig auszuführen.
    • Führen Sie den Befehl schließlich mit testMode=2 aus, um die simulierten Benutzer zu löschen.
  • [lagTime] (optional) gibt die Anzahl der Sekunden an (mindestens 5 Sekunden), die der Befehl zwischen zwei Ausführungen jedes in der Datei requirement.csv aufgeführten Anwendungsfalls warten soll. Der Standardwert beträgt 5 Sekunden. Verwenden Sie keine negativen Zahlen (wie -1), Brüche (wie 1/2) oder Dezimalwerte.

    Nachdem ein Benutzer die Ausführung eines Anwendungsfalls aus der Datei requirement.csv initiiert hat, wartet der Befehl für die in diesem Parameter angegebene Anzahl von Sekunden, bevor er die Ausführung des Anwendungsfalls durch den nächsten Benutzer initiiert. Da Benutzeraktivitäten in der Regel nicht gleichzeitig initiiert werden, hilft die Festlegung dieses Parameters, eine realistischere Simulation der Last einer Umgebung zu erstellen.

Beispiel

epmAutomate simulateConcurrentUsage test_simulation.zip iterations=5 notificationEmails="jane.doe@example.com;john.doe@example.com;example@example.com" lagTime=6