Guía de migración de ecoSignatureJWS Browser

Guía de migración de ecoSignatureJWS Browser

Sobre este documento

El objetivo de este documento es explicar los pasos que se deben seguir cuando se haga una migración de ecoSignature JWS Browser de una versión anterior a 4.x a otra mas nueva. Explica qué modificaciones han de realizarse si se hubiera realizado un proceso de integración de ecoSignature JWS Browser en diferentes procesos de negocio.

En un primer paso, hay que copiar una serie de ficheros que son necesarios para que los cambios realizados en la aplicación se mantengan.

Posteriormente, hay que comprobar una serie de ficheros en los que hay que sustituir las personalizaciones que se hayan realizado en los mismos.

En un último apartado de este documento se explican las correspondencias de variables que hay entre la versión antigua, y la nueva.

Antes de leer este documento, se recomienda haber leído previamente el documento ecoSignature JWS – Browser – Manual técnico e integración.

Ficheros a copiar

Una vez desplegado el contenido del zip, hay que copiar de la versión antigua, los siguientes ficheros:

• Fichero de licencia. Se encuentra en:
  • Eclipse, ecoSignatureJWS/WebContent/JWS/ecobiometricJWS/serverlic.lic.
  • IIS, web/JWS/ecobiometricJWS/serverlic.lic.
  • WAMP, www/JWS/ecobiometricJWS/serverlic.lic. 
• Ficheros ebps. Se deben copiar en la misma  ruta que se encontraba en la versión antigua. La mayoría de las veces se encuentran en la ruta web/JWS/*.ebp.
• Ficheros PDFs utilizados previamente en la aplicación.

Ficheros a modificar

Cuando se ha realizado la sustitución de los ficheros indicados en el paso 1, hay que revisar el resto de la estructura, ya que sólo se realizarán determinados cambios en función del grado de integración que se haya realizado previamente. El fichero que suele tener integradas estas modificaciones es web/JWS/js/jws.js. 

En el mismo se encuentra la lógica de la aplicación. A partir de la versión 4.0, se ha realizado una simplificación de la misma, por lo que se recomienda hacer una comparación cuidadosa en el caso de que se hayan realizado cambios en el proceso de integración e incorporar los mismos en la nueva versión.

Correspondencia de variables

Se ha procedido a realizar un renombrado de las variables en esta nueva versión. Estos cambios se encuentran incorporados en los ficheros web/JWS/js/jws.js y web/personalización.js.

Si la variable buscada no aparece en este apartado, su nombre es el mismo.

jws.js

NOMBRE ANTERIOR A VERSIÓN 4

NOMBRE EN VERSIÓN 4

URLApplication

URLecoSignatureJWS

pdfSignedB64

nameFileResult

this.useProtocol

jws.protocol

configJWS

jws

personalizacion.js

NOMBRE ANTERIOR A VERSIÓN 4

NOMBRE EN VERSIÓN 4

workUrlAbsolutePDF

———–

checkEBPInicialPersCu

checkEBPIniTialPersCu

typeSignedPersCu

———–

typeTabletPersCu

———–

widgetWidthPersCu

widgetAnchoPersCu

widgetHeightPersCu

widgetAltoPersCu

positionPersCu

typePositionPersCu

checkDownloadPersCu

checkDownloadPDFPersCu

textFolderDownloadPersCu

textFolderDownloadPDFPersCu

checkExecutionPersCu

checkExecutionPDFPersCu

tspActivatePersCu

activateTspPersCu

tspUrlPersCu

urlTspPersCu

tspUserPersCu

userTspPersCu

tspPasswordPersCu

passTspPersCu

ocspActivatePersCu

activateOcspPersCu

ocspUrlPersCu

urlOcspPersCu

ocspUserPersCu

userOcspPersCu

ocspPasswordPersCu

passOcspPersCu

Migración de versiones posteriores

Entre las  novedades de la versión 4, se ha realizado una simplificación del código, pensando sobre todo, en una mayor facilidad para actualizar a la última versión. En posteriores migraciones, únicamente se requerirá sustituir el archivo ecoSignatureJWS.js.