Este método asocia usuarios, como alumnos, a uno o más departamentos.


HTTP request


POST https://<URL_EJECUTIVA>/restpub/



Content-Type


application/json;charset=utf-8



Ejemplo de request-content:


{
    "accion": "asociar_alumnos_escuelas",
    "data": 
        {
            "1": ["rgomez", "lbelucci", "mavila"],
            "2": ["eaguilera"],
            "3": ["kleavitt","froosevelt"]
        }
} 


Formato del request

El body del request debe estar codificado en JSON y ser un objeto con los siguientes atributos:


  • accion: Indica la acción del servicio web. Tipo: string


Se debe indicar el valor "asociar_alumnos_escuelas" para asociar usuarios a uno o más escuelas.


  • data: Datos de las escuelas junto a los usuarios a asociar. Tipo: object


El mismo está indexado por id de escuela y sus valores son listas de usuarios a asociar. Por cada escuelas (id), se debe especificar una lista con los nombres de usuario.



Respuesta

Se responderá un documento en formato JSON, el cual contará con los siguientes atributos:



status: Indica si la operación fue exitosa o hubo error mediante el uso de uno de los siguientes valores. Tipo: string

OK: Indica que el formato JSON es correcto, y la respuesta para cada departamento estará contenida en el array result

ERROR: En caso de que haya algún error en el formato JSON enviado o problemas de conexión.


error_mssg: Indicará la causa de que no se haya podido procesar el request. Tipo: string

Solo estará presente en caso de que el status sea ERROR.


result: En caso de que el status sea OK, se devueleve un array compuesto por objetos referidos a las escuelas a las que se intentó inscribir a los usuarios. Por cada escuela se presentan los siguientes campos:

    • nombre: nombre de la escuela
    • usuarios_total_asociados: cantidad total de usuarios asociados a la escuela
    • usuarios_no_asociados: lista de nombres de usuarios que no pudieron asociarse a la escuela. Si un usuario ya se encuentra asociado, aparece en este listado


Si la escuela no se encontró mediante el id, se devuelve el siguiente objeto; en vez del mencionado previamente:

    • error: Mensaje informando que la escuela con el id que se consultó no existe.