gatilidades | GATILIDADES.BLOGSPOT.COM

Pramo Anexo :: Vocabulario

PRAMO

: ANEXO - VOCABULARIO | 1

gatilidades | GATILIDADES.BLOGSPOT.COM

ÍNDICE DE CONTENIDO |01. Introducción.............................................................................................................3 |02. Anotaciones.............................................................................................................4 |03. Condiciones..............................................................................................................5 Ficheros........................................................................................................................5 Interfaz.........................................................................................................................5 Sistema.........................................................................................................................5 Tiempo..........................................................................................................................6 Varias............................................................................................................................6 |04. Acciones....................................................................................................................7 Energía..........................................................................................................................7 Interfaz.........................................................................................................................7 Multimedia...................................................................................................................8 Procesos.......................................................................................................................9 Sistema operativo.....................................................................................................10 Sistema de ficheros...................................................................................................11 Ratón...........................................................................................................................12 Tiempo........................................................................................................................12 Pramo.........................................................................................................................13 |05. Macros.....................................................................................................................14 |06. Definiciones y configuraciones...........................................................................15 |07. Variables y Conjuntos...........................................................................................17 |08. Teclas y combinaciones........................................................................................18 |09. Línea de comandos...............................................................................................19

PRAMO

: ANEXO - VOCABULARIO | 2

gatilidades | GATILIDADES.BLOGSPOT.COM

|01. Introducción El vocabulario de Pramo se divide en seis grupos o categorías que se detallan a continuación: Condiciones – Aparecen al comienzo de una línea y/o directamente antes de una acción para condicionar su procesado. También pueden encadenarse tras otras condiciones. Acciones – Aparecen al comienzo de una línea y/o directamente después de una condición; También pueden encadenarse tras otras acciones. Realizan tareas o ejecutan acciones que pueden afectar al sistema operativo e interfaz de usuario. Macros – Una macro -o macroinstrucción- es una palabra comodín precedida del símbolo arroba (@) que se incluye dentro de una condición o acción y durante la ejecución se ve sustituida por una cadena específica que se calcula/obtiene en ese instante. Definiciones y configuraciones – Opciones generales que suelen afectar a todo un fichero de sinopsis. No cuentan como condición ni acción aunque afectan a acciones y condiciones. Variables y Conjuntos – Variables y conjuntos cuyo contenido puede personalizar el usuario y utilizar o modificar posteriormente con acciones. Teclas y combinaciones – Envío de pulsaciones de teclas especiales; individuales y combinadas.

PRAMO

: ANEXO - VOCABULARIO | 3

gatilidades | GATILIDADES.BLOGSPOT.COM

|02. Anotaciones Se recomienda prestar atención a las siguientes notas y precisiones acerca del vocabulario que aparece en este documento: a. b.

c. d. e.

f. g. h. i.

j.

k.

l. m.

n.

