Schnittstellen-Assistent

Bei der Einrichtung und Konfiguration einer OpenImmo-Schnittstelle steht Ihnen der FLOWFACT Assistent zur Verfügung. Um den Assistenten zu starten, klicken Sie im Menü Hilfe ? auf den Eintrag Schnittstellen-Assistent.

Bitte beachten Sie die folgenden Links, die Ihnen weitere wertvolle Informationen zum Thema zur Verfügung stellen:

Die untenstehende Abbildung zeigt die Hauptseite des Einrichtungsassistenten, die Ihnen zur Konfiguration einer neuen OpenImmo-Schnittstelle zur Verfügung steht:

Wichtige Hinweise

Immobilien Scout 24:

Vor der ersten Übertragung
muss von IS24 der FTP Zugang freigeschaltet werden! Richten Sie dazu eine entsprechende E-Mail, unter Angabe Ihrer ImmobilienScout24-Kundennummer, an Support@ImmobilienScout24.de . Falls Sie eine andere Hostadresse von IS24 erhalten haben, verwenden Sie diese auch weiterhin.
Vorsicht!
Nur die Daten, die Sie mit FLOWFACT übertragen, sind dann bei IS24. Wenn Sie bereits Objekte manuell eingegeben hatten, werden diese überschrieben! Daher sollten Sie genau überlegen, ob Sie den Voll- oder Teilabgleich aktivieren. Wir empfehlen den Teilabgleich (nur geänderte Daten übertragen muss aktiv sein).
Pdf-Dateien an Scout übertragen:
Es können insgesamt nur 15 Dateien (zehn) an IS24 übermittelt werden! Wenn Sie z.B. 14 Bilder online stellen, kann nur noch ein PDF übertragen werden! Um mehrere PDF's senden zu können, muss die Feldart "Dokumentanhang" mittels der Taste "Einf." (einfügen) verdoppelt werden.

Beschreibung der Elemente

Bezeichnung

Eine Bezeichnung des empfangenden Portals, zugleich erster Teil des OpenImmo Dateinamens, daher muss er den Vorgaben des Empfängers entsprechen, falls diese bestehen.

Hostadresse

Geben Sie hier die Adresse (auch 'url') ein, an die Datei gesendet werden soll (sowohl bei FTP & HTTPRequest).

Kundennr

Die Kundennummer, anhand der Empfänger Sie in seinem System identifiziert. Evtl. lautete die Bezeichnung anders (z.B. BestandshalterId, KundenID, Kundennummer, etc.). Zweiter Teil des OpenImmo Dateinamen bei FTP Übertragungen. Diese wird Ihnen normalerweise bei Abschluss eines Vertrages zugeteilt. Diese Kennung kann, je nach Vorgabe des Empfängers, mit dem Login identisch sein.

Je nach Empfänger bekommen Sie ein individuelles Login und Passwort oder Sie tragen die vorgegebenen allgemeinen Zugangsdaten ein. Diese Daten sind hauptsächlich bei FTP Übertragungen notwendig und können bei HTTP auch leer bleiben.

Passwort

siehe Login

FTP-Übertragung

Hier wird der vom Empfänger vorgegebene Übertragungsweg festgelegt. Das gesetzte Flag (das Häkchen) bedeutet, dass die Daten an den Empfänger der Schnittstelle per FTP übertragen werden sollen. Damit zusammenhängend werden beim FTP die Immobiliendaten alle in eine einzige XML-Datei geschrieben und die Bilder werden als eigene Dateien mitgesendet

nur geänderte Daten...

Mit diesem Parameter wird der vom Empfänger vorgegebene Umfang der Daten festgelegt. Ein gesetzter Haken bedeutet, dass nur die Objektdaten übertragen werden, die nach der letzten Übertragung geändert wurden, ansonsten wird der gesamte, für diesen Empfänger ausgewählte Datenbestand, übertragen (nur bei FTP möglich).

Zuordnung

Hier werden die Xml Dateien aus dem FLOWFACT Unterverzeichnis SYSTEM/XML aufgelistet. Mit dieser Datei wird die Umsetzung der in FLOWFACT erfassten Objektdaten für die OpenImmo gesteuert und ist für jede Schnittstelle individuell auswählbar.

ZipArchiv für Übertragung

Dieses Flag wird nur in Verbindung mit einer FTP Übertragung berücksichtigt. Die erstellte xml und die JPG Bilder Dateien werden in ein Zip-Archiv gepackt und nur diese Datei wird per FTP übertragen. Der Name des Zip-Archives entspricht dem der XML Datei.

OpenImmo Präfix verwenden

Hier handelt es sich um eine Xml spezifische Einstellung für den sog. 'namespace’, bei der jedem Elementnamen ein 'imo:’ vorangestellt wird. Diese Einstellung muss den Vorgaben des Empfängers entsprechen, da ansonsten u.U. die Datei nicht verarbeitet werden kann.

HTTP-Übertragung (nur bis FLOWFACT 2012 unterstützt)

Mit diesem Flag wird festgelegt, dass die Daten per HTTPRequest übertragen werden. Bei diesem Übertragungsmodus wird für jede Immobilie eine eigene Datei erstellt und Bilder werden direkt in der XML als base64codierter Text abgelegt.

Antwort für Objektstatus verwenden

Dieses Flag wird nur bei HTTP berücksichtigt. Mit dieser Einstellung wird eine Antwort des Empfängers über den Importerfolg erwartet, und nur wenn die Antwort 'OK' war, wird das Übertragungsdatum und der Status des Objektes für diese Schnittstelle aktualisiert.

Hinweis: Ab Performer CRM 2014 ist die Übertragung mittels HTTP abgekündigt. Es können nach Update auf Performer CRM 2014 keine neuen HTTP-Schnittstellen mehr eingerichtet und keine Änderungen an bestehenden HTTP-Schnittstellen vorgenommen werden. Dennoch funktioniert die Übertragung zu bereits eingerichteten HTTP-Schnittstellen. Sollte die Übertragung auf FTP umgestellt werden, so wird empfohlen die der HTTP-Schnittstelle zugeordneten Immobilien zunächst global vom Portal zu entfernen, dann die Schnittstelle neu als FTP-Schnittstelle einzurichten und die Immobilien dorthin erneut zu übertragen. Die bisherige HTTP-Schnittstelle kann dann dauerhaft gelöscht werden.