Instrukcja integracji z portalem ogłoszeń praca.24portal.pl Wersja: 1.0 Data utworzenia: 09.06.2010 Data auktualizacji: 09.06.2010 Adres: E1 Jędrzej Hiller Maciej Algusiewicz Spółka Cywilna, ul. Przełajowa 2, 61-622 Poznań
1. Ogólne zasady integracji Integracja z portalem praca.24.portal.pl następuje poprzez udostępnienie serwisowi aktualnej oferty zawartej w pliku XML. Serwis korzysta z formatu pliku XML, udostępnionego przez portal otopraca. Poprawny format pliku XML zostanie przedstawiony szczegółowo w dalszej części dokumentu. Przygotowany plik XML należy umieścić pod adresem http, a następnie przesłać nam do niego link, np. http://www.serwis.com/oferta.xml. Przesłanie linku odbywa się za pomocą opcji importuj plik XML, dostępnej w panelu użytkownika po zalogowaniu. Jako format pliku należy wybrać otopraca. Nazwa pliku nie powinna się zmieniać w momencie aktualizacji oferty (plik powinien być jedynie nadpisywany). Od momentu dostarczenia linku do pliku XML nasz system na jego podstawie będzie automatycznie pobierał ofertę, dodając lub usuwając oferty pracy. Plik XML powinien być aktualizowany za każdym razem gdy następują zmiany w ofercie. Zalecamy automatyczną aktualizację pliku raz na 24 godziny. 2. Specyfikacja struktury pliku XML Wymagania związane z formatem pliku XML Dokument XML musi być przygotowany z zastosowaniem kodowania UTF-8. W związku z tym plik powinien zaczynać się nagłówkiem określającym kodowanie polskich znaków w odpowiednim formacie. <?xml version= 1.0 encoding= UTF-8?> Jeśli udostępniony dokument XML nie zawiera wszystkich danych wymaganych do publikacji oferty, to dana oferta nie zostanie dodana. Edycja ogłoszenia możliwa jest z poziomu serwisu jak i poprzez aktualizację pliku XML. Obowiązkowy jest atrybut CategoriId, dodatkowe tagi Category nie będą brane pod uwagę. Wewnątrz znaczników XML można stosować znaczniki HTML, takie jak <strong>, <br>, <ul>, <li>. Jeśli wewnątrz znaczników XML występują znaczniki HTML, bądź znaki &, ',, <, > to cały tekst między znacznikami należy objąć sekcją CDATA. Prawidłowy zapis to <znacznikxml<!cdata[treść]]></znacznikxml>. Stosowanie sekcji CDATA zalecane jest dla wszystkich znaczników wewnątrz których występują wartości tekstowe. Struktura dokumentu Portal praca.24portal.pl obsługuje dokumenty XML w formacie udostępnionym przez serwis otopraca, nie biorąc jednak pod uwagę wszystkich jego pól. Niektóre pola są łączone w jedno (opis stanowiska, wymagania, oferta)
Przykładowy plik XML <?xml version="1.0" encoding="utf8"?> <Offers UserId="12312313" ResponseUrl="http://www.serwis.pl/skrypt"> <Offer SourceId="1234567" CategoryId="1"> <OfferTitle><![CDATA[Programista PHP Symfony]]></OfferTitle> <ApplyLink><![CDATA[http://apply.pl/o=12221455]]></ApplyLink> <CompanyDescription><![CDATA[Firma jest na rynku od 20 lat...]]></companydescription> <PositionDescription><![CDATA[Opis stanowiska]]></positiondescription> <Requirements><![CDATA[<ul><li>język angielski</li> <li>prawo jazdy</li></ul>]]></requirements> <WeOffer><![CDATA[<ul><li>atrakcyjne wynagrodzenie</li> </ul>]]></weoffer> <OfferAdditional><![CDATA[Dodatki]]></OfferAdditional> <City CountryId="24"> <![CDATA[Toruń]]></City> <StartDate>2009-07-23</StartDate> </Offer> </Offers> Opis pól Pole Offer OfferTitle ApplyLink CompanyDescription PositionDescription Requirements WeOffer OfferAdditional City StartDate Opis Znacznik otwierający każde pojedyncze ogłoszenie. Posiada następujące atrybuty wymagane: - SourceId unikalny i niezmienny identyfikator oferty w Państwa serwisie - CategoryId identyfikator kategorii zgodny z identyfikatorami podanymi w tabeli CategoryId Nazwa ogłoszenia (nazwa stanowiska) Adres URL do podstrony oferty w Państwa serwisie Opis firmy wystawiającej ogłoszenie Opis stanowiska Wymagania Oferta Dodatkowa oferta/dodatki Miejscowość pracy. Jeśli praca nie jest na terenie Polski należy uzupełnić atrybut CountryId, zgodnie z tabelą CountryId Data wystawienia ogłoszenia w formacie YYYY-MM-DD Tabela CategoryId CategoryId Państwo 1 Administracja 2 Agencje ochrony 3 Architektura/Projektowanie
4 Badanie i rozwój 5 Budownictwo 6 Edukacja/Szkolenia 7 Elektryka/Elektronika 8 Energetyka 9 Farmaceutyka/Biotechnologie/Kosmetologia 10 Finanse/Bankowość 11 Gastronomia/Catering 12 Grafika/Fotografia 13 Handel/Sprzedaż 14 Human Resources/Doradztwo personalne 15 Informatyka/Administrowanie 16 Informatyka/IT 17 Inne 18 Internet/E-Commerce 19 Inżynieria/Konstrukcje 20 Kadra zarządzająca 21 Kontrola jakości 22 Księgowość/Audyt 23 Logistyka/Transport 24 Marketing/Reklama/Public Relations 25 Media/Sztuka/Rozrywka 26 Motory 27 Nieruchomości 28 Obsługa klienta/call center 29 Opieka medyczna 30 Organizacje pozarządowe/wolontariat 31 Praca dla studenta 32 Praca fizyczna 33 Prawo 34 Przemysł 35 Rolnictwo/Leśnictwo/Ochrona środowiska 36 Sport/Rekreacja 37 Telekomunikacja 38 Tłumaczenia 39 Turystyka/Hotelarstwo 40 Ubezpieczenia
41 Zakupy 43 Sprzedaż bezpośrednia Tabela CountryId CountryId 1 Albania 2 Austria 3 Belgia 4 Białoruś 5 Bośnia i Hercegowina 6 Bułgaria 7 Chorwacja 8 Czechy 9 Dania 10 Estonia 11 Finlandia 12 Francja 13 Grecja 14 Hiszpania 15 Holandia 16 Irlandia 17 Litwa 18 Łotwa 19 Macedonia 20 Malta 21 Mołdawia 22 Niemcy 23 Norwegia 24 Polska 25 Portugalia 26 Rosja 27 Rumunia 28 Serbia 29 Słowacja 30 Słowenia 31 Szwajcaria 32 Szwecja Państwo
33 Ukraina 34 Węgry 35 Wielka Brytania 36 Włochy 37 Stany zjednoczone 38 Inne państwa 3. Najczęstsze problemy 1. Brak deklaracji kodowania znaków <?xml version= 1.0 encoding= UTF-8?>. 2. Brak prawidłowego rozpoczęcia pliku <?xml version= 1.0 encoding= UTF-8?> <Offers UserId= 12312313 ResponseUrl= http://www.serwis.pl/skrypt >. 3. Stosowanie <Offers> przy każdym produkcie zamiast tylko raz, jako oznaczenie całej oferty. 4. Mylenie znacznika <Offers> z <Offer>. 5. Brak stosowania CDATA dla wartości tekstowych zawierających znaki &,, ', <, >. 6. Wstawianie kodu javascript/php/innego w ramach pliku z dokumentem XML. 7. Użycie spacji w adresach url ogłoszeń. 8. Stosowanie czcionek narodowych innych niż polskie. 9. Błędne zapisywanie CDATA, najczęściej dotyczy to pomijania nawiasów. Prawidłowy zapis to <znacznikxml><![cdata[treść]]></znacznikxml>. 10. Brak dostępu do pliku XML z powodu stosowanych filtrów IP. 11. Brak zamknięć znaczników, zamykanie znaczników przed ich otwarciem, niepełne znaczniki [brak nawiasów]. 12. Nie wypełnienie wszystkich wymaganych pól. 4. Pomoc techniczna W celu uzyskania pomocy technicznej związanej z przygotowaniem dokumentu XML prosimy o kontakt pod adresem info@24portal.pl.