Stand: 20.08.2001
IS24-Version: 1.0
von Cornelia Krebs (cornelia.krebs@flowfact.de)
Vorweg : Allgemeines zu den Börsenschnittstellen.doc
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 für ImmobilienScout24 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 (und aller anderen übergeordneten Objekte) 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 d.h. es wird nicht mehr übertragen (s.u.)
Achtung: eine vollständig leere CSV-Datei wird nicht übertragen! Falls also aus irgendeinem Grund alle Objekte bei IS24 gelöscht werden sollen, sollte der Kunde sich mit seinem Objektbetreuer dort in Verbindung setzen, und die Löschung veranlassen.
Der Objektimport bei IS24 funktioniert auf der Basis des Totalabgleichs (oder auch "Vollabgleich").D.h. für jede Lieferung eines Anbieters oder eines Standorts des Anbieters, wird der gesamte im Internet zu vermarktende Bestand übersendet.
Achtung : bei Einführung der Schnittstelle sollte vor dem ersten Import Rücksprache mit dem zuständigen Bearbeiter bei IS24 gehalten werden (besonders bei bereits bei IS24 eingestellten Objekten). Damit kann vermieden werden, dass die bestehenden Daten gelöscht werden, wenn weniger Objekte übertragen werden, als bereits in der Internet-Börse stehen.
Bei IS24 wird der Import manuell gesteuert, bei Problemen ist es daher am besten, sich direkt mit diesen in Verbindung zu setzen.
Nicht vergessen: Vor der ersten Übertragung muss von IS24 der FTP Zugang eingerichtet werden!
Als Ansprechpartener empfehlen wir Herrn Casten Mann Tel.:030/24301-1112
Verschiedene Daten des Objektes (z.Zt. nur privat genutzte Objekte), 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. 10 bei IS24 - wenn Langexpose) wird entsprechend vorgegangen.
Die vollständige Beschreibung der Schnittstellenfelder von IS24 siehe in deren Schnittstellen-Beschreibung
Die Anpassung wird über den internen Namen einer Feldart durchgeführt und ist nur für die Muss-Felder notwendig. Bei einigen anderen hat das Vorhandensein eines Feldes eine Auswirkung auf die Feinselektion in der Internetbörse (z.B. Heizungsart) und ist daher empfehlenswert. Die nicht zwingend erforderlichen Felder und alle weiteren gewünschten Daten können in dem Text-Feld Nr. 71 (s.o.) 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.
|
Interner Name / eingerückt: Alternativen |
RDM-Standard |
Muss-Feld/ Alternative erforderlich |
Anmerkung |
Typ/ verwendeter Datenwert |
||||||
|
ArchivGrund |
R |
Dient bei RDM-Standard zur Festlegung, ob Objekt bei IS24 gelöscht werden soll. |
Optionsfeld, Optionswert |
|||||||
|
Ausstattungsmerkmale |
(R ) |
Dieses Feld ist neu in die mitgelieferten Felder aufgenommen, und die optionen sind für IS24 und PropertyGate erweitert worden. |
||||||||
|
BauJahr |
R |
R |
Nummerisch, Intervall in der Feldart möglich, übertragen wird aber nur BIS_NUM |
|||||||
|
BezugsTermin |
R |
Bei RDM ist dies ein Textfeld, hier kann nur dann der Eintrag verwendet werden, wenn es sich um ein gültiges Datum handelt. |
Text, Eingabe oder Datum, Von_Num, Intervall möglich |
|||||||
|
GaragenAnzahl |
R |
Nummerisch |
||||||||
|
GaragenMiete |
R |
Währung |
||||||||
|
Geschosse |
R |
Text / Nummerisch Bei Text werden einige Besonderheiten berücksichtigt |
||||||||
|
Grundfläche |
R |
R |
Häuser ohne Grundfläche werden verworfen |
Nummerisch , Bis_Num |
||||||
|
HeadLine |
R |
R |
Headline |
Text, Eingabe |
||||||
|
Beschreibung |
R |
R |
Beschreibung |
Text, Eingabe |
||||||
|
HeizKosten |
R |
Wird zur Kaltmiete hinzugerechnet |
Währung |
|||||||
|
KaufPreis |
R |
R |
Gesamt Kaufpreis, bei fehlenden Werten wird Objekt nicht importiert |
Währung, Intervall in der Feldart möglich, übertragen wird aber nur BIS_NUM |
||||||
|
Kaution |
R |
Text |
||||||||
|
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 |
Text, Eingabe |
||||||||
|
MaklerAnsprech |
R |
R |
Ansprechpartner; wenn dies ein Adressfeld ist, wird AD_Telefon und AD_Email für verbundene Adresse gesucht (hier aber nicht wenn die Merkmale aus der Auswahlliste verwendet werden). Da bei fehlendem Ansprechpartner das Objekt verworfen wird, wird im Notfall der Firmenname eingetragen |
Textfeld oder Adressfeld |
||||||
|
AD_Email |
Adressdetails: eMailadresse |
Text, Eingabe |
||||||||
|
AD_Telefon |
Adressdetails: Telefonnummer |
Text, Eingabe |
||||||||
|
Adressdaten der Firma aus Grundeinstellungen |
Eigentlich nicht anpassbar |
|||||||||
|
Miete |
R |
R |
Miete DM, bei fehlenden Werten wird Objekt nicht importiert. |
Währung, Intervall möglich, Bis_Num |
||||||
|
Nutzfläche |
R |
Nutzfläche + Wohnfläche ergibt Gesamtfläche ( Feld 41) |
||||||||
|
NutzungsArt |
R |
Optionswert lt. RDM Standard |
Optionsfeld, Optionswert |
|||
|
IstGewerbe |
Dienen als Alternativen zur Feststellung ob es ein gewerbliches Objekt ist. Diese werden z.Zt. nicht in IS24 verwendet, soweit sich dies nicht über die Objektart ergibt |
Ja/Nein |
||||
|
IstPrivat |
Ja/Nein |
|||||
|
ObjArt |
R |
R |
Objektart |
Optionsfeld, Optionswert |
||
|
StellplatzAnzahl |
R |
Nummerisch |
||||
|
StellplatzMiete |
R |
Währung |
||||
|
Stock |
R |
Bei Text werden einige Besonderheiten berücksichtigt: E, EG, HP à 0 für Erdgeschoss D, DG à Anzahl der Geschosse |
Text, Eingabe / Nummerisch, Bis_Num |
|||
|
Straße |
R |
R |
Straße, wird aufgeteilt in Straßenname und Hausnummer. Bei fehlenden Werten wird Objekt verworfen, da diese Angabe für die Geocodierung bei IS24 erforderlich ist |
Text, Eingabe |
||
| UmKosten |
R |
Umlegbare Kosten (auf Mieter), bei Häusern daher als Nebenkosten ohne Heizung verwendet | Währung | |||
|
WohnFläche |
R |
R |
Wohnfläche (m²), Bei fehlenden Werten wird Objekt verworfen |
Nummerisch, Intervall in der Feldart möglich, übertragen wird aber nur BIS_NUM |
||
|
WohngeldOhneHzg |
R |
Nebenkosten ohne Heizung |
Währung |
|||
|
ZimmerAnzahl |
R |
R |
Zimmerzahl, , bei fehlenden Werten wird Objekt im IS24 nicht importiert. |
Nummerisch, Intervall in der Feldart möglich, übertragen wird aber nur BIS_NUM |
||
Folgende Felder können zusätzlich angelegt werden, um eine Optimierung der Daten für IS24 zur erreichen:
|
Interner Name / eingerückt: Alternativen |
RDM-Standard |
Muss-Feld/ Alternative erforderlich |
Anmerkung |
Typ/ verwendeter Datenwert |
|
Aufzug_IS24 |
Ja/Nein oder Optionsfeld, Optionswert |
|||
|
BalkTerr_IS24 |
Ja/Nein oder Optionsfeld, Optionswert |
|||
|
BetreutesWohnen_IS24 |
|
Ja/Nein oder Optionsfeld, Optionswert |
||
| BruttoWarmMiete | Der Inhalt dieses Feldes wird als Warmmiete im IS24 abgebildet. Die korrekten Angaben liegen in der Verantwortung des Anwenders! | Währungsfeld, BIS_NUM | ||
|
Einbaukueche_IS24 |
Ja/Nein oder Optionsfeld, Optionswert |
|||
|
Foerderung_IS24 |
Ja/Nein oder Optionsfeld, Optionswert |
|||
|
GartenBenutzung_IS24 |
Ja/Nein oder Optionsfeld, Optionswert |
|||
|
Haustiere_IS24 |
Ja/Nein oder Optionsfeld, Optionswert |
|||
| HeizungsArt_IS24 | Optionen müssen IS24 entsprechen: | Optionsfeld, Optionswert | ||
|
Wert |
Bezeichnung |
|||
|
0 |
unbekannt |
|||
|
1 |
Etagenheizung |
|||
|
2 |
Gas |
|||
|
3 |
Kohle |
|||
|
4 |
Ofenheizung |
|||
|
5 |
Zentralheizung |
|||
|
Moebliert_IS24 |
Ja/Nein oder Optionsfeld, Optionswert |
|||
| ObjektZustand_IS24 | Optionen müssen IS24 entsprechen: | Optionsfeld, Optionswert | ||
|
Wert |
Bezeichnung |
|||
|
0 |
Unbekannt |
|||
|
1 |
Erstbezug |
|||
|
2 |
Neuwertig |
|||
|
3 |
Vollständig renoviert |
|||
|
4 |
renovierungsbedürftig |
|||
|
ParkplKauf_IS24 |
Kaufpreis eines Parkplatzes |
Währung, BIS_NUM |
||
|
Vermietet_IS24 |
Ja/Nein oder Optionfeld |
|||
Für den Transfer wird im lokalen temp. Verzeichnis (bei NT / 2000 benutzerabhängig!) das Unterverzeichnis /TRANSFER angelegt. In dieses Verzeichnis wird die .log-Datei geschrieben und für jede Börse ein eigenes weiteres Unterverzeichnis angelegt (Hier also SCOUTTransfer).
Nach dem die Abfrage, für alle in Frage kommenden Objekte erstellt wurde, werden diese, wie folgend beschrieben, verarbeitet
·
Im Temp/Transfer/ SCOUTTransfer wird die .CSV - Datei angelegt, deren Namen aus Datum (TTMMJJJJ)& Kundennummer generiert wird. Hier werden dann die, u.U. komprimierten, *.Jpg Bilder bereitgestellt 8bilder werden auf max. 64 Kb komprimiert )·
Nach dem alle Daten zusammengestellt sind, werden alle Dateien des Unterverzeichnisses, so wie sie vorliegen, auf den Host bei IS24 übertragen.Nach erfolgreicher Übertragung aller Dateien wird der Status der Objekte und der Zeitpunkt der Übertragung in der Datenbank gespeichert
In der Transfer.log Datei wird folgendes mit protokolliert:
·
Beginn des Aufrufes;·
Beginn der Erstellung der *.csv;·
Angabe über den aktuellen Datensatz-Block·
Auflistung der übernommenen 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 Ende
Ereignis-/Fehlermeldungen
Die Ereignismeldungen werden durch zwei verschieden Ereignisse generiert, die einen werden alle angezeigt und in das Log-file geschrieben:
0 Kein Status
2 Start des Gesamtablaufes
4 Beginne eine CSV zu schreiben, Beginn der Übertragung
6 Fertigstellung mit der CSV
8 Erstellung der CSV abgebrochen oder diese ist leer
10 Beginne eine Datei zu Übertragen
12 Übertragung erfolgreich beendet!
16 Ende des Gesamtablaufes
96 Keine Börse initialisiert
100 Abbruch wegen Fehler oder durch den Benutzer
102 Fehler ist aufgetreten
Die anderen werden auch alle angezeigt, aber die Ereignisse Nr.:
0 - 12 sind die weitergegebenen FTP-Statusmeldungen diese werden nur im Listenfeld des Formulares bei der Übertragung angezeigt!
In das Log-File werden aber eingetragen :
30 Objekt wurde verwendet & Status
31 Objekt wurde nicht verwendet & Begründung
32 Bild wurde für Transfer vorbereitet
mögliche 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)·
Objekt ist gewerblich genutzt à IS24 zeigt z.Zt nur privat genutzte Häuser/Wohnungen·
Fehlender Ansprechpartner à das Feld Ansprechpartner ist nicht erfasst und in den Firmendaten fehlt der Firmenname! Hier wird der Ablauf ganz beendet, und zumindest die Firmendaten sollten ergänzt werden!·
fehlende Straße/Hausnummer·
fehlender PLZ/Ortsangaben·
wurde wegen Objektart für WZ-Kategorie nicht verwendet à dies kann nur bei HomeCompany-Filialen auftreten - einem normalen Objekt wurde z.B. die Objektart Zimmer zugeordnet)·
fehlender Überschrift à weder Headline/ Beschreibung sind erfasst·
fehlender Wohnfläche à es wurde keine Wohnfläche erfasst·
fehlender Grundfläche à zu einem Haus wurde keine Grund(-stücks)fläche erfasst·
wegen Trenner-Überzahl à in einem Feld-Eingabetext befindet sich ein '|'·
alle anderen möglichen Daten/Typenfehler die durch fehlerhafte Daten entstehen können