Regole e descrizioni di convalida
Corrispondenza e regole di convalida in base al tipo di dati
| Tipo di dati | Regola di corrispondenza | Regola di convalida | Valore memorizzato |
|---|---|---|---|
| ID univoco * | Distinzione tra maiuscole e minuscole | Come ricevuto | |
| ENUM** | Senza distinzione tra maiuscole e minuscole | Corrispondenza con lettere minuscole | Come camelCase |
| Stringa | Distinzione tra maiuscole e minuscole | Come ricevuto | |
| Posta elettronica | In minuscolo | RFC 5532 (3.4.1) | In minuscolo |
| Date o DateTime | ISO8601 | ISO8601 | ISO8601 |
| Telefono | E.164 | E.164 | Come ricevuto |
| Booleano | Senza distinzione tra maiuscole e minuscole | Corrispondenza con 'true' o 'false' | In minuscolo |
*Il record è univoco in tutti i record. Identificatore univoco globale, anche se può assumere o meno la forma di un identificatore univoco universale (UUID).
** Gli zeri iniziali '0' mancanti nel valore in ingresso per l'ENUM livello di livello di livello, ad esempio '1', corrisponderanno all'elenco definito di valori (ENUM) '01' e verranno archiviati come '01'.
** Per altre informazioni sui valori ENUM predefiniti, vedere l'elenco predefinito di valori.
Si prevede che i campi telefono e SMS vengano formattati in base allo standard E.164 in cui il carattere più viene usato e completato dal numero di telefono, o piuttosto il carattere più seguito da codice paese, prefisso di area, prefisso telefonico e numero di riga. (Esempio: +1234567890)
Regole e descrizioni
| Nome regola | Descrizione regola | Stato | Azione regola | Esempio di messaggio descrittivo | Generato da (origine o scrittura in Microsoft Entra ID) |
|---|---|---|---|---|---|
| Errore interno dell'applicazione | Si è verificato un errore imprevisto. | Errore irreversibile | Arresta l'esecuzione dei dati | Errore dell'applicazione durante il tentativo di elaborazione: {errore} | Connettere i dati & gestire i dati |
| File non trovato | Impossibile trovare un file obbligatorio. | Errore irreversibile | Arresta l'esecuzione dei dati | Impossibile trovare {expectedFileName} nel percorso: {Path}. Controllare il percorso di {Name} per assicurarsi che {expectedFileName} esista o che il nome del file sia {expectedFileName} ed eseguire di nuovo la sincronizzazione. | Connettere i dati |
| Operazione annullata | Si è verificato un problema durante l'esecuzione dei dati che richiedeva l'annullamento. | Errore irreversibile | Arresta l'esecuzione dei dati | L'operazione è stata annullata con il messaggio: {cancelMessage} | Connettere i dati |
| L'intestazione non esiste | Per assicurarsi che venga inviato un file formattato correttamente per l'elaborazione che contiene le intestazioni di file definite. | Errore irreversibile | Arresta l'esecuzione dei dati | Impossibile trovare {expectedHeaderName} in {fileName}. Correggere l'estrazione per aggiungere o assicurarsi che venga letto come {expectedHeaderName}. Caricare i file corretti ed eseguire nuovamente la sincronizzazione. | Connettere i dati |
| Colonna duplicata nell'intestazione | Per assicurarsi che venga inviato un file formattato correttamente per l'elaborazione che contiene l'intestazione del file definita e non più di una o più intestazioni. | Errore irreversibile | Arresta l'esecuzione dei dati | Sono stati trovati due o più {expectedHeaderName} in {fileName}. Correggere l'estrazione, caricare i file corretti ed eseguire nuovamente la sincronizzazione. | Connettere i dati |
| Formato di file non valido | Quando i file non supportati o una cartella sono presenti nel file compresso (zip). | Errore irreversibile | Arresta l'esecuzione dei dati | Convalida archivio non riuscita. File {fileInArchive} non supportato trovato nell'archivio {archiveName}. | Connettere i dati |
| File duplicati trovati | Quando l'archivio contiene un file caricato anche all'esterno dell'archivio. Esempio: users.csv e users.zip vengono caricati e users.zip contiene anche users.csv. | Errore irreversibile | Arresta l'esecuzione dei dati | Convalida archivio non riuscita. {fileInArchive} duplicato trovato nell'archivio {archiveName} e nell'archivio esterno. | Connettere i dati |
| File duplicato trovato | Quando vengono trovati file duplicati in più archivi. Esempio: users.zip e relationship.zip vengono caricati e relationship.zip contiene anche users.csv. | Errore irreversibile | Arresta l'esecuzione dei dati | Convalida archivio non riuscita. {fileInArchive} duplicato trovato negli archivi {archiveName1}, {archiveName2}. | Connettere i dati |
| Mapping tra riferimenti non trovato | Convalida che i dati collegati vengano trovati nei dati associati forniti (ad esempio, organizzazione mancante per un utente, sezione mancante per le registrazioni). | Error | Rimuove il record dalla registrazione | Impossibile trovare un record {entityType} per {record} dall'origine [{fileName}/{apiEndPoint}]. Verificare che {entityType} sourcedId e {record} sourcedId siano corretti o aggiornare i dati nel sistema di origine ed eseguire di nuovo la sincronizzazione. | Connettere i dati & gestire i dati |
| Mapping tra riferimenti incrociati facoltativo non trovato | Convalida che i dati collegati vengano trovati nei dati associati forniti (ad esempio, organizzazione mancante per un utente, sezione mancante per le registrazioni). | Avviso | Rimuove il valore dal record, invia record per la registrazione | Valore di riferimento facoltativo {value} non valido nel campo {field} per {entityType} trovato per {record} e il valore è stato eliminato dal record per procedere con l'elaborazione. Verificare che {entityType} sourcedId e {record} sourcedId siano corretti o aggiornare i dati nel sistema di origine ed eseguire nuovamente la sincronizzazione. | Connettere i dati |
| Errore di formato data/ora | Per garantire che i valori dei dati passati abbiano il formato corretto (ISO8601). | Error | Rimuove il record dalla registrazione | Il {record} in {field} dall'origine [{fileName}/{apiEndPoint}] ha una data che non è nel formato corretto: 'AAAA-MM-DD'. | Connettere i dati & gestire i dati |
| Dati obbligatori mancanti | Per rilevare il valore mancante in un campo obbligatorio per un record. | Error | Rimuove il record dalla registrazione | Manca un valore obbligatorio per {record} nel nome del campo: {field} dall'origine [{fileName}/{apiEndPoint}] per creare il record. | Connettere i dati & gestire i dati |
| Errore del valore di formato | Per assicurarsi che i dati passati in un campo corrispondano alla formattazione definita. Vedere anche regole di corrispondenza e convalida in base al tipo di dati. | Error | Rimuove il record dalla registrazione | Il valore {record} trovato in {field} dall'origine [{fileName}/{apiEndPoint}] non ha un valore formattato correttamente per {field}. | Connettere i dati & gestire i dati |
| Errore di analisi | Per assicurarsi che per ogni record sia possibile associare i dati nella colonna corretta. I record possono essere contrassegnati a causa di virgole singole, ritorni a capo trovati o virgolette mancanti. | Error | Rimuove il record dalla registrazione | Impossibile analizzare [se api: {apiEndpoint}] dall'origine [{fileName}/{apiEndPoint}] per trovare i dati nelle colonne. Assicurarsi che il delimitatore nel file sia una singola virgola (,) e che i ritorni a capo nei campi non siano consentiti. I campi contenenti virgole e virgolette doppie devono essere racchiusi tra virgolette doppie. Se le virgolette doppie vengono usate per racchiudere un campo, è necessario che all'interno del campo venga visualizzato un carattere di escape preceduto da un'altra virgolette doppie. | Connettere i dati |
| Vincolo di lunghezza massima campo violato | Per garantire che i dati passati non superino la lunghezza del campo, i dati risultano mancanti. | Error | Rimuove il record dalla registrazione | Il valore specificato per {field} in {record} supera la lunghezza massima supportata di {length} caratteri. | Connettere i dati |
| Codice di riferimento non valido o mancante | Identifica se il valore di riferimento di un campo obbligatorio [Enum] passato per un record non è stato trovato per associare il record. | Error | Rimuove il record dalla registrazione | Il valore {refValue} per {field} in {record} non è stato trovato in {refCodeEntity}. Correggere il sistema di origine. | Connettere i dati |
| Codice di riferimento facoltativo non valido | Identifica se il valore di riferimento di un campo facoltativo [Enum] passato per un record non è stato trovato per associare il record. | Avviso | Rimuove il valore dal record, invia record per la registrazione | Il valore {refValue} per {field} in {record} non è stato trovato in {refCodeEntity}. Correggere il sistema di origine. | Connettere i dati |
| Dati facoltativi mancanti valore obbligatorio corrispondente | Per assicurarsi che, se un record passa un valore per i dati facoltativi, vengano forniti anche eventuali dati associati aggiuntivi che ora richiedono la presenza di un valore. | Avviso | Rimuove il valore dal record, invia record per la registrazione | Un valore è stato fornito in un campo facoltativo per {record} ma manca un valore corrispondente nel campo associato per registrare correttamente i dati. | Connettere i dati |
| Riferimento circolare | Per assicurarsi che se un record ha un'associazione padre che non è stato fornito un riferimento circolare. | Avviso | Rimuove il valore dal record, invia record per la registrazione | {entityType} {entityId} è collegato in un riferimento circolare con {entityType}(s) {entityList}. Il valore per {entityParentIdField} verrà eliminato dal record per procedere con l'elaborazione. | Connettere i dati |
| Identificatore del mapping utente non trovato | Per assicurarsi che esista un valore in base alle regole di identità utente configurate. | Error | Record rimosso dalla registrazione | Identificatore del mapping utente {identifierType} non trovato per l'utente {record}. | Connettere i dati |
| Mapping utente più corrispondenze trovate | Se per questo utente sono presenti più account Microsoft Entra, verrà usato solo il primo account AAD per la corrispondenza. Verranno eliminate altre corrispondenze. | Error | Rimuove i record secondari dalla registrazione | L'utente {record} con identificatore di mapping {identifierType}={value} ha trovato più corrispondenze in Microsoft Entra ID. Verrà usata solo la prima corrispondenza trovata, vedere Microsoft Entra ObjectId {AadObjectId}. | Connettere i dati |
| Trova corrispondenze in conflitto con il mapping degli utenti | Per impedire l'associazione automatica di un utente diverso a un account Microsoft Entra esistente e corrispondente. | Error | Rimuove il record dalla registrazione | L'utente {record} con identificatore di mapping {identifierType}={value} corrisponde a un oggetto mappato esistente Microsoft Entra ObjectId {AadObjectId}. Verrà usata la corrispondenza esistente trovata e questa corrispondenza verrà ignorata. | Connettere i dati |
| Corrispondenza utente con Microsoft Entra ID non trovato | Notifica che un record utente fornito non è stato in grado di trovare una corrispondenza con un utente Microsoft Entra in base all'utente/identificare le regole di corrispondenza configurate. | Avviso | Record non corrispondente a Microsoft Entra ID | L'utente {record} con identificatore di mapping {identifierType}={value} non corrisponde ad alcun utente Microsoft Entra. Questo potrebbe essere che il valore fornito non è corretto dal sistema di origine in base alle regole di identità utente configurate oppure Sincronizzazione di Azure Active Directory non ha ancora aggiunto l'utente prima dell'esecuzione più recente. | Connettere i dati |
| Associazione utente mancante | Notifica che viene fornito un record utente, ma non è associato come ruolo Studente o Personale a un'organizzazione o a un ruolo Contatto a uno studente. | Avviso | Rimuove il record dalla registrazione | L'utente {record} dall'origine [{fileName}/{apiEndPoint}] manca di dati dell'associazione di ruoli dell'organizzazione & o delle relazioni di contatto. Se si tratta di un utente valido, aggiornare i dati di origine in modo da fornire le associazioni di ruoli o relazioni di contatto & organizzazione appropriate. | Connettere i dati |
| Ruolo primario non specificato | Notifica che vengono forniti più record di ruolo per un utente, ma uno di essi non è contrassegnato come ruolo primario. | Avviso | Il record viene aggiunto come ricevuto | Sono stati trovati più record di ruolo dall'origine [{fileName}/{apiEndPoint}] per l'utente {record} senza denotare uno dei ruoli come ruolo primario per la stessa organizzazione. È consigliabile specificare uno dei ruoli di questo utente come primario dall'origine | Connettere i dati |
| Più ruoli primari specificati | Notifica che vengono forniti più record di ruolo e che più sono contrassegnati come ruolo primario | Avviso | Il record viene aggiunto come ricevuto | Sono stati trovati più record di ruolo dall'origine [{fileName}/{apiEndPoint}] per l'utente {record} e sono stati definiti come ruolo primario per la stessa organizzazione. È consigliabile specificare uno dei ruoli di questo utente come Primario dall'origine. | Connettere i dati |
| Associazione del gruppo di ruoli mancante per il ruolo utente | Identifica che a un utente è stato fornito un ruolo valido, ma il ruolo non è associato a un gruppo di ruoli, in quanto non si è certi delle regole corrispondenti da usare. | Error | Rimuove il record dalla registrazione | L'utente {record} dall'origine [{fileName}/{apiEndPoint}] è associato a un ruolo valido {value} ma il ruolo non è associato a un gruppo di ruoli. È necessario aggiornare l'elenco di valori per associare il valore {value} a un gruppo di ruoli. | Connettere i dati |
| Errore generale post-dati | Durante l'invio del record è stato restituito un errore. | Error | Rimuove il record dalla registrazione | Impossibile aggiungere {record} a causa di {error}. Controllare o aggiornare il sistema di origine per correggere. | Connettere i dati |
| Errore di formato UPN | Notifica che il nome dell'entità utente usato o generato non è formattato correttamente per soddisfare i requisiti di Microsoft Entra. | Error | Record non registrato in Microsoft Entra ID | Il record utente{record} non ha un nome dell'entità utente formattato correttamente: {value} per creare un oggetto utente in Microsoft Entra ID. Correggere i dati per il record dell'utente nel sistema di origine in base ai campi selezionati per la configurazione Nome utente. | Gestire i dati |
| Microsoft Entra valore della proprietà non valido | Notifica la presenza di caratteri non validi per cui è stato tentato di scrivere in Microsoft Entra ID | Error | Record non registrato in Microsoft Entra ID | Impossibile creare o aggiornare {record} in Active Directory a causa di una o più proprietà non valide. Controllare i valori di {record} in {field} per assicurarsi che contengano solo caratteri alfanumerici e nessun spazio vuoto e meno di 256 caratteri. Correggere i dati nel sistema di origine o attivare l'impostazione sostituisci caratteri speciali in {FlowName}. | Gestire i dati |
| Licenza dipendente mancante | Notifica che una licenza dipendente non è stata assegnata al record. | Error | Record non registrato in Microsoft Entra ID | Una licenza dipendente non è attualmente assegnata al {record}. Ad esempio, la licenza classroom richiede che il {record} disponga già di una licenza per Exchange Online e SharePoint Online. Risolvere questo errore assegnando la licenza dipendente ed eseguendo nuovamente la sincronizzazione. | Gestire i dati |
| Nessuna licenza disponibile | Notifica che non sono presenti licenze da assegnare all'utente. | Error | Record non concesso in licenza | Impossibile assegnare una licenza al {record}. La licenza è scaduta o esaurita (sono state assegnate tutte le licenze disponibili di questo tipo). Correggere aggiungendo altre licenze di {licenseType} ed eseguendo nuovamente la sincronizzazione. | Gestire i dati |
| L'ultimo proprietario del gruppo non può essere rimosso | Notifica che non sono presenti record di proprietario per un gruppo di classi team sincronizzato esistente. | Error | Record non rimosso da Microsoft Entra ID | Impossibile rimuovere {record} da un {teamsType} perché {teamsType} deve avere almeno un proprietario. Controllare o aggiornare i dati nel sistema di origine o controllare le selezioni dei filtri per assicurarsi che sia assegnato almeno un proprietario. | Gestire i dati |
| Dimensioni delle risorse superate | Notifica che un record include troppe associazioni di organizzazioni. | Error | Record non registrato in Microsoft Entra ID | {record} è stato assegnato a un numero eccessivo di scuole (più di 30). Rimuovere l'appartenenza al {record} dalle scuole che non sono più necessarie. | Gestire i dati |
| Voci di destinazione duplicate | Notifica che esistono due o più record con lo stesso sourceId in Microsoft Entra ID. | Error | Record non registrato in Microsoft Entra ID | Esistono due o più record con lo stesso sourcedId per {record} in Active Directory. Identificare e rimuovere l'identità errata. | Gestire i dati |
| Nessuna corrispondenza Microsoft Entra trovata | Notifica che non è stato possibile aggiungere il collegamento dall'origine alla Microsoft Entra ID perché la destinazione non è presente in Microsoft Entra ID. | Error | Record non collegato a Microsoft Entra ID | {record} non può essere aggiornato perché non è stata trovata alcuna voce corrispondente in Active Directory. Verificare i criteri di corrispondenza delle identità per il flusso in ingresso. | Gestire i dati |
| Oggetto esistente trovato | Notifica che è già stato trovato un collegamento per lo stesso sourceId in Microsoft Entra ID. | Error | Record non registrato in Microsoft Entra ID | {record} per {entityType} è già stato creato in passato con lo stesso sourcedId. Ritirare o rimuovere il precedente {entityType}. | Gestire i dati |
| Formato del nome dell'entità non valido | Notifica che non è stato possibile aggiungere il collegamento a causa di un formato imprevisto trovato nel nome dell'entità utente generato. | Error | Record non collegato a Microsoft Entra ID | {record} non può essere aggiornato perché non è stata trovata alcuna voce corrispondente in Active Directory. Il formato del nome dell'entità utente è imprevisto. | Gestire i dati |
| Non è possibile sincronizzare oggetti di proprietà locali | Notifica al tenant che usa la sincronizzazione di Azure Active Directory da un tenant locale al tenant di Microsoft 365 che una modifica visualizzata per un valore utente in AAD non verrà aggiornata dai dati di origine. | Error | Record non registrato in Microsoft Entra ID | Impossibile aggiornare le proprietà (ad esempio: nome) per {record} sincronizzate da active directory locale. Apportare prima la modifica in Active Directory locale. | Gestire i dati |
| ID gruppo di sicurezza duplicati | Notifica al tenant che è stato generato un ID gruppo di sicurezza duplicato dopo la rimozione di caratteri speciali non consentiti in Microsoft Entra ID e che non è possibile creare il gruppo di sicurezza aggiuntivo. | Error | Record non registrato in Microsoft Entra ID | Più gruppi di sicurezza hanno valori identificatori duplicati {identifierSource} dopo la rimozione di caratteri speciali per sourcedId dell'organizzazione: {identifierValue}. | Gestire i dati |