Objekte entstehen jetzt vollständig über die API
Ein Objekt über die Schnittstelle anzulegen ging schon länger — vollständig wurde es nie: Die Zuordnung einer Einheit zu ihrem Projekt ließ sich nicht setzen, und Bilder mussten von Hand hochgeladen werden. Beides geht jetzt per API. Die Hierarchie wird dabei geprüft statt still verworfen, und hochgeladene Bilder landen in der Medien-Galerie statt in der Dokumentenablage — inklusive Reihenfolge, Titelbild und Grundriss-Kennzeichnung.
- Einheit unter Projekt und Projekt unter Areal lassen sich über die API setzen und wieder lösen
- Ungültige Zuordnungen liefern einen Fehler mit Begründung, statt kommentarlos verworfen zu werden
- Bilder und Grundrisse landen in der Medien-Galerie des Objekts, nicht in der Dokumentenablage
- Reihenfolge bestimmt Titelbild und Position im Exposé; Grundrisse sind als solche markierbar
- Damit läuft die Kette durch: Felder, Objekte, Struktur, Medien, Vorlage, fertiges Dokument
- Besonders relevant für Commercial: Stammobjekte mit vielen Einheiten entstehen ohne Handarbeit
Ein Objekt über die Schnittstelle anzulegen ging schon länger. Vollständig wurde es dabei nie: Die Struktur — welche Einheit zu welchem Projekt gehört — ließ sich nicht setzen, und Bilder mussten von Hand in der Oberfläche hochgeladen werden. Jede automatisierte Anlage endete deshalb in Nacharbeit. Beides geht jetzt über die API.
Die Hierarchie lässt sich schreiben
- Einheit unter Projekt, Projekt unter Areal — die Zuordnung wird beim Anlegen oder nachträglich gesetzt und lässt sich auch wieder lösen. Damit entsteht eine Projektstruktur vollständig über die Schnittstelle, statt zur Hälfte.
- Geprüft statt still verworfen — das übergeordnete Objekt muss existieren und vom passenden Typ sein, und ein Objekt kann nicht sein eigener Vorgänger werden. Wer etwas Unmögliches schickt, bekommt einen Fehler mit Begründung. Vorher verschwand eine ungültige Zuordnung kommentarlos, und die Einheit stand ohne Projekt da.
Bilder und Grundrisse gehören dazu
- Medien statt Dokumente — hochgeladene Bilder landen in der Galerie des Objekts, nicht in der Dokumentenablage. Sie verhalten sich damit genau wie ein Upload aus der Oberfläche, inklusive der erzeugten Größenvarianten.
- Reihenfolge, Titel und Grundriss-Kennzeichnung — die Sortierung bestimmt, welches Bild das Titelbild wird und in welcher Reihenfolge die übrigen im Exposé erscheinen. Grundrisse lassen sich als solche markieren, statt in der Galerie mitzuschwimmen.
Damit schließt sich die Kette
Der eigentliche Gewinn zeigt sich erst im Zusammenspiel. Bisher brach die Automatisierung an zwei Stellen ab — und ein per API erzeugtes Exposé blieb ohne Bilder, weil es keine gab. Jetzt läuft der Weg durch:
Für Gewerbemakler ist vor allem der Strukturteil entscheidend: Ein Stammobjekt mit zwanzig Einheiten von Hand zu verknüpfen ist genau die Arbeit, wegen der Migrationen als Monatsprojekt geplant werden.
Verfügbarkeit
Beides steht ab sofort zur Verfügung, mit Rechten je API-Schlüssel wie im übrigen Schnittstellenmodell. Einen Überblick gibt die Seite Public API.
Verwandte Releases: Formulare per API für die Felder darunter, Briefvorlagen per API für das Dokument darüber, Areale als oberste Ebene und die Public API als Fundament.
Mehr zu allen propgen-Funktionen findest Du im Funktionsüberblick.