simulateConcurrentUsage

透過模擬使用者，以在環境中執行不同的並行作業。

此命令可用來驗證環境的效能，以確認當特定數量的使用者執行特定作業時，此時處於負載狀態的服務，其回應時間是否可接受。例如，此命令可用來測試 50 個使用者同時使用不同 POV 開啟表單時的效能。它允許對環境進行自助負載測試。

此命令會針對指定的使用者和重複執行數目，執行指定的作業來執行模擬。它會執行多次重複執行來計算特定作業的最短時間、最長時間和平均時間。它支援下列作業來執行並行使用量負載測試：

  • 開啟表單
  • 儲存表單
  • 執行商業規則
  • 執行商業規則集
  • 執行資料規則
  • 開啟特設方格
  • 執行報表
  • 執行報表簿

Note:

此命令不支援 Financial Reporting 報表和報表簿；它只支援屬於「報表」(先前稱為「管理報表」) 的報表簿和報表。

Caution:

此命令會在目前的環境上執行指定的操作，而且可能會 (根據操作) 更新環境中的資料。在測試環境上執行此命令。建議不要在生產環境上執行此命令。

此命令接受 ZIP 檔案作為輸入，該檔案必須已上傳至環境的收件匣。ZIP 檔案包含一個 requirement.csv 檔案以及一個能支援 requirement.csv 中包含之使用案例的輸入檔案。(選擇性) ZIP 檔案可能包含提供使用者變數成員對應的 userVarMemberMapping.csv、針對某些案例提供 Oracle Smart View for Office 選項的 options.xml 檔案，以及提供要使用之現有使用者 (而非建立新使用者) 的使用者名稱與密碼的 users.csv 檔案。然後，該命令會模擬使用案例並建立一份能透過電子郵件傳送給一個或多位收件者的報表。

Note:

此命令不會產生「提供意見」提交。在執行模擬之後，您可以使用來自商業程序畫面的「提供意見」(請參閱管理員適用的 Oracle Enterprise Performance Management Cloud 入門中的使用提供意見公用程式協助 Oracle 收集診斷資訊) 選項、提供意見 REST API 或 feedback 命令來產生「提供意見」提交以取得環境的詳細資料。

使用案例 1：針對 50 位同時開啟表單的使用者，進行應用程式效能驗收測試。

解決方案：

  1. 使用類似下列內容的項目建立 requirement.csv，假設您想開啟儲存在 Library/Global Assumption/ 資料夾且名為 Exchange Rates 的表單： 
    # 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. 使用開啟表單輸入檔案 中指定的格式，建立 open_form_input.csv。您在這個檔案中會有一個項目，它會被使用 50 次。若要使用不同 POV 開啟相同的表單，則您有的項目數會與 POV 數目相同。
  3. 如果需要設定使用者變數成員對應，請使用 建立 UserVarMemberMapping.csv 檔案 中指定的格式建立 userVarMemberMapping.csv。
  4. 如果需要設定 Smart View 選項，請將 Smart View 選項匯出至 options.xml。請參閱建立 options.xml 檔案 以取得詳細資料。
  5. 建立 ZIP 檔案，其中必須包含先前步驟中的檔案，然後將 ZIP 檔案上傳至收件匣。
  6. 使用上一個步驟中的 ZIP 檔案作為輸入檔案來執行 simulateConcurrentUsage 命令。

使用案例 2：模擬季節性使用量增加時的效能，例如在會計年度結束時。假設：100 個使用者儲存表單，每個使用者之間的延遲時間為 6 秒。

解決方案：

  1. 使用類似下列內容的項目建立 requirement.csv，假設您想儲存已儲存至 Library/Dashboards/ 資料夾且名為 Accessories Revenue 的表單： 
    # Type of Operation,Artifact Name,Number of Users,Input File,Additional Info
