Código fuente wiki de Servicios para aplicaciones del Departamento de Educación
Última modificación por Victor Lucian Timoftii el 2021/02/23 14:32
Mostrar los últimos autores
| author | version | line-number | content |
|---|---|---|---|
| 1 | \\ | ||
| 2 | |||
| 3 | |||
| 4 | {{toc/}} | ||
| 5 | |||
| 6 | = SERVICIO DE USUARIOS = | ||
| 7 | |||
| 8 | == Objetivos == | ||
| 9 | |||
| 10 | Proporcionar acceso a los datos de usuario a otras aplicaciones internas del Departamento de Educación. | ||
| 11 | |||
| 12 | //URL WSDL: [[https:~~/~~/educages.navarra.es/Educa/services/usr/USRWS?wsdl>>https://educages.navarra.es/Educa/services/usr/USRWS?wsdl]]// | ||
| 13 | |||
| 14 | == Bloqueos de acceso por orden judicial == | ||
| 15 | |||
| 16 | En determinadas ocasiones, y por orden judicial, se bloquea el acceso de padres, madres o tutores a los datos de sus hijos e hijas. | ||
| 17 | Para poder comprobar esto, se define el método "getUsuariosBloqueados" al que se le pasa como parámetro el nombre del usuario del que queremos comprobar si puede acceder a datos de otros usuarios. | ||
| 18 | Devuelve un listado de usuarios y sede a las que no puede acceder. | ||
| 19 | |||
| 20 | **Parámetros de entrada** | ||
| 21 | |||
| 22 | {{code language="java"}} | ||
| 23 | getUsuariosBloqueados(String usuario) | ||
| 24 | {{/code}} | ||
| 25 | |||
| 26 | **Datos de salida** | ||
| 27 | |||
| 28 | {{code language="java"}} | ||
| 29 | List<DataSingleDTO> | ||
| 30 | {{/code}} | ||
| 31 | |||
| 32 | Donde: | ||
| 33 | id es el id de la sede | ||
| 34 | valor es el nombre del usuario al que no puede acceder | ||
| 35 | |||
| 36 | **Parámetros de entrada** | ||
| 37 | |||
| 38 | {{code language="xml"}} | ||
| 39 | <usr:getUsuariosBloqueados> | ||
| 40 | <usuario>userName</usuario> | ||
| 41 | </usr:getUsuariosBloqueados> | ||
| 42 | {{/code}} | ||
| 43 | |||
| 44 | **Ejemplo de uso** | ||
| 45 | {{code language="xml"}} <ns2:getDatosPersonalesResponse xmlns:ns2="http://usr.ws.educa.educacion.navarra.es/"> | ||
| 46 | <return> | ||
| 47 | <id>456</id> | ||
| 48 | <valor>userName2</valor> | ||
| 49 | </return> | ||
| 50 | </ns2:getDatosPersonalesResponse>{{/code}} | ||
| 51 | |||
| 52 | == Datos personales == | ||
| 53 | |||
| 54 | === A partir de un número de documento (DNI, Pasaporte...) === | ||
| 55 | |||
| 56 | Devuelve los datos personales de un usuario a partir de un tipo de documento y su número. | ||
| 57 | |||
| 58 | Los tipos de documento válidos son: | ||
| 59 | |||
| 60 | * 1.- DNI | ||
| 61 | * 2.- Pasaporte | ||
| 62 | * 3.- NIE | ||
| 63 | * 6.- DNI sin letra | ||
| 64 | |||
| 65 | **Parámetros de entrada** | ||
| 66 | |||
| 67 | {{code language="java"}} | ||
| 68 | getDatosPersonales(int iDocumentoTipo, String txDocumentoNumero) | ||
| 69 | {{/code}} | ||
| 70 | |||
| 71 | **Datos de salida** | ||
| 72 | |||
| 73 | {{code language="java"}} | ||
| 74 | GNRDatosPersonalesDTO | ||
| 75 | {{/code}} | ||
| 76 | |||
| 77 | **Definición SOAP** | ||
| 78 | |||
| 79 | {{code language="xml"}} | ||
| 80 | <usr:getDatosPersonales> | ||
| 81 | <iDocumentoTipo>1</iDocumentoTipo> | ||
| 82 | <txDocumentoNumero>1234567A</txDocumentoNumero> | ||
| 83 | </usr:getDatosPersonales> | ||
| 84 | {{/code}} | ||
| 85 | |||
| 86 | **Ejemplo de uso** | ||
| 87 | |||
| 88 | {{code language="xml"}} | ||
| 89 | <ns2:getDatosPersonalesResponse xmlns:ns2="http://usr.ws.educa.educacion.navarra.es/"> | ||
| 90 | <return> | ||
| 91 | <apellido1>Martínez</apellido1> | ||
| 92 | <apellido2>Etxeberria</apellido2> | ||
| 93 | <datosContacto> | ||
| 94 | <id>5</id> | ||
| 95 | <valor>657670001</valor> | ||
| 96 | </datosContacto> | ||
| 97 | <datosContacto> | ||
| 98 | <id>7</id> | ||
| 99 | <valor>sucorreo@proveedor.com</valor> | ||
| 100 | </datosContacto> | ||
| 101 | <datosContacto> | ||
| 102 | <id>8</id> | ||
| 103 | <valor>otrocorreo@educacion.navarra.es</valor> | ||
| 104 | </datosContacto> | ||
| 105 | <documentoNumero>1234567A</documentoNumero> | ||
| 106 | <documentoTipo>1</documentoTipo> | ||
| 107 | <fechaNacimiento>1972-02-21T00:00:00+01:00</fechaNacimiento> | ||
| 108 | <idLocalizador>5836</idLocalizador> | ||
| 109 | <nombre>Mariano</nombre> | ||
| 110 | <sexo>H</sexo> | ||
| 111 | <ubicacionDomicilio> | ||
| 112 | <calleEs>Calle Rue del Percebe</calleEs> | ||
| 113 | <calleEu>Rue del Percebe Kalea</calleEu> | ||
| 114 | <codigoINE>312010002</codigoINE> | ||
| 115 | <codigoPostal>31026</codigoPostal> | ||
| 116 | <idCalle>2604</idCalle> | ||
| 117 | <idLocalidad>747</idLocalidad> | ||
| 118 | <idPais>724</idPais> | ||
| 119 | <idProvincia>31</idProvincia> | ||
| 120 | <localidadEs>Pamplona</localidadEs> | ||
| 121 | <localidadEu>Iruña</localidadEu> | ||
| 122 | <portal>27</portal> | ||
| 123 | <puerta>4ºA</puerta> | ||
| 124 | </ubicacionDomicilio> | ||
| 125 | <usuario>mmartin32</usuario> | ||
| 126 | </return> | ||
| 127 | </ns2:getDatosPersonalesResponse> | ||
| 128 | |||
| 129 | {{/code}} | ||
| 130 | |||
| 131 | === A partir del identificador único de persona === | ||
| 132 | |||
| 133 | Devuelve los datos personales de un usuario | ||
| 134 | |||
| 135 | **Parámetros de entrada** | ||
| 136 | |||
| 137 | {{code language="java"}} | ||
| 138 | getDatosPersonales(int iDocumentoTipo, String txDocumentoNumero) | ||
| 139 | {{/code}} | ||
| 140 | |||
| 141 | **Datos de salida** | ||
| 142 | |||
| 143 | {{code language="java"}} | ||
| 144 | GNRDatosPersonalesDTO | ||
| 145 | {{/code}} | ||
| 146 | |||
| 147 | **Definición SOAP** | ||
| 148 | |||
| 149 | {{code language="xml"}} | ||
| 150 | <usr:getDatosPersonalesPorLocalizador> | ||
| 151 | <idLocalizador>1234</idLocalizador> | ||
| 152 | </usr:getDatosPersonalesPorLocalizador> | ||
| 153 | {{/code}} | ||
| 154 | |||
| 155 | **Ejemplo de uso** | ||
| 156 | |||
| 157 | {{code language="xml"}} | ||
| 158 | <ns2:getDatosPersonalesResponse xmlns:ns2="http://usr.ws.educa.educacion.navarra.es/"> | ||
| 159 | <return> | ||
| 160 | <apellido1>Martínez</apellido1> | ||
| 161 | <apellido2>Etxeberria</apellido2> | ||
| 162 | <datosContacto> | ||
| 163 | <id>5</id> | ||
| 164 | <valor>657670001</valor> | ||
| 165 | </datosContacto> | ||
| 166 | <datosContacto> | ||
| 167 | <id>7</id> | ||
| 168 | <valor>sucorreo@proveedor.com</valor> | ||
| 169 | </datosContacto> | ||
| 170 | <datosContacto> | ||
| 171 | <id>8</id> | ||
| 172 | <valor>otrocorreo@educacion.navarra.es</valor> | ||
| 173 | </datosContacto> | ||
| 174 | <documentoNumero>1234567A</documentoNumero> | ||
| 175 | <documentoTipo>1</documentoTipo> | ||
| 176 | <fechaNacimiento>1972-02-21T00:00:00+01:00</fechaNacimiento> | ||
| 177 | <idLocalizador>1234</idLocalizador> | ||
| 178 | <nombre>Mariano</nombre> | ||
| 179 | <sexo>H</sexo> | ||
| 180 | <ubicacionDomicilio> | ||
| 181 | <calleEs>Calle Rue del Percebe</calleEs> | ||
| 182 | <calleEu>Rue del Percebe Kalea</calleEu> | ||
| 183 | <codigoINE>312010002</codigoINE> | ||
| 184 | <codigoPostal>31026</codigoPostal> | ||
| 185 | <idCalle>2604</idCalle> | ||
| 186 | <idLocalidad>747</idLocalidad> | ||
| 187 | <idPais>724</idPais> | ||
| 188 | <idProvincia>31</idProvincia> | ||
| 189 | <localidadEs>Pamplona</localidadEs> | ||
| 190 | <localidadEu>Iruña</localidadEu> | ||
| 191 | <portal>27</portal> | ||
| 192 | <puerta>4ºA</puerta> | ||
| 193 | </ubicacionDomicilio> | ||
| 194 | <usuario>mmartin32</usuario> | ||
| 195 | </return> | ||
| 196 | </ns2:getDatosPersonalesResponse> | ||
| 197 | |||
| 198 | {{/code}} | ||
| 199 | |||
| 200 | == Datos profesionales == | ||
| 201 | |||
| 202 | Devuelve los datos profesionales | ||
| 203 | La entrada es por número de documento, no tiene sentido para menores que no tienen documento de identidad. | ||
| 204 | |||
| 205 | |||
| 206 | **Parámetros de entrada** | ||
| 207 | |||
| 208 | {{code language="java"}} | ||
| 209 | getDatosProfesionales(int iDocumentoTipo, String txDocumentoNumero) | ||
| 210 | {{/code}} | ||
| 211 | |||
| 212 | **Datos de salida** | ||
| 213 | |||
| 214 | {{code language="java"}} | ||
| 215 | USRDatosProfesionalesDTO | ||
| 216 | {{/code}} | ||
| 217 | |||
| 218 | **Definición SOAP** | ||
| 219 | |||
| 220 | {{code language="xml"}} | ||
| 221 | <usr:getDatosProfesionales> | ||
| 222 | <iDocumentoTipo>1</iDocumentoTipo> | ||
| 223 | <txDocumentoNumero>12345678A</txDocumentoNumero> | ||
| 224 | <idioma>es</idioma> | ||
| 225 | </usr:getDatosProfesionales> | ||
| 226 | |||
| 227 | {{/code}} | ||
| 228 | |||
| 229 | **Ejemplo de uso** | ||
| 230 | |||
| 231 | {{code language="xml"}} | ||
| 232 | <ns2:getDatosProfesionalesResponse xmlns:ns2="http://usr.ws.educa.educacion.navarra.es/"> | ||
| 233 | <return> | ||
| 234 | <especialidad> | ||
| 235 | <id>590011</id> | ||
| 236 | <idSede>1254</idSede> | ||
| 237 | <nombre>Inglés</nombre> | ||
| 238 | <idioma>1</idioma> | ||
| 239 | </especialidad> | ||
| 240 | <etapa> | ||
| 241 | <id>623</id> | ||
| 242 | <valor>Educación Básica (U.C.E.)</valor> | ||
| 243 | </etapa> | ||
| 244 | <etapa> | ||
| 245 | <id>4</id> | ||
| 246 | <valor>Educación Secundaria Obligatoria</valor> | ||
| 247 | </etapa> | ||
| 248 | <idLocalizador>1234</idLocalizador> | ||
| 249 | <perfil>101</perfil> | ||
| 250 | <puesto> | ||
| 251 | <id>25</id> | ||
| 252 | <idSede>1254</idSede> | ||
| 253 | <nombre>Coordinador EOIDNA</nombre> | ||
| 254 | </puesto> | ||
| 255 | <sede> | ||
| 256 | <id>1254</id> | ||
| 257 | <valor>Pedro de Ursua</valor> | ||
| 258 | </sede> | ||
| 259 | </return> | ||
| 260 | </ns2:getDatosProfesionalesResponse> | ||
| 261 | |||
| 262 | {{/code}} | ||
| 263 | |||
| 264 | == Contexto del usuario == | ||
| 265 | |||
| 266 | Para los profesores: Devuelve los datos asociados a los puestos de trabajo en las distintas sedes | ||
| 267 | Alumnos: Datos a sociados a las matrículas en las distintas sedes. | ||
| 268 | Otos datos de otros puestos de trabajo. | ||
| 269 | |||
| 270 | |||
| 271 | **Parámetros de entrada** | ||
| 272 | |||
| 273 | {{code language="java"}}getContextoUsuario(String usuario, String idioma){{/code}} | ||
| 274 | usuario es el nombre de usuario de educa (nombreUsuarioUnico) | ||
| 275 | |||
| 276 | **Datos de salida** | ||
| 277 | |||
| 278 | {{code language="java"}} | ||
| 279 | USRContextoUsuarioDTO | ||
| 280 | {{/code}} | ||
| 281 | |||
| 282 | **Definición SOAP** | ||
| 283 | {{code language="xml"}} <usr:getContextoUsuario> | ||
| 284 | <usuario>pmartine238</usuario> | ||
| 285 | <idioma>es</idioma> | ||
| 286 | </usr:getContextoUsuario>{{/code}} | ||
| 287 | |||
| 288 | **Ejemplo de uso** | ||
| 289 | Un profesor normal | ||
| 290 | {{code language="xml"}} <ns2:getContextoUsuarioResponse xmlns:ns2="http://usr.ws.educa.educacion.navarra.es/"> | ||
| 291 | <return> | ||
| 292 | <cargo> | ||
| 293 | <id>25</id> | ||
| 294 | <idSede>1254</idSede> | ||
| 295 | <nombre>Coordinador EOIDNA</nombre> | ||
| 296 | </cargo> | ||
| 297 | <idLocalizador>1234</idLocalizador> | ||
| 298 | <profesor> | ||
| 299 | <id>1</id> | ||
| 300 | <idSede>1254</idSede> | ||
| 301 | <nombre>Profesor/a</nombre> | ||
| 302 | </profesor> | ||
| 303 | </return> | ||
| 304 | </ns2:getContextoUsuarioResponse>{{/code}} | ||
| 305 | |||
| 306 | Un director que además es jefe de estudios | ||
| 307 | {{code language="xml"}} <ns2:getContextoUsuarioResponse xmlns:ns2="http://usr.ws.educa.educacion.navarra.es/"> | ||
| 308 | <return> | ||
| 309 | <cargo> | ||
| 310 | <id>3</id> | ||
| 311 | <idSede>483</idSede> | ||
| 312 | <nombre>Jefe de Estudios</nombre> | ||
| 313 | </cargo> | ||
| 314 | <cargo> | ||
| 315 | <id>1</id> | ||
| 316 | <idSede>483</idSede> | ||
| 317 | <nombre>Director</nombre> | ||
| 318 | </cargo> | ||
| 319 | <idLocalizador>1234</idLocalizador> | ||
| 320 | <profesor> | ||
| 321 | <id>1</id> | ||
| 322 | <idSede>483</idSede> | ||
| 323 | <nombre>Profesor/a</nombre> | ||
| 324 | </profesor> | ||
| 325 | </return> | ||
| 326 | </ns2:getContextoUsuarioResponse>{{/code}} | ||
| 327 | |||
| 328 | Un alumno con varias matrículas | ||
| 329 | {{code languaje="xml"}} <ns2:getContextoUsuarioResponse xmlns:ns2="http://usr.ws.educa.educacion.navarra.es/"> | ||
| 330 | <return> | ||
| 331 | <idLocalizador>1234</idLocalizador> | ||
| 332 | <matricula> | ||
| 333 | <curso>4º ESO</curso> | ||
| 334 | <fechaInicio>2013-09-02T00:00:00+02:00</fechaInicio> | ||
| 335 | <grupo>4M</grupo> | ||
| 336 | <idCurso>23</idCurso> | ||
| 337 | <idGrupo>55192</idGrupo> | ||
| 338 | <idModalidad>167</idModalidad> | ||
| 339 | <idModeloLinguistico>4</idModeloLinguistico> | ||
| 340 | <idSede>1254</idSede> | ||
| 341 | <modalidad>Única 4ESO</modalidad> | ||
| 342 | <modeloLinguistico>D</modeloLinguistico> | ||
| 343 | </matricula> | ||
| 344 | <matricula> | ||
| 345 | <curso>Nivel Intermedio</curso> | ||
| 346 | <fechaInicio>2013-09-02T00:00:00+02:00</fechaInicio> | ||
| 347 | <idCurso>12182</idCurso> | ||
| 348 | <idGrupo>0</idGrupo> | ||
| 349 | <idModalidad>870</idModalidad> | ||
| 350 | <idModeloLinguistico>1242</idModeloLinguistico> | ||
| 351 | <idSede>467</idSede> | ||
| 352 | <modalidad>Inglés</modalidad> | ||
| 353 | <modeloLinguistico>Cas.</modeloLinguistico> | ||
| 354 | </matricula> | ||
| 355 | <matricula> | ||
| 356 | <curso>2º Nivel avanzado</curso> | ||
| 357 | <fechaInicio>2013-09-02T00:00:00+02:00</fechaInicio> | ||
| 358 | <idCurso>12216</idCurso> | ||
| 359 | <idGrupo>0</idGrupo> | ||
| 360 | <idModalidad>872</idModalidad> | ||
| 361 | <idModeloLinguistico>1242</idModeloLinguistico> | ||
| 362 | <idSede>467</idSede> | ||
| 363 | <modalidad>Euskera</modalidad> | ||
| 364 | <modeloLinguistico>Cas.</modeloLinguistico> | ||
| 365 | </matricula> | ||
| 366 | </return> | ||
| 367 | </ns2:getContextoUsuarioResponse>{{/code}} | ||
| 368 | |||
| 369 | == Contexto del usuario para la mensajería interna == | ||
| 370 | |||
| 371 | Extiende los datos mostrados por el método 'getContextoUsuario' para su uso delsde el cliente de mensajería 'RoundCube'. | ||
| 372 | Proporciona el DTO 'USRContextoUsuarioMSGDTO' que añade los campos al USRContextoUsuarioDTO: | ||
| 373 | protected boolean puedeCambiarCE; //True si puede cambiar el curso escolar en la generación de las libretas | ||
| 374 | protected int idCursoEscolar; //Curso escolar actual | ||
| 375 | protected List<String> libretas; //Nombres de las libretas que puede cambiar// | ||
| 376 | |||
| 377 | **Parámetros de entrada** | ||
| 378 | |||
| 379 | {{code language="java"}}getContextoUsuarioMSG(String usuario, String idioma){{/code}} | ||
| 380 | usuario es el nombre de usuario de educa (nombreUsuarioUnico) | ||
| 381 | |||
| 382 | **Datos de salida** | ||
| 383 | |||
| 384 | {{code language="java"}} | ||
| 385 | USRContextoUsuarioMSGDTO | ||
| 386 | {{/code}} | ||
| 387 | |||
| 388 | **Definición SOAP** | ||
| 389 | {{code language="xml"}} <usr:getContextoUsuarioMSG> | ||
| 390 | <usuario>pmartine238</usuario> | ||
| 391 | <idioma>es</idioma> | ||
| 392 | </usr:getContextoUsuario>{{/code}} | ||
| 393 | |||
| 394 | **Ejemplo de uso** | ||
| 395 | Un profesor normal | ||
| 396 | {{code language="xml"}} <ns2:getContextoUsuarioMSGResponse xmlns:ns2="http://usr.ws.educa.educacion.navarra.es/"> | ||
| 397 | <return> | ||
| 398 | <cargo> | ||
| 399 | <id>25</id> | ||
| 400 | <idSede>1254</idSede> | ||
| 401 | <nombre>Coordinador EOIDNA</nombre> | ||
| 402 | </cargo> | ||
| 403 | <idLocalizador>1234</idLocalizador> | ||
| 404 | <profesor> | ||
| 405 | <id>1</id> | ||
| 406 | <idSede>1254</idSede> | ||
| 407 | <nombre>Profesor/a</nombre> | ||
| 408 | </profesor> | ||
| 409 | <idCursoEscolar>129</idCursoEscolar> | ||
| 410 | <libretas>libretaAlumnado</libretas> | ||
| 411 | <libretas>libretaCargosOrientacion</libretas> | ||
| 412 | <libretas>libretaPAS</libretas> | ||
| 413 | <libretas>libretaProfesorado</libretas> | ||
| 414 | <libretas>libretaRepresentantesLegales</libretas> | ||
| 415 | <libretas>libreta.sede.para-pas.1</libretas> | ||
| 416 | <libretas>libreta.sede.para-pas.1</libretas> | ||
| 417 | <libretas>libreta.sede.equipodirectivo.para-todos.1254</libretas> | ||
| 418 | <puedeCambiarCE>false</puedeCambiarCE> | ||
| 419 | </return> | ||
| 420 | </ns2:getContextoUsuarioMSGResponse>{{/code}} | ||
| 421 | |||
| 422 | == Usuarios bloqueados == | ||
| 423 | |||
| 424 | Devuelve un listado con aquellos usuarios a cuyos datos el usuario pasado como argumento no uede acceder. | ||
| 425 | Puede haber sido bloqueado el acceso por orden judicial. | ||
| 426 | El id devuelto es el id de la sede a la que afecta el bloqueo. | ||
| 427 | El valor es el nombre de usuario a cuyos datos no se puede acceder. | ||
| 428 | |||
| 429 | |||
| 430 | **Parámetros de entrada** | ||
| 431 | |||
| 432 | {{code language="java"}}getUsuariosBloqueados(String usuarioQueQuiereAcceder){{/code}} | ||
| 433 | usuarioQueQuiereAccederes el nombre de usuario de educa (nombreUsuarioUnico) | ||
| 434 | |||
| 435 | **Datos de salida** | ||
| 436 | |||
| 437 | {{code language="java"}} | ||
| 438 | DataSingleDTO | ||
| 439 | {{/code}} | ||
| 440 | |||
| 441 | **Definición SOAP** | ||
| 442 | {{code language="xml"}} <usr:getUsuariosBloqueados> | ||
| 443 | <usuario>nombreUsuario</usuario> | ||
| 444 | </usr:getUsuariosBloqueados>{{/code}} | ||
| 445 | **Ejemplo de uso** | ||
| 446 | {{code languaje="xml"}}<ns2:getUsuariosBloqueadosResponse xmlns:ns2="http://usr.ws.educa.educacion.navarra.es/"> | ||
| 447 | <return> | ||
| 448 | <id>26</id> | ||
| 449 | <valor>otroNombreUsuario</valor> | ||
| 450 | </return> | ||
| 451 | </ns2:getUsuariosBloqueadosResponse>{{/code}} | ||
| 452 | |||
| 453 | |||
| 454 | |||
| 455 | == Listados de datos auxiliares == | ||
| 456 | |||
| 457 | === Tipos de puesto en la sede. Cargos. (CTRPuestoTipo) === | ||
| 458 | |||
| 459 | **Parámetros de entrada** | ||
| 460 | |||
| 461 | {{code language="java"}} | ||
| 462 | getCTRPuestoTipos(boolean activo,String idioma) | ||
| 463 | {{/code}} | ||
| 464 | |||
| 465 | |||
| 466 | **Datos de salida** | ||
| 467 | |||
| 468 | {{code language="java"}} | ||
| 469 | List<DataSingleDTO> | ||
| 470 | {{/code}} | ||
| 471 | |||
| 472 | **Definición SOAP** | ||
| 473 | {{code language="xml"}} <usr:getCTRPuestoTipos> | ||
| 474 | <activo>true</activo> | ||
| 475 | <idioma>eu</idioma> | ||
| 476 | </usr:getCTRPuestoTipos>{{/code}} | ||
| 477 | **Ejemplo de uso** | ||
| 478 | {{code languaje="xml"}} <ns2:getCTRPuestoTiposResponse xmlns:ns2="http://usr.ws.educa.educacion.navarra.es/"> | ||
| 479 | <return> | ||
| 480 | <id>26</id> | ||
| 481 | <valor>Otro</valor> | ||
| 482 | </return> | ||
| 483 | <return> | ||
| 484 | <id>27</id> | ||
| 485 | <valor>General</valor> | ||
| 486 | </return> | ||
| 487 | <return> | ||
| 488 | <id>28</id> | ||
| 489 | <valor>Orientación</valor> | ||
| 490 | </return> | ||
| 491 | <return> | ||
| 492 | <id>29</id> | ||
| 493 | <valor>PAS - Administrativo</valor> | ||
| 494 | </return> | ||
| 495 | <return> | ||
| 496 | <id>30</id> | ||
| 497 | <valor>Jefe/Encargado de Calidad</valor> | ||
| 498 | </return> | ||
| 499 | <return> | ||
| 500 | <id>31</id> | ||
| 501 | <valor>APYMA</valor> | ||
| 502 | </return> | ||
| 503 | <return> | ||
| 504 | <id>1</id> | ||
| 505 | <valor>Director</valor> | ||
| 506 | </return> | ||
| 507 | <return> | ||
| 508 | <id>2</id> | ||
| 509 | <valor>Director Adjunto</valor> | ||
| 510 | </return> | ||
| 511 | <return> | ||
| 512 | <id>3</id> | ||
| 513 | <valor>Jefe de Estudios</valor> | ||
| 514 | </return> | ||
| 515 | <return> | ||
| 516 | <id>4</id> | ||
| 517 | <valor>Jefe de Estudios de Euskera</valor> | ||
| 518 | </return> | ||
| 519 | <return> | ||
| 520 | <id>5</id> | ||
| 521 | <valor>Jefe de Estudios Adjunto</valor> | ||
| 522 | </return> | ||
| 523 | <return> | ||
| 524 | <id>6</id> | ||
| 525 | <valor>Secretario</valor> | ||
| 526 | </return> | ||
| 527 | <return> | ||
| 528 | <id>7</id> | ||
| 529 | <valor>Administrador</valor> | ||
| 530 | </return> | ||
| 531 | <return> | ||
| 532 | <id>8</id> | ||
| 533 | <valor>Vicedirector</valor> | ||
| 534 | </return> | ||
| 535 | <return> | ||
| 536 | <id>9</id> | ||
| 537 | <valor>Coordinador de ciclo</valor> | ||
| 538 | </return> | ||
| 539 | <return> | ||
| 540 | <id>10</id> | ||
| 541 | <valor>Jefe de Departamento</valor> | ||
| 542 | </return> | ||
| 543 | <return> | ||
| 544 | <id>11</id> | ||
| 545 | <valor>Jefe de Departamento de Familia Profesional</valor> | ||
| 546 | </return> | ||
| 547 | <return> | ||
| 548 | <id>12</id> | ||
| 549 | <valor>Jefe de Estudios Nocturno</valor> | ||
| 550 | </return> | ||
| 551 | <return> | ||
| 552 | <id>13</id> | ||
| 553 | <valor>Jefe de Departamento de Actividades Profesionales Externas</valor> | ||
| 554 | </return> | ||
| 555 | <return> | ||
| 556 | <id>14</id> | ||
| 557 | <valor>Coordinador de ciclos formativos</valor> | ||
| 558 | </return> | ||
| 559 | <return> | ||
| 560 | <id>15</id> | ||
| 561 | <valor>Responsable Módulo Formación Centro de Trabajo</valor> | ||
| 562 | </return> | ||
| 563 | <return> | ||
| 564 | <id>21</id> | ||
| 565 | <valor>Coordinador de la Unidad de Apoyo Educativo</valor> | ||
| 566 | </return> | ||
| 567 | <return> | ||
| 568 | <id>16</id> | ||
| 569 | <valor>Encargado de comedor</valor> | ||
| 570 | </return> | ||
| 571 | <return> | ||
| 572 | <id>17</id> | ||
| 573 | <valor>Responsable de Nuevas Tecnologías</valor> | ||
| 574 | </return> | ||
| 575 | <return> | ||
| 576 | <id>18</id> | ||
| 577 | <valor>Encargado de actividades artístico-culturales</valor> | ||
| 578 | </return> | ||
| 579 | <return> | ||
| 580 | <id>19</id> | ||
| 581 | <valor>Encargado de actividades específicas</valor> | ||
| 582 | </return> | ||
| 583 | <return> | ||
| 584 | <id>20</id> | ||
| 585 | <valor>Coordinador de actividades deportivas</valor> | ||
| 586 | </return> | ||
| 587 | <return> | ||
| 588 | <id>22</id> | ||
| 589 | <valor>Coordinador de Biblioteca</valor> | ||
| 590 | </return> | ||
| 591 | <return> | ||
| 592 | <id>23</id> | ||
| 593 | <valor>Gestor Educa</valor> | ||
| 594 | </return> | ||
| 595 | <return> | ||
| 596 | <id>24</id> | ||
| 597 | <valor>Secretario adjunto</valor> | ||
| 598 | </return> | ||
| 599 | <return> | ||
| 600 | <id>25</id> | ||
| 601 | <valor>Coordinador EOIDNA</valor> | ||
| 602 | </return> | ||
| 603 | <return> | ||
| 604 | <id>32</id> | ||
| 605 | <valor>Coordinador EDUCA</valor> | ||
| 606 | </return> | ||
| 607 | </ns2:getCTRPuestoTiposResponse>{{/code}} | ||
| 608 | |||
| 609 | == Tipos de puesto de trabajo. (PRSPuestoSubTipo) == | ||
| 610 | |||
| 611 | **Parámetros de entrada** | ||
| 612 | |||
| 613 | {{code language="java"}} | ||
| 614 | getPRSPuestoSubTipos(boolean activo,String idioma) | ||
| 615 | {{/code}} | ||
| 616 | |||
| 617 | |||
| 618 | **Datos de salida** | ||
| 619 | |||
| 620 | {{code language="java"}} | ||
| 621 | List<DataSingleDTO> | ||
| 622 | {{/code}} | ||
| 623 | |||
| 624 | **Definición SOAP** | ||
| 625 | {{code language="xml"}} <usr:getPRSPuestoSubtipos> | ||
| 626 | <activo>true</activo> | ||
| 627 | <idioma>es</idioma> | ||
| 628 | </usr:getPRSPuestoSubtipos>{{/code}} | ||
| 629 | **Ejemplo de uso** | ||
| 630 | {{code languaje="xml"}} | ||
| 631 | <ns2:getPRSPuestoSubtiposResponse xmlns:ns2="http://usr.ws.educa.educacion.navarra.es/"> | ||
| 632 | <return> | ||
| 633 | <id>1</id> | ||
| 634 | <valor>Profesor/a</valor> | ||
| 635 | </return> | ||
| 636 | <return> | ||
| 637 | <id>2</id> | ||
| 638 | <valor>Orientador/a</valor> | ||
| 639 | </return> | ||
| 640 | <return> | ||
| 641 | <id>104</id> | ||
| 642 | <valor>Subalterno/a</valor> | ||
| 643 | </return> | ||
| 644 | <return> | ||
| 645 | <id>105</id> | ||
| 646 | <valor>Servicios Generales</valor> | ||
| 647 | </return> | ||
| 648 | <return> | ||
| 649 | <id>106</id> | ||
| 650 | <valor>Mantenimiento</valor> | ||
| 651 | </return> | ||
| 652 | <return> | ||
| 653 | <id>107</id> | ||
| 654 | <valor>Limpiador/a</valor> | ||
| 655 | </return> | ||
| 656 | <return> | ||
| 657 | <id>108</id> | ||
| 658 | <valor>Jardinero/a</valor> | ||
| 659 | </return> | ||
| 660 | <return> | ||
| 661 | <id>101</id> | ||
| 662 | <valor>Oficial de Administración</valor> | ||
| 663 | </return> | ||
| 664 | <return> | ||
| 665 | <id>102</id> | ||
| 666 | <valor>Auxiliar Administración</valor> | ||
| 667 | </return> | ||
| 668 | <return> | ||
| 669 | <id>103</id> | ||
| 670 | <valor>Conserje</valor> | ||
| 671 | </return> | ||
| 672 | <return> | ||
| 673 | <id>111</id> | ||
| 674 | <valor>Cuidador/a</valor> | ||
| 675 | </return> | ||
| 676 | <return> | ||
| 677 | <id>201</id> | ||
| 678 | <valor>Comisión de Escolarización</valor> | ||
| 679 | </return> | ||
| 680 | <return> | ||
| 681 | <id>202</id> | ||
| 682 | <valor>Administrador</valor> | ||
| 683 | </return> | ||
| 684 | <return> | ||
| 685 | <id>203</id> | ||
| 686 | <valor>Inspector</valor> | ||
| 687 | </return> | ||
| 688 | <return> | ||
| 689 | <id>204</id> | ||
| 690 | <valor>Inspector Administrador</valor> | ||
| 691 | </return> | ||
| 692 | <return> | ||
| 693 | <id>205</id> | ||
| 694 | <valor>Gestor Evaluación Diagnóstica</valor> | ||
| 695 | </return> | ||
| 696 | <return> | ||
| 697 | <id>206</id> | ||
| 698 | <valor>Administrador sólo lectura</valor> | ||
| 699 | </return> | ||
| 700 | <return> | ||
| 701 | <id>207</id> | ||
| 702 | <valor>Censo 1</valor> | ||
| 703 | </return> | ||
| 704 | <return> | ||
| 705 | <id>208</id> | ||
| 706 | <valor>Censo 2</valor> | ||
| 707 | </return> | ||
| 708 | <return> | ||
| 709 | <id>209</id> | ||
| 710 | <valor>Gestor Libros de texto</valor> | ||
| 711 | </return> | ||
| 712 | <return> | ||
| 713 | <id>210</id> | ||
| 714 | <valor>Gestor FCT</valor> | ||
| 715 | </return> | ||
| 716 | <return> | ||
| 717 | <id>211</id> | ||
| 718 | <valor>Director Servicio</valor> | ||
| 719 | </return> | ||
| 720 | <return> | ||
| 721 | <id>212</id> | ||
| 722 | <valor>Auxiliar de inspección</valor> | ||
| 723 | </return> | ||
| 724 | <return> | ||
| 725 | <id>213</id> | ||
| 726 | <valor>Gestor Salud</valor> | ||
| 727 | </return> | ||
| 728 | <return> | ||
| 729 | <id>214</id> | ||
| 730 | <valor>Gestor Títulos</valor> | ||
| 731 | </return> | ||
| 732 | <return> | ||
| 733 | <id>215</id> | ||
| 734 | <valor>Estadísticas</valor> | ||
| 735 | </return> | ||
| 736 | <return> | ||
| 737 | <id>216</id> | ||
| 738 | <valor>Gestor PNTE</valor> | ||
| 739 | </return> | ||
| 740 | <return> | ||
| 741 | <id>217</id> | ||
| 742 | <valor>Incidencias GDP</valor> | ||
| 743 | </return> | ||
| 744 | <return> | ||
| 745 | <id>218</id> | ||
| 746 | <valor>Gestor validaciones</valor> | ||
| 747 | </return> | ||
| 748 | </ns2:getPRSPuestoSubtiposResponse>{{/code}} | ||
| 749 | |||
| 750 | == Cuerpos == | ||
| 751 | |||
| 752 | Devuelve el listado de cuerpos a los que pueden pertenecer los profesores con su código | ||
| 753 | |||
| 754 | **Parámetros de entrada** | ||
| 755 | |||
| 756 | {{code language="java"}} | ||
| 757 | getCuerpos(String idioma) | ||
| 758 | {{/code}} | ||
| 759 | |||
| 760 | |||
| 761 | **Datos de salida** | ||
| 762 | |||
| 763 | {{code language="java"}} | ||
| 764 | List<DataSingleDTO> | ||
| 765 | {{/code}} | ||
| 766 | |||
| 767 | **Definición SOAP** | ||
| 768 | {{code language="xml"}} | ||
| 769 | <usr:getCuerpos> | ||
| 770 | <!--Optional:--> | ||
| 771 | <idioma>es</idioma> | ||
| 772 | </usr:getCuerpos>{{/code}} | ||
| 773 | **Ejemplo de uso** | ||
| 774 | {{code languaje="xml"}} <ns2:getCuerposResponse xmlns:ns2="http://usr.ws.educa.educacion.navarra.es/"> | ||
| 775 | <return> | ||
| 776 | <id>595</id> | ||
| 777 | <valor>Profesores de Artes Plásticas y Diseño</valor> | ||
| 778 | </return> | ||
| 779 | <return> | ||
| 780 | <id>594</id> | ||
| 781 | <valor>Profesores de Música y Artes Escénicas</valor> | ||
| 782 | </return> | ||
| 783 | <return> | ||
| 784 | <id>597</id> | ||
| 785 | <valor>Maestros</valor> | ||
| 786 | </return> | ||
| 787 | <return> | ||
| 788 | <id>511</id> | ||
| 789 | <valor>Inspectores de Educación</valor> | ||
| 790 | </return> | ||
| 791 | <return> | ||
| 792 | <id>596</id> | ||
| 793 | <valor>Maestros de Taller de Artes Plásticas y Diseño</valor> | ||
| 794 | </return> | ||
| 795 | <return> | ||
| 796 | <id>599</id> | ||
| 797 | <valor>NA-Profesores de Iniciación Musical</valor> | ||
| 798 | </return> | ||
| 799 | <return> | ||
| 800 | <id>598</id> | ||
| 801 | <valor>NA-Profesores de Religión</valor> | ||
| 802 | </return> | ||
| 803 | <return> | ||
| 804 | <id>590</id> | ||
| 805 | <valor>Profesores de Enseñanza Secundaria</valor> | ||
| 806 | </return> | ||
| 807 | <return> | ||
| 808 | <id>526</id> | ||
| 809 | <valor>Profesores Especialidades de I.T.E.M.</valor> | ||
| 810 | </return> | ||
| 811 | <return> | ||
| 812 | <id>591</id> | ||
| 813 | <valor>Profesores Técnicos de Formación Profesional</valor> | ||
| 814 | </return> | ||
| 815 | <return> | ||
| 816 | <id>592</id> | ||
| 817 | <valor>Profesores de Escuelas Oficiales de Idiomas</valor> | ||
| 818 | </return> | ||
| 819 | <return> | ||
| 820 | <id>593</id> | ||
| 821 | <valor>Catedráticos de Música y Artes Escénicas</valor> | ||
| 822 | </return> | ||
| 823 | </ns2:getCuerposResponse>{{/code}} | ||
| 824 | |||
| 825 | == Datos de contacto. tipos == | ||
| 826 | |||
| 827 | Devuelve el listado de tipos de datos de contacto con su código | ||
| 828 | |||
| 829 | **Parámetros de entrada** | ||
| 830 | |||
| 831 | {{code language="java"}} | ||
| 832 | getDatosContactoTipos(String idioma) | ||
| 833 | {{/code}} | ||
| 834 | |||
| 835 | |||
| 836 | **Datos de salida** | ||
| 837 | |||
| 838 | {{code language="java"}} | ||
| 839 | List<DataSingleDTO> | ||
| 840 | {{/code}} | ||
| 841 | |||
| 842 | **Definición SOAP** | ||
| 843 | {{code language="xml"}} | ||
| 844 | <usr:getDatosContactoTipos> | ||
| 845 | <!--Optional:--> | ||
| 846 | <idioma>es</idioma> | ||
| 847 | </usr:getDatosContactoTipos>{{/code}} | ||
| 848 | **Ejemplo de uso** | ||
| 849 | {{code languaje="xml"}} <ns2:getDatosContactoTiposResponse xmlns:ns2="http://usr.ws.educa.educacion.navarra.es/"> | ||
| 850 | <return> | ||
| 851 | <id>3</id> | ||
| 852 | <valor>Teléfono particular 3</valor> | ||
| 853 | </return> | ||
| 854 | <return> | ||
| 855 | <id>2</id> | ||
| 856 | <valor>Teléfono particular 2</valor> | ||
| 857 | </return> | ||
| 858 | <return> | ||
| 859 | <id>1</id> | ||
| 860 | <valor>Teléfono particular</valor> | ||
| 861 | </return> | ||
| 862 | <return> | ||
| 863 | <id>7</id> | ||
| 864 | <valor>Email</valor> | ||
| 865 | </return> | ||
| 866 | <return> | ||
| 867 | <id>6</id> | ||
| 868 | <valor>Móvil 2</valor> | ||
| 869 | </return> | ||
| 870 | <return> | ||
| 871 | <id>5</id> | ||
| 872 | <valor>Móvil</valor> | ||
| 873 | </return> | ||
| 874 | <return> | ||
| 875 | <id>4</id> | ||
| 876 | <valor>Fax</valor> | ||
| 877 | </return> | ||
| 878 | <return> | ||
| 879 | <id>8</id> | ||
| 880 | <valor>Email Google (PNTEApps)</valor> | ||
| 881 | </return> | ||
| 882 | </ns2:getDatosContactoTiposResponse>{{/code}} | ||
| 883 | |||
| 884 | == Idiomas == | ||
| 885 | |||
| 886 | Devuelve el listado de idiomas con su código que se utiliza en las respuestas. | ||
| 887 | Son idiomas correspondientes a las enseñanzas. | ||
| 888 | En la llamada a los métodos se utilizan los códigos "es" (Español) y "eu" (Euskera) | ||
| 889 | |||
| 890 | **Parámetros de entrada** | ||
| 891 | |||
| 892 | {{code language="java"}} | ||
| 893 | getIdiomas(String idioma) | ||
| 894 | {{/code}} | ||
| 895 | |||
| 896 | |||
| 897 | **Datos de salida** | ||
| 898 | |||
| 899 | {{code language="java"}} | ||
| 900 | List<DataSingleDTO> | ||
| 901 | {{/code}} | ||
| 902 | |||
| 903 | **Definición SOAP** | ||
| 904 | {{code language="xml"}} | ||
| 905 | <usr:getIdiomas> | ||
| 906 | <idioma>es</idioma> | ||
| 907 | </usr:getIdiomas>{{/code}} | ||
| 908 | **Ejemplo de uso** | ||
| 909 | {{code languaje="xml"}} <ns2:getIdiomasResponse xmlns:ns2="http://usr.ws.educa.educacion.navarra.es/"> | ||
| 910 | <return> | ||
| 911 | <id>3</id> | ||
| 912 | <valor>Inglés</valor> | ||
| 913 | </return> | ||
| 914 | <return> | ||
| 915 | <id>2</id> | ||
| 916 | <valor>Euskera</valor> | ||
| 917 | </return> | ||
| 918 | <return> | ||
| 919 | <id>1</id> | ||
| 920 | <valor>Castellano</valor> | ||
| 921 | </return> | ||
| 922 | <return> | ||
| 923 | <id>5</id> | ||
| 924 | <valor>Aleman</valor> | ||
| 925 | </return> | ||
| 926 | <return> | ||
| 927 | <id>4</id> | ||
| 928 | <valor>Francés</valor> | ||
| 929 | </return> | ||
| 930 | </ns2:getIdiomasResponse>{{/code}} | ||
| 931 | |||
| 932 | |||
| 933 | == Descripción de los objetos de transferencia de datos DTO empleados == | ||
| 934 | |||
| 935 | === GNRDatosPersonalesDTO === | ||
| 936 | |||
| 937 | {{code language="java"}} | ||
| 938 | int idLocalizador; | ||
| 939 | String nombre; | ||
| 940 | String apellido1; | ||
| 941 | String apellido2; | ||
| 942 | String usuario; | ||
| 943 | int documentoTipo; | ||
| 944 | String documentoNumero; | ||
| 945 | Date fechaNacimiento; | ||
| 946 | String descripcion; | ||
| 947 | String sexo; | ||
| 948 | {{/code}} | ||
| 949 | |||
| 950 | === USRDatosProfesionalesDTO === | ||
| 951 | |||
| 952 | {{code language="java"}} | ||
| 953 | int idLocalizador; // iIdGNRPersona | ||
| 954 | int perfil; | ||
| 955 | List<DataSingleDTO> sede; // Sedes en las que da clase | ||
| 956 | List<CTRDatoSedeIdiomaDTO> especialidad; | ||
| 957 | List<CTRDatoSedeDTO> puesto; | ||
| 958 | List<DataSingleDTO> etapa; | ||
| 959 | {{/code}} | ||
| 960 | |||
| 961 | === USRContextoUsuarioDTO === | ||
| 962 | |||
| 963 | {{code language="java"}} | ||
| 964 | List<MatriculaContextoDTO> matricula; | ||
| 965 | List<CTRDatoSedeDTO> pas; | ||
| 966 | List<CTRDatoSedeDTO> profesor; | ||
| 967 | List<CTRDatoSedeDTO> cargo; | ||
| 968 | int idLocalizador; | ||
| 969 | {{/code}} | ||
| 970 | |||
| 971 | === USRContextoUsuarioMSGDTO === | ||
| 972 | |||
| 973 | {{code language="java"}} | ||
| 974 | List<MatriculaContextoDTO> matricula; | ||
| 975 | List<CTRDatoSedeDTO> pas; | ||
| 976 | List<CTRDatoSedeDTO> profesor; | ||
| 977 | List<CTRDatoSedeDTO> cargo; | ||
| 978 | int idLocalizador; | ||
| 979 | boolean puedeCambiarCE; | ||
| 980 | int idCursoEscolar; | ||
| 981 | List<String> libretas; | ||
| 982 | {{/code}} | ||
| 983 | |||
| 984 | === DataSingleDTO === | ||
| 985 | |||
| 986 | {{code language="java"}} | ||
| 987 | int id; | ||
| 988 | String valor; | ||
| 989 | {{/code}} | ||
| 990 | |||
| 991 | === CTRDatoSedeDTO === | ||
| 992 | |||
| 993 | {{code language="java"}} | ||
| 994 | int id; | ||
| 995 | int idSede; | ||
| 996 | String nombre; | ||
| 997 | {{/code}} | ||
| 998 | |||
| 999 | === CTRDatoSedeIdiomaDTO === | ||
| 1000 | |||
| 1001 | {{code language="java"}} | ||
| 1002 | int id; | ||
| 1003 | int idSede; | ||
| 1004 | String nombre; | ||
| 1005 | int idioma; | ||
| 1006 | {{/code}} | ||
| 1007 | |||
| 1008 | === MatriculaContextoDTO === | ||
| 1009 | |||
| 1010 | {{code language="java"}} | ||
| 1011 | int idSede; | ||
| 1012 | int idCurso; | ||
| 1013 | String curso; | ||
| 1014 | int idModeloLinguistico; | ||
| 1015 | String modeloLinguistico; | ||
| 1016 | int idModalidad; | ||
| 1017 | String modalidad; | ||
| 1018 | Date fechaInicio; | ||
| 1019 | Date fechaFin; | ||
| 1020 | int idGrupo; | ||
| 1021 | String grupo; | ||
| 1022 | {{/code}} | ||
| 1023 | |||
| 1024 | = EJEMPLOS DE CLIENTES SOAP = | ||
| 1025 | |||
| 1026 | == PHP == | ||
| 1027 | |||
| 1028 | === Ciente sin autentificar === | ||
| 1029 | |||
| 1030 | {{code language="php"}} | ||
| 1031 | <?php | ||
| 1032 | $wsdl = "http://educa.navarra.es/Educa/services/ConsultaCentros?wsdl"; | ||
| 1033 | |||
| 1034 | $params = array( | ||
| 1035 | 'sede' => '9', | ||
| 1036 | 'cursoEscolar' => 125, | ||
| 1037 | 'idioma' => 'es' | ||
| 1038 | ); | ||
| 1039 | |||
| 1040 | $client = new SoapClient($wsdl); | ||
| 1041 | |||
| 1042 | $response = $client->detalleCentro($params); | ||
| 1043 | |||
| 1044 | print_r($response); | ||
| 1045 | ?> | ||
| 1046 | {{/code}} | ||
| 1047 | |||
| 1048 | === Ciente autentificado === | ||
| 1049 | |||
| 1050 | En este caso necesitgamos pasar una cabecera con los datos de autentificación y el tipo. | ||
| 1051 | Para ello extenderemos la clase SoapHeader | ||
| 1052 | |||
| 1053 | {{code language="php"}}<?php | ||
| 1054 | /** | ||
| 1055 | * Extendemos la clase SoapHeader para crear una autenticación acorde con Wsse | ||
| 1056 | */ | ||
| 1057 | class WsseAuthHeader extends SoapHeader { | ||
| 1058 | |||
| 1059 | private $wss_ns = 'http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd'; | ||
| 1060 | |||
| 1061 | /** | ||
| 1062 | * Constructor de la cabecera | ||
| 1063 | * @param $user Nombre de usuario | ||
| 1064 | * @param $pass Contraseña del usuario | ||
| 1065 | * @param $ns Esquema alternativo para la definición de la seguridad. Por defecto (null), contraseña sin encruptar | ||
| 1066 | */ | ||
| 1067 | function __construct($user, $pass, $ns = null) { | ||
| 1068 | if ($ns) { | ||
| 1069 | $this->wss_ns = $ns; | ||
| 1070 | } | ||
| 1071 | |||
| 1072 | $auth = new stdClass(); | ||
| 1073 | $auth->Username = new SoapVar($user, XSD_STRING, NULL, $this->wss_ns, NULL, $this->wss_ns); | ||
| 1074 | //$auth->Password = new SoapVar($pass, XSD_STRING, "PasswordText", $this->wss_ns, NULL, $this->wss_ns); | ||
| 1075 | |||
| 1076 | $p = '<ns2:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">'.htmlspecialchars($pass)."</ns2:Password>"; | ||
| 1077 | |||
| 1078 | $auth->Password = new SoapVar($p, XSD_ANYXML); | ||
| 1079 | |||
| 1080 | |||
| 1081 | $username_token = new stdClass(); | ||
| 1082 | $username_token->UsernameToken = new SoapVar($auth, SOAP_ENC_OBJECT, NULL, $this->wss_ns, 'UsernameToken', $this->wss_ns); | ||
| 1083 | |||
| 1084 | $security_sv = new SoapVar( | ||
| 1085 | new SoapVar($username_token, SOAP_ENC_OBJECT, NULL, $this->wss_ns, 'UsernameToken', $this->wss_ns), | ||
| 1086 | SOAP_ENC_OBJECT, NULL, $this->wss_ns, 'Security', $this->wss_ns); | ||
| 1087 | parent::__construct($this->wss_ns, 'Security', $security_sv, true); | ||
| 1088 | } | ||
| 1089 | } | ||
| 1090 | ?>{{/code}} | ||
| 1091 | Y el ejemplo de conexión quedaría así | ||
| 1092 | {{code language="php"}}<?php | ||
| 1093 | /* Ejemplo de uso de un cliente autentificado con contraseña plana*/ | ||
| 1094 | |||
| 1095 | include "WsseAuthHeader.php"; | ||
| 1096 | |||
| 1097 | //Definimos el nombre de usuario, contraseña y wsdl del servicio | ||
| 1098 | $username = 'el_nombre_de_usuario'; | ||
| 1099 | $password = 'la_contraseña'; | ||
| 1100 | $wsdl = "http://educa.navarra.es/Educa/services/usr/USRWS?wsdl"; //url a la definición del servicio (wsdl) | ||
| 1101 | |||
| 1102 | //Definimos la cabecera | ||
| 1103 | $wsse_header = new WsseAuthHeader($username, $password); | ||
| 1104 | $client = new SoapClient($wsdl, array("trace" => 1, "exception" => 0)); | ||
| 1105 | $client->__setSoapHeaders(array($wsse_header)); | ||
| 1106 | |||
| 1107 | //Parámetros del método llamado | ||
| 1108 | $params = array( | ||
| 1109 | 'usuario' => 'usuario_buscado', | ||
| 1110 | 'idioma' => 'es' | ||
| 1111 | ); | ||
| 1112 | //Llamada al método | ||
| 1113 | $response = $client->getContextoUsuario($params); | ||
| 1114 | |||
| 1115 | print_r($response); | ||
| 1116 | |||
| 1117 | //Llamada alternativa | ||
| 1118 | $response = $client->__soapCall("getContextoUsuario",$params); | ||
| 1119 | |||
| 1120 | print_r($response); | ||
| 1121 | ?>{{/code}} | ||
| 1122 | |||
| 1123 | = SERVICIO DE PREVISIÓN DATOS DE ALUMNADO Y NÚMERO DE GRUPOS = | ||
| 1124 | |||
| 1125 | En este espacio se incluye la definición de los servicios web necesarios para resolver las necesidades de previsión de datos de alumnado y número de grupos. | ||
| 1126 | |||
| 1127 | == FASES == | ||
| 1128 | |||
| 1129 | (% style="font-family: sans-serif; font-size: 14px; font-style: normal; font-weight: normal; text-align: start;" %)1.- Previsión inicial(%%) | ||
| 1130 | (% style="font-family: sans-serif; font-size: 14px; font-style: normal; font-weight: normal; text-align: start;" %)2.- Previsión Preinscripción(%%) | ||
| 1131 | (% style="font-family: sans-serif; font-size: 14px; font-style: normal; font-weight: normal; text-align: start;" %)3.- Previsión Matrícula Junio(%%) | ||
| 1132 | (% style="font-family: sans-serif; font-size: 14px; font-style: normal; font-weight: normal; text-align: start;" %)4.- Previsión Matrícula Septiembre(%%) | ||
| 1133 | (% style="font-family: sans-serif; font-size: 14px; font-style: normal; font-weight: normal; text-align: start;" %)5.- Matriculación Actual | ||
| 1134 | |||
| 1135 | == Método previsión número de alumnos == | ||
| 1136 | |||
| 1137 | Se define el método "previsiónAlumnos" al que se le pasa como parámetro un lista de códigos MEC de centros y el curso escolar. Devuelve un objeto con la previsión del curso escolar. | ||
| 1138 | |||
| 1139 | **Parámetros de entrada** | ||
| 1140 | |||
| 1141 | {{code}} | ||
| 1142 | previsionAlumnos(List<Integer> codMEC, int cursoAcademico) | ||
| 1143 | {{/code}} | ||
| 1144 | |||
| 1145 | **Datos de salida** | ||
| 1146 | |||
| 1147 | {{code}} | ||
| 1148 | MTRPrevisionCE | ||
| 1149 | {{/code}} | ||
| 1150 | |||
| 1151 | == Método previsión número de grupos de alumnos == | ||
| 1152 | |||
| 1153 | Se define el método "previsiónGrupos" al que se le pasa como parámetro un lista de códigos MEC de centros y el curso escolar. Devuelve un objeto con la previsión del curso escolar. | ||
| 1154 | |||
| 1155 | **Parámetros de entrada** | ||
| 1156 | |||
| 1157 | {{code}} | ||
| 1158 | previsionGrupos(List<Integer> codMEC, int cursoAcademico) | ||
| 1159 | {{/code}} | ||
| 1160 | |||
| 1161 | **Datos de salida** | ||
| 1162 | |||
| 1163 | {{code}} | ||
| 1164 | MTRPrevisionCE | ||
| 1165 | {{/code}} | ||
| 1166 | |||
| 1167 | == Más información: == | ||
| 1168 | |||
| 1169 | * [[WSDL>>https://educages.navarra.es/Educa/services/mtr/PrevisionWS?wsdl]] | ||
| 1170 | * [[Documentación detallada>>http://educadev.educacion.navarra.es/api/MTRPrevision/]] | ||
| 1171 | |||
| 1172 | ((( | ||
| 1173 | (% style="font-family: sans-serif; font-style: normal; text-align: start;" %) | ||
| 1174 | = (% style="font-size: 24.78px;" %)SERVICIO DE ENVÍO DE NOTIFICACIONES(%%) = | ||
| 1175 | |||
| 1176 | (% style="font-family: sans-serif; font-size: 14px; font-style: normal; font-weight: normal; text-align: start;" %) | ||
| 1177 | En este espacio se incluye la definición del servicio web necesario para la creación y envío de notificaciones de aplicaciones externas (servicios) a través de la plataforma Educa. | ||
| 1178 | |||
| 1179 | (% style="font-family: sans-serif; font-style: normal; text-align: start;" %) | ||
| 1180 | == Método de generación de SMS == | ||
| 1181 | |||
| 1182 | (% style="font-family: sans-serif; font-size: 14px; font-style: normal; font-weight: normal; text-align: start;" %) | ||
| 1183 | Se define el método "enviarSMS" al que se le pasa como parámetro un lista de notificaciones a generar. Las notificaciones son objetos que contienen uno o más destinatarios de la notificación, el mensaje que se desea entregar, una referencia externa y el nombre del servicio que solicita la notificación. Devuelve una lista de objetos con la información de cada SMS generado (destinatario, identificador del mensaje en Educa, referencia externa y servicio solicitante). | ||
| 1184 | |||
| 1185 | (% style="font-family: sans-serif; font-size: 14px; font-style: normal; font-weight: normal; text-align: start;" %) | ||
| 1186 | (% style="font-size: 14px; font-weight: 700;" %)Parámetros de entrada | ||
| 1187 | |||
| 1188 | {{code}} | ||
| 1189 | enviarSMS(List<GNRMSGMensajeDTO> notificaciones) | ||
| 1190 | {{/code}} | ||
| 1191 | |||
| 1192 | (% style="font-family: sans-serif; font-size: 14px; font-style: normal; font-weight: normal; text-align: start;" %) | ||
| 1193 | (% style="font-size: 14px; font-weight: 700;" %)Datos de salida | ||
| 1194 | |||
| 1195 | {{code}} | ||
| 1196 | List<GNRMSGMensajeCreadoDTO> | ||
| 1197 | {{/code}} | ||
| 1198 | |||
| 1199 | (% style="font-family: sans-serif; font-style: normal; text-align: start;" %) | ||
| 1200 | == (% style="font-size: 22.54px;" %)Método de consulta del estado los SMS generados (%%) == | ||
| 1201 | |||
| 1202 | (% style="font-family: sans-serif; font-size: 14px; font-style: normal; font-weight: normal; text-align: start;" %) | ||
| 1203 | Se define el método "consultarEstadoSMS" que consulta el estado de envío y entrega de los SMS generados. Para realizar la consulta hay que indicar el servicio que ha generado las notificaciones y se pueden pasar como parámetros una lista de destinatarios, una lista de referencias externas, una fecha de creación a partir de la cuál se quiere consultar y una fecha de creación máxima hasta la que se quiere consultar. Devuelve una lista de objetos con el detalle, incluyendo la información de envío y entrega, de cada SMS filtrado por los parámetros de entrada. | ||
| 1204 | |||
| 1205 | (% style="font-family: sans-serif; font-size: 14px; font-style: normal; font-weight: normal; text-align: start;" %) | ||
| 1206 | (% style="font-size: 14px; font-weight: 700;" %)Parámetros de entrada | ||
| 1207 | |||
| 1208 | {{code}} | ||
| 1209 | consultarEstadoSMS(List<String> destino, List<String> refExternas, Date fechaInicial, Date fechaFinal, String servicio) | ||
| 1210 | {{/code}} | ||
| 1211 | |||
| 1212 | (% style="font-family: sans-serif; font-size: 14px; font-style: normal; font-weight: normal; text-align: start;" %) | ||
| 1213 | (% style="font-size: 14px; font-weight: 700;" %)Datos de salida | ||
| 1214 | |||
| 1215 | {{code}} | ||
| 1216 | List<GNRMSGNotificacionDetalleDTO> | ||
| 1217 | {{/code}} | ||
| 1218 | |||
| 1219 | (% style="font-family: sans-serif; font-style: normal; text-align: start;" %) | ||
| 1220 | == (% style="font-size: 22.54px;" %)Método de búsqueda de un SMS generado(%%) == | ||
| 1221 | |||
| 1222 | (% style="font-family: sans-serif; font-size: 14px; font-style: normal; font-weight: normal; text-align: start;" %) | ||
| 1223 | Se define el método "buscarSMS" al que se le pasa como parámetro el identificador del SMS generado por Educa y devuelve (% style="font-family: sans-serif; font-size: 14px; font-style: normal; font-weight: normal; text-align: start;" %)el detalle del SMS, incluyendo la información de envío y entrega(%%). | ||
| 1224 | |||
| 1225 | (% style="font-family: sans-serif; font-size: 14px; font-style: normal; font-weight: normal; text-align: start;" %) | ||
| 1226 | (% style="font-size: 14px; font-weight: 700;" %)Parámetros de entrada | ||
| 1227 | |||
| 1228 | {{code}} | ||
| 1229 | buscarSMS(String idMensaje) | ||
| 1230 | {{/code}} | ||
| 1231 | |||
| 1232 | (% style="font-family: sans-serif; font-size: 14px; font-style: normal; font-weight: normal; text-align: start;" %) | ||
| 1233 | (% style="font-size: 14px; font-weight: 700;" %)Datos de salida | ||
| 1234 | |||
| 1235 | {{code}} | ||
| 1236 | GNRMSGNotificacionDetalleDTO | ||
| 1237 | {{/code}} | ||
| 1238 | |||
| 1239 | (% style="font-family: sans-serif; font-style: normal; text-align: start;" %) | ||
| 1240 | == (% style="font-size: 22.54px;" %)Más información(%%) == | ||
| 1241 | |||
| 1242 | (% style="font-family: sans-serif; font-size: 14px; font-style: normal; font-weight: normal; text-align: start;" %) | ||
| 1243 | * [[WSDL>>https://educages.navarra.es/Educa/services/gnr/msg/EnvioNotificacionesWS?wsdl||style="font-size: 14px;"]] | ||
| 1244 | * [[Documentación detallada>>http://educadev.educacion.navarra.es/api/MSGEnvioNotificaciones/||style="font-size: 14px;"]] | ||
| 1245 | |||
| 1246 | = SERVICIO DE CONSULTA DE PROVEEDORES (Censo genérico) = | ||
| 1247 | |||
| 1248 | == Objetivo == | ||
| 1249 | |||
| 1250 | Servicio de consulta que proporciona información de proveedores utilizados por el Gobierno de Navarra. Imita la funcionalidad del servicio equivalente de la Junta de Andalucía para dar soporte a //Ecoeduca//. | ||
| 1251 | |||
| 1252 | == Fuente de los datos == | ||
| 1253 | |||
| 1254 | Los datos de obtienen de un servicio al efecto proporcionado por el SAP además de entradas manuales introducidas por el Servicio de Gestión Económica del Departamento de Educación. | ||
| 1255 | |||
| 1256 | Almacena las entradas para poder funcionar aunque el servicio del SAP no esté en línea. | ||
| 1257 | |||
| 1258 | == Autentificación == | ||
| 1259 | |||
| 1260 | Anónima. | ||
| 1261 | |||
| 1262 | == Métodos == | ||
| 1263 | |||
| 1264 | === obtieneDatosCliente === | ||
| 1265 | |||
| 1266 | Devuelve los datos de un proveedor cuyo NIF se pasa como parámetro. | ||
| 1267 | |||
| 1268 | **Parámetros de entrada** | ||
| 1269 | |||
| 1270 | {{code language="java"}} | ||
| 1271 | obtieneDatosCliente(String nombreAplicacion,String nifSolicitante,String nombreSolicitante, String nifAconsultar) | ||
| 1272 | {{/code}} | ||
| 1273 | |||
| 1274 | De todos los parámetros pasados, sólo se utiliza nifAconsultar, el resto se mantiene por compatibilidad con el formato de Andalucía. | ||
| 1275 | |||
| 1276 | **Datos de salida** | ||
| 1277 | |||
| 1278 | {{code language="java"}} | ||
| 1279 | DatosCliente | ||
| 1280 | {{/code}} | ||
| 1281 | |||
| 1282 | |||
| 1283 | **Ejemplo de uso** | ||
| 1284 | {{code language="xml"}}<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:cen="http://es/juntadeandalucia/economiayhacienda/serviciosWeb/censoGenerico"> | ||
| 1285 | <soapenv:Header/> | ||
| 1286 | <soapenv:Body> | ||
| 1287 | <cen:obtieneDatosCliente> | ||
| 1288 | <nombreAplicacion></nombreAplicacion> | ||
| 1289 | <nifSolicitante></nifSolicitante> | ||
| 1290 | <nombreSolicitante></nombreSolicitante> | ||
| 1291 | <nifAconsultar>A20002572</nifAconsultar> | ||
| 1292 | </cen:obtieneDatosCliente> | ||
| 1293 | </soapenv:Body> | ||
| 1294 | </soapenv:Envelope>{{/code}} | ||
| 1295 | |||
| 1296 | **Respuesta** | ||
| 1297 | {{code language="xml"}}<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> | ||
| 1298 | <soap:Body> | ||
| 1299 | <ns1:obtieneDatosClienteResponse xmlns:ns1="http://es/juntadeandalucia/economiayhacienda/serviciosWeb/censoGenerico"> | ||
| 1300 | <obtieneDatosClienteReturn> | ||
| 1301 | <item> | ||
| 1302 | <codigoPostal>20140</codigoPostal> | ||
| 1303 | <localidad>ANDOAIN</localidad> | ||
| 1304 | <nifCliente>A20002572</nifCliente> | ||
| 1305 | <nombreCliente>PAPELERA DEL LEIZARAN SA</nombreCliente> | ||
| 1306 | <pais>724</pais> | ||
| 1307 | <provincia>20</provincia> | ||
| 1308 | </item> | ||
| 1309 | </obtieneDatosClienteReturn> | ||
| 1310 | </ns1:obtieneDatosClienteResponse> | ||
| 1311 | </soap:Body> | ||
| 1312 | </soap:Envelope>{{/code}} | ||
| 1313 | |||
| 1314 | === obtieneTodosLosClientes === | ||
| 1315 | |||
| 1316 | Devuelve los datos de varios proveedores cuyos NIFs se pasan como parámetro (Lista). | ||
| 1317 | |||
| 1318 | **Parámetros de entrada** | ||
| 1319 | |||
| 1320 | {{code language="java"}} | ||
| 1321 | obtieneDatosCliente(String nombreAplicacion,String nifSolicitante,String nombreSolicitante, List<item> nifs) | ||
| 1322 | {{/code}} | ||
| 1323 | |||
| 1324 | De todos los parámetros pasados, sólo se utiliza nifAconsultar, el resto se mantiene por compatibilidad con el formato de Andalucía. | ||
| 1325 | |||
| 1326 | **Datos de salida** | ||
| 1327 | |||
| 1328 | {{code language="java"}} | ||
| 1329 | List<DatosCliente> | ||
| 1330 | {{/code}} | ||
| 1331 | |||
| 1332 | |||
| 1333 | **Ejemplo de uso** | ||
| 1334 | |||
| 1335 | {{code language="xml"}} | ||
| 1336 | <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:cen="http://es/juntadeandalucia/economiayhacienda/serviciosWeb/censoGenerico"> | ||
| 1337 | <soapenv:Header/> | ||
| 1338 | <soapenv:Body> | ||
| 1339 | <cen:obtieneTodosLosClientes> | ||
| 1340 | <nombreAplicacion>a</nombreAplicacion> | ||
| 1341 | <nifSolicitante>b</nifSolicitante> | ||
| 1342 | <nombreSolicitante>b</nombreSolicitante> | ||
| 1343 | <nifs> | ||
| 1344 | <!--Zero or more repetitions:--> | ||
| 1345 | <item>B61503355</item> | ||
| 1346 | <item>A01020080</item> | ||
| 1347 | </nifs> | ||
| 1348 | </cen:obtieneTodosLosClientes> | ||
| 1349 | </soapenv:Body> | ||
| 1350 | </soapenv:Envelope> | ||
| 1351 | {{/code}} | ||
| 1352 | |||
| 1353 | **Respuesta** | ||
| 1354 | |||
| 1355 | {{code language="xml"}} | ||
| 1356 | <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> | ||
| 1357 | <soap:Body> | ||
| 1358 | <ns1:obtieneTodosLosClientesResponse xmlns:ns1="http://es/juntadeandalucia/economiayhacienda/serviciosWeb/censoGenerico"> | ||
| 1359 | <obtieneTodosLosClientesReturn xsi:type="ns3:DatosClienteArray" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:ns3="http://es/juntadeandalucia/economiayhacienda/serviciosWeb/censoGenerico"> | ||
| 1360 | <item> | ||
| 1361 | <codigoPostal>01010</codigoPostal> | ||
| 1362 | <localidad>VITORIA</localidad> | ||
| 1363 | <nifCliente>A01020080</nifCliente> | ||
| 1364 | <nombreCliente>AUTOBUSES HERMANOS ARRIAGA SA</nombreCliente> | ||
| 1365 | <pais>724</pais> | ||
| 1366 | <provincia>01</provincia> | ||
| 1367 | </item> | ||
| 1368 | <item> | ||
| 1369 | <codigoPostal>08174</codigoPostal> | ||
| 1370 | <fax>935834340</fax> | ||
| 1371 | <localidad>SANT CUGAT DEL VALLES</localidad> | ||
| 1372 | <nifCliente>B61503355</nifCliente> | ||
| 1373 | <nombreCliente>ROCHE DIAGNOSTICS SL</nombreCliente> | ||
| 1374 | <pais>724</pais> | ||
| 1375 | <provincia>08</provincia> | ||
| 1376 | <telefono>935834000</telefono> | ||
| 1377 | </item> | ||
| 1378 | </obtieneTodosLosClientesReturn> | ||
| 1379 | </ns1:obtieneTodosLosClientesResponse> | ||
| 1380 | </soap:Body> | ||
| 1381 | </soap:Envelope> | ||
| 1382 | {{/code}} | ||
| 1383 | |||
| 1384 | == Estructura del DTO de respuesta "DatosCliente" == | ||
| 1385 | |||
| 1386 | {{code languaje="java"}} | ||
| 1387 | @XmlAccessorType(XmlAccessType.FIELD) | ||
| 1388 | @XmlType(name = "DatosCliente", propOrder = { | ||
| 1389 | "calificadorNumeroVia", | ||
| 1390 | "codIneMunicipio", | ||
| 1391 | "codigoPostal", | ||
| 1392 | "complentoVia", | ||
| 1393 | "descMunicipio", | ||
| 1394 | "direccionEmail", | ||
| 1395 | "escalera", | ||
| 1396 | "fax", | ||
| 1397 | "letraVia", | ||
| 1398 | "localidad", | ||
| 1399 | "municipio", | ||
| 1400 | "nifCliente", | ||
| 1401 | "nombreCliente", | ||
| 1402 | "nombreVia", | ||
| 1403 | "numeroVia", | ||
| 1404 | "pais", | ||
| 1405 | "piso", | ||
| 1406 | "portal", | ||
| 1407 | "provincia", | ||
| 1408 | "puerta", | ||
| 1409 | "telefono", | ||
| 1410 | "tipoNumeracionVia", | ||
| 1411 | "tipoVia" }) | ||
| 1412 | {{/code}} | ||
| 1413 | |||
| 1414 | |||
| 1415 | (% style="font-family: sans-serif; font-size: 14px; font-style: normal; font-weight: normal; text-align: start;" %) | ||
| 1416 | * [[WSDL>>https://educages.navarra.es/Educa/services/eco/ProveedoresWS?wsdl||style="font-size: 14px;"]] | ||
| 1417 | ))) | ||
| 1418 | |||
| 1419 | = SERVICIO DE PLAN DE ESTUDIOS = | ||
| 1420 | |||
| 1421 | == Objetivos == | ||
| 1422 | |||
| 1423 | Proporcionar la organización del plan de estudios en Educa. | ||
| 1424 | |||
| 1425 | == WSDL e información de tallada de los métodos y DTOs == | ||
| 1426 | |||
| 1427 | //URL WSDL: [[https:~~/~~/educages.navarra.es/Educa/services/pe/PEPlanEstudiosWS?wsdl>>https://educages.navarra.es/Educa/services/pe/PEPlanEstudiosWS?wsdl]]// | ||
| 1428 | //URL Información detallada: [[http://educadev.educacion.navarra.es/api/PEPlanEstudios/service_ns0_PEPlanEstudiosWSService.html]]// |