El símbolo separador de barra vertical ("|") al comienzo de una línea marcará toda esa línea como un comentario y nada de la misma será interpretado por Pramo. Las comillas sólo indican que el contenido entrecomillado se escribe tal cual (normalmente usadas en nombres de sinopsis). En tales circunstancias, los símbolos de comillas no han de incluirse en el fichero de sinopsis y provocarán error de ser utilizados. Los parámetros se muestran en gris claro para resaltar la diferenciación respecto a la sinopsis. Todos los parámetros de sinopsis son obligatorios, excepto cuando se denote específicamente mediante los corchetes ("[" y "]"). Tales parámetros son opcionales. Ninguna de las sinopsis requiere posición precisa -salvo que se indique al contrario en su descripción- y pueden aparecer antes o después de cualquier otra, en cualquier orden, siempre que se respete la estructura de su sintaxis y parámetros. Las letras en cursiva en cualquier parámetro son meramente informativas. No son parte del parámetro y no deberán incluirse. Cuando un parámetro señale "nombre de proceso" o "nombre de fichero" se da por supuesto que incluirá la extensión, a menos que se indique de otro modo. Las macros utilizadas se valoran en el momento de ejecutar el fichero de sinopsis que las invoca; Y vuelven a valorarse cada vez que éste se ejecute. Las macros de rutas no incluyen la barra inclinada invertida -o contrabarra- al final ("\") por lo que deberá añadirse manualmente si es necesario (por ejemplo, para continuar una ruta a completar). Pramo no modificará el fichero de sinopsis en modo alguno. Los cambios en variables y conjuntos se realizan en memoria, son temporales y duran hasta que el fichero de sinopsis termine de ejecutarse. Siempre que Pramo reciba una ruta de fichero por parámetro ésta puede ser absoluta -es decir, completa, hasta la raíz del disco- o relativa, es decir, desde la carpeta del propio Pramo; Por ejemplo, teniendo una carpeta llamada sinopsis -en la misma donde se encuentra Pramocon un fichero dentro llamado lista.sps podría cargarse como: "sinopsis\lista.sps" sin más. Si varios ficheros de sinopsis son ejecutados concurrentemente y algunos coinciden en sus teclas definidas de pausa o salida sólo tendrá aplicación la del primero que se haya ejecutado. Por el momento se ha determinado que las tildes no pueden ser obviadas ni en sinopsis ni en parámetros, es decir, todo el vocabulario deberá ser respetado según dictan las normas de ortografía del castellano. Por otro lado, Pramo es flexible a la hora de interpretar mayúsculas y minúsculas en sinopsis y parámetros, es decir: no discriminará a la hora de interpretarlos salvo que se indique lo contrario en la descripción de la sinopsis pertinente. El envío de teclas sigue siendo tal cual se redacte.

PRAMO

: ANEXO - VOCABULARIO | 4

gatilidades | GATILIDADES.BLOGSPOT.COM

|03. Condiciones Ficheros · · ·

"carpetaexistente"|ruta completa – Comprueba si existe la carpeta indicada y procede con la línea. (Permite macros en la ruta) "ficheroexistente"|ruta completa al fichero – Comprueba si existe el fichero indicado y procede con la línea. (Permite macros en la ruta) "fechadefichero"|ruta y nombre de fichero|"creado/modificado/accedido"| [+/-/=D##][+/-/=M##][+/-/=A####][+/-/=h##][+/-/=m##][+/-/=s##] – Comprueba si uno o varios valores de la fecha de un fichero coinciden con la/s condiciones indicadas y procede con la línea. Cada letra equivale a un tipo de información, siendo: D día, M mes, A año, h hora, m minuto, s segundo. Como puede observarse, hay letras en mayúscula y minúscula por lo que será necesario escribirlas apropiadamente según convenga. (Permite macros en la ruta)

Interfaz · ·

·

"títulodeactualventana"|nombre – Compara el texto del parámetro con el título de la ventana que sea actual -encima del resto- en el momento de ejecución para proseguir con la línea. El nombre debe ser exactamente el mismo o no se validará la condición. "títuloparcialdeactualventana"|nombre – Compara el texto del parámetro con el título de la ventana que sea actual -encima del resto- en el momento de ejecución para proseguir con la línea. Cualquier parte de la cadena indicada que coincida con el nombre de la ventana validará la condición. "ventanaexistente"|nombre – Compara el texto del parámetro con el título de todas las ventanas, visibles u ocultas, en el momento de ejecución para proseguir con la línea. El nombre debe ser exactamente el mismo o no se validará la condición.

Sistema · · ·

"nombredeequipo"|nombre – Comprueba si el nombre del equipo coincide con el indicado y procede con la línea. No importa si está escrito en mayúsculas o minúsculas. "procesoexistente"|nombre del proceso – Comprueba si existe el proceso indicado y procede con la línea. "NOprocesoexistente"|nombre del proceso – Comprueba si no existe el proceso indicado y procede con la línea.

PRAMO

: ANEXO - VOCABULARIO | 5

gatilidades | GATILIDADES.BLOGSPOT.COM

Tiempo · · · · · · · · · · · ·

"hora"## – Comprueba si la hora actual es idéntica a la indicada (dos cifras en formato 24h: 00-23); de no serlo, termina de procesar la línea actual. "+hora"## – Comprueba si la hora actual es mayor a la indicada (dos cifras en formato 24h: 00-23); de no serlo, termina de procesar la línea actual. "-hora"## – Comprueba si la hora actual es menor a la indicada (dos cifras en formato 24h: 00-23); de no serlo, termina de procesar la línea actual. "minuto"## – Comprueba si el minuto actual es idéntico al indicado (dos cifras: 00-60); de no serlo, termina de procesar la línea actual. "+minuto"## – Comprueba si el minuto actual es mayor al indicado (dos cifras: 00-60); de no serlo, termina de procesar la línea actual. "-minuto"## – Comprueba si el minuto actual es menor al indicado (dos cifras: 00-60); de no serlo, termina de procesar la línea actual. "díadesemana"|"Lunes/Martes/Miércoles/Jueves/Viernes/Sábado/Domingo" – Comprueba si el día actual coincide con el indicado y procede a continuar la línea. "díademes"|## – Comprueba si el día actual coincide con el indicado (en formato numérico del 1 al 31) para proceder con la línea. "díapardesemana" – Comprueba si el día actual de la semana es par (asumiendo una semana que comienza en lunes y acaba en domingo) y prosigue con la línea actual de ser así. "díaimpardesemana" – Comprueba si el día actual de la semana es impar (asumiendo una semana que comienza en lunes y acaba en domingo) y prosigue con la línea actual de ser así. "mes"|"Enero/Febrero/Marzo/Abril/Mayo/Junio/Julio/Agosto/Septiembre/Octubr e/Noviembre/Diciembre" – Comprueba si el mes actual coincide con el indicado para proceder con la línea. "año"|#### – Comprueba si el año actual coincide con el indicado (4 cifras) y procede con la línea.

Varias ·

"azarlínea"# – Aleatoriza la ejecución del resto de la línea. Si el número indicado es inferior a un número que el programa sacará aleatoriamente (del 1 al 100) se continuará procesando la línea actual. Es decir, el programa ha de sacar un número mayor al indicado para seguir en la línea actual.

PRAMO

: ANEXO - VOCABULARIO | 6

gatilidades | GATILIDADES.BLOGSPOT.COM

|04. Acciones Energía · ·

"apagamonitor" – Desactiva el monitor poniéndolo en modo de espera/stand-by. "Gestión del sistema"|"Bloquea/Cierra sesión/En

·

espera/Hiberna/Reinicia/Reinicia forzosamente/Apaga" – Ejecuta una acción relacionada con la gestión de energía o del propio sistema operativo. Todos los nombres son autodescriptivos. En el caso de confusión entre En espera e Hiberna sólo ha de recordarse que el modo de hibernación es mucho más efectivo con la energía puesto que guarda el estado de los programas en el disco duro y apaga el equipo por completo; El modo En espera o stand-by es más apropiado para ordenadores de escritorio puesto que reduce el consumo de energía pero sigue necesitándola y si hubiera un corte de conexión nada estará respaldado. Notas: Esta acción requiere que exista un soporte para estos modos de energía por parte del PC y sus controladores. Esta es una sinopsis de final de línea. "iniciasalvapantallas" – Activa el salvapantallas actualmente asignado.

Interfaz · ·

"abrerutaenexplorador"|ruta – Abre una ventana del explorador de ficheros de Windows y muestra la ruta indicada; Si la ruta acaba en un fichero también selecciona el fichero en esa carpeta. "gestionaventana"| nombre|"cierra/elimina/minimiza/maximiza/restaura/oculta/muestra|"comienzo /parcial/exacto" – Busca entre todas las ventanas existentes -incluso ocultas- la que tenga un título exactamente igual al indicado y realiza una acción sobre ella. Notas: elimina cierra forzosamente la ventana, mientras que cierra no; incluso ésta puede quedar sin efecto si la ventana a cerrar solicitar grabar datos o una confirmación adicional antes de ser cerrada. Téngase en cuenta que, con esos dos parámetros, el nombre de ventana puede equivaler a programa si sólo existe una, por lo tanto tiene un efecto similar a cierraproceso si sólo existe una ventana del proceso relacionado. El último parámetro es el modo de coincidencia que establece cómo se buscará el título de la ventana a gestionar, siendo: desde el comienzo; en cualquier parte del título o parcial; o sólo si el parecido del título es exacto.

PRAMO

: ANEXO - VOCABULARIO | 7

gatilidades | GATILIDADES.BLOGSPOT.COM

Multimedia ·

·

·

"capturadepantalla"|ruta y fichero destino|"bmp/gif/jpg/png/tif" – Captura la pantalla y vuelca a un fichero de imagen en el formato elegido. El segundo parámetro determinará el formato y extensión del fichero. (Permite macros en la ruta/nombre del fichero destino). "reproduceficherosonoro"|ruta y nombre de fichero/"detener" – Reproduce un fichero .wav o .mp3 y continúa la ejecución. Si se desea interrumpir el resto de sinopsis hasta que acabe la reproducción puede emplearse cualquier sinopsis de espera de entre las mencionadas. Notas: La reproducción se detendrá inmediatamente si llega el final del fichero de sinopsis o, alternativamente, si se repite la sinopsis especificando detener como parámetro. "reproducepitido"|[frecuencia]|[duración] – El pitido sonará en la frecuencia (hercios/Hz) indicada (un número en formato decimal desde 0 hasta 32767) y durará el tiempo indicado en milisegundos, de forma que para que suene 5 segundos se indicará 5000. Notas: Ambos parámetros son opcionales y sus predeterminados son 500Hz y 1 segundo. Si el servicio ‘Beep’ de Windows no está en funcionamiento puede que esta sinopsis no funcione. Esta es una sinopsis de final de línea.

PRAMO

: ANEXO - VOCABULARIO | 8

gatilidades | GATILIDADES.BLOGSPOT.COM

Procesos ·

·

·

· · ·

"iniciaprograma"|ruta y nombre del ejecutable|[parámetro/s]|[carpeta de inicio]|[modo de ventana: "normal/oculto/minimizado/maximizado"]|[espera a que cierre: "0/1"] – Arranca un fichero ejecutable (.exe) bajo las condiciones indicadas. La ruta al fichero debe indicarse siempre, salvo que se encuentre en la propia carpeta de Pramo. El último parámetro condiciona si Pramo esperará al cierre del programa para continuar el resto de sinopsis. Salvo el primero, todos los parámetros son opcionales (sus valores predeterminados, si no se especifican, son: (vacío)|(ruta del ejecutable)|normal|0). (Permite macros en ruta/nombre y el/los parámetros). Esta es una sinopsis de final de línea. "iniciaobjeto"|ruta y nombre del objeto|[parámetro/s]|[carpeta de inicio]| [modo de ventana: "normal/oculto/minimizado/maximizado"]|[espera a que cierre: "0/1"]|["abrir/imprimir"] – Abre un objeto del disco duro, que puede ser carpeta, fichero/documento bajo las condiciones indicadas, iniciando el programa asociado a su tipo de extensión si es necesario. La ruta al fichero debe indicarse siempre, salvo que se encuentre en la propia carpeta de Pramo. El penúltimo parámetro condiciona si Pramo esperará al cierre del programa para continuar el resto de sinopsis. El último indica si se realiza una acción diferente a la predeterminada asociada a ese objeto en el sistema operativo (abrir no siempre es la acción predeterminada). Salvo el primero, todos los parámetros son opcionales (sus valores predeterminados, si no se especifican, son: (vacío)|(ruta del objeto)| normal|0). (Permite macros en ruta/nombre y el/los parámetros). Esta es una sinopsis de final de línea. "iniciaprogramacomo"|nombre de usuario|clave|nombre de sistema/dominio| ruta y nombre del ejecutable|[parámetro/s]|[carpeta de inicio]|[modo de ventana: "normal/oculto/minimizado/maximizado"]|[espera a que cierre: "0/1"] – Arranca un fichero ejecutable (.exe) bajo las condiciones indicadas en un sistema de la red local autentificándose bajo diferente identidad. La ruta al fichero debe indicarse siempre, salvo que se encuentre en la propia carpeta de Pramo. El último parámetro condiciona si Pramo esperará al cierre del programa para continuar el resto de sinopsis. Salvo el primero, todos los parámetros son opcionales (sus valores predeterminados, si no se especifican, son: (vacío)|(ruta del ejecutable)|normal|0). Notas: Si se emplea un usuario con permisos de administrador el servicio "Inicio de sesión secundario" deberá estar habilitado en el equipo/dominio destino. Si se indica una carpeta de inicio, el usuario con el que se valida ha de tener permisos de acceso o el programa no se ejecutará. El nombre de equipo/dominio no deberá contener las contrabarras (\\). Pramo no creará ni utilizará un perfil de usuario en el sistema donde se ejecute el proceso. (Permite macros en ruta/nombre y el/los parámetros). Esta es una sinopsis de final de línea. "cierraproceso"|nombre de ejecutable – Cierra el proceso indicado. "esperaalproceso"|nombre del proceso – Aguarda un máximo de 60 segundos hasta que el proceso indicado esté en funcionamiento. "procesoprioridad"|nombre del proceso|"0/1/2/3/4/5" – Altera la prioridad de ejecución de un proceso ya iniciado; a más alto el número, mayor será la prioridad. El valor estándar de prioridad normal es 2. El valor 0 deja al proceso inactivo. Notas: Se recomienda usar con precaución el valor 5, puede provocar un acaparamiento de recursos tal que bloquee el ordenador.

PRAMO

: ANEXO - VOCABULARIO | 9

gatilidades | GATILIDADES.BLOGSPOT.COM

Sistema operativo · ·

"servicioestado"|nombre del servicio|"iniciar/detener" – Realiza una acción sobre el servicio de Windows indicado. "serviciotipodeinicio"|nombre del servicio|"desactivado/auto/manual/auto-

·

demorado/arranque/sistema" – Realiza una acción sobre la forma en que se inicia y opera el servicio de Windows indicado. Sus posibilidades son: "desactivado" que impide su inicio; "auto" que activa su arranque automáticamente al iniciar el sistema; "manual" que no habilita su arranque automático pero permite que pueda ser iniciado en cuanto sea necesario, si un programa u otro servicio lo requiere; "auto-demorado" que activa su arranque automáticamente tras un tiempo determinado al iniciar el sistema -de serie, ese tiempo es 2 minutos después de haber iniciado el último servicio configurado en automático-; "arranque" que activa su ejecución durante la fase inicial de arranque del sistema operativo como un controlador de dispositivo; "sistema" que activa su ejecución durante la fase de inicialización del núcleo del sistema operativo como un controlador de dispositivo. "modificaregistrodewindows" |nombre de clave|[nombre del valor|tipo de clave:

·

· · · ·

"cadena"/"binario"/"DWORD"/"QWORD"|valor] – Crea o modifica el nombre de clave del registro del sistema operativo y, opcionalmente, también un valor asociado a un tipo de clave. Todo nombre de clave debe comenzar con los valores: HKLM (o HKEY_LOCAL_MACHINE), HKU (o HKEY_USERS), HKCU (o HKEY_CURRENT_USER), HKCR (o HKEY_CLASSES_ROOT), HKCC (o HKEY_CURRENT_CONFIG). Notas: La equivalencia entre tipos de clave es autodescriptiva: cadena=REG_SZ, binario=REG_BINARY, DWORD=REG_DWORD, QWORD=REG_QWORD. La adición del número 64 a una cadena hará referencia a su homólogo de 64 bits (ej.: HKLM64). Ha de tenerse en cuenta la forma en que Windows opera en sistemas de 64 bits: Casi todas las cadenas "Software" de las ramas principales poseen una subsección llamada "Wow6432Node" y es aquí donde se aplicarán los cambios a "Software" si no se indica específicamente 64 bits, tanto en Pramo como cualquier otro programa. Esta es una sinopsis de fin de línea. "borraregistrodewindows" |nombre de clave|[nombre del valor] – Borra el nombre de clave del registro del sistema operativo y, opcionalmente, también un valor subordinado. Todo nombre de clave debe comenzar con los valores: HKLM (o HKEY_LOCAL_MACHINE), HKU (o HKEY_USERS), HKCU (o HKEY_CURRENT_USER), HKCR (o HKEY_CLASSES_ROOT), HKCC (o HKEY_CURRENT_CONFIG). Notas: La adición del número 64 a una cadena hará referencia a su homólogo de 64 bits (ej.: HKLM64). Ha de tenerse en cuenta la forma en que Windows opera en sistemas de 64 bits: Casi todas las cadenas "Software" de las ramas principales poseen una subsección llamada "Wow6432Node" y es aquí donde se aplicarán los cambios a "Software" si no se indica específicamente 64 bits, tanto en Pramo como cualquier otro programa. Esta es una sinopsis de fin de línea. "alportapapeles"|texto – Copia el texto indicado al portapapeles, sobreescribiendo el contenido que hubiera anteriormente. "vacíaportapapeles" – Vacía el portapapeles. "ASCII"### – Inserta el caracter ASCII indicado. Formato de tres caracteres. "Unicode"#### – Inserta el código Unicode indicado en hexadecimal, formato de cuatro caracteres (0x????).

PRAMO

: ANEXO - VOCABULARIO | 10

gatilidades | GATILIDADES.BLOGSPOT.COM

Sistema de ficheros · · ·

· · · ·

·

·

·

"borracarpeta"|ruta|borra el interior recursivamente: "0/1" – Borra la carpeta indicada. (Permite macros en la ruta) "borrafichero"|ruta y ejecutable – Borra el fichero indicado. (Permite comodines y macros en ruta/nombre) "copiafichero"|ruta y nombre de origen|ruta y nombre destino|sobreescribe

si existe: "0/1" – Copia un fichero de una ubicación a otra. (Permite comodines y macros en la ruta/nombre de origen y destino) "copiacarpeta"|ruta de origen|ruta destino|sobreescribe si existe: "0/1" – Copia una carpeta. (Permite macros en ruta/nombre de origen y destino) "creacarpeta"|ruta de la carpeta a crear – Crea la carpeta indicada. (Permite macros en la ruta) "muevecarpeta"|ruta de origen|ruta destino|sobreescribe si existe: "0/1" – También sirve para renombrar una carpeta. (Permite macros en ruta/nombre de origen y destino) "muevefichero"|ruta y nombre de origen|ruta y nombre destino|sobreescribe si existe: "0/1" – Mueve un fichero de una ubicación a otra. También sirve para renombrar un fichero. (Permite comodines y macros en la ruta/nombre de origen y destino) "cambiahoradefichero"|ruta y nombre de fichero| hh:mm:ss|"creado/modificado/accedido" – Cambia la hora, minuto y segundo de uno de los tres atributos de un fichero. Puede evitarse modificar cualquiera de los tres valores de tiempo si, en su lugar, se escribe un signo de igual (=); de otra forma, los tres valores deben tener dos cifras, siendo la hora en formato 00-24. (Permite macros en la ruta/nombre) "cambiafechadefichero"|ruta y nombre de fichero|dd-mmaaaa|"creado/modificado/accedido" – Cambia el día, mes y año de uno de los tres atributos de un fichero. Puede evitarse modificar cualquiera de los tres valores de tiempo si, en su lugar, se escribe un signo de igual (=). El año tiene un límite inicial que comienza en 1980. (Permite macros en la ruta/nombre) "cambiaatributosdefichero"|ruta y nombre de fichero|[+/-"sólolectura"] [+/-"oculto"]+/-"sistema"][+/-"archivo"] – Cambia los atributos del fichero indicado. Pueden concatenarse varios en el mismo parámetro. (Permite comodines y macros en la ruta/nombre)

