L’últim trimestre del 2018 es va iniciar un projecte d’actualització tecnològica del servei STD (Servei de Transformació de Documents) que està previst que finalitzi a l’Abril. També es realitza una rearquitectura del servei per tal de millorar l’aïllament de les diferents funcionalitats que es proporcionen i la seva escalabilitat. STD és el principal servei en el qual es recolza eCopia, servei de còpia autèntica de documents corporatiu de la Generalitat.
Abans d’entrar en detall dels canvis que es realitzaran en aquest projecte, fem un recordatori de les diferents funcionalitats que ofereix el servei STD:
- Creació de codis segurs de verificació (CSV) per a la identificació i registre de documents
- Composició de documents PDF, consistent en la fusió de plantilles que contenen una sèrie de tags especials amb informació sobre les dades a inserir en els documents originals
- Conversió de diferents formats ofimàtics a PDF
- OCR (Optical Character Recognition) per obtenir el text d’una imatge i generació de PDFs cercables
Rearquitectura
Tota la capa d’aplicació del servei STD es mou de VM a contenidors Docker a la plataforma AppAgile. Només el servei de conversió de documents ofimàtics MS Office a PDF requereix d’un entorn Windows aprovisionat en VMs a CPD.
Gràcies a aquesta rearquitectura és possible escalar els diferents serveis per separat dependent del seu consum, a més d’estar aïllats, motiu pel qual un problema en un dels serveis no afectarà la resta. Tot el cicle de vida (desenvolupament, construcció, tests, versionat, desplegament) de cada servei és independent dels altres, podent ser evolucionats per separat.
Totes les funcionalitats del STD avui dia són exposades mitjançant serveis SOAP. Un cop finalitzat aquest projecte d’actualització tecnològica, a més de mantenir aquests serveis per compatibilitat amb els consumidors existents, s’exposarà una nova API REST. Aquesta és la línia que s’evolucionarà a futur i a la qual es recomana que les aplicacions noves s’integrin, i les existents vagin migrant. La documentació per l’ús d’aquesta nova API REST està disponible al Manual d’Usuari STD versió 2 del servei.
Sondes
Els contenidors desplegats a AppAgile tenen configurades sondes per garantir la disponibilitat del servei. En aquest comunicat s’inclou un how-to on s’explica com es poden configurar aquestes sondes en aplicacions Canigó 3.2.
Actualització tecnològica
A continuació es detalla les actualitzacions de versions i canvis de productes més rellevants:
- Tots els serveis es basen en Canigó, i s’actualitzen a la versió 3.2.7
- Es canvia l’engine de conversió de MS Office a PDF, passant de J-Interop a documents4j
- S’actualitza la versió de MS Office de 2010 a 2016
- S’actualitza OpenOffice 4.0.1 a LibreOffice 5.4.5.1
- S’actualitza la versió de Tesseract, engine OCR, de 3.02.02 a 3.05.02
- S’actualitzen les versions de les llibreries de tractament de documents PDF (PDFBox, iText) així com d’altres d’ús intern dels diferents serveis
Impacte en integradors
El canvi tecnològic s’ha realitzat tenint en compte que l’impacte en els consumidors actuals sigui mínim. És per aquest motiu que es mantindran intactes les URLs actuals d’accés al servei SOAP:
WS SOAP
- PRE:
http://preproduccio.sgde.intranet.gencat.cat/ServeisInvocacioSTD/services/ServeisSTD<V2>?wsdl
- PRO:
http://sgde.intranet.gencat.cat/ServeisInvocacioSTD/services/ServeisSTD<V2>?wsdl
*L’antic domini de PRE “sgde.pre.intranet.gencat.cat” també seguirà funcionant com fins ara
També l’accés SFTP:
SFTP
- PRE:
sftp <usuari-app>@preproduccio.sftp.sgde.intranet.gencat.cat
- PRO:
sftp <usuari-app>@sftp.sgde.intranet.gencat.cat
*L’antic domini de PRE “sftp.sgde.pre.intranet.gencat.cat” també seguirà funcionant com fins ara
A més dels dominis existents, es donaran d’alta nous dominis dedicats al STD, en el cas de l’accés http amb la possibilitat de fer-ho per SSL:
WS SOAP (NOU!)
- PRE:
https://preproduccio.std.intranet.gencat.cat/ServeisInvocacioSTD/services/ServeisSTD<V2>?wsdl
- PRO:
https://std.intranet.gencat.cat/ServeisInvocacioSTD/services/ServeisSTD<V2>?wsdl
SFTP (NOU!)
- PRE:
sftp <usuari-app>@preproduccio.sftp.std.intranet.gencat.cat
- PRO:
sftp <usuari-app>@sftp.std.intranet.gencat.cat
Aviat s'informarà, tant en aquest portal com mitjançant comunicats destinats als integradors, la data de disponibilitat del nou entorn de Preproducció així com del període de proves abans no es posi en servei el nou entorn de Producció.
Per qualsevol dubte referent a aquest projecte de transformació tecnològica us podeu posar en contacte amb el CS Canigó obrint una petició de consulta o suport al servei [STF](https://cstd.ctti.gencat.cat/jiracstd/projects/STF) del CSTD, o bé enviant un correu a [oficina-tecnica.canigo.ctti@gencat.cat](mailto:oficina-tecnica.canigo.ctti@gencat.cat)