Schnittstellen
Version 26 39.5.25 39.5.23 39.5.22 39.5.21 39.5.20 39.5.19 39.5.18 39.5.17 German English
Version 26 39.5.25 39.5.23 39.5.22 39.5.21 39.5.20 39.5.19 39.5.18 39.5.17 German English

PLANTA project und Outlook

Voraussetzungen

Folgende Voraussetzungen gelten für die Integration von PLANTA project mit Outlook-Kalender:

  • PLANTA project muss installiert sein 

  • Outlook muss installiert sein

  • PLANTA link muss lizenziert sein

Einstellungen

Folgende Einstellungen sind für die Integration von PLANTA project mit Outlook notwendig:

  • Web-Schnittstellen müssen eingeschaltet sein: In der web.conf muss der Parameter generic_service = true (Default = Deaktiviert) sein.

  • Die Web-Schnittstelle 01ba49c1-5476-0e4c-bd4c-b7775a961aa6 "iCalendar Termine" muss Aktiv sein (Default = Aktiviert).

  • Damit Outlook den Kalender abrufen kann, muss in der web.conf die Authentifizierung deaktiviert werden apikey_auth_filter_generic = false (Default = Aktiviert).

Standard-Web-Schnittstelle "iCalendar Termine"

  • Die Schnittstelle wird über GET abgerufen.

  • Sie holt gefiltert die Termine der Ressource aus der Datenbank.

  • Sie konvertiert diese Termine in das iCalendar-Format.

  • Sie gibt den Kalender an den Client.

Schnittstelle anpassen

Um die Schnittstelle anzupassen, sind folgende Schritte zu befolgen:

  • Neue Web-Schnittstellen-Implementationsklasse anlegen, die von CalendarFeed erbt.

  • Die CalendarFeed-Klasse hat zwei Attribute, die regeln, wie der Kalender aufgebaut wird:

    • ASSIGNMENT_CLS zeigt auf eine Klasse, die aus einem Termin (Vorgangsname, Kalk. Anfang, Kalk. Ende) einen VEVENT-Eintrag machen kann.

    • CALENDAR_CLS zeigt auf eine Klasse, die eine Liste von ASSIGNMENT_CLS-Instanzen bekommt und daraus einen VCALENDAR generiert.

  • Von diesen Klassen kann man ebenfalls Subklassen erstellen, die das Verhalten modifizieren und die entsprechenden Referenzen in der neuen CalendarFeed-Subklasse setzen.

  • Dann muss nur noch die GET Implementation der Web-Schnittstelle "iCalendar Termine" ausgetauscht werden, was vom Konfliktmanagement-Verfahren erkannt und automatisch nach Update wieder übernommen wird.

Meilenstein-Schnittstelle für M365-Integration

  • Die Schnittstelle liefert Meilensteine und Mastermeilensteine für mehrere Projekte in einem einzelnen Request und wird von der PLANTA M365-Integration für die Outlook-Kalender-Synchronisierung verwendet.

    • Berücksichtigt werden (Master-)Meilensteine aus aktiven, nicht gesperrten Projekten ohne Ist-Ende, deren Vorgänge ebenfalls nicht gesperrt sind und kein Ist-Ende haben.

  • Für jeden Meilenstein wird ein HTML-Body mit Projektname, PM-Status, Terminen und einem Link Open in PLANTA generiert.

  • Die webclient_url muss in den globalen Einstellungen konfiguriert sein (alpha120 mit python_id = 'webclient_url').