Contao EstateManager

Feldzuordnungen

Zuordnung von Feldern für Immobiliendatensätze

PreviousSynchronisation NextObjektgruppen & -Typen

Last updated 2 years ago

Innerhalb jeder Schnittstelle ist es möglich, jedes Feld einer Import-XML einem bestimmten Feld der im Contao EstateManager existierenden Objektfelder zuzuordnen und zu formatieren.

Die XML-Datei, welche die OpenImmo Felder beinhaltet, kann sich auch innerhalb eines importierten Archivs befinden.

Feldzuordnungen sind notwendig für das Speichern der Informationen von importierten Objekten.

Wenn keine Feldzuordnungen angelegt sind, können Objekte nicht synchronisiert werden!

OpenImmo Feldzuordnungen erstellen

Nach der Erstellung einer neuen Schnittstelle existieren noch keine Zuordnungen für Felder des OpenImmo-Standards.

Durch Felder zurücksetzen kann eine Standardzuordnung erstellt werden.

Neue Feldzuordnung erstellen

Neue Feldzuordnungen können über Neue Feldzuordnung erstellt werden.

Typ

Typ

Hier kann der Datentyp ausgewählt werden, auf den die Feldzuordnung verweisen soll:

Immobilie Bezieht sich auf die Tabelle tl_real_estate und somit auf einen Immobiliendatensatz.
Kontaktperson Bezieht sich auf die Tabelle tl_contact_person und somit auf eine Kontaktperson (Innerhalb der Anbieterverwaltung).

Attribut

Attribute sind Informationen für den ausgewählten Typen, welche in der jeweiligen Datenbank gespeichert werden. Hier kann das Datenbankfeld für die Zuordnung ausgewählt werden.

Feld-Einstellungen

Die Feldeinstellungen dienen dazu, die übertragenen Feldinformationen innerhalb einer Importdatei ermitteln zu können. Mithilfe dieser Einstellungen ist es möglich, verschiedene Importdateien einzulesen, um sie anschließend korrekt in das System zu überführen.

Feldgruppen dienen zur Identifizierung einer Kategorie. Innerhalb einer Feldgruppe können Felder gefunden werden.

Beispielhafte Ausschnitte aus einer Import.xml

Im nachfolgenden Beispiel ist <geo> die OpenImmo-Feldgruppe, die innen liegenden Informationen sind OpenImmo-Felder:

<geo>
    <plz>12345</plz>
    <ort>Musterstadt</ort>
    <strasse>Musterstrasse</strasse>
    <hausnummer>1</hausnummer>
</geo>

Die OpenImmo-Feldgruppe für die Postleitzahl einer Immobilie wäre somit:

geo

Im nachfolgenden Beispiel ist die Information des OpenImmo-Feldes <gueltis_bis> innerhalb von <energiepass>, welches sich wiederum in <zustand_angaben>befindet.

<zustand_angaben>
    <baujahr>1970</baujahr>
    <energiepass>
        <epart>BEDARF</epart>
        <gueltig_bis>01.01.1970</gueltig_bis>
        <endenergiebedarf>34.6</endenergiebedarf>
    </energiepass>
</zustand_angaben>

Der Zugriff auf das OpenImmo-Feld <gueltig_bis> wäre mit folgender Konfiguration der OpenImmo-Feldgruppe gegeben:

zustand_angaben/energiepass

Innerhalb der OpenImmo-Felder befinden sich Werte . Auf diese kann über verschiedene Wege zugegriffen werden:

Beispielhafte Ausschnitte aus einer Import.xml

Im nachfolgenden Beispiel wird der Wert Mustermann innerhalb von <name> ausgelesen.

<kontaktperson>
    <email_zentrale>info@estatemanager.com</email_zentrale>
    <tel_zentrale>02171/4015150</tel_zentrale>
    <name>Mustermann</name>
    <vorname>Max</vorname>
    <anrede>Herr</anrede>
</kontaktperson>

Hierfür ist folgende Konfiguration notwendig:

OpenImmo-Feldgruppe: kontaktperson
OpenImmo-Feld: name

