L’SGDE o Servei de Gestió del Document Electrònic ofereix una sèrie de serveis relacionats amb la gestió de documents electrònics. Aquests serveis els ofereixen les plataformes que integren l’SGDE. Actualment existeixen dues:
Podeu trobar mes informació sobre els serveis i funcionalitats del SGDE aquí.
El propòsit del connector és proporcionar una API que pugui ser utilitzada de forma fàcil pels integradors d’aquest connector per consumir els diferents serveis del SGDE.
El connector SGDE es troba dins els connectors funcionals de la Generalitat.
Aquest document va dirigit als següents perfils:
Aquest connector ofereix els següents serveis:
Serveis Plataforma Adobe
Serveis STD
Per poder utilitzar l’SGDE s’ha d’estar donat d’alta en el servei. Per poder fer-ho s’han d’enviar un mail a oficina-tecnica.canigo.ctti@gencat.cat sol.licitant l’alta a qualsevol de les plataformes que integren el SGDE:
Es pot trobar el codi font referent a aquest components a la següent url:
El connector SGDE és compatible amb les versions 1.5 o superior de Java. Per versions inferiors no es garantit el seu correcte funcionament.
El seu ús esta certificat per funcionar correctament en servidors d’aplicacions WL11g i Tomcat6.x.
La instal.lació del connector requereix de la utilització de la llibreria ‘canigo.integration.sgde’ i les dependències indicades a l’apartat ‘Introducció-Versions i Dependències’.
Per afegir aquesta dependència s’ha de modificar el pom.xml de l’aplicació per incloure les llibreries del Connector.
<dependency>
<groupId>cat.gencat.ctti</groupId>
<artifactId>canigo.integration.sgde</artifactId>
<version>[1.3.0,1.4.0)</version>
</dependency>
IMPORTANT
En el cas de que es vulgui integrar aquest connector en una aplicació que disposi del connector de la PICA, és farà necessari afegir les següents exclusions en aquests últim, per exemple el connector PADRÒ.
<dependency>
<groupId>cat.gencat.ctti</groupId>
<artifactId>canigo.integration.padro.pica</artifactId>
<version>1.3.0</version>
<exclusions>
<exclusion>
<groupId>org.apache.axis2</groupId>
<artifactId>axis2-jaxws</artifactId>
</exclusion>
<exclusion>
<groupId>org.apache.woden</groupId>
<artifactId>woden</artifactId>
</exclusion>
<exclusion>
<groupId>org.apache.ws.commons.schema</groupId>
<artifactId>XmlSchema</artifactId>
/exclusion>
</exclusions>
</dependency>
El no afegir aquestes exclusions pot provocar que el connector SGDE no funcioni correctament.
1.- Per poder configurar el connector SGDE és necessari crear un arxiu anomenat app-integration-sgde.xml situat en src/main/resources/spring/ amb el següent contingut:
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:aop="http://www.springframework.org/schema/aop"
xsi:schemaLocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans-4.1.xsd">
<!-- BEAN SGDE -->
<bean id="sgdeService" class="cat.gencat.ctti.canigo.arch.integration.sgde.impl.SGDEServiceImpl" init-method="setupService" scope="prototype">
<description>
SGDE implementation:
- formsWSDLUrl: Url de l'wsdl del servei de formularis per les operacions de: renderitzar, extracció de dades, aplanat, ...
- stdWSDLUrl: Url de l'wsdl del servei de Transformació de Documents(STD)
</description>
<property name="formsWSDLUrl" value="${sgde.forms.wsdl.url:https://preproduccio.eformularis.intranet.gencat.cat/ServeisInvocacio/serveis/ServeisInvocacioV2?wsdl}" />
<property name="stdWSDLUrl" value="${sgde.std.wsdl.url:https://preproduccio.std.intranet.gencat.cat/ServeisInvocacioSTD/services/ServeisSTDV2?wsdl}" />
</bean>
</beans>
on les variables sgde.forms.wsdl.url i sgde.std.wsdl.url són recuperades de l’arxiu sgde.properties que s’ha de crear en src/main/resources/config/props/sgde.properties
2.- Configuració dels arxius de properties.
Només es necessita un arxiu de properties a configurar el sgde.properties.
El primer conté només dos paràmetres,
sgde.forms.wsdl.url: Url del WSDL del servei de formularis Adobe.
sgde.std.wsdl.url: Url del WSDL del STD.
1.- En el bean on es vulgui disposar dels serveis del connector declarar el servei.
@Autowired
private ISGDEService sgdeService;
2.- Escollir un dels serveis del SGDE, per exemple el de CSV.
ResultSTD res = null;
byte[] STD_ARXIU_PDF_TEST1 = null;
try {
STD_ARXIU_PDF_TEST1 = IOUtils.toByteArray(Thread.currentThread().getContextClassLoader().getResourceAsStream("data_sgde/prueba_composar.pdf"));
res = sgdeService.generarCSV("ctti", "cscanigo", STD_ARXIU_PDF_TEST1, "cscanigo");
log.info("[SGDEConnectorService][sgdeGeneracioCSVTest][estat: " + res.getStatus().intValue() + "]");
} catch (Exception e) {
e.printStackTrace();
}
Per més informació sobre els diferents serveis que ofereix el SGDE consultar la documentació disponible aquí.