...

• Si no hay paginación --> 200 (OK) + JSON
• Si hay paginación --> 206 (Partial Content) + JSON

Obtener

...

todos los cursos (v7)

Método: GET

URL:

• Obtener

...

• todos los cursos sin paginación: 
  
  • /admin/rest/administration/api/courses
  /id/{id}

...

• Obtener todos los cursos con paginación:
  
  • /admin/rest/administration/api/courses?startIndex={startIndex}&count={count}
• Obtener todas las convocatorias de un curso:
  
  • /admin/rest/administration/api/courses
  /externalid/{externalid}

...

• • ?parentId={parentId}
  • /admin/rest/administration/api/courses?parenExternaltId={parentExternalId}

Ejemplo: https://demo.central-lms.com/admin/rest/administration/api/courses/id/2514

Cabeceras

...

?startIndex=0&count=100

Parámetros

• startindex = índice inicial para la paginación (Integer, opcional)
• count = total de elementos a recuperar para la paginación (Integer, opcional)
• planId = Filtrar por cursos dentro del plan (Long, opcional).
• status = Filtrar por el estado del curso (Valores válidos: DRAFT, PUBLISHED, CLOSED) opcional.
• startDateFrom = Filtrar los cursos que empiecen después de la fecha proporcionada. (String, opcional). Si la cabecera NLC-datesFormat está con el valor milliseconds el valor será en milisegundos, en otro caso será en el formato: yyyy-MM-dd HH:mm:ss"

Campos devueltos en el Json

Curso, cada curso consta de los siguientes campos:

...

• NO --> Sin certificado
• PASSED --> Certificado disponible para los estudiantes tan pronto aprueben el curso
• FINISHED --> Certificado disponible para los estudiantes solamente después de la finalización del curso

...

• PUBLICATION_DATE --> La fecha de inicio será la fecha de publicación del curso
• MANUAL --> La fecha de inicio se establecerá de forma manual

...

• NONE --> Ninguna, el administrador finalizará el curso manualmente
• MANUAL --> La fecha de fin se establecerá de forma manual
• FIRST_ACCESS -> Fecha fin según el primer acceso del alumno

...

• Valores permitidos:
  
  • PASSED_MANDATORY_ACTIVITIES
  • MIN_SCORE

...

• AUTO_ENROLLMENT --> Auto inscripción
• ADMIN_ENROLLMENT --> Sólo los administradores pueden inscribir alumnos
• REQUEST_ENROLLMENT --> Solicitar inscripción

...

• INHERIT --> Heredada del curso
• MANUAL --> Se establecerá de forma manual

...

• id = Identificador de la categoría
  
• external_id = Identificador externo
  
• name = Nombre de la categoría
  
• code = Código de la categoría
  
• description = Descripción de la categoría

...

• extendedFieldName = Nombre del campo extendido
• extendedFieldValue = Valor del campo extendido

Validaciones

• No existe el curso Error 404 (Not Found)
• Error en la generación del Json --> Error 503 (Service Unavailable)
• Todo OK --> 200 (OK) + JSON

Obtener curso (v3)

Método: GET

URL:

Obtener por id:

• /admin/rest/administration/api/courses/id/{id}

Obtener por external id:

• /admin/rest/administration/api/courses/externalid/{externalid}

Ejemplo: https://demo.central-lms.com/admin/rest/administration/api/courses/id/2514

Cabeceras

• NLC-datesFormat. Opcional, valores permitidos:
  
  • milliseconds. Las fechas se devolverán en milisegundos
  • en otro caso se seguirá el formato de texto: "yyyy-MM-dd HH:mm:ss"

Campos devueltos en el Json

...

• .
• startDateTo = Filtrar los cursos que empiecen antes de la fecha proporcionada. (String, opcional). Si la cabecera NLC-datesFormat está con el valor milliseconds el valor será en milisegundos, en otro caso será en el formato: yyyy-MM-dd HH:mm:ss.
• endDateFrom = Filtrar los cursos que terminen después de la fecha proporcionada. (String, opcional). Si la cabecera NLC-datesFormat está con el valor milliseconds el valor será en milisegundos, en otro caso será en el formato: yyyy-MM-dd HH:mm:ss.
• endDateTo = Filtrar los cursos que terminen antes de la fecha proporcionada. (String, opcional). Si la cabecera NLC-datesFormat está con el valor milliseconds el valor será en milisegundos, en otro caso será en el formato: yyyy-MM-dd HH:mm:ss.
• creationDateFrom = Filtrar los cursos creados después de la fecha proporcionada. (String, opcional). Si la cabecera NLC-datesFormat está con el valor milliseconds el valor será en milisegundos, en otro caso será en el formato: yyyy-MM-dd HH:mm:ss.
• creationDateTo = Filtrar los cursos creados antes de la fecha proporcionada. (String, opcional). Si la cabecera NLC-datesFormat está con el valor milliseconds el valor será en milisegundos, en otro caso será en el formato: yyyy-MM-dd HH:mm:ss.
• modificationDateFrom = Filtrar los cursos modificados después de la fecha proporcionada. (String, opcional). Si la cabecera NLC-datesFormat está con el valor milliseconds el valor será en milisegundos, en otro caso será en el formato: yyyy-MM-dd HH:mm:ss.
• modificationDateTo = Filtrar los cursos creados antes de la fecha proporcionada. (String, opcional). Si la cabecera NLC-datesFormat está con el valor milliseconds el valor será en milisegundos, en otro caso será en el formato: yyyy-MM-dd HH:mm:ss.
• parentId = Filtrar por todos los cursos cuyo parentId es el proporcionado (Long, opcional)
• parentExternalId = Filtrar por todos los cursos cuyo curso padre tiene el external id proporcionado (String, opcional)

Cabeceras

• NLC-datesFormat. Opcional, valores permitidos:
  
  • milliseconds. Las fechas se devolverán en milisegundos
  • en otro caso se seguirá el formato de texto: "yyyy-MM-dd HH:mm:ss"

Campos devueltos en el Json

Listado de cursos, cada curso consta de los siguientes campos:

• parent = Campos concretos del curso padre. En caso de que el curso esté configurado para tener convocatorias, son los campos que comparten todas las convocatorias. Contiene los siguientes atributos:
• parentId = Identificador del curso padre
• parentExternal_id = Id externo del curso padre
• name = Nombre del curso padre
• description = Descripción del curso
• comments = Comentarios del curso
• objectives = Objetivos del curso
• issueCertificate = Expedir certificado
  
  • NO --> Sin certificado
  • PASSED --> Certificado disponible para los estudiantes tan pronto aprueben el curso
  • FINISHED --> Certificado disponible para los estudiantes solamente después de la finalización del curso