PRAMO

: ANEXO - VOCABULARIO | 11

gatilidades | GATILIDADES.BLOGSPOT.COM

Ratón · · · · ·

"x&y"|#","# – Desplaza el cursor del ratón hasta la ubicación indicada según las coordenadas. Estas coordenadas deben estar dentro de las dimensiones (resolución) de la pantalla que se utilice o la sinopsis será ignorada. "clickx&y"|#","# – Realiza un click con el ratón en la ubicación indicada según las coordenadas. Estas coordenadas deben estar dentro de las dimensiones (resolución) de la pantalla que se utilice o la sinopsis será ignorada. "dobleclickx&y"|#","# – Realiza un doble click con el ratón en la ubicación indicada según las coordenadas. Estas coordenadas deben estar dentro de las dimensiones de la pantalla que se utilice o la sinopsis será ignorada. "ruedahaciaarriba"# – Desplaza la rueda del ratón hacia arriba el número de veces indicado. "ruedahaciaabajo"# – Desplaza la rueda del ratón hacia abajo el número de veces indicado.

Tiempo · · · · ·

#"miliseg" – Realiza una pausa durante tantos milisegundos como indique el número al inicio. #"segs" – Realiza una pausa durante tantos segundos como indique el número al inicio. #"mins" – Realiza una pausa durante tantos minutos como indique el número al inicio. "retraso"# – Hace que el programa se detenga el número de segundos indicado. "retrasovisual"# – Hace que el programa se detenga el número de segundos indicado y muestra una barra de progreso -centrada en medio de la pantalla- indicando el tiempo que queda hasta que acabe.

