Kann ich die Daten von tt_address im Address-Manager importieren?

Ja. Ab Version 5.0.0 stellt der Address-Manager einen Konsolenbefehl bereit, mit dem Du Datensätze aus tt_address in die Tabellen des Address-Managers überführen kannst.

Was macht der Befehl genau?

Der Befehl liest alle Datensätze aus tt_address und legt zugehörige Address-Manager-Datensätze an. Dabei werden u. a. folgende Felder übernommen:

Stammdaten: name, gender, first_name, middle_name, last_name, birthday, title, email, phone, mobile, www
Adresse: address, building, room, company, city, zip → postal_code, region, country
Beschreibung: description (HTML wird entfernt)
Karten-Daten (falls vorhanden): map_latitude, map_longitude, map_zoom, map_tooltip, map_link, directions aus Feldern mit Präfix txaddressmanagerlist in tt_address
Bilder: verknüpfte sys_file_reference Einträge zum Feld images werden pro Adresse übernommen
Gruppen/Taxonomien:
- company → Position (Address-Manager: addressposition)
- country → Organisation (Address-Manager: addressorganisation)
- tt_address_group via MM → Address-Manager Gruppen (addressgroup)

Auf welchen Seiten werden neue Datensätze angelegt?

Die eigentlichen Adressen erhalten die gleiche pid wie der jeweilige tt_address-Datensatz.
Neue Taxonomie-Einträge (Positionen, Organisationen, Gruppen) werden auf der von Dir übergebenen Container-Seite (PID) erzeugt.

Nutzung und Syntax

vendor/bin/typo3 address_manager:migrate-from-tt-address <containerPageUid> [truncate]

Beispiele:

Minimal: vendor/bin/typo3 address_manager:migrate-from-tt-address 123
Mit Vorab-Bereinigung (Tabellen leeren): vendor/bin/typo3 address_manager:migrate-from-tt-address 123 true

Parameter:

containerPageUid (erforderlich): PID, auf der neue Positionen/Organisationen/Gruppen angelegt werden.
truncate (optional, default false): true/false bzw. 1/0. Wenn true, werden vor der Migration relevante Zieltabellen geleert und bestehende Bild-Referenzen der Adresse entfernt.

Voraussetzungen und Hinweise

Führe vorher ein Backup der Datenbank durch.
Stelle sicher, dass die Extension tt_address samt Tabellen (tt_address, tt_address_group, tt_address_group_mm) vorhanden ist.
Der Befehl migriert alle tt_address-Datensätze; eine Filterung ist nicht vorgesehen.
Bei wiederholter Ausführung ohne truncate können Duplikate entstehen (die Migration legt neue Adressen an). Nutze ggf. truncate oder bereinige Daten vorher.

Welche Tabellen werden geschrieben?

tx_addressmanager_domain_model_address (Adressen)
tx_addressmanager_domain_model_addressgroup (Gruppen) + MM: tx_addressmanager_address_addressgroup_mm
tx_addressmanager_domain_model_addressposition (Positionen) + MM: tx_addressmanager_address_addressposition_mm
tx_addressmanager_domain_model_addressorganisation (Organisationen) + MM: tx_addressmanager_address_addressorganisation_mm
sys_file_reference (Bild-Referenzen für Adressen)

Grenzen und Besonderheiten

Freitext/HTML in description wird auf reinen Text reduziert (strip_tags).
table_local in sys_file_reference wird nur gesetzt, wenn die Spalte existiert (kompatibel mit neueren TYPO3-Versionen).
Es gibt keinen Dry-Run. Teste bei Bedarf vorab in einer Kopie/Stage.

Nutzen für Agenturen und Redaktionen

Schneller Umstieg von Bestandsprojekten mit tt_address auf den Address-Manager
Zeitersparnis durch automatische Übernahme von Gruppen und Bildern
Konsistente Datenbasis für Suche, Karten und SEO-Felder