Importarea anunturilor imobiliare din surse externe.

Actualizat la 22.12.2007

1. Privire de ansamblu

Acest document prezinta modalitatea prin care se pot importa, intr-un mod rapid, anunturi imobiliare din surse externe. Documentul se adreseaza persoanelor care administreaza site-uri cu anunturi imobiliare si care doresc promovarea anunturilor, prin publicarea lor pe mai multe site-uri.

Cateva motive pentru care republicarea anunturilor pe acest site ar aduce beneficii:

  • Publicarea anunturilor se face in mod gratuit.
  • Fiecare anunt publicat va avea un link catre site-ul/pagina de detalii sursa.
  • Anunturile sunt publicate fara date de contact, astfel incat singura modalitate prin care utilizatorii interesati pot afla mai multe detalii despre un anunt, este navigarea catre site-ul sursa. Asadar publicarea de anunturi pe acest site are ca efect cresterea numarului de vizitatori pe site-ul d-voastra.

2. Observatii generale privind structura fisierului de import

Fisierul folosit in cadrul modulului de import poate contine diferite tipuri de informatii: randuri ce reprezinta anunturi de inchiriere, randuri ce reprezinta imagini asociate unui anunt de inchiriere. Diferitele tipuri de randuri pot aparea aleator in fisier singura conditie este ca randurile corespunzatoare imaginilor unui anunt sa apara dupa randul ce contine anuntul.

Structura randurilor folosite in cadrul fisierului de import prezinta urmatoarele trasaturi comune:

  • Fiecare are un numar bine definit de campuri.
  • Campurile sunt separate prin "|".
  • Campurile nu au voie sa contina "|". In caz contrar liniile corespunzatoare vor fi marcate ca invalide.
  • Tipurile de campuri suportate in cadrul diferitelor randuri sunt:
    • String: este specificata in fiecare caz lungimea maxima. Este folosit pentru a specifica diferite parti ale unei adrese, diferite descrieri etc.
    • DateTime: are formatul AAAA.LL.ZZ unde AAAA reprezinta anul, LL luna iar ZZ ziua. De exemplu, 1986.10.26 reprezinta data de 26 octombrie 1986.
    • Integer: reprezinta un numar intreg (fara zecimale). De exemplu, 1000, 230000, etc
    • Short: reprezinta un numar intreg (fara zecimale). De exemplu, 10, 23, etc. Spre deosebire de Integer este folosit pentru a specifica numere mici (<255), corespunzatoare numarului de camere etc.
    • Decimal: reprezinta un numar real (cu zecimale). Separatorul dintre partea intreaga si partea zecimala este ".". Numai primele 2 zecimale sunt luate in consideratie. De exemplu, 10.23, 45.67 etc
    • Boolean: are 2 valori valide: 0-fals si 1-adevarat.

3. Structura unui rand ce reprezinta un anunt de inchiriere

