A interface ITranslateGroup é usada para traduzir um Registro de grupo do LIS em um OrgUnit do Brightspace.
A implementação da interface é D2L.IM.IPSIS.LIS.GMS.ITranslateGroup.
A seguinte lista de configuração fornece um ponto de partida para qualquer implementação do LIS.
Modelo, IPSIS
- GroupRequestBaseTranslator (Ordem de classificação = 10)
- GroupRequestTypeValueIdRequiredTranslator (Ordem de classificação = 20)
- GroupRequestNameShortDescRequiredTranslator (Ordem de classificação = 30)
GroupRequestBaseTranslator
O GroupRequestBaseTranslator mapeia o ID do grupo.
Implementação
D2L.IM.IPSIS.LIS.RequestAdapters.GMS.Default.GroupRequestBaseTranslator
Comportamento esperado
O tradutor realiza as seguintes tarefas:
- Configura OrgUnitCode e OrgUnitName para o valor fornecido no sourcedGUID.sourcedid.
- Continua o processamento para o próximo tradutor.
|
Propriedade
|
Objeto de resultado da tradução
|
Mapeamento da solicitação do LIS
|
|
Código
|
result.Entity.Code
|
groupRecord.sourcedGUID.sourcedId
|
|
Nome
|
result.Entity.Name
|
groupRecord.sourcedGUID.sourcedId
|
Comportamento de erro
Se houver um problema durante o processamento, um IncompleteRequestException será lançado. Isso resulta em:
- Suspensão de todo processamento adicional.
- Um cabeçalho de resposta do LIS contendo:
- CodeMajor = failure.
- Severity = status.
- CodeMinor = invaliddata.
Nota sobre a configuração
Esse tradutor (ou um tradutor base alternativo) deve ser configurado em primeiro lugar na lista de tradutores.
GroupRequestTypeValueIdRequiredTranslator
O GroupRequestTypeValueIdRequiredTranslator requer e mapeia o primeiro tipo de grupo usando o primeiro typeValue na solicitação.
Implementação
D2L.IM.IPSIS.LIS.RequestAdapters.GMS.Default.GroupRequestTypeValueIdRequiredTranslator
Comportamento esperado
O tradutor realiza as seguintes tarefas:
- Adiciona o Mapeamento de OrgUnitType do primeiro grouptype typeValue.
- Continua o processamento para o próximo tradutor.
|
Propriedade
|
Objeto de resultado da tradução
|
Mapeamento da solicitação do LIS
|
|
Tipo
|
result.LISGroupType
|
groupRecord.group.groupType.typeValue{0}.id.textString
|
Comportamento de erro
Se houver um problema durante o processamento, um IncompleteRequestException será lançado. Isso resulta em:
- Suspensão de todo processamento adicional.
- Um cabeçalho de resposta do LIS contendo:
- CodeMajor = failure.
- Severity = status.
- CodeMinor = invaliddata.
Notas sobre a configuração
- Esse tradutor pode ser posicionado em qualquer lugar depois do tradutor base.
- Esse tradutor (ou uma substituição personalizada) sempre deve ser configurado.
GroupRequestNameShortDescRequiredTranslator
O GroupRequestNameShortDescRequiredTranslator requer e mapeia o nome com base na descrição curta.
Implementação
D2L.IM.IPSIS.LIS.RequestAdapters.GMS.Default.GroupRequestNameShortDescRequiredTranslator
Comportamento esperado
O tradutor realiza as seguintes tarefas:
- Atualiza o OrgUnitName para conter o valor da descrição curta na solicitação.
- Continua o processamento para o próximo tradutor.
|
Propriedade
|
Objeto de resultado da tradução
|
Mapeamento da solicitação do LIS
|
|
Nome
|
result.Entity.Name
|
groupRecord.group.description.shortDescription
|
Comportamento de erro
Se houver um problema durante o processamento, um IncompleteRequestException será lançado. Isso resulta em:
- Suspensão de todo processamento adicional.
- Um cabeçalho de resposta do LIS contendo:
- CodeMajor = failure.
- Severity = status.
- CodeMinor = invaliddata.
Nota sobre a configuração
Esse tradutor pode ser posicionado em qualquer lugar depois do tradutor base.
GroupRequestNameLongDescRequiredTranslator
O GroupRequestNameLongDescRequiredTranslator requer e mapeia o nome com base na descrição longa.
Implementação
D2L.IM.IPSIS.LIS.RequestAdapters.GMS.Default.GroupRequestNameRequiredLongDescTranslator
Comportamento esperado
O tradutor realiza as seguintes tarefas:
- Atualiza o OrgUnitName para conter o valor da descrição longa na solicitação.
- Continua o processamento para o próximo tradutor.
|
Propriedade
|
Objeto de resultado da tradução
|
Mapeamento da solicitação do LIS
|
|
Nome
|
result.Entity.Name
|
groupRecord.group.description.longDescription
|
Comportamento de erro
Se houver um problema durante o processamento, um IncompleteRequestException será lançado. Isso resulta em:
- Suspensão de todo processamento adicional.
- Um cabeçalho de resposta do LIS contendo:
- CodeMajor = failure.
- Severity = status.
- CodeMinor = invaliddata.
Nota sobre a configuração
Esse tradutor pode ser posicionado em qualquer lugar depois do tradutor base.
GroupRequestNameLongDescOptionalTranslator
O GroupRequestNameLongDescOptionalTranslator configurará o nome com base na descrição longa, se ela existir.
Implementação
D2L.IM.IPSIS.LIS.RequestAdapters.GMS.Default.GroupRequestNameLongDescOptionalTranslator
Comportamento esperado
O tradutor realiza as seguintes tarefas:
- Atualizará o OrgUnitName para conter o valor da descrição longa na solicitação, se ele existir.
- Continua o processamento para o próximo tradutor.
|
Propriedade
|
Objeto de resultado da tradução
|
Mapeamento da solicitação do LIS
|
|
Nome
|
result.Entity.Name
|
groupRecord.group.description.longDescription
|
Comportamento de erro
Se houver um problema durante o processamento, um IncompleteRequestException será lançado. Isso resulta em:
- Suspensão de todo processamento adicional.
- Um cabeçalho de resposta do LIS contendo:
- CodeMajor = failure.
- Severity = status.
- CodeMinor = invaliddata.
Nota sobre a configuração
Esse tradutor pode ser posicionado em qualquer lugar depois do tradutor base.
GroupRequestNameShortDescOptionalTranslator
O GroupRequestNameShortDescOptionalTranslator configurará o nome com base na descrição curta, se ela for fornecida.
Implementação
D2L.IM.IPSIS.LIS.RequestAdapters.GMS.Default.GroupRequestNameShortDescOptionalTranslator
Comportamento esperado
O tradutor realiza as seguintes tarefas:
- Atualizará o OrgUnitName para conter o valor da descrição curta na solicitação, se ele existir.
- Continua o processamento para o próximo tradutor.
|
Propriedade
|
Objeto de resultado da tradução
|
Mapeamento da solicitação do LIS
|
|
Nome
|
result.Entity.Name
|
groupRecord.group.description.shortDescription
|
Comportamento de erro
Se houver um problema durante o processamento, um IncompleteRequestException será lançado. Isso resulta em:
- Suspensão de todo processamento adicional.
- Um cabeçalho de resposta do LIS contendo:
- CodeMajor = failure.
- Severity = status.
- CodeMinor = invaliddata.
Nota sobre a configuração
Esse tradutor pode ser posicionado em qualquer lugar depois do tradutor base.
GroupRequestCreateRecordFromSourcedIdRequiredTranslator
O GroupRequestCreateRecordFromSourcedIdRequiredTranslator criará um registro de grupo válido se tudo o que foi transmitido foi o sourcedId.
Implementação
D2L.IM.IPSIS.LIS.RequestAdapters.GMS.Default.GroupRequestCreateRecordFromSourcedIdRequiredTranslator
Comportamento esperado
O tradutor realiza as seguintes tarefas:
- Se um registro de grupo válido não existia na solicitação, o tradutor criará um registro de grupo fictício, usando o sourcedId para o shortDescription e o padronizando o tipo para Departamento.
- Continua o processamento para o próximo tradutor.
Nota sobre a configuração
Esse tradutor deve ser posicionado diretamente depois do tradutor base.
GroupRequestTruncateOrgUnitCodeTranslator
O GroupRequestTruncateOrgUnitCodeTranslator truncará o código da unidade organizacional do objeto de resultado se o código tiver mais de 50 caracteres. O código truncado é configurado em 50 caracteres.
Implementação
D2L.IM.IPSIS.LIS.RequestAdapters.CMS.Default.GroupRequestTruncateOrgUnitCodeTranslator
Comportamento esperado
O tradutor realiza as seguintes tarefas:
- Verifica se o resultado.Entity.Code tem mais de 50 caracteres. Se sim, o código será truncado para 50 caracteres.
- Continua o processamento para o próximo tradutor.
Nota sobre a configuração
Esse tradutor pode ser posicionado em qualquer lugar depois do tradutor base.