Im nachfolgenden Beispiel wird der Wert 51.06995 des Attributs breitengrad innerhalb von <geokoordinaten> ausgelesen. Auf Attributwerte kann mithilfe von element@attribut zugegriffen werden.

<geo>
    <plz>12345</plz>
    <ort>Musterstadt</ort>
    <geokoordinaten breitengrad="51.06995" laengengrad="6.99735"/>
    <strasse>Musterstr.</strasse>
    <hausnummer>123</hausnummer>
    <land iso_land="DEU"/>
</geo>

Hierfür ist folgende Konfiguration notwendig:

OpenImmo-Feldgruppe: geo
OpenImmo-Feld: geokoordinaten@breitengrad

In manchen Fällen enthält ein Element mehrere Attribute mit Wahrheitswerten (Boolean). Mit folgenden Konfigurationen lassen sich die nachfolgenden Beispiele auslesen:

Beispiel 1 Jedes Objekt enthält nur eine Nutzungsart. In der XML werden jedoch alle Nutzungsarten als Attribute übertragen. Nur eine der Nutzungsarten ist wahr. In diesem Fall soll also der Attributname ausgegeben werden, dessen Attributwert auf true steht. Um auf den einen Attributnamen eines Elements zuzugreifen, der wahr ist, kann attribut@+ verwendet werden.

<objektkategorie>
    <nutzungsart WAZ="false" GEWERBE="false" ANLAGE="false" WOHNEN="true"/>
    <vermarktungsart KAUF="true" LEASING="false" ERBPACHT="false" MIETE_PACHT="false"/>
    <objektart>
        <grundstueck grundst_typ="WOHNEN"/>
    </objektart>
</objektkategorie>

Hierfür ist folgende Konfiguration notwendig:

OpenImmo-Feldgruppe: objektkategorie
OpenImmo-Feld: nutzungsart@+

Der Rückgabewert mit der oben genannten Konfiguration wäre WOHNEN.

Beispiel 2 In diesem Beispiel sind mehrere Attribute innerhalb eines Elements von Wichtigkeit. Es sollen alle Attributnamen ausgelesen werden, in welchen der Wert wahr ist. Um auf alle Attributnamen eines Elements zuzugreifen, die wahr sind, kann attribut@# verwendet werden.

<ausstattung>
    <boden FLIESEN="true" TEPPICH="true" PARKETT="true" LAMINAT="true" MARMOR="true"/>
    <heizungsart ZENTRAL="true"/>
    <befeuerung OEL="true"/>
</ausstattung>

Hierfür ist folgende Konfiguration notwendig:

OpenImmo-Feldgruppe: ausstattung
OpenImmo-Feld: boden@#

Der Rückgabewert mit der oben genannten Konfiguration wäre: FLIESEN TEPPICH PARKETT LAMINAT MARMOR.

Beispiel 3 In diesem Beispiel sollen alle Attribute eines Elements unabhängig des Attributwerts zurückgegeben werden. Um auf alle Attributnamen eines Elements zuzugreifen, unabhängig des Attributwerts, kann attribut@* verwendet werden.

<example>
    <element attribut1 attribut2 attribut3 attribut4/>
</example>

Hierfür ist folgende Konfiguration notwendig:

OpenImmo-Feldgruppe: example
OpenImmo-Feld: element@*

Der Rückgabewert mit der oben genannten Konfiguration wäre: attribut1 attribut2 attribut3 attribut4.

Im nachfolgenden Beispiel wird der Name des Elements buero_praxen innerhalb von <objektart> ausgelesen. Auf den Namen des ersten Elements innerhalb eines Elternelements kann mithilfe von elternelement@[1] zugegriffen werden.

<objektkategorie>
    <objektart>
        <buero_praxen buero_typ="BUEROFLAECHE"/>
    </objektart>
</objektkategorie>

Hierfür ist folgende Konfiguration notwendig:

OpenImmo-Feldgruppe: objektkategorie
OpenImmo-Feld: objektart@[1]

Sollte der Name des zweiten oder dritten Elementes von Bedeutung sein, kann man auch elternelement@[2] oder elternelement@[3] verwenden.

