PadConnector Pro (Español)
El PadConnector Pro permite firmar documentos PDF, por lo que se ha añadido la API de firma de documentos PDF (Signature API) al PadConnector existente. La firma del documento PDF se realiza en el cliente y no en línea, como ocurre con webSignatureOfficer. El flujo de trabajo consiste en que la aplicación web debe enviar un StepOver-XML al PadConnector. Este XML contiene el documento PDF, información sobre las firmas y otros ajustes. El PadConnector reenvía el XML internamente a la SignatureAPI, que examinará el XML y ofrecerá al firmante las firmas que sean válidas. La aplicación web puede recoger el estado de la firma y el XML de salida que contiene el documento PDF firmado.
Descargas
El PadConnector Pro utiliza la API de firma, que requiere el PDF-Server que incluye la biblioteca PDF.
Página de muestra
La instalación de PadConnector contiene una página de demostración a la que puede acceder utilizando esta URL o dentro de la carpeta de instalación (...StepOver\PadConnector\bin\test\xmlsigning).
https://signsocket.stepover.com:57357/test/xmlsigning/index.html
Debe proporcionar el XML de entrada que se enviará al PadConnector. Durante la firma, verá un XML parcial con información sobre el proceso de firma. Una vez finalizado el proceso de firma, podrá descargar directamente el XML de salida o el PDF firmado.
Documentación XML
El XML permite crear un proceso de firma con una posición de firma definida. El XML es un contenedor que contiene el documento PDF codificado base64, la información de las posiciones de firma y los valores de configuración. Después de firmar, puede obtener el XML de devolución, que contiene el documento firmado e información adicional sobre las firmas.
Definición de los campos de firma
Hay 3 formas de posicionar las firmas dentro del documento:
Coordenadas estáticas (
<Static/>
), lo que significa que usted define la posición en centímetros dentro de una página. Si los documentos son estáticos, puede colocar fácilmente sus firmas.Búsqueda inteligente (
<Signature>
), es recomendable si sus documentos son dinámicos y la posición de la firma cambia dependiendo del contenido. Para la colocación utilizamos la función de búsqueda de texto, para colocar la firma junto a un texto de búsqueda que está cerca de la sigantura. Esto permite el uso de documentos dinámicos, lo importante es que la posición de la firma junto al texto de búsqueda sea la misma y que el texto de búsqueda pueda ser encontrado. Si un texto de búsqueda no se encuentra la firma será ignorada, esto significa que usted puede crear una plantilla xml para diferentes diseños de documentos, sólo tiene que asegurarse de que el texto de búsqueda es lo suficientemente específico como para que no se encuentre en posiciones que no desea. También puede ocultar los textos de búsqueda utilizando un color de texto blanco sobre fondo blanco.Campos de firma existentes
<DigSig/>
. En caso de que el documento ya contenga campos de firma vacíos, puede utilizarlos.
Etiquetas XML
La documentación XML se basa siempre en la última versión de PadConnector. En caso de que tenga problemas con etiquetas XML específicas, ejecute una actualización para comprobar si se soluciona el problema.
Nombre | Requerido | Descripción |
|
---|---|---|---|
| Sí | El documento como base64 |
|
| Sí | Sección que define los campos de firma que se ofrecen al usuario cuando entra en el modo de firma. Los campos definidos en el documento XML se gestionan de la misma forma que los campos de firma inteligente contenidos en los archivos SSS. |
|
|
Al menos una de las etiquetas | Cada firma es una etiqueta independiente. El número de campos de firma no está limitado A continuación se definen las etiquetas agrupadas de <Signature>. |
|
| Declara un campo estático, como alternativa a los campos inteligentes declarados con Las propiedades de los campos estáticos deben definirse mediante etiquetas secundarias. Las posibles etiquetas hijas son <Static>
<Page>1</Page>
<X>3.5</X>
<Y>21.5</Y>
<Height>3.1</Height>
<Width>5</Width>
</Static> |
| |
| Declara un campo de firma vacío, que ya está dentro del documento PDF. Es una alternativa a los campos estáticos e inteligentes. |
| |
| Sí, como parte de | Contiene el nombre del campo Firma, que ya está dentro del PDF. |
|
| Sí, como parte de | Contiene la subcadena de anclaje, que se utiliza para buscar campos de firma. |
|
| Sí, como parte de | Define el tamaño de los campos de firma en centímetros. |
|
| Opcional como parte de | Define la posición del punto de anclaje dentro del rectángulo, rodeando la cadena clave. Puede representarse visualmente como una matriz 3x3: 1 2 3 4 5 6 7 8 9 Más información aquí. |
|
| Opcional como parte de | Define la posición del campo con respecto a la cadena de claves basándose en una matriz 3x3 similar a DisplacementTLIndex, pero reflejada. 9 8 7 6 5 4 3 2 1 Más información aquí. |
|
| Opcional como parte de | Son etiquetas opcionales. Especificando valores distintos de cero, es posible desplazar el campo de firma el número de centímetros dado. Los valores positivos desplazan el campo hacia la derecha / abajo, los negativos hacia la izquierda / arriba. Puede encontrar más información aquí. |
|
| Opcional | Es un campo opcional que indica que el campo de firma es obligatorio. Nota: webSignatureOffice espera un valor para esta etiqueta: <Mandatory>1</Mandatory> significa campo obligatorio, <Mandatory>0</Mandatory> significa campo opcional. |
|
| Opcional como parte | Etiquetas opcionales que definen la posición y el tamaño del campo de firma (rectángulo) en la pantalla del dispositivo.
(0, 0) es la esquina superior izquierda y (100, 100) es la esquina inferior derecha.
El intervalo de valores oscila entre el 10% y el 100%. |
|
| Opcional | Es una etiqueta opcional. Especifica el sello de firma (texto), que se almacena junto con la imagen de firma en la página del documento.
El valor 0x00FF0000 representa la intensidad completa, azul puro, 0x0000FF es verde puro y 0xFF0000 es rojo puro. 0x000000 es negro y 0xFFFFFF es blanco.
<Position> define la posición del sello en la imagen de la firma. por defecto es BottomLeft. Estos son todos los valores posibles:
Encontrará información sobre el marcador de posición del sello aquí. |
|
| Opcional | Las etiquetas pueden utilizarse para especificar el nombre del firmante, el motivo de la firma y la ubicación de la firma, respectivamente. |
|
| Opcional | Si se incluye esta etiqueta, el dispositivo comienza a firmar automáticamente después de abrir el documento. |
|
| Valor de retorno | Esta etiqueta se añade al resultado xml para indicar si la firma se ha añadido u omitido. Mediante Valores: 0 = no firmado 1 = firma realizada |
|
| Valor de retorno | Esta etiqueta se añade al resultado xml para cada firma Valores: 0 = no firmado 1 = firma realizada |
|
| Valor de retorno | Esta etiqueta se añade al xml resultante para indicar si se ha encontrado la posición de la firma ( Valores: 0 = no se encuentra en el documento 1 = se encuentra dentro del documento |
|
*estas etiquetas XML aún no se han implementado/publicado y se añadirán en el futuro.
XSD Sets
Modelos para la colocación de firmas
<Signatures>
<Static>
<Page>1</Page>
<X>3.5</X>
<Y>21.5</Y>
<Height>3.1</Height>
<Width>5</Width>
<Signed>0</Signed>
<Found>0</Found>
...
</Static>
...
</Signatures> |
<Signatures>
<Signature>
<Placeholder>Signature Customer</Placeholder>
<Width>4</Width>
<Height>3</Height>
<DisplacementTLIndex>7</DisplacementTLIndex>
<FeldPositionIndex>3</FeldPositionIndex>
<Offset_X>0</Offset_X>
<Offset_Y>-3</Offset_Y>
<Signed>0</Signed>
<Found>0</Found>
...
</Signature>
...
</Signatures> |
Ejemplos de archivos XML
Coordenadas estáticas:
Búsqueda de marcadores de posición:
campos de Firma existentes: