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 ; 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 ; 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 » affiche ce document, dans une fenêtre graphique.
- Certains commutateurs nécessitent des paramètres supplémentaires (affichés ci-dessous en tant que <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 aux guillemets présents en saisissant deux guillemets pour chaque guillemet 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
Ouvre ce document dans le navigateur d'aide html Blue Prism.
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 l'option /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 la salle de contrôle 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 une nouvelle tentative 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.
Par exemple, lorsque vous utilisez le commutateur /run, au lieu de spécifier
Automate.exe /run Process1 /user admin pwd
vous spécifieriez
Automate.exe /run Process1 /sso
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 avec le même nom que le nom de la base de données donnée (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é.
Il permet de créer une nouvelle connexion au serveur Blue Prism avec 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.
Il peut être 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.
Il peut être 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 cryptage de messages et authentification Windows
- 1 – WCF : SOAP avec cryptage 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é
Il peut être 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. REMARQUE : 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 utilisé avec l'un des commutateurs /User ou /sso pour que la configuration des alertes de processus correcte de l'utilisateur soit utilisée.
Définissez 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 (''). Par 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 aux guillemets présents en saisissant deux guillemets pour chaque guillemet 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 /soo à 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. Une fois que l'utilisateur quitte ce formulaire (à l'aide des boutons « OK » ou « Annuler »), l'application se ferme.
AutomateC.exe – commutateurs disponibles
Offre quelques conseils d'aide rapide sur la sortie standard de la ligne de commande.
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.
Définit le groupe Active Directory pour les administrateurs Blue Prism au moment de la création de la base de données. Uniquement pertinent si vous souhaitez utiliser l'authentification unique. Doit être utilisé avec /setaddomain et l'une des deux options suivantes : /createdb ou /replacedb.
Définit le nom de domaine pour les administrateurs Blue Prism au moment de la création de la base de données. Uniquement pertinent si vous souhaitez utiliser l'authentification unique. Doit être utilisé avec /setadadmingroup et l'une des deux options suivantes : /createdb ou /replacedb.
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.
Crée un script SQL permettant à un DBA de créer une nouvelle base de données. Par exemple :
AutomateC.exe /getdbscript createdb.sql
Cela génère le script – createdb.sql.
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é configuré 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 le commutateur /serverconfig, il s'agit d'un commutateur facultatif qui peut être utilisé pour définir les réglages qui seront utilisés lorsqu'un schéma de cryptage est créé.
<name> définit le nom du schéma de cryptage.
<encryptionmethod> (facultatif) définit l'algorithme de cryptage à 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.
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.
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 de 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 de système dans l'application cliente.
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 (voir 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 de 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 de 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.
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.
É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 la file d'attente, l'état de validation des processus, etc.
É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é.
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é). Voir /forceid pour remplacer ce comportement.
Le paramètre filespec fait référence à l'emplacement du fichier xml à importer.
Par défaut, si le processus/l'objet importé existe déjà dans l'environnement sélectionné, cette opération échouera. Voir /overwrite pour éviter cela.
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.
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 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>].
Exporte un processus Blue Prism (ou un objet métier visuel) de la base de données vers le système de fichiers local.
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 de 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.
Utilisé pour exécuter un processus à partir de la ligne de commande. Le paramètre processname doit être placé entre guillemets s'il contient un 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.
Supprime une variable environnementale.
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.
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.
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.
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 en utilisant 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.
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 de 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.
Applique la méthode de cryptage 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 : affichage de la méthode de cryptage 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 : annulation forcée 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
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 qu'elle ne soit plus cryptée.
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 la file d'attente qui ne sont pas cryptés selon le schéma actuellement sélectionné, et peut être utilisée, par exemple, pour révoquer une ancienne clé avant de supprimer un schéma de cryptage. 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).
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 schémas de cryptage.
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 que les identifiants d'utilisateur soient fournis 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, Lecture de l'accès à la gestion de la file d'attente
Efface les cas traités (c'est-à-dire les cas marqués comme étant terminés ou l'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.
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 la salle de contrôle.
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 que les identifiants d'utilisateur soient fournis 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.
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.
Options du planificateur d'événements
Le programme de ligne de commande automatec vous permet de démarrer et de supprimer des plannings et d'afficher des rapports et des horaires.
Pour effectuer une action de planification, vous devez fournir des informations de connexion valides.
Précise le ou les noms 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.
Supprime le planning spécifié et tous les logs de planning associé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 jusqu'à laquelle le rapport doit être inclus, le nombre de jours précédents à afficher et le format dans lequel le télécharger.
Options de 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.