Notas para desarrolladores

Modelo de datos

El modelo de datos que se facilita describe los diferentes elementos que componen los datos que el Servicio Pblico 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 formacin est acreditado o inscrito. El modelo incluye la denominacin de las etiquetas, su descripcin, el tipo de dato, su obligatoriedad y en su caso los valores posibles. Siguiendo este modelo cada centro de formacin facilitar los datos sobre sus acciones formativas. Se entiende que cada centro de formacin mantiene estos datos de forma coherente, con independencia del servicio web de seguimiento del Servicio Pblico de Empleo Estatal. Estos datos ya existentes, simplemente, se facilitarn siguiendo el modelo descrito. El modelo incluye restricciones, en especial en los valores codificados, que intencionadamente no estn incluidas en la definicin del WSDL. El motivo no es otro que tratar de reducir en la medida de lo posible el nmero de cambios en la definicin del servicio web.

Kit de auto-evaluacin
El programa de autoevaluacin le permitir probar su implementacin del servicio web de seguimiento de forma anloga a como se validar su disponibilidad en el trmite de acreditacin o inscripcin del centro de formacin. El kit se compone de un fichero comprimido ZIP con el siguiente contenido: Un programa Java que realiza la prueba de verificacin. Libreras necesarias para el programa Java. Un fichero XML con los datos necesarios para la prueba. Un archivo de comandos con la invocacin al programa.

Una vez descomprimido, se crea un subdirectorio lib con las dos libreras necesarias. Para su ejecucin se precisa un entorno Java versin 1.6 o posterior. El programa Java est pensado para ejecutarse desde el smbolo del sistema de un equipo que est comunicado con el servicio web. Al programa se le invoca con tres argumentos en la lnea 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 validacin. Su nombre es : PruebaWSCentTF.cmd y su contenido es el siguiente: java -jar ProvCentTFVal.jar ProveedorCentroEndPoint password pruebaDatosDelCentro.xml El fichero pruebaDatosDelCentro.xml, que tambin se incluye contiene una prueba equivalente a la que se pasar en la acreditacin o inscripcin. 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 errnea, se utilizar el literal: EPESSEPECESEPE. obtenerDatosCentro - datos identificativos correctos. Se solicitarn 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 formacin asignndole la identificacin 20 9999999999. Para poder crear el centro, ste no debe tener acciones. obtenerDatosCentro. Se obtendrn los datos del centro de formacin y se comprobar que su identificacin es : ORIGEN_CENTRO='20' y CODIGO_CENTRO='9999999999'. obtenerListaAcciones. Se solicitar la lista de acciones formativas que debe resultar vaca puesto que se acaba de crear el centro de formacin. crearAccion. Se solicitar la creacin de las acciones formativas que estn 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 situacin. obtenerListaAcciones. Se solicitar la lista de acciones formativas que debe coincidir con el XML de prueba. crearAccion - ya creada. Se intentar crear una accin formativa ya creada, que debe dar error para que el resultado de la prueba sea correcto. obtenerAccion. Se obtendrn, una por una, todas las acciones formativas del fichero XML de prueba y se comprobar que la informacin devuelta coincide con la del XML de prueba. eliminarAccion. Se eliminarn 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 autentificacin al servicio web se utilizar el estndar Web Services Security UsernameToken Profile 1.0 OASIS Standard 200401, March 2004. El elemento wsse:Username ser SEPE como cuando lo invoque el Servicio Pblico de Empleo Estatal. El elemento wsse:Password ser el segundo argumento de la lnea de comandos. Se emplearn credenciales de tipo wsse:PasswordText. Para garantizar la confidencialidad el endpoint del servicio web ser en una direccin HTTPS. Cualquier consulta o comentario pueden dirigirlo al correo: consultas_teleformacion@sepe.es