{"id":7417,"date":"2021-08-30T16:05:19","date_gmt":"2021-08-30T14:05:19","guid":{"rendered":"https:\/\/u-labs.de\/portal\/?p=7417"},"modified":"2021-08-30T16:05:20","modified_gmt":"2021-08-30T14:05:20","slug":"jsps-in-hcl-connection-anpassen-um-z-b-design-erweiterungen-aenderungen-vorzunehmen","status":"publish","type":"post","link":"https:\/\/u-labs.de\/portal\/jsps-in-hcl-connection-anpassen-um-z-b-design-erweiterungen-aenderungen-vorzunehmen\/","title":{"rendered":"JSPs in HCL Connection anpassen, um z.B. (Design) Erweiterungen\/\u00c4nderungen vorzunehmen"},"content":{"rendered":"

HCL Connections basiert auf Java und nutzt JSP als serverseitige Platform zur Generierung der dynamischen Seiten. Verschiedene JSPs k\u00f6nnen angepasst werden. Es gibt verschiedene Gr\u00fcnde daf\u00fcr, meist geht es um Anpassungen: Beispielsweise l\u00e4sst sich das Navigationsmen\u00fc ver\u00e4ndern oder man kann eigenen CSS\/JavaScript Code einf\u00fcgen. Zwar erm\u00f6glicht dies auch der Customizer, der als Reverse-Proxy vor Connections geschaltet wird. Die JSPs haben dennoch ihre Daseinsberechtigung. Beispielsweise immer dann, wenn serverseitige Logik ben\u00f6tigt wird, die man clientseitig mit JS nicht abbilden kann. Oder auch f\u00fcr den Fall, dass der Customizer nicht installiert ist. Falls nur kleinere Anpassungen vorgenommen werden sollen, sind die JSPs eine Alternative, die ohne Erweiterung der Infrastruktur genutzt werden k\u00f6nnen.<\/p>\n

JSP-\u00c4nderungen funktionieren wie folgt: Es gibt „vanilla“ JSPs f\u00fcr jede Anwendung. Wir k\u00f6nnen diese auf Ebene der Anwendung \u00fcberschreiben, damit eine bestimmte \u00c4nderung z.B. nur in Wikis oder Foren greift. Bestimmte JSPs wie header.jsp<\/strong>, footer.jsp<\/strong> oder login.jsp<\/strong> sind global genutzt und k\u00f6nnen auch global \u00fcberschrieben werden. M\u00f6chte man z.B. im gesamten Connections eine andere Schrift setzen, w\u00e4re die header.jsp<\/strong> Datei daf\u00fcr geeignet.<\/p>\n

Der Basis-Zielordner ist immer ${SHARED_DIRECTORY}\/customization<\/strong>, zum Beispiel \/opt\/IBM\/shared\/customization\/<\/strong>.<\/p>\n

Erstellt mit HCL Connections v7.0.0.0 Build IC7.0_Integration_20210423-1915<\/strong><\/p>\n

\u00dcberschreiben von JSPs einer bestimmten Anwendung<\/h2>\n

Die JSPs finden wir im Pfad \/opt\/IBM\/WebSphere\/AppServer\/profiles\/CnxNode01\/installedApps\/CnxCell\/Wikis.ear\/wikis.web.war\/nav\/templates<\/strong>, wobei CNXNode01\/CnxCell<\/strong> entsprechend der WebSphere Umgebung zu setzen sind. Wikis.ear ist in diesem Beispiel die Anwendung, welche angepasst werden soll. In unserem Customization-Directory kann f\u00fcr jede Anwendung ein Unterordner erstellt werden. Er hei\u00dft wie die Anwendung selbst, jedoch in Kleinbuchstaben. Eine \u00dcbersichtsliste findet man hier in der Dokumentation<\/a>.<\/p>\n

\u00dcberschreiben von globalen JSPs<\/h2>\n

M\u00f6chten wir globale JSPs wie unter anderem z.B. header.jsp oder footer.jsp in der gesamten Connections-Umgebung anpassen, kopieren wir die jeweiligen Ansichten aus einer beliebigen Anwendung. Beispielsweise Wikis. Das Basis-Zielverzeichnis ist ${SHARED_DIRECTORY}\/customization\/common<\/strong>, ab hier gilt die Verzeichnisstruktur der Anwendung. Am besten legen wir den Basispfad zun\u00e4chst an, da er standardm\u00e4\u00dfig nicht existiert:<\/p>\n

mkdir -p \/opt\/IBM\/shared\/customization\/common\/nav\/templates<\/code><\/pre>\n
Nun kopieren wir im Beispiel die header.jsp aus der Wikis-Anwendung<\/p>\n
cp \/opt\/IBM\/WebSphere\/AppServer\/profiles\/CnxNode01\/installedApps\/CnxCell\/Wikis.ear\/wikis.web.war\/nav\/templates\/header.jsp \/opt\/IBM\/shared\/customization\/common\/nav\/templates<\/code><\/pre>\n
Die Zieldatei \/opt\/IBM\/shared\/customization\/comm<\/strong>on\/nav\/templates\/header.jsp kann nun ver\u00e4ndert werden. Zur Demonstration f\u00fcgen wir nach dem letzten schlie\u00dfenden <\/div> Tag eine \u00dcberschrift ein. Diese befindet sich dadurch sp\u00e4ter in der Navigation, aber zum Testen spielt das keine Rolle.<\/p>\n
418 --%><\/div><%--\n\nwird zu\n\n418 --%><\/div><h1>Dies ist eine Anpassung<\/h1><%--<\/code><\/pre>\n
So werden die \u00c4nderungen wirksam<\/h2>\n
Um die \u00c4nderungen wirksam zu machen, muss entweder die jeweilige Anwendung (hier ist das die Homepage) per ISC neu gestartet werden. Oder man setzt die Umgebungsvariable CONNECTIONS_CUSTOMIZATION_DEBUG <\/strong>(siehe unten). Letzteres ist vor allem f\u00fcr das Testen interessant, da man so nicht st\u00e4ndig h\u00e4ndisch neu starten muss.<\/p>\n
Ergebnis:<\/p>\n
\"\"<\/a><\/figure>\n
Bei globalen \u00c4nderungen ist zu beachten, dass diese nur in den Anwendungen greifen, die neu gestartet wurden! Wenn also z.B. Wikis neu gestartet wurde, sind die \u00c4nderungen dort aktiv – in z.B. Blogs, Foren, etc. jedoch nicht. Falls es Probleme gibt, empfehle ich Common ebenfalls neu zu starten bzw. f\u00fcr den Testbetrieb am besten das automatische Neu laden zu aktivieren (siehe folgender Abschnitt).<\/p>\n
JSP-\u00c4nderungen in Echtzeit darstellen, ohne h\u00e4ndische Neustarts<\/h2>\n
Connections besitzt einen Debugmodus, der die JSPs alle paar Sekunden von der Festplatte l\u00e4dt. In der ISC \u00f6ffnen wir die WebSphere-Variablen:<\/p>\n
\"\"<\/a><\/figure>\n
Dort nach CONNECTIONS_CUSTOMIZATION_DEBUG <\/strong>suchen. Steht unten Filtered total: 0<\/strong> muss die Variable wie folgenden gezeigt angelegt werden. Ansonsten gen\u00fcgt es, ihren Wert auf true <\/em>zu \u00e4ndern.<\/p>\n
\"\"<\/a><\/figure>\n
Muss die Variable erstellt werden, ist es erforderlich, zun\u00e4chst oben einen Scope (Cell) auszuw\u00e4hlen. Dann ist es m\u00f6glich, \u00fcber den New<\/strong> Button neue Variablen anzulegen.<\/p>\n
\"\"<\/a><\/figure>\n
Name: CONNECTIONS_CUSTOMIZATION_DEBUG\r\nWert: true<\/p>\n
\"\"<\/a><\/figure>\n
Mit OK <\/strong>und anschlie\u00dfend Save<\/strong> best\u00e4tigen. <\/p>\n
\"\"<\/a><\/figure>\n
Anschlie\u00dfend alle AppsCluster neu starten. Alternativ kann man auch den ganzen Node neu starten, das ist gerade auf Testsystemen oft einfacher:<\/p>\n
cd \/opt\/IBM\/WebSphere\/AppServer\/profiles\/CnxNode01\/bin\/\n.\/stopNode.sh -stopservers -username wasadmin -password cnx\n.\/startNode.sh<\/code><\/pre>\n
Nach dem Neustart werden JSP-\u00c4nderungen automatisch wirksam. Es dauert jedoch ein paar Sekunden, bis diese greifen. Daf\u00fcr spart man sich den h\u00e4ndischen Neustart, der deutlich l\u00e4nger dauert. Gerade wenn mehrere Anwendungen involviert sind, denn ansonsten m\u00fcsste man die alle von Hand stoppen und wieder starten.<\/p>\n","protected":false},"excerpt":{"rendered":"
HCL Connections basiert auf Java und nutzt JSP als serverseitige Platform zur Generierung der dynamischen Seiten. Verschiedene JSPs k\u00f6nnen angepasst werden. Es gibt verschiedene Gr\u00fcnde daf\u00fcr, meist geht es um Anpassungen: Beispielsweise l\u00e4sst sich das Navigationsmen\u00fc ver\u00e4ndern oder man kann eigenen CSS\/JavaScript Code einf\u00fcgen. Zwar erm\u00f6glicht dies auch der Customizer, der als Reverse-Proxy vor Connections …<\/p>\n","protected":false},"author":5,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[765],"tags":[927,926],"class_list":["post-7417","post","type-post","status-publish","format-standard","hentry","category-hcl-connections","tag-anpassen","tag-customization"],"_links":{"self":[{"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/posts\/7417","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/users\/5"}],"replies":[{"embeddable":true,"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/comments?post=7417"}],"version-history":[{"count":2,"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/posts\/7417\/revisions"}],"predecessor-version":[{"id":7426,"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/posts\/7417\/revisions\/7426"}],"wp:attachment":[{"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/media?parent=7417"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/categories?post=7417"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/tags?post=7417"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}