Validierungsregeln und Beschreibungen
Abgleichs- und Validierungsregeln nach Datentyp
| Datentyp | Abgleichsregel | Validierungsregel | Gespeicherter Wert |
|---|---|---|---|
| Eindeutige ID * | Groß-/Kleinschreibung beachten | Wie empfangen | |
| ENUM** | Groß-/Kleinschreibung nicht beachtet | Übereinstimmung mit Kleinbuchstaben | Als camelCase |
| Zeichenfolge | Groß-/Kleinschreibung beachten | Wie empfangen | |
| E-Mails | In Kleinbuchstaben | RFC 5532 (3.4.1) | In Kleinbuchstaben |
| Date oder DateTime | ISO8601 | ISO8601 | ISO8601 |
| Telefon | E.164 | E.164 | Wie empfangen |
| Boolesch | Groß-/Kleinschreibung nicht beachtet | Übereinstimmung mit "true" oder "false" | In Kleinbuchstaben |
*Der Datensatz ist für alle Datensätze eindeutig. Global eindeutiger Bezeichner, obwohl er die Form eines universellen eindeutigen Bezeichners (UUID) annehmen kann oder nicht.
** Führende Nullen "0", die für den eingehenden Wert für ENUM der Stufe fehlen, z. B. "1", entsprechen der definierten Wertliste (ENUM) "01" und werden als "01" gespeichert.
** Weitere Informationen zu ENUM-Standardwerten finden Sie in der Standardliste der Werte.
Erwarten Sie, dass Telefon- und SMS-Felder basierend auf dem E.164-Standard formatiert werden, bei dem das Pluszeichen verwendet und von der Telefonnummer oder besser gesagt dem Pluszeichen gefolgt von Landesvorwahl, Ortsvorwahl, Telefonpräfix und Zeilennummer gefolgt wird. (Beispiel: +1234567890)
Regeln und Beschreibungen
| Regelname | Regelbeschreibung | Status | Regelaktion | Beispiel für eine benutzerfreundliche Nachricht | Von ausgelöst (Quelle oder Schreiben in Microsoft Entra ID) |
|---|---|---|---|---|---|
| Interner Anwendungsfehler | Ein unerwarteter Fehler ist aufgetreten. | Schwerwiegender Fehler | Beendet die Datenausführung | Beim Versuch, zu verarbeiten, ist ein Anwendungsfehler aufgetreten: {error} | Verbinden von Daten & Verwalten von Daten |
| Datei nicht gefunden | Eine erforderliche Datei konnte nicht gefunden werden. | Schwerwiegender Fehler | Beendet die Datenausführung | {expectedFileName} konnte im Pfad nicht gefunden werden: {Path}. Überprüfen Sie den Pfad von {Name}, um sicherzustellen, dass {expectedFileName} vorhanden ist oder der Name der Datei {expectedFileName} lautet, und führen Sie die Synchronisierung erneut aus. | Verbinden von Daten |
| Vorgang abgebrochen | Während der Datenausführung ist ein Problem aufgetreten, das den Abbruch erforderte. | Schwerwiegender Fehler | Beendet die Datenausführung | Der Vorgang wurde mit der folgenden Meldung abgebrochen: {cancelMessage} | Verbinden von Daten |
| Header ist nicht vorhanden | Um sicherzustellen, dass eine ordnungsgemäß formatierte Datei zur Verarbeitung gesendet wird, die die definierten Dateiheader enthält. | Schwerwiegender Fehler | Beendet die Datenausführung | {expectedHeaderName} kann in {fileName} nicht gefunden werden. Korrigieren Sie den Extrakt, um sie hinzuzufügen, oder stellen Sie sicher, dass sie als {expectedHeaderName} lautet. Laden Sie korrigierte Dateien hoch, und führen Sie die Synchronisierung erneut aus. | Verbinden von Daten |
| Duplizierte Spalte in Kopfzeile | Um sicherzustellen, dass eine ordnungsgemäß formatierte Datei zur Verarbeitung gesendet wird, die den definierten Dateiheader und nicht mehrere derselben Header enthält. | Schwerwiegender Fehler | Beendet die Datenausführung | Mindestens zwei {expectedHeaderName} wurden in {fileName} gefunden. Korrigieren Sie das Extrahieren, laden Sie korrigierte Dateien hoch, und führen Sie die Synchronisierung erneut aus. | Verbinden von Daten |
| Ungültiges Dateiformat | Wenn nicht unterstützte Dateien oder ein Ordner in einer komprimierten Datei (ZIP) vorhanden ist. | Schwerwiegender Fehler | Beendet die Datenausführung | Fehler bei der Archivüberprüfung. Die nicht unterstützte Datei {fileInArchive} wurde im Archiv {archiveName} gefunden. | Verbinden von Daten |
| Doppelte Dateien gefunden | Wenn archive eine Datei enthält, die auch außerhalb des Archivs hochgeladen wird. Beispiel: users.csv und users.zip werden hochgeladen und users.zip enthält auch users.csv. | Schwerwiegender Fehler | Beendet die Datenausführung | Fehler bei der Archivüberprüfung. Duplikate {fileInArchive} im Archiv {archiveName} und außerhalb des Archivs gefunden. | Verbinden von Daten |
| Doppelte Datei gefunden | Wenn doppelte Dateien in mehreren Archiven gefunden werden. Beispiel: users.zip und relationship.zip werden hochgeladen und relationship.zip enthält auch users.csv. | Schwerwiegender Fehler | Beendet die Datenausführung | Fehler bei der Archivüberprüfung. Dupliziertes {fileInArchive} gefunden in archiv {archiveName1}, {archiveName2}. | Verbinden von Daten |
| Querverweiszuordnung nicht gefunden | Überprüft, ob verknüpfte Daten in den zugeordneten Bereitgestellten Daten gefunden werden (Beispiel: fehlende organization für einen Benutzer, fehlender Abschnitt für Registrierungen). | Error | Entfernt datensatz aus der Veröffentlichung | Für {record} aus der Quelle [{fileName}/{apiEndPoint}] konnte kein {entityType}-Datensatz gefunden werden. Vergewissern Sie sich, dass {entityType} sourcedId und {record} sourcedId richtig sind, oder aktualisieren Sie die Daten im Quellsystem, und führen Sie die Synchronisierung erneut aus. | Verbinden von Daten & Verwalten von Daten |
| Optionale Querverweiszuordnung nicht gefunden | Überprüft, ob verknüpfte Daten in den zugeordneten Bereitgestellten Daten gefunden werden (Beispiel: fehlende organization für einen Benutzer, fehlender Abschnitt für Registrierungen). | Warnung | Entfernt einen Wert aus dem Datensatz, sendet einen Datensatz für die Buchung. | Für {record} wurde ein ungültiger optionaler Verweiswert {value} im Feld {field} für {entityType} gefunden, und der Wert wurde aus dem Datensatz gelöscht, um mit der Verarbeitung fortzufahren. Vergewissern Sie sich, dass {entityType} sourcedId und {record} sourcedId richtig sind, oder aktualisieren Sie die Daten im Quellsystem, und führen Sie die Synchronisierung erneut aus. | Verbinden von Daten |
| Datum/Uhrzeit-Formatfehler | Um sicherzustellen, dass übergebene Datenwerte das richtige Format (ISO8601) aufweisen. | Error | Entfernt datensatz aus der Veröffentlichung | Der {record} in {field} aus der Quelle [{fileName}/{apiEndPoint}] weist ein Datum auf, das nicht im richtigen Format vorliegt: "JJJJ-MM-TT". | Verbinden von Daten & Verwalten von Daten |
| Fehlende erforderliche Daten | Um fehlenden Wert in einem erforderlichen Feld für einen Datensatz zu erkennen. | Error | Entfernt datensatz aus der Veröffentlichung | Ein erforderlicher Wert für {record} fehlt im Feldnamen: {field} aus der Quelle [{fileName}/{apiEndPoint}], um den Datensatz zu erstellen. | Verbinden von Daten & Verwalten von Daten |
| Formatwertfehler | Um sicherzustellen, dass die übergebenen Daten in einem Feld mit der definierten Formatierung übereinstimmen. Weitere Informationen finden Sie unter Abgleichs- und Validierungsregeln nach Datentyp. | Error | Entfernt datensatz aus der Veröffentlichung | Der {record} in {field} aus der Quelle [{fileName}/{apiEndPoint}] weist keinen ordnungsgemäß formatierten Wert für {field} auf. | Verbinden von Daten & Verwalten von Daten |
| Analysefehler | Um sicherzustellen, dass wir für jeden Datensatz die Daten in der richtigen Spalte zuordnen können. Datensätze können aufgrund einzelner Kommas, gefundener Wagenrückläufe oder fehlender Anführungszeichen gekennzeichnet werden. | Error | Entfernt datensatz aus der Veröffentlichung | [if API: {apiEndpoint}] aus der Quelle [{fileName}/{apiEndPoint}] kann nicht analysiert werden, um Daten in Spalten zu finden. Stellen Sie sicher, dass das Trennzeichen in der Datei ein einzelnes Komma (,) ist und Wagenrückläufe in Feldern nicht zulässig sind. Felder, die Kommas und doppelte Anführungszeichen enthalten, müssen in doppelte Anführungszeichen eingeschlossen werden. Wenn doppelte Anführungszeichen verwendet werden, um ein Feld einzuschließen, muss ein doppeltes Anführungszeichen, das innerhalb des Felds angezeigt wird, mit Escapezeichen versehen werden, indem es mit einem weiteren doppelten Anführungszeichen vorangeht. | Verbinden von Daten |
| Maximale Feldlängeneinschränkung verletzt | Um sicherzustellen, dass übergebene Daten die Feldlänge nicht überschreiten, was zu fehlenden Daten führt. | Error | Entfernt datensatz aus der Veröffentlichung | Der für {field} in {record} angegebene Wert überschreitet die maximal unterstützte Länge von {length}-Zeichen. | Verbinden von Daten |
| Ungültiger oder fehlender Verweiscode | Gibt an, ob der für einen Datensatz übergebene Verweiswert [Enumeration] eines erforderlichen Felds nicht gefunden wird, um den Datensatz zuzuordnen. | Error | Entfernt datensatz aus der Veröffentlichung | Der Wert {refValue} für {field} in {record} wird in {refCodeEntity} nicht gefunden. Korrigieren Sie das Quellsystem. | Verbinden von Daten |
| Ungültiger optionaler Verweiscode | Gibt an, ob der für einen Datensatz übergebene Verweiswert [Enum] eines optionalen Felds nicht gefunden wird, um den Datensatz zuzuordnen. | Warnung | Entfernt einen Wert aus dem Datensatz, sendet einen Datensatz für die Buchung. | Der Wert {refValue} für {field} in {record} wird in {refCodeEntity} nicht gefunden. Korrigieren Sie das Quellsystem. | Verbinden von Daten |
| Optionale Daten fehlen der entsprechende erforderliche Wert | Um sicherzustellen, dass, wenn ein Datensatz einen Wert für optionale Daten übergibt, auch alle zusätzlichen zugeordneten Daten bereitgestellt werden, für die jetzt ein Wert vorhanden sein muss. | Warnung | Entfernt einen Wert aus dem Datensatz, sendet einen Datensatz für die Buchung. | Ein Wert wurde in einem optionalen Feld für {record} angegeben, aber es fehlt ein entsprechender Wert im zugeordneten Feld, um die Daten erfolgreich zu posten. | Verbinden von Daten |
| Zirkelverweis | Um sicherzustellen, dass, wenn ein Datensatz über eine übergeordnete Zuordnung verfügt, kein Zirkelverweis angegeben wurde. | Warnung | Entfernt einen Wert aus dem Datensatz, sendet einen Datensatz für die Buchung. | {entityType} {entityId} ist in einem Zirkelverweis mit {entityType}(s) {entityList} verknüpft. Der Wert für {entityParentIdField} wird aus dem Datensatz gelöscht, um mit der Verarbeitung fortzufahren. | Verbinden von Daten |
| Benutzerzuordnungs-ID nicht gefunden | Um sicherzustellen, dass ein Wert basierend auf den konfigurierten Benutzeridentitätsregeln vorhanden ist. | Error | Datensatz aus der Veröffentlichung entfernt | Die Benutzerzuordnungs-ID {identifierType} wurde für den Benutzer {record} nicht gefunden. | Verbinden von Daten |
| Benutzerzuordnung: Mehrere Übereinstimmungen gefunden | Wenn mehrere Microsoft Entra Konten für diesen Benutzer übereinstimmen, wird nur das erste AAD-Konto für die Übereinstimmung verwendet. Zusätzliche Übereinstimmungen werden gelöscht. | Error | Entfernt sekundäre Datensätze aus der Veröffentlichung | Benutzer {record} mit zuordnungsbezeichner {identifierType}={value} hat mehrere Übereinstimmungen in Microsoft Entra ID gefunden. Nur die erste gefundene Übereinstimmung wird verwendet, siehe Microsoft Entra ObjectId {AadObjectId}. | Verbinden von Daten |
| In Konflikt stehende Übereinstimmungen für die Benutzerzuordnung gefunden | Um die automatische Zuordnung eines anderen Benutzers zu einem vorhandenen und abgeglichenen Microsoft Entra Konto zu verhindern. | Error | Entfernt datensatz aus der Veröffentlichung | Der Benutzer {record} mit dem Zuordnungsbezeichner {identifierType}={value} wird mit einer vorhandenen zugeordneten Microsoft Entra ObjectId {AadObjectId} abgeglichen. Die vorhandene gefundene Übereinstimmung wird verwendet, und diese Übereinstimmung wird übersprungen. | Verbinden von Daten |
| Benutzer match to Microsoft Entra ID Not Found | Benachrichtigt, dass ein bereitgestellter Benutzerdatensatz keine Übereinstimmung mit einem Microsoft Entra Benutzer basierend auf den konfigurierten Abgleichsregeln für Benutzer/Identifizierung finden konnte. | Warnung | Datensatz nicht mit Microsoft Entra ID abgeglichen | Der Benutzer {record} mit dem Zuordnungsbezeichner {identifierType}={value} wurde keinem Microsoft Entra User zugeordnet. Dies kann sein, dass der vom Quellsystem angegebene Wert basierend auf den konfigurierten Benutzeridentitätsregeln falsch ist, oder azure Active Directory-Synchronisierung hat den Benutzer vor der letzten Ausführung noch nicht hinzugefügt. | Verbinden von Daten |
| Fehlende Benutzerzuordnung | Benachrichtigt, dass ein Benutzerdatensatz bereitgestellt wird, aber nicht als Rolle "Student" oder "Mitarbeiter" einer organization- oder Kontaktrolle zu einem Kursteilnehmer zugeordnet ist. | Warnung | Entfernt datensatz aus der Veröffentlichung | Dem Benutzer {record} aus der Quelle [{fileName}/{apiEndPoint}] fehlen entweder Zuordnungsdaten der Organisation & Rolle oder Zuordnungsdaten zur Kontaktbeziehung. Wenn es sich um einen gültigen Benutzer handelt, aktualisieren Sie die Quelldaten, um die richtigen Zuordnungen der Organisations- & Rolle oder Kontaktbeziehung bereitzustellen. | Verbinden von Daten |
| Primäre Rolle nicht angegeben | Benachrichtigt, dass mehrere Rollendatensätze für einen Benutzer bereitgestellt werden, einer davon jedoch nicht als primäre Rolle markiert ist. | Warnung | Datensatz wird als empfangen hinzugefügt | Es wurden mehrere Rollendatensätze aus der Quelle [{fileName}/{apiEndPoint}] für Den Benutzer {record} gefunden, ohne eine der Rollen als primäre Rolle für dieselbe organization zu kennzeichnen. Es wird empfohlen, eine dieser Benutzerrollen als Primär aus der Quelle anzugeben. | Verbinden von Daten |
| Mehrere primäre Rollen angegeben | Benachrichtigt, dass mehrere Rollendatensätze bereitgestellt und mehrere als primäre Rolle gekennzeichnet sind. | Warnung | Datensatz wird als empfangen hinzugefügt | Mehrere Rollendatensätze aus der Quelle [{fileName}/{apiEndPoint}] für Den Benutzer {record} wurden gefunden und als primäre Rolle für dieselbe organization definiert. Es wird empfohlen, eine dieser Benutzerrollen als Primär aus der Quelle anzugeben. | Verbinden von Daten |
| Zuordnung der Rollengruppe "Benutzerrolle fehlt" | Gibt an, dass ein Benutzer mit einer gültigen Rolle versehen wurde, die Rolle aber keiner Rollengruppe zugeordnet ist. Daher ist nicht sicher, welche Abgleichsregeln verwendet werden sollen. | Error | Entfernt datensatz aus der Veröffentlichung | Der Benutzer {record} aus der Quelle [{fileName}/{apiEndPoint}] ist einer gültigen Rolle {value} zugeordnet, aber die Rolle ist keiner Rollengruppe zugeordnet. Sie müssen Ihre Werteliste aktualisieren, um den {wert} einer Rollengruppe zuzuordnen. | Verbinden von Daten |
| Allgemeiner Fehler bei Postdaten | Beim Übermitteln des Datensatzes wurde ein Fehler zurückgegeben. | Error | Entfernt datensatz aus der Veröffentlichung | {record} kann aufgrund von {error} nicht hinzugefügt werden. Überprüfen oder aktualisieren Sie das Quellsystem, um es zu korrigieren. | Verbinden von Daten |
| UPN-Formatfehler | Benachrichtigt, dass der verwendete oder generierte Benutzerprinzipalname nicht ordnungsgemäß formatiert ist, um Microsoft Entra Anforderungen zu erfüllen. | Error | Datensatz nicht in Microsoft Entra ID | Der Benutzerdatensatz {record} verfügt nicht über einen ordnungsgemäß formatierten Benutzerprinzipalnamen: {value}, um ein Benutzerobjekt in Microsoft Entra ID zu erstellen. Korrigieren Sie die Daten für diesen Benutzerdatensatz im Quellsystem basierend auf den für die Konfiguration des Benutzernamens ausgewählten Feldern. | Datenverwaltung |
| Microsoft Entra Ungültiger Eigenschaftswert | Benachrichtigt ungültige Zeichen, warum versucht wurde, in Microsoft Entra ID | Error | Datensatz nicht in Microsoft Entra ID | {record} kann aufgrund einer oder mehrerer ungültiger Eigenschaften nicht in Active Directory erstellt oder aktualisiert werden. Überprüfen Sie die Werte für {record} in {field}, um sicherzustellen, dass sie nur alphanumerische Zeichen und keine Leerzeichen und weniger als 256 Zeichen enthalten. Korrigieren Sie die Daten im Quellsystem, oder aktivieren Sie die Einstellung Sonderzeichen in {FlowName} ersetzen. | Datenverwaltung |
| Fehlende abhängige Lizenz | Benachrichtigt, dass dem Datensatz keine abhängige Lizenz zugewiesen wurde. | Error | Datensatz nicht in Microsoft Entra ID | Dem {record} ist derzeit keine abhängige Lizenz zugewiesen. Beispiel: Die Classroom-Lizenz erfordert, dass {record} bereits über eine Lizenz für Exchange Online und SharePoint Online verfügen muss. Weisen Sie die abhängige Lizenz zu, und führen Sie die Synchronisierung erneut aus. | Datenverwaltung |
| Keine verfügbaren Lizenzen | Benachrichtigt, dass dem Benutzer keine Lizenzen zugewiesen wurden. | Error | Datensatz nicht lizenziert | Fehler beim Zuweisen einer Lizenz zu {record}. Die Lizenz ist entweder abgelaufen oder erschöpft (alle verfügbaren Lizenzen dieses Typs wurden zugewiesen). Abhilfe schaffen, indem Sie weitere Lizenzen von {licenseType} hinzufügen und die Synchronisierung erneut ausführen. | Datenverwaltung |
| Letzter Besitzer der Gruppe kann nicht entfernt werden | Benachrichtigt, dass keine Besitzerdatensätze für eine vorhandene synchronisierte Teamklassengruppe vorhanden sind. | Error | Datensatz nicht aus Microsoft Entra ID entfernt | {record} konnte nicht aus einem {teamsType} entfernt werden, da ein {teamsType} mindestens einen Besitzer haben muss. Überprüfen oder aktualisieren Sie Die Daten im Quellsystem oder die Filterauswahl, um sicherzustellen, dass mindestens ein Besitzer zugewiesen ist. | Datenverwaltung |
| Ressourcengröße überschritten | Benachrichtigt einen Datensatz, der zu viele Organisationszuordnungen aufweist. | Error | Datensatz nicht in Microsoft Entra ID | {record} wurde zu vielen Schulen zugewiesen (mehr als 30). Bitte entfernen Sie die Mitgliedschaft von {record} aus Schulen, die nicht mehr benötigt werden. | Datenverwaltung |
| Doppelte Zieleinträge | Benachrichtigt, dass zwei oder mehr Datensätze mit derselben sourceId in Microsoft Entra ID vorhanden sind. | Error | Datensatz nicht in Microsoft Entra ID | In Active Directory sind mindestens zwei Datensätze mit der gleichen sourcedId für {record} vorhanden. Identifizieren und entfernen Sie die falsche Identität. | Datenverwaltung |
| Keine Microsoft Entra Übereinstimmung gefunden | Benachrichtigt, dass der Link nicht aus der Quelle zu Microsoft Entra ID hinzugefügt werden konnte, da das Ziel nicht in Microsoft Entra ID gefunden wurde. | Error | Datensatz nicht mit Microsoft Entra ID verknüpft | {record} kann nicht aktualisiert werden, da kein übereinstimmenden Eintrag in Active Directory gefunden wurde. Überprüfen Sie die Identitätsabgleichskriterien für den eingehenden Fluss. | Datenverwaltung |
| Vorhandenes Objekt gefunden | Benachrichtigt, dass bereits ein Link für dieselbe sourceId in Microsoft Entra ID gefunden wurde. | Error | Datensatz nicht in Microsoft Entra ID | {record} für {entityType} wurde bereits in der Vergangenheit mit derselben sourcedId erstellt. Bitte setzen Sie das alte {entityType} aus, oder entfernen Sie es. | Datenverwaltung |
| Ungültiges Prinzipalnamenformat | Benachrichtigt, dass der Link aufgrund eines unerwarteten Formats für den generierten Benutzerprinzipalnamen nicht hinzugefügt werden konnte. | Error | Datensatz nicht mit Microsoft Entra ID verknüpft | {record} kann nicht aktualisiert werden, da kein übereinstimmenden Eintrag in Active Directory gefunden wurde. Das Format des Benutzerprinzipalnamens ist unerwartet. | Datenverwaltung |
| Lokale Objekte können nicht synchronisiert werden | Benachrichtigt den Mandanten, der die Azure Active Directory-Synchronisierung von einer lokalen Instanz an seinen Microsoft 365-Mandanten verwendet, dass eine Änderung, die für einen Benutzerwert in AAD angezeigt wird, nicht aus den Quelldaten aktualisiert wird. | Error | Datensatz nicht in Microsoft Entra ID | Eigenschaften (z. B. Vorname) für {record}, die aus einem lokalen Active Directory synchronisiert werden, können nicht aktualisiert werden. Nehmen Sie zuerst die Änderung in Lokales Active Directory vor. | Datenverwaltung |
| Doppelte Sicherheitsgruppen-IDs | Benachrichtigt den Mandanten, dass nach dem Entfernen von Sonderzeichen, die in Microsoft Entra ID nicht zulässig sind, eine doppelte Sicherheitsgruppen-ID generiert wurde und die zusätzliche Sicherheitsgruppe nicht erstellt werden kann. | Error | Datensatz nicht in Microsoft Entra ID | Mehrere Sicherheitsgruppen verfügen über doppelte Bezeichnerwerte {identifierSource}, nachdem Sonderzeichen für org sourcedId entfernt wurden: {identifierValue}. | Datenverwaltung |