PRAMO

: ANEXO - VOCABULARIO | 12

gatilidades | GATILIDADES.BLOGSPOT.COM

Pramo ·

· ·

· · ·

·

"aleatorizasinopsisdelínea" – Desordena aleatoriamente todos los segmentos -separados por el símbolo de barra vertical ("|")- de la línea actual antes de proceder con ellos normalmente. Notas: Está de más decir que los segmentos no deben ser sinopsis con parámetros o estos quedarán también desordenados. Esta es una sinopsis de principio de línea. "aleatorizaconjunto"|@conjunto1/2/3/4/5/6/7/8/9 – Desordena aleatoriamente el contenido de un conjunto -@conjunto1 al @conjunto9- cuyo contenido haya sido previamente elegido/definido. "enviaconjuntoaprograma"|"@conjunto1/2/3/4/5/6/7/8/9"|número de elementos a enviar|retraso entre elementos|"@programa1/2/3/4/5/6/7/8/9" – Dado un conjunto de elementos previamente establecido y una variable @programa previamente establecida, envía un número determinado de elementos de ese conjunto como parámetro a tal programa, uno a uno, tantos como se indique e invocando el programa tantas veces como sea necesario, con un retraso -en segundos- entre cada uno de ellos. Una vez enviados, estos elementos serán vaciados del conjunto. Si se indica un valor 0 (cero) o vacío como número de elementos, enviará todos los que haya en el conjunto. "saltodelínea"|# – Deja de procesar la línea actual y cambia al número de línea indicado (del fichero de sinopsis). Notas: Téngase en cuenta que las líneas de comentario cuentan y no son omitidas para el conteo de líneas. "salir" – Termina la exploración del fichero de sinopsis acabando también la ejecución del actual proceso de Pramo. Antes, muestra un mensaje -posicionado a la izquierda de la pantalla y 3/4 de la vertical- durante 2 segundos indicando la salida. "pausa" – Pone la exploración del fichero en pausa y activa la tecla de pausa (para poderse reanudar) que se haya especificado previamente. Esta tecla sólo será efectiva para el primer fichero de sinopsis salvo que se establezca una diferente en cada uno — Esto ocurre porque no puede asignarse la misma tecla de pausa -y reanudar- a todos los ficheros de sinopsis por evidentes motivos. Si se indica esta acción justo después de realizar envíaconjuntoaprograma, Pramo mostrará un tooltip -descripción emergente- en pantalla, indicando el número de elementos a enviar y el total de elementos restantes en ese conjunto, además del nombre -sin extensión- del fichero de sinopsis actual. Esto ayuda a que puede enviarse una serie de tandas o lotes a un programa de forma mucho más gradual y personalizada. "accesodirectoalficheroactual"|nombre de fichero/"="|carpeta destino – Comprueba si existe un acceso directo en la carpeta destino indicada para arrancar Pramo con el actual fichero de sinopsis. Si no existe, lo crea; de otro modo no realiza cambio alguno. El acceso directo será generado con el nombre indicado; o, en caso de que se indique un signo de igual (=) en su lugar, el nombre que ya tuviera el fichero.

