Schnittstellenbeschreibung für Stellenanzeigen
Mit jopo bietet softgarden eine Software-Lösung zum einfachen Erstellen und Schalten von Stellenanzeigen auf diversen Jobbörsen (Boards) im Internet. Bisher wurden bereits zahlreiche Jobbörsen an jopo und taloom angebunden. Da wir derzeit zahlreiche Anfragen von Jobbörsen erhalten, die auch gerne an jopo angebunden werden möchten beschreiben wir im Folgenden die Schnittstelle.
Alle Stellenanzeigen, die über jopo erstellt und Veröffentlicht wurden werden in einer XML-Datei zur Verfügung gestellt. Diese XML-Datei kann über eine URL (http oder https) abgerufen werden. Die XML-Datei wird alle 4 Stunden aktualisiert und enthält immer alle geschaltetet Stellenanzeigen. Ist also eine Stellenanzeige, die vor 4 Stunden noch in der XML-Datei enthalten bei nochmaligem Aufruf der XML-Datei nicht mehr enthalten bedeutet dies: Die Stellenanzeige wurde deaktiviert.
Es gelten also die folgenden Prämissen:
- Alle in der Datei enthaltenen Stellenanzeigen sollen auf dem jeweiligen Board geschaltet sein.
- Alle nicht (mehr) darin enthaltenen Anzeigen sollen somit auch nicht online sein (bzw. wieder gelöscht werden).
- Diese Datei enthält die Anzeigen aller Schaltungskunden, die über eines unserer Tools die Stellenanzeigen bei dem jeweiligen Jobboard schalten. Durch entsprechende XML-Knoten können diese auf Seiten des Jobboards identifiziert werden.
Die Anzeigen stehen auf zwei sich ähnelnden URLs zum Donwload bereit:
B-1) Als Komplettdatei: unter der URL http://jobdb.softgarden.de/jobdb/public/download/hrxml/xmlgenerator/all.xml?channelId=HIER_DIE_ID_DES_JOBBOARDS kann eine (evtl. sehr grosse) XML-Datei abgerufen werden, die alle derzeit geschalteten Stellenanzeigen jeweils als (HR-XML) PositionOpening beinhaltet.
B-2) Als Übersichts-Link-Liste: unter der URL http://jobdb.softgarden.de/jobdb/public/download/hrxmlalllist/xmlgenerator/all.xml?channelId=HIER_DI_ID_DES_JOBBOARDS kann eine Liste mit Links für jede Stellenanzeige abgerufen werden. Unter jedem Link ist dann eine einzelne Stellenanzeige als (HR-XML) PositionOpening erhältlich. Dieses Verfahren bietet zwar den Vorteil, dass jede übertragene XML-Datei für sich genommen kleiner ist, jedoch müssen u.U. sehr viele einzelne Requests gemacht werden. Es ist daher nur in Ausnahmefällen zu verwenden.
Datenformat
Das in beiden Verfahren genutzte Datenformat für die Stellenanzeigen ist PositionOpening aus dem HR-XML-Standard. Hierbei sind insbesondere die folgenden Felder belegt:
- PositionRecordInfo/Id/IdValue -> unsere ID der Stellenanzeige
- PositionRecordInfo/Status -> von wann bis wann soll die Anzeige geschaltet sein
- PositionPostings/PositionPosting/Title -> Titel der Stellenanzeige
- PositionPostings/PositionPosting/Link -> Link zur HTML-Ansicht der Anzeige
- PositionSupplier/SupplierId -> Vertragspartner der Stellenbörse
- PositionProfile/Organization/OrganizationName -> Name der ausschreibenden Firma, so wie er in Ergebnislisten auftauchen soll. Kann insbesondere bei Agenturen (als Vertragspartner) von dem als PositionSupplier übertragenen Wert abweichen
- PositionProfile/PositionDetail/PhysicalLocation -> Ort der zu besetzenden Position, sofern vorhanden
- PositionProfile/FormattedPositionDescription[Name='text/html']/Value -> HTML der Stellenanzeige
- PositionProfile/HowToApply -> Online-Bewerben-Link (nochmals separat)
Beispiel
Als Beispiel sei hier die XML-Datei für einen Job auf der Stellenbörse jobware.de angeführt (Aus dem Übertragungsweg B-2, also nur eine Stelle pro XML-Datei): http://jobdb.softgarden.de/jobdb/public/download/hrxmlsingle/xmlgenerator/joblist.xml?channelId=jobware_de&pv=36061
Import von Stellenanzeigen für jobs-for-friends
Analog zu diesem Verfahren können Stellenanzeigen auch in jobs-for-friends importiert werden. In diesem Fall muss die XML-Datei von dem Fremdsystem über http oder https zur Verfügung gestellt werden.