Nume camp: RecordType
Tip camp: String. Valori posibile: RR
Descriere: Identifica tipul randului: anunt de inchiriere
Nume camp: AnnounceIdentificationNumber
Tip camp: String. Max 32 chars.
Descriere: Numarul de identificare al anuntului in cadrul site-ului sursa
Nume camp: LinkToAnnounce
Tip camp: String. Max 250 chars.
Descriere: Url catre site-ul sursa sau catre pagina de detalii a anuntului
Nume camp: Rent
Tip camp: Decimal. Interval valori admise: [0, 10000]
Descriere: Chiria lunara
Nume camp: RentInAdvance
Tip camp: Decimal. Interval valori admise: [0, 10000]
Descriere: Chiria care se plateste in avans la inchirierea imobilului
Nume camp: Guarantee
Tip camp: Decimal. Interval valori admise: [0, 10000]
Descriere: Garantia platita la inchirierea imobilului de catre chirias
Nume camp: Currency
Tip camp: String. Valori posibile: EUR, USD, RON
Descriere: Valuta in care sunt exprimate chiria, chiria in avans si garantia
Nume camp: ValabilityInDays
Tip camp: Short. Interval valori admise: [5, 100]
Descriere: Valabilitatea anuntului, exprimata in zile.
Nume camp: Description
Tip camp: String. Max 500 chars.
Descriere: Descrierea imobilului, a zonei etc
Nume camp: City
Tip camp: String. Max 100 chars.
Descriere: Orasul in care se afla imobilul
Nume camp: District
Tip camp: String. Max 100 chars.
Descriere: Cartierul in care se afla imobilul
Nume camp: Zone
Tip camp: String. Max 100 chars.
Descriere: Zona in care se afla imobilul
Nume camp: Street
Tip camp: String. Max 100 chars.
Descriere: Strada pe care se afla imobilul
Nume camp: Number
Tip camp: String. Max 10 chars.
Descriere: Numarul la care se afla imobilul
Nume camp: NumberOfRooms
Tip camp: Short. Interval valori admise: [1, 10]
Descriere: Numarul de camere al imobilului
Nume camp: NumberOfBalconies
Tip camp: Short. Interval valori admise: [0, 10]
Descriere: Numarul de balcoane al imobilului. Daca imobilul este casa sau nu are balcoane specificati 0
Nume camp: NumberOfBathrooms
Tip camp: Short. Interval valori admise: [1, 10]
Descriere: Numarul de bai
Nume camp: NumberOfFloors
Tip camp: Short. Interval valori admise: [1, 20]
Descriere: Numarul de etaje al cladirii in care se afla imobilul
Nume camp: Surface
Tip camp: Decimal. Interval valori admise: [10, 300]
Descriere: Suprafata imobilului exprimata in metrii patrati
Nume camp: ConstructionYear
Tip camp: Short. Interval valori admise: [1900, 2018]
Descriere: Anul de constructie al imobilului
Nume camp: HasTermopan
Tip camp: Boolean.
Descriere: Specifica daca imobilul are termopan
Nume camp: HasAirConditioning
Tip camp: Boolean.
Descriere: Specifica daca imobilul are aer conditionat
Nume camp: HasParquet
Tip camp: Boolean.
Descriere: Specifica daca imobilul are parchet
Nume camp: HasSandstone
Tip camp: Boolean.
Descriere: Specifica daca imobilul are gresie
Nume camp: HasFaience
Tip camp: Boolean.
Descriere: Specifica daca imobilul are faianta

4. Structura unui rand ce reprezinta o imagine asociata unui anunt

Nume camp: RecordType
Tip camp: String. Valori posibile: IR
Descriere: Identifica tipul randului: imagine asociata unui anunt
Nume camp: AnnounceIdentificationNumber
Tip camp: String. Max 32 chars.
Descriere: Numarul de identificare al anuntului asociat in cadrul site-ului sursa
Nume camp: ImagePathRelativeToImportFolder
Tip camp: String. Max 250 chars.
Descriere: Calea relativ la directorul root catre imaginea asociata
Nume camp: Description
Tip camp: String. Max 500 chars.
Descriere: Descrierea imaginii

5. Pregatirea datelor pentru import

Pentru publicarea unui set de anunturi trebuie:

  • sa aveti un cont valid pe site. Inregistrarea pe site este gratuita.
  • sa creati un director, preferabil avand ca nume data curenta. Pentru usurarea exprimarii, acest director va fi numit in continuare root.
  • In cadrul directorului root, creati un fisier text. Pentru fiecare anunt de inchiriere creati un rand cu structura definita mai sus. Fiecarui anunt i se pot asocia maxim 10 imagini. Pentru a asocia o imagine unui anunt, plasati imaginea in directorul root si creati un rand corespunzator in fisierul text. Intrucat imaginile trebuie sa aiba nume unice, va sugeram sa plasati nr de identificare al anuntului in fiecare nume de poza. De exemplu, pentru anuntul cu numarul 1235, dispuneti de 2 poze: Sufragerie.jpg si Dormitor.jpg. Conform sugestiei, acestea ar trebui numite: 1235_Sufragerie.jpg si respectiv 1235_Dormitor.jpg.
  • Dupa crearea directorului root, va recomandam sa arhivati acest director si sa incarcati acest director folosind contul de care dispuneti pe site.

6. Exemple

Pentru a importa un set de 2 anunturi din care unul are 2 imagini asociate un fisier asemanator cu fisierul 27.08.2007.zip trebuie creat. (click pentru download)

Copyright © 2007-2008 caut-casa.com. Toate drepturile rezervate. Termeni si conditii