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.