• sessionOrganization = Organización de acciones formativas
  
  • MANUAL --> Manual
  • AUTOMATIC --> Automática para actividades de auto-aprendizaje y manual para el resto
• evaluationType = Sistema de evaluación seleccionado
  
  • Valores permitidos:
    
    • PASSED_MANDATORY_ACTIVITIES
    • MIN_SCORE
• credits = Número de créditos
• optativeCredits = Número de créditos optativos
• percentageToPass = porcentaje mínimo para superar el curso
• hasForum = Valor true/false. Indica si tiene foro.
• hasMessage = Valor true/fallse. Indica si tiene mensajes.  
• clonedFromId = Identificador de curso que se clona 
• hasReminder = Activar recordatorio a usuarios que llevan un tiempo sin acceder
  
  • Valores permitidos: TRUE / FALSE
  • Valor por defecto: FALSE
• hasStartReminder = Activar recordatorios de la fecha de inicio del curso
  
  • Valores permitidos: TRUE / FALSE
  • Valor por defecto: FALSE
• hasEditions = El curso tiene habilitadas las convocatorias
  
  • Valores permitidos: TRUE / FALSE
  • Valor por defecto: FALSE
• recogniseEditions = Validación automática entre convocatorias
  
  • Valores permitidos: TRUE / FALSE
  • Valor por defecto: FALSE
• id = Identificador
• external_id = Id externo
• editionName = Nombre de la convocatoria
• startDateMode = Tipo de fecha de inicio
  
  • PUBLICATION_DATE --> La fecha de inicio será la fecha de publicación del curso
  • MANUAL --> La fecha de inicio se establecerá de forma manual
• startDate = Fecha estimada de inicio (UTC)
• endDateMode = Tipo fecha de fin 
  
  • NONE --> Ninguna, el administrador finalizará el curso manualmente
  • MANUAL --> La fecha de fin se establecerá de forma manual
  • FIRST_ACCESS -> Fecha fin según el primer acceso del alumno
• studentAvailableDays = Número de días tras el primero acceso que tiene el alumno disponible el curso (Integer, obligatorio si el modo es FIRST_ACCESS).
• endDate     = Fecha estimada de fin (UTC)
• status = Estado del curso
• moduleType = Tipo de módulo
  
• enrolmentPolicy = Política de inscripción
  
  • AUTO_ENROLLMENT --> Auto inscripción
  • ADMIN_ENROLLMENT --> Sólo los administradores pueden inscribir alumnos
  • REQUEST_ENROLLMENT --> Solicitar inscripción
• requestEnrolmentEndDateMode = Tipo de fecha de fin en solicitud de inscripción
  
  • INHERIT --> Heredada del curso
  • MANUAL --> Se establecerá de forma manual
• requestEnrolmentStartDate = Fecha de apertura de inscripciones (UTC)
• requestEnrolmentEndDate = Fecha de cierre de inscripciones (UTC)
• clonedFromId = Identificador de curso que se clona (Long) 
  
• capacity = Aforo máximo de la edición (Integer)
• avgRating = Valoración media (Double)
• rateable = Curso valorable por los alumnos o no valorable
  
  • Valores permitidos: 
    
    • NONE : no valorable
    • ONLY_ENROLMENTS : los alumnos inscritos pueden valorar el curso
  • Valor por defecto: NONE 
• categories = Lista de Categorías del curso
  
  • id = Identificador de la categoría
    
  • external_id = Identificador externo
    
  • name = Nombre de la categoría
    
  • code = Código de la categoría
    
  • description = Descripción de la categoría
• extendedFields = Campos extensibles en lista con clave extendedFieldName y valor extendedFieldValue
  
  • extendedFieldName = Nombre del campo extendido
  • extendedFieldValue = Valor del campo extendido
• collection = Nombre de la colección asociada al curso. Vacio si no está asociado a ninguna colección.
• hasLink = Valor true/false. Indica si tiene enlaces externos
• externalLinks= Lista de enlaces externos. Devuelve null si el curso no los tiene.
  
  • name = Nombre del enlace
  • urlLink = El propio enlace
• estimatedDuration = Duración estimada del curso (sumatorio de las duraciones de todas las actividades)

Validaciones

• Índices erróneos --> Error 416 (Requested Range Not Satisfiable) Usando paginación, ambos índices deben tener un valor
• No hay cursos --> Error 204 (No Content)
• Filtro por estado incorrecto –> Error 400 (Bad request).
• Filtro de fechas con formato incorrecto --> Error 400 (Bad request).
• Error en la generación del Json --> Error 503 (Service Unavailable)

Todo OK

• Si no hay paginación --> 200 (OK) + JSON
• Si hay paginación --> 206 (Partial Content) + JSON

Obtener curso (v1,v2)

Método: GET

URL:

Obtener por id:

• /admin/rest/administration/api/courses/id/{id}

Obtener por external id:

• /admin/rest/administration/api/courses/externalid/{externalid}

Ejemplo: https://demo.central-lms.com/admin/rest/administration/api/courses/id/2514

Cabeceras

• NLC-datesFormat. Opcional, valores permitidos:
  
  • milliseconds. Las fechas se devolverán en milisegundos
  • en otro caso se seguirá el formato de texto: "yyyy-MM-dd HH:mm:ss"

Campos devueltos en el Json

Curso, cada curso consta de los siguientes campos:

• id = Identificador
• external_id = Id externo
• name = Nombre del curso
• description = Descripción del curso
• comments = Comentarios del curso
• objectives = Objetivos del curso
• moduleType = Tipo de módulo
• issueCertificate = Expedir certificado
  
  • NO --> Sin certificado
  • PASSED --> Certificado disponible para los estudiantes tan pronto aprueben el curso
  • FINISHED --> Certificado disponible para los estudiantes solamente después de la finalización del curso
• startDateMode = Tipo de fecha de inicio
  
  • PUBLICATION_DATE --> La fecha de inicio será la fecha de publicación del curso
  • MANUAL --> La fecha de inicio se establecerá de forma manual
