You are viewing an old version of this page. View the current version.
Compare with Current
View Page History
« Previous
Version 11
Next »
Este servicio será utilizado por las aplicaciones que necesiten insertar asociaciones de Alumno-Grado-Grupo en la BDC.
Situación actual
Descripción | Inserta una entidad StudentGroupAssociation (Alumno-Grado-Grupo), para un Colegio en un Ciclo en específico. |
Referencia SIF | Extensión de SIF 3.0.1 |
Tipo de Petición | POST |
Parámetros o Campos | Campos en llamada | Descripción | Reglas de negocio |
---|
school | - (Obligatorio) Id del Colegio correspondiente
| - El identificador del colegio debe existir, en caso de no ser válido devuelve:
- Si no se especifica el parámetro, como es obligatorio devuelve:
- <code>400</code>
<message>Debe especificar el identificador del colegio.</message>
| schoolYear | - (Obligatorio) Año escolar que se consulta
| - El colegio debe existir en el año escolar, en caso de no ser válido devuelve:
- Si no se especifica el parámetro, como es obligatorio devuelve:
- <code>400</code>
<message>Debe especificar un ciclo para consultar.</message>
|
Campos en XML payload | Descripción | Reglas de negocio |
---|
unoStudentRefId | - (Obligatorio) alumno.alumno_id
| - En caso que no se especifique correctamente el tag del grado devuelve:
- <code>400</code>
<message>El xml del payload no se encuentra bien formado.</message>
- El identificador del alumno debe existir, en caso de no ser válido devuelve:
- El alumno debe tener relacionada una persona, en caso de no ser válido devuelve:
- <code>400</code>
<message>Ocurrió un error al guardar la información personal.</message>
| gradeRefId | | - En caso que no se especifique correctamente el tag del grado devuelve:
- <code>400</code>
<message>El xml del payload no se encuentra bien formado.</message>
- El identificador del grado debe existir, en caso de no ser válido devuelve:
| groupRefId | - (Obligatorio) grupo_id. Ver maestro de Grupos.
| - En caso que no se especifique correctamente el tag del grupo devuelve:
- <code>400</code>
<message>El xml del payload no se encuentra bien formado.</message>
- El identificador del grupo debe existir, en caso de no ser válido devuelve:
|
|
Ejemplo de llamada o de formulario | http://desenv.uno-internacional.com/sif/studentGroupAssociation;contextId={"school":1135, "schoolYear":2014} |
XML payload | <studentGroupAssociation refId=""> <unoStudentRefId> 00000000-0000-1000-0000-000001696188 alumno.alumno_id (Identificador único en la BDC) </unoStudentRefId> <gradeRefId>00000000-0000-1000-0000-000000000026</gradeRefId> grado_id. Ver maestro de Grados y Niveles. <groupRefId>00000000-0000-1000-0000-000000000017</groupRefId> grupo_id. Ver maestro de Grupos. </studentGroupAssociation> |
Respuesta | <createResponse> <creates> <create id="00000017-0000-1000-0000-000001696188" alumno.alumno_id. statusCode="200" /> Se realizó exitosamente la inserción de la asociación StudentGroupAssociation (Alumno-Grado-Grupo). </creates> </createResponse> |
¿Quién lo utiliza y cómo? | |