Instrukcja integracji z portalem ogłoszeń praca.24portal.pl

Wielkość: px

Rozpocząć pokaz od strony:

Download "Instrukcja integracji z portalem ogłoszeń praca.24portal.pl"

Tadeusz Jabłoński
8 lat temu
Przeglądów:

1 Instrukcja integracji z portalem ogłoszeń praca.24portal.pl Wersja: 1.0 Data utworzenia: Data auktualizacji: Adres: E1 Jędrzej Hiller Maciej Algusiewicz Spółka Cywilna, ul. Przełajowa 2, Poznań

2 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. 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)

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.

3 Przykładowy plik XML <?xml version="1.0" encoding="utf8"?> <Offers UserId=" " ResponseUrl=" <Offer SourceId=" " CategoryId="1"> <OfferTitle><![CDATA[Programista PHP Symfony]]></OfferTitle> <ApplyLink><![CDATA[ <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> </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

..]]></companydescription> <PositionDescription><![CDATA[Opis stanowiska]]></positiondescription> <Requirements><!

4 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

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

5 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

14 Hiszpania 15 Holandia 16 Irlandia 17 Litwa 18 Łotwa 19 Macedonia 20 Malta 21 Mołdawia 22 Niemcy 23

6 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= ResponseUrl= >. 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.

Stosowanie <Offers> przy każdym produkcie zamiast tylko raz, jako oznaczenie całej oferty. 4. Mylenie znacznika <Offers> z <Offer>. 5.

Podobne dokumenty

Euro 2016 QUALIFIERS. Presenter: CiaaSteek. Placement mode: Punkte, Direkter Vergleich, Tordifferenz, Anzahl Tore. Participant.

Euro 2016 QUALIFIERS. Presenter: CiaaSteek. Placement mode: Punkte, Direkter Vergleich, Tordifferenz, Anzahl Tore. Participant. Presenter: CiaaSteek Date: 10.01.2017 Time: 10:00 City: France, Paris Spieldauer: 10min Placement mode: Punkte, Direkter Vergleich, Tordifferenz, Anzahl Tore Participant Gruppe A 1 Niemcy 7 Belgia 2 Polska