Die XML-Schnittstelle von FreelancerWelt.de Projektimport

Transkript

1 Die XML-Schnittstelle von FreelancerWelt.de Projektimport Die Schnittstelle ermöglicht es neue IT Projekte auf FreelancerWelt.de automatisch einzustellen, bestehende zu aktualisieren oder zu löschen. Wenn Bewerber bei Ihnen bewerben, können Sie die Bewerbungen entsprechend abfragen. Die Kommunikation erfolgt über eine HTTP-Verbindung. Vorraussetzungen: Diese Dokumentation setzt voraus, dass der Leser mit der Struktur eines XML- Dokuments, einer XML-Schnittstelle und PHP Kenntnissen vertraut ist. Erste Schritte: Jeder Personaldienstleister hat die möglichkeit einen Account zu erhalten, dazu kontaktieren Sie bitte zuerst unser FreelancerWelt.de Support! Weitere Informationen für die Nutzung unserer XML API lesen Sie bitte hier. XML Datei - Stream Erstellen: Als Beispiel um XMl Datei mit Stellenangeboten auf Ihrer Webseite zu erstellen sehen Sie hier unten die einfachste Lösung. Bitte beachten Sie unsere XML Parameter und Parametertypen. Nur u.g parameter werden von uns unterstützt! XML Parameter: Die folgenden Parameter muss beim Abrufen des XML-Feeds angegeben werden, ansonsten wird eine Fehlermeldung zurückgeliefert und die Anzeigen werden nicht importiert. <catalog> <document> Parameter Type Beschreibung allgemeine Name des XML Katalogs Start- und End-Tags des Dukuments <title> [text] Hier wird Anzeige - Titel geschrieben z.b: IT-Supporter/ Service Desk Mitarbeiter <description> [text] Beschreibung der Tätigkeit, erlaubt bis 1000 Zeichen und darf BB Code enthalten (siehe unten). <artikeltags> [text] passende Tags / Stichwörter der Anzeige dürch Komma(,) getrennt. Minimum 3 Stichwörter z.b supporter, service, it <monatslohn> [integer] hier wird der Lohn für die Tätigkeit pro Monat oder pro Einsatz geschrieben, wenn nichts eingegeben, wird ignoriert

2 Parameter Type Beschreibung <currencylohn> [enum] nur in Verbindung mit <monatslohn>, hier kann 1 von 2 Parametertypen geschrieben werden eur für euro und usd für Dollar. <angebottype> [enum] Der Anzeigetyp, kann entweder free oder office geschrieben werden free: gilt für freiberufliche Tätigkeiten office: für Festanstellung, Büroarbeit <einsatzort> [text] Einsatzort der Tätigkeit, Name der Stadt z.b Berlin, <kontakt > [text] Hier wird Adresse eingegeben. An diese Adresse werden Bewerbungen, Dateien und Nachrichten von Bewerber weitergeleitet! <kontaktdescription> [text] der Tag gilt für Anschprechpartner der Tätigkeit. Dürfen nur Name, Vorname und Telefonnnumer des/der Anschprechpartners/in für Bewerber geschrieben werden. <externid> [integer] ID, Ident Nummer des Angebots in Ihrer Datebank, sehr wichtig, da geprüft wird ob Ihr Angebot in unserer Datebank vorhanden ist! <angebotaktiv> [enum] kann entweder yes oder no geschrieben werden. Wenn diese Tätigkeit Bereits vergeben ist aber noch in XML Datei existiert und geschrieben wird stellen Sie in diesem Tag das Werd auf no um diese Anzeige auf FreelancerWelt.de zu ignorieren und automatisch aus unserer Datebank zu löschen. <enddatum> (int) time() Das Enddatum der Anzeige. An diesem Tag wird die Anzeige auf FreelancerWelt.De automatisch gelöscht. Erlaubt bis maksimum 6 Monate. Beipsiel PHP: $days = 30; //Anzahl der Tage bis die Anzeige bei uns aktiv ist, ab Heute $time_one_day = 86400; $anzeige_aktiv_bis = (time() + ($days * $time_one_day)); <enddatum> </enddatum> //entschpricht :49:23 Die XML Antwort erfolgt, wenn alle notwendigen Parameter korrekt übergeben wurden und der verwendete Channel aktiv ist. Die Antwort erfolgt auch in XML, wenn die Anfrage keine Ergebnisse liefern konnte.