PRAMO

: ANEXO - VOCABULARIO | 13

gatilidades | GATILIDADES.BLOGSPOT.COM

|05. Macros · · · · · · · · · · · · · · · · · · · · ·

"@año" – Año actual (en el momento de la ejecución de la sinopsis). Resultado en número de 4 cifras. "@mes" – Mes actual (Ídem). Resultado en número de 2 cifras. "@día" – Día actual. Resultado en número de 2 cifras. "@hora" – Hora actual. Resultado en número de 2 cifras. "@minuto" – Minuto actual. Resultado en número de 2 cifras. "@segundos" – Segundos actuales. Resultado en número de 2 cifras. "@milisegundos" – Milisegundos actuales. Resultado en número de 2 cifras. "@azar" – Un número generado al azar. Resultado en número de 2 cifras. "@rutadePramo" – Ruta hasta la carpeta de Pramo. "@rutadeWindows" – Ruta hasta la carpeta de Windows. (ej.: c:\Windows) "@rutadeSistema32bits" – Ruta hasta la carpeta de sistema en Windows 32bits. (ej.: c:\Windows\System o c:\Windows\System32) o la carpeta de compatibilidad si es un sistema operativo de 64bits (c:\Windows\SysWOW64). "@rutadeSistema64bits" – Ruta hasta la carpeta de sistema en Windows 64bits. (ej.: c:\Windows\System32). "@unidaddeWindows" – Unidad de Windows. (ej.: c:) "@rutadeTemporales" – Ruta hasta la carpeta de temporales de Windows. "@rutadelEscritorio" – Ruta hasta la carpeta de Escritorio del usuario actual. "@rutadeMisDocumentos" – Ruta hasta la carpeta de Mis Documentos del usuario actual. "@rutadeFavoritos" – Ruta hasta la carpeta de Favoritos del usuario actual. "@rutadePerfildeUsuario" – Ruta hasta la carpeta de perfil del usuario actual. (ej.: c:\Users\Garriot) "@rutadeAutoArranque" – Ruta hasta la carpeta de autoarranque de Windows para todos los usuarios. "@rutadeAutoArranqueUsuario" – Ruta hasta la carpeta de autoarranque de Windows para el usuario actual. "@NombredeUsuario" – Nombre del usuario de la cuenta de Windows actualmente en funcionamiento.

