Declaración

registrar_grupo (nombre, descripcion, opcional estado, id_tipo_grupo, opcional id_grupo, opcional id_curso_externo, opcional fecha_inicio_grupo, opcional fecha_finalizacion_grupo)


El método crea un grupo con el nombre y la descripción indicados. Se toman los valores por defecto de un grupo para todos los campos no especificados, junto con los valores por defecto de secciones, perfiles y permisos para el tipo de grupo creado. Se establece la fecha de creación como la fecha del día.


Parámetros:

id_grupo

Opcional.

Si se indica un id_grupo, se intentará crear el grupo con el mismo. En caso de que dicho id_grupo exista se informa del error.

Es un entero positivo (máximo valor 4294967295)

nombre

Requerido.

Es un texto de 255 caracteres máximo.

descripcion

Opcional.

Es un texto de 250 caracteres máximo.

estado

Opcional.

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

Id_curso_externo

Opcional.

Es un texto que asocia al grupo a crear con un curso externo. Texto de 16 caracteres máximo.

fecha_inicio_grupo

Opcional.

Se indica que el grupo estará abierto desde esa fecha.

fecha_finalizacion_grupo

Opcional.

Se indica que el grupo estará cerrado desde esa fecha.

Nota: el parámetro id_tipo_grupo no es necesario y no debería utilizarse a partir de la versión 9. Si ya existe deberá siempre enviar el valor “7”. Si esto no se cumple se devolverá el error TipoGrupoInvalido.


Excepciones:

Educativa::Aula::Error::CreateGrupo("Administracion bloqueada")

Ocurre si la administración de la plataforma se encuentra bloqueada

Educativa::Error::MissingParameter("nombre")

Ocurre cuando no se ingresa el atributo ‘nombre’

Educativa::Error::MissingParameter("descripción")

Ocurre cuando no se ingresa el atributo "descripción"

Educativa::Aula::Error::CreateGrupo ("Error creando el grupo: el nombre del curso ('$args{nombre}') supera los 255 caracteres")

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

Educativa::Aula::Error::CreateGrupo("id existente")

Ocurre cuando ya existe un grupo con el "id_grupo" ingresado

Educativa::Aula::Error::TipoGrupoInvalido

Ocurre cuando el tipo de grupo ingresado no corresponde a uno de los tipos de grupos definidos en la plataforma

Educativa::Aula::Error::GrupoRelacionExternaInvalida

Ocurre cuando el "id_curso_externo" ingresado supera los 16 caracteres

Educativa::Aula::Error::GrupoDescripcionInvalida

Ocurre cuando la "descripción" ingresada supera los 250 caracteres

Educativa::Aula::Error::IdGrupoInvalido

Ocurre cuando el "id_grupo" ingresado no es integer o es superior al numero mayor permitido

Educativa::Aula::Error::FechaFormatoInvalido

Ocurre cuando se ingresa una fecha con un formato distinto a aaaa-mm-dd

Educativa::Aula::Error::FechaInvalida

Ocurre cuando se ingresa 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: id_grupo, nombre del grupo creado. (el nombre se retorna porque puede haberse cambiado debido a que ya existía un grupo con el nombre_grupo especificado).


Ejemplo

SOAP Request

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

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

  <soapenv:Header/>

  <soapenv:Body>

    <aula:registrar_grupo>

       <aula:nombre>epistemologia 1</aula:nombre>

       <aula:descripcion>curso sobre epistemología</aula:descripcion>

       <aula:estado>A</aula:estado>

       <aula:id_grupo></aula:id_grupo>

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

  </soapenv:Body>

</soapenv:Envelope>


SOAP Response

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

       <id_grupo>538</id_grupo>

       <nombre>epistemologia 1</nombre>

    </registrar_grupo_response>

En esta respuesta, podemos observar que:

- Se creó un grupo con id_grupo 538.

- Su nombre es epistemologia 1. Su estado es activado.

- Todos los parámetros no especificados toman el valor por defecto del aula.