Stand 13.07.01
Version 1.0.08
von Cornelia Krebs (cornelia.krebs@flowfact.de)
Vorweg : Allgemeines zu den Börsenschnittstellen
Erstübertragung :
Noch nicht übertragene Objekte werden Online gestellt, wenn "noch nicht übertragen" abgewählt wurde und in der Übertragungsmatrix unter "Objektdaten / 5..( Internet)" eine der Optionen Kurz- bzw. Langexpose ausgewählt wurde, zusätzlich dazu können die Adressangaben des Objektes veröffentlicht werden, aber diese Option allein führt nicht zur Übertragung.
Aktualisierung :
bereits übertragene Objekte werden aktualisiert, wenn das Änderungsdatum nach dem Datum der letzten Übertragung liegt. Achtung: hier wird bei Objekten, die einem STAMM-Objekt untergeordnet sind, auch das Änderungsdatum des STAMM-Objektes (alle übergeordneten) berücksichtigt.
Löschen :
Wenn ein Objekt archiviert wurde (Achtung: hier muss die Option 'Archiv einbeziehen' unter 'Ansicht' gesetzt sein), auf inaktiv gesetzt, in den Objektdetails die Feldart "Archivgrund" erfasst worden ist (nur bei RDM-Standard) oder in der Übertragungsmatrix die entsprechende Option entfernt wurde, wird dieses Objekt in der Internet Börse gelöscht bzw. mit dem Status "deleted" übertragen.
Was wird übertragen ?
Verschiedene Daten des Objektes, die erfassten Objektdetails und dem Objekt zugeordnete Bilder.
Bei den Objektdetails wird berücksichtigt, ob übergeordnete STAMM-Objekte vorhanden sind.
Dies bedeutet:
·
In diesem Fall werden Objektdetails des STAMM-Objektes, die in den Objektdetails des zu übertragenden Objektes nicht vorhanden sind, dem eigentlich zu übertragenden Objekt temporär hinzugefügt. Dies gilt für alle Hirachie - Ebenen!·
Ebenso werden die Texte aus den Langexposefeldern (Freier Text, Lage, Ausstattung, Beschreibung) berücksichtigt: wenn zu dem Objekt selbst keine oder nur manche Texte erfasst sind, wird, wenn STAMM-Objekte vorhanden sind, solange gesucht bis entweder Texte gefunden werden oder die oberste Ebene der Objekt - Hirachie erreicht ist.·
Bei den zu übertragenden Bildern (max. 3 bei DIB – bei Langexpose) wird entsprechend vorgegangen.
Weitere Angaben über die Schnittstellenfelder finden Sie in der Schnittstellenbeschreibung der DIB (Externe-Makler-Datenschnittstelle-1.0.08(DIB).rtf)
|
Feldname bei DIB |
Angaben über das gesuchte Feld, bzw. der interne Name |
anpassbar |
|
laufende Nummer |
Diese Nummer wird generiert und dient der Zuordnung von Bilden zu den einzelnen Objekten |
|
|
Objektnummer |
Wert aus dem Feld Kennung der Objektdaten |
|
|
Anzahl Zimmer |
Wert aus dem Feld "ZimmerAnzahl" |
R |
|
Wohnfläche in m² |
Wert aus dem Feld "WohnFläche" |
R |
|
Grundstücksfläche in m² |
Wenn es sich nach der Objektzuordnung um ein Land-/ Forstwirtschaftliches Objekt handelt wird hier bei fehlendem Objektdetail "Grundfläche" nach "GrundHa" als Flächenangabe gesucht (der Hektar-Wert wird dann umgerechnet). |
R |
|
Baujahr |
Wert aus dem Feld "BauJahr" |
R |
|
PLZ |
hier wird ebenfalls zuerst nach dem RDM-Standard und dann alternativ nach freien Feldarten gesucht. Bei nicht erfasstem Land wird "Deutschland" unterstellt |
R |
|
Ort |
s.o. |
R |
|
Bundesland |
Hier wird das Optionsfeld "Bundesland" erwartet, dessen Einträge unter dem Options-Wert dem RDM-Standard entsprechen. Bei fehlender oder andersartiger Erfassung wird der Wert 1 (= keine Angaben) übermittelt. DIB generiert den Wert dann aus PLZ/Ort |
(R ) |
|
Regierungsbezirk |
Hier wird davon ausgegangen, dass dies nicht als Feldart angelegt wird und daher auch bei den Objektarten erfasst wird. Daher wird hier immer der Wert 1 (= keine Angaben ) übertragen. |
|
|
Land |
KFZ Länder- Kennzeichen für das jeweilige Land ( s. Feld PLZ), die Erfassung von 3-st. ISO Kennzeichen in Land/Plz/Ort wird auch verarbeitet |
R |
|
Preis |
Gesamtkaufpreis (aus Feld "KaufPreis") oder Miete (aus Feld "Miete"), hier ist der Standard in der DIB "zzgl. Nebenkosten". Hier ist es nicht möglich ein Intervall zu übertragen! |
R |
|
Verkauf- oder Mietobjekt |
Kaufpreis oder Miete, je nach dem was als Art eingetragen ist (EART). Hier wird bei der Doppel-Option "Kauf/Miete" entsprechend der erfassten Objektdetails weiter entschieden wie das Objekt übertragen wird. . |
|
|
Courtage |
Wert aus Provision (PROV_INT) Interessent/Käufer/Mieter in den Objektdaten .NEU: Hier wird bei RDM-Maklern davon ausgegangen, dass der Wert immer inkl. der MWST erfasst ist, da dies vom RDM so gefordert wird. Bei 'Nicht-RDM-Maklern' wird geprüft ob das Feld 'Provision inkl. MWST' erfasst ist und als letzte Alternative wird der Wert als 'inkl. MWST' behandelt falls der Zahlenwert 116% von einer glatten Zahl entspricht.(wie z.B. 2,9 116% von 2,5 entsprechen oder 3,48 116% 3 von ) Für die korrekten Werte muss der Anwender Sorgfalt tragen! |
|
|
Status |
"online" oder "deleted", wird entsprechend der Einstelllungen auf der Seite "Internet" und den Änderungen am Objekt generiert |
|
|
Objekt-beschreibung |
Entsprechend der Einstellung Lang- oder Kurzexpose in der Übertragungsmatrix, werden die Headline + Exposedetails + Beschreibungstexte verwendet Hier spielt der interne Name der Objektdetails keine Rolle, entscheidend ist nur, ob die Feldart im Kurz- bzw. Langexposé verfügbar sein soll. Bei dem RDM-Standard besteht hier kein Spielraum und es kann dadurch zur wiederholten Darstellungen von Werten kommen. Bei freien Feldarten ist dies natürlich frei wählbar, aber wirkt sich auf den globalen Word-Platzhalter OBJ_ExposeDetails aus. Dies sollte hier bedacht werden! Als erste wird das Objektdetail "Headline" (sollte dies fehlen: "Beschreibung") genommen. · Bei Numerischen-/Währungsfeldern wird bei einer, in der Feldart hinterlegten Formatierung, der formatierte "BIS_NUM" Wert eingetragen, bei fehlender Formatierung der Eingabewert (der auch unter den Objektdetails dargestellt wird).· Bei einer Adressfeldart wird aus der verknüpften Adresse die Anrede und der Namen übernommen. Falls zusätzlich unter dieser Adresse Details erfasst sind, werden hier die Felder "AD_Telefon" und "AD_Email" gesucht. "AD_Telefon" wird mit in der Tabelle dargestellt, Einträge unter "AD_Email werden im Schnittstellenfeld "kaufm. Email" eingetragen (siehe unten).Diese Adressfeldart kann auch im RDM-Standard zusätzlich angelegt werden! Der interne Name spielt keine Rolle, darf aber nicht "MaklerAnsprech" lauten, da dieser schon vergeben ist. · Bei allen anderen Feldarten wird der Eingabewert verwendet. Dies bietet daher auch die Möglichkeit Intervallwerte darzustellen.Anschließend wird bei gewünschtem Langexposé der Inhalt aus den Langexposetexten (in dieser Reihenfolge) "Lage", "Ausstattung", "Objekt", "Freier Text", mit Überschriften angehängt. Bei Objekten, bei denen der eigene Langexposetext leer ist, kommt die Stamm-Objekte-Funktion zum Tragen - s.o.). |
(R ) |
|
Objektart |
Hier wird der Wert der Feldartoptionen über eine Zuordnungstabelle (Objektzuordnung der entsprechenden DIB-Objektart zugeordnet, ist aber auch abhängig von Nutzungsart (bei RDM-Feldarten), und der Eigenschaft als Anlageobjekt. Jetzt ist es auch möglich mehrere Objektarten bei der Zuordnung zu hinterlegen, die jeweils erste wird auf das gewerbliche Pendant umgesetzt (siehe Objektarten DIB). Als Defaultwert (z.B. bei fehlerhaften Objektarten) wird je nach Nutzungsart der Wert 18 (Sonstiges, privat) bzw. 16 (Sonstiges,gewerblich) eingetragen. |
R |
|
GUID |
DSN des Objektes. Diese dient der eindeutigen Identifizierung des Objektes zum Aktualisieren der Daten |
|
|
Gewerbefläche in m² |
Abhängig von der Objektart nach der Zuordnung, wird nach verschiedenen Flächen oder auch nur nach der "GewerbeFläche" gesucht (z.B. bei Gastronomieobjekten nach "GastroFläche", bei Läden nach "VerkaufsFläche" ). Sollten diese Felder nicht erfasst sein, wird dann der Wert der "GewerbeFläche" genommen. |
R |
|
eMail Technik |
eMail - Adresse an die Importfehlermeldungen geschickt werden. Wenn das Feld "ObjektDatenAdminMail" nicht erfasst ist, wird aus den Grundeinstellungen / Firmendaten die Firmen-eMail-Adresse verwendet. Für diesen Fall sollte, über den Tobit Server, eine Verteilung der eingehenden Importfehler-eMails der DIB eingerichtet werden. |
R |
|
eMail Ansprechpartner |
max. 250 Zeichen, mehrere eMail-Adressen von Objektbeteuern, die durch Komma getrennt werden und an die direkt Kundenanfragen gesendet werden können. |
R |
|
Währung |
z.Zt nur DEM oder EUR ( "Extras / Grundeinstellungen / Allgemein" ). Bei dem Eintrag "EUR" wird dies übernommen, ansonsten momentan nur "DEM" |
Anpassung
Die Anpassung wird über den internen Namen einer Feldart durchgeführt und ist nur für die Muss-Felder notwendig. Bei DIB gibt es z.Zt.keine Feinselektion im. Die nicht erforderlichen Felder und alle weiteren gewünschten Daten können in dem Beschreibungsfeld dargestellt werden.
Bei den "technischen Feldern" (Daten die einzeln den definierten Schnittstellenfeldern zugeordnet werden) werden einige Daten direkt aus den Objektdaten übernommen und sind somit nicht anpassbar (siehe oben). Andere werden aus den Objektdetails genommen und sind an individuelle Feldarten anpassbar, da hier ja nach dem internen Namen gesucht wird.
Bei der Verwendung der Feldarten wird aber ein entsprechender Feldart-Typ erwartet, da abhängig von diesem Typ Daten aus unterschiedlichen Datenbank-Feldern gesucht werden und entsprechend verarbeitet werden müssen.
Liste der Objektdetailfeldarten die für DIB anhand ihres internen Namens gesucht werden und die Alternativen die eingetragen werden können bzw. müssen
| Interner Name/ eingerückt: Alternativen | RDM-Standard | Zwingend/ Alternative erforderlich | Anmerkung | Typ/ verwendeter Datenwert | |||
| AD_Telefon |
Adressdetails Telefonnummer Gehören zu Makleransprech (bzw. Objektbetreuer ) dieser wird aber nicht nach dem intern Namen gesucht! |
Text, Eingabe | |||||
| ArchivGrund | R |
Dient bei RDM-Standard zur Festlegung, ob Objekt archiviert werden soll. |
Optionsfeld, Optionswert |
||||
| BauJahr | R | R | Nummerisch, Intervall in der Feldart möglich, übertragen wird aber nur der Wert aus BIS_NUM | ||||
| Bundesland | R | Optionswerte wie bei RDM | Optionsfeld Optionswert | ||||
| GewerbeFläche |
R |
R |
Gewerbefläche (m²) - nur bei Gewerbeobjekten | Nummerisch, Intervall in der Feldart möglich,übertragen wird aber nur der Wert aus BIS_NUM | |||
| GastroFläche | R | Nummerisch, Intervall in der Feldart möglich,übertragen wird aber nur der Wert aus BIS_NUM | |||||
| BüroFläche | R | Nummerisch, Intervall in der Feldart möglich,übertragen wird aber nur der Wert aus BIS_NUM | |||||
| PraxisFläche | R | Nummerisch, Intervall in der Feldart möglich,übertragen wird aber nur der Wert aus BIS_NUM | |||||
| VerkaufsFläche | R | Nummerisch, Intervall in der Feldart möglich,übertragen wird aber nur der Wert aus BIS_NUM | |||||
| Grundfläche | R | R | Grundstücksfläche m² | Nummerisch, Intervall in der Feldart möglich,übertragen wird aber nur der Wert aus BIS_NUM | |||
| GrundHa | R | Hektarangabe für land-/ forstwirtschaftliche Flächen, wird in m² umgerechnet | Nummerisch, Intervall in der Feldart möglich,übertragen wird aber nur der Wert aus BIS_NUM | ||||
| HeadLine | R | R | Überschrift des Beschreibungstextes | Text, Eingabe | |||
| Beschreibung | R | Text, Eingabe | |||||
| KaufPreis | R | R | Gesamt Kaufpreis, bei fehlenden Werten wird Objekt nicht importiert | Währung, Intervall in der Feldart möglich,übertragen wird aber nur der Wert aus BIS_NUM | |||
| LAND_PLZ_Ort | R | R | Bei fehlender Adresse wird das Objekt verworfen | Land/Plz oder Text, Eingabe | |||
| PLZ_Ort | R | Die alternative PLZ/Ort ist nur erforderlich, wenn das Standardfeld nicht existiert | Land/Plz oder Text, Eingabe | ||||
| Nur_Land | Land zu Adresse | Text, Eingabe | |||||
| Nur_Ort | Ort | Text, Eingabe | |||||
| Nur_PLZ | Nur PLZ in dieses Feld! | Text, Eingabe | |||||
| Miete | R | R | Miete DM, s.o. | Währung, Intervall in der Feldart möglich,übertragen wird aber nur der Wert aus BIS_NUM | |||
| NutzungsArt | R |
Optionswert lt. RDM Standard |
Optionsfeld, Optionswert | ||||
| InvestmentObjekt | Ja/Nein | ||||||
| IstGewerbe | Ja/Nein | ||||||
| IstPrivat | Ja/Nein | ||||||
| ObjArt | R | R | Objektart | Optionsfeld, Optionswert | |||
|
ObjektDatenAdminMail |
R | Text, Eingabe | |||||
| AD_Email | Adressdetails eMailadresse | Text, Eingabe | |||||
| EMail-Adresse der Firma aus Grundeinstellungen | R | Bei fehlender Emailadresse wird Objekt verworfen | Text, Eingabe | ||||
| Straße | R | Straße, nur benötigt wenn Adresse mit veröffentlicht wird | Text, Eingabe | ||||
| WohnFläche | R | R | Wohnfläche (m²) | Nummerisch, Intervall in der Feldart möglich,übertragen wird aber nur der Wert aus BIS_NUM | |||
| ZimmerAnzahl | R | R | Zimmerzahl | Nummerisch, Intervall in der Feldart möglich,übertragen wird aber nur der Wert aus BIS_NUM | |||
Ablauf der Übertragung
Für den Transfer wird im lokalen temp. Verzeichnis (bei NT / 2000 benutzerabhängig!) das Unterverzeichnis /TRANFER angelegt. In dieses Verzeichnis wird die .log-Datei geschrieben und für jede Börse ein eigenes weiteres Unterverzeichnis angelegt.
Nach dem die Abfrage, für alle in Frage kommenden Objekte erstellt wurde, werden diese, wie folgend beschrieben, verarbeitet (bei großen Datenmengen geschieht dies blockweise zu je 100):
·
Im Temp/TRANSFER/DIBTRANSFER wird bei DIB ein weiteres Unterverzeichnis angelegt, das aus Datum & Zeit & DIB Kundennummer besteht. In diesem wird die " DATA.CSV ", die Datei mit den eigentlichen Daten, angelegt und für jedes Objekt, das Bilder hat, ein Unterverzeichnis, gleichlautend mit der laufenden Nummer des Objektes aus der DATA.CSV . In diesem werden dann die, u.U. auf 64 kb komprimierten, *.Jpg Bilder bereitgestellt. Als letztes wird eine Login.txt Datei erstellt. Sollte bei der Erstellung der CSV ein Fehler auftreten, wird versucht das entsprechende Objekt auszulassen.·
Nach dem alle Daten zusammengestellt sind, wird das Unterverzeichnis aus Datum & Zeit & DIB Kundennummer, so wie es vorliegt auf den Host bei DIB übertragen. Zuerst die DATA.CSV , dann werden die Verzeichnisse für die Bilder auf dem Host angelegt und die entsprechenden *.Jpg's übertragen und wieder zuletzt die Login.txt
Sollten Übertragungsfehler auftreten, wird dreimal versucht den Vorgang zu wiederholen, sollte dieser denn noch nicht mehr erfolgreich beendet werden, wird:
a.) bei der Übertragung von Bildern versucht das nächste Verzeichnis anzulegen und hier weiter fortzufahren
b.) bei anderen Anweisungen der Vorgang beendet
Bei der Übertragung zu DIB und bei mehr als 170 Objekten findet die Übertragung blockweise zu je hundert statt! D.h. die DATA.CSV wird für die ersten hundert Datensätze erstellt und übertragen , dann für die nächsten hundert,usw. Hierbei können natürlich wesentlich weniger Objekte in der DATA.CSV enthalten sein, da z.B. nicht allle der geprüften Hundert übertragen werden müssen.
Nach erfolgreicher Übertragung einer Datei (und der zugehörigen Bilder) wird der Status der Objekte und der Zeitpunkt der Übertragung in der Datenbank gespeichert und die DATA.CSV wird in das Verzeichnis TRANSFER verschoben und umbenannnt
Sollte bei der Übertragung eines Blockes ein Fehler aufgetreten sein, so wird versucht mit der Übertragung des nächsten Blockes fortzufahren.
In der Transfer.log Datei wird folgendes mit protokolliert:
·
Beginn des Aufrufes;·
Beginn der Erstellung der *.csv;·
Angaben über den aktuellen Datensatz-Block·
Auflistung der übernommene Objekte, Objekte die aufgrund mangelhafter Daten nicht ausgelassen wurden und Objekte bei denen Fehler aufgetreten sind;·
Ende der CSV Erstellung;·
Beginn der FTP-Übertragung;·
Alle FTP Anweisungen, die ausgeführt werden·
Aufgetretene Fehler·
Ende der FTP-Übertragung·
Gesamt Endeweitere häufige Ursachen für die Störung der Übertragung :
·
Temp. Transferverzeichnis oder eine der Dateien aus dem Verzeichnis ist noch geöffnet (dies macht normalerweise nur einer der testet) - dann kommt die Meldung das der Zugriff verweigert wirdZum Überspringen/ Auslassen eines Objektes während der Erstellung kommt es bei folgendem:
·
Fehlende Objektdetails (kommt normalerweise nur bei wilden Testdaten vor)·
Fehlende techn. Email-Adresse à Feld Ansprechpartner ist nicht erfasst und nicht einmal in den Firmendaten ist eine Email-Adresse hinterlegt.·
fehlender PLZ/Ortsangaben·
wegen Trenner-Überzahl à z.B. in den Ortsnamen befinder sich ein Semikolon·
alle anderen möglichen Daten/Typenfehler, die durch fehlerhafte Daten entstehen können