Asignar valores clasificación


asignar_valores_clasificacion (

 1{

  nombre_clasificacion as String,

    1{

     nombre_valor as String,

    }m

 }n

)  


El metódo permite crear n campos de clasificación de aula, con m valores para cada uno de ellos.



Devuelve: 1{nombre_clasificacion + id_clasificacion + 1{id_valor + nombre_valor}n}n


Funcionamiento


  • Para crear un nuevo campo de clasificación de aula junto con sus valores, debemos correr el ws especificando el nombre_clasificacion y los nombre_valor_i para cada valor correspondiente a cada campo.


    • La estructura correspondiente a la clasificación, compuesta por el nombre de la misma y los valores debe ser repetida n veces según la cantidad de clasificaciones que se quieran crear/modificar.
    • La estructura correspondiente a los valores de una clasificación, compuesta por el nombre del valor, debe ser repetida m veces según la cantidad de valores que se quieran crear para la clasificación en cuestión.


  • Si el campo de clasificación especificado no existe en la plataforma, se crea junto con sus valores.
  • Si el campo de clasificación especificado ya existe en la plataforma, se crean los nuevos valores especificados para el mismo.
    • Si el valor especificado ya existe previamente no arroja error, simplemente devuelve su id y su nombre.


Ejemplo de Respuesta


Ejemplo de respuesta de la llamada asignar_valores_clasificacion, con dos clasificaciones y dos valores para cada una de ellas.


  • Llamada:

     <aula:asignar_valores_clasificacion>
         <aula:valores_clasificacion>
             <aula:nombre_clasificacion>turno</aula:nombre_clasificacion>
                 <aula:valores>
                     <aula:nombre_valor>mañana</aula:nombre_valor>
                     <aula:nombre_valor>tarde</aula:nombre_valor>
                 <aula:valores>
         </aula:valores_clasificacion>
         <aula:valores_clasificacion>
             <aula:nombre_clasificacion>dificultad</aula:nombre_clasificacion>
                 <aula:valores>
                     <aula:nombre_valor>baja</aula:nombre_valor>
                     <aula:nombre_valor>alta</aula:nombre_valor>
                 <aula:valores>
         </aula:valores_clasificacion>
     </aula:asignar_valores_clasificacion>


  • Respuesta:


     <valores_clasificacion_response>
           <nombre_clasificacion>turno</nombre_clasificacion>
           <id_clasificacion>1</id_clasificacion>
           <estado>true</estado>
           <valores>
               <valor>
                   <nombre_valor>mañana</nombre_valor>
                   <id_valor>1</id_valor>
                   <estado>true</estado>
               </valor>
               <valor>
                   <nombre_valor>tarde</nombre_valor>
                   <id_valor>2</id_valor>
                   <estado>true</estado>
               </valor>
           </valores>
        </valores_clasificacion_response>
        <valores_clasificacion_response>
           <nombre_clasificacion>dificultad</nombre_clasificacion>
           <id_clasificacion>2</id_clasificacion>
           <estado>true</estado>
           <valores>
               <valor>
                   <nombre_valor>baja</nombre_valor>
                   <id_valor>3</id_valor>
                   <estado>true</estado>
               </valor>
               <valor>
                   <nombre_valor>alta</nombre_valor>
                   <id_valor>4</id_valor>
                   <estado>true</estado>
               </valor>              
           </valores>
        </valores_clasificacion_response>
     </asignar_valores_clasificacion_response>

     

           

  • Para cada nombre_clasificacion especificada se devuelve el nombre y el id, lo mismo para cada nombre_valor especificado en cada clasificación.


  • En el caso particular que el nombre_clasificación especificado ya exista, se devolverá el id correspondiente y se procederá a asociar los nuevos valores especificados a la misma.


  • En el caso particular que el nombre_valor clasificado especificado ya exista, se devolverá el id correspondiente.


  • Importante tener en cuenta que si la clasificación ya existía previamente, al devolver el listado de los valores, solo devolverá los valores especificados en el llamado (hayan existido previamente o no) y no la totalidad de los mismos.


Errores de validación


  • Educativa::Aula::Error::NoSePasaronClasificaciones: Ocurre cuando no se pasa ninguna clasificación.
  • Educativa::Aula::Error::NombreClasificacionVacio: Ocurre cuando no se pasa un nombre de clasificación vacío.
  • Educativa::Aula::Error::NombreClasificacionMuyLargo: Ocurre cuando no se pasa un nombre de clasificación mayor a 255 caracteres.
  • Educativa::Aula::Error::NombreClasificacionMuyLargo: Ocurre cuando no se pasa un nombre de clasificación mayor a 255 caracteres.
  • Educativa::Aula::Error::NoSePasaronValoresClasificaciones: ocurre cuando no se especifica ningún valor para la clasificación.
  • Educativa::Aula::Error::NombreValorVacio: ocurre cuando se pasa un valor con nombre vacío.
  • Educativa::Aula::Error::NombreValorMuyLargo: ocurre cuando no se pasa un nombre de valor mayor a 255 caracteres.