3 Zu Beginn des XML-Feeds erfolgt die XML-Deklaration: <?xml version="1.0" encoding="iso "?> encoding gibt dabei den Zeichensatz der folgenden Daten an. Standardmäßg liefert FreelancerWelt.De Ergebnisse im Unicode Zeichensatz ISO aus. Sie können aber in Ihrem Redaktionsbereich auf UTF-8 umschalten, wenn Sie Ihre XML Datei im Unicode UTF-8 schreiben. Nach der XML-Deklaration folgt direkt die eigentliche Antwort, welche durch die Tags <catalog></catalog> umschlossen ist. Innerhalb dieser Tags sind die Informationen zu Ihren Tätigkeiten. Beispiel des XML Dokuments: <?xml version="1.0" encoding="iso "?> <catalog> <document> <title>programmierer gesucht (m/w)</title> <description>sehr geehrte Programmierer,ich habe einige Idee die ich gerne als App umsetzen wurde. Zunachst für das Iphone/ Ipad später auch für Android und Blackberry. Deswegen suche ich mir einen(e) PHP Programmierer(in) </description> <artikeltags>programmierer, iphone, entwicklung</artikeltags> <monatslohn>100</monatslohn> <currencylohn>eur</currencylohn> <angebottype>free</angebottype> <einsatzort>münchen</einsatzort> <kontaktdescription>max Musterman <externid>25035</externid> <angebotaktiv>yes</angebotaktiv> <enddatum> </enddatum> </document> </catalog>

4 Die Daten aus Daterbank (MYSQL) in eine XML Datei schreiben: Nur ein Beispiel, <?php $sql = "SELECT * FROM projekts"; $q = mysql_query($sql) or die(mysql_error()); $xml = "<?xml version=\"1.0\" encoding=\"iso \"?>\n"; $xml. = "<catalog>\n"; while($r = mysql_fetch_array($q)){ $xml.= "<document>\n"; $xml.= "<title>".$r['title']."</title>\n"; $xml.= "<description>".$r['beschreibung']."</description>\n"; $xml.= "<artikeltags>".$r['tags']."</artikeltags>\n"; $xml.= "<monatslohn>".$r['monatslohn']."</monatslohn>\n"; $xml.= "<currencylohn>".$r['lohn_type']."</currencylohn>\n"; $xml.= "<angebottype>".$r['type']."</angebottype>\n"; $xml.= "<einsatzort>".$r['jobort']."</einsatzort>\n"; $xml.= "<kontakt >".$r[' ']."</kontakt >\n"; $xml.= "<kontaktdescription>". $r['kontakt_beschreibung']."</kontaktdescription>\n"; $xml.= "<externid>".$r['id']."</externid>\n"; $xml.= "<angebotaktiv>".$r['aktiv']."</angebotaktiv>\n"; $xml.= "<enddatum>".$r['time']."</enddatum>\n"; $xml.= "</document>\n"; } $xml.= "</catalog>\n"; $file_name = "unsere_projekte.xml"; $file_pointer = fopen($file_name, "w+"); fwrite($file_pointer, $xml); fclose($file_pointer);?> Die XML Daten importieren und XML-Schnittstelle testen: Logen Sie sich mit den Zugangsdaten die Sie von uns erhalten haben in Ihr Redaktionsbereich, klicken Sie auf Einstellungen. Geben Sie dort XML Dateiname und URl der Webseite den Sie auf Ihrem Server b.z.w auf Ihrer Webseite vorbereitet haben. Die Datei soll schon auf Ihrem Server vorhanden sein sonst wird die Fehlermeldung angezeigt! Prüfen Sie ob alles korrekt ist, testen Sie zuerst den XML Feed, erst dann wenn alles funktioniert und korrekt anzeigt schalten Sie die Einstellung - Parsing Mode auf parsemodus um und speichern Sie die Einstellungen.

5 Haben Sie noch Fragen dann kontaktieren Sie uns!