Estado de funcionamento e monitorização da sincronização
Home dashboard
Durante o processamento de dados, o School Data Sync (SDS) valida os dados ao introduzir bons dados nos dados da cache e sinalizar dados incorretos. No final de cada execução de sincronização, são geradas estatísticas para ajudar no estado de funcionamento e na monitorização.
Para determinar o estado de funcionamento dos dados, é transmitido através das regras de correspondência e validação de dados para ajudar a salvaguardar os dados necessários e opcionais que só entram na cache. Os dados que não passam na validação são identificados como erros ou avisos e não são enviados para a cache.
Se não forem encontrados erros ou avisos, o resultado da execução será Concluído. A home dashboard indicará "Nenhum Erro de Dados ou Avisos Encontrados" e "Não encontrámos erros ou avisos de dados durante a última execução. Mantenha o grande trabalho!"
Se forem encontrados erros e avisos, o resultado da execução será Concluído com erros.
- O erro é gerado quando um valor num registo para os dados necessários não passou uma regra de correspondência e validação de dados ou de validação; o registo foi removido e não foi enviado para a cache.
Se só forem encontrados avisos, o resultado da execução será Concluído com avisos.
- O aviso é gerado quando um valor num registo para dados opcionais não passou uma regra de correspondência e validação de dados ou de validação; o valor foi removido, mas o registo foi enviado para a cache.
O Dashboard Base informa que "Encontrámos alguns problemas com os seus dados" e incentiva-o a Investigar o estado de funcionamento da Sincronização. Para obter mais informações sobre os resultados da execução de Sincronização, selecione Investigar o estado de funcionamento da sincronização.
Estado de funcionamento da sincronização
Descrição geral do estado de funcionamento da sincronização
O estado de funcionamento da sincronização é uma ferramenta que o ajuda a compreender melhor o estado de funcionamento dos seus dados sincronizados e a ajudar nas investigações de dados.
As alterações aos dados ocorrem com base nas alterações de dados da execução de sincronização mais recente.
Uma execução de sincronização é a sequenciação das configurações de ligação e gestão de dados.
O estado de funcionamento da sincronização também fornece uma representação histórica das últimas 14 execuções.
- Início da execução: carimbo de data/hora quando a execução geral começou
- Fim da execução: carimbo de data/hora quando a execução geral terminou
- Executar status: status geral em todos os fluxos de dados
- Em execução: execução ativa
- Concluído: concluído sem erros ou avisos
- Concluído com Erros: Concluído, mas foram encontrados erros
- Concluído com Avisos: Concluído, mas apenas foram encontrados avisos
- Falha: Executar cancelada pelo sistema ou pelo cliente
Para investigar os dados sinalizados, pode selecionar Transferir relatório para obter uma cópia do relatório.
O relatório é formatado da seguinte forma:
| Nome da Coluna | Descrição | Exemplo |
|---|---|---|
| Regra | Representação da Regra de Validação | RequiredDataViolated |
| ExternalIdentifier | ID externo/de origem da entidade relacionada do sistema de origem | 7B2C8A0B33-F7E5-460B-993A-7257165430F7 |
| Severity | Representação da gravidade dos dados sinalizados | Erro de Validação, Aviso de Validação |
| EntityCode | Representação da área relacionada com o erro | Pessoa, Organização, Inscrição |
| FriendlyMessage | Com base em Mensagens de Erro e Aviso | Falta um valor necessário para {record} no nome do campo: {field} da origem [{fileName}/{apiEndPoint}] para criar o registo. |
| FlowName | Nome do fluxo de Entrada ou Saída | Entrada da API OneRoster |
| SourceSystemName | Nome da Origem de onde veio o registo | Contoso SIS |
| Time | Dados/Hora em que o registo foi identificado durante o processamento, UTC. | 2023-08-21T02:53:00Z |
- Para obter mais informações sobre a correspondência de dados e regras de validação, veja Regras de Validação e Descrições.
- Para obter mais informações sobre a Lista de Valores predefinida suportada, veja Lista Predefinida de Valores.
- familyName, givenName e e-mail são necessários para utilizadores que tenham funções de contacto/tutor.
- Espera-se que o telefone e sms estejam na E.164 e + têm de ser incluídos. (Exemplo: +1234567890)
Dica
Para carregar manualmente as alterações após a primeira execução para atualizar os dados de origem, consulte Carregamento Manual de CSV com o School Data Sync.
Aviso
O número máximo de carregamentos com uma execução correspondente é seis vezes por dia de calendário. Depois disso, se carregar, este só será executado mais duas vezes com base na cadência de execução automatizada do SDS de 12 em 12 horas.
Priorizar erros de remediação
Ao resolver erros, recomendamos que priorize os erros de validação com a maioria das instâncias para o mesmo código de entidade antes de resolver outros erros.
Os erros de validação podem resultar em inúmeros erros subsequentes para cada instância na mesma execução de dados. Muitas vezes, remediar estes erros de validação primeiro remedia muitos erros relacionados com a lista que são encontrados durante a validação.
Detalhes da vista de estado de funcionamento da sincronização
Descrição Geral dos Detalhes da Sincronização
Para ver as estatísticas da execução, pode selecionar Ver detalhes para abrir uma lista de opções para ver Os detalhes da execução. As estatísticas da execução são apresentadas no separador Descrição geral .
Fases de Detalhes de Sincronização
As fases são uma ferramenta que fornece informações sobre a execução selecionada à medida que avança em cada uma das fases da execução de sincronização ativa. As informações apresentadas como uma fase são concluídas e outra é iniciada.
Dependendo do tamanho dos dados, uma fase pode estar no estado "em execução" durante um longo período de tempo.
Observação
Para obter mais informações, veja Estatísticas Institucionais e De execução em estatísticas encontradas em Detalhes da execução.
Como o SDS determina os dados que estão presentes e define status ativos
A associação de um utilizador a uma organização baseia-se na respetiva função, associada a uma organização.
A associação de um utilizador a uma classe baseia-se na função associada a uma inscrição.
Com base nos dados ligados, estas regras são utilizadas para determinar a deteção do registo e da respetiva sessão status no arquivo de dados.
- Os dados refletem quando um novo registo é apresentado pela primeira vez.
- O SDS define a primeira data (hora) vista e a data da última modificação (hora) como atual.
- Os dados refletem quando o mesmo registo está presente na execução subsequente.
- O SDS preserva o valor de data (hora) visto pela primeira vez, defina a data da última modificação (hora) como atual.
- Os dados refletem quando o mesmo registo não está presente numa execução subsequente.
- O SDS preserva a primeira data (hora) vista e os últimos valores de data (hora) modificados.
- As exceções ocorrem quando as organizações, as pessoas (utilizadores) e os registos de sessão persistem ao longo do tempo e não são inativos.
- Existem atualizações sem interrupção para "inativado". Por exemplo, se um registo de utilizador não estiver presente, o sistema preserva os valores existentes de data (hora) e data (hora) da última modificação.
- O SDS preserva a primeira data (hora) vista e os últimos valores de data (hora) modificados.
Observação
Para obter mais informações sobre o processamento de dados, veja Validate and Data Health on SDS Overview (Descrição Geral da Validação e do Estado de Funcionamento dos Dados no SDS).