Regras e descrições de validação
Regras de correspondência e validação por tipo de dados
| Tipo de dados | Regra correspondente | Regra de validação | Valor armazenado |
|---|---|---|---|
| ID exclusiva * | Confidencial de Caso | Conforme recebido | |
| ENUM** | Caso Insensível | Corresponder a maiúsculas minúsculas | Como camelCase |
| Cadeia de caracteres | Confidencial de Caso | Conforme recebido | |
| Para baixar o caso | RFC 5532 (3.4.1) | Para baixar o caso | |
| Date ou DateTime | ISO8601 | ISO8601 | ISO8601 |
| Telefone | E.164 | E.164 | Conforme recebido |
| Booliano | Caso Insensível | Corresponder a 'true' ou 'false' | Para baixar o caso |
*O registro é exclusivo em todos os registros. Identificador globalmente exclusivo, embora possa ou não assumir a forma de um UUID (identificador exclusivo universal).
** Os zeros principais '0' ausentes no valor de entrada do ENUM de nível de grau, por exemplo, '1', corresponderão à lista de valor (ENUM) definida '01' e serão armazenados como '01'.
** Para obter mais informações de valores ENUM padrão, consulte a Lista Padrão de Valores.
Espere que os campos de telefone e SMS sejam formatados com base no padrão E.164 em que o caractere plus é usado e bem-sucedido pelo número de telefone, ou melhor, o caractere plus seguido pelo código do país, código de área, prefixo telefônico e número de linha. (Exemplo: +1234567890)
Regras e descrições
| Nome da regra | Descrição da regra | Status | Ação de regra | Exemplo de mensagem amigável | Gerado de (origem ou gravação para Microsoft Entra ID) |
|---|---|---|---|---|---|
| Erro interno do aplicativo | Ocorreu um erro inesperado. | Erro catastrófico | Interrompe a execução de dados | Houve um erro de aplicativo ao tentar processar: {error} | Conectar dados & Gerenciar dados |
| Arquivo Não Encontrado | Não foi possível encontrar um arquivo necessário. | Erro catastrófico | Interrompe a execução de dados | Não é possível encontrar {expectedFileName} no caminho: {Path}. Marcar o caminho de {Name} para garantir que {expectedFileName} exista ou o nome do arquivo seja {expectedFileName} e execute novamente a sincronização. | Conectar dados |
| Operação Cancelada | Ocorreu um problema durante a execução de dados que exigia que ele fosse cancelado. | Erro catastrófico | Interrompe a execução de dados | A operação foi cancelada com a mensagem: {cancelMessage} | Conectar dados |
| Cabeçalho não existe | Para garantir que um arquivo formatado corretamente esteja sendo enviado para processamento que contenha os cabeçalhos de arquivo definidos. | Erro catastrófico | Interrompe a execução de dados | Não é possível localizar {expectedHeaderName} em {fileName}. Corrija o extrato para adicionar ou verifique se ele é lido como {expectedHeaderName}. Carregue arquivos corrigidos e execute novamente a sincronização. | Conectar dados |
| Coluna duplicada no cabeçalho | Para garantir que um arquivo formatado corretamente esteja sendo enviado para processamento que contém o cabeçalho de arquivo definido e não vários de um mesmo cabeçalho. | Erro catastrófico | Interrompe a execução de dados | Dois ou mais {expectedHeaderName} foram encontrados em {fileName}. Corrija extrair, carregar arquivos corrigidos e executar novamente a sincronização. | Conectar dados |
| Formato de arquivo inválido | Quando arquivos não compatíveis ou uma pasta estiver presente no arquivo compactado (zip). | Erro catastrófico | Interrompe a execução de dados | Falha na validação de arquivo. Arquivo não compatível {fileInArchive} encontrado no arquivo {archiveName}. | Conectar dados |
| Arquivos duplicados encontrados | Quando o arquivo contém um arquivo que também é carregado fora do arquivo. Exemplo: users.csv e users.zip são carregados e users.zip também contém users.csv. | Erro catastrófico | Interrompe a execução de dados | Falha na validação de arquivo. Duplicar {fileInArchive} encontrado no arquivo {archiveName} e no arquivo externo. | Conectar dados |
| Arquivo duplicado encontrado | Quando arquivos duplicados são encontrados em vários arquivos. Exemplo: users.zip e relationship.zip são carregados e relationship.zip também contém users.csv. | Erro catastrófico | Interrompe a execução de dados | Falha na validação de arquivo. Duplicar {fileInArchive} encontrado em arquivos {archiveName1}, {archiveName2}. | Conectar dados |
| Mapeamento de referência cruzada não encontrado | Valida que os dados vinculados são encontrados entre os dados associados que estão sendo fornecidos (exemplo: organização ausente para um usuário, seção ausente para registros). | Erro | Remove o registro da postagem | Um registro {entityType} não pôde ser encontrado para {record} da origem [{fileName}/{apiEndPoint}]. Confirme se o sourcedId {entityType} e {record} sourcedId estão corretos ou atualizam dados no sistema de origem e reexame sincronização. | Conectar dados & Gerenciar dados |
| Mapeamento de referência cruzada opcional não encontrado | Valida que os dados vinculados são encontrados entre os dados associados que estão sendo fornecidos (exemplo: organização ausente para um usuário, seção ausente para registros). | Aviso | Remove o valor do registro, envia registro para postagem | O valor de referência opcional inválido {value} no campo {field} para {entityType} foi encontrado para {record} e o valor foi retirado do registro para continuar com o processamento. Confirme se o sourcedId {entityType} e {record} sourcedId estão corretos ou atualizam dados no sistema de origem e reexame sincronização. | Conectar dados |
| Erro de formato de data/hora | Para garantir que os valores de dados que estão sendo passados tenham o formato adequado (ISO8601). | Erro | Remove o registro da postagem | O {record} em {field} da origem [{fileName}/{apiEndPoint}] tem uma data que não está no formato adequado: 'YYYYY-MM-DD'. | Conectar dados & Gerenciar dados |
| Dados obrigatórios ausentes | Para detectar o valor ausente em um campo necessário para um registro. | Erro | Remove o registro da postagem | Um valor necessário para {record} está ausente no nome do campo: {field} da origem [{fileName}/{apiEndPoint}] para criar o registro. | Conectar dados & Gerenciar dados |
| Erro de valor de formato | Para garantir que os dados que estão sendo passados em um campo correspondam à formatação definida. Confira também regras de correspondência e validação por tipo de dados. | Erro | Remove o registro da postagem | O {record} encontrado em {field} da origem [{fileName}/{apiEndPoint}] não tem um valor formatado corretamente para {field}. | Conectar dados & Gerenciar dados |
| Erro de análise | Para garantir que para cada registro possamos associar os dados na coluna correta. Os registros podem ser sinalizados devido a vírgulas únicas, retornos de transporte encontrados ou citações ausentes. | Erro | Remove o registro da postagem | Não é possível analisar [se api: {apiEndpoint}] da origem [{fileName}/{apiEndPoint}] para localizar dados em colunas. Verifique se o delimitador no arquivo é uma vírgula única (,) e que o transporte retorna em campos não é permitido. Os campos que contêm vírgulas e aspas duplas devem ser fechados em aspas duplas. Se aspas duplas forem usadas para incluir um campo, uma citação dupla que aparece dentro do campo deverá ser escapada precedendo-a com outra citação dupla. | Conectar dados |
| Restrição máxima de comprimento do campo violada | Para garantir que os dados que estão sendo passados não excedam o comprimento do campo, resultando em dados ausentes. | Erro | Remove o registro da postagem | O valor fornecido para {field} em {record} excede o comprimento máximo com suporte dos caracteres {length}. | Conectar dados |
| Código de referência inválido ou ausente | Identifica se o valor de referência de um campo necessário [Enum] sendo passado para um registro não for encontrado para associar o registro. | Erro | Remove o registro da postagem | O valor {refValue} para {field} em {record} não é encontrado em {refCodeEntity}. Corrija o sistema de origem. | Conectar dados |
| Código de referência opcional inválido | Identifica se o valor de referência de um campo opcional [Enum] que está sendo passado para um registro não for encontrado para associar o registro. | Aviso | Remove o valor do registro, envia registro para postagem | O valor {refValue} para {field} em {record} não é encontrado em {refCodeEntity}. Corrija o sistema de origem. | Conectar dados |
| Valor obrigatório correspondente ausente de dados opcionais | Para garantir que, se um registro estiver passando um valor para dados opcionais, todos os dados associados adicionais que agora exigem um valor também estar presente também estarão sendo fornecidos. | Aviso | Remove o valor do registro, envia registro para postagem | Um valor foi fornecido em um campo opcional para {record} mas não há um valor correspondente no campo associado para postar os dados com êxito. | Conectar dados |
| Referência circular | Para garantir que, se um registro tiver uma associação pai, uma referência circular não tenha sido fornecida. | Aviso | Remove o valor do registro, envia registro para postagem | {entityType} {entityId} está vinculado em uma referência circular com {entityType}(s) {entityList}. O valor de {entityParentIdField} será retirado do registro para continuar com o processamento. | Conectar dados |
| Identificador de mapeamento de usuário não encontrado | Para garantir que um valor exista com base nas regras de identidade do usuário configuradas. | Erro | Registro removido da postagem | O identificador de mapeamento de usuário {identifierType} não foi encontrado para o usuário {record}. | Conectar dados |
| Mapeamento de usuário de várias correspondências encontradas | Se várias contas Microsoft Entra forem consideradas correspondentes para esse usuário, somente a primeira conta do AAD será usada para a correspondência. As correspondências adicionais serão descartadas. | Erro | Remove registros secundários da postagem | O usuário {record} com o identificador de mapeamento {identifierType}={value} encontrou várias correspondências em Microsoft Entra ID. Somente a primeira correspondência encontrada será usada, consulte Microsoft Entra ObjectId {AadObjectId}. | Conectar dados |
| Correspondências conflitantes de mapeamento de usuário encontradas | Para evitar a associação automatizada de um usuário diferente a uma conta Microsoft Entra existente e correspondente. | Erro | Remove o registro da postagem | O usuário {record} com o identificador de mapeamento {identifierType}={value} é correspondido a um Microsoft Entra mapeado existente ObjectId {AadObjectId}. A correspondência existente encontrada será usada e essa correspondência será ignorada. | Conectar dados |
| Correspondência do usuário com Microsoft Entra ID não encontrada | Notifica que um registro de usuário fornecido não foi capaz de encontrar uma correspondência com um usuário Microsoft Entra com base no usuário/identificar regras correspondentes configuradas. | Aviso | Registro não correspondido a Microsoft Entra ID | O usuário {record} com o identificador de mapeamento {identifierType}={value} não foi correspondido a nenhum Microsoft Entra Usuário. Isso pode ser que o valor fornecido esteja incorreto do Sistema de Origem com base nas regras de identidade de usuário configuradas ou o Azure Active Directory Sync ainda não tenha adicionado o usuário antes da execução mais recente. | Conectar dados |
| Associação de Usuário Ausente | Notifica que um registro de usuário é fornecido, mas não está associado como uma função Aluno ou Funcionário a uma organização ou função De contato com um aluno. | Aviso | Remove o registro da postagem | O usuário {record} da origem [{fileName}/{apiEndPoint}] está ausente de uma organização & dados de associação de função ou dados de associação de relacionamento de contato. Se este for um usuário válido, atualize os dados de origem para fornecer as associações de Função de & de Organização ou Relações de Contato adequadas. | Conectar dados |
| Função primária não especificada | Notifica que vários registros de função são fornecidos para um usuário, mas um deles não está marcado como a função Primária. | Aviso | O registro é adicionado conforme recebido | Vários registros de função da origem [{fileName}/{apiEndPoint}] para o usuário {record} foram encontrados sem denotar uma das funções como a função Primária para a mesma organização. Recomendamos especificar uma das funções desse usuário como Primário da origem | Conectar dados |
| Várias funções primárias especificadas | Notifica que vários registros de função são fornecidos e vários são marcados como a função Primária | Aviso | O registro é adicionado conforme recebido | Vários registros de função da origem [{fileName}/{apiEndPoint}] para o usuário {record} foram encontrados e definidos como a função Primária para a mesma organização. Recomendamos especificar uma das funções desse usuário como Primária da origem. | Conectar dados |
| Associação de Grupo de Funções Ausentes da Função de Usuário | Identifica que o de um usuário foi fornecido com uma função válida, mas a função não está associada a um Grupo de Funções, como tal, não sei quais regras correspondentes devem ser usadas. | Erro | Remove o registro da postagem | O usuário {record} da origem [{fileName}/{apiEndPoint}] está associado a uma função válida {value} mas a função não está associada a um Grupo de Funções. Você precisa atualizar sua Lista de Valores para associar o {value} a um Grupo de Funções. | Conectar dados |
| Erro geral de dados de postagem | Ao enviar o registro, um erro foi retornado. | Erro | Remove o registro da postagem | Não é possível adicionar {record} devido a {error}. Marcar ou atualize o sistema de origem para corrigir. | Conectar dados |
| Erro de formato UPN | Notifica que o Nome da Entidade de Usuário usado ou gerado não é formatado corretamente para atender aos requisitos Microsoft Entra. | Erro | Registro não postado no Microsoft Entra ID | O registro de usuário: {record} não tem um nome de entidade de usuário formatado corretamente: {value} para criar um objeto de usuário no Microsoft Entra ID. Corrija os dados do registro desse usuário no sistema de origem com base nos campos selecionados para a configuração nome de usuário. | Gerenciar dados |
| Microsoft Entra valor da propriedade inválida | Notifica que caracteres inválidos estavam presentes por que tentar escrever para Microsoft Entra ID | Erro | Registro não postado no Microsoft Entra ID | Não é possível criar ou atualizar {record} no Active Directory devido a uma ou mais propriedades inválidas. Verifique os valores do {record} em {field} para garantir que eles contenham apenas caracteres numéricos alfa e nenhum whitespace e menos de 256 caracteres. Corrija dados no sistema de origem ou ative a configuração para Substituir caracteres especiais em {FlowName}. | Gerenciar dados |
| Licença dependente ausente | Notifica que uma licença dependente não foi atribuída ao registro. | Erro | Registro não postado no Microsoft Entra ID | No momento, uma licença dependente não está atribuída ao {record}. Por exemplo , a licença de sala de aula exige que o {record} já deve ter uma licença para Exchange Online e SharePoint Online. Resolva isso atribuindo a licença dependente e a sincronização de repetição. | Gerenciar dados |
| Sem licenças disponíveis | Notifica que não havia licenças para atribuir ao usuário. | Erro | Registro não licenciado | Falha ao atribuir uma licença ao {record}. A licença está expirada ou esgotada (todas as licenças disponíveis desse tipo foram atribuídas). Corrija adicionando mais licenças de {licenseType} e rerun sync. | Gerenciar dados |
| O último proprietário do grupo não pode ser removido | Notifica que não há registros de proprietário para um Grupo de Classe de Equipe sincronizado existente. | Erro | Registro não removido de Microsoft Entra ID | {record} não pôde ser removido de um {teamsType} porque um {teamsType} deve ter pelo menos um proprietário. Marcar ou atualize dados no sistema de origem ou marcar seleções de filtro para garantir que pelo menos um proprietário seja atribuído. | Gerenciar dados |
| Tamanho do recurso excedido | Notifica que um registro tem muitas associações de organizações. | Erro | Registro não postado no Microsoft Entra ID | {record} foi atribuído a muitas escolas (mais de 30). Remova a associação do {record} das escolas que não são mais necessárias. | Gerenciar dados |
| Entradas de destino duplicadas | Notifica que existem dois ou mais registros com a mesma sourceId no Microsoft Entra ID. | Erro | Registro não postado no Microsoft Entra ID | Existem dois ou mais registros com o mesmo sourcedId para {record} no Active Directory. Identifique e remova a identidade incorreta. | Gerenciar dados |
| Nenhuma correspondência de Microsoft Entra encontrada | Notifica que o link não pôde ser adicionado da Origem ao Microsoft Entra ID porque o destino não foi encontrado no Microsoft Entra ID. | Erro | Registro não vinculado a Microsoft Entra ID | {record} não pode ser atualizado, pois nenhuma entrada correspondente no Active Directory foi encontrada. Verifique os critérios de correspondência de identidade para o fluxo de entrada. | Gerenciar dados |
| Objeto existente encontrado | Notifica que já há um link encontrado para a mesma sourceId no Microsoft Entra ID. | Erro | Registro não postado no Microsoft Entra ID | {record} para {entityType} já foi criado no passado com o mesmo sourcedId. Retire ou remova o velho {entityType}. | Gerenciar dados |
| Formato de nome de entidade inválido | Notifica que o link não pôde ser adicionado devido ao formato inesperado encontrado no Nome da Entidade de Usuário que está sendo gerado. | Erro | Registro não vinculado a Microsoft Entra ID | {record} não pode ser atualizado, pois nenhuma entrada correspondente no Active Directory foi encontrada. O formato do nome da entidade de usuário é inesperado. | Gerenciar dados |
| Não é possível sincronizar objetos de propriedade local | Notifica que o locatário está usando o Azure Active Directory Sync de um locatário local para o Microsoft 365 que uma alteração vista para um valor de usuário no AAD não será atualizada dos dados de origem. | Erro | Registro não postado no Microsoft Entra ID | Não é possível atualizar propriedades (como: primeiro nome) para {record} que estão sendo sincronizadas de um Active Directory local. Primeiro, faça a alteração no Active Directory local. | Gerenciar dados |
| IDs de grupo de segurança duplicadas | Notifica o locatário de que uma Id de Grupo de Segurança duplicada foi gerada após a remoção de caracteres especiais que não são permitidos em Microsoft Entra ID e não podem criar o Grupo de Segurança adicional. | Erro | Registro não postado no Microsoft Entra ID | Vários grupos de segurança têm valores de identificador duplicados {identifierSource} depois que caracteres especiais foram removidos para org sourcedId: {identifierValue}. | Gerenciar dados |