Bedingungsfelder sind ähnlich der OpenImmo-Felder und dienen mithilfe des OpenImmo-Bedingungswertes der Überprüfung von Attributwerten.

Beispielhafter Ausschnitt aus einer Import.xml

Im nachfolgenden Beispiel sind <infrastruktur> und <distanzen> die OpenImmo-Feldgruppe, das Attribut distanz_zu wäre das OpenImmo-Bedingungsfeld. Auf den Attributnamen kann mithilfe von @attributname zugegriffen werden.

<infrastruktur>
    <distanzen distanz_zu="EINKAUFSMOEGLICHKEITEN">0.50</distanzen>
    <distanzen distanz_zu="FLUGHAFEN">25.00</distanzen>
    <distanzen distanz_zu="AUTOBAHN">2.00</distanzen>
    <distanzen distanz_zu="BUS">0.20</distanzen>
</infrastruktur>

Folgende Konfiguration ist für die Verwendung des Attributnamen als Bedingungsfeld von Nöten:

OpenImmo-Feldgruppe: infrastruktur/distanzen
OpenImmo-Feld:
OpenImmo-Bedingungsfeld: @distanz_zu

Ein Bedingungsfeld benötigt immer einen Bedingungswert, welcher überprüft werden muss.

Der Bedingungswert ist der zu überprüfende Attributwert des Attributnamen, welcher im OpenImmo-Bedingungsfeld eingetragen wird. Mithilfe eines Bedingungswertes kann ein Wert innerhalb mehrerer gleichnamiger Elemente ausgelesen werden.

Beispielhafter Ausschnitt aus einer Import.xml

Im nachfolgenden Beispiel sind <infrastruktur> und <distanzen> die OpenImmo-Feldgruppe, das Attribut distanz_zu ist das OpenImmo-Bedingungsfeld. Es soll auf den Wert des Elements <distanzen distanz_zu="FLUGHAFEN">25.00</distanzen> zugegriffen werden. Das Attribut distanz_zu ist das OpenImmo-Bedingungsfeld. Der Wert FLUGHAFEN ist der OpenImmo-Bedingungswert.

<infrastruktur>
    <distanzen distanz_zu="EINKAUFSMOEGLICHKEITEN">0.50</distanzen>
    <distanzen distanz_zu="FLUGHAFEN">25.00</distanzen>
    <distanzen distanz_zu="AUTOBAHN">2.00</distanzen>
    <distanzen distanz_zu="BUS">0.20</distanzen>
</infrastruktur>

Folgende Konfiguration ist für die Überprüfung des Attributwertes von Nöten:

OpenImmo-Feldgruppe: infrastruktur/distanzen
OpenImmo-Feld:
OpenImmo-Bedingungsfeld: @distanz_zu
OpenImmo-Bedingungswert: FLUGHAFEN

Der Rückgabewert mit der oben genannten Konfiguration wäre: 25.00.

Mit dieser Option lassen sich gefundene Werte serialisieren. Anwendung findet diese Option z. B. bei Bildern eines Objektes.

Diese Einstellung ist notwendig für Felder, welche in Contao serialisiert sind und als ein Wert in der Datenbank gespeichert werden. Ein Beispiel für einen serialisierten Wert in Contao wäre das Feld multiSRC.

Beispielhafter Ausschnitt aus einer Import.xml

Im nachfolgenden Beispiel sind:

<anhaenge> und <anhang> die OpenImmo-Feldgruppe
<daten> und <pfad> die OpenImmo-Felder
@gruppe ist das OpenImmo-Bedingungsfeld
BILD ist der zu überprüfende OpenImmo-Bedingungswert

Es sollen alle Werte innerhalb von anhang/daten/pfad ausgegeben werden, in welchem <anhang> das Attribut gruppe und den Attributwert BILD besitzt.

Da es sich um mehrere Werte handelt, welche dem System übergeben werden sollen, kann hier serialisiert werden.

