establecer_clasificacion_grupos

establecer_clasificacion_grupos (1{id_grupo as Integer, id_campo as Integer, id_valor as Integer}n)

El metódo permite asignar un valor, para cada campo de clasificación, en n grupos

Devuelve: [true|false]

  • estado 'true' si pudo asignar correctamente el valor al campo indicado en un grupo: por cada 3-tupla de datos que se pudo procesar correctamente.
  • estado 'false' si no pudo asignar correctamente el valor al campo indicado en un grupo: por cada 3-tupla de datos que no se pudo procesar correctamente. En este caso se muestra también el error correspondiente.


Funcionamiento

  • Para asignar un valor, a un campo de clasificación, de un grupo, debemos correr el WS especificando el 'id_grupo', el 'id_campo' y el 'id_valor' correspondiente.
  • La estructura correspondiente(aula:grupo_campo_valor) debe ser repetida n veces según la cantidad de 3-tuplas grupo_campo_valor que se quieran procesar.
  • El campo de clasificación ya debe existir en la plataforma.
  • El valor ya debe existir en la plataforma, definido para el campo en cuestión.


Ejemplo de Respuesta

Ejemplo de respuesta de la llamada establecer_clasificacion_grupos, con un grupo y dos campos-valores, que indica asignar los valores , en los campos del grupo especificado.

  • Llamada:

    <aula:establecer_clasificacion_grupos>
        <aula:establecer_clasificacion_grupos>
            <aula:id_grupo>21</aula:id_grupo>
            <aula:id_campo>1</aula:id_campo>
            <aula:id_valor>2</aula:id_valor>
        </aula:establecer_clasificacion_grupos>
        <aula:establecer_clasificacion_grupos>
            <aula:id_grupo>21</aula:id_grupo>
            <aula:id_campo>1</aula:id_campo>
            <aula:id_valor>3</aula:id_valor>
        </aula:establecer_clasificacion_grupos>
    </aula:establecer_clasificacion_grupos>


  • Respuesta:

    <establecer_clasificacion_grupos_response xmlns="urn:Educativa/Aula/">
       <grupo_campo_valor>
          <aula:id_grupo>21</aula:id_grupo>
          <aula:id_campo>1</aula:id_campo>
          <aula:id_valor>2</aula:id_valor>
          <estado>true</estado>
      </grupo_campo_valor>
      <grupo_campo_valor>
          <aula:id_grupo>21</aula:id_grupo>
          <aula:id_campo>1</aula:id_campo>
          <aula:id_valor>3</aula:id_valor>
          <estado>false</estado>
          <error>
            <error_code>Educativa::Aula::Error::ValorInvalido</error_code>
            <error_string>No existe el valor ingresado para el campo ingresado</error_string>
          </error>
       </grupo_campo_valor>
    </establecer_clasificacion_grupos_response>

Tanto el mensaje indicando que la asignación fue realizada correctamente, como el mensaje por error de validación, deben presentarse junto con el id_grupo, el id_campo y el valor ingresados correspondientes. Es decir, en la salida debe mostrarse un bloque por cada 3-tupla de datos ingresada junto con un mensaje indicando la situación de cada una.


Errores de validación

  • Educativa::Aula::Error::IdGrupoInvalido - ocurre cuando el 'id_grupo' ingresado no es integer.
  • Educativa::Aula::Error::GrupoInexistente - ocurre cuando el 'id_grupo' ingresado no existe en la plataforma.
  • Educativa::Aula::Error::GrupoAgrupado - ocurre cuando el grupo con id 'id_grupo' pertenece a una agrupación.
  • Educativa::Aula::Error::CampoInexistente - ocurre cuando el 'id_campo' ingresado no existe en la plataforma.
  • Educativa::Aula::Error::ValorInvalido - ocurre cuando el 'id_valor' ingresado no existe definido para el campo en la plataforma.