7. Parámetros de inicio
- Andy Erd
Para iniciar eSignatureOffice desde otra aplicación debe llamar al archivo «SOSigOffice.exe». Puede transferir diferentes parámetros a este archivo cuando lo llame, el orden de los parámetros no importa.
Si no sabe en qué directorio se encuentra eSignatureOffice, puede encontrar la ubicación de guardado con la siguiente entrada del registro:
HKEY_LOKAL_MACHINE\SOFTWARE\STEPOVER\ESIGNATUREOFFICE X.XX\PATH (under 64Bit: HKEY_LOKAL_MACHINE\SOFTWARE\Wow6432Node\STEPOVER\ESIGNATUREOFFICE X.XX\PATH )
Pantalla y diseño
| Parámetro | Valores | Info |
|---|---|---|
-left=<integer_value> | integer | Si no inicia eSignatureOffice en modo de pantalla completa, aquí puede definir las coordenadas x para determinar la posición preferida de eSignatureOffice cuando se ejecuta. |
-top=<integer_value> | integer | Si no inicia eSignatureOffice en modo de pantalla completa, aquí puede definir las coordenadas y para determinar la posición preferida de eSignatureOffice cuando se ejecute. |
| -width=<integer_value> | integer | Si no inicia eSignatureOffice en modo de pantalla completa, aquí puede definir la anchura para determinar la posición preferida de eSignatureOffice cuando se ejecute. |
-height=<integer_value> | integer | Si no inicia eSignatureOffice en modo de pantalla completa, aquí puede definir la altura para determinar la posición preferida de eSignatureOffice cuando se ejecute. |
-gm0 -gm1 -gm2 -gm3 -gm4 | Permite utilizar el diseño de ventana «antiguo», necesario para algunos de los parámetros de visualización y diseño. "-gm0" = tradicional "-gm1" = tradicional minimalista "-gm2" = clásico "-gm3" = clásico reducido "-gm4" = New GUI (Eso V5.x) | |
-hideframe | El marco de la ventana se ocultará. (sólo funciona con OLD GUI, ver -gm0) | |
-hidestartwin | Al abrir una aplicación -ya sea manualmente, transfiriéndola a través del convertidor de PDF o iniciando eSignatureOffice a través del parámetro «eSOSigOffice.exe» desde otra aplicación- aparecerá durante un breve espacio de tiempo una ventana que indica al usuario que eSignatureOffice ha comenzado a ejecutarse. Puede ocultar la ventana de inicio mediante el comando «-hidestartwin». | |
| -hidesignbtn | El botón «Modo Firma» no aparecerá. | |
| -hidesupportbtn | El botón «Soporte» del formulario de información no aparecerá. | |
| -support | El formulario de soporte se muestra justo después de iniciar y cargar los documentos de la línea de comandos (para «Correo a Soporte») | |
-hidesofcname -hsn | oculta el título de la eSignatureOffice | |
deactivateXXXX -deactivateXXXX deactivate=XXXX -deactivate=XXXX | Esta opción sólo tiene efectos sobre el «antiguo» diseño de ventana, es decir, si se ha desactivado el «nuevo diseño de ventana». Los distintos menús pueden desactivarse mediante «desactivarXXXX», es decir, se ocultarán. De este modo, determinadas funciones pueden quedar inaccesibles para el usuario. Las cuatro «x» después de la palabra «desactivar» significan en esta secuencia:
| |
-zoom= | integer/string | Con este parámetro puede especificar el zoom del documento al iniciar el programa. "10" ... "300" = Porcentaje de zoom "fit" or "f" or "0" = que significa ajustar a la pantalla o |
| -zoomaftersign= | integer/string | Con este parámetro puede especificar el zoom del documento después de firmar (incluso al cancelar) "10" ... "300" = Porcentaje de zoom "fit" or "f" or "0" = que significa ajustar a la pantalla o 'k' o 'keep' o Cadena vacía cuando no debe producirse ningún cambio - se utiliza el zoom antes de iniciar la firma |
| -zoomlcd= | Integer | Define el valor del zoom en el Dispositivo (Color) cuando la vista del documento está activada al inicio. Valor en el rango 0..2, 0 = Ajustar al ancho 1 = Ajustar a LCD (página completa) 2 = Zoom máximo posible en el dispositivo |
| -minimize | iniciar la aplicación minimizada | |
| -maximize | iniciar la aplicación maximizada | |
| -monitor=<MonitorIndex> | Integer | El parámetro permite establecer en qué monitor debe colocarse la aplicación |
| -editcorners | vuelve a activar el cuadro de diálogo para predefinir y editar patrones de esquina. Si en SSS se ha definido previamente un patrón de esquinas, esta función se utilizará siempre en la búsqueda de los bordes del campo de firma. | |
-hidesssfiles | no es posible seleccionar archivos SSS en la nueva interfaz gráfica de usuario | |
| -hidesssmenu | no Toolbox-Menú para la creación/cambio/dirección de archivos SSS | |
| -hidesss | oculta la selección de archivos SSS y el Menú para SSS | |
| -mds | activa el botón para la búsqueda manual de dispositivos dentro de la administración. Este botón sólo es necesario si utiliza un dispositivo com muy antiguo. | |
| -nocentersign | en modo firma, al desplazarse dentro del documento, el rectángulo del campo de firma se centra si se agota el tiempo de espera o el usuario comienza a firmar. Este comportamiento no es deseado cuando se utilizan MsInkPads o Tablets. Con este parámetro se prohíbe el centrado si el rectángulo de la firma es completamente visible en el monitor. | |
| -noscrollsign | Desactivar el desplazamiento en eSignatureOffice durante el modo de firma | |
| -overlapped | Parámetro para SecureSign cuando se utiliza con la función SigFile. En este modo, la función sigFile finaliza inmediatamente después de la llamada, mientras que eSignatureOffice sigue ejecutándose en segundo plano. La aplicación que realiza la llamada debe cumplir unos requisitos especiales; consulte la documentación de SecureSign. | |
| -chkresize | Parámetro para SeucreSign cuando se utiliza con la función SigFile. Cuando se utiliza con superposición, la comprobación del tamaño de la ventana no está activada, lo que puede causar problemas. | |
| -setfocus | Forzar el enfoque de eSignatureOffice al inicio |
Comportamiento o ajustes básicos
| Parámetro | Valores | Info |
|---|---|---|
| -lang=<Ing> | D,GB, ES, NL, PL, F, IT, US | Este comando permite configurar automáticamente el idioma de eSignatureOffice. |
savedoc -savedoc | El parámetro SaveDoc llega a eSignatureOffice, por ejemplo, a través del StepOver PDF Converter. eSignatureOffice asume entonces que el archivo PDF abierto es un archivo temporal y, en consecuencia, preguntará al cerrar la aplicación si se debe guardar el archivo, aunque no se haya modificado. Al hacer clic una vez en el botón «Guardar» aparecerá en este caso el «Guardar como ...» Diálogo. | |
| -sofcrenameto=<file_name> | Este comando es relevante si un documento firmado debe guardarse automáticamente con un botón de macro. Esto puede hacerse activando un botón de macro visible o a través de un botón invisible que se activará automáticamente mediante una firma establecida después de firmar. Con la ayuda de este comando puede cambiar ahora el nombre de archivo en el que debe guardarse el documento firmado. El parámetro cambia entonces el nombre de archivo del original o, si es necesario, el nombre que se indicó durante la configuración del botón de macro en «después de copiar cambiar nombre de archivo a ». | |
| -stayontop | Si eSignatureOffice está siempre en primer plano mientras se ejecuta el programa, puede acceder a esta función mediante el parámetro «-stayontop». De este modo, otras aplicaciones que se estén abriendo permanecerán siempre en segundo plano. eSignatureOffice ahora sólo puede minimizarse haciendo clic en «Minimizar» en el cuadro situado en la parte superior derecha. | |
-scs=<file> *.scs (Configuration-Set-File) | ruta local o url | Un archivo de conjunto de configuración de StepOver (*.scs) es aquel que puede contener todos los ajustes de eSignatureOffice, p. ej. ajustes para botones de macro, derechos de usuario, o para seguridad y gestión de claves, etc. Consulte el capítulo «Administración de eSignatureOffice» Ajustes de exportación Un archivo *.scs entregado como parámetro de inicio se importará inmediatamente al usuario sin una consulta, a diferencia del comando [Opciones |Importar]. Es posible proporcionar una versión SCS múltiple como parámetro de inicio, en ese caso el número de versión debe añadirse como:
|
| -multi | Utilizando este parámetro, es posible iniciar varias instancias de eSignatureOffice a la vez. | |
| -nodrawdata | Garantiza que no se guarde información por encima de los caracteres de firma en el PDF, reduciendo así el tamaño del archivo. | |
| -nobiodata | Garantiza que no se guarden datos biométricos en la firma del documento PDF o TIFF. Dentro del documento, sólo se guarda la imagen de la firma. Esto también reduce ligeramente el tamaño del archivo después de la firma. El comando «nobiodata» contiene nodrawdata. | |
| -pdfnobiodata= | local path | guarda la versión sin biodatos del PDF en el archivo local. Este archivo no se borra al finalizar la aplicación. |
| -df= | integer | Este comando también se utiliza para reducir el tamaño del archivo; para ello, se ignora cada N puntos de medición de la firma. Con la indicación «-df=5», no se registra uno de cada cinco puntos de la imagen de la firma. Con la indicación «-df=2», por ejemplo, sólo se analizaría la mitad de todos los puntos de medición. |
| -page=<pagenumber> | integer | Este comando permite indicar la página que debe mostrarse en el PDF abierto. |
| -printonly | El cuadro de diálogo de impresión se abre inmediatamente después de iniciar eSignatureOffice. | |
| -dkf= | String | Este comando permite establecer el tipo de pad que se va a utilizar. Actualmente son posibles las dos indicaciones «-dkf=naturaSignPad» o «-dkf=nsp». Con ellas se puede limitar el uso del naturaSign Pad. |
| -nodocumentview | impide que la Tableta de firma muestre el documento | |
| -allowskipandabortlastsig | activa el salto y aborta en la última firma | |
| -epc | Activar la casilla Pad Open | |
| -brightness= | integer | ajustar el brillo del pad (0-100) p.e. «-brightness=40» |
| -rotate | Gira todas las páginas del documento PDF 90 grados a la derecha. Tenga en cuenta que este parámetro se ignorará si ya hay firmas digitales en el documento. De lo contrario, estas firmas quedarían invalidadas debido al cambio en la estructura del PDF. | |
| -rotate=<Degree> | integer | girar todas las páginas en el sentido de las agujas del reloj en el documento PDF por <Degree> puede ser 90,180 o 270 «-rotate=90» es lo mismo que “-rotate”. Tenga en cuenta que este parámetro se ignorará si ya hay firmas digitales en el documento. De lo contrario, estas firmas quedarían invalidadas debido al cambio en la estructura del PDF. |
-PadRotateStart=<orientation value> | integer from 0 to 5 | Gira la vista en la tableta de firma conectada y seleccionada en cuanto se inicia el programa. Los valores de orientación definen la dirección. Sin cambios = 0 Horizontal = 1 (es la orientación por defecto) Horizontal (vista izquierda) = 2 Retrato (vista vertical) = 3 Vertical (zurdo) = 4 Por favor, tenga en cuenta que esto sólo funciona para dispositivos ya configurados (por lo que normalmente NO funciona para el primer inicio con una tableta de firma recién conectada). |
-PadRotateEnd=<orientation value> | integer from 0 to 5 | Gira la vista en la tableta de firma conectada y seleccionada en cuanto se cierra el programa. Los valores de orientación definen la dirección. Sin cambios = 0 Horizontal = 1 (es la orientación por defecto) Horizontal (vista izquierda) = 2 Retrato (vista vertical) = 3 Retrato (zurdo) = 4 Ajustar al valor inicial = 5 (esto ajustará la Tableta de firma a la orientación que tenía cuando se inició el programa) Por favor, tenga en cuenta que esto sólo puede funcionar correctamente, si el programa se termina correctamente. |
Certificado de dispositivo personalizado (CDC)
| Parámetro | Valores | Info |
|---|---|---|
| -cdc= | local path or url | Nombre de archivo del certificado que se utilizará como CDC |
| -cdcpw= | string | Contraseña utilizada para acceder al Certificado(s) en el archivo, omitir si no se utiliza. |
| -cdcpubka= | string | Definición de alias de clave pública (si hay más de un certificado en el archivo), omitir si no se utiliza |
| -cdcprivka= | string | Definition of Private Key Alias (if more than one certificates in file), omit if not used |
Workflow Integration
| Parameter | Values | Info |
|---|---|---|
-fff=<file> *.fff (Form Field Filler File) | local path or url | Dicho archivo contiene los nombres de los campos de formulario de un archivo PDF que deben rellenarse, así como su valor o texto. Al iniciarse, eSignatureOffice rellena automáticamente los campos de formulario del PDF y muestra el archivo PDF rellenado. La especificación de un archivo *.fff sólo tiene sentido en relación con la especificación del archivo PDF correspondiente. Este archivo *.fff se construye como un archivo INI y consta de nombre de campo = contenido de campo, la "cabecera" se denomina campos Puede obtener más información sobre el archivo FFF aquí. |
-sss=<file> *.sss (StepOver Signature Set File) | local path or url | Si se transfiere un conjunto de firmas StepOver, éste se activa en cuanto el usuario cambia al modo de firma. Esto significa que el usuario puede consultar el documento tranquilamente y empezar a firmar en cuanto pase al modo de firma. Puede obtener más información sobre el archivo SSS aquí. |
-ret=<file> *.ret (return file) | local path | (sólo en relación con la especificación de un archivo de conjunto de firmas) Si desea saber qué campos de firma ha rellenado el usuario, o si ha cancelado el proceso de firma, puede especificar la ruta a un archivo *.ret como parámetro adicional. Éste es creado de nuevo por eSignatureOffice . eSignatureOffice introduce aquí qué campos de firma se han firmado. Un archivo *.ret se construye como un archivo INI. Puede obtener más información sobre el archivo RET aquí. |
-autostartsig | (sólo en relación con la especificación de un archivo de conjunto de firmas). Si desea que el usuario acceda automáticamente al modo de firma tras iniciar eSignatureOffice y pueda empezar a firmar de inmediato, debe proporcionar el parámetro adicional "autostartsig". No utilización del grupo de firma | |
| -autostartsig= | group name | (sólo en relación con la especificación de un archivo de conjunto de firmas). Si desea que el usuario acceda automáticamente al modo de firma tras iniciar eSignatureOffice y pueda empezar a firmar de inmediato, debe proporcionar el parámetro adicional "autostartsig". Se utiliza el grupo de firma con el nombre "nombre del grupo", si hay espacios en blanco en el nombre, rodear con comillas dobles f.e. -autostartsig="Group Name" |
-autostartpdf | Si desea que el usuario acceda automáticamente al modo de formulario PDF tras iniciar eSignatureOffice y, de este modo, pueda empezar a rellenar los campos del formulario inmediatamente, debe proporcionar el parámetro adicional "autostartpdf". El parámetro "autostartpdf" desactiva algunos botones como Viewmode y Administration. | |
| -autostartformfill | sólo activa el modo de rellenado de formularios, sin desactivar otras funcionalidades (salvo el parámetro "autostartpdf") | |
| -autostartmacroX | inicio automático de macro (ejemplo -autostartmacro1 .... -autostartmacro10) | |
| -autosave | Se guarda automáticamente al cerrar el documento. | |
-pdf=<file> (PDF File) | local path or url | El archivo PDF entregado como parámetro de inicio se mostrará inmediatamente después del inicio en eSignatureOffice. |
-xml=<file> -exml=<file> *.xml (XMLFile) | local path or url | El archivo XML entregado como parámetro inicial mostrará el PDF que contiene inmediatamente después de iniciarse en eSignatureOffice. Puede obtener más información sobre el archivo RET aquí. |
-zip=<file> *.zip | local path or url | archivo comprimido |
| -password=<password> | Si el acceso a eSignatureOffice ("característica de seguridad" opcional) está protegido por contraseña, ésta puede entregarse en el marco de un procedimiento de firma automatizado con una línea de comandos. | |
-varN= (N is a integer value) | string | Este parámetro le permite introducir variables en eSignatureOffice que pueden utilizarse para la funcionalidad Macro o el Sello. Puede encontrar más detalles aquí. |
| -addsearchhistory | el historial de búsqueda se añade al RET file y/o a XML Output | |
| -mds | reactivar el botón de búsqueda manual de dispositivos en la pestaña Administración / General | |
| -bfcadddoc | Este parámetro activará el procesamiento de los documentos ya existentes en su carpeta watchdog tras el inicio de eSignatureOffice. Por defecto, los documentos existentes se ignorarán y sólo se procesarán los documentos que se añadan durante el tiempo de ejecución. |
Selección automática de ficheros SSS
Véase también el uso de la selección automática de expedientes SSS
| Parámetro | Valores | Info |
|---|---|---|
| -asssfile= | 0,1,2 | controla el comportamiento de la selección automática de archivos. 0 = Desactivado 1 = Preguntar al usuario 2 = Seleccionar siempre |
| -asssselect= | 0,1 | controla el uso de los archivos SSS encontrados para el documento 0 = utilizar siempre el primer documento 1 = Preguntar al usuario si se encuentra más de un archivo SSS |
Campos DigSig
Véase también el uso de campos DigSig automático
| Parameter | Values | Info |
|---|---|---|
| -autodigsig= | 0,1,2 | controla el comportamiento del uso automático del campo DigSig. 0 = Desactivado 1 = Preguntar al usuario 2 = Utilizar siempre |
| -adsdefault= | local SSS-file | Configuración por defecto del archivo SSS |
| -adspreview= | 0,1 | controla la posibilidad de hacer clic en los campos digsig en la vista previa del documento 0 = No se puede hacer clic 1 = Sí, se puede hacer clic en un campo digsig en la vista previa y se activa la firma del campo DigSig correspondiente |
| -adspdf= | 0,1 | controla la posibilidad de hacer clic en los campos digsig del área de visualización del documento 0 = No se puede hacer clic 1 = Sí, puede hacer clic en un campo digsig en la vista del documento y se activará la firma del campo DigSig correspondiente |
| -adssignature= | 0,1 | controla la posibilidad de hacer doble clic en los campos digsig del panel de firma 0 = No se puede hacer doble clic 1 = Sí, se puede hacer doble clic en un campo digsig del panel de firmas y se activa la firma del campo DigSig correspondiente |
| -adsclick= | 0,1 | controla la posibilidad de hacer (doble) clic en los campos digsig del panel de firma, el área de visualización y la vista previa 0 = No se puede hacer (doble) clic 1 = Sí, puede hacer (doble) clic en un campo digsig en la vista del documento, la vista previa y el panel de firmas y se activará la firma del campo DigSig correspondiente. |
| -sssmanual | 0,1,2 | controla el clic directo en un campo digsig dentro de la vista previa/documento 0 = no firmar 1 = preguntar al usuario 2 = firmar siempre |
Explicación
El uso de mayúsculas o minúsculas, así como la secuencia en la que entregue los parámetros no es importante. eSignatureOffice los asignará en consecuencia. Algunas funciones/configuraciones de los parámetros de inicio explicados también pueden encontrarse en Administración (o Startmanager.exe). Sin embargo, es esencial trabajar con parámetros de inicio si eSignatureOffice se inicia desde distintas aplicaciones y debe mostrar distintas funciones.
Ejemplos
Es aconsejable entregar los parámetros de inicio individuales entre comillas, ya que las indicaciones de ruta también pueden contener espacios.
C:\Program Files (x86)\StepOver\eSignatureOffice 5.0\SOSigOffice.exe "SaveDoc" "C:\Config.scs" "C:\My Testfiles\Test.pdf" "C:\Signaturset.sss" "C:\Form.fff" "C:\My Testfiles\Return.ret" "-autostartsig" "deactivate0110" "-page=3" C:\Program Files (x86)\StepOver\eSignatureOffice 5.0\SOSigOffice.exe "C:\My Testfiles\Test.pdf" "C:\Signaturset.sss"