import { Callout } from "zudoku/ui/Callout";
# Adressdaten-Initialisierung
Die Adressdaten-Initialisierung ermöglicht die schrittweise Verarbeitung vorhandener Adressdaten in Business Central, um das interne Adressdaten-Verzeichnis aufzubauen und die Nutzung nachzuverfolgen.
## Geschäftswert
Die Batch-basierte Initialisierung bietet folgende Vorteile:
- **Unterbrechungsfreie Verarbeitung**: Die Initialisierung erfolgt in konfigurierbaren Batches, sodass große Datenmengen zuverlässig verarbeitet werden können
- **Fehlertoleranz**: Fehler in einzelnen Batches blockieren nicht die Verarbeitung anderer Quelltabellen
- **Fortschrittstransparenz**: Der aktuelle Verarbeitungsstand ist jederzeit sichtbar und kann nach Unterbrechungen nahtlos fortgesetzt werden
- **Datenintegrität**: Bereits validierte Adressdaten bleiben während der Initialisierung unverändert erhalten
## Funktionsbeschreibung
Die Adressdaten-Initialisierung liest alle relevanten Adressdaten aus den folgenden Quelltabellen:
- Kontakte
- Debitoren
- Kreditoren
- Mitarbeiter
- Ressourcen
- Verkaufsbelege (Aufträge, Angebote, Rechnungen)
- Einkaufsbelege (Bestellungen, Anfragen, Rechnungen)
- Lieferadressen
- Auftragsadressen
- Alternative Adressen
Die Verarbeitung erfolgt in konfigurierbaren Batches. Nach jedem Batch wird der Fortschritt gespeichert, sodass die Initialisierung bei Unterbrechungen (z.B. Session-Ende, Task-Abbruch, Fehler) an der letzten Position fortgesetzt werden kann.
Die Initialisierung aktualisiert das interne Adressdaten-Verzeichnis und die Nutzungsverfolgung. Es werden keine automatischen Adressvalidierungen durchgeführt. Bereits als "Validiert" oder "Manuell geprüft" markierte Adressdaten bleiben unverändert.
## Verwendung
### 1. Batchgröße konfigurieren
Öffnen Sie die **Einrichtung für Adressvalidierung** und legen Sie die gewünschte **Batchgröße für Initialisierung** fest:
- **Standardwert**: 1.000 Datensätze pro Batch
- **Bereich**: 0 bis 100.000 Datensätze
- **Empfehlung**: Für große Datenmengen (> 100.000 Adressdatensätze) empfehlen wir Batchgrößen zwischen 500 und 2.000
### 2. Initialisierung starten
1. Öffnen Sie die Seite **Adressdaten-Initialisierung** über die Suche oder über die Aktion **Adressdaten-Initialisierung** in der Einrichtung
2. Die Seite zeigt den aktuellen Fortschritt für jede Quelltabelle
3. Klicken Sie auf **Nächsten Batch ausführen**, um die Verarbeitung zu starten
### 3. Fortschritt überwachen
Über der Liste der Quelltabellen zeigt die Seite den Gesamtstand:
| Feld | Beschreibung |
| --- | --- |
| **Fortschritt** | Gesamtfortschritt der Initialisierung in Prozent |
| **Batchgröße** | Anzahl der Datensätze, die je Batch aus einer Quelltabelle gelesen werden |
| **Im Hintergrund geplant** | Gibt an, ob die Fortsetzung in einer Hintergrundsitzung geplant ist |
Für jede Quelltabelle zeigt die Liste folgende Informationen:
| Feld | Beschreibung |
| --- | --- |
| **Quelltabelle** | Name der verarbeiteten Tabelle (z.B. "Debitor", "Kreditor") |
| **Status** | Aktueller Verarbeitungsstatus (siehe unten) |
| **Abgeschlossen %** | Prozentualer Fortschritt der Quelltabelle |
| **Anzahl verarbeiteter Datensätze** | Anzahl der bisher verarbeiteten Datensätze |
| **Anzahl Datensätze** | Gesamtanzahl der zu verarbeitenden Datensätze |
| **Anzahl hinzugefügter Adressen** | Anzahl der Adressen, die dem Adressdaten-Verzeichnis hinzugefügt wurden |
| **Letzter Batch-Lauf am** | Zeitpunkt, zu dem der letzte Batch verarbeitet wurde |
| **Letzte Fehlermeldung** | Eventuelle Fehlermeldung (nur bei Status "Fehlgeschlagen") |
### 4. Verarbeitung anhalten oder fortsetzen
- **Anhalten**: Schließen Sie die Seite oder beenden Sie die Session. Der aktuelle Fortschritt wird automatisch gespeichert
- **Fortsetzen**: Öffnen Sie die Seite erneut und klicken Sie auf **Nächsten Batch ausführen**. Die Verarbeitung wird an der letzten Position fortgesetzt
Die Initialisierung verarbeitet keine Datensätze doppelt. Ein erneuter Start setzt die Verarbeitung an der letzten gespeicherten Position fort.
## Aktionen
| Aktion | Beschreibung |
| --- | --- |
| Nächsten Batch ausführen | Liest den nächsten Batch Adressdaten aus den Quelltabellen. Es wird nur die konfigurierte Anzahl von Datensätzen verarbeitet, sodass die Aktion wiederholt werden kann, bis die Initialisierung abgeschlossen ist. |
| Nächsten Batch für ausgewählte Quelltabelle ausführen | Liest den nächsten Batch Adressdaten aus der ausgewählten Quelltabelle. |
| Alle verbleibenden Batches ausführen | Liest alle verbleibenden Adressdaten aus den Quelltabellen. Jeder Batch wird einzeln gespeichert, sodass die Initialisierung bei einer Unterbrechung an der Abbruchstelle fortsetzt. |
| Im Hintergrund fortsetzen | Setzt die Initialisierung in einer Hintergrundsitzung fort. Die Sitzung verarbeitet die verbleibenden Batches und plant sich erneut, bis die Initialisierung abgeschlossen ist. |
| Ausgewählte Quelltabelle zurücksetzen | Verarbeitet die ausgewählte Quelltabelle mit dem nächsten Batch erneut von Anfang an. Vorhandene Adressdaten werden nicht gelöscht. |
| Ausgewählte Quelltabelle überspringen | Schließt die ausgewählte Quelltabelle von der Initialisierung aus. Ihre Adressen werden dem Adressdaten-Verzeichnis hinzugefügt, sobald sie verwendet werden. |
| Initialisierung neu starten | Verarbeitet alle Quelltabellen erneut von Anfang an. Vorhandene Adressdaten und der Validierungsstatus der Adressen bleiben erhalten. |
| Nicht verwendete Adressdaten entfernen | Entfernt Adressdaten, die nicht validiert sind und von keinem Datensatz mehr verwendet werden. Entfernte Adressen werden erneut aufgenommen, sobald sie verwendet werden. |
| Adressdaten | Öffnet das Adressdaten-Verzeichnis, das durch die Initialisierung gefüllt wird. |
| Einrichtung für Adressvalidierung | Öffnet die [Einrichtung für Adressvalidierung](setup.md), um die Batchgröße zu ändern. |
## Status-Übersicht
| Status | Beschreibung |
| --- | --- |
| **Ausstehend** | Die Quelltabelle wartet auf Verarbeitung |
| **In Bearbeitung** | Die Quelltabelle wird gerade verarbeitet |
| **Abgeschlossen** | Die Verarbeitung wurde erfolgreich abgeschlossen |
| **Übersprungen** | Die Quelltabelle wurde übersprungen (z.B. keine Leseberechtigung) |
| **Fehlgeschlagen** | Die Verarbeitung ist fehlgeschlagen. Die Fehlermeldung wird im Feld "Letzte Fehlermeldung" angezeigt |
Fehler in einzelnen Quelltabellen blockieren nicht die Verarbeitung anderer Tabellen. Sie können fehlerhafte Batches nach Behebung der Ursache erneut ausführen.
## Hintergrundinformationen
Die Initialisierung bereinigt außerdem verwaiste Datensätze in den Tabellen "Verwendung von Adressdaten" und "Adressdaten-Hash", die durch frühere Versionen entstanden sein können.