Declaración

modificar_grupo (id_grupo, opcional nombre, opcional descripcion, opcional estado, opcional id_usuario_administrador, opcional id_idioma, opcional id_curso_externo, opcional fecha_inicio_grupo, opcional fecha_finalizacion_grupo)


El método modifica las características esenciales de un grupo. El único campo obligatorio es el id_grupo, el resto serían opcionales.


Parámetros:

id_grupo

Requerido.

Id_grupo del grupo a modificar.

nombre

Opcional.

Es un texto de 255 caracteres máximo.

descripción

Opcional.

Es un texto de 250 caracteres máximo.

estado

Opcional.

Si queremos desactivar el grupo, el parámetro "estado" debe ser 0, con cualquier otro valor para el parámetro "estado" el grupo será activo.

id_usuario_administrador

Opcional.

Usuario que sea webmaster o administrador en el grupo en cuestión.

id_curso_externo

Opcional.

Identificación del curso externo cuyo valor no debe superar los 16 caracteres. Para eliminar la relación que un grupo tiene con un curso externo, debemos pasar "id_curso_externo" = - .

fecha_inicio_grupo

Opcional.

Se indica que el grupo estará abierto desde esa fecha. El formato debe ser aaaa-mm-dd (si el campo está vacío, se borrará la fecha existente).

fecha_finalizacion_grupo

Opcional.

Se indica que el grupo estará cerrado desde esa fecha. El formato debe ser aaaa-mm-dd (si el campo está vacío, se borrará la fecha existente).


Excepciones:

Educativa::Error::MissingParameter

Ocurre cuando no se especifico "id_grupo"

Educativa::Aula::Error::GrupoInexistente

Ocurre cuando no existe el grupo con el "id_grupo" indicado

Educativa::Aula::Error::ModifyGrupo("Error modificando el grupo: el nombre del grupo ( '$args{nombre}' ) supera los 30 caracteres")

Ocurre cuando el nombre ingresado para el grupo supera los 255 caracteres

Educativa::Aula::Error::ModifyGrupo("Error modificando el grupo: la descripcion del grupo ( '$args{descripcion}' ) supera los 250 caracteres")

Ocurre cuando la descripción ingresada para el grupo supera los 250 caracteres

Educativa::Aula::Error::ModifyGrupo("Error modificando el grupo: el usuario ( '$args{id_administrador}' ) no puede ser administrador del grupo")

Ocurre cuando el usuario elegido como "administrador encargado en el manejo de mails" NO es webmaster o NO está definido como "administrador" para ese grupo.

Educativa::Aula::Error::ModifyGrupo("Error modificando el grupo: el usuario ( '$args{id_administrador}' ) no existe en el grupo")

Ocurre cuando el usuario elegido como "administrador encargado en el manejo de mails" NO existe en el grupo.

Educativa::Error::IdiomaInvalido

Ocurre cuando el idioma ingresado no corresponde a uno de los idiomas definidos en la plataforma.

Educativa::Aula::Error::GrupoRelacionExternaInvalida

Ocurre cuando el "id_curso_externo" ingresado supera los 16 caracteres

Educativa::Aula::Error::FechaFormatoInvalido

Ocurre al ingresar una fecha con un formato distinto a aaaa-mm-dd

Educativa::Aula::Error::FechaInvalida

Ocurre al ingresar una fecha no existente, ej: no existe dicho día para ese mes

Educativa::Aula::Error::RangoFechaInvalido

Ocurre cuando la fecha de finalización es anterior a la fecha de inicio


Devuelve: estado de la acción, true si se puede realizar la modificación. En el caso de que no se pueda realizar la modificación devolverá el error correspondiente.


Ejemplo

SOAP Request

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"

   xmlns:aula="urn:Educativa/Aula/">

  <soapenv:Header/>

  <soapenv:Body>

    <aula:modificar_grupo>

       <aula:id_grupo>71</aula:id_grupo>

       <aula:nombre>grupo renovado</aula:nombre>

       <aula:descripcion>este grupo ha sido renovado</aula:descripcion>

       <aula:estado>0</aula:estado>

       <aula:id_usuario_administrador>poxi_admin</aula:id_usuario_administrador>

       <aula:id_idioma></aula:id_idioma>

       <aula:id_curso_externo>-</aula:id_curso_externo>

       <aula:fecha_inicio_grupo>2015-02-03</aula:fecha_inicio_grupo>

       <aula:fecha_finalizacion_grupo>2015-11-04</aula:fecha_finalizacion_grupo>

     </aula:modificar_grupo>  

</soapenv:Body>

</soapenv:Envelope>


Obs: Si bien se indica desactivar el grupo (estado ‘0’) se hará caso omiso de este valor, ya que el estado final se verá determinado por las fechas.






SOAP Response

<modificar_grupo_response xmlns="urn:Educativa/Aula/">

       <estado>true</estado>

    </modificar_grupo_response>