Zum Hauptinhalt springen

Stellenimport – Technik für Partner

Diese Seite beschreibt, in welcher Form Cosmos laufende Stellen bei einem Partner (z. B. einem Multiposter) abholt. Die Einrichtung der Quelle, die Vorschau und die Übernahme erfolgen in Cosmos unter Vermittlung → Einstellungen → Stellenquellen (Bedienung: Seite „Stellenimport“). Die Funktion ist ein eigenes Modul (Stellenimport) und setzt die Jobbörsen-Anbindung voraus.

Abruf​

  • Cosmos ruft eine vom Partner genannte Adresse per GET ab. Erlaubt ist nur https://.
  • Zugang über einen Schlüssel des Partners, wahlweise als Authorization: Bearer <schlüssel> oder als eigene Kopfzeile (z. B. x-api-key: <schlüssel>). Der Schlüssel wird verschlüsselt gespeichert und ist in Cosmos nach dem Speichern nicht mehr lesbar.
  • Weiterleitungen werden nicht verfolgt, damit der Schlüssel nie an eine andere Adresse geht.
  • Antwortet die Quelle nicht innerhalb von 20 Sekunden, mit einem Fehlerstatus oder mit mehr als 10 MB, bricht der Lauf ab. Der Bestand in Cosmos bleibt dann unverändert.
  • Zeitplan je Quelle: aus, stündlich oder täglich zu einer einstellbaren Stunde.

Empfohlenes Format​

Am einfachsten liefert der Partner dasselbe Format, das er von unserem Stellen-Feed kennt:

{
  "count": 2,
  "jobs": [
    {
      "id": "A-1001",
      "title": "Lagerhelfer (m/w/d)",
      "description": "<p>Wir suchen Verstärkung.</p><ul><li>Kommissionieren</li></ul>",
      "employment_type": "FULL_TIME",
      "city": "Musterstadt",
      "postal_code": "12345",
      "country_code": "DE",
      "group_id": "G-LAGER"
    }
  ]
}
  • id ist die Kennung der Anzeige beim Partner. Sie muss über alle Abrufe gleich bleiben.
  • Ein Eintrag entspricht einem Standort. Liefert der Partner eine Gruppenkennung (oben group_id), werden Einträge mit gleicher Kennung zu einer Stelle mit mehreren Standorten.
  • description darf HTML enthalten. Cosmos übernimmt Absätze, Zwischenüberschriften und Aufzählungen, alles andere als Text. Skripte, Stile und Links werden entfernt.
  • Pflicht je Eintrag: Kennung, Titel, Ort und Postleitzahl. Ein unvollständiger Eintrag erscheint in der Vorschau als Fehler und wird nicht übernommen.

Andere Formate​

Die Zuordnung „Stellenfeld → Feld der Quelle“ ist je Quelle einstellbar, auch für verschachtelte Felder (location.city). Neben JSON liest Cosmos:

  • XML, z. B. im verbreiteten Aufbau <source><job><referencenumber>…</referencenumber><title>…</title>…</job></source>,
  • CSV (Trennzeichen ;, , oder Tab, erste Zeile = Spaltenüberschriften),
  • XLSX (erstes Tabellenblatt, erste Zeile = Spaltenüberschriften).

CSV, XLSX und JSON können statt des Abrufs auch als Datei hochgeladen werden.

Was beim Abgleich passiert​

  • Vorschau vor Übernahme: Jeder Lauf zeigt zuerst neu · geändert · unverändert · fehlt in Quelle · Fehler. Den ersten Lauf einer Quelle übernimmt immer ein Mensch. Spätere Zeitplan-Läufe übernehmen nur, wenn „automatisch übernehmen“ eingeschaltet ist.
  • Bestandsschutz: Felder, die in Cosmos nach dem Import von Hand geändert wurden, überschreibt ein späterer Lauf nicht. Die Vorschau nennt sie als „geschützt“.
  • Fehlt in Quelle: Stellen werden nie gelöscht. Erst nach der eingestellten Zahl aufeinanderfolgender übernommener Läufe bekommt eine fehlende Stelle den eingestellten Status, eine einzelne fehlende Anzeige wird auf Wunsch archiviert – einmal je Fehl-Strecke: Holt ein Mensch die Stelle zurück, dreht der nächste Lauf das nicht wieder um. Eine verdächtige Lieferung bei vorhandenem Bestand (leer, kein verwertbarer Eintrag, oder bei mindestens der Hälfte fehlt die Kennung) löst eine Warnung in der Vorschau aus. Dann zählt ohne bewusste Auswahl durch einen Menschen nichts hoch, und der Zeitplan übernimmt nicht selbst.
  • Nur die neueste Vorschau einer Quelle ist übernehmbar; ältere werden verworfen.
  • Keine Doppelanzeigen: Ist die Quelle mit einer Jobbörsen-Anbindung verknüpft, liefert unser Stellen-Feed für importierte Anzeigen die Kennung des Partners als id zurück. So erkennt der Partner sie als dieselbe Anzeige. Ohne Verknüpfung warnt die Vorschau.