1. Übersicht
Jobiqo unterstützt den automatisierten Import von Stellenangeboten über XML-Feeds. Dies ermöglicht es Feed-Anbietern, eine Jobplattform mit minimalem manuellem Aufwand zu befüllen und zu verwalten. Vorausgesetzt, der Feed ist fehlerfrei aufgebaut und enthält die in dieser Anleitung beschriebenen Pflichtfelder, bietet das System Flexibilität beim Feld-Mapping und kommt mit den unterschiedlichsten XML-Strukturen zurecht.
Dieses Dokument beschreibt die technischen Anforderungen für die Einrichtung eines kompatiblen XML-Feeds, einschließlich der Pflicht- und empfohlenen Felder, den Anforderungen an die Feed-Bereitstellung sowie eines Referenzbeispiels.
2. Wie der Feed funktioniert
Der Importprozess des XML-Feeds läuft vollautomatisch ab. Sobald eine Feed-URL auf der Jobiqo-Plattform konfiguriert wurde, führt das System regelmäßig die folgenden Schritte aus:
Der Importprozess wird alle paar Stunden automatisch ausgeführt.
Bei jedem Durchlauf ruft das System den aktuellen XML-Inhalt von der hinterlegten Feed-URL ab.
Neue Stellenanzeigen, die im Feed enthalten, aber noch nicht auf der Plattform vorhanden sind, werden automatisch veröffentlicht.
Stellenanzeigen, die zuvor importiert wurden, aber nicht mehr im Feed enthalten sind, werden automatisch vom Stellenportal offline genommen.
Dies stellt sicher, dass das Stellenportal kontinuierlich mit den Inhalten des XML-Feeds synchronisiert bleibt.
Feed-Anbieter haben die direkte Kontrolle darüber, welche Jobs auf der Jobplattform erscheinen: Das Hinzufügen eines Jobs zum Feed veröffentlicht diesen automatisch, während das Entfernen eines Jobs dafür sorgt, dass er wieder offline genommen wird.
3. Feed-Anforderungen
3.1 Allgemeine Vorgaben
Der Feed darf maximal 10.000 Jobs enthalten.
Der XML-Feed muss eine valide XML-Struktur aufweisen.
Der XML-Feed muss über eine feste URL erreichbar sein.
Der XML-Feed kann per Benutzername und Passwort geschützt werden – in diesem Fall müssen die Zugangsdaten für die Einrichtung bereitgestellt werden.
3.2 Struktur der Job-Tags
Das Jobiqo-Importsystem muss exakt auf den Namen des XML-Tags konfiguriert werden, der einen einzelnen Stellenübertrag repräsentiert. Die empfohlene Standardstruktur verwendet ein <jobs>-Wurzelelement , das einzelne untergeordnete <job>-Elemente enthält, wie hier dargestellt:
<jobs>
<job>
<!-- job fields -->
</job>
<job>
<!-- job fields -->
</job>
</jobs>
Alternative Tag-Namen (z. B. <listings> / <listing>) werden unterstützt – vorausgesetzt, sie werden innerhalb desselben XML-Feeds durchgehend einheitlich verwendet. Ein Mix aus verschiedenen Tags für dasselbe Objekt (z. B. die gleichzeitige Nutzung von <jobs> und <listings> im selben Feed) wird nicht unterstützt.
4. Feld-Referenz
Die folgende Tabelle listet alle unterstützten Felder, ob sie Pflicht oder Empfehlung sind sowie eine Beschreibung des erwarteten Inhalts auf.
5. XML-Feed-Beispiel
Das folgende Beispiel zeigt einen fehlerfrei aufgebauten XML-Feed, der eine einzelne Stellenanzeige mit allen ausgefüllten, empfohlenen Feldern enthält:
<jobs>
<job>
<jobId><![CDATA[12345]]></jobId>
<title><![CDATA[Senior Software Engineer]]></title>
<description><![CDATA[Full job description here...]]></description>
<company><![CDATA[Acme Corporation]]></company>
<city><![CDATA[Richmond]]></city>
<state><![CDATA[VA]]></state>
<country><![CDATA[US]]></country>
<postalCode><![CDATA[23890]]></postalCode>
<postedAt><![CDATA[2024-03-01T10:00:00Z]]></postedAt>
<jobUrl><![CDATA[https://example.com/apply/12345]]></jobUrl>
<applicationEmail><![CDATA[jobs@example.com]]></applicationEmail>
<category><![CDATA[Engineering]]></category>
<companyLogo><![CDATA[https://example.com/logo.png]]></companyLogo>
<salaryMin><![CDATA[80000]]></salaryMin>
<salaryMax><![CDATA[120000]]></salaryMax>
<salaryCurrency><![CDATA[USD]]></salaryCurrency>
<salaryFrequency><![CDATA[Yearly]]></salaryFrequency>
</job>
</jobs>
6. Onboarding & Konfiguration
Um den XML-Feed-Import für Ihre Jobplattform zu aktivieren, stellen Sie unserem Team bitte die folgenden Informationen zur Verfügung:
Die URL des Feeds
Die Zugangsdaten zur Authentifizierung (falls der Feed geschützt ist)
Wir übernehmen die Konfiguration des Feld-Mappings direkt auf der Plattformseite. Es sind daher keine Änderungen an Ihrer bestehenden Feed-Struktur erforderlich – vorausgesetzt, alle Pflichtdaten sind im Feed enthalten.