PRAMO

: ANEXO - VOCABULARIO | 14

gatilidades | GATILIDADES.BLOGSPOT.COM

|06. Definiciones y configuraciones A continuación se muestran varios ajustes especiales y globales que no cuentan específicamente como acciones o condiciones. Para que tengan efecto han de incluirse al comienzo del fichero de sinopsis o directamente antes de las acciones/condiciones a las que pueden afectar. De cualquier modo, su aparición en un fichero de sinopsis no se limita en número, por lo que pueden añadirse tantas veces como se considere necesario — entendiendo que cada entrada sólo afectará a las sinopsis sucesivas.

·

·

·

·

· ·

"Tecla de pausa"|"PAUSA/BLOQUEO DE DESPLAZAMIENTO/BLOQUEO NUMÉRICO/1/2/3/0" – Establece una tecla que, de ser presionada durante la ejecución del fichero de sinopsis en el que se incluya, realizará una pausa en su procesado. Esta tecla actuará como conmutador: Pramo se detendrá o proseguirá con cada pulsación. (1/2/3 sirven de alternativa breve a las teclas indicadas, en el mismo orden). Si el parámetro es 0 (cero) se desactivará la función de pausa por teclado. "Tecla de salida"|Tecla o combinación/"0" – Establece una tecla que, de ser presionada durante la ejecución del fichero de sinopsis en el que se incluya, realizará una salida inmediata de Pramo, dejando de interpretar el fichero actual. Si el parámetro es 0 (cero) se desactivará la función de salida por teclado. "Velocidad de movimiento del ratón"|"0..100" – Establece un valor global para todas las acciones pertinentes al ratón de manera que el desplazamiento sea a aque ealiza un pitido al acabar el fichero de sinopsis que se esté ejecutando. Un valor de 0 (cero) indicará un desplazamiento instantáneo. Esta configuración sólo afecta al entorno de Pramo, no modifica el ajuste del ratón de Windows en ningún momento. "Esperar al cierre tras los inicios de programas y objetos"|"Sí/No/1/0" – Pramo establece, al iniciar programas y objetos -para el resto del fichero de sinopsis-, un modo de arranque por el que no hace pausa tras cada ejecución. Notas: La sinopsis de iniciar un programa/objeto tiene un parámetro específico para esto, pero con esta definición puede evitarse tener que activar por cada ejecución que Pramo espere a que el programa/objeto ejecutado acabe o no. Independientemente de lo que se indique con esta definición global, siempre quedará supeditada al parámetro específico de la sinopsis. "Permitir un pitido al acabar"|"Sí/No/1/0" – Realiza un pitido al acabar el fichero de sinopsis que se esté ejecutando. "Icono de Pramo"|fichero de librería/número de icono/|[número de icono] – Establece un icono -que podrá verse en la bandeja de sistema de Windows- para el fichero de sinopsis cuando Pramo lo ejecute. De forma predeterminada, el icono puede elegirse de entre los disponibles en el fichero shell32.dll de Windows, pero puede indicarse un fichero de librería de iconos alternativo o incluso un ejecutable. (El número de icono de cualquier librería puede averiguarse/confirmarse mediante utilidades como IconsExtract, de Nir Sofer.) Esta sinopsis tiene dos parámetros, que pueden ser ambos o excluyentes, esto significa: puede indicarse sólo el número de icono (se establecerá shell32.dll como librería); puede indicarse sólo el fichero de librería (se establecerá automáticamente el primer icono); puede indicarse tanto el fichero de iconos como el número de icono. Notas: El usuario podrá elegir el número de icono que prefiera, cualquiera que sea. De estar mal elegido podrá provocar problemas, tal como ser invisible. Se ruega sentido común en este aspecto. Algunas librerías necesitarán que el valor sea negativo y así habrá de indicarse (ej.: -125). Si el primer parámetro es 0 (cero) o PRAMO

