simulateConcurrentUsage

Exécute différentes opérations simultanées dans un environnement en simulant des utilisateurs.

Cette commande peut être utilisée pour valider les performances de l'environnement et vérifier que le temps de réponse est acceptable lorsque le service est soumis à une charge pendant des opérations spécifiques exécutées par un nombre donné d'utilisateurs. Par exemple, cette commande peut être utilisée pour mesurer les performances si 50 utilisateurs ouvrent simultanément un formulaire à l'aide de différents PDV. Elle permet de tester les environnements dans des conditions de charge, en libre-service.

Cette commande effectue la simulation en exécutant les opérations indiquées pour un nombre donné d'utilisateurs et d'itérations. Elle exécute plusieurs itérations pour calculer les durées minimale, maximale et moyenne d'une opération particulière. Elle prend en charge les opérations ci-après pour effectuer des tests de charge d'utilisation simultanée :

Ouverture de formulaires
Enregistrement de formulaires
Exécution de règles métier
Exécution d'ensembles de règles métier
Exécution de règles de données
Ouverture de grilles ad hoc
Exécution de rapports
Exécution de liasses

Note:

Cette commande ne prend pas en charge les rapports et les liasses Financial Reporting ; elle ne prend en charge que les liasses et les rapports appartenant à Reports (anciennement Management Reports).

Caution:

Cette commande exécute les opérations spécifiées sur l'environnement en cours et peut, selon l'opération, mettre à jour les données de l'environnement. Exécutez cette commande sur des environnements de test. Il est déconseillé d'exécuter cette commande dans des environnements de production.

Cette commande accepte en tant qu'entrée un fichier ZIP, qui doit déjà avoir été chargé dans la boîte de réception de l'environnement. Le fichier ZIP contient un fichier requirement.csv et les fichiers d'entrée qui prennent en charge les cas d'emploi inclus dans requirement.csv. Le fichier ZIP peut éventuellement contenir un fichier userVarMemberMapping.csv afin de fournir le mapping de membre de variable utilisateur, un fichier options. xml afin de fournir des options Oracle Smart View for Office pour certains cas d'emploi, et un fichier users.csv afin de fournir les noms d'utilisateur et les mots de passe des utilisateurs déjà existants à utiliser plutôt que de créer d'autres utilisateurs. La commande simule alors les cas d'emploi et crée un rapport pouvant être envoyé par courriel à des destinataires.

Note:

Cette commande ne génère pas de soumission Fournir des commentaires. Vous pouvez utiliser la fonctionnalité Fournir des commentaires (reportez-vous à la section Aider Oracle à collecter des informations de diagnostic à l'aide de l'utilitaire Fournir des commentaires du guide Mise en route d'Oracle Enterprise Performance Management Cloud pour les administrateurs) à partir d'un écran de processus métier, de l'API REST Fournir des commentaires ou de la commande feedback pour générer une soumission Fournir des commentaires afin d'obtenir des détails sur l'environnement après l'exécution de la simulation.

Scénario d'utilisation 1 : test d'acceptation des performances de l'application pour 50 utilisateurs ouvrant simultanément un formulaire.

Solution :

Créez un fichier requirement.csv contenant des entrées semblables aux suivantes, en supposant que vous souhaitez ouvrir un formulaire nommé Exchange Rates stocké dans le dossier Library/Global Assumption/ :
```
# Type of Operation,Artifact Name,Number of Users,Input File,Additional Info
Open Form, Library/Global Assumption/Exchange Rates,50,open_form_input.csv,
```
Créez un fichier open_form_input.csv à l'aide du format indiqué dans la section Fichier d'entrée d'ouverture de formulaire. Ce fichier comportera une entrée qui sera utilisée 50 fois. Si vous souhaitez ouvrir le même formulaire avec différents PDV, vous aurez autant d'entrées que de PDV à utiliser.
Créez userVarMemberMapping.csv à l'aide du format spécifié dans Création du fichier UserVarMemberMapping.csv si le mapping de membre de variable utilisateur doit être défini.
Exportez les options Smart View dans le fichier options.xml, si les options Smart View doivent être utilisées. Pour plus de détails, reportez-vous à la section Création du fichier options.xml.
Créez un fichier ZIP contenant les fichiers des étapes précédentes et chargez-le dans la boîte de réception.
Exécutez la commande simulateConcurrentUsage en utilisant le fichier ZIP de l'étape précédente comme fichier d'entrée.

Scénario d'utilisation 2 : simulation des performances en cas d'augmentation saisonnière de l'utilisation, par exemple, à la fin de l'exercice financier. Hypothèse : 100 utilisateurs enregistrent un formulaire avec un décalage de six secondes entre chaque utilisateur.

Solution :

Créez un fichier requirement.csv contenant des entrées semblables aux suivantes, en supposant que vous souhaitez enregistrer un formulaire nommé Accessories Revenue stocké dans le dossier Library/Dashboards/ :
```
# Type of Operation,Artifact Name,Number of Users,Input File,Additional Info
Save Form, Library/Dashboards/Accessories Revenue,100,save_form_input.csv,
```
Créez un fichier save_form_input.csv à l'aide du format indiqué dans la section Fichier d'entrée d'enregistrement de formulaire.
Créez userVarMemberMapping.csv à l'aide du format spécifié dans Création du fichier UserVarMemberMapping.csv si le mapping de membre de variable utilisateur doit être défini.
Exportez les options Smart View dans le fichier options.xml, si les options Smart View doivent être utilisées. Pour plus de détails, reportez-vous à la section Création du fichier options.xml.
Créez un fichier ZIP contenant les fichiers des étapes précédentes et chargez-le dans la boîte de réception.
Exécutez la commande simulateConcurrentUsage en utilisant le fichier ZIP de l'étape précédente comme fichier d'entrée, ainsi que les valeurs de propriété iteration=1 et lagTime=6.

Champ d'application

Planning, modules Planning, FreeForm, Financial Consolidation and Close, Tax Reporting, Strategic Workforce Planning et Sales Planning.

Rôles requis

Administrateur de service. Vous devez également disposer du rôle Administrateur de domaine d'identité pour utiliser testMode 0, 1 et 2.

Syntaxe

epmautomate simulateConcurrentUsage INPUT_FILE.zip [iterations=COUNT] [notificationEmails="EMAIL_ADDRESS"] [testMode=0|1|2|3|4] [lagTime=LAG_TIME] où :

INPUT_FILE.zip est le nom du fichier ZIP qui identifie les cas d'emploi. Utilisez la commande uploadFile (exemple de syntaxe de commande : epmautomate uploadFile "C:/uploads/INPUT_FILE.zip" inbox) pour charger ce fichier vers la boîte de réception avant d'exécuter cette commande. Le fichier ZIP doit contenir les fichiers suivants :
- Un fichier CSV de cas d'emploi nommé requirement.csv. Chaque ligne du fichier CSV identifie le type d'opération à effectuer, le nom d'artefact, le nombre d'utilisateurs simultanés, le fichier d'entrée indiquant les détails de l'opération et d'autres informations relatives à chaque cas d'emploi. Reportez-vous à la section Création du fichier requirement.csv.
- Les fichiers d'entrée qui contiennent les détails de chaque opération. Reportez-vous aux rubriques suivantes :
- Ajoutez éventuellement userVarMemberMapping.csv au fichier ZIP d'entrée pour fournir le mapping de membre de variable utilisateur. Reportez-vous à la section Création du fichier UserVarMemberMapping.csv.
- Ajoutez éventuellement options.xml au fichier ZIP d'entrée pour utiliser les options Smart View. Reportez-vous à la section Création du fichier options.xml.
- Ajoutez éventuellement users.csv au fichier ZIP d'entrée pour fournir les noms d'utilisateur et les mots de passe des utilisateurs existants. Reportez-vous à la section Création du fichier users.csv.
iterations est un nombre positif indiquant le nombre de fois où chaque cas d'emploi identifié dans requirement.csv doit être exécuté pour mesurer le temps de réponse. Si aucune valeur n'est indiquée, l'opération n'est exécutée qu'une seule fois.
notificationEmails (facultatif) indique les adresses électroniques auxquelles les résultats de la commande doivent être envoyés. Si vous indiquez plusieurs adresses électroniques, séparez-les à l'aide d'un point-virgule. De plus, placez la liste d'adresses entre guillemets. Si aucune valeur n'est indiquée, les résultats sont envoyés par courriel à l'utilisateur qui a lancé la commande. Pour obtenir des informations détaillées sur ce rapport, reportez-vous à la section Exemple de rapport de simulation d'utilisation simultanée.
[testMode] (facultatif) indique le mode de simulation de l'utilisation simultanée. La valeur par défaut est 0. Les valeurs acceptables sont les suivantes :
- 0 : mode de simulation par défaut ; il ajoute des utilisateurs simulés à l'environnement et leur affecte le rôle Administrateur de service, exécute la simulation, puis supprime les utilisateurs simulés. Ce mode est utile si vous ne voulez exécuter le test qu'une seule fois.
  Les utilisateurs simulés comportent les propriétés suivantes :
  
  Prénom : testuser1, testuser2, etc.
  
  Nom : testuser1, testuser2, etc.
  
  Adresse électronique : testuser1@discard.oracle.com, testuser2@discard.oracle.com, etc.
  
  Nom d'utilisateur : testuser1, testuser2, etc.
- 1 : ajoute des utilisateurs simulés à l'environnement et leur affecte le rôle Administrateur de service. N'exécute pas la simulation et ne supprime pas les utilisateurs simulés.
  Après avoir utilisé ce mode, exécutez la commande en mode 3 pour lancer la simulation autant de fois que nécessaire. A la fin, exécutez la commande en mode 2 pour supprimer les utilisateurs simulés.
- 2 : supprime les utilisateurs simulés. Ne crée pas d'utilisateurs et n'exécute pas la simulation.
- 3 : exécute la simulation avec des utilisateurs simulés existants sans ajouter ni supprimer d'utilisateurs.
- 4 : se sert des utilisateurs définis dans le fichier users.csv inclus dans le fichier ZIP d'entrée pour exécuter la commande. Reportez-vous à la section Création du fichier users.csv. Ce mode ne crée pas d'utilisateurs pour la simulation. A la place, il se sert d'utilisateurs existants.
Si vous ne voulez exécuter l'utilisation simultanée qu'une seule fois, utilisez testMode=0. Pour effectuer une série de tests, procédez comme suit :
- Dans un premier temps, exécutez la commande avec testMode=1 pour ajouter les utilisateurs simulés et leur affecter le rôle Administrateur de service.
- Exécutez ensuite la commande avec testMode=3 pour lancer la simulation autant de fois que nécessaire.
- A la fin, exécutez la commande avec testMode=2 pour supprimer les utilisateurs simulés.
[lagTime] (facultatif) indique le nombre de secondes (5 ou plus) d'attente de la commande entre l'exécution de chaque cas d'emploi de requirement.csv. La valeur par défaut est 5 secondes. N'utilisez ni nombres négatifs (par exemple, -1), ni fractions (par exemple, 1/2), ni valeurs décimales.
Après le lancement de l'exécution d'un cas d'emploi de requirement.csv par un utilisateur, la commande attend le nombre de secondes indiqué par ce paramètre pour lancer l'exécution du cas d'emploi par l'utilisateur suivant. Les activités utilisateur n'étant généralement pas lancées simultanément, la définition de ce paramètre contribue à créer une simulation plus réaliste du chargement dans un environnement.

Exemple

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