Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 16 Current »

Estado

EN USO

En Uso

Cuando un requisito de sistema software tenga el estado En Uso significa que está disponible para su uso.

 

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. Se valida que el colegio pertenezca al ciclo escolar, verificando consistencia entre los niveles del colegio y grados indicados en los parámetros. Antes de insertar la entidad Alumno-Grado-Grupo, se verifica que no exista para evitar duplicidad.

Referencia SIFExtensión de SIF 3.0.1
Tipo de PeticiónPOST
Parámetros o Campos
Campos en llamadaDescripciónReglas de negocio
school
  • (Obligatorio) Id del Colegio correspondiente
  • El identificador del colegio debe existir, en caso de no ser válido devuelve:
    •  <code>400</code>

      <message>El identificador propocionado no es válido.</message>

  • Si no se especifica el parámetro, como es obligatorio devuelve:
    •  <code>400</code>
      <message>Debe especificar el identificador del colegio.</message>
  • El colegio debe existir en el ciclo escolar que se especifica.
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:

    • <code>400</code>
      <message>El identificador propocionado no es válido</message>

  • 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 payloadDescripciónReglas 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:

    • <code>400</code>
      <message>>El identificador propocionado no es válido.</message>

  • 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:

      • <code>400</code>
        <message>>El identificador propocionado no es válido.</message>

 

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:

      • <code>400</code>
        <message>>El identificador propocionado no es válido.</message>

Ejemplo de llamada o de formulario

http://desenv.uno-internacional.com/sif/studentGroupAssociation;contextId={"school":1135, "schoolYear":2014}

Ejemplo 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?

 

  • No labels