La interfaz ITranslateGroup se utiliza para traducir un Registro de grupos del LIS en una OrgUnit de Brightspace.
La implementación de la interfaz es D2L.IM.IPSIS.LIS.GMS.ITranslateGroup.
La siguiente lista de configuración ofrece un punto de partida para la implementación del LIS:
Plantilla, IPSIS
- GroupRequestBaseTranslator (Orden de clasificación = 10)
- GroupRequestTypeValueIdRequiredTranslator (Orden de clasificación = 20)
- GroupRequestNameShortDescRequiredTranslator (Orden de clasificación = 30)
GroupRequestBaseTranslator
El traductor GroupRequestBaseTranslator asigna el ID de grupo.
Implementación
D2L.IM.IPSIS.LIS.RequestAdapters.GMS.Default.GroupRequestBaseTranslator
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.
|
Propiedad
|
Objeto de resultados de traducción
|
Esquema de solicitud del LIS
|
|
Código
|
result.Entity.Code
|
groupRecord.sourcedGUID.sourcedId
|
|
Nombre
|
result.Entity.Name
|
groupRecord.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.
Nota de configuración
Este traductor (o un traductor Base alternativo) debe configurarse, en primer lugar, en la lista de traductores.
GroupRequestTypeValueIdRequiredTranslator
El traductor GroupRequestTypeValueIdRequiredTranslator requiere y asigna el primer tipo de grupo con el primer typeValue en la solicitud.
Implementación
D2L.IM.IPSIS.LIS.RequestAdapters.GMS.Default.GroupRequestTypeValueIdRequiredTranslator
Comportamiento esperado
El traductor realiza las siguientes tareas:
- Agrega el Esquema de OrgUnitType desde el primer typeValue de grouptype.
- El proceso continúa con el traductor siguiente.
|
Propiedad
|
Objeto de resultados de traducción
|
Esquema de solicitud del LIS
|
|
Tipo
|
result.LISGroupType
|
groupRecord.group.groupType.typeValue{0}.id.textString
|
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 (o un reemplazo personalizado) siempre debe estar configurado.
GroupRequestNameShortDescRequiredTranslator
El traductor GroupRequestNameShortDescRequiredTranslator requiere y asigna el nombre según la descripción breve.
Implementación
D2L.IM.IPSIS.LIS.RequestAdapters.GMS.Default.GroupRequestNameShortDescRequiredTranslator
Comportamiento esperado
El traductor realiza las siguientes tareas:
- Actualiza el OrgUnitName para contener el valor de la descripción breve en la solicitud.
- El proceso continúa con el traductor siguiente.
|
Propiedad
|
Objeto de resultados de traducción
|
Esquema de solicitud del LIS
|
|
Nombre
|
result.Entity.Name
|
groupRecord.group.description.shortDescription
|
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.
GroupRequestNameLongDescRequiredTranslator
El traductor GroupRequestNameLongDescRequiredTranslator requiere y asigna el nombre según la descripción larga.
Implementación
D2L.IM.IPSIS.LIS.RequestAdapters.GMS.Default.GroupRequestNameRequiredLongDescTranslator
Comportamiento esperado
El traductor realiza las siguientes tareas:
- Actualiza el OrgUnitName para contener el valor de la descripción larga en la solicitud.
- El proceso continúa con el traductor siguiente.
|
Propiedad
|
Objeto de resultados de traducción
|
Esquema de solicitud del LIS
|
|
Nombre
|
result.Entity.Name
|
groupRecord.group.description.longDescription
|
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.
GroupRequestNameLongDescOptionalTranslator
El traductor GroupRequestNameLongDescOptionalTranslator establece el nombre en función de la descripción larga, si existe.
Implementación
D2L.IM.IPSIS.LIS.RequestAdapters.GMS.Default.GroupRequestNameLongDescOptionalTranslator
Comportamiento esperado
El traductor realiza las siguientes tareas:
- Actualiza el OrgUnitName para contener el valor de la descripción larga en la solicitud, si existe.
- El proceso continúa con el traductor siguiente.
|
Propiedad
|
Objeto de resultados de traducción
|
Esquema de solicitud del LIS
|
|
Nombre
|
result.Entity.Name
|
groupRecord.group.description.longDescription
|
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.
GroupRequestNameShortDescOptionalTranslator
El traductor GroupRequestNameShortDescOptionalTranslator establece el nombre en función de la descripción breve, si se provee.
Implementación
D2L.IM.IPSIS.LIS.RequestAdapters.GMS.Default.GroupRequestNameShortDescOptionalTranslator
Comportamiento esperado
El traductor realiza las siguientes tareas:
- Actualiza el OrgUnitName para contener el valor de la descripción breve en la solicitud, si existe.
- El proceso continúa con el traductor siguiente.
|
Propiedad
|
Objeto de resultados de traducción
|
Esquema de solicitud del LIS
|
|
Nombre
|
result.Entity.Name
|
groupRecord.group.description.shortDescription
|
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.
GroupRequestCreateRecordFromSourcedIdRequiredTranslator
El traductor GroupRequestCreateRecordFromSourcedIdRequiredTranslator crea un registro de grupo válido si todo lo que se pasó se encontraba en el sourcedId.
Implementación
D2L.IM.IPSIS.LIS.RequestAdapters.GMS.Default.GroupRequestCreateRecordFromSourcedIdRequiredTranslator
Comportamiento esperado
El traductor realiza las siguientes tareas:
- Si no existe un registro de grupos válidos en la solicitud, el traductor crea un registro de grupos ficticio; para ello, utiliza el sourcedId de la shortDescription y selecciona el tipo, de forma predeterminada, en Departamento.
- El proceso continúa con el traductor siguiente.
Nota de configuración
Este traductor debe ubicarse directamente después del traductor Base.
GroupRequestTruncateOrgUnitCodeTranslator
El traductor GroupRequestTruncateOrgUnitCodeTranslator 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.GroupRequestTruncateOrgUnitCodeTranslator
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.