Projekte per API: anlegen, verknüpfen und in Vorlagen verwenden

Projekte sind in propgen die Klammer um alles, was mehr als eine Immobilie betrifft: ein Bauvorhaben mit seinen Abschnitten, ein Portfolio, eine Vermarktungskampagne, eine Zusammenarbeit, die über Jahre läuft. Seit den Projekt-Hierarchien lassen sie sich beliebig tief verschachteln. Was fehlte: Das alles ging nur in der Oberfläche. Wer ein Projekt aus einem anderen System übernehmen oder automatisch anlegen wollte, musste es von Hand nachbauen.

Projekte über die Schnittstelle

• Anlegen, lesen, ändern, löschen. Projekte sind ein eigener Bereich der Public API geworden, mit eigenen Rechten je API-Schlüssel — Lesen schließt Auflisten nicht automatisch ein, wie im übrigen Schnittstellenmodell.
• Unterprojekte entstehen mit. Ein Projekt kann beim Anlegen sein übergeordnetes Projekt mitbekommen. Damit entsteht die Hierarchie über die Schnittstelle statt nur im Dialog — eine Migration bringt ihre Struktur mit, statt sie hinterher von Hand nachzuziehen.
• Datensätze tragen ihr Projekt. Kontakte, Unternehmen, Termine, Aufgaben, Deals und Notizen lassen sich per API einem oder mehreren Projekten zuordnen. Die Klammer entsteht damit dort, wo die Daten entstehen, und nicht in einer nachgelagerten Aufräumrunde.
• Ersetzen statt ergänzen — bewusst. Beim Schreiben wird die Projektzuordnung eines Datensatzes ersetzt, nicht erweitert. Für Integrationen heißt das: vorhandene Zuordnung lesen, die eigene ergänzen, die vollständige Liste zurückschreiben. Das ist die einzige Stelle, an der zwei gleichzeitig laufende Integrationen einander sonst überschreiben.

Nach Projekt filtern

Notizen und Termine lassen sich nach Projekt filtern. Das klingt klein, ist aber der Unterschied zwischen „irgendwo steht, was besprochen wurde" und einer Liste, die genau das Projekt zeigt: alle Gesprächsnotizen zum Bauabschnitt, alle Termine der Vermarktungsphase, ohne den übrigen Betrieb dazwischen.

• Für Auswertungen. Wer einen Projektbericht baut, holt sich die Notizen und Termine eines Projekts jetzt direkt, statt über die verknüpften Objekte zu gehen und zu hoffen, dass nichts fehlt.
• Für den Alltag. In der Oberfläche ist es derselbe Filter — das Projekt als Sicht auf Aktivitäten, nicht nur als Ordner für Immobilien.

Projektdaten in Vorlagen

Der zweite Teil betrifft alle, die nie eine API anfassen: Projektdaten lassen sich in E-Mails, Textbausteinen und Word-Vorlagen als Platzhalter verwenden. Der Vermarktungsstand an den Bauträger, die Einladung zum Projekttermin, das Anschreiben an alle Interessenten eines Abschnitts — der Projektname und seine Daten kommen aus dem Datensatz, statt in jeder Vorlage als fester Text zu stehen, den irgendwann jemand zu ändern vergisst.

Wofür das gebaut ist

• Bauträgervertrieb. Abschnitte, Einheiten, Interessenten und Termine hängen an einer Struktur, die monatlich berichtet wird — die Zahlen kommen aus den Datensätzen statt aus einer Tabelle daneben (siehe Ein Objekt kann jeder. Das Problem beginnt bei zwölf.).
• Migration und angebundene Systeme. Wer ein Portfolio übernimmt oder eine Website, ein Portal oder ein BI-Werkzeug anbindet, bekommt die Projektebene jetzt mit — statt sie als einzige Struktur von Hand nachzubauen.

Verwandte Releases: Projekte, Projekt-Hierarchien, Objekte per API, Vorlagen per API und Public API. Den Überblick über die Schnittstelle gibt /api-schnittstelle.