Die Schnittstelle wurde auf Flexibilität und Anpassung an verschiedene Empfänger hin entworfen, daher sind die Umsetzung der in Flowfact erfassten Daten, der Umfang der zu übertragenden Daten, Übertragungswege und verschiedene techn. Details konfigurierbar.
Für jedes Zielportal bzw. jeden Empfänger kann unter den 'Grundeinstellungen - Stand.Schnittstellen ein eigener Datensatz angelegt werden und so die Schnittstelle den Anforderungen des Empfängers angepasst werden. Genaueres dazu im Abschnitt (siehe Seite "Konfiguration" in diesem Kapitel).
Die Umsetzung der Daten / Feldarten aus Flowfact in die OpenImmo sind individuell anpassbar, und für jeden Übertragungspartner kann eine eigene Umsetzung verwendet werden. Diese Umsetzung wird über Zuordnungs-XML-Dateien gesteuert. Nur die unter "Nicht anpassbare Elemente". aufgeführten Elemente sind davon ausgenommen bzw. unterliegen einer Sonderbehandlung!
Die OpenImmo wird unter einem festgelegten Namen erstellt, der sich folgendermaßen aufbaut
Bei FTP :
[Bezeichnung des Portals]-[eigene Kundenkennung]-[Zeitstempel (im Format: YYYYMMDDHHMMSS)] (Leerstellen werden durch Unterstrich ersetzt)
Bei HTTPRequest :
Kennung des Objektes (Leerstellen werden durch Unterstrich ersetzt)
Vor der eigentlichen Übertragung werden die Daten im Temp. Verzeichnis (Systemabhängig!) unter 'Transfer/OpenImmo/Börsenbezeichnung' abgelegt und können z.B. mit dem InternetExplorer (sowohl die XML Dateien, als auch die JPG-Bilder) geöffnet werden.
Im Fenster 'Objekte - ...6 (emakeln2)' kann für jedes Objekt einzeln festgelegt werden, an welchen Empfänger es übertragen werden soll, ob es als Kurz- oder Langexpose dargestellt werden soll und ob die Objektadresse freigegeben werden darf (d.h. Anzeige der Strasse und Hausnummer im Internet!).
Bei den Standardschnittstellen ( FFWebserver und OpenImmo) werden Objekte immer dann übertragen wenn eine Häkchen gesetzt ist!
Zur Arbeitserleichterung werden aber, sobald ein Objekt auf inaktiv gesetzt wird, die Häkchen aus der Übertragungsmatrix unter '..6 (emakeln2)' für die Standardschnittstellen entfernt.
Bei der Übertragung ( Fenster 'Objekte übertragen') werden alle Schnittstellen ( FFWebserver und OpenImmo) für die Zugangsdaten (bzw. Benutzername und Passwort) erfasst sind, in einer Checkbox-Liste angezeigt. Beim Öffnen des Fenster sind alle Schnittstellen zur Übertragung ausgewählt, aber Sie haben hier die Möglichkeit, die Übertragung einzeln für jede Schnittstelle ab- bzw. auszuwählen.
Die Einrichtung hängt von den Vorgaben des jeweiligen Empfängers ab. Verwenden Sie zum Anlegen und Ändern einer Schnittstelle den Assistenten!
Der Aufbau einer Xml-Datei ähnelt einer HTML-Datei: In spitzen Klammen (auch 'Tags genannt) befinden sich die einzelnen Elemente (oder auch 'Knoten'). Mit <xxx> öffnet ein Element, </xxx> schließt es ab, Manche der Elemente enthalten nur einfach Daten, hier z.B. <ort> , andere enthalten 'Attribute in denen der Wert abgelegt wird, z.B. <nutzungsart WOHNEN="true" />. Wieder andere dienen nur der Gruppierung wie z.B. <geo>. Diese zeigen in der Ansicht des InternetExplorers einen Bindestrich vor dem Namen und können per Mausklick auf- und zugeklappt werden.
Für den Großteil der angezeigten Daten wird über die jeweilige Zuordnungsdatei festgelegt mit welchen Daten sie gefüllt werden. Die Standard-Zuordnung, die für die RDM-Standardfeldarten gilt, finden Sie unter Auflistung der OpenImmo-Datenelemente und die Standardzuordnung der FlowFact Feldarten.
Im Kopf der OpenImmo werden die Daten aus den Grundeinstellungen übernommen, die Auskunft über die Makler-Firma und die Art der Übertragung geben:
In der Abb. unten z.B. bedeutet art="OFFLINE" das eine FTP Übertragung statt findet und die Daten Offline in die Datenbank eingelesen werden, bei einer Http-Übertragung steht hier: art="ONLINE".
Weiter bedeutet umfang="TEIL" hier, dass ein Daten-Teilabgleich stattfindet (s.o.)
Version und sendersoftware sind interne Daten
Bei anbieter sind folgende Angaben enthalten :
anbieternr : Ihre Kundennummer bei der jeweiligen Immobilenportal (s.o.), so wie Sie es bei der Konfiguration der Schnittstelle unter 'Kundennr' eingetragen haben
firma : enthält den Firmennamen aus den Grundeinstellungen
OpenImmo_anid : enthält Ihre OpenImmo-AnbieterID
Danach folgen die Immobiliendaten. Hier, zum allgemeinen Verständnis, ein Ausschnitt der Ansicht einer OpenImmo im InternetExplorer )
Vorweg: bei allen verwendeten Feldarten kommt auch in dieser Schnittstelle die Hierarchie-Funktionalität in den Daten zum Tragen.
Bei der Umsetzung der Feldarten zu den Elementen muss berücksichtigt werden, um welchen Typ von Elementen es sich handelt.
Einfachster Fall: das Element ist ein einfacher Typ und enthält nur Daten. Hier findet die direkte Umsetzung von Feldart zu Element statt. Beispiele dazu sind die verschiedenen Flächen- oder Preis- Elemente.
Einen Schritt weiter liegen dann die Elemente, die von Typ Boolean (Ja/Nein) sind. Diesen kann direkt eine ja/nein Feldart zugeordnet werden, aber auch das Vorhanden sein der zugeordneten Feldart von einem anderen Datentyp kann als Ja - Wert abgebildet werden, z.B.:
<kran>true</kran> wenn die Feldart 'Kran' mit der Traglast erfasst ist
Die dritte Möglichkeit ein solches Element mit einem True - Wert zu befüllen ist die Abhängigkeit vom vorkommen eines bestimmten Optionswertes des zugeordneten Feldes, z.B.:
<swimmingpool>true</swimmingpool> wenn die entsprechende Option unter den Ausstattungsmerkmalen erfasst ist.
Die komplexer aufgebauten Elemente enthalten entweder ein Attribut das verschiedene Optionswerte annehmen kann, aber nur jeweils einen Wert ( Bsp. land / waehrung / zustand <zustand zustand_art="ERSTBEZUG" wenn die entsprechende Option unter den Ausstattungsmerkmalen erfasst ist.
oder mehrere Attribute, die vom Typ Boolean sind. Dann können alle vorkommen bzw. in beliebiger Kombination Ja/ Nein Werte (true / false) enthalten. Hierbei entsprechen fehlende Attribute einem Nein Wert.
<boden STEIN="true" TEPPICH="true" PARKETT="true" DIELEN="true" KUNSTSTOFF="true"/>
wenn die entsprechenden Ausstattungsmerkmale im Objekt erfasst sind, wie in der Abb. rechts
Alternativ zu den Feldarten können auch die Datenbankfelder der OBJ - Tabelle einzelnen Elemente zu geordnete werden.
Nachfolgende Daten werden nicht über die Zuordnung geschrieben, alle anderen Elemente werden entsprechend der gewählten Zuordnung befüllt (Siehe Auflistung der OpenImmo-Datenelemente und die Standardzuordnung der FlowFact Feldarten. )
'waehrung' da FlowFact intern die Währungsfelder immer auf die Standardwährung umgerechnet abspeichert (wegen der Selektion!), wird hier kein Währungskennzeichen übertragen, da vereinbart ist 'kein Währungskennzeichen = die landesübliche Standardwährung, also 'EUR'
'objektadresse_freigeben' dieses Kennzeichen oder sog. Flag gibt an ob die genauen Adressdaten (Straße und Hausnummer) der Immobilie angezeigt werden dürfen. Der Wert dazu kommt aus der Übertragungsmatrix unter 'emakeln2'
'objektnr_intern' das DSN Feld aus der OBJ - Datenbanktabelle
'objektnr_extern' Kennung des Objektes
'OpenImmo_obid' gleichnamiges Feld aus der OBJ - Datenbanktabelle stand vom Feld TOUCH aus der OBJ - Datenbanktabelle
'kennung_ursprung' immer FLOWFACT
'aktion - aktionart' hier steht entweder 'CHANGE' für jede Änderung gegenüber dem vorherigen Zustand (also sowohl Neu oder Änderung) oder 'DELETE' (löschen), wenn eine Immobilie zuvor 'Online aktiv' war, je nach Übertragungsauftrag:
Bei allen Standartschnittstellen wird dies über die gesetzten / bzw. wieder entfernten Flags (Häkchen) aus der Matrix festgelegt und bei Datenteilabgleich in die Xml Datei geschrieben, bzw. bei einem Vollabgleich wird das Objekt nicht in die XML übernommen.
Bei der Auswahl der mitzuliefernden Bilder, wird wie bei den anderen Schnittstellen, bzw. der automatisch.doc für Exposé Erstellung vorgegangen. Der Aufbau des Dateinamens bestimmt die Auswahl und die Position des Bildes. Hier kommt auch die Hierarchie-Funktionalität in den FlowFact-Daten zum Tragen.
Bei der OpenImmo gibt es verschiedene Gruppen von Bildern, denen Sie Ihre Daten zuordnen können: TITELBILD , BILD , GRUNDRISS, KARTEN_LAGEPLAN.
Die Zuordnung ist folgendermaßen möglich : das Kurzexposébild wird der Gruppe "TITELBILD" zugeordnet, Bilder deren Namen 'grundri' enthalten als "GRUNDRISS" z.B. "_1001-RDMLANG2#Grundriß EG" (Groß/Kleinschreibung spielt dabei keine Rolle), Bilder deren Namen 'lageplan' enthalten als "KARTEN_LAGEPLAN" z.B. "_1001-RDMLANG3#Umgebungslageplan" , alle restlichen einfach der Gruppe Bild.
Wenn in der Übertragungsmatrix 'Lang gewählt wurde, dann werden die Exposétexte verwendet und den folgenden Elementen zugeordnet. Dabei kommt ebenfalls die Hierarchie-Funktionalität in den FlowFact-Daten zum Tragen!.
lage Textfeld Lage
ausstatt_beschr Textfeld Ausstattung
objektbeschreibung Textfeld Beschreibung
sonstige_angaben Textfeld Freier Text
Angaben zur Kontaktadresse sind Pflicht! Daher wird Verschiedenes berücksichtigt.
dem Element name ist die Standardfeldart 'Ansprechpartner' zugeordnet. Der gesamte Inhalt diese Feldes wird in das Element geschrieben und aus den Grundeinstellungen werden folgende Daten übernommen:
E-Mail_zentrale Firmendaten - Telefon
tel_zentrale Firmendaten - Telefon
tel_fax Firmendaten - Fax
strasse Firmendaten - Straße
hausnummer Firmendaten Straße (Hausnummernteil)
plz Firmendaten PLZ
ort Firmendaten Ort
land Land aus den Grundeinstellungen, Registerkarte Allgemein oder wenn leer: Deutschland
Falls kein Ansprechpartner hinterlegt ist, wird in das Element name der Eintrag aus Firmendaten-Name geschrieben.
Der Inhalt der Feldes, das dem Element strasse zugeordnet ist, wird in Strasse und Hausnummer aufgeteilt.
land, plz, ort 
da hier normalerweise die Felder Land_PLZ_Ort mit dem Spezialtyp Land/PLZ verwendet wird, wird diese Feldart alle drei Elementen zugeordnet und entsprechend aufgeteilt (gilt für die Angaben in der Gruppe <geo>, die sich auf das Objekt beziehen).