Sincronizar integridade e monitoramento
Home dashboard
Durante o processamento de dados, o SDS (Sincronização de Dados Escolares) valida dados trazendo bons dados para o data lake e sinalizando dados ruins. Ao final de cada execução de sincronização, as estatísticas são geradas para ajudar na integridade e no monitoramento.
Para determinar a integridade dos dados, é passado por regras de correspondência e validação de dados para ajudar a proteger dados bons necessários e opcionais que vão apenas para o data lake. Os dados que não passam pela validação são identificados como erros ou avisos e não são enviados para o data lake.
Se não houver erros ou avisos encontrados, o resultado da execução será concluído. A dashboard inicial afirmará" Sem erros de dados ou avisos encontrados" e "Não encontramos nenhum erro de dados ou avisos durante sua última execução. Mantenha o ótimo trabalho!
Se houver erros e avisos encontrados, o resultado da execução será concluído com erros.
- O erro é gerado quando um valor em um registro para dados necessários não passa uma regra de correspondência e ou validação de dados; o registro foi removido e não enviado para o data lake.
Se houver apenas avisos encontrados, o resultado da execução será concluído com avisos.
- O aviso é gerado quando um valor em um registro para dados opcionais não passa uma regra de correspondência e ou validação de dados; o valor foi removido, mas o registro foi enviado para o data lake.
O Painel Inicial informa que "Encontramos alguns problemas com seus dados" e incentivamos você a investigar a integridade da sincronização. Para obter mais informações sobre os resultados da execução Sincronização, selecione Investigar integridade de sincronização.
Integridade de sincronização
A integridade da sincronização é uma ferramenta para ajudar você a entender melhor a integridade dos dados sincronizados e ajudar nas investigações de dados.
As alterações nos dados ocorrem com base nas alterações de dados da execução de sincronização mais recente.
Uma execução de sincronização é o sequenciamento de conexão e gerenciamento de configurações de dados.
A integridade de sincronização também fornece uma representação histórica das últimas 14 execuções.
- Início da execução: carimbo de hora quando a execução geral começou
- Final da execução: carimbo de hora quando a execução geral terminou
- Executar status: status geral em todos os fluxos de dados
- Execução: execução ativa
- Concluído: concluído sem erros ou avisos
- Concluído com erros: concluídos, mas erros foram encontrados
- Concluído com avisos: concluídos, mas somente avisos foram encontrados
- Falha: executar cancelado por sistema ou cliente
Para investigar os dados sinalizados, você pode selecionar Baixar relatório para recuperar uma cópia do relatório.
O relatório é formatado da seguinte maneira:
| Nome da Coluna | Descrição | Exemplo |
|---|---|---|
| Regra | Representação da Regra de Validação | RequiredDataViolated |
| ExternalIdentifier | ID externa/de origem da entidade relacionada do sistema de origem | 7B2C8A0B33-F7E5-460B-993A-7257165430F7 |
| Severity | Representação de gravidade dos dados sinalizados | Erro de validação, aviso de validação |
| EntityCode | Representação da área relacionada ao erro | Pessoa, Organização, Registro |
| FriendlyMessage | Com base em mensagens de erro e aviso | Um valor necessário para {record} está ausente no nome do campo: {field} da origem [{fileName}/{apiEndPoint}] para criar o registro. |
| FlowName | Nome do fluxo de entrada ou saída | Entrada da API do OneRoster |
| SourceSystemName | Nome da origem de onde o registro veio | Contoso SIS |
| Ano | Ano Acadêmico | 2023 |
| Horário | Dados /Hora em que o registro foi identificado durante o processamento, UTC. | 2023-08-21T02:53:00Z |
- Para obter mais informações sobre regras de correspondência e validação de dados, consulte Regras e Descrições de Validação.
- Para obter mais informações sobre a lista padrão de valores com suporte, consulte Lista padrão de valores.
- familyName, givenName e email são necessários para usuários que têm funções de contato/guardião.
- Espere que o telefone e o SMS estejam no E.164 e + devem ser incluídos. (Exemplo: +1234567890)
Dica
Para carregar manualmente as alterações após a primeira execução para atualizar seus dados de origem, consulte Atualizar dados de origem com o CSV do SDS v2.1.
Aviso
O número máximo de uploads com uma execução correspondente é de seis vezes por dia calendário. Depois disso, se você carregar, ele só será executado até mais duas vezes com base na cadência de execução automatizada do SDS de cada 12 horas.
Priorizando erros para correção
Ao solucionar problemas de erros, recomendamos priorizar erros de validação com a maioria das instâncias para o mesmo código de entidade antes de solucionar problemas de outros erros.
Erros de validação podem resultar em vários erros subsequentes para cada instância na mesma execução de dados. Geralmente, corrigir esses erros de validação primeiro corrige muitos erros relacionados à lista que são encontrados durante a validação.
Sincronizar detalhes da exibição de integridade
Para ver as estatísticas da execução, você pode selecionar Exibir detalhes para abrir um fly-out para ver Executar detalhes. As estatísticas da execução são mostradas na guia Visão geral .
Para entender melhor de qual estágio os Erros e Avisos podem ter sido gerados, selecione Guia Estágios . As informações são divididas nos estágios a seguir, dependendo do que as configurações de gerenciamento de dados foram habilitadas.
Dados da instituição
Usuários do Microsoft 365
Grupos do Microsoft 365
Grupos de TI da Microsoft
Última status
- Concluído: concluído sem erros ou avisos
- Concluído com erros: concluídos, mas erros foram encontrados
- Concluído com avisos: concluídos, mas apenas avisos foram encontrados
- Falha: executar cancelado por sistema ou cliente
Observação
Para obter mais informações, consulte Estatísticas institucionais e de execução sobre estatísticas encontradas em Executar detalhes.
Como o SDS determina a presença de dados e define status ativos
Observação
Para obter mais informações sobre a configuração do Ano Acadêmico, confira Tratamento do Ano Acadêmico
A associação de um usuário a uma sessão (por exemplo, Ano Acadêmico) é baseada em sua função, vinculada a uma organização.
A associação de um usuário a uma classe baseia-se em sua função vinculada a um registro, que também inclui um link para uma sessão.
Com base nos dados conectados, essas regras são usadas para determinar a conscientização sobre o registro e suas status de sessão no armazenamento de dados.
- Os dados refletem quando um novo registro é apresentado pela primeira vez.
- O SDS define a primeira data (hora) e a última data modificada (hora) como atual e, se apropriado, marca o registro como "está ativo na sessão" para ser verdadeiro.
- Os dados refletem quando o mesmo registro está presente na execução subsequente.
- O SDS preserva o valor de data (hora) visto pela primeira vez, define a última data (hora) modificada como atual e a saída "está ativa na sessão" para ser verdadeira.
- Os dados refletem quando o mesmo registro não está presente em uma execução subsequente.
- O SDS preserva os valores de data (hora) e a última data (hora) modificadas e, se apropriado, marcar o registro como "está ativo na sessão" como false.
- Exceções acontecem quando organizações, pessoas (usuários) e registros de sessão persistem ao longo do tempo e não são inativadas.
- Há atualizações em rolamento para "inativado". Por exemplo, se um registro de usuário não estiver presente, o sistema preservará os valores de data (hora) e última data (hora) modificadas. O sistema define "está ativo na sessão" para false para os registros de organização/função e registro dos usuários.
- O SDS preserva os valores de data (hora) e a última data (hora) modificadas e, se apropriado, marcar o registro como "está ativo na sessão" como false.
Observação
Para obter mais informações sobre o tratamento de dados, consulte Validar, Armazenar e Integridade de Dados na Visão Geral do SDS.