: ANEXO - VOCABULARIO | 15

gatilidades | GATILIDADES.BLOGSPOT.COM

· · ·

·

·

nulo el icono de Pramo quedará oculto, por lo que previamente deberán tomarse las medidas oportunas si se quiere cerrar o pausar la ejecución. (Permite macros en la ruta del fichero). Esta es una sinopsis de final de línea. "Texto en icono de Pramo"|texto – Reemplaza parte del texto del icono de Pramo con un texto personalizado. "Volumen de Pramo"|"0..100" – Cambia el volumen de sonido asignado a Pramo en Windows Vista y superiores o al volumen del canal onda/wave en Windows anteriores. El valor indicado como parámetro se tomará como un porcentaje. "Solicita elevación de permisos" – Inicia una petición de consentimiento al usuario para que el programa pueda realizar operaciones que requieran acceso administrativo. Si Pramo detecta que ya tiene plenos permisos de administración ignorará esta petición y continuará normalmente; De otro modo, el UAC (Control de Cuentas de Usuario) de Windows mostrará una ventana y Pramo se detendrá hasta que el usuario decida qué hacer. Notas: Sólo para Windows Vista y superiores. Esta es una sinopsis de final de línea. "Carga fichero de Sinopsis"|ruta y nombre de fichero de sinopsis|["0/1/2"] ["cierra/mantiene/espera"] – Termina la ejecución del actual fichero de sinopsis e inicia el indicado desde el principio. El último parámetro es opcional; si se añade con valor 1 o mantiene -el valor predeterminado- el nuevo fichero de sinopsis no reemplazará al actual, sino que se ejecutará otra instancia de Pramo, prosiguiendo la actual inmediatamente. Un valor 2 o mantiene ejecutará la nueva sinopsis sin reemplazar la actual y esperando a que termine antes de continuar. El valor cierra (o el 0) cargará la nueva sinopsis como si se rearrancase Pramo. Notas: la ruta a indicar -si hiciera falta- debe ser (tal como se indicó en las Anotaciones) o absoluta o relativa a Pramo, no a la sinopsis desde la que se invoca. Esta es una sinopsis de final de línea. "Activa log" – Activa el fichero de informe y diagnóstico Pramo.log y asociados. Para más información véase la sección 9 (Línea de comandos) de este documento.

PRAMO

: ANEXO - VOCABULARIO | 16

gatilidades | GATILIDADES.BLOGSPOT.COM

|07. Variables y Conjuntos Pramo puede emplear una serie de variables para facilitar su uso automatizado de diferentes formas. Tanto las variables como los conjuntos son equivalentes en cuanto a su método pero no su aplicación y ambos tienen un formato similar a las macros, salvo que no son constantes fijas. Veamos cuáles son y sus características:

·

·

"@programa1/2/3/4/5/6/7/8/9"|ruta y nombre de ejecutable – Se trata de 9 variables (@programa1 a @programa9) que pueden emplearse para definir la ruta completa de un fichero ejecutable. Estas variables podrán usarse posteriomente en acciones específicas o como parámetro multiusos. (Permite comodines y macros en ruta/nombre). "@conjunto1/2/3/4/5/6/7/8/9"|xx[|xx|..|xx] – Se trata de 9 variables (@conjunto1 a @conjunto9) que pueden emplearse para definir tantos grupos de caracteres, palabras o cadenas de texto como se quiera — separados entre sí, como es costumbre, con la barra vertical “|”. Un conjunto puede actualizarse -sin borrar el contenido anterior- con más cadenas de texto. También se puede vaciar su contenido dejando el primer parámetro vacío. Notas: El número de caracteres por conjunto es, en práctica, ilimitado: algo más de 2.147 millardos. El número de segmentos tampoco afecta a esta limitación. Esta es una sinopsis de final de línea.

