Opciones de la línea de comandos
Blue Prism proporciona dos herramientas que aceptan modificadores de línea de comandos:
- Automate.exe: la aplicación gráfica de Blue Prism. Todos los mensajes o comentarios de esta aplicación se hacen visualmente. Un código de retorno de cero indica que el resultado es correcto; un código de retorno distinto de cero indica un error.
- AutomateC.exe: una herramienta de línea de comandos que arroja mensajes y comentarios a la línea de comandos (mediante salida estándar). Un código de retorno de cero indica que el resultado es correcto; un código de retorno distinto de cero indica un error.
Sugerencias:
- La ayuda dinámica está disponible para AutomateC utilizando el modificador /help. En Automate.exe, el modificador /help mostrará este documento en una ventana gráfica.
- Algunos modificadores requieren parámetros adicionales (se muestran a continuación como <parameter>), que deben colocarse a continuación del modificador.
- Los modificadores y los parámetros están separados por espacios. Si el valor de un parámetro contiene espacios u otros caracteres especiales, debe estar entre comillas dobles. Por este motivo, el valor real no puede contener comillas, por lo que se debe procurar evitarlas.
- Al aprobar XML, debe incluir la cadena XML entre comillas. Dado que las comillas se utilizan para delimitar el inicio/fin de la cadena XML de los parámetros en la entrada estándar, Blue Prism recomienda que delimite sus atributos XML mediante comillas simples. Como alternativa, puede anular todas las comillas presentes ingresando dos comillas, para cada comilla dentro de los parámetros XML.
-
Ejecute Blue Prism como un equipo de recursos exclusivo para el usuario "admin":
automate /resourcepc /user admin mypwd
o para un usuario de inicio de sesión único:
automate /resourcepc /sso
-
Ejecute Blue Prism como equipo de recursos público:
automate /resourcepc /public
-
Ejecute un proceso en el equipo local:
AutomateC /run "Mi proceso programado" /user admin mypwd
o para un usuario de inicio de sesión único:
AutomateC /run "Mi proceso programado" /sso
-
Ejecute un proceso en un equipo remoto con parámetros de inicio:
AutomateC /run "Prueba de Excel" /resource NombredeHostdesuPC /user admin mypwd /startp "<inputs> <input name='Comment' type='text' value='Hello World' /></inputs>"
-
Inicie la supervisión de alerta de proceso en segundo plano sin iniciar la aplicación principal de Blue Prism:
automate /alerts /user admin mypwd
o para un usuario de inicio de sesión único:
automate /alerts /sso
Automate.exe: modificadores disponibles
Imprime algunos consejos de ayuda rápidos en la salida estándar de la línea de comandos.
Inicia Blue Prism en el modo de equipo de recursos. El modificador /public se puede agregar para que el equipo de recursos esté disponible para todos los usuarios de Blue Prism. De lo contrario, solo estará disponible para el usuario especificado con la opción /user o la opción /sso.
Esta opción no debe confundirse con el modificador /resource.
Tenga en cuenta que iniciar y ejecutar un recurso de tiempo de ejecución con permisos elevados podría afectar la interacción con la aplicación que se está automatizando. Generalmente, los permisos del recurso de tiempo de ejecución deben coincidir con los del contexto de usuario de la aplicación destino.
Utilizado junto con el modificador /resourcepc únicamente. Hace que el equipo de recursos esté disponible públicamente, como se describe en los Modos de ejecución.
Utilizado junto con el modificador /resourcepc solamente, esto permite la seguridad de transporte (SSL/TLS) en conexiones al equipo de recursos, utilizando el certificado con la huella digital determinada, que debe instalarse en el almacén de certificados del usuario o del equipo.
Habilitar la seguridad de transporte afectará a ambas conexiones desde Control Room y el Programador, así como a los servicios web expuestos enrutados al recurso. El CN del certificado deberá coincidir con la dirección utilizada para conectarse al recurso, y el cliente que lo conecta deberá confiar en la CA que emite el certificado.
(Avanzado) Utilizado junto con el modificador /resourcepc solamente; esto anula la ubicación direccionable visualizada de los servicios web publicados y los recursos asociados como WSDL alojados en este dispositivo. El valor especificado deberá contener la dirección de ruta completa, p. ej., “https://blueprismws.myorg.com:8181”. Blue Prism adjuntará automáticamente /ws/ y las rutas asociadas a los recursos disponibles localmente.
Es esencial que se aplique de forma manual el enrutamiento de red adecuado para garantizar que el prefijo especificado sea una dirección válida que se enrute a este dispositivo.
(Avanzado) Utilizado junto con el modificador /resourcepc solamente; esto indica al recurso de tiempo de ejecución que ignore cualquier comunicación HTTP recibida en su puerto de escucha. Esta opción solo se puede usar cuando no se solicita al recurso que exponga un servicio web y no necesita controlarse mediante la interfaz HTTP.
En el inicio, espere a que la base de datos esté disponible durante el número especificado de segundos antes de renunciar. La conexión se volverá a intentar a intervalos durante este período. Esto puede ser útil en instalaciones pequeñas cuando se ejecuta un equipo de recursos al inicio con un “servidor” de base de datos en el mismo equipo; en este caso, la base de datos puede no estar lista inmediatamente para aceptar conexiones cuando se inicia el equipo de recursos. Por ejemplo, si usa /dbwait 120, volverá a intentarlo durante 2 minutos antes de renunciar.
El comando /dbwait se puede utilizar para establecer el tiempo que el servicio del servidor de Login Agent de Blue Prism espera una conexión, antes de que se agote el tiempo de espera. Esto es útil cuando todos los recursos se reinician al mismo tiempo. En estos casos, se recomienda que el tiempo de /dbwait se establezca en 300 (cinco minutos).
Para obtener más información, consulte Establecer la hora de reintento de conexión de Login Agent.
Utilizado junto con el modificador /resourcepc únicamente. El formulario de información del equipo de recursos se hace invisible de manera predeterminada. Puede volver a mostrarse a través del menú contextual en el área de notificación (busque el siguiente ícono: ).
Utilizado junto con el modificador /resourcepc únicamente. El equipo de recursos solo se podrá controlar desde el equipo local; los recursos remotos no estarán al tanto de su presencia.
Utilizado junto con el modificador /resourcepc únicamente. Especifica el puerto en el que Blue Prism debe ponerse a disposición como un equipo de recursos. De esta manera, puede ejecutar varios equipos de recursos desde el mismo equipo.
Esta opción puede ser útil en situaciones poco frecuentes y específicas. P. ej.:
- Anular el puerto predeterminado
Si el puerto predeterminado de 8181 ya se utiliza para otro servicio en su red, tal vez deba utilizar otro. Asegúrese de utilizar el mismo puerto para todos los equipos de recursos de su red, a menos que tenga un motivo específico para no hacerlo.
- Uso de Terminal Services
Al interactuar con un host de Terminal Services, Blue Prism solo puede ejecutar una sesión a la vez en cada equipo de recursos. Esto se debe a una restricción técnica de la implementación de Microsoft Terminal Services. Ejecutando varios equipos de recursos en diferentes puertos, un solo equipo puede ejecutar varias sesiones como de costumbre.
Esto determina el equipo de recursos objetivo para las alertas de proceso. Si esto no se especifica, se utilizará el equipo local.
Esta opción no debe confundirse con el modificador /resourcepc.
Se utiliza para proporcionar credenciales de inicio de sesión de Blue Prism cuando es necesario. Si su base de datos está configurada para el inicio de sesión único, debe usar el modificador /sso en su lugar.
Instruye a Blue Prism para que autentique el comando en función de las credenciales del usuario actual en una configuración de inicio de sesión único (SSO). Si la base de datos no está configurada para el inicio de sesión único, debe utilizar el modificador /user en su lugar.
Hace que todas las opciones de configuración de Blue Prism sean aplicables para el usuario del sistema operativo que inició sesión actualmente. De manera predeterminada, la configuración se aplica a todos los usuarios.
Utilice estos parámetros juntos para crear una nueva conexión de base de datos con el mismo nombre que el nombre de base de datos dado (consulte también /dbconname), o actualice esa conexión si existe. Para la autenticación del Servidor SQL, que se recomienda, se deben proporcionar los cuatro parámetros. Para la autenticación de Windows, se debe omitir el nombre de usuario y la contraseña. La conexión también está configurada para ser la actual. Después de esto, Blue Prism se cerrará.
Se usa con /setdbserver para especificar una conexión de grupo de disponibilidad en lugar de una conexión de base de datos directa. En este caso, el “databaseservername” será el nombre del receptor del grupo de disponibilidad.
Se usa con /ag para especificar el puerto para el receptor del grupo de disponibilidad. Si no se proporciona, se utilizará el valor predeterminado de 1433.
Se usa con /ag para especificar que debe habilitarse la conmutación por error de subred múltiple.
Crea una nueva conexión de servidor de Blue Prism con el mismo nombre que el host dado. (Consulte también /dbconname, /connectionmode y /bpserversecure). La conexión también está configurada como la actual. Después de esto, Blue Prism se cerrará.
Se puede utilizar con las opciones /setdbserver o /setbpserver para especificar un nombre de conexión en particular en lugar de utilizar el valor predeterminado. Si se utiliza sin uno de esos parámetros, especifica el nombre de la conexión de base de datos que se utilizará.
Se puede utilizar con la opción /setbpserver para seleccionar el modo de conexión utilizado para la conexión entre el cliente y el servidor de Blue Prism. Tenga en cuenta que esta opción debe coincidir con el valor correspondiente establecido en la configuración del servidor de Blue Prism.
El valor predeterminado es 0. Los modos de conexión disponibles son los siguientes:
- 0 – WCF: SOAP con cifrado de mensajes y autenticación de Windows
- 1 – WCF: SOAP con cifrado de transporte y autenticación de Windows
- 2 – WCF: SOAP con cifrado de transporte
- 3 – .NET Remoting: Seguro
- 4 – .NET Remoting: Inseguro
- 5 – WCF inseguro
Se puede utilizar con la opción /setbpserver para deshabilitar la seguridad en la conexión del servidor de Blue Prism. Esto nunca debe utilizarse a menos que se hagan arreglos alternativos para asegurar la conexión.
La opción /bpserversecure ha sido desaprobada y ahora debe utilizarse en su lugar la opción /connectionmode.
Inicia la supervisión de alerta de proceso en segundo plano. Debe utilizarse junto con uno de los modificadores /User o /sso para que se utilice la configuración correcta de alertas de proceso del usuario.
Establece la prioridad de la aplicación Blue Prism en el modo dado. Se utiliza normalmente para controlar la prioridad del proceso de Windows de Blue Prism cuando Blue Prism funciona como un equipo de recursos. Esto puede ser útil cuando Blue Prism necesita una prioridad más alta que otros procesos en el equipo que, de otro modo, podrían acaparar los recursos de la CPU y evitar que Blue Prism funcione de manera eficiente. Los modos válidos son los siguientes:
- por debajo: por debajo de la prioridad normal
- por encima: por encima de la prioridad normal
- alta: prioridad alta
- en tiempo real: la prioridad más alta posible
Se utiliza junto con el parámetro /run para suministrar parámetros de arranque a una sesión.
El parámetro paramsxml debe contener parámetros XML válidos de Blue Prism, entre comillas (""). Dado que las comillas se utilizan para delimitar el inicio/fin de la cadena XML de los parámetros en la entrada estándar, Blue Prism recomienda que delimite sus atributos XML mediante comillas simples (''). Ejemplo:
AutomateC /run "Prueba de Excel" /resource NombredeHostdesuPC /user admin mypwd /startp "<inputs> <input name='Comment' type='text' value='Hello World' /></inputs>"
Como alternativa, puede anular cualquier comilla presente ingresando dos comillas, para cada comilla dentro de los parámetros XML. Por ejemplo:
AutomateC /run "Prueba de Excel" /resource NombredeHostdesuPC /user admin mypwd /startp "<inputs> <input name=""Comment"" type=""text"" value=""Hello World"" /></inputs>"
Los usuarios de inicio de sesión único deben sustituir el modificador /sso en lugar del modificador /user en los ejemplos anteriores. Por ejemplo:
AutomateC /run "Prueba de Excel" /resource NombredeHostdesuPC /sso /startp "<inputs> <input name=""Comment"" type=""text"" value=""Hello World"" /></inputs>"
Muestra el formulario de configuración de la base de datos. Una vez que el usuario sale de este formulario (con los botones “Aceptar” o “Cancelar”), la aplicación se cierra.
AutomateC.exe: modificadores disponibles
Imprime algunos consejos de ayuda rápidos en la salida estándar de la línea de comandos.
Base de datos
Crea una base de datos con la conexión de base de datos ya configurada (consulte /setdbserver de Automate.exe). La contraseña requerida es la que se suministra como parte de la conexión de base de datos configurada.
Esto difiere del modificador /replacedb en que elimina cualquier base de datos existente con el mismo nombre, mientras que el modificador /replacedb elimina las tablas existentes dentro de la base de datos, sin eliminar la base de datos en sí.
Crea una base de datos con la conexión de base de datos ya configurada (consulte /setdbserver de Automate.exe). La contraseña requerida es la que se suministra como parte de la conexión de base de datos configurada.
Esto difiere del modificador /createdb en que, si ya existe una base de datos con el mismo nombre, simplemente se sueltan las tablas existentes dentro de esa base de datos, mientras que el comando /createdb soltará toda la base de datos y la recreará.
Actualiza una base de datos existente, si es necesario. La contraseña requerida es la que se suministra como parte de la conexión de base de datos configurada.
Claves de licencias
Agrega la clave de licencia en el archivo especificado a la base de datos de Blue Prism. Requiere que las credenciales de usuario se suministren a través de uno de los modificadores /user o /sso.
Las licencias también se pueden administrar mediante el Administrador del sistema en la aplicación del cliente.
Elimina la clave de licencia del archivo especificado de la base de datos de Blue Prism. Requiere que las credenciales de usuario se suministren a través de uno de los modificadores /user o /sso.
Las licencias también se pueden administrar mediante el Administrador del sistema en la aplicación del cliente.
Registro
Registra un objeto de negocio COM para su uso en el equipo local. Esto equivale a visitar el área “Objetos de negocio externos” en el Administrador del sistema.
El parámetro clsid se refiere a la Id. de clase COM.
Registra un servicio web para consumo en los procesos de Blue Prism. Esto equivale a registrar un servicio web a través del asistente en el área “Servicios web” en el Administrador del sistema.
- Requiere que las credenciales de usuario se suministren a través de uno de los modificadores /user o /sso.
- Otra posibilidad puede ser utilizarlo junto con el modificador /objectname.
- El modificador /timeout puede especificarse opcionalmente.
- Si se requieren credenciales para recuperar el documento WSDL, se puede utilizar el modificador /wsauth.
El identificador <servicename> debe coincidir con el nombre de un servicio que aparece en el documento WSDL del servicio web (consulte el Glosario de servicios web para obtener más información sobre los documentos WSDL). Esto es necesario porque un documento WSDL puede describir varios servicios web diferentes. El nombre proporcionado es distinto del que se obtiene mediante el modificador /objectname, que especifica el nombre por el cual se conocerá el servicio web internamente, dentro de sus procesos de Blue Prism.
El parámetro <WSDLURL> debe especificar la ubicación (URL) de un documento WSDL para el servicio web de interés. Esto se recuperará utilizando http o https, según corresponda.
Cancela el registro de un servicio web Esto equivale a eliminar un servicio web a través del asistente en el área “Servicios web” en el Administrador del sistema.
- Requiere que las credenciales de usuario se suministren a través de uno de los modificadores /user o /sso.
El identificador <servicename> debe coincidir con el nombre por el cual se conoce el servicio web internamente, dentro de sus procesos de Blue Prism.
Se utiliza junto con el modificador /regwebservice para especificar el nombre del objeto de negocio que se entregará al servicio web, una vez registrado.
Se utiliza junto con el modificador /regwebservice para especificar las credenciales de usuario que se utilizarán en la solicitud HTTP al descargar el documento WSDL. El uso de este modificador solo es necesario cuando el WSDL está protegido con contraseña por el servidor de hosting.
Se utiliza junto con el modificador /regwebservice para especificar el valor de tiempo límite que se asociará con el servicio web (medido en milisegundos). Este será el tiempo límite aplicado en tiempo de ejecución cuando se espera una respuesta del servicio web. Puede modificarse posteriormente visitando el Administrador del sistema y editando el servicio web.
El uso de este modificador junto con el comando /regwebservice es opcional. Si no se utiliza, se aplicará el valor predeterminado de 10 000 milisegundos.
Informe
Escribe un informe del sistema en el archivo especificado. El informe del sistema es una descripción general amplia del estado actual del sistema: el número de sesiones y entradas de registro, el número de elementos de cola, el estado de validación de los procesos, etc.
Genera un informe sobre todos los roles y permisos asociados para cada usuario en el sistema.
Escribe un informe de uso del elemento en el archivo especificado, en formato CSV. Utilice la opción /process para especificar el objeto de negocio sobre el que se va a informar. El informe contendrá detalles de la página y la fase donde se utiliza cada elemento del modelo de aplicación.
Importar/exportar
Importa un proceso de Blue Prism (o un objeto de negocio visual) a la base de datos de forma predeterminada utilizando la Id. que se encuentra en el archivo (si existe; de lo contrario, se genera una nueva Id.). Consulte /forceid para anular este comportamiento.
El parámetro filespec se refiere a la ubicación del archivo que se importará.
De manera predeterminada, si el proceso/objeto importado ya existe en el entorno seleccionado, esta operación fallará. Consulte /overwrite para evitar esta situación.
Importa un archivo de lanzamiento de Blue Prism (.bprelease) o un archivo de habilidad de Blue Prism (.bpskill) a la base de datos. Esta acción es funcionalmente lo mismo que realizar la importación de manera interactiva a través del cliente de Blue Prism (consulte la pestaña Lanzamiento), excepto que no es interactiva y cualquier conflicto se maneja automáticamente cuando sea posible. En general, la acción predeterminada será Sobrescribir si el elemento que se importa ya existe en la base de datos. Sin embargo, algunos conflictos evitarán que un lanzamiento se importe de manera no interactiva. La siguiente tabla resume el manejo de conflictos:
Conflicto |
Resultado |
---|---|
El elemento con la misma Id./nombre y tipo ya existe en la base de datos | El elemento se sobrescribirá |
El proceso debe publicarse o retirarse después de la importación | El proceso se publicará/retirará |
Los siguientes son ejemplos de conflictos que darían lugar a un error de importación:
|
El lanzamiento no se importará |
Al importar nuevas credenciales de manera interactiva, se le pide al usuario que ingrese el nombre de usuario y la contraseña (ya que esta información no se escribe en el archivo de exportación). Cuando se importan de manera no interactiva, las credenciales se importarán con un nombre de usuario/contraseña en blanco y requerirán actualización manual en el cliente de Blue Prism.
El parámetro filespec se refiere a la ubicación del archivo .bprelease que se importará.
Exporta un proceso de Blue Prism (o un objeto de negocio visual) de la base de datos al sistema de archivos local.
Exporta la versión actual del paquete de Blue Prism nombrado de la base de datos al sistema de archivos local. Para exportar un lanzamiento anterior de un paquete, utilice el parámetro opcional [/release <releasename>].
Úselo junto con /import para imponer el uso de la Id. dada para el proceso, en lugar de usar la definida en el archivo que se importará.
La palabra clave “new” generará una nueva Id. para el objeto importado; de lo contrario, se debe proporcionar un GUID válido.
De manera predeterminada, /import fallará si el proceso/objeto que se importará ya existe en la base de datos.
Si se utiliza la opción /overwrite, se importará una nueva versión del proceso/objeto encima de la existente.
Si existe un proceso/objeto diferente con el mismo nombre que el proceso/objeto importado, pero con una Id. diferente, la operación de importación fallará. /overwrite funciona solo si se encuentra un proceso/objeto con la misma Id. Para lidiar con este caso, el Asistente de importación se puede utilizar desde el interior del producto.
Publicar
Publica el proceso nombrado de Blue Prism. Si el nombre del proceso contiene espacios, deberá incluir el nombre entre comillas.
Cancela la publicación del proceso nombrado de Blue Prism. Si el nombre del proceso contiene espacios, deberá incluir el nombre entre comillas.
Expone el objeto o proceso nombrados de Blue Prism como un servicio web, para su consumo por parte de aplicaciones externas. Si el nombre del objeto o proceso contiene espacios, deberá incluir el nombre entre comillas.
Si el parámetro opcional /forcedoclitencoding está presente, el servicio web siempre arrojará mensajes SOAP en formato Documento/Literal para el cumplimiento de WS-I.
Si el parámetro /forcedoclitencoding no está presente, puede imponer el uso de un espacio de nombres global.
Oculta un objeto o proceso de Blue Prism que haya estado expuesto anteriormente como un servicio web. Si el nombre del objeto o proceso contiene espacios, deberá incluir el nombre entre comillas.
Cifrado
Configura la combinación de cifrado que utilizará la cola especificada. La combinación especificada debe configurarse dentro de este entorno para que se haga correctamente. El nombre de la combinación predeterminado, establecido en la configuración del servidor de Blue Prism, se denomina Combinación de cifrado predeterminada.
Para desactivar la clave del cifrado de una cola, consulte el modificador /resetencrypt.
Debe utilizarse junto con /queuename. Requiere que las credenciales de usuario se suministren a través de uno de los modificadores /user o /sso.
Restablece la combinación de cifrado en la cola especificada de manera que ya no esté cifrada.
Debe utilizarse junto con /queuename. Requiere que las credenciales de usuario se suministren a través de uno de los modificadores /user o /sso.
Esta opción vuelve a cifrar toda credencial, captura de pantalla de recursos o dato de elemento de cola que no estén cifrados según la combinación seleccionada actualmente. Se utiliza comúnmente cuando se revoca una clave antigua antes de eliminar una combinación de cifrado. El parámetro /batchsize controla la frecuencia con la que se asignan los registros actualizados en la base de datos (el valor predeterminado es 1000), y /maxbatches controla cuántos lotes se procesan (el valor predeterminado es 1).
Cuando se ejecuta el comando:
- Cualquier credencial o captura de pantalla de excepción que actualmente esté cifrada utilizando una combinación diferente a la que está configurada como la combinación de cifrado predeterminada se descifrará; y luego se volverá a cifrar utilizando la combinación de cifrado predeterminada.
- Todos los elementos de cola de trabajo cifrados que actualmente estén cifrados utilizando una combinación diferente a la que está configurada en la cola de trabajo se descifrarán; y luego se volverán a cifrar utilizando la combinación de cifrado asociada con la cola de trabajo.
Según el parámetro /batchsize configurado, el procesamiento se repetirá hasta que se alcance el valor de /maxbatches configurado.
Requiere que las credenciales de usuario se suministren a través de uno de los modificadores /user o /sso, y acceso al permiso Seguridad: administrar combinaciones de cifrado.
Aplica el método de cifrado requerido a la configuración del servidor de Blue Prism. Puede optar por utilizar el cifrado predeterminado de Blue Prism o instalar el certificado especificado. Las opciones para este comando son las siguientes:
- /configencrypt: muestra el método de cifrado actual utilizado en la configuración del servidor.
- /configencrypt default: aplica el cifrado predeterminado de Blue Prism. Requiere que se especifique la contraseña del administrador del sistema de Blue Prism.
- /configencrypt thumbprint: cambia el método configencrypt para tener el certificado con la huella digital especificada. Requiere que se especifique la contraseña del administrador del sistema de Blue Prism.
- /configencrypt thumbprint /forceconfigencrypt: impone la anulación de un error. Esto puede hacer que se muestre una advertencia. Requiere que se especifique la contraseña del administrador del sistema de Blue Prism.
Por ejemplo:
Mostrar método de cifrado actual:
AutomateC /configencrypt /user admin password
Configurar el método de cifrado predeterminado:
AutomateC /configencrypt default /user admin password
Configurar para usar la huella digital de certificado especificada:
AutomateC /configencrypt bc6269e89048cbf5553601cc0314b291609d9f3 /user admin password
Colas de trabajo
Crea una cola de trabajo con los valores keyfield, running y maxattempts, como se requeriría al crear una cola a mano en el Administrador del sistema.
Debe utilizarse junto con /queuename. Requiere que las credenciales de usuario se suministren a través de uno de los modificadores /user o /sso.
Exporta datos desde una cola de trabajo y los almacena en la ubicación que especifica <filespec>.
Requiere que las credenciales de usuario se suministren a través de uno de los modificadores /user o /sso.
Debe utilizarse junto con /queuename. Puede estar acompañado por los parámetros /queuefilter y /clearexported (uno de ellos o los dos).
Tenga en cuenta que /exportqueue requiere que las credenciales de usuario se suministren a través de uno de los modificadores /user o /sso, y acceso a uno de los siguientes permisos:
Acceso completo a la administración de colas, acceso de solo lectura a la administración de colas
Borra los casos procesados (es decir, los casos marcados como completados o excepciones) de una cola de trabajo.
Requiere que las credenciales de usuario se suministren a través de uno de los modificadores /user o /sso.
Debe utilizarse junto con /queuename.
Si se utiliza el modificador /age, solo se eliminarán de la cola los elementos procesados anteriores a la antigüedad especificada; de lo contrario, todos los elementos procesados se eliminarán de la cola nombrada.
Puede utilizar el comando /exportqueue junto con /clearexported en su lugar, ya que le permite generar un registro de los elementos que se eliminaron en el proceso; este comando no crea dicho registro.
Al utilizarse con /queueclearworked, elimina todos los elementos procesados que son más antiguos que la antigüedad especificada (esto incluye los elementos marcados como una excepción antes de este momento).
Al utilizarse con /archive y /restorearchive, evita la selección basada en el intervalo de fechas y selecciona sesiones anteriores a una antigüedad en particular. El valor es un número seguido de una opción entre “y” (años), “m” (meses) “w” (semanas) o “d” (días). Por ejemplo, “6m” especifica que los registros con más de 6 meses de antigüedad deben archivarse.
Especifica el nombre de una cola, cuando se utiliza junto con un comando relacionado con la cola, como /exportqueue o /createqueue.
Especifica el nombre de un filtro que se utilizará al exportar una cola con /exportqueue. Este es el nombre de un filtro creado en el área “Administración de colas” de Control Room.
Cuando se utiliza junto con /exportqueue, hace que los elementos procesados y mencionados exportados se eliminen de la cola.
Requiere que las credenciales de usuario se suministren a través de uno de los modificadores /user o /sso (uno de los dos), y acceso al permiso Acceso completo a la administración de colas.
Grupo de recursos
Puede crear y eliminar grupos de recursos, y agregar y eliminar recursos de grupos existentes mediante el programa de línea de comandos AutomateC.
Para realizar cualquiera de las acciones del grupo de recursos, se deben proporcionar detalles de inicio de sesión válidos.
Crea un grupo de recursos con el nombre especificado.
Elimina el grupo de recursos especificado.
Agrega un recurso al grupo especificado.
Si no se especifica un nombre de recurso, el recurso local se agrega al grupo.
Elimina un recurso del grupo en el que reside.
Si no se especifica un nombre de recurso, el recurso local se elimina de su grupo.
Programa
Puede iniciar y eliminar programas, y ver informes y tablas de ejecución de tareas mediante el programa de línea de comandos AutomateC.
Para realizar cualquiera de las acciones de programación, se deben proporcionar detalles de inicio de sesión válidos.
Especifica el nombre o los nombres de los programas que se utilizarán junto con las acciones /startschedule, /deleteschedule, /viewschedtimetable y /viewschedreport.
Todos los parámetros posteriores a un modificador /schedule se considerarán nombres de programa hasta que se alcance otro modificador (es decir, un parámetro que comienza con un carácter “/”) o se llegue al final del comando.
Cuando no se especifican programas, se considera que los comandos se ejecutan en todos los programas.
Inicia la planificación especificada en el momento actual. Si el programador se está ejecutando, debe ejecutar la programación en un plazo de 30 segundos.
Si el programa especificado nunca se ejecutó, se eliminan el programa y cualquier registro relacionado. Si el programa especificado se ejecutó anteriormente, el programa se marca como eliminado, pero se conserva cualquier registro existente.
Especifica el formato de salida del informe de planificación o la tabla de ejecución de tareas, ya sea 'txt' (legible para humanos) o 'csv' (variable separada por comas). El valor predeterminado es “txt” si no se especifica explícitamente ningún formato.
Genera el horario especificado.
Puede especificar un horario con nombre que se haya creado y configurado en el cliente de Blue Prism.
Como alternativa, puede especificar un cronograma ad hoc indicando la fecha a partir de la cual se debe ejecutar el cronograma, la cantidad de días que se mostrará y el formato en el que se descargará.
Genera el informe especificado.
Puede especificar un informe con nombre que se haya creado y configurado en el cliente de Blue Prism.
Como alternativa, puede especificar un informe ad hoc indicando la fecha hasta la cual debe incluir el informe, la cantidad de días pasados que se mostrará y el formato en el que se descargará.
Variable del entorno
Establece una variable de entorno existente. Si no hay variables de entorno existentes, la ejecución de este comando crea una nueva.
Elimina una variable del entorno.
Archivar
Archiva los registros de sesión en archivos. Consulte Archivado para obtener más detalles. Sin opciones, todos los registros de sesión se archivarán. Para limitar el intervalo de registros archivados, utilice la opción /age o una combinación de las opciones /from y /to. También puede utilizar /process para limitar el archivado a registros para un proceso en particular.
Para eliminar los registros de sesión, sin exportarlos, puede agregar la opción /delete.
Establezca la ruta de archivado. Esta es la ruta que utilizan los comandos /archive y /restorearchive, así como en la interfaz del Administrador del sistema.
Al utilizarse con /archive y /restorearchive, establece el inicio inclusivo de un intervalo de fechas.
Al utilizarse con /archive y /restorearchive, establece el final no inclusivo de un intervalo de fechas.
Al utilizarse con /queueclearworked, elimina todos los elementos procesados que son más antiguos que la antigüedad especificada (esto incluye los elementos marcados como una excepción antes de este momento).
Al utilizarse con /archive y /restorearchive, evita la selección basada en el intervalo de fechas y selecciona sesiones anteriores a una antigüedad en particular. El valor es un número seguido de una opción entre “y” (años), “m” (meses) “w” (semanas) o “d” (días). Por ejemplo, “6m” especifica que los registros con más de 6 meses de antigüedad deben archivarse.
Al utilizarlo con /archive, limita el archivado a sesiones que ejecutaron el proceso nombrado. Al utilizarlo con /elementusage, selecciona el proceso para generar un informe.
Asignación de usuarios
Asigna usuarios entre Blue Prism y Authentication Server. Se requiere el permiso Authentication Server: asignar usuarios.
inputcsvpath: la ruta a un archivo CSV que contiene detalles de los usuarios que se asignarán. Acceso de lectura requerido por AutomateC.
outputcsvpath: la ruta a la que se escribirá un archivo CSV que contiene los usuarios que no se pudieron asignar. Acceso de lectura y escritura requerido por AutomateC.
Estado
Sesiones de informe para un nombre de recurso determinado, los resultados pueden limitarse a un período específico. Para enumerar todos los recursos, use [Todos] como el nombre del recurso.
También puede proporcionar un número y tipo de límite (m = minutos, h = horas, d = días, mm = meses) para limitar los resultados arrojados, por ejemplo, /resourcestatus ABC:8181 1 d arrojaría todas las sesiones para el recurso nombrado que comenzó el último día.
Requiere que las credenciales de usuario se suministren a través del modificador /user.
Configuración del servidor
Crea o actualiza la configuración del servidor de Blue Prism identificada por el nombre especificado y establece el nombre de conexión de la base de datos y el puerto de escucha en los valores proporcionados.
Se puede utilizar un modificador opcional /connectionmode para establecer el modo de conexión.
Si no se han configurado combinaciones de cifrado para la configuración del servidor de Blue Prism, se creará un nuevo registro de combinación de cifrado. De manera predeterminada, la combinación se denominará Combinación de cifrado predeterminada y se configurará para usar AES 256 (AESCryptoService) y una clave generada aleatoriamente. Como alternativa, utilice el modificador /encryptionscheme para definir la configuración que se utilizará.
Utilizado junto con el modificador /serverconfig, este es un modificador opcional que se puede utilizar para definir la configuración que se usará cuando se cree una combinación de cifrado.
<name> define el nombre de la combinación de cifrado.
<encryptionmethod> (opcional) define el algoritmo de cifrado que se utilizará.
- 1 = Triple DES (192 bit)
- 2 = AES-256 RijndaelManaged (256 bit)
- 3 = AES-256 AesCryptoService (256 bit): predeterminado
Se proporciona triple DES (192 bits) por compatibilidad con versiones anteriores. Se recomienda enfáticamente que las nuevas combinaciones de cifrado no estén configuradas para usar este método.
Establece la configuración de Application Server Controlled Resources (ASCR) mediante los siguientes comandos:
AutomateC /ascrconfig <servername> <conntype> <hostname> <port> <connectionmode> <certificatename> <clientcertificatename> <servercertstore> <clientcertstore>
<conntype> acepta los siguientes valores:
- 1 – grpc
- 2 – wcf
<connectionmode> acepta los siguientes valores:
- 1 – certificate
- 2 – windows
- 3 – insecure
Las opciones de certificado solo se requieren cuando <connectionmode> especifica certificados.
Para obtener más información, consulte Configuración de ASCR.
Credenciales
Crea una nueva credencial con el nombre, la contraseña y el nombre de usuario especificados.
El nombre de usuario y la contraseña se pueden representar con "" si no se requieren.
Se creará un tipo de credencial general si no se especifica ninguno.
Requiere que las credenciales de usuario se suministren a través de uno de los modificadores /user o /sso (uno de los dos), y acceso al permiso Seguridad: administrar credenciales.
La credencial creada estará disponible universalmente para todos los roles de usuario, recursos y procesos de manera predeterminada.
Actualiza una credencial existente que se encontró con el nombre especificado.
Requiere que las credenciales de usuario se suministren a través de uno de los modificadores /user o /sso (uno de los dos), y acceso al permiso Seguridad: administrar credenciales.
Se usa con /updatecredential para actualizar la contraseña de la credencial.
Se usa con /updatecredential para actualizar el nombre de usuario que se encuentra en la credencial.
Se usa con /updatecredential o /createcredential para configurar el texto que se utiliza como la descripción de la credencial.
Se usa con /updatecredential o /createcredential para establecer la fecha en la que vencerá la credencial. La fecha debe tener el formato aaaammdd.
Se usa con /updatecredential o /createcredential para especificar si una credencial debe marcarse como no válida.
Se usa con /updatecredential o /createcredential para especificar el tipo de credencial. Debe ser un valor compatible.
Cree una nueva propiedad de credencial o actualícela si ya existe.
Requiere que las credenciales de usuario se suministren a través de uno de los modificadores /user o /sso (uno de los dos), y acceso al permiso Seguridad: administrar credenciales.
Actualiza la configuración del sistema para permitir inicios de sesión anónimos.
Autenticación de Windows
Esto solo está disponible en Blue Prism 7.0.2 y versiones posteriores.
Obliga a Microsoft Negotiate Security Package a seleccionar New Technology LAN Manager (NTLM) como Proveedor de Soporte de Seguridad (SSP) para la última conexión utilizada o especificada (usando el modificador /dbconname) al autenticar la conexión del servidor de Blue Prism. Esta opción se proporciona para que se pueda utilizar NTLM cuando Kerberos no está disponible o no está configurado (consulte Configuración de SPN). Por ejemplo, /forcentlm true
Esto solo está disponible en Blue Prism 7.0.2 y versiones posteriores.
Debe configurarse para cada conexión del servidor de Blue Prism en el cliente interactivo donde el dominio Kerberos del usuario es diferente al de la cuenta configurada para ejecutar el servidor de Blue Prism. Por ejemplo, /setkerberosrealm mycompany.com
El dominio Kerberos suele ser el mismo que el nombre de dominio; sin embargo, consulte con su equipo de TI para obtener el valor correcto. Este debe ser el dominio de la cuenta de servicio que ejecuta el servicio del servidor de Blue Prism. En algunos entornos, puede ser necesario aplicar la misma configuración donde la cuenta de servicio existe en otro dominio dentro del mismo bosque.
Tiempo de espera del comando
Función estándar para consultas SQL ejecutadas por el producto que establece el límite de tiempo para que un comando se ejecute y arroje resultados antes de que se agote el tiempo de espera; se establece en 60 segundos de forma predeterminada.
Establece el límite de tiempo para que un comando se ejecute y arroje resultados antes de que se agote el tiempo de espera para las consultas SQL que generalmente tardan más tiempo en arrojar resultados, p. ej., consultas que interactúan con colas de trabajo; se establece en 600 segundos de manera predeterminada.
Establece el límite de tiempo para que un comando se ejecute y arroje resultados antes de que se agote el tiempo de espera de los registros que, por lo general, tardan más; se establece en 0 (infinito) de manera predeterminada.
Estos comandos implementan un cambio irreversible en todo el sistema y solo deben utilizarse cuando lo aconseje el equipo de soporte de Blue Prism.
Directorio Activo
Determina el grupo de Directorio Activo para los administradores de Blue Prism en el momento en que se crea la base de datos. Solo es aplicable si desea usar el inicio de sesión único. Debe utilizarse junto con /setaddomain y /createdb o /replacedb (uno de los dos).
Determina el nombre de dominio para los administradores de Blue Prism en el momento en que se crea la base de datos. Solo es aplicable si desea usar el inicio de sesión único. Debe utilizarse junto con /setadadmingroup y /createdb o /replacedb.
Administración de sesiones
Se utiliza para ejecutar un proceso desde la línea de comandos. El parámetro processname debe estar entre comillas si contiene un espacio. El proceso nombrado debe publicarse para poder ejecutarse (consulte /publish). Los parámetros de entrada se pueden especificar con el parámetro /startp.
Se requieren credenciales de usuario para ejecutar un proceso; consulte /user y /sso, por ejemplo:
AutomateC.exe /run Process1 /user admin pwd
o
AutomateC.exe /run Process1 /sso
Envía una “Solicitud de detención” a la sesión especificada, lo que establece una marca que el proceso en ejecución puede verificar usando la función IsStopRequested() en una fase de decisión.
Debe proporcionarse una Id. de sesión (un GUID) o el número de sesión (un número) para indicar la sesión que debe marcarse con la solicitud de detención.
Tenga en cuenta que esto solo puede ejecutarlo un usuario autenticado (proporcionado mediante los modificadores /user o /sso) con el permiso Acceso completo a administración de sesiones.
Disposiciones varias
Aplica los permisos del usuario controlador para crear, iniciar o eliminar una sesión.
Solicita que el repositorio de dependencia de objeto/proceso se actualice si se ha marcado como desactualizado por una actualización de Blue Prism. Si se especifica la palabra clave “force”, el repositorio se actualizará independientemente de su estado actual.
Obtiene el registro de la sesión especificada. SessionID es un identificador único en el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. Requiere que las credenciales de usuario se suministren a través de uno de los modificadores /user o /sso.
El registro se escribe en la salida estándar, línea por línea. Hay un límite de datos de 232 -1 filas; sin embargo, este límite es irrelevante en la práctica, ya que corresponde a cientos de gigabytes de datos.
Generar una lista de procesos y objetos de negocio.