Genervání Hmepage ze serveru AReality.sk 9. 9. 2010 - Ing. Jiří Fřt Diadema Sftware s.r.. Verze 3.5 Diadema Sftware s. r.. Stránka 1
Obsah Obsah... 2 1. Obecně k prpjení dat... 3 2. Typy prpjení dat... 4 3. Prpjení pmcí IFRAME... 5 3.1. Základní parametry... 5 3.2. Typy genervání... 5 3.3. Nvě vlžené zakázky... 5 3.4. Všechny zakázky... 6 3.5. Rychlé hledání... 6 3.6. Pdrbné hledání... 6 3.7. Zbrazení knkrétníh výběru... 6 3.8. Pčet zakázek pr knkrétní výběr... 7 3.9. Cizjazyčné vyhledávání... 7 4. XML - Prpjení pmcí dynamicky genervaných stránek... 8 4.1. Pstup získání dat ze serveru... 8 4.1.1. Vytvření dtazu... 8 4.1.2. Zbrazení získaných dat... 8 4.1.3. Zbrazení detailu knkrétní nemvitsti... 8 4.1.4. Cizjazyčné zbrazení... 8 4.2. Další dpručení... 9 5. WebService - Prpjení pmcí webvých služeb... 10 5.1. Číselníky... 10 5.2. Webvá služba... 10 5.2.1. Metda Search... 10 5.2.2. Metda Detail... 11 5.2.3. Zbrazení brázků... 12 Diadema Sftware s. r.. Stránka 2
1. Obecně k prpjení dat Genervání Hmepage je služba služící k prpjení webvých stránek jedntlivých realitních kanceláří s daty na serveru areality.sk. Umžňuje tak centralizvané vládání zakázek na serveru areality.sk a zárveň na webvých stránkách realitní kanceláře. Makléři tak editují puze data na serveru areality.sk a všechny změny jsu jim autmaticky prmítnuty d jejich dalších prezentací. Makléři tak neztrácení čas neustálým přepisváním něklika databází stejnými daty. Realitní kanceláře mají mžnst spjit d své WWW prezentace nabídky všech svých pbček, které inzerují na serveru samstatně, a připjit také nabídky partnerských firem v rámci aliancí. Pr více infrmací pbčkách, aliancích a jejich nastaveních kntaktujte zástupce serveru. Diadema Sftware s. r.. Stránka 3
2. Typy prpjení dat Pr genervání je mžné pužít 3 mžnsti prpjení dat: 1. IFRAME, ve kterém se zbrazují přím stránky ze serveru areality.sk 2. XML - dynamicky genervané stránky (asp, php, ) které se během svéh zpracvání dtazují serveru areality.sk na výsledky pr zbrazení. Výsledky jsu vrácena jak XML dkumenty a tyt výsledky pak dynamické stránky samy renderují d svých výstupů. 3. WebService dynamicky genervané stránky (asp, php, ) které se během svéh zpracvání dtazují pmcí webvých služeb serveru areality.sk na výsledky pr zbrazení. Výsledky pak dynamické stránky samy renderují d svých výstupů. Třetí varianta (dtazvání pmcí WebService) nabízí nejširší mžnsti pr hledání a lkalizaci výstupů d dalších jazyků. Prt je mnhem flexibilnější a je jí dsahván mnhem kvalitnějších prezentací, dpručujeme tut (WebService) variantu. Diadema Sftware s. r.. Stránka 4
3. Prpjení pmcí IFRAME Implementace tht prpjení je nejjedndušší. Je mžné je pužít v libvlných stránkách. Nedvluje však plně přizpůsbit výstup pžadavkům na layut a celkvý design stránky. Implementace služby se prvádí umístěním <frame> neb <iframe> d Vaší sučasné prezentace. Atribut src se pr frame nastaví na jedn z námi pdprvaných URL. Tím djde k prpjení Vaší prezentace s naší databází. 3.1. Základní parametry Jak parametry zdrjvých URL se ddávají: ID knkrétní realitní kanceláře (parametr IDRK). K Vašim zakázkám budu vždy d všech výpisů i výsledků vyhledávání přidávané zakázky všech Vašich partnerů aliance a všech vašich pbček. Pkud nechcete přidávat cizí zakázky (partnerů neb pbček), přidejte d URL parametr NPartners=1. Pr nastavení členství v aliancích neb nastavení pbček kntaktujte prsím naše zástupce. Abslutní cesta k CSS sbru (parametr CSS). Mdifikace designu (barvy, fnt,...) je mžné prvádět pmcí úprav tht CSS. Upravený CSS je mžné umístit na libvlné URL. PictAll - pr zbrazvání náhledů brázků ve výpisu vlžte hdntu 1 Hyp - pr zbrazvání hypteční kalkulačky vlžte hdntu 1 Případné další parametry, služící ke knkrétním výběrům z databáze. 3.2. Typy genervání Systém areality.sk pdpruje pr genervání dmácích stránek využití těcht URL: Nvě vlžené zakázky Výpis všech zakázek Rychlé hledání Pdrbné hledání Knkrétní výběry 3.3. Nvě vlžené zakázky URL: http://www.areality.sk/hmepage/newlist.aspx?idrk=rk12345&css=http://abslutni-urlvaseh.css&s=7 Parametry: IDRK CSS PageSize pčet řádků (velikst stránky) zbrazvaných ve výpisu nepvinný parametr S pčet zbrazvaných dní Příklad: <iframe src="http://www.areality.sk/hmepage/newlist.aspx?idrk=rk12345&css=http://www.mjerk.s k/realitysk.css"/> Diadema Sftware s. r.. Stránka 5
3.4. Všechny zakázky URL: http://www.areality.sk/hmepage/rkzakazky.aspx?idrk=rk12345&css=http://abslutni- URL-vaseh.css Parametry: IDRK CSS PageSize pčet řádků (velikst stránky) zbrazvaných ve výpisu nepvinný parametr Příklad: <iframe src="http://www.areality.sk/hmepage/rkzakazky.aspx?idrk=rk12345&css=http://www.mjer k.sk/realitysk.css"/> 3.5. Rychlé hledání URL: http://www.areality.sk/hmepage/quicksearchresult.aspx?idrk=rk12345&css=http://abslutni -URL-vaseh.css Parametry: IDRK CSS Příklad: <iframe src="http://www.areality.sk/hmepage/quicksearchresult.aspx?idrk=rk12345&css=http://ww w.mjerk.sk/realitysk.css"/> 3.6. Pdrbné hledání URL: http://www.areality.sk/hmepage/detailsearch.aspx?idrk=rk12345&css=http://abslutni- URL-vaseh.css Parametry: IDRK CSS Příklad: <iframe src="http://www.areality.sk/hmepage/detailsearch.aspx?idrk=rk12345&css=http://www.mj erk.sk/realitysk.css"/> 3.7. Zbrazení knkrétníh výběru URL: http://www.areality.sk/hmepage/detailsearchresult.aspx?idrk=rk12345&css=http://abslutn i-url-vaseh.css Parametry: IDRK CSS Druh knkrétní výběr druhu nemvitsti (byty, pzemky, ). Je mžné zadat více hdnt ddělených čárku Diadema Sftware s. r.. Stránka 6
Typ knkrétní výběr typu (prdej, prnájem, ). Je mžné zadat více hdnt ddělených čárku Kraj knkrétní výběr kraje. Je mžné zadat více hdnt ddělených čárku Okres knkrétní výběr kresu. Je mžné zadat více hdnt ddělených čárku JakStare knkrétní výběr stáří zakázky. Uvádí se jen hdnta ve dnech. PageSize pčet řádků zbrazených ve výpisu. Nepvinný parametr. SlLen maximální délka zbrazenéh slganu. Nepvinný parametr. Seznam hdnt pr tyt parametry najdete zde http://www.areality.sk/rs/rsblob.aspx?blbid=3fb0a487a96f3911fd7138c9d4ef374 1.xls Příklad: <iframe src="http://www.areality.sk/hmepage/detailsearchresult.aspx?idrk=rk12345&css=http://ww w.mjerk.sk/realitysk.css&druh=10&typ="/> 3.8. Pčet zakázek pr knkrétní výběr URL: http://www.areality.sk/hmepage/pcetzak.aspx?idrk=vase-idrk Ppis: Script služí pr zbrazení pčtu zakázek (například d menu) pr knkrétní výběr Parametry: Parametry mají stejný význam jak parametry pr knkrétní výběr Příklad: <script src="http://www.areality.sk/hmepage/detailsearch.aspx?idrk=rk12345druh=10&typ= "></script> 3.9. Cizjazyčné vyhledávání Pmcí IFRAME je mžné zbrazit vyhledávání i v německém a anglickém jazyku. Stránky pr cizjazyčné výběry je mžné zbrazit pmcí stejných dkazů, které se nacházejí v pdadresáři pr daný jazyk. V sučasné dbě je mžné pužít adresáře http://www.areality.sk/hmepage/eng pr angličtinu http://www.areality.sk/hmepage/de pr němčinu. Např. URL http://www.areality.sk/hmepage/eng/newlist.aspx?idrk=rk12345&css=http://abslutni- URL-vaseh.css&s=7 služí pr zbrazvání nvinek v anglické jazykvé lkalizaci. Diadema Sftware s. r.. Stránka 7
4. XML - Prpjení pmcí dynamicky genervaných stránek Tent způsb prpjení dat je mnhem flexibilnější. Vývjář webvé prezentace má mžnst data získávat nline přím ze serveru v XML frmátu a následně je zbrazvat (XML transfrmací, neb jiným způsbem) v libvlném designu ptřebném pr prezentaci. IFRAME umžňval puze nasazení vlastníh stylu, který však byl svými mžnstmi velmi mezený. Nebyl například mžné plně vlivňvat celkvý layut prezentace. 4.1. Pstup získání dat ze serveru 4.1.1. Vytvření dtazu Při zpracvání vlastní stránky pr vyhledávání (na serveru - php, asp, atd.) si designér vytvří dtaz pr server areality.sk a stáhne si XML výsledek svéh hledání z našeh url: http://www.areality.sk/hmepage/xml/search.aspx Např. http://www.areality.sk/hmepage/xml/search.aspx?kraj=1&typ=1&druh=12,13&jakstare=14&kres=102,103&maxcena=1256325&idjedntkacena=1 Parametry hledání jsu stejné jak při vytváření URL pr IFRAME genervání. Další parametry: p - čísl stránky pagesize velikst stránky (řádky) 4.1.2. Zbrazení získaných dat P vlání výše uvedenéh URL s ptřebnými parametry bdržíte jak výsledek XML, jehž bsah následvně len vyrenderujete (za pmcí XSLT neb jinak) d ptřebnéh designu pr výpis nalezených nemvitstí. 4.1.3. Zbrazení detailu knkrétní nemvitsti Stránka pr zbrazení jedntlivých nemvitstí funguje stejně, jen je třeba pužít XML získané na adrese http://www.areality.sk/hmepage/xml/detail.aspx?idzak=aaaa-bbbbbb. Parametr je čísl zakázky (idzak). Jedntlivé brázky získáte sestavením dkazu takt: http://www.areality.sk/brazek.aspx?idzak=aaaa-bbbbbb&idbrazek=cccc 4.1.4. Cizjazyčné zbrazení Detail nemvitsti lze získat také pr jiné, systémem RealitySK pdprvané, jazyky. V sučasné dbě jsu pdprvané jazyky Němčina kód jazyku DE Diadema Sftware s. r.. Stránka 8
Angličtina kód jazyku EN Cizjazyčnu verzi získáte na URL ve tvaru http://www.areality.sk/hmepage/{kód-jazyka}/xml/detail.aspx?idzak=aaaa-bbbbbb tedy například http://www.areality.sk/hmepage/en/xml/detail.aspx?idzak=aaaa-bbbbbb 4.2. Další dpručení Výsledky dtazu na náš systém můžete samzřejmě ukládat d lkální cache, abyste se nemuseli neustále dtazvat cizíh strje. Zrychlíte tak zbrazení pr návštěvníka Vašich stránek. Diadema Sftware s. r.. Stránka 9
5. WebService - Prpjení pmcí webvých služeb Tent způsb prpjení dat má nejrzšířenější mžnsti hledání a lkalizací d jiných jazykvých mutací vašich stránek. Vývjář webvé prezentace má mžnst data získávat nline přím ze serveru pmcí Webvých Služeb a následně je zbrazvat v libvlném designu ptřebném pr prezentaci. 5.1. Číselníky Ptřebné číselníky pr pužití ve vláních funkcí naleznete na adrese http://www.areality.sk/hpv2/ws/hpwscdes.ashx?idrk={vaseidrk} Parametr {VASEIDRK} je identifikační řetězec přidělený realitní kanceláři systémem. Knkrétní ID najdete p přihlášení d členské sekce sytému. 5.2. Webvá služba WSDL ppis služby je na adrese http://www.areality.sk/ws/hp.asmx Služba bsahuje dvě metdy: Search hledání zakázek Detail získání pdrbných infrmací zakázce 5.2.1. Metda Search Metda Search služí pr vyhledání a následné zbrazení zakázek dle zadaných kritérií. Vstupní parametry idjazyk služí pr definici cílvéh jazyka. Lkalizvatelné texty jsu autmaticky vráceny v pžadvaném jazyce. Mžné hdnty pr tent parametr jsu uvedeny v číselníku v sekci LanguageList. crit vyhledávací kritéria typu WSHPSearchCriteria. Služí pr přesné zadání kritérií pr výběr dat. Budu vždy vrácena jen data dpvídající daným kritériím. PageSize, PageN velikst stránky, čísl stránky. Pkud je nastavena nenulvá hdnta parametru PageSize, bude výsledek stránkván a na výstupu bude vždy jen pžadvaná stránky. Lze využít pr zmenšení přenášených dat, pkud se na stránkách Rk zbrazují data stránkvaně. WSHPSearchCriteria Služí pr předání parametrů pr vyhledání pžadvaných nemvitstí. Výsledkem je mnžina zakázek, které splňují všechna kritéria (AND pravidl). string IDRK pvinný parametr. ID realitní kanceláře. Knkrétní ID najdete p přihlášení d členské sekce sytému. int? JakStare maximální stáří nabídky ve dnech List<string> IDTypy seznam hledaných typů nemvitstí, dle číselníku List<string> IDDruhy - seznam hledaných druhů nemvitstí, dle číselníku string IDStat ID státu, dle číselníku List<string> IDKraje - seznam krajů, dle číselníku List<string> IDOkresy - seznam kresů, dle číselníku Diadema Sftware s. r.. Stránka 10
List<string> IDObce - seznam bcí, dle číselníku int? MinVelikst minimální velikst (m2) int? MaxVelikst maximální velikst (m2) int? MinCena - minimální cena, jedntka je určena parametrem IDJedntkaCena int? MaxCena - maximální cena, jedntka je určena parametrem IDJedntkaCena string IDJedntkaCena jedntka ceny, dle číselníku List<string> IDReferenti ID makléřů, ID lze získat ve členské sekci string Fulltext výraz pr fulltextvé hledání bl Nvstavba pžadavek na hledání nvstaveb bl NPartners mžnst zbrazení zakázek d partnerských RK (pbčky, MLS). Nastavením na true budu nalezeny jen zakázky vaší RK. Výchzí nastavení je false. WSHPOrderBy OrderBy pžadavek na řazení výsledků, Může bsahvat hdnty VlzenDne, ZmenenDne a Cena OrderDirectin OrderDir směr řazení. Hdnty Asc a Desc Výstup WSHPSearchResult bsahuje pčet nalezených zakázek a nalezená data ResultCunt pčet nalezených záznamů. Nezávisle na vstupních parametrech PageSize a PageN bsahuje vždy celkvý pčet nalezených záznamů. WSHPSearchZakList ple záznamů typu WSHPSearchZakListItem. Obsahuje nalezená data. Pkud je specifikván parametr PageSize, pak bsahuje jen pžadvanu stránku. WSHPSearchZakListItem plžka výsledku hledání. Obsahuje údaje pr zbrazení na klientské straně. Vždy v pžadvaném jazyce. WSHPSearchZakListItem Plžka výsledku hledání. Obsahuje údaje pr zbrazení na klientské straně. Vždy v pžadvaném jazyce. string IDZak čísl zakázky. Služí pr jednznačnu identifikaci zakázky v systému. Pužívá se i při vlání metdy Detail. string SeUrlPart ppis, který lze využít v SEO dkazech ve vaší prezentaci, vždy příslušně lkalizván string Slgan nadpis string Ppis pdrbný ppis. Pkud je zadán, bsahuje knkrétní jazykvu mutaci. Obsahuje puze prvních 300 znaků. string Typ typ zakázky (prdej, prnájem ). V pžadvaném jazyce string Druh druh nemvitsti (byt, dům ). V pžadvaném jazyce string Obec decimal? Cena string JedntkaCena jedntka ceny (SK, SK/měsíc...). V pžadvaném jazyce DateTime? VlzenDne datum vlžení zakázky DateTime? ZmenenDne datum pslední změny zakázky int? IDObrazek čísl prvníh brázku pr zbrazení ve výpisu nalezených zakázek 5.2.2. Metda Detail Tat metda služí pr zbrazení všech detailů nemvitsti. Diadema Sftware s. r.. Stránka 11
Vstupní parametry idjazyk služí pr definici cílvéh jazyka. Lkalizvatelné texty jsu autmaticky vráceny v pžadvaném jazyce. Mžné hdnty pr tent parametr jsu uvedeny v číselníku v sekci LanguageList. idrk - pvinný parametr. ID realitní kanceláře. Knkrétní ID najdete p přihlášení d členské sekce sytému idzak čísl zakázky Výstup Výstupem je struktura typu WSHPZakazka. Obsahuje tyt plžky: bsahuje stejné plžky jak WSHPSearchZakListItem string Ppis pdrbný ppis. Pkud je zadán, bsahuje knkrétní jazykvu mutaci. string PpisDefaultLang - pdrbný ppis ve výchzím jazyce aplikace string IDReferent ID makléře decimal? Velikst WSHPKntakt Kntakt Kntakt na makléře. Pkud je u zakázky uveden referent, bude tat struktura bsahvat jeh údaje. Pkud se jedná zakázku partnerské RK, pak zde údaje nebudu, na stránkách RK se tedy budu zbrazvat partnerské zakázky, ale s kntakty na vlastní RK. Obsahuje plžky: string Prijmeni - příjmení string Jmen - jmén string Titul - titul List<string> Email seznam emailů string Tel - telefn string Fax - fax WSHPObrazek[] Obrazky seznam všech brázků. Vždy dvjice (IDObrazek, Ppis) WSHPCharakteristika[] Charakteristiky seznam charakteristik. Vždy trjice (Nazev, Hdnta, Měrná jedntka). Vždy v pžadvané jazykvé mutaci 5.2.3. Zbrazení brázků Obrázky lze získat na tmt URL http://www.areality.sk/ashx/brazek.ashx?idzak={idzak}&idobrazek={idobr}&maxx={maxx}&maxy={maxy} Systém autmaticky prvádí změnu veliksti na pžadvaný rzměr. Systém autmaticky implementuje cache mechanismus pr uchvání brázků v různých velikstech. Parametry IDZak čísl zakázky IDObrazek čísl brázku MaxX, MaxY maximální šířka, výška v pixelech. Nepvinné parametry. V případě uvedení těcht parametrů systém autmaticky prvede změnu veliksti tak, aby se výsledný brázek vešel d pžadvanéh bdélníku. Diadema Sftware s. r.. Stránka 12
5.2.4. Metda WriteInterest Tat metda služí k zapsání zájmu. Pkud návštěvním prjeví zájem danu zakázku, vláním tét metdy djte: k zápisu tht zájmu d databáze systému zápis d statistik zakázky deslání infrmačníh mailu dané RK Parametry string idrk čísl RK WSHPInterest interest detail zájmu. Obsahuje ple: string IDZak čísl zakázky, pvinný parametr string Jmen jmén uživatele string Telefn - telefn string Email - email string Text uživatelský text k zájmu Diadema Sftware s. r.. Stránka 13