Save Form, Library/Dashboards/Accessories Revenue,100,save_form_input.csv,
  2. 使用儲存表單輸入檔案中指定的格式，建立 save_form_input.csv。
  3. 如果需要設定使用者變數成員對應，請使用建立 UserVarMemberMapping.csv 檔案 中指定的格式建立 userVarMemberMapping.csv。
  4. 如果需要設定 Smart View 選項，請將 Smart View 選項匯出至 options.xml。請參閱建立 options.xml 檔案以取得詳細資料。
  5. 建立 ZIP 檔案，其中必須包含先前步驟中的檔案，然後將 ZIP 檔案上傳至收件匣。
  6. 使用上一個步驟中的 ZIP 檔案作為輸入檔案，再加上 iteration=1 和 lagTime=6 這些特性值，執行 simulateConcurrentUsage 命令。

適用於

Planning、Planning 模組、FreeForm、Financial Consolidation and Close、Tax Reporting、Strategic Workforce Planning 和 Sales Planning。

必要角色

服務管理員。您也需要識別網域管理員角色，才能使用 testModes 0、1 及 2。

用法

epmautomate simulateConcurrentUsage INPUT_FILE.zip [iterations=COUNT] [notificationEmails="EMAIL_ADDRESS"] [testMode=0|1|2|3|4] [lagTime=LAG_TIME]，其中：

  • INPUT_FILE.zip 是 ZIP 檔案的名稱，此檔案會識別您的使用案例。在執行此命令之前，使用 uploadFile 命令 (範例命令語法 epmautomate uploadFile "C:/uploads/INPUT_FILE.zip" inbox) 將此檔案上傳至收件匣。這個 ZIP 檔案必須包含下列檔案：
  • iterations 是一個正數，它指出為了測量回應時間，在 requirement.csv 中識別的每一個使用案例應該執行的次數。如果未指定，則該作業只會執行一次。
  • notificationEmails (選擇性) 會指出要將此命令的結果寄送到哪些電子郵件地址。如果指定多個電子郵件地址，請使用分號分隔它們。此外，請將地址清單括在雙引號中。如果未指定，系統會將結果寄送給起始該命令的使用者。如需此報表的詳細資訊，請參閱模擬並行使用量報表範例。
  • [testMode] (選擇性) 會指定並行使用量模擬模式。預設值為 0。可接受的值為：
    • 0：預設模擬模式，它會將模擬的使用者新增至環境中並為其指派服務管理員角色、執行模擬，然後刪除模擬的使用者。如果只想執行一次測試，則這個模式非常實用。

      模擬的使用者具備下列特性：

      名字： testuser1、testuser2 等等

      姓氏： testuser1、testuser2 等等

      電子郵件地址： testuser1@discard.oracle.com、testuser2@discard.oracle.com 等等

      使用者名稱： testuser1、testuser2 等等

    • 1：將模擬的使用者新增至環境並為其指派服務管理員角色。不會執行模擬或刪除模擬的使用者。

      使用此模式之後，請使用模式 3 執行命令，以根據需要的次數執行模擬。最後，使用模式 2 執行命令，以刪除模擬的使用者。

    • 2：刪除模擬的使用者。不建立使用者或執行模擬。
    • 3：使用現有的模擬使用者執行模擬，不新增或刪除使用者。
    • 4：使用輸入 ZIP 檔案中包含的 users.csv 檔案中定義的使用者來執行命令。請參閱建立 users.csv 檔案。此模式不會建立使用者以進行模擬。它會改為使用現有的使用者。

    如果只想執行一次並行使用量，請使用 testMode=0。若要執行一系列的測試，請執行下列動作：

    • 首先，使用 testMode=1 執行命令以新增模擬的使用者，然後將服務管理員角色指派給他們。
    • 然後，使用 testMode=3 執行命令，以根據需要的次數執行模擬。
    • 最後，使用 testMode=2 執行命令，以刪除模擬的使用者。
  • [lagTime] (選擇性) 指定命令在執行 requirement.csv 中的每個使用案例之前，應該先等待的秒數 (5 秒或更長)。預設值為 5 秒。請勿使用負數 (例如 -1)、分數 (例如 1/2) 和小數值。

    一位使用者起始執行 requirement.csv 中的使用案例後，該命令會等待此參數指定的秒數，然後再起始執行下一個使用者的使用案例。由於使用者活動通常不會同時啟動，因此設定此參數有助於建立更真實的環境負載模擬。

範例

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