• startDate = Fecha estimada de inicio (UTC)
• endDateMode = Tipo fecha de fin
  
  • NONE --> Ninguna, el administrador finalizará el curso manualmente
  • MANUAL --> La fecha de fin se establecerá de forma manual
  • FIRST_ACCESS -> Fecha fin según el primer acceso del alumno
• studentAvailableDays = Número de días tras el primero acceso que tiene el alumno disponible el curso (Integer, obligatorio si el modo es FIRST_ACCESS).
• endDate     = Fecha estimada de fin (UTC)
• sessionOrganization = Organización de acciones formativas
  
  • MANUAL --> Manual
  • AUTOMATIC --> Automática para actividades de auto-aprendizaje y manual para el resto
    
    
• evaluationType = Sistema de evaluación seleccionado
  
  • Valores permitidos:
    
    • PASSED_MANDATORY_ACTIVITIES
    • MIN_SCORE
• credits = Número de créditos
• optativeCredits = Número de créditos optativos
• percentageToPass = porcentaje mínimo para superar el curso
• hasForum = Valor true/false. Indica si tiene foro.
• hasMessage = Valor true/fallse. Indica si tiene mensajes.  
• status = Estado del curso
• enrolmentPolicy = Política de inscripción
  
  • AUTO_ENROLLMENT --> Auto inscripción
  • ADMIN_ENROLLMENT --> Sólo los administradores pueden inscribir alumnos
  • REQUEST_ENROLLMENT --> Solicitar inscripción
• requestEnrolmentEndDateMode = Tipo de fecha de fin en solicitud de inscripción
  
  • INHERIT --> Heredada del curso
  • MANUAL --> Se establecerá de forma manual
• requestEnrolmentStartDate = Fecha de apertura de inscripciones (UTC)
• requestEnrolmentEndDate = Fecha de cierre de inscripciones (UTC)
• categories = Lista de Categorías del curso 
  
  • id = Identificador de la categoría
    
  • external_id = Identificador externo
    
  • name = Nombre de la categoría
    
  • code = Código de la categoría
    
  • description = Descripción de la categoría
• extendedFields = Campos extensibles en lista con clave extendedFieldName y valor extendedFieldValue
  
  • extendedFieldName = Nombre del campo extendido
  • extendedFieldValue = Valor del campo extendido

Validaciones

• No existe el curso Error 404 (Not Found)
• Error en la generación del Json --> Error 503 (Service Unavailable)
• Todo OK --> 200 (OK) + JSON

Obtener curso (v3)

Método: GET

URL:

Obtener por id:

• /admin/rest/administration/api/courses/id/{id}

Obtener por external id:

• /admin/rest/administration/api/courses/externalid/{externalid}

Ejemplo: https://demo.central-lms.com/admin/rest/administration/api/courses/id/2514

Cabeceras

• NLC-datesFormat. Opcional, valores permitidos:
  
  • milliseconds. Las fechas se devolverán en milisegundos
  • en otro caso se seguirá el formato de texto: "yyyy-MM-dd HH:mm:ss"

Campos devueltos en el Json

Curso, cada curso consta de los siguientes campos:

• id = Identificador
• external_id = Id externo
• name = Nombre del curso
• description = Descripción del curso
• comments = Comentarios del curso
• objectives = Objetivos del curso
• moduleType = Tipo de módulo
• issueCertificate = Expedir certificado
  
  • NO --> Sin certificado
  • PASSED --> Certificado disponible para los estudiantes tan pronto aprueben el curso
  • FINISHED --> Certificado disponible para los estudiantes solamente después de la finalización del curso
• startDateMode = Tipo de fecha de inicio
  
  • PUBLICATION_DATE --> La fecha de inicio será la fecha de publicación del curso
  • MANUAL --> La fecha de inicio se establecerá de forma manual
• startDate = Fecha estimada de inicio (UTC)
• endDateMode = Tipo fecha de fin
  
  • NONE --> Ninguna, el administrador finalizará el curso manualmente
  • MANUAL --> La fecha de fin se establecerá de forma manual
  • FIRST_ACCESS -> Fecha fin según el primer acceso del alumno
• studentAvailableDays = Número de días tras el primero acceso que tiene el alumno disponible el curso (Integer, obligatorio si el modo es FIRST_ACCESS).
• endDate     = Fecha estimada de fin (UTC)
• sessionOrganization = Organización de acciones formativas
  
  • MANUAL --> Manual
  • AUTOMATIC --> Automática para actividades de auto-aprendizaje y manual para el resto
    
    
• evaluationType = Sistema de evaluación seleccionado
  
  • Valores permitidos:
    
    • PASSED_MANDATORY_ACTIVITIES
    • MIN_SCORE
• credits = Número de créditos
• optativeCredits = Número de créditos optativos
• percentageToPass = porcentaje mínimo para superar el curso
• hasForum = Valor true/false. Indica si tiene foro.
• hasMessage = Valor true/fallse. Indica si tiene mensajes.  
• status = Estado del curso
• enrolmentPolicy = Política de inscripción
  
  • AUTO_ENROLLMENT --> Auto inscripción
  • ADMIN_ENROLLMENT --> Sólo los administradores pueden inscribir alumnos
  • REQUEST_ENROLLMENT --> Solicitar inscripción
• requestEnrolmentEndDateMode = Tipo de fecha de fin en solicitud de inscripción
  
  • INHERIT --> Heredada del curso
  • MANUAL --> Se establecerá de forma manual
• requestEnrolmentStartDate = Fecha de apertura de inscripciones (UTC)
• requestEnrolmentEndDate = Fecha de cierre de inscripciones (UTC)
• avgRating = Valoración media (Double)
• rateable = Curso valorable por los alumnos o no valorable
  
  • Valores permitidos: 
    
    • NONE : no valorable
    • ONLY_ENROLMENTS : los alumnos inscritos pueden valorar el curso
  • Valor por defecto: NONE
   
• categories = Lista de Categorías del curso 
  
  • id = Identificador de la categoría
    
  • external_id = Identificador externo
    
  • name = Nombre de la categoría
    
  • code = Código de la categoría
    
  • description = Descripción de la categoría
• extendedFields = Campos extensibles en lista con clave extendedFieldName y valor extendedFieldValue
  
  • extendedFieldName = Nombre del campo extendido
  • extendedFieldValue = Valor del campo extendido

Validaciones

• No existe el curso Error 404 (Not Found)
• Error en la generación del Json --> Error 503 (Service Unavailable)
• Todo OK --> 200 (OK) + JSON

