Versions Compared

Version Old Version 1 New Version Current
Changes made by

Samara Carmona. CCORP

Tania Romo

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Import Link Fixer


Panel
titleEstado

Status
colourGreen
titleEn Uso

Info
titleEn 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 datos actualizas el alias de grupos asociados a un colegio para un ciclo específico en la BDC.

Situación actual

Descripción
Crea

Actualiza el alias para un Grupo en un Colegio para un Ciclo y Grado en específico.

Referencia SIFExtensión de SIF 3.0.1
Entidad BDCGrupo
Entidad SIF

group (Lista).

Tipo de Petición
POST
PUT
Parámetros o Campos


CamposDescripciónReglas de negocio
school
  • (Obligatorio) Id del Colegio correspondiente
  • Si no ese especifica el parámetro, como es obligatorio devuelve:

    • <code>400</code>
      <message>Debe especificar el identificador del colegio.</message>

  • En caso de
que ya exista el grupo para el colegio en el ciclo escolar y grado especificado
  • no existir el identificador del colegio, devuelve:

    • <code>404</code>
      <message>No se encontraron datos con los parámetros especificados.</message>

  • En caso que el usuario que invoca el servicio (generatorId) no tenga permisos en la empresa donde esta relacionado el colegio, devuelve:
    <code>409<

      • <code>403</code>

    <message>Ya existe el grupo en el colegio para el ciclo especificado

      • <message>No tiene permiso para insertar o modificar en la empresa a la que pertenece el colegio.</message>

    schoolYear
    • (Obligatorio) Año escolar que se consulta 
    • Si no se especifica el parámetro, como es obligatorio devuelve:
      •  <code>400</code>
        <message>Debe especificar un ciclo para consultar.</message>
    • En caso de que el colegio no exista en el ciclo escolar, devuelve:

      • <code>409</code>
        <message>Ocurrió un error al guardar la información del ciclo.</message>

    grade

    • (Obligatorio) Id del grado para el que se quiere crear el grupo. Ver maestro de  Grados y Niveles.
       
    •  Si no se especifica el parámetro, como es obligatorio devuelve:
      • <code>400</code>
        <message>Debe especificar un grado.</message>
    • En caso de que el grado especificado no corresponda con el nivel del colegio o no exista,devuelve:
      • <code>409</code>
        <message>Ocurrió un error al guardar la información del ciclo.</message>
    group
    • (Obligatorio) Id del grupo que se quiere crear. Ver maestro de Grupos
    •  Si no se especifica el parámetro, como es obligatorio devuelve:

      • <code>400</code>
        <message>Debe especificar un grupo.</message>

    • En caso de que el grupo no exista,devuelve:
      • <code>409</code>
        <message>Ocurrió un error al guardar la información del ciclo.</message>
    alias
    • (Obligatorio) Nombre especifico con el cual se puede indentificar al grupo.
    • Acepta como valor "".
    •  Si no se especifica el parámetro, devuelve:

      • <code>400</code>
        <message>Debe especificar un grupo.</message>

    sessionId
    • (Opcional) Id del ciclo escolar dónde se desea modificar. Ver maestro de Ciclo Escolar
    		El parámetro se adiciona para aquellas empresas que cuentan con ciclos escolares semestrales


    Ejemplo de llamada o de formulario
    http

    https://

    desenv

    homol.uno-internacional.com/sif/unoSchool/group;contextId={"school":

    1135

    1140, "schoolYear":

    2016

    2018, "grade":

    27

    19, "group":

    18}Respuesta<createResponse>
    <creates>
    <create id="00000027-0000-1000-0000-000000000018" statusCode="200" ></create>
    </creates>
    </createResponse>

    17, "alias":"Grupo B"}

    Respuesta

    N/A 204

    ¿Quién lo utiliza y cómo?