La interfaz ITranslateCourseSection se utiliza para traducir la sección de cursos del LIS en una sección del curso del IPSIS.
La implementación de la interfaz es D2L.IM.IPSIS.LIS.CMS.ITranslateCourseSection.
En la siguiente lista de configuración de plantillas se proporciona un punto de partida para cualquier implementación del LIS:
IPSIS, Predeterminado
- CourseSectionRequestBaseTranslator (Orden de clasificación = 10)
- CourseSectionRequestParentOfferingIdRequiredTranslator (Orden de clasificación = 20)
- CourseSectionRequestNameRequiredTranslator (Orden de clasificación = 30)
- CourseSectionRequestDepartmentRequiredTranslator (Orden de clasificación = 40)
- CourseSectionRequestSemesterOptionalTranslator (Orden de clasificación = 50)
- CourseSectionRequestStartDateEndDateRequiredTranslator (Orden de clasificación = 60)
- CourseSectionRequestStatusOptionalTranslator (Orden de clasificación = 70)
CourseSectionRequestBaseTranslator
El traductor CourseSectionRequestBaseTranslator obtiene el identificador único de la sección del curso de la solicitud.
Implementación
D2L.IM.IPSIS.LIS.RequestAdapters.CMS.Default.CourseSectionRequestBaseTranslator
Comportamiento esperado
El traductor realiza las siguientes tareas:
- Establece los valores OrgUnitCode y OrgUnitName según los valores provistos en sourcedGUID.sourcedid.
- El proceso continúa con el traductor siguiente.
Entidad
|
Propiedad
|
Objeto de resultados de traducción
|
Esquema de solicitud del LIS
|
|
Código
|
result.Entity.Code
|
courseSectionRecord.sourcedGUID.sourcedId
|
|
Nombre
|
result.Entity.Name
|
courseSectionRecord.sourcedGUID.sourcedId
|
Comportamiento de error
Si existe un problema durante el procesamiento, se arroja una excepción IncompleteRequestException. Esto produce lo siguiente:
- La suspensión de todos los procesamientos adicionales.
- Un encabezado de respuesta del LIS que contiene:
- CodeMajor = failure.
- Severity = status.
- CodeMinor = invaliddata.
Notas de configuración
Este traductor (o un traductor Base alternativo) debe configurarse, en primer lugar, en la lista de traductores.
CourseSectionRequestParentOfferingIdRequiredTranslator
El traductor CourseSectionRequestParentOfferingIdRequiredTranslator solicita y asigna el ID principal de la oferta de cursos.
Implementación
D2L.IM.IPSIS.LIS.RequestAdapters.CMS.Default.CourseSectionRequestParentOfferingIdRequiredTranslator
Comportamiento esperado
El traductor realiza las siguientes tareas:
- Establece el ParentOfferingId del resultado para contener el valor del ParentOfferingId en la solicitud.
- El proceso continúa con el traductor siguiente.
ParentOfferingId
|
Propiedad
|
Objeto de resultados de traducción
|
Esquema de solicitud del LIS
|
|
ID de oferta principal
|
result.ParentOfferingId
|
courseSectionRecord.courseSection.parentOfferingId
|
Comportamiento de error
Si existe un problema durante el procesamiento, se arroja una excepción IncompleteRequestException. Esto produce lo siguiente:
- La suspensión de todos los procesamientos adicionales.
- Un encabezado de respuesta del LIS que contiene:
- CodeMajor = failure.
- Severity = status.
- CodeMinor = invaliddata.
Nota de configuración
Este traductor puede ubicarse en cualquier orden después del traductor Base.
CourseSectionRequestNameRequiredTranslator
El traductor CourseSectionRequestNameRequiredTranslator requiere y asigna el nombre de la sección.
Implementación
D2L.IM.IPSIS.LIS.RequestAdapters.CMS.Default.CourseSectionRequestNameRequiredTranslator
Comportamiento esperado
El traductor realiza las siguientes tareas:
- Actualiza el OrgUnitName para contener el valor del título en la solicitud.
- El proceso continúa con el traductor siguiente.
Entidad
|
Propiedad
|
Objeto de resultados de traducción
|
Esquema de solicitud del LIS
|
|
Nombre
|
result.Entity.Name
|
courseSectionRecord.courseSection.title
|
Comportamiento de error
Si existe un problema en el procesamiento, se arroja una excepción IncompleteRequestException. Esto produce lo siguiente:
- Suspensión de todos los procesos adicionales.
- Un encabezado de respuesta del LIS que contiene:
- CodeMajor = failure.
- Severity = status.
- CodeMinor = invaliddata.
Nota de configuración
Este traductor puede ubicarse en cualquier orden después del traductor Base.
CourseSectionRequestDepartmentRequiredTranslator
El traductor CourseSectionRequestDepartmentRequiredTranslator requiere y asigna el ID de Departamento.
Implementación
D2L.IM.IPSIS.LIS.RequestAdapters.CMS.Default.CourseSectionRequestDepartmentRequiredTranslator
Comportamiento esperado
El traductor completa las siguientes tareas:
- Establece el ParentDepartmentId del resultado para contener el valor del org.orgName en la solicitud.
- El proceso continúa con el traductor siguiente.
ParentDepartmentID
|
Propiedad
|
Objeto de resultados de traducción
|
Esquema de solicitud del LIS
|
|
ID del departamento principal
|
result.ParentDepartmentId
|
courseSectionRecord.courseSection.org.orgName
|
Comportamiento de error
Si existe un problema durante el procesamiento, se arroja una excepción IncompleteRequestException. Esto produce lo siguiente:
- La suspensión de todos los procesamientos adicionales.
- Un encabezado de respuesta del LIS que contiene:
- CodeMajor = failure.
- Severity = status.
- CodeMinor = invaliddata.
Notas de configuración
Este traductor puede ubicarse en cualquier orden después del traductor Base.
CourseSectionRequestSemesterOptionalTranslator
El traductor CourseSectionRequestSemesterOptionalTranslator asigna el ID de Semestre.
Implementación
D2L.IM.IPSIS.LIS.RequestAdapters.CMS.Default.CourseSectionRequestSemesterOptionalTranslator
Comportamiento esperado
El traductor realiza las siguientes tareas:
- Establece el ParentSemesterId del resultado para contener el valor de la academicSession en la solicitud (si se proporciona).
- El proceso continúa con el traductor siguiente.
ParentSemeseterId
|
Propiedad
|
Objeto de resultados de traducción
|
Esquema de solicitud del LIS
|
|
ID del semestre principal
|
result.ParentSemesterId
|
courseSectionRecord.courseSection.academicSession
|
Comportamiento de error
Si existe un problema durante el procesamiento, se arroja una excepción IncompleteRequestException. Esto produce lo siguiente:
- La suspensión de todos los procesamientos adicionales.
- Un encabezado de respuesta del LIS que contiene:
- CodeMajor = failure.
- Severity = status.
- CodeMinor = invaliddata.
Notas de configuración
Este traductor puede ubicarse en cualquier orden después del traductor Base.
CourseSectionRequestStartDateEndDateOptionalTranslator
El traductor CourseSectionRequestStartDateEndDateOptionalTranslator establece la fecha de inicio y final de la sección.
Implementación
D2L.IM.IPSIS.LIS.RequestAdapters.CMS.Default.CourseSectionRequestStartDateEndDateOptionalTranslator
Comportamiento esperado
El traductor realiza las siguientes tareas:
- Establece las fechas de inicio y final de la OrgUnit para que contengan los valores del primer timeFrame.begin y timeFrame.end en la solicitud.
- El proceso continúa con el traductor siguiente.
Entidad
|
Propiedad
|
Objeto de resultados de traducción
|
Esquema de solicitud del LIS
|
|
Fecha de inicio
|
result.Entity.StartDate
|
courseSectionRecord.courseSection.timeFrame(0).begin
|
|
Fecha final
|
result.Entity.EndDate
|
courseSectionRecord.courseSection.timeFrame(0).end
|
Comportamiento de error
Si existe un problema durante el procesamiento, se arroja una excepción IncompleteRequestException. Esto produce lo siguiente:
- La suspensión de todos los procesamientos adicionales.
- Un encabezado de respuesta del LIS que contiene:
- CodeMajor = failure.
- Severity = status.
- CodeMinor = invaliddata.
Notas de configuración
- Este traductor puede ubicarse en cualquier orden después del traductor Base.
- Este traductor no puede configurarse con CourseSectionRequestStartDateEndDateRequiredTranslator.
CourseSectionRequestStartDateEndDateRequiredTranslator
El traductor CourseSectionRequestStartDateEndDateRequiredTranslator requiere y asigna las fechas de inicio y final de la Sección del curso.
Implementación
D2L.IM.IPSIS.LIS.RequestAdapters.CMS.Default.CourseSectionRequestStartDateEndDateRequiredTranslator
Comportamiento esperado
El traductor realiza las siguientes tareas:
- Establece las fechas de inicio y final de la OrgUnit para que contengan los valores del primer timeFrame.begin y timeFrame.end en la solicitud.
- El proceso continúa con el traductor siguiente.
Entidad
|
Propiedad
|
Objeto de resultados de traducción
|
Esquema de solicitud del LIS
|
|
Fecha de inicio
|
result.Entity.StartDate
|
courseSectionRecord.courseSection.timeFrame(0).begin
|
|
Fecha final
|
result.Entity.EndDate
|
courseSectionRecord.courseSection.timeFrame(0).end
|
Comportamiento de error
Si existe un problema durante el procesamiento, se arroja una excepción IncompleteRequestException. Esto produce lo siguiente:
- La suspensión de todos los procesamientos adicionales.
- Un encabezado de respuesta del LIS que contiene:
- CodeMajor = failure.
- Severity = status.
- CodeMinor = invaliddata.
Notas de configuración
- Este traductor puede ubicarse en cualquier orden después del traductor Base.
- Este traductor no puede configurarse con CourseSectionRequestStartDateEndDateOptionalTranslator.
CourseSectionRequestStatusOptionalTranslator
El traductor CourseSectionRequestStatusOptionalTranslator establece el estado de la sección.
Implementación
D2L.IM.IPSIS.LIS.RequestAdapters.CMS.Default.CourseSectionRequestStatusOptionalTranslator
Comportamiento esperado
El traductor realiza las siguientes tareas:
- Establece la propiedad IsActive de la OrgUnit a fin de que contenga el valor del estado en la solicitud, si se ha establecido la propiedad courseSectionRecord.courseSection.status.
- Si no se proporciona el estado, el valor predeterminado es nulo, ya que el campo es un booleano que admite el valor nulo.
- Si se proporciona el estado, pero el valor no se encontró en el diccionario (a través de VocabManager), el valor se establece en false.
- El proceso continúa con el traductor siguiente.
Entidad
|
Propiedad
|
Objeto de resultados de traducción
|
Esquema de solicitud del LIS
|
|
Estado
|
result.Entity.IsActive
|
courseSectionRecord.courseSection.status
|
Comportamiento de error
Si existe un problema durante el procesamiento, se arroja una excepción IncompleteRequestException. Esto produce lo siguiente:
- La suspensión de todos los procesamientos adicionales.
- Un encabezado de respuesta del LIS que contiene:
- CodeMajor = failure.
- Severity = status.
- CodeMinor = invaliddata.
Nota de configuración
Este traductor puede ubicarse en cualquier orden después del traductor Base.
CourseSectionRequestTruncateOrgUnitCodeTranslator
El traductor CourseSectionRequestTruncateOrgUnitCodeTranslator trunca el código de la unidad de organización del objeto del resultado si el código supera los 50 caracteres. El código truncado se establece en 50 caracteres.
Implementación
D2L.IM.IPSIS.LIS.RequestAdapters.CMS.Default.CourseSectionRequestTruncateOrgUnitCodeTranslator
Comportamiento esperado
El traductor realiza las siguientes tareas:
- Comprueba si el result.Entity.Code tiene más de 50 caracteres. En caso afirmativo, el código se trunca a 50 caracteres.
- El proceso continúa con el traductor siguiente.
Nota de configuración
Este traductor puede ubicarse en cualquier orden después del traductor Base.
CourseSectionRequestCreateParentsTranslator
CourseSectionRequestCreateParentsTranslator proporciona de manera automática las unidades de organización, es decir, la oferta de cursos, las plantillas y los departamentos de la solicitud de sección de ILP de Ellucian.
Implementación
D2L.IM.IPSIS.LIS.RequestAdapters.CMS.Default.CourseSectionRequestCreateParentsTranslator
Comportamiento esperado
Cuando se recibe una solicitud de sección de ILP de Ellucian, activa las siguientes actividades en la plataforma de Brightspace:
- Crear/actualizar un departamento de acuerdo con las siguientes asignaciones
- Crear/actualizar una plantilla del curso de acuerdo con las siguientes asignaciones
- Crear/actualizar una oferta de cursos de acuerdo con las siguientes asignaciones
- Crear/actualizar una sección de acuerdo con la solicitud
Además, las unidades de organización vuelven a tener un elemento principal si uno nuevo se manifiesta con una estructura de organización diferente.
Entidad
Propiedad
|
Objeto de resultados de traducción
|
Asignación de solicitud de LS
|
| id |
result.Entity.id |
courseSectionRecord.sourceGUID.sourceId |
| título |
result.Entity.title |
courseSectionRecord.courseSection.title.textString |
| etiqueta |
|
courseSectionRecord.courseSection.label.textString |
| Elemento principal |
|
courseSectionRecord.courseSection.parentOfferingId |
| departamento |
|
courseSectionRecord.courseSection.org.orgName.textString |
| término |
|
courseSectionRecord.courseSection.academicSession.textString |
| departmentId |
|
courseSectionRecord.courseSection.org.id.textString |
| StartDate |
|
courseSectionRecord.courseSection.timeFrame.begin |
| EndDate |
|
courseSectionRecord.courseSection.timeFrame.end |
| status |
result.Entity.status |
courseSectionRecord.courseSection.status |
Comportamiento de error
Si existe un problema durante el procesamiento, se arroja una excepción IncompleteRequestException. Esto produce lo siguiente:
- La suspensión de todos los procesamientos adicionales.
- Un encabezado de respuesta del LIS que contiene:
- CodeMajor = failure.
- Severity = status.
- CodeMinor = invaliddata.
Si la solicitud de sección de cursos falla, las unidades de organización principales no se eliminan.
Notas de configuración
D2L recomienda el siguiente orden de configuración cuando utilice este traductor:
- CourseSectionRequestBaseTranslator
- CourseSectionRequestNameRequiredTranslator
- CourseSectionRequestCreateParentsTranslator
- CourseSectionRequestStartDateEndDateOptionalTranslator