7. Parámetros de inicio

7. Parámetros de inicio

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

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:
1. El menú principal situado en la parte superior de la ventana
2. El banner con el logotipo debajo del menú de archivos
3. La barra de herramientas con los botones de zoom debajo del banner del logotipo
4. La barra de menú de la derecha con los botones de los distintos modos (modo firma, etc.)


Para desactivar uno de los menús mencionados, coloque un 1 en la posición correspondiente para que aparezca un 0. El comando Desactivar1001 desactiva el menú principal y el botón de la derecha en eSignatureOffice.
Desactivar1111 desactiva las cuatro barras de menú. Las barras de menú desactivadas también se ocultarán. Si se desactiva la barra de menú de la derecha, los botones necesarios para firmar se mostrarán debajo del documento. Si utiliza el comando Desactivar1111, sólo aparecerá en una ventana en la pantalla el documento visualizado, así como los botones «Modo de firma», «Aceptar», «Cancelar» y «Repetir», o en caso necesario «Saltar» y «Atrás». A pesar de ello, podrá utilizar todas las funciones, como los conjuntos de firmas y los botones de macro activados por conjuntos de firmas.

-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
"width" or "w" = que significa ajustar al ancho de la página..

-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
"width" or "w" = que significa ajustar al ancho de la página..

'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:

 -scs="122|C:\config.scs" "135|C:\config.scs" "139|C:\config.scs" -scs="C:\config.scs"

  • En caso de que el número de versión sea superior al de la instalación real, se ignorará el SCS.

  • Si hay más de 1 SCS posible, se utilizará la versión admitida más alta.

  • En caso de que la versión de eSignatureOffice sea anterior a agosto de 2017 (eSignatureOffice 5.4), se ignorará la versión específica del SCS (no se admite el traspaso de versiones específicas del SCS).

-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

(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