Règles et descriptions de validation
Règles de correspondance et de validation par type de données
| Type de données | Règle de correspondance | Règle de validation | Valeur stockée |
|---|---|---|---|
| ID unique * | Respect de la casse | Tel qu’il a été reçu | |
| ENUM** | Non sensible à la casse | Correspondance en minuscules | En tant que camelcase |
| String | Respect de la casse | Tel qu’il a été reçu | |
| En minuscules | RFC 5532 (3.4.1) | En minuscules | |
| Date ou DateTime | ISO8601 | ISO8601 | ISO8601 |
| Phone | E.164 | E.164 | Tel qu’il a été reçu |
| Boolean | Non sensible à la casse | Faire correspondre à 'true' ou 'false' | En minuscules |
*L’enregistrement est unique pour tous les enregistrements. Identificateur global unique, bien qu’il puisse ou non prendre la forme d’un identificateur unique universel (UUID).
** Les zéros non significatifs « 0 » manquants sur la valeur entrante pour l’ENUM de niveau de grade, par exemple « 1 », correspondent à la liste de valeurs définie (ENUM) « 01 » et sont stockés sous la forme « 01 ».
** Pour plus d’informations sur les valeurs ENUM par défaut, consultez la liste de valeurs par défaut.
Attendez-vous à ce que les champs téléphone et sms soient mis en forme en fonction de la norme E.164 où le caractère plus est utilisé et réussi par le numéro de téléphone, ou plutôt par le caractère plus suivi de l’indicatif de pays, de l’indicatif régional, du préfixe téléphonique et du numéro de ligne. (Exemple : +1234567890)
Règles et descriptions
| Nom de la règle | Description de la règle | Statut | Action de règle | Exemple de message convivial | Déclenché à partir de (source ou écriture dans Microsoft Entra ID) |
|---|---|---|---|---|---|
| Erreur d’application interne | Une erreur inattendue est survenue. | Erreur catastrophique | Arrête l’exécution des données | Une erreur d’application s’est produite lors de la tentative de traitement : {error} | Connecter des données & Gérer les données |
| Fichier introuvable | Impossible de trouver un fichier requis. | Erreur catastrophique | Arrête l’exécution des données | Impossible de trouver {expectedFileName} dans le chemin d’accès : {Path}. Veuillez case activée le chemin d’accès de {Name} pour vous assurer que {expectedFileName} existe ou que le nom du fichier est {expectedFileName} et réexécutez la synchronisation. | Connecter des données |
| Opération annulée | Un problème s’est produit pendant l’exécution des données qui a nécessité son annulation. | Erreur catastrophique | Arrête l’exécution des données | L’opération a été annulée avec le message : {cancelMessage} | Connecter des données |
| L’en-tête n’existe pas | Pour vous assurer qu’un fichier correctement mis en forme est envoyé pour traitement qui contient les en-têtes de fichier définis. | Erreur catastrophique | Arrête l’exécution des données | Impossible de trouver {expectedHeaderName} dans {fileName}. Corrigez l’extrait pour ajouter ou vérifiez qu’il se lit comme {expectedHeaderName}. Chargez les fichiers corrigés et réexécutez la synchronisation. | Connecter des données |
| Colonne dupliquée dans l’en-tête | Pour vous assurer qu’un fichier correctement mis en forme est envoyé pour traitement qui contient l’en-tête défini et non plusieurs d’un ou plusieurs en-têtes identiques. | Erreur catastrophique | Arrête l’exécution des données | Au moins deux {expectedHeaderName} ont été trouvés dans {fileName}. Corrigez l’extraction, chargez les fichiers corrigés et réexécutez la synchronisation. | Connecter des données |
| Format de fichier non valide | Lorsque des fichiers ou un dossier non pris en charge sont présents dans un fichier compressé (zip). | Erreur catastrophique | Arrête l’exécution des données | Échec de la validation de l’archive. Fichier {fileInArchive} non pris en charge trouvé dans l’archive {archiveName}. | Connecter des données |
| Fichiers en double trouvés | Lorsque l’archive contient un fichier qui est également chargé en dehors de l’archive. Exemple : users.csv et users.zip sont chargés et users.zip contient également des users.csv. | Erreur catastrophique | Arrête l’exécution des données | Échec de la validation de l’archive. Dupliquer {fileInArchive} trouvé dans l’archive {archiveName} et en dehors de l’archive. | Connecter des données |
| Fichier en double trouvé | Lorsque des fichiers en double sont trouvés dans plusieurs archives. Exemple : users.zip et relationship.zip sont chargés et relationship.zip contient également des users.csv. | Erreur catastrophique | Arrête l’exécution des données | Échec de la validation de l’archive. Dupliquer {fileInArchive} trouvé dans les archives {archiveName1}, {archiveName2}. | Connecter des données |
| Mappage de références croisées introuvable | Vérifie que les données liées sont trouvées dans les données associées fournies (exemple : organization manquantes pour un utilisateur, section manquante pour les inscriptions). | Erreur | Supprime l’enregistrement de la publication | Impossible de trouver un enregistrement {entityType} pour {record} à partir de la source [{fileName}/{apiEndPoint}]. Vérifiez que {entityType} sourcedId et {record} sourcedId sont corrects ou mettez à jour les données dans le système source et réexécutez la synchronisation. | Connecter des données & Gérer les données |
| Mappage de références croisées facultatif introuvable | Vérifie que les données liées sont trouvées dans les données associées fournies (exemple : organization manquantes pour un utilisateur, section manquante pour les inscriptions). | Avertissement | Supprime la valeur de l’enregistrement, envoie l’enregistrement pour publication | La valeur de référence facultative {value} non valide dans le champ {field} pour {entityType} a été trouvée pour {record} et la valeur a été supprimée de l’enregistrement pour poursuivre le traitement. Vérifiez que les {entityType} sourcedId et {record} sourcedId sont corrects ou mettez à jour les données dans le système source et réexécutez la synchronisation. | Connecter des données |
| Erreur de format de date et heure | Pour vous assurer que les valeurs de données transmises ont le format approprié (ISO8601). | Erreur | Supprime l’enregistrement de la publication | Le {record} dans {field} de la source [{fileName}/{apiEndPoint}] a une date qui n’est pas au format approprié : « AAAA-MM-JJ ». | Connecter des données & Gérer les données |
| Données requises manquantes | Pour détecter la valeur manquante dans un champ obligatoire pour un enregistrement. | Erreur | Supprime l’enregistrement de la publication | Une valeur requise pour {record} est manquante dans le nom du champ : {field} dans la source [{fileName}/{apiEndPoint}] pour créer l’enregistrement. | Connecter des données & Gérer les données |
| Erreur de format de la valeur | Pour garantir que les données transmises dans un champ correspondent à la mise en forme définie. Consultez également les règles de correspondance et de validation par type de données. | Erreur | Supprime l’enregistrement de la publication | {record} trouvé dans {field} à partir de la source [{fileName}/{apiEndPoint}] n’a pas de valeur correctement mise en forme pour {field}. | Connecter des données & Gérer les données |
| Erreur d’analyse | Pour nous assurer que pour chaque enregistrement, nous sommes en mesure d’associer les données dans la colonne correcte. Les enregistrements peuvent être marqués en raison de virgules uniques, de retours chariot trouvés ou de guillemets manquants. | Erreur | Supprime l’enregistrement de la publication | Impossible d’analyser [if api : {apiEndpoint}] à partir de la source [{fileName}/{apiEndPoint}] pour rechercher des données dans des colonnes. Vérifiez que le délimiteur dans le fichier est une seule virgule (,) et que les retours chariot dans les champs ne sont pas autorisés. Les champs contenant des virgules et des guillemets doubles doivent être placés entre guillemets doubles. Si des guillemets doubles sont utilisés pour entourer un champ, un guillemet double apparaissant à l’intérieur du champ doit être placé dans une séquence d’échappement en le précédant d’un autre guillemet double. | Connecter des données |
| Contrainte de longueur de champ maximale violée | Pour garantir que les données transmises ne dépassent pas la longueur du champ, ce qui entraîne des données manquantes. | Erreur | Supprime l’enregistrement de la publication | La valeur fournie pour {field} dans {record} dépasse la longueur maximale prise en charge de {length} caractères. | Connecter des données |
| Code de référence non valide ou manquant | Identifie si la valeur de référence d’un champ requis [Enum] passé pour un enregistrement est introuvable à laquelle associer l’enregistrement. | Erreur | Supprime l’enregistrement de la publication | La valeur {refValue} pour {field} dans {record} est introuvable dans {refCodeEntity}. Corrigez le système source. | Connecter des données |
| Code de référence facultatif non valide | Identifie si la valeur de référence d’un champ facultatif [Enum] passée pour un enregistrement n’est pas trouvée à laquelle associer l’enregistrement. | Avertissement | Supprime la valeur de l’enregistrement, envoie l’enregistrement pour publication | La valeur {refValue} pour {field} dans {record} est introuvable dans {refCodeEntity}. Corrigez le système source. | Connecter des données |
| Valeur obligatoire correspondante manquante des données facultatives | Pour vous assurer que si un enregistrement transmet une valeur pour des données facultatives, toutes les données associées supplémentaires qui nécessitent maintenant qu’une valeur soit également présente sont également fournies. | Avertissement | Supprime la valeur de l’enregistrement, envoie l’enregistrement pour publication | Une valeur a été fournie dans un champ facultatif pour {record}, mais il manque une valeur correspondante dans le champ associé pour publier correctement les données. | Connecter des données |
| Référence circulaire | Pour garantir que si un enregistrement a une association parente, aucune référence circulaire n’a été fournie. | Avertissement | Supprime la valeur de l’enregistrement, envoie l’enregistrement pour publication | {entityType} {entityId} est lié dans une référence circulaire avec {entityType}(s) {entityList}. La valeur de {entityParentIdField} sera supprimée de l’enregistrement pour poursuivre le traitement. | Connecter des données |
| Identificateur de mappage d’utilisateur introuvable | Pour vous assurer qu’une valeur existe en fonction des règles d’identité utilisateur configurées. | Erreur | Suppression de l’enregistrement de la publication | L’identificateur de mappage utilisateur {identifierType} est introuvable pour l’utilisateur {record}. | Connecter des données |
| Correspondances multiples trouvées par l’utilisateur | Si plusieurs comptes Microsoft Entra correspondent à cet utilisateur, seul le premier compte AAD est utilisé pour la correspondance. Les correspondances supplémentaires seront supprimées. | Erreur | Supprime les enregistrements secondaires de la publication | L’utilisateur {record} avec l’identificateur de mappage {identifierType}={value} a trouvé plusieurs correspondances dans Microsoft Entra ID. Seule la première correspondance trouvée sera utilisée, consultez Microsoft Entra ObjectId {AadObjectId}. | Connecter des données |
| Correspondances en conflit trouvées entre les mappages d’utilisateurs | Pour empêcher l’association automatisée d’un utilisateur différent à un compte Microsoft Entra existant et correspondant. | Erreur | Supprime l’enregistrement de la publication | L’utilisateur {record} avec l’identificateur de mappage {identifierType}={value} est mis en correspondance avec un Microsoft Entra ObjectId mappé existant {AadObjectId}. La correspondance existante trouvée sera utilisée et cette correspondance sera ignorée. | Connecter des données |
| Correspondance utilisateur avec Microsoft Entra ID introuvable | Avertit qu’un enregistrement utilisateur fourni n’a pas été en mesure de trouver une correspondance à un Microsoft Entra’utilisateur en fonction des règles de correspondance d’utilisateur/d’identification configurées. | Avertissement | Enregistrement non mis en correspondance avec Microsoft Entra ID | L’utilisateur {record} avec l’identificateur de mappage {identifierType}={value} n’a pas été mis en correspondance avec Microsoft Entra Utilisateur. Cela peut être dû au fait que la valeur fournie est incorrecte à partir du système source en fonction des règles d’identité utilisateur configurées, ou qu’Azure Active Directory Sync n’a pas encore ajouté l’utilisateur avant la dernière exécution. | Connecter des données |
| Association d’utilisateurs manquante | Avertit qu’un enregistrement utilisateur est fourni, mais qu’il n’est pas associé en tant que rôle Étudiant ou Personnel à un rôle organization ou Contact à un Étudiant. | Avertissement | Supprime l’enregistrement de la publication | L’utilisateur {record} de la source [{fileName}/{apiEndPoint}] ne contient pas de données d’association de rôle d’organisation & ou de données d’association de relation de contact. S’il s’agit d’un utilisateur valide, mettez à jour les données sources pour fournir les associations de rôle & d’organisation ou de relation de contact appropriées. | Connecter des données |
| Rôle principal non spécifié | Avertit que plusieurs enregistrements de rôle sont fournis pour un utilisateur, mais que l’un d’eux n’est pas marqué comme rôle principal. | Avertissement | L’enregistrement est ajouté tel qu’il a été reçu | Plusieurs enregistrements de rôle de la source [{fileName}/{apiEndPoint}] pour l’utilisateur {record} ont été trouvés sans que l’un des rôles soit indiqué comme rôle principal pour le même organization. Nous vous recommandons de spécifier l’un des rôles de cet utilisateur en tant que principal à partir de la source | Connecter des données |
| Plusieurs rôles principaux spécifiés | Avertit que plusieurs enregistrements de rôle sont fournis et que plusieurs sont marqués comme rôle principal | Avertissement | L’enregistrement est ajouté tel qu’il a été reçu | Plusieurs enregistrements de rôle de la source [{fileName}/{apiEndPoint}] pour l’utilisateur {record} ont été trouvés et définis comme le rôle principal pour le même organization. Nous vous recommandons de spécifier l’un des rôles de cet utilisateur en tant que rôle principal à partir de la source. | Connecter des données |
| Association de groupes de rôles manquants de rôle d’utilisateur | Identifie que le rôle d’un utilisateur a été fourni avec un rôle valide, mais que le rôle n’est pas associé à un groupe de rôles, car il ne sait pas quelles règles de correspondance doivent être utilisées. | Erreur | Supprime l’enregistrement de la publication | L’utilisateur {record} de la source [{fileName}/{apiEndPoint}] est associé à un rôle valide {value}, mais le rôle n’est pas associé à un groupe de rôles. Vous devez mettre à jour votre liste de valeurs pour associer {value} à un groupe de rôles. | Connecter des données |
| Erreur de post-données générale | Lors de l’envoi de l’enregistrement, une erreur a été retournée. | Erreur | Supprime l’enregistrement de la publication | Impossible d’ajouter {record} en raison de {error}. Veuillez case activée ou mettre à jour le système source pour le corriger. | Connecter des données |
| Erreur de format UPN | Avertit que le nom d’utilisateur principal utilisé ou généré n’est pas correctement mis en forme pour répondre aux exigences Microsoft Entra. | Erreur | Enregistrement non publié sur Microsoft Entra ID | L’enregistrement utilisateur {record} n’a pas de nom d’utilisateur principal correctement mis en forme : {value} pour créer un objet utilisateur dans Microsoft Entra ID. Corrigez les données de l’enregistrement de cet utilisateur dans le système source en fonction des champs sélectionnés pour la configuration nom d’utilisateur. | Gestion des données |
| Microsoft Entra valeur de propriété non valide | Avertit que des caractères non valides étaient présents pour la raison pour laquelle vous essayez d’écrire dans Microsoft Entra ID | Erreur | Enregistrement non publié sur Microsoft Entra ID | Impossible de créer ou de mettre à jour {record} dans Active Directory en raison d’une ou de plusieurs propriétés non valides. Vérifiez les valeurs de {record} dans {field} pour vous assurer qu’elles contiennent uniquement des caractères alphanumériques et aucun espace blanc et moins de 256 caractères. Corrigez les données dans le système source ou activez le paramètre Remplacer les caractères spéciaux dans {FlowName}. | Gestion des données |
| Licence dépendante manquante | Avertit qu’une licence dépendante n’a pas été affectée à l’enregistrement. | Erreur | Enregistrement non publié sur Microsoft Entra ID | Une licence dépendante n’est actuellement pas affectée à l'{enregistrement}. Par exemple, la licence Classroom nécessite que {record} dispose déjà d’une licence pour Exchange Online et SharePoint Online. Pour résoudre ce problème, affectez la licence dépendante et réexécutez la synchronisation. | Gestion des données |
| Aucune licence disponible | Avertit qu’il n’y avait aucune licence à attribuer à l’utilisateur. | Erreur | Enregistrement sans licence | Échec de l’attribution d’une licence à {record}. La licence a expiré ou est épuisée (toutes les licences disponibles de ce type ont été attribuées). Corrigez en ajoutant d’autres licences de {licenseType} et réexécutez la synchronisation. | Gestion des données |
| Le dernier propriétaire du groupe ne peut pas être supprimé | Avertit qu’il n’existe aucun enregistrement de propriétaire pour un groupe de classes d’équipe synchronisé existant. | Erreur | Enregistrement non supprimé de Microsoft Entra ID | {record} n’a pas pu être supprimé d’un {teamsType} car un {teamsType} doit avoir au moins un propriétaire. Veuillez case activée ou mettre à jour les données dans le système source ou case activée sélections de filtres pour vous assurer qu’au moins un propriétaire est affecté. | Gestion des données |
| Taille de ressource dépassée | Avertit qu’un enregistrement a trop d’associations d’organisations. | Erreur | Enregistrement non publié sur Microsoft Entra ID | {record} a été affecté à un trop grand nombre d’écoles (plus de 30). Supprimez l’appartenance à {record} des écoles qui ne sont plus nécessaires. | Gestion des données |
| Entrées cibles en double | Avertit que deux enregistrements ou plus existent avec le même sourceId dans Microsoft Entra ID. | Erreur | Enregistrement non publié sur Microsoft Entra ID | Deux enregistrements ou plus existent avec le même sourcedId pour {record} dans Active Directory. Identifiez et supprimez l’identité incorrecte. | Gestion des données |
| Aucune correspondance Microsoft Entra trouvée | Avertit que le lien n’a pas pu être ajouté à partir de la source à Microsoft Entra ID, car la cible est introuvable dans Microsoft Entra ID. | Erreur | Enregistrement non lié à Microsoft Entra ID | {record} ne peut pas être mis à jour, car aucune entrée correspondante dans Active Directory n’a été trouvée. Vérifiez les critères de correspondance d’identité pour le flux entrant. | Gestion des données |
| Objet existant trouvé | Avertit qu’un lien a déjà été trouvé pour le même sourceId dans Microsoft Entra ID. | Erreur | Enregistrement non publié sur Microsoft Entra ID | {record} pour {entityType} a déjà été créé dans le passé avec le même sourcedId. Veuillez mettre hors service ou supprimer l’ancien {entityType}. | Gestion des données |
| Format de nom de principal non valide | Avertit que le lien n’a pas pu être ajouté en raison d’un format inattendu trouvé sur le nom d’utilisateur principal généré. | Erreur | Enregistrement non lié à Microsoft Entra ID | {record} ne peut pas être mis à jour, car aucune entrée correspondante dans Active Directory n’a été trouvée. Le format du nom d’utilisateur principal est inattendu. | Gestion des données |
| Impossible de synchroniser des objets locaux | Avertit le locataire utilise Azure Active Directory Sync d’un client local vers son locataire Microsoft 365 qu’une modification observée pour une valeur utilisateur dans AAD ne sera pas mise à jour à partir des données sources. | Erreur | Enregistrement non publié sur Microsoft Entra ID | Impossible de mettre à jour les propriétés (telles que : prénom) de {record} qui se synchronise à partir d’un annuaire Active Directory local. Effectuez d’abord la modification dans Active Directory local. | Gestion des données |
| ID de groupe de sécurité en double | Avertit le locataire qu’un ID de groupe de sécurité en double a été généré après la suppression des caractères spéciaux qui ne sont pas autorisés dans Microsoft Entra ID et ne peuvent pas créer le groupe de sécurité supplémentaire. | Erreur | Enregistrement non publié sur Microsoft Entra ID | Plusieurs groupes de sécurité ont des valeurs d’identificateur en double {identifierSource} après la suppression des caractères spéciaux pour l’organisation sourcedId : {identifierValue}. | Gestion des données |