it XML-Importern können Seitenadministrator:innen viele Jobs automatisch importieren. In diesem Artikel erfährst du, wie du einen Importer in der Admin-Oberfläche verwaltest.
So gelangst du zum Importer
- Gehe auf „Jobs“ > „Job Importers“ oder öffne /admin/content/feed.
- Wähle den Importer aus, den du prüfen möchtest.
- Klicke auf „Bearbeiten“ (Edit).
- Oben auf der Seite findest du vier Tabs: „Ansicht“ (View), „Bearbeiten“ (Edit), „Elemente“ (Items, die importierten Jobs) und „Verlauf“ (History).
Tab „Ansicht“ (View)
Der Tab zeigt die wichtigsten Informationen zum Importer, zum Beispiel die Gesamtzahl der importierten Elemente, die enthaltenen Produkte, die Produktzuweisung und den letzten Importlauf. Wenn du Änderungen am Importer vorgenommen hast, klicke auf „Im Hintergrund importieren“ (Import in background), um den Import manuell zu starten. Er läuft zum nächstmöglichen Zeitpunkt.
Tab „Bearbeiten“ (Edit)
Hier kannst du die XPath-Einstellungen des Importers bearbeiten. Die Einrichtung eines Importers ist im Artikel „Wie konfiguriere ich einen XML-Importer?“ beschrieben. Außerdem kannst du die Einstellungen zu Unternehmen, die Produktzuweisung und die Importoptionen ändern. Mehr dazu findest du im Artikel „Unternehmenszuordnung bei importierten Jobs“.
Einstellungen zu Unternehmen
Mit diesen Einstellungen weist du importierte Jobs Unternehmen auf deiner Seite zu.
Unternehmen zuordnen (Mapping organisations): Aktiviere diese Option, um die Zuordnung einzuschalten. Ist sie deaktiviert, weist der Importer Jobs keinem Unternehmen zu.
Quelle der Unternehmenszuordnung (Mapping organisation source): Lege fest, wie der Importer das passende Unternehmen für jeden Job findet. Das Unternehmen muss in deinem Backend bereits existieren.
So weist du alle Jobs einem Unternehmen zu:
- Lass die Standardeinstellung „Unternehmensname“ (Organisation name) aktiv.
- Wähle im Feld „Unternehmensreferenz“ (Organisation reference) das Unternehmen aus dem Dropdown-Menü aus.
Hinweis: Findet der Importer kein passendes Unternehmen, wird der Job trotzdem importiert, aber keinem Unternehmen zugewiesen.
Einstellungen zur Credit-Abbuchung
Bei der Credit-Abbuchung werden Credits abgebucht, wenn Jobs über den Importer veröffentlicht werden.
Die Credit-Abbuchung funktioniert nur, wenn Jobs einem Unternehmen zugeordnet sind.
Die Credit-Namen im XML müssen mit den Credit-Namen in deinem System übereinstimmen.
Credit-Typen: Wähle den Credit aus, der abgebucht werden soll. Zur Auswahl stehen die Credits, die in deinem System existieren.
Wenn das Unternehmen keine Credits mehr hat: Der Job wird importiert, erhält aber den Status „Zur Prüfung“ (Needs review) und wird nicht veröffentlicht.
Mehr zur Credit-Abbuchung findest du im Artikel „Wie funktioniert die Credit-Abbuchung bei importierten Jobs?“.
Produkte automatisch zu importierten Jobs hinzufügen
Wenn du importierten Jobs bestehende Upgrades zuweisen möchtest, verwende das Feld „Produkte“ (Products). Du legst fest, ob alle Jobs aus diesem Feed dasselbe Produkt erhalten oder ob die Produkte pro Job definiert sind. Mehr dazu im Artikel „Wie kann ich Produkte zu importierten Jobs hinzufügen?“.
Gleiches Produkt für alle Jobs (Same product for all jobs): Wähle diese Option, wenn jeder Job aus einem XML-Feed dasselbe Upgrade erhalten soll, und lege das Produkt fest. Um weitere Produkte hinzuzufügen, klicke auf „Weiteres Element hinzufügen“ (Add another item) und definiere das nächste Produkt.
Produkt pro Job im XML definiert (Product defined per job in the XML): Wähle diese Option, wenn die Produkte pro Job festgelegt werden sollen. Es erscheint das Feld „Produkt-XPath“ (Product XPath), in dem du angibst, wo die Produktinformationen im XML stehen.
Wichtig: Die Produktnamen im XML müssen mit den Produktnamen auf deiner Seite übereinstimmen.
Importer-Einstellungen ändern
Wenn du einen Importer oder seine Einstellungen bearbeitest, kann sich die Darstellung der Jobs im Frontend ändern.
Importoptionen ändern
Mit dem Tab „Importoptionen“ (Import options) steuerst du, ob ein Feed automatisch importiert wird, wie oft Importe laufen und wann der Feed deaktiviert werden soll.
Automatische Importe aktivieren oder deaktivieren: Mit dem Kontrollkästchen „Aktiv“ (Active) steuerst du die regelmäßigen Importe.
- Ausgewählt: Regelmäßige Importe sind aktiviert.
- Nicht ausgewählt: Regelmäßige Importe sind für diesen Feed deaktiviert.
Importintervall wählen: Wähle im Feld „Importintervall“ (Import period), wie oft der Feed importiert werden soll. Du kannst den Standard des Feed-Typs verwenden, der alle 3 Stunden beträgt, oder eine andere Option mit einem Intervall in Minuten, Stunden, Tagen oder Wochen wählen.
Das Importintervall legt fest, wie oft das System den Feed importieren soll, nicht den genauen Startzeitpunkt. Importe laufen über Cron, den Dienst für geplante Hintergrundaufgaben. Sind noch andere Aufgaben in Bearbeitung, muss der Import eventuell warten. „Alle 3 Stunden“ bedeutet daher nicht, dass ein Import exakt alle drei Stunden startet. Er kann später beginnen, je nachdem, wie viele Aufgaben noch anstehen.
Optionales Deaktivierungsdatum festlegen: Wenn du für einen Importer ein Deaktivierungsdatum festlegen möchtest, gib im Feld „Aktiv bis“ (Active until) Datum und Uhrzeit ein, zu denen der Feed deaktiviert werden soll.
Tab „Elemente“ (Items)
Der Tab listet alle Jobs des Importers auf. Die Administrator:innen der Seite können nach Jobtitel, Unternehmensname, Änderungsdatum, Workflow-Status und Job-Upgrade filtern.
- Jobstatus: Entwurf, Zur Prüfung (Needs review), Geplant, Veröffentlicht, Unveröffentlicht, Archiviert.
- Upgrades: Zeigt die aktiven Upgrades jedes Jobs an.
- Ergriffene Maßnahmen (Action taken): Zeigt, was beim letzten Lauf passiert ist: Der Job wurde aktualisiert, der Job ist abgelaufen (von „Veröffentlicht“ auf „Unveröffentlicht“ gesetzt) oder keine Maßnahme.
- Bulk-Operationen: Jobs archivieren, Jobs unveröffentlichen und Jobs für den Reimport markieren (zum Aktualisieren ausgewählter Jobs). Verwende die Bulk-Operationen mit Vorsicht.
- Bearbeiten: Öffnet den Job im Backend, damit du Beschreibung, Workflow-Status oder Veröffentlichungsdaten prüfen kannst.
Bevor du einen importierten Job bearbeitest, deaktiviere die Jobaktualisierung (Disable job updates) für den Importer oder für den einzelnen Job. Sonst überschreibt der nächste Import deine Änderungen. Mehr dazu in den Artikeln „Wie kann ich einen importierten Job bearbeiten?“ und „Wie kann ich einen importierten Job aktualisieren?“.
Tab „Verlauf“ (History)
Der Tab zeigt die Jobs, die der Feed importiert hat, sowie detaillierte Statistiken zu jedem Importerlauf.