Obtener curso (v4)

Método: GET

URL:

Obtener por id:

• /admin/rest/administration/api/courses/id/{id}

Obtener por external id:

• /admin/rest/administration/api/courses/externalid/{externalid}

Ejemplo: https://demo.central-lms.com/admin/rest/administration/api/courses/id/2514

Cabeceras

• NLC-datesFormat. Opcional, valores permitidos:
  
  • milliseconds. Las fechas se devolverán en milisegundos
  • en otro caso se seguirá el formato de texto: "yyyy-MM-dd HH:mm:ss"

Campos devueltos en el Json

Curso, cada curso consta de los siguientes campos:

• parent = Campos concretos del curso padre. En caso de que el curso esté configurado para tener convocatorias, son los campos que comparten todas las convocatorias. Contiene los siguientes atributos:
  • parentId = Identificador del curso padre
  • parentExternal_id = Id externo del curso padre
  • name = Nombre del curso padre
  • description = Descripción del curso
  • comments = Comentarios del curso
  • objectives = Objetivos del curso
  • issueCertificate = Expedir certificado
    
    • NO --> Sin certificado
    • PASSED --> Certificado disponible para los estudiantes tan pronto aprueben el curso
    • FINISHED --> Certificado disponible para los estudiantes solamente después de la finalización del curso
  • sessionOrganization = Organización de acciones formativas
    
    • MANUAL --> Manual
    • AUTOMATIC --> Automática para actividades de auto-aprendizaje y manual para el resto
  • evaluationType = Sistema de evaluación seleccionado
    
    • Valores permitidos:
      
      • PASSED_MANDATORY_ACTIVITIES
      • MIN_SCORE
  • credits = Número de créditos
  • optativeCredits = Número de créditos optativos
  • percentageToPass = porcentaje mínimo para superar el curso
  • hasForum = Valor true/false. Indica si tiene foro.
  • hasMessage = Valor true/fallse. Indica si tiene mensajes.  
  • clonedFromId = Identificador de curso que se clona 
  • hasReminder = Activar recordatorio a usuarios que llevan un tiempo sin acceder
    
    • Valores permitidos: TRUE / FALSE
    • Valor por defecto: FALSE
  • hasStartReminder = Activar recordatorios de la fecha de inicio del curso
    
    • Valores permitidos: TRUE / FALSE
    • Valor por defecto: FALSE
  • hasEditions = El curso tiene habilitadas las convocatorias
    
    • Valores permitidos: TRUE / FALSE
    • Valor por defecto: FALSE
  • recogniseEditions = Validación automática entre convocatorias
    
    • Valores permitidos: TRUE / FALSE
    • Valor por defecto: FALSE
• id = Identificador
• external_id = Id externo
• name editionName =   Nombre del curso
• description = Descripción del curso
• comments = Comentarios del curso
• objectives = Objetivos del curso
• moduleType = Tipo de módulo
• issueCertificate = Expedir certificado
  
  • NO --> Sin certificado
  • PASSED --> Certificado disponible para los estudiantes tan pronto aprueben el curso
  • FINISHED --> Certificado disponible para los estudiantes solamente después de la finalización del curso
• startDateMode de la edición
• startDateMode = Tipo de fecha de inicio
  
  • PUBLICATION_DATE --> La fecha de inicio será la fecha de publicación del curso
  • MANUAL --> La fecha de inicio se establecerá de forma manual
• startDate = Fecha estimada de inicio inicio (UTC)
• endDateMode = Tipo fecha de finfin 
  
  • NONE --> Ninguna, el administrador finalizará el curso manualmente
  • MANUAL --> La fecha de fin se establecerá de forma manual
  • FIRST_ACCESS -> Fecha fin según el primer acceso del alumno
• studentAvailableDays = Número de días tras el primero acceso que tiene el alumno disponible el curso (Integer, obligatorio si el modo es FIRST_ACCESS).
• endDate     = Fecha estimada de fin (UTC)
sessionOrganization = Organización de acciones formativas

• MANUAL --> Manual
AUTOMATIC --> Automática para actividades de auto-aprendizaje y manual para el resto

• evaluationType = Sistema de evaluación seleccionado
  
  • Valores permitidos:
    
    • PASSED_MANDATORY_ACTIVITIES
    • MIN_SCORE
• credits = Número de créditos
• optativeCredits = Número de créditos optativos
• percentageToPass = porcentaje mínimo para superar el curso
• hasForum = Valor true/false. Indica si tiene foro.
• hasMessage = Valor true/fallse. Indica si tiene mensajes.  
• status = Estado del cursotiene el alumno disponible el curso (Integer, obligatorio si el modo es FIRST_ACCESS).
• endDate     = Fecha estimada de fin (UTC)
• status = Estado del curso
• moduleType = Tipo de módulo
  
• enrolmentPolicy = Política de inscripción
  
  • AUTO_ENROLLMENT --> Auto inscripción
  • ADMIN_ENROLLMENT --> Sólo los administradores pueden inscribir alumnos
  • REQUEST_ENROLLMENT --> Solicitar inscripción
• requestEnrolmentEndDateMode = Tipo de fecha de fin en solicitud de inscripción
  
  • INHERIT --> Heredada del curso
  • MANUAL --> Se establecerá de forma manual
