NextGen XML (Español)

<PDF>

Sí

El documento como secuencia base64

<Signatures>

Sí

Une la 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 del mismo modo que los campos de firma inteligente contenidos en los archivos SSS.

<Signature>

Al menos una de las etiquetas <Signature>, <Static> o <DigSig> es necesaria para definir las posiciones de la firma. Es posible una combinación de diferentes colocaciones de firma.

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>.

<Static>

Define un campo estático, como alternativa a los campos inteligentes definidos con<Signature>.

Las propiedades estáticas de los campos deben definirse mediante etiquetas secundarias. Las posibles etiquetas secundarias son <Page>,<X>,<Y>. La etiqueta <Page> permite establecer también valores negativos (-1 para la última página, -2 la página anterior a la última; etc...). Si la etiqueta <Page> se establece en 0, el campo de firma se ignorará.

<DigSig>

Define un campo de firma vacío, que ya se encuentra dentro del documento PDF. Es una alternativa a los campos estáticos e inteligentes.

<FieldName>

Sí, como parte de <DigSig>

Contiene el nombre del campo Firma, que ya está dentro del PDF.

<Placeholder>

Sí, como parte de <Signature>

Contiene la subcadena de anclaje, que se utiliza para buscar campos de firma.

<Width> and <Height>

Sí, como parte de <Static> y<Signature>

Define el tamaño de los campos de firma en centímetros.

<DisplacementTLIndex> or <VersatzOLIndex>

Opcional como parte de<Signature>

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

Encontrará más información aquí.

<FeldPositionIndex>

Opcional como parte de<Signature>

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í.

<Offset_X> and <Offset_Y>

Opcional como parte de <Signature>

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 a la derecha / abajo, los negativos a la izquierda / arriba.

Encontrará más información aquí.

<Mandatory/>

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.

<Zoom> 

Opcional

Es una etiqueta opcional que define valores de zoom para el documento en eSignatureOffice/webSign/secureSign para un campo de firma concreto.

El texto dentro de la etiqueta puede ser un valor entero en el rango 10..300 (indica porcentaje)

o Ajustar, que significa ajustar a la pantalla

o Ancho, que significa ajustar al ancho de la página.

El valor de zoom predeterminado es 100 por cien.

<SignatureDisplayPlacement>

Ejemplo:

<SignatureDisplayPlacement>

<MaxWidth>40</MaxWidth>

<MaxHeight>20</MaxHeight>

<RectPosX>10</RectPosX>

<RectPosY>80</RectPosY>

</SignatureDisplayPlacement>

Opcional como parte de<Signature> o en<ESign> como opción global para cada firma sin la opción individual.

Etiquetas opcionales que definen la posición y el tamaño del campo de firma (rectángulo) en la pantalla del dispositivo.

<RectPosX> y <RectPosY> es para colocar la firma. Puede utilizar sólo uno de los valores o combinar ambos. El valor por defecto es 50 % que es el centro de la pantalla.

(0, 0) es la esquina superior izquierda y (100, 100) es la esquina inferior derecha.

Open

Open

<MaxWidth> y <MaxHeight> es para el tamaño de la firma basada. Puede utilizar sólo uno de los valores o combinar ambos. En caso de utilizar ambos valores, el dispositivo hará zoom hasta que se alcance el primero de los dos valores. Si utiliza estos valores, los valores de zoom quedarán obsoletos.

El intervalo de valores oscila entre el 10% y el 100%.

<Stamp>

Ejemplo:

<Stamp>

<Position>BottomLeft</Position>

<Text>Unterzeichnet von:  [Signer]\r\n
              Grund:  [Reason]\r\n
              Ort:    [Location]\r\n
              Zeit:   [Time]
</Text>

<Size>12</Size>

<Color>0x0000FF</Color>
</Stamp>
<Signer>Homer Simson</Signer>
<Reason>Bestätige den Inhalt</Reason>
<Location>Springfield</Location>

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.

<Text> La etiqueta debe contener el texto del sello. Nueva línea se puede introducir con símbolos \r\n.

<Color> Define el color del texto. En formato hexadecimal, representa las intensidades de color RGB para el azul, el verde y el rojo.

El valor 0x00FF0000 representa la intensidad total, azul puro, 0x0000FF es verde puro y 0xFF0000 es rojo puro. 0x000000 es negro y 0xFFFFFF es blanco.

<Font> y <Size> Define la fuente y el tamaño, respectivamente.

<Position> define la posición del sello en la imagen de la firma. por defecto es BottomLeft.

Estos son todos los valores posibles:

• <Position>BottomLeft</Position>

  <Position>TopLeft</Position>

  <Position>TopRight</Position>

  <Position>BottomRight</Position>

  <Position>CenterLeft</Position>

  <Position>CenterRight</Position>

  <Position>Center</Position>

Encontrará información sobre el marcador de posición del sello aquí.

<Signer>, <Reason> y <Location>

Opcional

Las etiquetas pueden utilizarse para especificar el nombre del firmante, el motivo de la firma y la ubicación de la firma, respectivamente

<AutoStartSig>

Opcional

Si se incluye esta etiqueta, el dispositivo comienza a firmar automáticamente después de abrir el documento.

<Signed>

Valor de retorno

Esta etiqueta se añade al resultado xml para indicar si la firma se ha añadido u omitido.

Para el <Placeholder> de la firma el valor es 1 (firmado) cuando al menos uno de los campos fue firmado. Para los detalles de cada firma individual se añadirá el <SignedProtocol>.

Valores:

0 = no firmado

1 = firma realizada

<SignedProtocol>*
<Index id="1">0</Index>
<Index id="2">1</Index>
...
</SignedProtocol>

Valor de retorno

Esta etiqueta se añade al resultado xml para cada firma <Placeholder> que se encontró dentro del documento. Hay un índice separado para cada posición de marcador de posición que se encontró dentro del pdf.

Valores:

0 = no firmado

1 = firma realizada

<Found>

Valor de retorno

Esta etiqueta se añade al xml resultante para indicar si se ha encontrado la posición de la firma (<FieldName> y <Placeholder>).

Valores:

0 = no se encuentra en el documento

1 = se encuentra dentro del documento