Options de ligne de commande
Blue Prism fournit deux utilitaires acceptant les commutateurs de ligne de commande :
- Automate.exe : l'application Blue Prism graphique. Tous les messages ou commentaires provenant de cette application sont transmis visuellement. Un code de retour zéro indique un succès, tandis qu'un code de retour autre que zéro indique une erreur.
- AutomateC.exe : un utilitaire de ligne de commande qui renvoie les messages et les commentaires à la ligne de commande (via une sortie standard). Un code de retour zéro indique un succès, tandis qu'un code de retour autre que zéro indique une erreur.
Conseils :
- Une aide dynamique est disponible pour AutomateC, en utilisant le commutateur /help. Sous Automate.exe, le commutateur /help affichera ce document dans une fenêtre graphique.
- Certains commutateurs nécessitent des paramètres supplémentaires (indiqués ci-dessous par <parameter>), qui doivent suivre le commutateur.
- Les commutateurs et les paramètres sont séparés par des espaces. Si la valeur d'un paramètre contient des espaces ou d'autres caractères spéciaux, elle doit être placée entre guillemets. Par conséquent, la valeur réelle ne peut pas contenir de guillemets. Il faut donc veiller à éviter cela.
- Lorsque vous transmettez XML, vous devez placer la chaîne de caractères xml entre guillemets. Puisque les guillemets sont utilisés pour délimiter le début et la fin de la chaîne de caractères xml des paramètres en entrée standard, Blue Prism vous recommande de délimiter vos attributs xml en utilisant des guillemets simples. Vous pouvez également échapper les guillemets présents en saisissant deux guillemets au lieu d'un seul dans les paramètres xml.
-
Exécutez Blue Prism en tant que ressource machine exclusive à l'utilisateur « admin » :
automate /resourcepc /user admin mypwd
ou pour un utilisateur à authentification unique :
automate /resourcepc /sso
-
Exécutez Blue Prism en tant que ressource machine publique :
automate /resourcepc /public
-
Exécutez un processus sur le PC local :
AutomateC /run "My Scheduled Process" /user admin mypwd
ou pour un utilisateur à authentification unique :
AutomateC /run "My Scheduled Process" /sso
-
Exécutez un processus sur un PC distant avec des paramètres de démarrage :
AutomateC /run "Excel Test" /resource YourPCHostName /user admin mypwd /startp "<inputs><input name='Comment' type='text' value='Hello World' /></inputs>"
-
Démarrez la surveillance d'alerte de processus en arrière-plan sans démarrer l'application Blue Prism principale :
automate /alerts /user admin mypwd
ou pour un utilisateur à authentification unique :
automate /alerts /sso
Automate.exe – Commutateurs disponibles
Offre quelques conseils d'aide rapide sur la sortie standard de la ligne de commande.
Démarre Blue Prism en mode Ressource machine. Le commutateur /public peut être ajouté pour rendre la ressource machine disponible à tous les utilisateurs de Blue Prism. Sinon, il est uniquement disponible pour l'utilisateur spécifié avec l'option /user ou /sso.
Cette option ne doit pas être confondue avec le commutateur /resource.
Uniquement utilisé avec le commutateur /resourcepc. Rend la ressource machine accessible au public, comme décrit dans l'aide des modes d'exécution.
Uniquement utilisé avec le commutateur /resourcepc, il permet d'assurer la sécurité du transport (SSL/TLS) lors des connexions à la ressource machine, en utilisant le certificat avec l'empreinte de pouce donnée, qui doit être installé dans le magasin de certificats de l'utilisateur ou de la machine.
Assurer la sécurité du transport affecte les connexions de Control Room et du planificateur d'événements, ainsi que les services Web affichés qui sont dirigés vers la ressource. Le nom commun dans le certificat doit correspondre à l'adresse utilisée pour se connecter à la ressource, et le client qui se connecte doit faire confiance à l'autorité de certification qui a émis le certificat.
(Avancé) Uniquement utilisé avec le commutateur /resourcepc, il remplace l'emplacement adressable affiché des services Web publiés et les ressources associées telles que les WSDL hébergés sur cet appareil. La valeur spécifiée doit contenir l'adresse complète du chemin d'accès, par exemple : « https://blueprismws.myorg.com:8181 ». Blue Prism ajoute automatiquement /ws/ et les chemins d'accès associés aux ressources disponibles localement.
Il est essentiel que le routage réseau approprié soit appliqué manuellement pour s'assurer que le préfixe spécifié est une adresse valide qui mène à cet appareil.
(Avancé) Uniquement utilisé avec le commutateur /resourcepc, il demande à la ressource d'exécution d'ignorer les communications HTTP reçues sur son port d'écoute. Cette option ne doit être utilisée que lorsque la ressource n'est pas tenue d'afficher les services Web et n'a pas besoin d'être contrôlée via l'interface HTTP.
Au démarrage, attendez que la base de données soit disponible pendant le nombre de secondes spécifié avant d'abandonner. De nouvelles tentatives de connexion sont effectuées par intervalles pendant cette période. Cela peut s'avérer utile sur les petites installations lors de l'exécution d'une ressource machine au démarrage avec un « serveur » de base de données sur la même machine. Dans ce cas, il se peut que la base de données ne soit pas immédiatement prête à accepter des connexions au démarrage de la ressource machine. Par exemple, l'utilisation de /dbwait 120 lance des nouvelles tentatives pendant 2 minutes avant d'abandonner.
Uniquement utilisé avec le commutateur /resourcepc. Le formulaire d'informations de la ressource machine devient invisible par défaut. Vous pouvez l'afficher à nouveau à l'aide du menu contextuel dans la zone de notification (recherchez l'icône suivante : ).
Uniquement utilisé avec le commutateur /resourcepc. La ressource machine ne peut être contrôlée que depuis la machine locale ; les ressources distantes ignorent sa présence.
Uniquement utilisé avec le commutateur /resourcepc. Spécifie le port sur lequel Blue Prism doit devenir disponible en tant que ressource machine. De cette manière, vous pouvez exécuter plusieurs ressources machines à partir d'une même machine.
Cette option peut s'avérer utile dans de rares cas particuliers. Par exemple :
- Remplacement du port par défaut
Si le port par défaut 8181 est déjà utilisé pour un autre service sur votre réseau, vous pouvez en utiliser un autre. Veillez à utiliser le même port pour toutes les ressources machines de votre réseau, sauf si vous ne souhaitez pas le faire pour une raison particulière.
- Utilisation des services de terminal
Lors de l'interaction avec un hôte de services de terminal, Blue Prism ne peut exécuter qu'une seule session à la fois sur chaque ressource machine. Ceci est dû à une restriction technique de l'implémentation des services Terminal Server Microsoft. En exécutant plusieurs ressources machine sur différents ports, une même machine peut exécuter plusieurs sessions normalement.
Il permet de déterminer la ressource machine cible pour les alertes de processus. Si cela n'est pas spécifié, le PC local est utilisé.
Cette option ne doit pas être confondue avec le commutateur /resourcepc.
Utilisé pour fournir des identifiants de connexion Blue Prism lorsque nécessaire. Lorsque votre base de données est configurée pour une authentification unique, vous devez utiliser le commutateur /sso à la place.
Demande à Blue Prism d'authentifier la commande en fonction des identifiants de l'utilisateur actuel dans une configuration d'authentification unique (SSO). Si votre base de données n'est pas configurée pour une authentification unique, vous devez alors utiliser le commutateur /user à la place.
Rend toutes les options de configuration de Blue Prism applicables à l'utilisateur du système d'exploitation actuellement connecté. Par défaut, la configuration s'applique à tous les utilisateurs.
Utilisez ces paramètres conjointement pour créer une nouvelle connexion à la base de données, en reprenant le même nom que la base de données (voir aussi /dbconname) ou pour mettre cette connexion à jour, si elle existe. Pour l'authentification SQL Server, qui est recommandée, les quatre paramètres doivent être fournis. Pour l'authentification Windows, le nom d'utilisateur et le mot de passe doivent être omis. La connexion est également définie comme étant la connexion en cours. Après cela, Blue Prism se ferme.
Utilisez-le avec /setdbserver pour spécifier une connexion de groupe de disponibilité au lieu d'une connexion directe à la base de données. Dans ce cas, « databaseservername » est le nom de l'écouteur du groupe de disponibilité.
Utilisez-le avec /ag pour spécifier le port de l'écouteur du groupe de disponibilité. S'il n'est pas fourni, la valeur par défaut de 1433 est utilisée.
Utilisez-le avec /ag pour spécifier que le basculement multi-sous-réseaux doit être activé.
Crée une connexion au serveur Blue Prism portant le même nom que l'hôte donné. (Voir aussi /dbconname, /connectionmode et /bpserversecure) La connexion est également définie comme étant la connexion en cours. Après cela, Blue Prism se ferme.
Utilisé avec les options /setdbserver ou /setbpserver pour spécifier un nom de connexion particulier plutôt que d'utiliser celui par défaut. S'il est utilisé sans l'un de ces paramètres, il spécifie le nom de la connexion à la base de données à utiliser.
Utilisé avec l'option /setbpserver pour sélectionner le mode de connexion utilisé pour la connexion entre le client et le serveur Blue Prism. Veuillez noter que cette option doit correspondre à la valeur correspondante définie dans la configuration du serveur Blue Prism.
La valeur par défaut est 0. Les modes de connexion disponibles sont :
- 0 – WCF : SOAP avec chiffrement de messages et authentification Windows
- 1 – WCF : SOAP avec chiffrement de transport et authentification Windows
- 2 – WCF : SOAP avec cryptage de transport
- 3 – .NET Remoting : Sécurisé
- 4 – .NET Remoting : Non sécurisé
- 5 – WCF non sécurisé
Utilisé avec l'option /setbpserver pour désactiver la sécurité sur la connexion au serveur Blue Prism. Ceci ne devrait jamais être utilisé à moins que d'autres dispositions ne soient prises pour sécuriser la connexion.
L'option /bpserversecure est obsolète et vous devez désormais utiliser l'option /connectionmode à la place.
Démarre la surveillance d'alerte de processus en arrière-plan. Doit être combiné à l'un des commutateurs /User ou /sso pour l'utilisation de la bonne configuration des alertes de processus de l'utilisateur.
Définit la priorité de l'application Blue Prism sur le mode donné. Normalement utilisé pour contrôler la priorité du processus Windows de Blue Prism lorsque Blue Prism fonctionne comme une ressource machine. Ceci peut être utile lorsque Blue Prism a besoin d'une priorité plus élevée que d'autres processus sur le PC, qui pourraient autrement monopoliser les ressources du processeur et empêcher Blue Prism de fonctionner efficacement. Les modes valides sont :
- inférieure – priorité inférieure à la normale
- supérieure – priorité supérieure à la normale
- élevée – priorité élevée
- temps réel – la priorité la plus élevée possible
Utilisé avec le paramètre /run afin de fournir des paramètres de démarrage à une session.
Le paramètre paramsxml doit contenir des paramètres xml Blue Prism valides, placés entre guillemets (""). Puisque les guillemets sont utilisés pour délimiter le début et la fin de la chaîne de caractères xml des paramètres en entrée standard, Blue Prism vous recommande de délimiter vos attributs xml en utilisant des guillemets simples (''). Exemple :
AutomateC /run "Excel Test" /resource YourPCHostName /user admin mypwd /startp "<inputs><input name='Comment' type='text' value='Hello World' /></inputs>"
Vous pouvez également échapper les guillemets présents en saisissant deux guillemets au lieu d'un dans les paramètres xml. Par exemple :
AutomateC /run "Excel Test" /resource YourPCHostName /user admin mypwd /startp "<inputs><input name=""Comment"" type=""text"" value=""Hello World"" /></inputs>"
Les utilisateurs à authentification unique doivent utiliser le commutateur /sso à la place du commutateur /user dans les exemples ci-dessus. Par exemple :
AutomateC /run "Excel Test" /resource YourPCHostName /sso /startp "<inputs><input name=""Comment"" type=""text"" value=""Hello World"" /></inputs>"
Affiche le formulaire de configuration de la base de données. L'application se ferme dès que l'utilisateur quitte ce formulaire (à l'aide des boutons « OK » ou « Annuler »).
AutomateC.exe – available switches
Offre quelques conseils d'aide rapide sur la sortie standard de la ligne de commande.
Base de données
Crée une base de données à l'aide de la connexion à la base de données déjà configurée (voir Automate.exe /setdbserver). Le mot de passe requis est celui fourni dans le cadre de la connexion à la base de données configurée.
La différence par rapport au commutateur /replacedb réside dans le fait qu'il supprime les bases de données existantes portant le même nom, alors que le commutateur /replacedb supprime les tableaux existants dans la base de données, sans supprimer la base de données elle-même.
Crée une base de données à l'aide de la connexion à la base de données déjà configurée (voir Automate.exe /setdbserver). Le mot de passe requis est celui fourni dans le cadre de la connexion à la base de données configurée.
La différence par rapport au commutateur /createdb réside dans le fait que si une base de données du même nom existe déjà, il ne supprime que les tableaux existants dans cette base de données, alors que la commande /createdb supprime la base de données entière et la recrée.
Améliore une base de données existante, si nécessaire. Le mot de passe requis est celui fourni dans le cadre de la connexion à la base de données configurée.
Clés de licence
Ajoute la clé de licence du fichier spécifié à la base de données Blue Prism. Nécessite que les identifiants d'utilisateur soient fournis via l'un des commutateurs /user ou /sso.
Les licences peuvent également être gérées à l'aide du gestionnaire du système dans l'application cliente.
Supprime la clé de licence du fichier spécifié de la base de données Blue Prism. Nécessite que les identifiants d'utilisateur soient fournis via l'un des commutateurs /user ou /sso.
Les licences peuvent également être gérées à l'aide du gestionnaire du système dans l'application cliente.
Inscription
Enregistre un objet métier COM à utiliser sur la machine locale. Cela équivaut à accéder à la zone « Objets métier externes » dans le gestionnaire de système.
Le paramètre clsid fait référence à l'identificateur de classe COM.
Enregistre un service Web pour l'utiliser dans les processus Blue Prism. Cela équivaut à l'enregistrement d'un service Web via l'assistant dans la zone « services Web » du gestionnaire de système.
- Nécessite que les identifiants d'utilisateur soient fournis via l'un des commutateurs /user ou /sso.
- Peut être utilisé, de façon optionnelle, avec le commutateur /objectname.
- Le commutateur /timeout peut être spécifié de manière optionnelle.
- Si des identifiants sont nécessaires pour récupérer le document WSDL, le commutateur /wsauth peut être utilisé.
L'identificateur <servicename> doit correspondre au nom d'un service qui apparaît dans le document WSDL du service Web (consultez le glossaire des services Web pour plus d'informations sur les documents WSDL). Cela est nécessaire, car un document WSDL peut décrire plusieurs services Web différents. Le nom fourni est différent de celui donné en utilisant le commutateur /objectname, qui spécifie le nom sous lequel le service Web sera identifié en interne, dans vos processus Blue Prism.
Le paramètre <WSDLURL> doit spécifier l'emplacement (URL) d'un document WSDL pour le service Web concerné. Cela est récupéré en utilisant http ou https, selon le cas.
Annule l'enregistrement d'un service Web. Cela équivaut à la suppression d'un service Web via l'assistant dans la zone « Services Web » du gestionnaire du système.
- Nécessite que les identifiants d'utilisateur soient fournis via l'un des commutateurs /user ou /sso.
L'identificateur <servicename> doit correspondre au nom sous lequel le service Web est identifié en interne, dans vos processus Blue Prism.
Utilisé avec le commutateur /regwebservice pour spécifier le nom de l'objet métier qui sera donné au service Web, une fois enregistré.
Utilisé avec le commutateur /regwebservice pour spécifier les identifiants d'utilisateur à utiliser dans la requête http lors du téléchargement du document WSDL. L'utilisation de ce commutateur n'est nécessaire que lorsque le serveur d'hébergement protège le WSDL par mot de passe.
Utilisé avec le commutateur /regwebservice pour spécifier la valeur du délai avant expiration à associer au service Web (en millisecondes). Ce sera le délai avant expiration appliqué à l'exécution lorsque vous attendez une réponse du service Web. Il peut être modifié ultérieurement en accédant au gestionnaire du système et en modifiant le service Web.
L'utilisation de ce commutateur avec la commande /regwebservice est facultative. S'il n'est pas utilisé, la valeur par défaut de 10 000 millisecondes est appliquée.
Rapport
Écrit un rapport système dans le fichier spécifié. Le rapport système est une vue d'ensemble de l'état actuel du système : le nombre de sessions et d'entrées de log, le nombre d'éléments de file d'attente, l'état de validation des processus, etc.
Génère un rapport sur tous les rôles et les permissions associées pour chaque utilisateur du système.
Écrit un rapport d'utilisation de l'élément dans le fichier spécifié, au format CSV. Utilisez l'option /process pour spécifier l'objet métier pour lequel écrire un rapport. Le rapport contient les détails de la page et de l'étape où chaque élément du modèle d'application est utilisé.
Importer/Exporter
Importe un processus (ou un objet métier visuel) Blue Prism dans la base de données, en utilisant par défaut l'ID trouvé dans le fichier (s'il existe, sinon un nouvel ID est généré). Consultez la section /forceid pour remplacer ce comportement.
Le paramètre filespec fait référence à l'emplacement du fichier à importer.
Par défaut, si le processus/l'objet importé existe déjà dans l'environnement sélectionné, cette opération échouera. Consultez la section /overwrite pour éviter cela.
Importe un fichier de version Blue Prism (.bprelease) ou un fichier de compétences Blue Prism (.bpskill) dans la base de données. Cette action est identique sur le plan fonctionnel à l'exécution interactive de l'importation via le client Blue Prism (voir l'onglet Version), mais elle n'est pas interactive et les conflits sont traités automatiquement lorsque cela est possible. En général, l'action par défaut consiste à effectuer un remplacement lorsque l'élément importé existe déjà dans la base de données. Cependant, certains conflits empêchent l'importation de manière non interactive d'une version. Le tableau suivant résume la gestion des conflits :
Conflit |
Résultat |
---|---|
Un élément avec le même ID/nom et le même type existe déjà dans la base de données | L'élément sera remplacé |
Le processus nécessite la publication ou le classement après l'importation | Le processus sera publié/classé |
Voici des exemples de conflits qui pourraient entraîner l'échec de l'importation :
|
La version ne sera pas importée |
Lors de l'importation interactive de nouveaux identifiants, l'utilisateur est invité à saisir son nom d'utilisateur et son mot de passe (car ces informations ne sont pas écrites dans le fichier d'exportation). Lors de l'importation de manière non interactive, les identifiants sont importés avec un nom d'utilisateur/mot de passe vide et doivent être mis à jour manuellement dans le client Blue Prism.
Le paramètre filespec fait référence à l'emplacement du fichier .bprelease à importer.
Exporte un processus Blue Prism (ou un objet métier visuel) de la base de données vers le système de fichiers local.
Exporte la version actuelle de l'ensemble logiciel Blue Prism nommé de la base de données vers le système de fichiers local. Pour exporter une version précédente d'un ensemble logiciel, utilisez le paramètre facultatif [/release <releasename>].
Utilisez-le avec /import pour forcer l'utilisation de l'ID donné pour le processus, au lieu d'utiliser celui défini dans le fichier en cours d'importation.
Le mot-clé « nouveau » génère un nouvel ID pour l'objet importé, sinon un GUID valide doit être fourni.
Par défaut, un /import échouera si le processus/l'objet importé existe déjà dans la base de données.
Si l'option /overwrite est utilisée, une nouvelle version du processus/de l'objet sera importée et remplacera la version existante.
Remarque : si un processus/objet différent existe avec le même nom que le processus/l'objet importé, mais avec un ID différent, l'opération d'importation échoue. /overwrite fonctionne uniquement si un processus/objet avec le même ID est trouvé. Dans ce cas, l'assistant d'importation peut être utilisé dans le produit.
Publier
Publie le processus Blue Prism nommé. Si le nom du processus contient des espaces, vous devrez le placer entre guillemets.
Annule la publication du processus Blue Prism nommé. Si le nom du processus contient des espaces, vous devrez le placer entre guillemets.
Affiche l'objet ou le processus Blue Prism nommé en tant que service Web, pour être utilisé par des applications externes. Si le nom de l'objet ou du processus contient des espaces, vous devrez le placer entre guillemets.
Si le paramètre /forcedoclitencoding facultatif est présent, le service Web renverra toujours les messages SOAP dans le formulaire document/littéral pour la conformité WS-I.
Si le paramètre /forcedoclitencoding n'est pas présent, alors vous pouvez forcer l'utilisation d'un espace de noms global.
Masque un objet ou un processus Blue Prism qui a déjà été affiché en tant que service Web. Si le nom de l'objet ou du processus contient des espaces, vous devrez le placer entre guillemets.
Cryptage
Définit le schéma de cryptage qui sera utilisé par la file d'attente spécifiée. Le schéma spécifié doit être configuré dans cet environnement pour que cela fonctionne. Le nom de schéma par défaut, défini dans la configuration du serveur Blue Prism, est Schéma de cryptage par défaut.
Pour désactiver la clé de cryptage d'une file d'attente, voir le commutateur /resetencrypt.
Doit être utilisé en combinaison avec /queuename. Nécessite que les identifiants d'utilisateur soient fournis via l'un des commutateurs /user ou /sso.
Réinitialise le schéma de cryptage sur la file d'attente spécifiée afin d'arrêter son cryptage.
Doit être utilisé en combinaison avec /queuename. Nécessite que les identifiants d'utilisateur soient fournis via l'un des commutateurs /user ou /sso.
Cette option permet de crypter à nouveau les identifiants, les captures d'écran des ressources ou les données des éléments de file d'attente qui ne sont pas cryptés selon le schéma actuellement sélectionné. Elle est couramment utilisée lors de la révocation d'une ancienne clé avant la suppression d'un schéma de chiffrement. Le paramètre /batchsize contrôle la fréquence à laquelle les enregistrements mis à jour sont transmis à la base de données (1 000 par défaut), et /maxbatches contrôle combien de lots sont traités (1 par défaut).
Lorsque la commande est exécutée :
- Tous les identifiants ou captures d'écran d'exception qui sont actuellement chiffrés à l'aide d'un schéma différent de celui qui est configuré comme schéma de chiffrement par défaut seront déchiffrés, puis chiffrés à nouveau à l'aide du schéma de chiffrement par défaut.
- Tous les éléments de file d'attente de travaux qui sont actuellement chiffrés à l'aide d'un schéma différent de celui qui est configuré sur la file d'attente de travaux seront déchiffrés, puis chiffrés à nouveau à l'aide du schéma de chiffrement associé à la file d'attente de travaux.
En fonction du paramètre /batchsize configuré, le traitement se répète jusqu'à ce que la valeur /maxbatches configurée soit atteinte.
Cela nécessite la fourniture des identifiants utilisateur via les commutateurs /user ou /sso, ainsi que l'accès à la permission Sécurité – Gestion des schémas de chiffrement.
Applique la méthode de chiffrement requise à la configuration du serveur Blue Prism. Vous pouvez choisir d'utiliser le cryptage Blue Prism par défaut ou d'installer le certificat spécifié. Les options pour cette commande sont les suivantes :
- /configencrypt : affiche la méthode de chiffrement actuelle utilisée dans la configuration du serveur.
- /configencrypt default : application du cryptage Blue Prism par défaut. Le mot de passe de l'administrateur du système Blue Prism doit être spécifié.
- /configencrypt thumbprint : modification de la méthode configencrypt pour obtenir un certificat avec l'empreinte du pouce spécifiée. Le mot de passe de l'administrateur du système Blue Prism doit être spécifié.
- /configencrypt thumbprint /forceconfigencrypt : force l'annulation d'une erreur. Cela peut entraîner l'affichage d'un avertissement. Le mot de passe de l'administrateur du système Blue Prism doit être spécifié.
Par exemple :
Affichez la méthode de cryptage actuelle :
AutomateC /configencrypt /user admin password
Définissez la méthode de cryptage par défaut :
AutomateC /configencrypt default /user admin password
Définissez l'utilisation de l'empreinte du pouce du certificat spécifiée :
AutomateC /configencrypt bc6269e89048cbf5553601cc0314b291609d9f3 /user admin password
Files d'attente de travaux
Crée une file d'attente de travaux avec les valeurs keyfield, running et maxattempts, comme cela serait nécessaire pour la création manuelle d'une file d'attente dans le gestionnaire du système.
Doit être utilisé en combinaison avec /queuename. Nécessite que les identifiants d'utilisateur soient fournis via l'un des commutateurs /user ou /sso.
Exporte les données d'une file d'attente de travaux et les enregistre dans l'emplacement spécifié par <filespec>.
Nécessite que les identifiants d'utilisateur soient fournis via l'un des commutateurs /user ou /sso.
Doit être utilisé en combinaison avec /queuename. Peut être accompagné par une ou les deux options suivantes : /queuefilter et /clearexported.
Notez que /exportqueue nécessite la fourniture des identifiants d'utilisateur via l'un des commutateurs /user ou /sso, ainsi que l'accès à l'une des permissions suivantes :
Plein accès à la gestion de la file d'attente, Accès en lecture seule à la gestion de la file d'attente
Efface les cas traités (c'est-à-dire marqués comme étant terminés ou comme une exception) d'une file d'attente de travaux.
Nécessite que les identifiants d'utilisateur soient fournis via l'un des commutateurs /user ou /sso.
Doit être utilisé en combinaison avec /queuename.
Si le commutateur /age est utilisé, seuls les éléments traités plus anciens que l'âge spécifié sont supprimés de la file d'attente. Sinon, tous les éléments traités sont supprimés de la file d'attente nommée.
Vous pouvez utiliser la commande /exportqueue en combinaison avec /clearexported à la place, car cela vous permet de générer un enregistrement des éléments qui ont été supprimés au cours du processus. Cette commande ne crée aucun enregistrement.
Utilisé avec /queueclearworked, ceci supprime tous les éléments traités qui sont plus anciens que l'âge spécifié (ceci inclut les éléments marqués comme une exception avant cette date).
Utilisé avec /archive et /restorearchive, ceci permet de contourner la sélection basée sur la plage de dates et de sélectionner les sessions plus anciennes qu'un certain âge. La valeur est un nombre suivi d'un « y » (années), « m » (mois), « w » (semaines) ou « d » (jours). Par exemple, « 6m » spécifie que les logs de plus de 6 mois doivent être archivés.
Spécifie le nom d'une file d'attente, lorsque celle-ci est utilisée avec une commande liée à une file d'attente, telle que /exportqueue ou /createqueue.
Spécifie le nom d'un filtre à utiliser lors de l'exportation d'une file d'attente avec /exportqueue. Il s'agit du nom d'un filtre créé dans la zone « Gestion de la file d'attente » de Control Room.
Lorsqu'il est utilisé avec /exportqueue, les éléments traités et référencés exportés sont supprimés de la file d'attente.
Nécessite la fourniture des identifiants d'utilisateur via l'un des commutateurs /user ou /sso, ainsi que l'accès à la permission Plein accès à la gestion de la file d'attente.
Pools de ressource
Le programme de ligne de commande AutomateC vous permet de créer et supprimer des pools de ressource, mais également d'ajouter et de supprimer des ressources des pools existants.
Pour effectuer une action de pool de ressource, vous devez fournir des informations de connexion valides.
Crée un pool de ressource avec le nom spécifié.
Supprime le pool de ressource spécifié.
Ajoute une ressource au pool de ressource spécifié.
Si aucun nom de ressource n'est spécifié, la ressource locale est ajoutée au pool.
Supprime une ressource du pool dans lequel elle réside.
Si aucun nom de ressource n'est spécifié, la ressource locale est supprimée de son pool.
Planning
Le programme de ligne de commande AutomateC vous permet de démarrer et de supprimer des plannings, mais aussi d'afficher des rapports et des horaires.
Pour effectuer une action de planification, vous devez fournir des informations de connexion valides.
Précise le(s) nom(s) des plannings à utiliser avec les actions /startschedule, /deleteschedule, /viewschedtimetable et /viewschedreport.
Tous les paramètres suivant un commutateur /schedule sont traités comme des noms de plannings jusqu'à ce qu'un autre commutateur soit atteint (c'est-à-dire un paramètre commençant par un caractère « / ») ou que la fin de la commande soit atteinte.
Lorsqu'aucun planning n'est spécifié, les commandes sont généralement traitées comme en cours d'exécution sur l'ensemble des plannings.
Lance le planning spécifié à l'heure actuelle. Si le planificateur d'événements est en cours d'exécution, il devrait exécuter le planning dans les 30 secondes.
Si le planning spécifié n'a jamais été exécuté, le planning et tous les logs connexes sont supprimés. Si le planning spécifié a déjà été exécuté, il est marqué comme supprimé, mais tous les logs existants sont conservés.
Spécifie le format de sortie du rapport de planning ou de l'horaire, en « txt » (lisible par l'homme) ou en « csv » (variable séparée par des virgules). Le format par défaut est « txt » si aucun format n'est explicitement spécifié.
Génère l'horaire spécifié.
Vous pouvez spécifier un horaire nommé qui a été créé et configuré dans le client Blue Prism.
Vous pouvez également spécifier un horaire ad hoc en indiquant la date à partir de laquelle l'horaire doit démarrer, le nombre de jours à afficher et le format dans lequel le télécharger.
Génère le rapport spécifié.
Vous pouvez spécifier un rapport nommé qui a été créé et configuré dans le client Blue Prism.
Vous pouvez également spécifier un rapport ad hoc en indiquant la date de fin du rapport, le nombre de jours précédents à afficher et le format du fichier à télécharger.
Variable environnementale
Définit une variable d'environnement existante. S'il n'y a pas de variables environnementales existantes, l'exécution de cette commande en crée une nouvelle.
Supprime une variable environnementale.
Archiver
Archive les logs de session dans les fichiers. Consultez Archivage pour en savoir plus. Sans aucune option, tous les logs de session seront archivés. Pour limiter la plage des logs archivés, utilisez l'option /age ou une combinaison des options /from et /to. Vous pouvez également utiliser /process pour limiter l'archivage aux logs d'un processus particulier.
Pour supprimer les logs de session, sans les exporter, vous pouvez ajouter l'option /delete.
Définissez le chemin d'archivage. Il s'agit du chemin d'accès utilisé par les commandes /archive et /restorearchive, ainsi que dans l'interface du gestionnaire du système.
Utilisé avec /archive et /restorearchive, ceci définit le début inclusif d'une plage de dates.
Utilisé avec /archive et /restorearchive, ceci définit la fin non inclusive d'une plage de dates.
Utilisé avec /queueclearworked, ceci supprime tous les éléments traités qui sont plus anciens que l'âge spécifié (ceci inclut les éléments marqués comme une exception avant cette date).
Utilisé avec /archive et /restorearchive, ceci permet de contourner la sélection basée sur la plage de dates et de sélectionner les sessions plus anciennes qu'un certain âge. La valeur est un nombre suivi d'un « y » (années), « m » (mois), « w » (semaines) ou « d » (jours). Par exemple, « 6m » spécifie que les logs de plus de 6 mois doivent être archivés.
Utilisé avec /archive, ceci limite l'archivage aux sessions qui ont exécuté le processus nommé. Utilisé avec /elementusage, ceci sélectionne le processus sur lequel générer un rapport.
Statut
Répertorie les sessions pour un nom de ressource donné, les résultats pouvant être limités à une période spécifique. Pour répertorier toutes les ressources, utilisez [All] comme nom de ressource.
Vous pouvez également fournir un numéro de limite et un type (m = minutes, h = heures, j = jours, mm = mois) pour limiter les résultats renvoyés. Par exemple, /resourcestatus ABC:8181 1 d renverrait toutes les sessions pour la ressource nommée qui ont démarré le dernier jour.
Nécessite que les identifiants d'utilisateur soient fournis via le commutateur /user.
Configuration de serveur
Crée ou met à jour la configuration du serveur Blue Prism identifiée par le nom spécifié, en définissant le nom de la connexion à la base de données et le port d'écoute sur les valeurs fournies.
Un commutateur /connectionmode facultatif peut être utilisé pour définir le mode de connexion.
Si aucun schéma de cryptage n'a été défini pour la configuration du serveur Blue Prism, un nouvel enregistrement du schéma de cryptage est créé. Par défaut, le schéma est nommé Schéma de cryptage par défaut et configuré pour utiliser AES 256 (AESCryptoService) et une clé générée aléatoirement. Vous pouvez également utiliser le commutateur /encryptionscheme pour définir les réglages qui seront utilisés.
Utilisé avec un commutateur /serverconfig, il s'agit d'un commutateur facultatif pour définir les réglages qui seront utilisés à la création d'un schéma de cryptage.
<name> définit le nom du schéma de chiffrement.
<encryptionmethod> (facultatif) définit l'algorithme de chiffrement à utiliser.
- 1 = Triple DES (192 bits)
- 2 = AES-256 RijndaelManaged (256 bits)
- 3 = AES-256 AesCryptoService (256 bits) – par défaut
Triple DES (192 bits) est fourni pour la rétrocompatibilité. Il est fortement recommandé de ne pas configurer de nouveaux schémas de cryptage pour utiliser cette méthode.
Identifiants
Crée un nouvel identifiant en utilisant le nom, le mot de passe et le nom d'utilisateur spécifiés.
Le nom d'utilisateur et le mot de passe peuvent tous deux être représentés par "" s'ils ne sont pas requis.
Un type d'identifiant général sera créé si aucun n'est spécifié.
Nécessite que les identifiants d'utilisateur soient fournis via l'un des commutateurs /user ou /sso, ainsi que l'accès à la permission Sécurité – Gestion des identifiants.
L'identifiant créé sera universellement disponible pour tous les rôles d'utilisateur, ressources et processus par défaut.
Met à jour un identifiant existant trouvé à l'aide du nom spécifié.
Nécessite que les identifiants d'utilisateur soient fournis via l'un des commutateurs /user ou /sso, ainsi que l'accès à la permission Sécurité – Gestion des identifiants.
Utilisez-le avec /updatecredential pour mettre à jour le mot de passe de l'identifiant.
Utilisez-le avec /updatecredential pour mettre à jour le nom d'utilisateur contenu dans l'identifiant.
Utilisez-le avec /updatecredential ou /createcredential pour définir le texte contenu comme description de l'identifiant.
Utilisez-le avec /updatecredential ou /createcredential pour définir la date d'expiration de l'identifiant. La date doit être au format aaaaMMjj.
Utilisez-le avec /updatecredential ou /createcredential pour spécifier si un identifiant devrait être marqué comme non valide.
Utilisez-le avec /updatecredential ou /createcredential pour spécifier le type d'identifiant. Doit être une valeur prise en charge.
Créez une nouvelle propriété d'identifiant ou mettez-la à jour si elle existe déjà.
Nécessite que les identifiants d'utilisateur soient fournis via l'un des commutateurs /user ou /sso, ainsi que l'accès à la permission Sécurité – Gestion des identifiants.
Met à jour les paramètres système pour autoriser les connexions anonymes.
Authentification Windows
Cette fonctionnalité n'est disponible qu'à partir de la version 6.10.5 de Blue Prism.
Force l'ensemble logiciel de sécurité Microsoft Negotiate à sélectionner New Technology LAN Manager (NTLM) comme fournisseur SSP (Security Support Provider) pour la dernière connexion utilisée ou spécifiée (à l'aide du commutateur /dbconname) lors de l'authentification de la connexion au serveur Blue Prism. Cette option est fournie afin que NTLM puisse être utilisé lorsque Kerberos n'est pas disponible ou n'est pas configuré (voir Configuration du SPN). Par exemple, /forcentlm true.
Cette fonctionnalité n'est disponible qu'à partir de la version 6.10.5 de Blue Prism.
Doit être configuré pour chaque connexion au serveur Blue Prism dans le client interactif où le domaine Kerberos de l'utilisateur est différent de celui du compte configuré pour exécuter le serveur Blue Prism. Par exemple, /setkerberosrealm monentreprise.com
Le domaine Kerberos est généralement le même que le nom de domaine. Cependant, veuillez vérifier auprès de votre équipe informatique la valeur correcte. Il doit s'agir du domaine du compte de service exécutant le service de serveur Blue Prism. Dans certains environnements, il peut être nécessaire d'appliquer la même configuration lorsque le compte de service existe dans un autre domaine au sein de la même forêt.
Délai avant expiration de la commande
La fonction standard pour les requêtes SQL exécutées par le produit, qui fixe le délai d'exécution d'une commande et de renvoi des résultats avant expiration. Ce délai est fixé à 60 secondes par défaut.
Définit le délai d'exécution et de renvoi des résultats d'une commande avant expiration pour les requêtes SQL qui sont généralement les plus lentes à renvoyer des résultats, par exemple les requêtes qui interagissent avec les files d'attente de travaux. Ce délai est fixé à 600 secondes par défaut.
Définit le délai d'exécution et de renvoi des résultats d'une commande avant expiration pour les logs qui prennent généralement plus de temps. Ce délai est fixé à 0 (infini) par défaut.
Ces commandes implémentent une modification irréversible à l'échelle du système et ne doivent être utilisées que sur les conseils de l'équipe d'assistance Blue Prism.
Gestion des sessions
Utilisé pour exécuter un processus à partir de la ligne de commande. Le paramètre processname doit être placé entre guillemets s'il contient une espace. Le processus nommé doit être publié pour être exécuté (voir /publish). Les paramètres d'entrée peuvent être spécifiés à l'aide du paramètre /startp.
Les identifiants d'utilisateur sont requis pour exécuter un processus. Voir /user et /sso, par exemple :
AutomateC.exe /run Process1 /user admin pwd
ou
AutomateC.exe /run Process1 /sso
Envoie une « Demande d'arrêt » à la session spécifiée, en définissant un indicateur que le processus en cours d'exécution peut vérifier à l'aide de la fonction IsStopRequested() dans une étape de décision.
L'un des ID de session (un GUID) ou le numéro de session (un numéro) doit être fourni pour indiquer la session qui doit être marquée avec la demande d'arrêt.
Notez que ceci ne peut être exécuté que par un utilisateur authentifié (fourni en utilisant les commutateurs /user ou /sso) avec la permission Accès complet à la gestion de session.
Divers
Applique les permissions de l'utilisateur contrôlant pour la création, le démarrage et la suppression d'une session.
Demande que le référentiel de dépendances de l'objet/du processus soit actualisé si une mise à niveau de Blue Prism l'a signalé comme obsolète. Si le mot-clé « forcer » est spécifié, le référentiel est actualisé quel que soit son état actuel.
Obtient le log de la session spécifiée. L'ID de session est un identificateur unique sous la forme xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. Nécessite que les identifiants d'utilisateur soient fournis via l'un des commutateurs /user ou /sso.
Le log est écrit sur la sortie standard, ligne par ligne. Il existe une limite de données de 232 -1 lignes, mais cette limite n'est pas pertinente dans la pratique, car elle correspond à des centaines de gigaoctets de données.
Produit une liste de processus et d'objets métier.