• requestEnrolmentStartDate = Fecha de apertura de inscripciones inscripciones (UTC)
• requestEnrolmentEndDate = Fecha de cierre de inscripciones (UTCinscripciones (UTC)
• clonedFromId = Identificador de curso que se clona (Long) 
  
• capacity = Aforo máximo de la edición (Integer)
• avgRating = Valoración media (Double)
• rateable rateable = Curso valorable por los alumnos o no valorable
  
  • Valores permitidos: 
    
    • NONE : no valorable
    • ONLY_ENROLMENTS : los alumnos inscritos pueden valorar el curso
  • Valor por defecto: NONE
   
  • NONE 
• categories = Lista de Categorías del curso 
  
  • id id = Identificador de la categoría
    
  • external_id id = Identificador externo
    
  • name name = Nombre de la categoría
    
  • code code = Código de la categoría
    
  • description description = Descripción de la categoría
• extendedFields = Campos extensibles en lista con clave extendedFieldName y valor extendedFieldValue
  
  • extendedFieldName extendedFieldName = Nombre del campo extendido
  • extendedFieldValue = Valor del campo extendido

Validaciones

• No existe el curso Error 404 (Not Found)
• Error en la generación del Json --> Error 503 (Service Unavailable)
• Todo OK --> 200 (OK) + JSON

Obtener curso (

...

v5)

Método: GET

URL:

Obtener por id:

...

Cabeceras

• NLC-datesFormat. Opcional, valores permitidos:
  
  • milliseconds. Las fechas se devolverán en milisegundos
  • en otro caso se seguirá el formato de texto: "yyyy-MM-dd HH:mm:ss"

Campos devueltos en el Json

Curso, cada curso consta de los siguientes campos:

• parent = Campos concretos del curso padre. En caso de que el curso esté configurado para tener convocatorias, son los campos que comparten todas las convocatorias. Contiene los siguientes atributos:
  
  • parentId = Identificador del curso padre
  • parentExternal_id = Id externo del curso padre
  • name = Nombre del curso padre
  • description = Descripción del curso
  • comments = Comentarios del curso
  • objectives = Objetivos del curso
  • issueCertificate = Expedir certificado
    
    • NO --> Sin certificado
    • PASSED --> Certificado disponible para los estudiantes tan pronto aprueben el curso
    • FINISHED --> Certificado disponible para los estudiantes solamente después de la finalización del curso
  • sessionOrganization = Organización de acciones formativas
    
    • MANUAL --> Manual
    • AUTOMATIC --> Automática para actividades de auto-aprendizaje y manual para el resto
  • evaluationType = Sistema de evaluación seleccionado
    
    • Valores permitidos:
      
      • PASSED_MANDATORY_ACTIVITIES
      • MIN_SCORE
  • credits = Número de créditos
  • optativeCredits = Número de créditos optativos
  • percentageToPass = porcentaje mínimo para superar el curso
  • hasForum = Valor true/false. Indica si tiene foro.
  • hasMessage = Valor true/fallse. Indica si tiene mensajes.  
  • clonedFromId = Identificador de curso que se clona 
  • hasReminder = Activar recordatorio a usuarios que llevan un tiempo sin acceder
    
    • Valores permitidos: TRUE / FALSE
    • Valor por defecto: FALSE
  • hasStartReminder = Activar recordatorios de la fecha de inicio del curso
    
    • Valores permitidos: TRUE / FALSE
    • Valor por defecto: FALSE
  • hasEditions = El curso tiene habilitadas las convocatorias
    
    • Valores permitidos: TRUE / FALSE
    • Valor por defecto: FALSE
  • recogniseEditions = Validación automática entre convocatorias
    
    • Valores permitidos: TRUE / FALSE
    • Valor por defecto: FALSE
• id = Identificador
• external_id = Id externo
• editionName = Nombre de la edición
• startDateMode = Tipo de fecha de inicio
  
  • PUBLICATION_DATE --> La fecha de inicio será la fecha de publicación del curso
  • MANUAL --> La fecha de inicio se establecerá de forma manual
• startDate = Fecha estimada de inicio (UTC)
• endDateMode = Tipo fecha de fin 
  
  • NONE --> Ninguna, el administrador finalizará el curso manualmente
  • MANUAL --> La fecha de fin se establecerá de forma manual
  • FIRST_ACCESS -> Fecha fin según el primer acceso del alumno
• studentAvailableDays = Número de días tras el primero acceso que tiene el alumno disponible el curso (Integer, obligatorio si el modo es FIRST_ACCESS).
• endDate     = Fecha estimada de fin (UTC)
• status = Estado del curso
• moduleType = Tipo de módulo
  
• enrolmentPolicy = Política de inscripción
  
  • AUTO_ENROLLMENT --> Auto inscripción
  • ADMIN_ENROLLMENT --> Sólo los administradores pueden inscribir alumnos
  • REQUEST_ENROLLMENT --> Solicitar inscripción
• requestEnrolmentEndDateMode = Tipo de fecha de fin en solicitud de inscripción
  
  • INHERIT --> Heredada del curso
  • MANUAL --> Se establecerá de forma manual
• requestEnrolmentStartDate = Fecha de apertura de inscripciones (UTC)
• requestEnrolmentEndDate = Fecha de cierre de inscripciones (UTC)
• clonedFromId = Identificador de curso que se clona (Long) 
  
• capacity = Aforo máximo de la edición (Integer)
• avgRating = Valoración media (Double)
• rateable = Curso valorable por los alumnos o no valorable
  
  • Valores permitidos: 
    
    • NONE : no valorable
    • ONLY_ENROLMENTS : los alumnos inscritos pueden valorar el curso
  • Valor por defecto: NONE 
• categories = Lista de Categorías del curso
  
  • id = Identificador de la categoría
    
  • external_id = Identificador externo
    
  • name = Nombre de la categoría
    
  • code = Código de la categoría
    
  • description = Descripción de la categoría
• extendedFields = Campos extensibles en lista con clave extendedFieldName y valor extendedFieldValue
  
  • extendedFieldName = Nombre del campo extendido
  • extendedFieldValue = Valor del campo extendido
• collection = Nombre de la colección asociada al curso. Vacio si no está asociado a ninguna colección.

Validaciones

• No existe el curso Error 404 (Not Found)
• Error en la generación del Json --> Error 503 (Service Unavailable)
• Todo OK --> 200 (OK) + JSON

Obtener curso (

...

v6)

Método: GET

URL:

Obtener por id:

...

...

...

...

Cabeceras

• NLC-datesFormat. Opcional, valores permitidos:
  
  • milliseconds. Las fechas se devolverán en milisegundos
  • en otro caso se seguirá el formato de texto: "yyyy-MM-dd HH:mm:ss"

Campos devueltos en el Json

Curso, cada curso consta de los siguientes campos:

• parent = Campos concretos del curso padre. En caso de que el curso esté configurado para tener convocatorias, son los campos que comparten todas las convocatorias. Contiene los siguientes atributos:
  
  • parentId = Identificador del curso padre
  • parentExternal_id = Id externo del curso padre
  • name = Nombre del curso padre
  • description = Descripción del curso
  • comments = Comentarios del curso
  • objectives = Objetivos del curso
  • issueCertificate = Expedir certificado
    
    • NO --> Sin certificado
    • PASSED --> Certificado disponible para los estudiantes tan pronto aprueben el curso
    • FINISHED --> Certificado disponible para los estudiantes solamente después de la finalización del curso
  • sessionOrganization = Organización de acciones formativas
    
    • MANUAL --> Manual
    • AUTOMATIC --> Automática para actividades de auto-aprendizaje y manual para el resto
  • evaluationType = Sistema de evaluación seleccionado
    
    • Valores permitidos:
      
      • PASSED_MANDATORY_ACTIVITIES
      • MIN_SCORE
  • credits = Número de créditos
  • optativeCredits = Número de créditos optativos
  • percentageToPass = porcentaje mínimo para superar el curso
  • hasForum = Valor true/false. Indica si tiene foro.
  • hasMessage = Valor true/fallse. Indica si tiene mensajes.  
  • clonedFromId = Identificador de curso que se clona 
  • hasReminder = Activar recordatorio a usuarios que llevan un tiempo sin acceder
    
    • Valores permitidos: TRUE / FALSE
    • Valor por defecto: FALSE
  • hasStartReminder = Activar recordatorios de la fecha de inicio del curso
    
    • Valores permitidos: TRUE / FALSE
    • Valor por defecto: FALSE
  • hasEditions = El curso tiene habilitadas las convocatorias
    
    • Valores permitidos: TRUE / FALSE
    • Valor por defecto: FALSE
  • recogniseEditions = Validación automática entre convocatorias
    
    • Valores permitidos: TRUE / FALSE
    • Valor por defecto: FALSE
• id = Identificador
• external_id = Id externo
• editionName = Nombre de la edición
• startDateMode = Tipo de fecha de inicio
  
  • PUBLICATION_DATE --> La fecha de inicio será la fecha de publicación del curso
  • MANUAL --> La fecha de inicio se establecerá de forma manual
• startDate = Fecha estimada de inicio (UTC)
• endDateMode = Tipo fecha de fin 
  
  • NONE --> Ninguna, el administrador finalizará el curso manualmente
  • MANUAL --> La fecha de fin se establecerá de forma manual
  • FIRST_ACCESS -> Fecha fin según el primer acceso del alumno
• studentAvailableDays = Número de días tras el primero acceso que tiene el alumno disponible el curso (Integer, obligatorio si el modo es FIRST_ACCESS).
• endDate     = Fecha estimada de fin (UTC)
• status = Estado del curso
• moduleType = Tipo de módulo
  
• enrolmentPolicy = Política de inscripción
  
  • AUTO_ENROLLMENT --> Auto inscripción
  • ADMIN_ENROLLMENT --> Sólo los administradores pueden inscribir alumnos
  • REQUEST_ENROLLMENT --> Solicitar inscripción
• requestEnrolmentEndDateMode = Tipo de fecha de fin en solicitud de inscripción
  
  • INHERIT --> Heredada del curso
  • MANUAL --> Se establecerá de forma manual
• requestEnrolmentStartDate = Fecha de apertura de inscripciones (UTC)
• requestEnrolmentEndDate = Fecha de cierre de inscripciones (UTC)
• clonedFromId = Identificador de curso que se clona (Long) 
  
• capacity = Aforo máximo de la edición (Integer)
• avgRating = Valoración media (Double)
• rateable = Curso valorable por los alumnos o no valorable
  
  • Valores permitidos: 
    
    • NONE : no valorable
    • ONLY_ENROLMENTS : los alumnos inscritos pueden valorar el curso
  • Valor por defecto: NONE 
• categories = Lista de Categorías del curso
  
  • id = Identificador de la categoría
    
  • external_id = Identificador externo
    
  • name = Nombre de la categoría
    
  • code = Código de la categoría
    
  • description = Descripción de la categoría
• extendedFields = Campos extensibles en lista con clave extendedFieldName y valor extendedFieldValue
  
  • extendedFieldName = Nombre del campo extendido
  • extendedFieldValue = Valor del campo extendido
• collection = Nombre de la colección asociada al curso. Vacio si no está asociado a ninguna colección.
• hasLink = Valor true/false. Indica si tiene enlaces externos
• externalLinks= Lista de enlaces externos. Devuelve null si el curso no los tiene.
  • name = Nombre del enlace
  • urlLink = El propio enlace

Validaciones

• No existe el curso Error 404 (Not Found)
• Error en la generación del Json --> Error 503 (Service Unavailable)
• Todo OK --> 200 (OK) + JSON

Obtener curso (

...

v7)

Método: GET

URL:

Obtener por id:

...

Image Added

Recuerda que por motivos de seguridad,

...

...

...

Ejemplo: https://demo.central-lms.com/admin/rest/administration/api/courses/id/2514

Cabeceras

• NLC-datesFormat. Opcional, valores permitidos:
  
  • milliseconds. Las fechas se devolverán en milisegundos
  • en otro caso se seguirá el formato de texto: "yyyy-MM-dd HH:mm:ss"

Campos devueltos en el Json

Curso, cada curso consta de los siguientes campos:

• parent = Campos concretos del curso padre. En caso de que el curso esté configurado para tener convocatorias, son los campos que comparten todas las convocatorias. Contiene los siguientes atributos:
  
  • parentId = Identificador del curso padre
  • parentExternal_id = Id externo del curso padre
  • name = Nombre del curso padre
  • description = Descripción del curso
  • comments = Comentarios del curso
  • objectives = Objetivos del curso
  • issueCertificate = Expedir certificado
    
    • NO --> Sin certificado
    • PASSED --> Certificado disponible para los estudiantes tan pronto aprueben el curso
    • FINISHED --> Certificado disponible para los estudiantes solamente después de la finalización del curso
  • sessionOrganization = Organización de acciones formativas
    
    • MANUAL --> Manual
    • AUTOMATIC --> Automática para actividades de auto-aprendizaje y manual para el resto
  • evaluationType = Sistema de evaluación seleccionado
    
    • Valores permitidos:
      
      • PASSED_MANDATORY_ACTIVITIES
      • MIN_SCORE
  • credits = Número de créditos
  • optativeCredits = Número de créditos optativos
  • percentageToPass = porcentaje mínimo para superar el curso
  • hasForum = Valor true/false. Indica si tiene foro.
  • hasMessage = Valor true/fallse. Indica si tiene mensajes.  
  • clonedFromId = Identificador de curso que se clona 
  • hasReminder = Activar recordatorio a usuarios que llevan un tiempo sin acceder
    
    • Valores permitidos: TRUE / FALSE
    • Valor por defecto: FALSE
  • hasStartReminder = Activar recordatorios de la fecha de inicio del curso
    
    • Valores permitidos: TRUE / FALSE
    • Valor por defecto: FALSE
  • hasEditions = El curso tiene habilitadas las convocatorias
    
    • Valores permitidos: TRUE / FALSE
    • Valor por defecto: FALSE
  • recogniseEditions = Validación automática entre convocatorias
    
    • Valores permitidos: TRUE / FALSE
    • Valor por defecto: FALSE
• id = Identificador
• external_id = Id externo
• editionName = Nombre de la edición
• startDateMode = Tipo de fecha de inicio
  
  • PUBLICATION_DATE --> La fecha de inicio será la fecha de publicación del curso
  • MANUAL --> La fecha de inicio se establecerá de forma manual
• startDate = Fecha estimada de inicio (UTC)
• endDateMode = Tipo fecha de fin 
  
  • NONE --> Ninguna, el administrador finalizará el curso manualmente
  • MANUAL --> La fecha de fin se establecerá de forma manual
  • FIRST_ACCESS -> Fecha fin según el primer acceso del alumno
• studentAvailableDays = Número de días tras el primero acceso que tiene el alumno disponible el curso (Integer, obligatorio si el modo es FIRST_ACCESS).
• endDate     = Fecha estimada de fin (UTC)
• status = Estado del curso
• moduleType = Tipo de módulo
  
• enrolmentPolicy = Política de inscripción
  
  • AUTO_ENROLLMENT --> Auto inscripción
  • ADMIN_ENROLLMENT --> Sólo los administradores pueden inscribir alumnos
  • REQUEST_ENROLLMENT --> Solicitar inscripción
• requestEnrolmentEndDateMode = Tipo de fecha de fin en solicitud de inscripción
  
  • INHERIT --> Heredada del curso
  • MANUAL --> Se establecerá de forma manual
• requestEnrolmentStartDate = Fecha de apertura de inscripciones (UTC)
• requestEnrolmentEndDate = Fecha de cierre de inscripciones (UTC)
• clonedFromId = Identificador de curso que se clona (Long) 
  
• capacity = Aforo máximo de la edición (Integer)
• avgRating = Valoración media (Double)
• rateable = Curso valorable por los alumnos o no valorable
  
  • Valores permitidos: 
    
    • NONE : no valorable
    • ONLY_ENROLMENTS : los alumnos inscritos pueden valorar el curso
  • Valor por defecto: NONE 
• categories = Lista de Categorías del curso
  
  • id = Identificador de la categoría
    
  • external_id = Identificador externo
    
  • name = Nombre de la categoría
    
  • code = Código de la categoría
    
  • description = Descripción de la categoría
• extendedFields = Campos extensibles en lista con clave extendedFieldName y valor extendedFieldValue
  
  • extendedFieldName = Nombre del campo extendido
  • extendedFieldValue = Valor del campo extendido
• collection = Nombre de la colección asociada al curso. Vacio si no está asociado a ninguna colección.
• hasLink = Valor true/false. Indica si tiene enlaces externos
• externalLinks= Lista de enlaces externos. Devuelve null si el curso no los tiene.
  
  • name = Nombre del enlace
  • urlLink = El propio enlace
• estimatedDuration = Duración estimada del curso (sumatorio de las duraciones de todas las actividades)

Validaciones

• No existe el curso Error 404 (Not Found)
• Error en la generación del Json --> Error 503 (Service Unavailable)
• Todo OK --> 200 (OK) + JSON

...

Ejemplo: https://demo.central-lms.com/admin/rest/administration/api/courses/id/2514

Validaciones

• Error inesperado al eliminar el curso --> Error CRS036 / 400 (Bad Request)
• No existe un curso con ese id o id externo --> Error 404 (Not Found)
• Todo OK --> 200 (OK)

...

id=51476&id=654165&id=6566

Parámetros

• action = acción que se quiere realizar (añadir usando ids de grupos o ids externos) (String, obligatorio)
  • Valores permitidos 
    
    • addByIds
    • addByExternalids
• id (lista) = cada uno de los identificadores o identificadores externos (String, obligatorio)

...

• status: KO
• ids / external ids: listado de ids o external ids que han dado error

Validaciones

• Lista de parámetros vacía o algún campo obligatorio sin cubrir--> Error ERR001 / 400 (Bad Request)
• Acción no válida (no se comprueban mayúsculas/minúsculas) --> Error ERR002 / 400 (Bad Request)
• Se ha escogido la acción "addByIds" y algún id no es numérico --> Error ERR003 / 400 (Bad Request)
• No existe el curso --> Error 400 (Not Found)
• Ejecución OK y todos los grupos han sido añadidos--> 200 (OK)
• Ejecución OK y algún grupo no ha podido ser añadido --> 200 (OK) + JSON

...

Ejemplo: https://demo.central-lms.com/admin/rest/administration/api/courses/id/345/groups

Campos devueltos en el Json

Listado de grupos, cada grupo consta de los siguientes campos:

• id = Identificador
• external_id = Id externo
• parentId = Identificador de grupo padre
• name = Nombre de grupo
• description = Descripción de grupo
• extendedFields = Campos extensibles en lista con clave extendedFieldName y valor extendedFieldValuee 
  
  • extendedFieldName = Nombre del campo extendido
  • extendedFieldValue = Valor del campo extendido

Validaciones

• Si el curso no existe --> Error 404 (Not Found)
• No hay grupos --> Error 204 (No Content)
• Error en la generación del Json --> Error 503 (Service Unavailable)
• Todo OK --> 200 (OK) + JSON

...

id=51476&id=654165&id=6566

Parámetros

• action = acción que se quiere realizar (eliminar usando ids de grupos o ids externos) (String, obligatorio)
  
  • Valores permitidos 
    
    • removeByIds
    • removeByExternalids
• id (lista) = cada uno de los identificadores o identificadores externos (String, obligatorio)

...

• status: KO
• ids / external ids: listado de ids o external ids que han dado error

Validaciones

• Lista de parámetros vacía o algún campo obligatorio sin cubrir--> Error ERR001 / 400 (Bad Request)
• Acción no válida (no se comprueban mayúsculas/minúsculas) --> Error ERR002 / 400 (Bad Request)
• Se ha escogido la acción "addByIds" y algún id no es numérico --> Error ERR003 / 400 (Bad Request)
• No existe el curso --> Error 400 (Not Found)
• Ejecución OK y todos los grupos han sido eliminados -> 200 (OK)
• Ejecución OK y algún grupo no ha podido ser eliminado --> 200 (OK) + JSON

...

id=51476&id=654165&id=6566

Parámetros

• action = acción que se quiere realizar (añadir usando ids de usuario o ids externos) (String, obligatorio)
  
  • Valores permitidos
    
    • addByIds
    • addByExternalids
• id (lista) = cada uno de los identificadores o identificadores externos (String, obligatorio)

...

• status: KO
• ids / external ids: listado de ids o external ids que han dado error

Validaciones

• Lista de parámetros vacía o algún campo obligatorio sin cubrir--> Error ERR001 / 400 (Bad Request)
• Acción no válida (no se comprueban mayúsculas/minúsculas) --> Error ERR002 / 400 (Bad Request)
• Se ha escogido la acción "addByIds" y algún id no es numérico --> Error ERR003 / 400 (Bad Request)
• No existe el curso --> Error 400 (Not Found)
• Ejecución OK y todos los usuarios han sido añadidos --> 200 (OK)
• Ejecución OK y algún usuario no ha podido ser añadido --> 200 (OK) + JSON

...

Ejemplo: https://demo.central-lms.com/admin/rest/administration/api/courses/id/345/tutors

Campos devueltos en el Json

Listado de usuarios tutores, cada tutor consta de los siguientes campos:

• id = Identificador
• external_id = Id externo
• username = Nombre de usuario
• firstName = Nombre
• lastName = Apellidos
• preferredLanguage = Idioma predeterminado
• personTimezoneId = Zona horaria
• roles = Roles del usuario
• email = Correo electrónico del usuario
• officePhoneNumber = Teléfono de oficina
• mobilePhoneNumber = Teléfono móvil
• address = Dirección
• jobTitle = Puesto
• location = Departamento
• organization = Compañía
• aboutMe = Sobre mí
• interests = Intereses
• status = Estado
• extendedFields = Campos extensibles en lista con clave extendedFieldName y valor extendedFieldValue
  
  • extendedFieldName = Nombre del campo extendido
  • extendedFieldValue = Valor del campo extendido

Validaciones

• Si el curso no existe --> Error 404 (Not Found)
• No hay usuarios --> Error 204 (No Content)
• Error en la generación del Json --> Error 503 (Service Unavailable)
• Todo OK --> 200 (OK) + JSON

...

id=51476&id=654165&id=6566

id=51476&id=654165&id=6566

id=51476&id=654165&id=6566

id=51476&id=654165&id=6566

id=51476&id=654165&id=6566

date=12456897000

{
"evaluation_id":4543,
"student_id":2221,
"external_id":"ff80818166be7eac0166cbc684d802ce",
"username":"login279",
"score":15,
"totaltime":"00:20:00",
"firstAccess":"2019-12-19 23:59:59",
"lastAccess":"2019-12-19 23:59:59",
"status":"IN_PROGRESS",
"passedItems":1,
"passedMandatoryItems":0,
"totalItems":1,
"totalMandatoryItems":1,
"enrolmentMotive":"aaaaaa",
"limitAccessDate":"2019-12-19 23:59:59"
}

{
"evaluation_id":4543,
"student_id":2221,
"external_id":"ff80818166be7eac0166cbc684d802ce",
"username":"login279",
"score":15,
"totaltime":"00:20:00",
"firstAccess":"2019-12-19 23:59:59",
"lastAccess":"2019-12-19 23:59:59",
"status":"IN_PROGRESS",
"passedDate": "2019-12-19 23:59:59",
"passedItems":1,
"passedMandatoryItems":0,
"totalItems":1,
"totalMandatoryItems":1,
"enrolmentMotive":"aaaaaa",
"limitAccessDate":"2019-12-19 23:59:59"
}

[
{ "op": "add", "path": "/limitAccessDate", "value": "2019-12-19 23:59:59" }
]

[{"op":"test","path":"/a/b/c","value":"foo"},
{"op":"remove","path":"/a/b/c"},
{"op":"add","path":"/a/b/c","value":["foo","bar"]},
{"op":"replace","path":"/a/b/c","value":42},
{"op":"move","from":"/a/b/c","path":"/a/b/d"},
{"op":"copy","from":"/a/b/d","path":"/a/b/e"}]

[
{ "op": "add", "path": "/limitAccessDate", "value": "2019-12-19 23:59:59" }
]

 [{ "op": "test", "path": "/a/b/c", "value": "foo" }, 
{ "op": "remove", "path": "/a/b/c" }, 
{ "op": "add", "path": "/a/b/c", "value": [ "foo", "bar" ] }, 
{ "op": "replace", "path": "/a/b/c", "value": 42 },
{ "op": "move", "from": "/a/b/c", "path": "/a/b/d" }, 
{ "op": "copy", "from": "/a/b/d", "path": "/a/b/e" }]

id=51476&id=654165&id=6566

collective[0]=2171&collective[1]=2022&collective[4]=2103

collective[0]=2171&collective[1]=2022&collective[4]=2103

external_id=excourse1&name=Curso de diseño gráfico&clonedFromId=1

external_id=excourse1&name=Curso de diseño gráfico&clonedFromExternalId=excourseToClone

external_id=excourse1&name=Curso de diseño gráfico&clonedFromId=1

external_id=excourse1&name=Curso de diseño gráfico&clonedFromExternalId=excourseToClone

 {
  "external_id": "excourse1",
  "name": "Curso de diseño gráfico",
  "clonedFromId": 1
}

 {
	"id": 72307,
	"studentId": 1,
	"showMessage": "true",
	"message": "Mi mensaje de bienvenida"
}

 {
	"showMessage": "true",
	"message": "Mi mensaje de bienvenida"
}

...

• name = Nombre del enlace (String, obligatorio)
• urlLink = El propio enlace (String, obligatorio)

Validaciones

• Lista de parámetros vacía o algún campo obligatorio sin cubrir --> Error ERR001 / 400 (Bad Request)
• No permite enlaces (hasLink es falso) --> Error CSR061 / 400 (Bad Request)
• URL mal formada --> Error CSR062 / 400 (Bad Request)
• Nombres no introdicidos --> Error CSR063 / 400 (Bad Request)

...

• Eliminar enlaces por id de curso y nombre de enlace
  
  • /admin/rest/administration/api/courses/id/{id}/externallinks?name={name}

Parámetros

• name = Nombre del enlace (String, opcional)

...