Befehlszeilenoptionen
Blue Prism bietet zwei Hilfsprogramme, die Befehlszeilenschalter akzeptieren:
- Automate.exe
Die grafische Blue Prism Anwendung. Alle Nachrichten und Rückmeldungen dieser Anwendung werden grafisch dargestellt. Der Rückgabecode null weist dies auf einen erfolgreichen Vorgang hin. Wird ein anderer Code als null zurückgegeben, weist dies auf einen Fehler hin.
- AutomateC.exe
Ein Befehlszeilen-Hilfsprogramm, das Nachrichten und Rückmeldung (per Standard-Output) in der Befehlszeile wiedergibt. Der Rückgabecode null weist dies auf einen erfolgreichen Vorgang hin. Wird ein anderer Code als null zurückgegeben, weist dies auf einen Fehler hin.
Tipps:
- AutomateC unterstützt die dynamische Hilfe durch Eingabe von „/help“; in Automate.exe wird dadurch dieses Dokument in einem grafischen Fenster angezeigt.
- Einige Schalter erfordern zusätzliche Parameter (unten als <Parameter> dargestellt), die dem Schalter angehängt werden müssen.
- Schalter und Parameter werden durch Leerzeichen getrennt. Enthält der Wert eines Parameters Leerstellen oder andere Sonderzeichen, so müssen diese in „Anführungszeichen“ stehen. Achten Sie aus diesem Grund besonders darauf, dass der Wert selbst keine Anführungszeichen enthält.
- XML-Zeichenfolgen müssen in Anführungszeichen eingegeben werden. Da Anführungszeichen beim Standard-Input zum Trennen von Beginn/Ende der XML-Zeichenfolgen von Parametern verwendet werden, empfiehlt Blue Prism das Trennen der XML-Attribute durch einzelne Anführungszeichen. Alternativ können Sie zwei Anführungszeichen pro Anführungszeichen in einer Parameter-XML-Zeichenfolge als Escapezeichen verwenden.
Blue Prism als exklusiven Ressourcen-PC für Benutzer „admin“ ausführen:
automate /resourcepc /user admin mypwd
oder für einen Benutzer mit Single Sign-on:
automate /resourcepc /sso
Blue Prism als öffentlichen Ressourcen-PC ausführen:
automate /resourcepc /public
Einen Prozess auf dem lokalen PC ausführen:
AutomateC /run "Mein geplanter Prozess" /user admin mypwd
oder für einen Benutzer mit Single Sign-on:
AutomateC /run "Mein geplanter Prozess" /sso
Einen Prozess mit Startparametern auf einem Remote-PC ausführen:
AutomateC /run "Excel Test" /resource IhrPCHostname /user admin mypwd /startp "<inputs> <input name='Comment' type='text' value='Hallo Welt' /></inputs>"
Starten der Prozessalarmüberwachung im Hintergrund ohne Start der Blue Prism Hauptanwendung:
automate /alerts /user admin mypwd
oder für einen Benutzer mit Single Sign-on:
automate /alerts /sso
Automate.exe – verfügbare Schalter
Öffnet dieses Dokument im html-Hilfsbrowser von Blue Prism.
Startet Blue Prism im Ressourcen-PC-Modus. Der Schalter /public kann hinzugefügt werden, um den Ressourcen-PC allen Blue Prism Benutzern zugänglich zu machen. Andernfalls ist er nur dem Benutzer zugänglich, der mit der Option /user bzw. /sso angegeben wurde.
Diese Option ist nicht mit dem Schalter /resource zu verwechseln.
Wird nur zusammen mit dem Schalter /resourcepc verwendet. Macht den Ressourcen-PC, wie in der Hilfe zu den Ausführungsmodi beschrieben, öffentlich verfügbar.
Wird nur zusammen mit dem Schalter /resourcepc verwendet und ermöglicht SSL/TLS-Verschlüsselung für die Datenübertragung an den Ressourcen-PC. Dazu wird das Zertifikat mit dem angegebenen Fingerabdruck verwendet, das im Zertifikatsspeicher des Benutzers oder PCs installiert sein muss.
Die Verschlüsselung betrifft sowohl Verbindungen vom Kontrollraum und Zeitplaner als auch verfügbar gemachte Webdienste mit einer Verbindung zur Ressource. Der CN des Zertifikats muss mit der Adresse für die Ressourcenverbindung übereinstimmen und der sich verbindende Client muss der CA vertrauen, die das Zertifikat ausstellt.
(Fortgeschritten) Wird nur zusammen mit dem Schalter /resourcepc verwendet und überschreibt den angezeigten adressierbaren Speicherort der veröffentlichten Webdienste sowie der zugehörigen Ressourcen, wie auf diesem Gerät gehostete WSDLs. Der angegebene Wert muss die vollständige Pfadadresse beinhalten, z. B.: "https://blueprismws.myorg.com:8181". Blue Prism hängt /ws/ sowie die zugehörigen Pfade automatisch an die lokal verfügbaren Ressourcen an.
Dabei ist manuelles Netzwerk-Routing erforderlich, um sicherzustellen, dass es sich bei dem angegebenen Präfix um eine gültige Adresse handelt, die auf dieses Gerät verweist.
(Fortgeschritten) Wird nur zusammen mit dem Schalter /resourcepc verwendet und weist die Laufzeitressource an, sämtliche HTTP-Kommunikation zu ignorieren, die auf ihrem Überwachungsport eingeht. Diese Option sollte nur verwendet werden, wenn die Ressource keine Webdienste verfügbar machen und nicht über die HTTP-Schnittstelle kontrolliert werden muss.
Beim Starten wird zunächst für die angegebene Dauer in Sekunden auf die Verfügbarkeit der Datenbank gewartet. Während dieses Zeitraums wird regelmäßig versucht, eine Verbindung herzustellen. Dies kann für kleinere Installationen nützlich sein, wenn auf einem Ressourcen-PC beim Start auch ein „Datenbankserver“ ausgeführt wird. In diesem Fall ist die Datenbank möglicherweise nicht sofort beim Start des Ressourcen-PCs verbindungsbereit. Zum Beispiel werden bei /dbwait 120 2 Minuten lang Neuversuche unternommen, bevor der Prozess abgebrochen wird.
Wird nur zusammen mit dem Schalter /resourcepc verwendet. Das Fenster mit den Informationen zum Ressourcen-PC wird standardmäßig ausgeblendet. Es kann über das Kontextmenü im Benachrichtigungsbereich wieder eingeblendet werden (achten Sie auf folgendes Symbol: ).
Wird nur zusammen mit dem Schalter /resourcepc verwendet. Der Ressourcen-PC lässt sich nur über den lokalen Computer kontrollieren und ist für Remote-Ressourcen nicht verfügbar.
Wird nur zusammen mit dem Schalter /resourcepc verwendet. Gibt den Port an, über den sich Blue Prism als Ressourcen-PC verfügbar macht. Auf diese Weise können Sie mehrere Ressourcen-PCs auf einem einzigen Computer ausführen.
Diese Option kann unter bestimmten Umständen nützlich sein. Z. B.:
- Überschreiben des Standardports
Wenn der Standardport 8181 bereits für einen anderen Dienst in Ihrem Netzwerk verwendet wird, können Sie einen anderen angeben. Achten Sie darauf, für alle Ressourcen-PCs in Ihrem Netzwerk denselben Ressourcen-PC zu verwenden, außer es gibt einen bestimmten Grund dagegen.
- Verwenden von Terminaldiensten
Bei der Interaktion mit einem Host für Terminaldienste kann Blue Prism nur eine Sitzung pro Ressourcen-PC gleichzeitig ausführen. Dies liegt an einer technischen Einschränkung der Implementierung von Microsoft Terminaldiensten. Auf einem einzelnen Computer können mehrere Sitzungen ausgeführt werden, wenn jeder Ressourcen-PC einen anderen Port verwendet.
Bestimmt den Ziel-Ressourcen-PC für Prozessalarme. Wird nichts anderes angegeben, wird der lokale PC verwendet.
Diese Option ist nicht mit dem Schalter /resourcepc zu verwechseln.
Zur Angabe von Blue Prism Anmeldedaten. Wenn Ihre Datenbank für Single Sign-on eingerichtet ist, sollten Sie stattdessen den Schalter /sso verwenden.
Weist Blue Prism an, den Befehl auf Basis der aktuellen Anmeldedaten eines Benutzers in einer Single Sign-on (SSO)-Konfiguration zu authentifizieren. Wenn Ihre Datenbank nicht für Single Sign-on eingerichtet ist, sollten Sie stattdessen den Schalter /user verwenden.
Zum Beispiel: Wenn Sie den Schalter /run verwenden, geben Sie anstatt
Automate.exe /run Process1 /user admin pwd
dies an:
Automate.exe /run Process1 /sso
Übernimmt alle zutreffenden Konfigurationsoptionen von Blue Prism für den gegenwärtig angemeldeten Betriebssystembenutzer. Standardmäßig gilt die Konfiguration für alle Benutzer.
Verwenden Sie diese Parameter zusammen, um eine neue Datenbankverbindung mit demselben Namen wie der angegebene Datenbankname zu erstellen (siehe auch /dbconname), oder um eine ggf. existierende Verbindung zu aktualisieren. Für die empfohlene SQL Server Authentifizierung müssen alle vier Parameter angegeben werden. Für die Windows Authentifizierung sollten Benutzername und Passwort ausgelassen werden. Diese Verbindung wird auch als aktuelle Verbindung festgelegt. Danach wird Blue Prism beendet.
Verwenden Sie /setdbserver, um die Verbindung einer Verfügbarkeitsgruppe anstatt einer direkten Datenbankverbindung anzugeben. In diesem Fall ist „databaseservername“ der Listener der Verfügbarkeitsgruppe.
Mit /ag den Port für den Listener der Verfügbarkeitsgruppe angeben. Bei keiner Angabe wird der Standard-Port 1433 verwendet.
Mit /ag verwenden, um anzugeben, dass Multisubnet-Failover aktiviert werden soll.
Erstellt eine neue Blue Prism Serververbindung mit demselben Namen wie der angegebene Host. (Siehe auch /dbconname, /connectionmode and /bpserversecure) Die Verbindung wird zudem als die aktuelle Verbindung festgelegt. Danach wird Blue Prism beendet.
Kann mit den Optionen /setdbserver oder /setbpserver verwendet werden, um einen anderen Verbindungsnamen als den standardmäßigen anzugeben. Wird keiner dieser Parameter verwendet, gibt die Option den Namen der zu verwendenden Datenbankverbindung an.
Kann mit der Option /setbpserver verwendet werden, um den Modus für die Verbindung zwischen Client und Blue Prism Server einzustellen. Beachten Sie, dass diese Option mit dem entsprechenden Wert in der Blue Prism Serverkonfiguration übereinstimmen muss.
Der Standardwert ist 0. Verfügbare Verbindungsmodi:
- 0 – WCF: SOAP mit Nachrichtenverschlüsselung und Windows Authentifizierung
- 1 – WCF: SOAP mit Transportverschlüsselung und Windows Authentifizierung
- 2 – WCF: SOAP mit Transportverschlüsselung
- 3 – .NET Remoting: Sicher
- 4 – .NET Remoting: Unsicher
- 5 – WCF Unsicher
Kann mit der Option /setbpserver verwendet werden, um die Sicherheit einer Blue Prism Serververbindung zu deaktivieren. Dies sollte niemals geschehen, außer es wurden alternative Vorkehrungen zur Absicherung der Verbindung getroffen. HINWEIS: Die Option /bpserversecure ist mittlerweile veraltet. Verwenden Sie stattdessen /connectionmode.
Startet die Prozessalarmüberwachung im Hintergrund. Muss zusammen mit dem Schalter /User oder /sso verwendet werden, damit die richtige Prozessalarmkonfiguration eines Benutzers verwendet wird.
Stellt die Priorität der Blue Prism Anwendung auf den angegebenen Modus ein. Wird normal dazu verwendet, die Priorität des Windows Prozesses von Blue Prism zu kontrollieren, wenn Blue Prism als Ressourcen-PC fungiert. Dies kann nützlich sein, wenn Blue Prism eine höhere Priorität als andere Prozesse auf dem PC erfordert, die andernfalls zu viele CPU-Ressourcen beanspruchen und die Funktion von Blue Prism beeinträchtigen könnten. Gültige Modi:
- below – geringere Priorität als normal
- above – höhere Priorität als normal
- high – hohe Priorität
- realtime – höchstmögliche Priorität
Wird zusammen mit dem Parameter /run verwendet, um Startparameter für eine Sitzung anzugeben.
Der Parameter „Parameter-XML“ sollte gültige Blue Prism XML-Parameter enthalten, umschlossen von Anführungszeichen (""). Da Anführungszeichen beim Standard-Input zum Trennen von Beginn/Ende der XML-Zeichenfolgen von Parametern verwendet werden, empfiehlt Blue Prism das Trennen der XML-Attribute durch einzelne Anführungszeichen (''). Z. B.:
AutomateC /run "Excel Test" /resource IhrPCHostname /user admin mypwd /startp "<inputs> <input name='Comment' type='text' value='Hallo Welt' /></inputs>"
Alternativ können Sie zwei Anführungszeichen pro Anführungszeichen in einer Parameter-XML-Zeichenfolge als Escapezeichen verwenden. Z. B.:
AutomateC /run "Excel Test" /resource IhrPCHostname /user admin mypwd /startp "<inputs> <input name=""Comment"" type=""text"" value=""Hallo Welt"" /></inputs>"
Benutzer mit Single Sign-on sollten in den obigen Beispielen den Schalter /sso anstelle des Schalters /user verwenden. Z. B.:
AutomateC /run "Excel Test" /resource IhrPCHostname /sso /startp "<inputs> <input name=""Comment"" type=""text"" value=""Hallo Welt"" /></inputs>"
Zeigt das Datenbank-Konfigurationsfenster an. Wenn der Benutzer dieses Fenster schließt (über die Schaltfläche „OK“ oder „Abbrechen“), wird die Anwendung beendet.
AutomateC.exe – verfügbare Schalter
Zum Ausdrucken einiger Kurztipps zum Standard-Output der Befehlszeile.
Erstellt mit der bereits konfigurierten Datenbankverbindung eine Datenbank (siehe Automate.exe /setdbserver). Das erforderliche Passwort wird als Teil der konfigurierten Datenbankverbindung bereitgestellt.
Der Unterschied zum Schalter /replacedb besteht darin, dass sämtliche bestehenden Datenbanken mit demselben Namen verworfen werden, wohingegen /replacedb die Tabellen in der Datenbank verwirft, die Datenbank selbst bleibt jedoch bestehen.
Erstellt mit der bereits konfigurierten Datenbankverbindung eine Datenbank (siehe Automate.exe /setdbserver). Das erforderliche Passwort wird als Teil der konfigurierten Datenbankverbindung bereitgestellt.
Der Unterschied zum Schalter /createdb besteht darin, dass bei einer bereits vorhandenen gleichnamigen Datenbank lediglich die enthaltenen Tabellen verworfen werden, wohingegen /createdb die gesamte Datenbank verwirft und neu erstellt.
Bestimmt die Active Directory-Gruppe für Blue Prism Administratoren bei der Erstellung der Datenbank. Nur für Single Sign-on relevant. Muss zusammen mit /setaddomain und entweder /createdb oder /replacedb verwendet werden.
Bestimmt den Domain-Namen für Blue Prism Administratoren bei der Erstellung der Datenbank. Nur für Single Sign-on relevant. Muss zusammen mit /setadadmingroup und entweder /createdb oder /replacedb verwendet werden.
Führt ggf. ein Upgrade einer bestehenden Datenbank durch. Das erforderliche Passwort wird als Teil der konfigurierten Datenbankverbindung bereitgestellt.
Erstellt ein SQL-Skript, das zur Erstellung einer neuen Datenbank an einen DBA übergeben werden kann. Zum Beispiel:
AutomateC.exe /getdbscript createdb.sql
Erzeugt das Skript – createdb.sql.
Erstellt oder aktualisiert die BP-Serverkonfiguration mit dem angegebenen Namen. Dabei werden Name und Überwachungsport der Datenbankverbindung anhand der angegebenen Werte eingestellt.
Mit dem optionalen Schalter /connectionmode kann der Verbindungsmodus eingestellt werden.
Wenn keine Verschlüsselungsschemata für die BP-Serverkonfiguration festgelegt wurden, wird ein neuer Datensatz für das Verschlüsselungsschema erstellt. Standardmäßig wird das Schema Standard-Verschlüsselungsschema genannt und für die Verschlüsselung mit AES 256 (AESCryptoService) und einem zufällig erzeugten Schlüssel konfiguriert. Alternativ können Sie die zu verwendeten Einstellungen mit dem Schalter /encryptionscheme definieren.
Dieser optionale Schalter wird zusammen mit /serverconfig verwendet, um die bei der Erstellung eines Verschlüsselungsschemas zu verwendenden Einstellungen zu definieren.
<Name> definiert den Namen des Verschlüsselungsschemas.
<Verschlüsselungsmethode> (optional) definiert den zu verwendenden Verschlüsselungsalgorithmus.
- 1 = Triple DES (192 Bit)
- 2 = AES-256 RijndaelManaged (256 Bit)
- 3 = AES-256 AesCryptoService (256 Bit) – Standard
Triple DES (192 Bit) wird zur Abwärtskompatibilität bereitgestellt. Es wird dringend davon abgeraten, neue Verschlüsselungsschemata mit dieser Methode zu konfigurieren.
Fordert eine Aktualisierung des Repository der Objekt-/Prozessabhängigkeiten an, wenn es von einem Blue Prism Upgrade als veraltet markiert wurde. Wird dabei „force“ angegeben, wird das Repository ungeachtet seines gegenwärtigen Status aktualisiert.
Fügt den Lizenzschlüssel in der angegebenen Datei zur Blue Prism Datenbank hinzu. Erfordert die Bereitstellung von Benutzer-Anmeldedaten über den Schalter /user oder /sso.
Lizenzen lassen sich auch über den System-Manager in der Client-Anwendung verwalten.
Entfernt den Lizenzschlüssel in der angegebenen Datei aus der Blue Prism Datenbank. Erfordert die Bereitstellung von Benutzer-Anmeldedaten über den Schalter /user oder /sso.
Lizenzen lassen sich auch über den System-Manager in der Client-Anwendung verwalten.
Registriert ein COM-Geschäftsobjekt zur Verwendung auf dem lokalen Computer. Dies entspricht dem Aufrufen des Bereichs „Externe Geschäftsobjekte“ im System-Manager.
Der Parameter „clsid“ bezieht sich auf die ID der COM-Klasse.
Registriert einen Webdienst zur Nutzung in Blue Prism Prozessen. Dies entspricht dem Registrieren eines Webdiensts über den Assistenten im Bereich „Webdienste“ im System-Manager.
- Erfordert die Bereitstellung von Benutzer-Anmeldedaten über den Schalter /user oder /sso.
- Kann optional zusammen mit dem Schalter /objectname verwendet werden.
- Optional kann der Schalter /timeout angegeben werden.
- Wenn Anmeldedaten zum Abrufen des WSDL-Dokuments erforderlich sind, kann der Schalter /wsauth verwendet werden.
Die Kennzeichnung <servicename> muss mit dem Namen des Dienstes übereinstimmen, der im WSDL-Dokument des Webdienstes aufgeführt wird (siehe das Glossar zu Webdiensten für weitere Informationen über WSDL-Dokumente). Das ist nötig, weil ein WSDL-Dokument mehrere verschiedene Webdienste beschreiben kann. Der angegebene Name unterscheidet sich von dem, der mit dem Schalter /objectname vergeben wird. Dieser spezifiziert die interne Bezeichnung des Webdiensts in Ihren Blue Prism Prozessen.
Der Parameter <WSDLURL> muss die Adresse (URL) eines WSDL-Dokuments für den betreffenden Webdienst angeben. Dieses wird je nach Fall über http oder https abgerufen.
Hebt die Registrierung eines Webdienstes auf. Dies entspricht dem Löschen eines Webdienstes über den Assistenten im Bereich „Webdienste“ im System-Manager.
Die Kennzeichnung <Servicename> muss mit dem internen Namen des Webdiensts in Ihren Blue Prism Prozessen übereinstimmen.
Wird zusammen mit dem Schalter /regwebservice verwendet, um den Geschäftsobjektnamen anzugeben, den der Webdienst nach der Registrierung erhält.
Wird zusammen mit dem Schalter /regwebservice verwendet, um die Benutzer-Anmeldedaten für die HTTP-Anfrage beim Download des WSDL-Dokuments anzugeben. Dieser Schalter ist nur erforderlich, wenn das WSDL vom Hostserver passwortgeschützt ist.
Wird zusammen mit dem Schalter /regwebservice verwendet, um den Timeout-Wert für den Webdienst anzugeben (in Millisekunden). Dabei handelt es sich um den Timeout für das Warten auf eine Antwort vom Webdienst zur Laufzeit. Der Timeout kann später durch Bearbeiten des Webdiensts im System-Manager abgeändert werden.
Optional kann dieser Schalter zusammen mit dem Befehl /regwebservice verwendet werden. Wird er nicht verwendet, gilt der Standardwert von 10.000 Millisekunden.
Diese Standardfunktion für SQL Abfragen, die vom Produkt ausgeführt werden, legt ein Zeitlimit für die Ausführung eines Befehls und die Rückgabe von Ergebnissen fest, bevor ein Timeout ausgelöst wird; standardmäßig auf 60 Sekunden festgelegt.
Legt ein Zeitlimit für die Ausführung eines Befehls und die Rückgabe von Ergebnissen fest, bevor ein Timeout ausgelöst wird. Betrifft SQL Abfragen, bei denen die Rückgabe von Ergebnissen typischerweise am längsten dauert, z. B. Abfragen, die mit Arbeitswarteschlangen interagieren; standardmäßig auf 600 Sekunden festgelegt.
Legt ein Zeitlimit für die Ausführung eines Befehls und die Rückgabe von Ergebnissen fest, bevor ein Timeout ausgelöst wird. Betrifft Logs, die typischerweise mehr Zeit benötigen; standardmäßig auf 0 (unendlich) festgelegt.
Diese Befehle bewirken eine systemweite Änderung, die nicht rückgängig gemacht werden kann, und sollten nur auf Empfehlung des Blue Prism Supportteams verwendet werden.
Schreibt einen Systembericht in die angegebene Datei. Der Systembericht gewährt einen Überblick über den gegenwärtigen Status des Systems – die Anzahl der Sitzungen, Log-Einträge und Warteschlangenelemente, der Validierungsstatus der Prozesse usw.
Schreibt einen Elementnutzungsbericht in die angegebene CSV-Datei. Mit der Option /process können Sie angeben, zu welchem Geschäftsobjekt ein Bericht erstellt werden soll. Der Bericht enthält Informationen zu der Seite und Phase, wo die Elemente des Anwendungsmodells genutzt werden.
Importiert einen Blue Prism Prozess (oder ein visuelles Geschäftsobjekt) in die Datenbank. Standardmäßig wird die ID in der Datei verwendet (falls vorhanden, sonst wird einen neue ID erzeugt). Mit /forceid kann dieses Verhalten überschrieben werden.
Der Parameter „Spezifizierte Datei“ bezieht sich auf den Speicherort der zu importierenden XML-Datei.
Standardmäßig schlägt dieser Vorgang fehl, wenn der/das importierte Prozess/Objekt bereits in der ausgewählten Umgebung vorhanden ist. Mit /overwrite lässt sich dies vermeiden.
Wird mit /import verwendet, um die Verwendung der angegebenen ID für den Prozess zu erzwingen, anstatt die ID aus der importierten Datei zu verwenden.
Durch „new“ wird eine neue ID für das importierte Objekt erzeugt, andernfalls sollte eine gültige GUID angegeben werden.
Standradmäßig schlägt /import fehl, wenn der/das importierte Prozess/Objekt bereits Teil der Datenbank ist.
Durch die Option /overwrite wird eine neue Version des Prozesses/Objekts importiert, die die derzeit bestehende überschreibt.
Hinweis: Wenn bereits ein Prozess/Objekt mit dem Namen des importierten Prozesses/Objekts, aber mit einer anderen ID vorhanden ist, schlägt der Import fehl – /overwrite funktioniert nur, wenn ein Prozess/Objekt mit der gleichen ID gefunden wird.
In diesem Fall kann der Importassistent innerhalb des Produkts verwendet werden.
Importiert eine Blue Prism Releasedatei (.bprelease) oder Blue Prism Fertigkeitsdatei (.bpskill) in die Datenbank. Diese Aktion gleicht dem interaktiven Import über den Blue Prism Client (siehe Release-Registerkarte), außer, dass sie nicht interaktiv ist und Konflikte nach Möglichkeit automatisch gelöst werden. Im Allgemeinen ist die Standardaktion beim Importieren das Überschreiben eines bereits in der Datenbank vorhandenen Elements. Allerdings können Konflikte den nicht interaktiven Import eines Release verhindern. Folgende Tabelle enthält eine Zusammenfassung der Handhabung von Konflikten:
Konflikt | Ergebnis |
---|---|
Element mit gleicher ID/gleichem Namen bereits in Datenbank vorhanden | Element wird überschrieben |
Prozess muss nach Import veröffentlicht oder zurückgezogen werden | Prozess wird veröffentlicht/zurückgezogen |
Es folgen Beispiele zu Konflikten, die ein Scheitern des Imports verursachen:
|
Der Release wird nicht importiert |
Beim interaktiven Importieren von Anmeldedaten wird der Benutzer zur Eingabe von Benutzername und Passwort aufgefordert (da diese Informationen nicht in die Exportdatei geschrieben werden). Beim nicht interaktiven Importieren werden Benutzername/Passwort nicht angegeben und sie müssen manuell im Blue Prism Client aktualisiert werden.
Der Parameter „Spezifizierte Datei“ bezieht sich auf den Speicherort der zu importierenden .bprelease-Datei.
Exportiert die aktuelle Version des angegebenen Blue Prism Pakets von der Datenbank in das lokale Dateisystem. Um einen früheren Release eines Pakets zu exportieren, verwenden Sie den optionalen Parameter [/release <Releasename>].
Exportiert einen Blue Prism Prozess (oder ein visuelles Geschäftsobjekt) aus der Datenbank in das lokale Dateisystem.
Archiviert Sitzungslogs in Dateien. Siehe Archivieren für weitere Informationen. Ohne Einstellungen werden alle Sitzungslogs archiviert. Um nur bestimmte Logs zu archivieren, verwenden Sie die Option /age oder eine Kombination aus /from und /to. Mit /process können Sie die Archivierung in Logs für einen bestimmten Prozess einschränken.
Um Sitzungslogs zu löschen, ohne sie zu exportieren, verwenden Sie die Option /delete.
Zum Wiederherstellen von Sitzungslogs aus Dateien in die Datenbank. Siehe Archivieren für weitere Informationen. Ohne Einstellungen werden alle Sitzungslogs wiederhergestellt. Um nur bestimmte Logs zu archivieren, verwenden Sie die Option /age oder eine Kombination aus /from und /to.
Zum Einstellen des Archivierungspfads. Dieser Pfad wird von den Befehlen /archive und /restorearchive sowie im System-Manager verwendet.
Wird zusammen mit /archive und /restorearchive verwendet, um den inklusiven Beginn eines Datumsbereichs anzugeben.
Wird zusammen mit /archive und /restorearchive verwendet, um das nicht inklusive Ende eines Datumsbereichs anzugeben.
Wird zusammen mit /queueclearworked verwendet und löscht alle bearbeiteten Elemente, die das angegebene Alter überschreiten (einschließlich Elemente, die vor dieser Zeit als Ausnahme markiert wurden).
Wird zusammen mit /archive und /restorearchive verwendet, umgeht die Datumsbereich-basierte Auswahl und wählt Sitzungen aus, die ein bestimmtes Alter überschreiten. Der Wert ist eine Zahl gefolgt von „y“ (Jahre), „m“ (Monate), „w“ (Wochen) oder „d“ (Tage). Zum Beispiel legt „6m“ fest, dass Logs archiviert werden, die älter als 6 Monate sind.
Wird zusammen mit /archive verwendet und beschränkt die Archivierung auf Sitzungen, in denen der genannte Prozess ausgeführt wurde. Bei der Verwendung mit /elementusage wird ein Prozess zur Berichterstellung ausgewählt.
Zum Ausführen eines Prozesses über die Befehlszeile. Der Prozessname-Parameter muss in Anführungszeichen stehen, wenn er ein Leerzeichen enthält. Der genannte Prozess muss veröffentlicht sein, um ausgeführt werden zu können (siehe /publish). Input-Parameter können mit dem Parameter /startp angegeben werden.
Zum Ausführen eines Prozesses sind Benutzeranmeldedaten erforderlich – siehe /user und /sso.
Wird zusammen mit /archive verwendet, um die Logs zu löschen, ohne sie vorher zu exportieren.
Löscht eine Umgebungsvariable.
Veröffentlicht den genannten Blue Prism Prozess. Wenn der Name des Prozesses Leerstellen enthält, muss er in Anführungszeichen stehen.
Hebt die Veröffentlichung des genannten Blue Prism Prozesses auf. Wenn der Name des Prozesses Leerstellen enthält, muss er in Anführungszeichen stehen.
Macht das genannte Blue Prism Objekt/den genannten Prozess als Webdienst zur Nutzung durch externe Anwendungen verfügbar. Wenn der Name des Objekts oder Prozesses Leerstellen enthält, muss er in Anführungszeichen stehen.
Wenn der optionale Parameter /forcedoclitencoding verwendet wird, gibt der Webdienst SOAP-Nachrichten zu Zwecken der WS-I Compliance immer in Form eines Dokuments oder Literals wieder.
Ist der Parameter /forcedoclitencoding nicht vorhanden, können Sie die Verwendung eines globalen Namespace erzwingen.
Verbirgt Blue Prism Objekte oder Prozesse, die bisher als Webdienst verfügbar waren. Wenn der Name des Objekts oder Prozesses Leerstellen enthält, muss er in Anführungszeichen stehen.
Ruft das Log der angegebenen Sitzung ab. Die Sitzungs-ID ist eine eindeutige Kennzeichnung im Format xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. Erfordert die Bereitstellung von Benutzer-Anmeldedaten über den Schalter /user oder /sso.
Das Log wird Zeile für Zeile in den Standard-Output geschrieben. Es können maximal 232 -1 Zeilen geschrieben werden. In der Praxis ist dieses Limit jedoch nicht von Belang, da es Hunderten Gigabyte an Daten entspricht.
Meldet Sitzungen für einen angegebenen Ressourcennamen. Die Ergebnisse lassen sich zeitlich einschränken. Um alle Ressourcen aufzulisten, geben Sie als Ressourcennamen [Alle] an.
Sie können auch einen Wert und einen Typ für das Limit angeben (m = Minuten, h = Stunden, d = Tage, mm = Monate), um die gelieferten Ergebnisse einzuschränken. Zum Beispiel liefert /resourcestatus ABC:8181 1 d alle Sitzungen für die genannte Ressource, die am vergangenen Tag gestartet wurden.
Erfordert die Bereitstellung von Benutzer-Anmeldedaten über den Schalter /user.
Sendet eine „Stoppanfrage“ an die genannte Sitzung und setzt eine Flag, die der laufende Prozess mit der Funktion IsStopRequested() in der Entscheidungsphase überprüfen kann.
Entweder die Sitzungs-ID (eine GUID) oder die Sitzungsnummer (eine Zahl) muss angegeben werden, um die Sitzung zu kennzeichnen, die eine Flag für die Stoppanfrage erhalten soll.
Beachten Sie, dass diese Aktion nur von einem authentifizierten Benutzer (bereitgestellt über die Schalter /user oder /sso) mit der Berechtigung Vollständiger Zugriff auf das Sitzungsmanagement ausgeführt werden kann.
Erstellt eine Arbeitswarteschlange mit den Werten Schlüsselfeld, Ausführen und Max. Versuche, wie es beim manuellen Erstellen einer Warteschlange im System-Manager erforderlich wäre.
Muss in Kombination mit /queuename verwendet werden. Erfordert die Bereitstellung von Benutzer-Anmeldedaten über den Schalter /user oder /sso.
Wendet die gewünschte Verschlüsselungsmethode auf die Blue Prism Serverkonfiguration an. Sie können die standardmäßige Blue Prism Verschlüsselung verwenden oder ein angegebenes Zertifikat installieren. Optionen für diesen Befehl:
- /configencrypt – Zeigt die aktuelle in der Serverkonfiguration verwendete Verschlüsselungsmethode an.
- /configencrypt default – Wendet die standardmäßige Blue Prism Verschlüsselung an. Erfordert die Angabe des Blue Prism Systemadministratorpassworts.
- /configencrypt thumbprint – Ändert die configencrypt-Methode zu eigenem Zertifikat mit spezifiziertem Fingerabdruck. Erfordert die Angabe des Blue Prism Systemadministratorpassworts.
- /configencrypt thumbprint /forceconfigencrypt – Erzwingt die Außerkraftsetzung eines Fehlers. Dadurch könnte eine Warnmeldung angezeigt werden. Erfordert die Angabe des Blue Prism Systemadministratorpassworts.
Zum Beispiel:
Aktuelle Verschlüsselungsmethode anzeigen:
AutomateC /configencrypt /user admin password
Standardmäßige Verschlüsselungsmethode aktivieren:
AutomateC /configencrypt default /user admin password
Verwendung des spezifizierten Zertifikatfingerabdrucks aktivieren:
AutomateC /configencrypt bc6269e89048cbf5553601cc0314b291609d9f3 /user admin password
Stellt das Verschlüsselungsschema ein, das von der angegebenen Warteschlange verwendet wird. Das angegebene Schema muss in dieser Umgebung konfiguriert werden, um erfolgreich verwendet werden zu können. Der standardmäßige Schemaname, der bei der Konfiguration vom Blue Prism Server angegeben wird, wird als Standard-Verschlüsselungsschema bezeichnet.
Um den Verschlüsselungsschlüssel einer Warteschlange zu deaktivieren, verwenden Sie den Schalter /resetencrypt.
Muss in Kombination mit /queuename verwendet werden. Erfordert die Bereitstellung von Benutzer-Anmeldedaten über den Schalter /user oder /sso.
Setzt das Verschlüsselungsschema der spezifizierten Warteschlange zurück, sodass diese nicht mehr verschlüsselt wird.
Muss in Kombination mit /queuename verwendet werden. Erfordert die Bereitstellung von Benutzer-Anmeldedaten über den Schalter /user oder /sso.
Diese Option bewirkt eine Neuverschlüsselung aller Anmeldedaten, Bildschirmaufnahmen von Ressourcen oder Warteschlangenelementdaten, die nicht nach dem aktuellen Schema verschlüsselt sind. Kann beispielsweise verwendet werden, wenn ein alter Schlüssel vor dem Löschen eines Verschlüsselungsschemas entzogen wird. Der Parameter /batchsize kontrolliert, wie oft aktualisierte Datensätze in die Datenbank geschrieben werden (Standardwert ist 1.000) und /maxbatches bestimmt, wie viele Batches verarbeitet werden (Standardwert ist 1).
Erfordert die Bereitstellung von Benutzer-Anmeldedaten über den Schalter /user oder /sso sowie Zugriff auf die Berechtigung Sicherheit – Verschlüsselungsschemata verwalten.
Exportiert Daten aus einer Arbeitswarteschlange und speichert sie im von <Spezifizierte Datei> angegebenen Ordner. Erfordert die Bereitstellung von Benutzer-Anmeldedaten über den Schalter /user oder /sso. Muss in Kombination mit /queuename verwendet werden. Kann zusammen mit /queuefilter und/oder /clearexported verwendet werden.
Beachten Sie, dass /exportqueue die Angabe von Benutzer-Anmeldedaten über den Schalter /user oder /sso und den Zugriff auf eine der folgenden Berechtigungen erfordert: Vollständiger Zugriff auf Warteschlangenmanagement, Lesezugriff auf Warteschlangenmanagement
Löscht bearbeitete Fälle (d. h. als abgeschlossen oder Ausnahme markierte Fälle) aus einer Arbeitswarteschlange. Erfordert die Bereitstellung von Benutzer-Anmeldedaten über den Schalter /user oder /sso. Muss in Kombination mit /queuename verwendet werden.
Bei Verwendung des Schalters /age werden nur bearbeitete Elemente aus der Warteschlange gelöscht, die das angegebene Alter überschritten haben. Andernfalls werden alle verarbeiteten Elemente aus der genannten Warteschlange gelöscht.
Stattdessen können Sie die Befehle /exportqueue und /clearexported zusammen verwenden, um einen Datensatz der im Prozess gelöschten Elemente zu erzeugen – dieser Befehl erstellt keinen derartigen Datensatz.
Gibt bei Verwendung zusammen mit einem auf Warteschlangen bezogenen Befehl wie /exportqueue oder /createqueue den Namen der Warteschlange an.
Gibt beim Export einer Warteschlange mit /exportqueue den Namen eines Filters an. Das ist der Name eines Filters, der im Bereich „Warteschlangenmanagement“ des Kontrollraums erstellt wurde.
Zusammen mit /exportqueue löscht dieser Befehl die bearbeiteten und zugeteilten exportierten Elemente.
Erfordert die Bereitstellung von Benutzer-Anmeldedaten über den Schalter /user oder /sso sowie Zugriff auf die Berechtigung Vollständiger Zugriff auf Warteschlangenmanagement.
Erstellt neue Anmeldedaten mit dem angegebenen Namen, Passwort und Benutzernamen.
Sind Benutzername und Passwort nicht erforderlich, können sie durch "" repräsentiert werden.
Wird nichts angegeben, werden Anmeldedaten vom Typ „Allgemein“ erstellt.
Erfordert die Bereitstellung von Benutzer-Anmeldedaten über den Schalter /user oder /sso sowie Zugriff auf die Berechtigung „Sicherheit – Anmeldedaten verwalten“.
Die erstellten Anmeldedaten sind standardmäßig universell für alle Benutzerrollen, Ressourcen und Prozesse verfügbar.
Aktualisiert bestehende Anmeldedaten, die anhand des angegebenen Namens gefunden werden.
Erfordert die Bereitstellung von Benutzer-Anmeldedaten über den Schalter /user oder /sso sowie Zugriff auf die Berechtigung „Sicherheit – Anmeldedaten verwalten“.
Wird mit /updatecredential zum Aktualisieren des Passworts der Anmeldedaten verwendet.
Wird mit /updatecredential zum Aktualisieren des Benutzernamens der Anmeldedaten verwendet.
Wird mit /updatecredential oder /createcredential zum Festlegen der Textbeschreibung der Anmeldedaten verwendet.
Wird zusammen mit /updatecredential oder /createcredential verwendet, um das Ablaufdatum für die Anmeldedaten festzulegen. Das Datumsformat muss JJJJMMTT sein.
Wird mit /updatecredential oder /createcredential verwendet, um zu spezifizieren, ob Anmeldedaten als ungültig markiert werden.
Wird mit /updatecredential oder /createcredential verwendet, um den Typ der Anmeldedaten zu spezifizieren. Muss ein unterstützter Wert sein.
Erstellt eine neue Anmeldedateneigenschaft oder aktualisiert diese, wenn sie bereits existiert.
Erfordert die Bereitstellung von Benutzer-Anmeldedaten über den Schalter /user oder /sso sowie Zugriff auf die Berechtigung „Sicherheit – Anmeldedaten verwalten“.
Zeitplaneroptionen
Mit dem AutomateC Befehlszeilenprogramm können Sie Zeitpläne starten und löschen und Berichte und Zeittabellen anzeigen.
Um Zeitplanaktionen durchzuführen, sind gültige Anmeldedaten erforderlich.
Gibt den oder die Namen von Zeitplänen für die Verwendung mit den Aktionen /startschedule, /deleteschedule, /viewschedtimetable und /viewschedreport an.
Parameter nach dem Schalter /schedule werden als Zeitplannamen behandelt, bis ein anderer Schalter beginnt (d. h. ein Parameter, der mit einem „/“ beginnt) oder das Ende des Befehls erreicht wird.
Wenn keine Zeitpläne angegeben werden, werden die Befehle allgemein als für alle Zeitpläne gültig betrachtet.
Startet den angegebenen Zeitplan zur gegenwärtigen Zeit. Wenn der Zeitplaner ausgeführt wird, sollte er den Zeitplan innerhalb von 30 Sekunden ausführen.
Löscht den angegebenen Zeitplan und alle zugehörigen Zeitplan-Logs.
Gibt das Output-Format des Zeitplanberichts oder der Zeittabelle an, entweder „txt“ (visuell lesbar) oder „csv“ (durch Kommas getrennte Variablen). Die Standardeinstellung ist „txt“, wenn kein Format angegeben wird.
Gibt die angegebene Zeittabelle aus.
Sie können eine benannte Zeittabelle angeben, die im Blue Prism Client erstellt und konfiguriert wurde.
Alternativ können Sie eine Ad-hoc-Zeittabelle spezifizieren, indem Sie angeben, ab welchem Datum sie ausgeführt werden soll, wie viele Tage anzuzeigen sind und in welchem Format sie heruntergeladen werden soll.
Gibt den spezifizierten Bericht aus.
Sie können einen benannten Bericht angeben, der im Blue Prism Client erstellt und konfiguriert wurde.
Alternativ können Sie einen Ad-hoc-Bericht spezifizieren, indem Sie angeben, bis zu welchem Datum der Bericht ausgeführt werden soll, wie viele Tage in der Vergangenheit anzuzeigen sind und in welchem Format er heruntergeladen werden soll.
Ressourcenpool-Optionen
Mit dem AutomateC Befehlszeilenprogramm können Sie Ressourcenpools erstellen und löschen sowie Ressourcen zu bestehenden Pools hinzufügen und daraus entfernen.
Um Aktionen für Ressourcenpools durchzuführen, sind gültige Anmeldedaten erforderlich.
Erstellt einen Ressourcenpool mit dem angegebenen Namen.
Löscht den angegebenen Ressourcenpool.
Fügt eine Ressource zum angegebenen Pool hinzu.
Wenn kein Ressourcenname angegeben wird, wird die lokale Ressource zum Pool hinzugefügt.
Entfernt eine Ressource aus ihrem Pool.
Wenn kein Ressourcenname angegeben wird, wird die lokale Ressource aus ihrem Pool entfernt.