<anhaenge>
    <anhang location="EXTERN" gruppe="TITELBILD">
        <anhangtitel>Immobilie 1</anhangtitel>
        <format>jpg</format>
        <daten>
            <pfad>Foto_1.jpg</pfad>
        </daten>
    </anhang>
    <anhang location="EXTERN" gruppe="BILD">
        <anhangtitel>Bild 1</anhangtitel>
        <format>jpg</format>
        <daten>
            <pfad>Bild_1.jpg</pfad>
        </daten>
    </anhang>
    <anhang location="EXTERN" gruppe="BILD">
        <anhangtitel>Bild 2</anhangtitel>
        <format>jpg</format>
        <daten>
            <pfad>Bild_2.jpg</pfad>
        </daten>
    </anhang>
    <anhang location="EXTERN" gruppe="BILD">
        <anhangtitel>Bild 3</anhangtitel>
        <format>jpg</format>
        <daten>
            <pfad>Bild_3.jpg</pfad>
        </daten>
    </anhang>
    <anhang location="EXTERN" gruppe="BILD">
        <anhangtitel>Bild 4</anhangtitel>
        <format>jpg</format>
        <daten>
            <pfad>Bild_3.jpg</pfad>
        </daten>
    </anhang>
</anhaenge>

Folgende Konfiguration dient der Serialisierung der Werte:

OpenImmo-Feldgruppe: anhaenge/anhang
OpenImmo-Feld: daten/pfad
OpenImmo-Bedingungsfeld: @gruppe
OpenImmo-Bedingungswert: BILD Werte Serialisieren: ✅

Der Rückgabewert mit der oben genannten Konfiguration wäre: {Bild1.jpg, Bild2.jpg, Bild3.jpg, Bild4.jpg}

Wenn importierte Objekte trotz nicht-existenter Informationen in der Import.xml einen Standardwert erhalten sollen, kann hier bei Aktivierung der Checkbox, ein gewünschter Standardwert eingetragen werden.

Formatierung

Durch Formatierungen können die eingelesenen Werte vor der Speicherung in die Datenbank in eine gewünschte Form umgewandelt werden.

Hier kann ausgewählt werden, welche Formatierung angewendet werden soll. Folgende Optionen stehen zur Verfügung:

Keine
Zahl
Datum
Text
Boolescher Wert

Zahl (Formatierung)

Kürzt eine Zahl anhand der übergebenen Dezimalstellen.

Beispiel: Anzahl an Dezimalstellen: 2 Aus 5000 wird 50.00

Nutzt die Funktion number_format()

Datum (Formatierung)

Wandelt ein übertragenes Datum in einen Timestamp um. Optional kann ein Datumsformat angegeben werden.

Beispiel: Aus 1990-03-21 wird 638006400

Nutzt die Funktion strtotime()

Text (Formatierung)

Mithilfe der Text-Formatierung können gefundene Strings formatiert werden. Folgende Auswahlmöglichkeiten stehen zur Verfügung:

Keine
Kleinschreibung
Großschreibung
Erstes Zeichen groß
Sonderzeichen ersetzen

Setzt einen String in Kleinbuchstaben um.

Beispiel: Aus GEWERBE wird gewerbe

Nutzt die Funktion strtolower()

Wandelt alle Zeichen eines Strings in Großbuchstaben um.

Beispiel: Aus beispiel wird BEISPIEL

Nutzt die Funktion strtoupper()

Verwandelt das erste Zeichen eines Strings in einen Großbuchstaben.

Beispiel: Aus beispiel wird Beispiel

Nutzt die Funktion ucfirst()

Trimmen (Textformatierung)

Entfernt Zwischenraumzeichen (oder andere Zeichen) am Anfang und Ende eines Strings.

Nutzt die Funktion trim()

Boolescher Wert (Formatierung)

Wandelt übertragene Werte in boolsche Werte um (0 und 1). Kann mithilfe von Vergleichswert auch zur Überprüfung von vorgegebenen Werten genutzt werden.

Experten-Einstellungen

Hier kann angegeben werden, ob eine Datei bei einer Feldzuordnung gespeichert werden soll. Diese Option ist nötig, um übertragene Dateien für ein Objekt zu speichern.

Sollte sich im Immobilien-Import eine Datei mit dem angegebenen Wert befinden, wird diese Datei im Ordner der Immobilie gespeichert.