Download Notas para desarrolladores

Notas para desarrolladores
Modelo de datos
El modelo de datos que se facilita describe los diferentes elementos que componen los datos
que el Servicio Público de Empleo Estatal considera necesarios para el seguimiento de las
acciones formativas en las que se imparten las especialidades formativas en las que el centro
de formación está acreditado o inscrito.
El modelo incluye la denominación de las etiquetas, su descripción, el tipo de dato, su
obligatoriedad y en su caso los valores posibles.
Siguiendo este modelo cada centro de formación facilitará los datos sobre sus acciones
formativas.
Se entiende que cada centro de formación mantiene estos datos de forma coherente, con
independencia del servicio web de seguimiento del Servicio Público de Empleo Estatal. Estos
datos ya existentes, simplemente, se facilitarán siguiendo el modelo descrito.
El modelo incluye restricciones, en especial en los valores codificados, que intencionadamente
no están incluidas en la definición del WSDL. El motivo no es otro que tratar de reducir en la
medida de lo posible el número de cambios en la definición del servicio web.
Kit de auto-evaluación
El programa de autoevaluación le permitirá probar su implementación del servicio web de
seguimiento de forma análoga a como se validará su disponibilidad en el trámite de
acreditación o inscripción del centro de formación.
El kit se compone de un fichero comprimido ZIP con el siguiente contenido:
•
•
•
•
Un programa Java que realiza la prueba de verificación.
Librerías necesarias para el programa Java.
Un fichero XML con los datos necesarios para la prueba.
Un archivo de comandos con la invocación al programa.
Una vez descomprimido, se crea un subdirectorio “lib” con las dos librerías necesarias.
Para su ejecución se precisa un entorno Java versión 1.6 o posterior.
El programa Java está pensado para ejecutarse desde el símbolo del sistema de un equipo que
está comunicado con el servicio web.
Al programa se le invoca con tres argumentos en la línea de comandos:
•
URL del servicio WEB.
•
•
Credenciales de acceso.
Fichero XML con datos de prueba.
Se incluye un archivo CMD modelo para ejecutar el programa de validación. Su nombre es :
PruebaWSCentTF.cmd y su contenido es el siguiente:
java -jar ProvCentTFVal.jar ProveedorCentroEndPoint password pruebaDatosDelCentro.xml
El fichero pruebaDatosDelCentro.xml, que también se incluye contiene una prueba equivalente
a la que se pasará en la acreditación o inscripción. Debe obtener resultado correcto en todos
los pasos.
La prueba se compone de los siguientes pasos:
•
•
•
•
•
•
•
•
•
•
obtenerDatosCentro con una password incorrecta.
Se invocará al WS con usuario: “SEPE” (este es el usuario correcto que se empleará en
el seguimiento) y, a modo de credencial errónea, se utilizará el literal:
“EPESSEPECESEPE”.
obtenerDatosCentro - datos identificativos correctos.
Se solicitarán los datos identificativos y el resultado será correcto si coinciden con los
datos identificativos del Fichero XML con datos de prueba.
crearCentro - ORIGEN_CENTRO='20' y CODIGO_CENTRO='9999999999'.
Se creará el centro de formación asignándole la identificación 20 9999999999. Para
poder crear el centro, éste no debe tener acciones.
obtenerDatosCentro.
Se obtendrán los datos del centro de formación y se comprobará que su identificación
es : ORIGEN_CENTRO='20' y CODIGO_CENTRO='9999999999'.
obtenerListaAcciones.
Se solicitará la lista de acciones formativas que debe resultar vacía puesto que se
acaba de crear el centro de formación.
crearAccion.
Se solicitará la creación de las acciones formativas que estén en el fichero XML con
datos de prueba. Esta prueba se repetirá tantas veces como acciones formativas haya
en el XML de prueba. El fichero XML de prueba incluido en el kit tiene acciones
formativas en diferentes situaciones con los elementos del modelo presentes o
ausentes apropiados para cada situación.
obtenerListaAcciones.
Se solicitará la lista de acciones formativas que debe coincidir con el XML de prueba.
crearAccion - ya creada.
Se intentará crear una acción formativa ya creada, que debe dar error para que el
resultado de la prueba sea correcto.
obtenerAccion.
Se obtendrán, una por una, todas las acciones formativas del fichero XML de prueba y
se comprobará que la información devuelta coincide con la del XML de prueba.
eliminarAccion.
Se eliminarán una por una todas las acciones formativas del fichero XML de prueba.
Para cada prueba se mostrará “OK” si el resultado es el esperado y “KO” si no lo es.
Se considerará disponible el servicio web que tenga todas las pruebas “OK”.
Se recuerda que para la autentificación al servicio web se utilizará el estándar Web Services
Security UsernameToken Profile 1.0 OASIS Standard 200401, March 2004. El elemento
wsse:Username será “SEPE” como cuando lo invoque el Servicio Público de Empleo Estatal. El
elemento wsse:Password será el segundo argumento de la línea de comandos. Se emplearán
credenciales de tipo wsse:PasswordText.
Para garantizar la confidencialidad el endpoint del servicio web será en una dirección HTTPS.
Cualquier consulta o comentario pueden dirigirlo al correo: [email protected]