Content-Mapper

Der Content-Mapper (im Admin: Importe) holt Daten aus fremden Quellen und legt daraus Einträge an — wiederholbar, nach Zeitplan und mit Protokoll je Lauf. Damit ziehen Bestände aus WordPress, TYPO3, Shops, PIM-Systemen oder jeder anderen JSON-, REST- oder GraphQL-Quelle nach Entrydeck um, ohne Neuanfang.

Ein Konnektor besteht aus zwei Teilen

1. Quelle: woher die Daten kommen — URL, Authentifizierung, seitenweiser Abruf.
2. Zuordnung: wie sie ins CMS übersetzt werden — Quellfeld zu Zielfeld des Inhaltstyps.

Beides steht auf einer Seite unter Importe → Konnektor.

Quellen

Für WordPress genügt die REST-API https://alte-seite.de/wp-json/wp/v2/posts?_embed&per_page=50&page={page}; TYPO3 liefert über Extensions wie headless oder eine eigene JSON-Ausgabe.

Pfade in die Antwort

Ein Pfad wie data.items greift in die JSON-Antwort. Die Baumansicht links zeigt eine echte Antwort der Quelle — ein Klick übernimmt den Pfad. Der Elementpfad bestimmt, welche Liste als Datensätze gilt; Feldpfade sind relativ dazu (title.rendered, _embedded.wp:featuredmedia.0.source_url).

Feldzuordnung

Erst den Ziel-Inhaltstyp wählen, dann je Zielfeld ein Quellfeld. Nicht zugeordnete Felder bleiben leer, sie verhindern den Import nicht. Drei Arten von Regeln stehen bereit:

• Feldregeln mit Transformation: trim, slugify, number, boolean, date, stripHtml, join, split oder template (mehrere Quellwerte zu einem Text zusammensetzen), jeweils mit optionalem Vorgabewert.
• Medienregeln: eine Bild-URL wird heruntergeladen, in die Mediathek gelegt und mit Varianten versehen — einzeln oder als Liste.
• Relationsregeln: ein Fremdschlüssel wird über ein Feld des Ziel-Inhaltstyps aufgelöst (matchBy), auf Wunsch wird der verknüpfte Eintrag angelegt, wenn er noch fehlt.

Die Zuordnung entsteht im Admin per Klick; intern sieht sie so aus (Auszug für WordPress-Beiträge):

{
  "fields": [
    { "target": "title", "source": "title.rendered", "transform": "stripHtml" },
    { "target": "slug",  "source": "slug", "transform": "slugify" },
    { "target": "body",  "source": "content.rendered" },
    { "target": "date",  "source": "date", "transform": "date" }
  ],
  "media": [
    { "target": "hero", "source": "_embedded.wp:featuredmedia.0.source_url", "download": true }
  ],
  "relations": [
    { "target": "author", "relatedTypeSlug": "person", "source": "author", "matchBy": "wpId", "createIfMissing": false }
  ]
}

Eindeutiger Schlüssel

Das Feld aus der Quelle, das einen Datensatz eindeutig identifiziert — meist eine ID oder ein Slug. Der Import aktualisiert dann vorhandene Einträge, statt neue anzulegen. Ohne Schlüssel legt jeder Lauf alles neu an.

Probelauf, Zeitplan, Protokoll

• Probelauf zeigt, wie viele Datensätze ankommen und was daraus würde, ohne etwas zu schreiben. Den Zeitplan schaltet man erst ein, wenn das Ergebnis stimmt.
• Seitenweiser Abruf: Seitengröße und maximale Seitenzahl begrenzen, wie viel ein Lauf holt. Vorsichtige Werte beim ersten Versuch sparen Zeit.
• Zeitplan in Minuten: der Abstand zwischen zwei Läufen. Unter fünfzehn Minuten lohnt sich selten.
• Protokoll: Jeder Lauf listet angelegte, aktualisierte und übersprungene Datensätze samt Fehlermeldungen je Datensatz. Bei einem unerwarteten Ergebnis beginnt die Suche dort.

Status importierter Einträge

Importierte Einträge landen wahlweise als Entwurf (Redaktion prüft und veröffentlicht) oder direkt als Veröffentlicht (für laufend synchronisierte Bestände wie Produkte oder Termine). Die Zuweisung an Websites lässt sich im Konnektor vorbelegen.

Migration in der Praxis

1. Inhaltstypen in Entrydeck anlegen, die zur Zielstruktur passen — nicht zur Quelle.
2. Konnektor je Quelltyp anlegen (Beiträge, Seiten, Personen), Relationen zuletzt.
3. Probelauf, Zuordnung korrigieren, Probelauf.
4. Erster Lauf als Entwurf, Stichproben prüfen, dann veröffentlichen.
5. Bis zum Umschalten der Domain den Zeitplan laufen lassen — dann bleibt das alte System bis zur letzten Minute führend.

Der Mapper ist ab dem Professional-Paket enthalten, siehe Pläne & Abrechnung.