PRAMO

: ANEXO - VOCABULARIO | 17

gatilidades | GATILIDADES.BLOGSPOT.COM

|08. Teclas y combinaciones Cuando Pramo procesa ficheros de sinopsis interpreta que cada segmento separado por barras verticales ("|") puede ser, según orden de prioridad, uno de los siguientes: una definición o configuración, una condición o acción, una combinación de teclas, una pulsación de tecla especial o, finalmente, texto que se desea enviar tal cual a la ventana en foco. Conocer este orden de prioridad es importante para evitar que haya colisiones en cuanto al contenido de lo que se acciona, pulsa o envía, aunque Pramo está programado para ser resistente a este tipo de ambigüedades. Así pues, Pramo puede ejecutar pulsaciones -a conveniencia: juntas o separadas por barras verticalesde diferentes teclas que pueden encontrarse en un teclado estándar, tales como:

· · · ·

·

el teclado alfanumérico: [MÁSNUMÉRICO], [MENOSNUMÉRICO], [ASTERISCONUMÉRICO], [DIVISORNUMÉRICO], [BLOQUEAR-TNUM]. teclas en la zona del cursor: [FLECHA-ARRIBA], [FLECHA-ABAJO], [FLECHA-IZQUIERDA], [FLECHA-DERECHA], [INSERTAR], [SUPRIMIR], [INICIO], [FIN], [PÁGINAARRIBA], [PÁGINA-ABAJO]. teclas de función: [F1] a [F12]. teclas especiales: [ESPACIO], [BARRAVERTICAL], [ESC], [TAB], [INTRO], [WINDOWS], [BLOQUEARMAYS], [WINIZQ], [WINDER], [ALTIZQ], [ALTDER], [CTRLIZQ], [CTRLDER], [MAYSIZQ], [MAYSDER], [IMPRIMIRPANTALLA], [BLOQUEARDESPL], [PAUSA]. combinaciones junto a las teclas control, alternar y mayúsculas; siendo cada una de ellas: [CTRL], [ALT], [MAYS].

PRAMO

: ANEXO - VOCABULARIO | 18

gatilidades | GATILIDADES.BLOGSPOT.COM

|09. Línea de comandos Pramo posee una breve pero práctica selección de parámetros para la línea de comandos. Estos son:

·

"-log" – El funcionamiento de Pramo puede diagnosticarse mediante el parámetro "-log" (sin comillas). Si se añade como segundo parámetro (siendo el primero el nombre de un fichero de sinopsis), Pramo activará un informe interno y volcará esa información generando un fichero llamado Pramo.log en su propia carpeta, que contendrá todos los pormenores. Puede enviar este fichero al autor en caso de problemas no documentados, indicando con precisión cuál es la intención del fichero de sinopsis y el resultado esperado.

Para potenciar la versatilidad de Pramo, se le ha diseñado una serie de sinopsis externas en forma de parámetros. Con ellas, el programa puede invocarse a sí mismo -de igual modo que a cualquier otro programa- de manera que permiten otras funcionalidades para no depender de las limitaciones de un sistema de automatización con un solo hilo de ejecución/proceso. Estas son:

·

·

"-mensaje" título contenido [segundos] ["-sinborde"] ["-solobandeja"] ["desubicado] [-icono#] – Esta acción muestra una ventana que incluye el mensaje y características especificadas. Si título o contenido poseen espacios, el texto deberá incluirse entre comillas. Segundos ha de ser un número que indicará el retraso que Pramo esperará antes de cerrarse. -sinborde y -solobandeja son parámetros excluyentes puesto que uno modifica la ventana para que no muestre borde, y el otro evita que se muestre ventana, informando sólo en el icono de la bandeja de sistema. Desubicado moverá el mensaje a una posición al azar. Pramo se ejecutará, mostrará el mensaje y se cerrará cuando acabe el número de segundos indicado; alternativamente, tras un segundo. Por último, icono modifica el icono de Pramo en la bandeja de sistema reemplazándolo por el número indicado de entre los disponibles en el fichero shell32.dll de Windows, utilizando su mismo orden. (De nuevo, el número de icono de cualquier librería puede averiguarse/confirmarse mediante utilidades como IconsExtract, de Nir Sofer.) "-mensajeconfirmar" título contenido [segundos] [-icono#] – Esta acción muestra una ventana tipo caja de mensajes (message box) con botón de cierre, que incluye el mensaje y características especificadas. Si título o contenido poseen espacios o caracteres especiales, el texto deberá incluirse entre comillas. Segundos ha de ser un número que indicará el retraso que Pramo esperará antes de cerrarse. Pramo se ejecutará, mostrará el mensaje y se cerrará cuando acabe el número de segundos indicado; alternativamente, esperará a que el usuario pulse el botón de OK/Aceptar. Por último, icono modifica el icono de Pramo en la bandeja de sistema reemplazándolo por el número indicado de entre los disponibles en el fichero shell32.dll de Windows, utilizando su mismo orden. (De nuevo, el número de icono de cualquier librería puede averiguarse/confirmarse mediante utilidades como IconsExtract, de Nir Sofer.)

|Nota: Estos parámetros no pueden ser combinados o añadidos junto a rutas de ficheros de sinopsis. Si se quiere diagnosticar la línea de comandos "-log" debe añadirse como uno de los parámetros opcionales.

PRAMO

: ANEXO - VOCABULARIO | 19