T E C H N I S C H E D O K U M E N T A T I O N Update auf Intrexx 8

Transkript

1 T E C H N I S C H E D O K U M E N T A T I O N Update auf Intrexx 8 INTREXX 8.0

2 1. Vorwort Herzlich Willkommen zum Update Ihrer Intrexx Version auf die Version 8.0! Neben der Umsetzung sehr vieler Feature-Requests, die uns erreicht haben, können wir Ihnen natürlich auch wieder eine Vielzahl von Innovationen bieten. Weitere Informationen zu den neuen Funktionen erhalten Sie unter oder direkt in der Onlinehilfe von Intrexx 8.0. Manfred Stetz CTO, United Planet GmbH 2. Updatevorbereitungen Anlässlich natürlicher versionsbedingter Änderungen, neuer Features und Kontrollen sowie einer Vielzahl an Optimierungen hatten Entwicklung und Qualitätssicherung von United Planet ein besonderes Augenmerk auf die Sicherstellung eines reibungslosen und komfortablen Umstiegs auf die neue Version. 3. API In umfangreichen Testreihen wurden verschiedenste Updateszenarien simuliert und erfolgreich durchgeführt. Weiterhin gab es einen sehr breit angelegten Betatest, an dem nicht nur unsere Partner, sondern auch zahlreiche Kunden teilgenommen haben. Alle daraus gewonnenen Erfahrungen sind in dieses Dokument eingeflossen, das Sie nun bei Ihrem Update unterstützen soll. Wichtig: Vor dem Update sollten Sie in jedem Fall ein Backup der Datenbank und des Dateisystems durchführen! Deaktivieren Sie darüber hinaus für die Dauer des Updatevorgangs eventuell vorhandene Virenscanner. Beachten Sie, dass ein Portalexport alleine kein ausreichendes Backup darstellt. Sollte das Update aus unvorhergesehenen Gründen (z.b. wegen notwendiger Anpassungen an Java-Klassen, die Sie für spezielle Anforderungen von Ihrem Partner oder einem Software-Zulieferer erhalten haben) nicht erfolgreich sein, können Sie so unproblematisch zu der vorherigen Version zurückkehren. Bitte führen Sie das Update im ersten Schritt auf einem Testsystem aus und nicht direkt innerhalb der Produktivumgebung. Achten Sie bei einem Update darauf, dass Sie während der Installation das korrekte Verzeichnis der bereits bestehenden Intrexx-Installation auswählen. Sollten Sie eine Neuinstallation wünschen, sind bereits bestehende Installationen von Intrexx im Voraus zu entfernen. Testen Sie im Anschluss an einen erfolgreichen Updatevorgang Ihr Portal auf eine korrekte Funktionsweise. Der Deprecated-Modus in DbQuery, der im Mai 2009 für Intrexx 5 eingeführt wurde, um die Kompatibilität zu früheren Versionen sicherzustellen, wurde entfernt. def l_rs = l_stmt.executequery() while (l_rs.next()) l_rs.getstringvalue(1).value(int) -> getstringvalue(int), getintvalue(int),....preparedeprecated(...) -> prepare(...) Die Methode preparedeprecated kann in der Regel durch die Methode prepare ersetzt werden. Diese kann sich unter Umständen aber bei der Rückgabe von Boolean-Werten etwas anders verhalten. UNITED PLANET - INTREXX 8 - TECHNISCHE DOKUMENTATION - UPDATE AUF INTREXX 8 2

3 Die alten Deprecated-Methoden von IFileValueHolder wurden entfernt und müssen wie folgt ersetzt werden: getcontenttype ersetzen mit getfirstfile().getcontenttype() getpath() ersetzen mit getfirstfile().getpath() getfilename() ersetzen mit getfirstfile().getfilename() 4. SQL-Server-Einstellungen Um evtl. sporadische Deadlocks zu vermeiden, sollten im Rahmen des Updates evtl. vorhandene Portal-Datenbanken unter Microsoft SQL Server auf den snapshot-basierten Read- Committed-Modus umgestellt werden, sofern dies nicht durch das Update selbst schon erfolgt ist. Weitere Informationen zu diesem Thema finden Sie in unserer Knowledgebase unter help.unitedplanet.com im Beitrag Nr MSSQL Datenbank Anpassung SET READ_COMMITTED_SNAPSHOT ON; 5. IMAP-Ereignisquellen Bisher war es bei der Konfiguration von IMAP-Ereignisquellen für STARTTLS notwendig, das Property mail.imap.starttls.enable=true zu setzen. Zukünftig wird das Property beim Setzen des Häkchens serverseitig automatisch gesetzt, falls es nicht schon vorhanden ist (true oder false). Zusätzlich wird im Falle des automatischen Setzens das Property mail.imap.starttls.required=true gesetzt, falls es nicht schon (true oder false) vorhanden ist. Dadurch soll ein Rückfall auf eine nicht gesicherte Verbindung verhindert werden, falls STARTTLS erwünscht ist. In seltenen Fällen kann dies nach dem Update auf Intrexx 8 zu Problemen führen. Durch manuelles Setzen von mail.imap.starttls.enable und mail.imap.starttls.required kann das voreingestellte Verhalten beliebig übersteuert werden. 6. Allgemein (WEB) Zugriff via JS VTL auf Formular-Informationen: die Verknüpfung eine Eingabefeldes zu einem Formular wird ab Intrexx 8 über das HTML(5)-Attribut form realisiert. Für den Microsoft Internet Explorer werden entsprechende Polyfills zur Verfügung gestellt. Ein generisch zur Intrexxseite hinzugefügtes input-element wird beim Posten der Seite nicht mehr automatisch eingesammelt und weitergereicht. Im Folgenden wird beschrieben, wie die Form eines Elements ermittelt werden kann Javascript getformobjectbyelement(html-element) Liefert das UP-Objekt der umschließenden Form: var inp = document.createelement("input"); inp.setattribute("form", getformobjectbyelement(html-element).id) UNITED PLANET - INTREXX 8 - TECHNISCHE DOKUMENTATION - UPDATE AUF INTREXX 8 3

4 6.2. Velocity #writecurrentformid() Liefert die ID der umschließenden Form. <input name="test" value="test" form="#writecurrentformid()"/> $AppWalker wurde deprecated. Code, der diesen verwendet, sollte angepasst werden. Weitere Informationen zu diesem Thema finden Sie unter y/server/appservice/applicationwalker.html. 7. Apache Solr Die Umstellung auf Apache Solr führt beim Update zur Neuindexierung von Daten. Dies kann einige Zeit in Anspruch nehmen. Die Neuindexierung erfolgt auch nach jedem Portalimport, da die Indexdaten nicht mehr im Portalexport enthalten sind. 8. Office Integration Die aktuelle Office Integration ist aufgrund erhöhter Sicherheitsmaßnahmen noch nicht mit Intrexx 8 kompatibel. Die Aktualisierung wird mit einem kommenden Online Update erfolgen. UNITED PLANET - INTREXX 8 - TECHNISCHE DOKUMENTATION - UPDATE AUF INTREXX 8 4

5 2016 United Planet. All rights reserved. Intrexx and United Planet are registered trademarks of United Planet, Freiburg - Germany. Alle im Text erwähnten Hersteller, Produkte und Dienstleistungen sind Marken oder eingetragene Marken der jeweiligen Unternehmen in Deutschland und anderen Ländern weltweit.