AdminCamp 14: Make your IBM Connections deployment your own - Customize it!

Notes & Domino –> Mobil, Web und als RichClient AdminCamp 2014

Make Your IBM ConnecDons Deployment Your Own -‐ Customize It!

Klaus Bild – WebGate ConsulDng AG Christoph StöQner -‐ Fritz & Macziol GmbH


Über uns

Klaus Bild Senior System Architect WebGate ConsulDng AG IBM Notes / Domino seit

LearningSpace 2003 IBM ConnecDons seit Beta1

Christoph Stö2ner IBM SoXware Consultant Fritz & Macziol GmbH IBM Notes / Domino seit 1999 IBM ConnecDons seit 2010 Ich mag: Linux, ScripDng Sprecher auf:


Über diesen Vortrag

hQp://www.slideshare.net/kbild/show301-‐make-‐your-‐ibm-‐connecDons-‐deployment-‐your-‐own-‐customize-‐it


Agenda

•  Einleitung •  Benutzeroberfläche •  Login Seite •  BenachrichDgungen •  Gebng Started Seite •  CommuniDes •  Wikis •  Profile •  Richtext Editor


Agenda (falls es die Zeit erlaubt)

•  Mobile ApplikaDon •  Desktop Plugin


Einleitung – Wer ist hier im Publikum?


Einleitung – Ziel der Session?

Dieser Vortrag soll Ihnen die Grundlage vermiQeln, um

Anpassungen Ihrer Umgebung zu planen und in Angriff zu

nehmen.


Einleitung – Die Systemumgebung

•  MicrosoX Windows Server 2008 R2 •  IBM ConnecDons 5 (IBM Domino LDAP, single box InstallaDon) •  CONNECTIONS_CUSTOMIZATION_DEBUG akDviert •  Profile templateReloading in profiles-‐config.xml auf 15s

eingestellt •  Login Daten gespeichert in soap.client.properDes

•  -‐> BiQe debug & reloading Einstellungen für die ProdukDon IMMER deakDvieren!


Einleitung – Bemerkungen

•  Folgende Abkürzungen werden verwendet: •  custom_dir: CustomizaDon Verzeichnis, kann in der WebSphere

Variable CONNECTIONS_CUSTOMIZATION_PATH gefunden werden (Hier D:\IBM\data\shared\customizaDon\ )

•  provision_dir: Provision Verzeichnis, kann in der WebSphere Variable CONNECTIONS_PROVISION_PATH gefunden werden (Hier D:\IBM\data\shared\provision\)

•  profiles_dir: WebSphere profiles Verzeichnis (Hier D:\IBM\WebSphere\AppServer\profiles)

•  htdocs: HTTP Server htdocs Verzeichnis (Hier D:\IBM\HTTPServer\htdocs)


Benutzeroberfläche -‐ Einleitung

•  In diesem Teil werden wir: •  Das Logo und Farben anpassen •  Ein neues Menu und einen permanenten Link hinzufügen


Benutzeroberfläche -‐ Beispiel


Benutzeroberfläche -‐ How to – Farben und Logo

•  IBM ConnecDons 5 nutzt das NextGen Theme standardmässig •  Leider ist die DokumentaDon dazu im Knowledge Center noch

nicht vollständig respekDve am falschen Ort (Community Theme) abgelegt

•  Alle CSS Änderungen für das NextGen Theme müssen im folgenden Ordner abgelegt werden: custom_dir\themes\gen4Theme\



•  Öffnen der WAS AdministraDve Console und navigieren zu “ApplicaDons – WebSphere enterprise applicaDons”

•  Stoppen der Common App



•  Erstellen des Ordners gen4Theme im Order custom_dir\themes\

•  Im Ordner gen4Theme die Datei custom.css erstellen



•  Relevantes CSS-‐Format zB. Mit Firebug herausfinden



•  Öffnen von custom.css mit einem Text Editor •  Einfügen des kopierten css Tags aus Firebug •  Ersetzen des Farbgradienten #3c404 -‐ #151718 durch #00b2ef -‐

#00649d



•  Verbergen des IBM Logos und hinzufügen eines neuen Logos über folgende CSS tags



•  Erstellen eines images Orders in custom_dir\themes\gen4Theme\ und kopieren des Logos ibmconnect.png in diesen neuen Order




•  Starten der Common App


Benutzeroberfläche -‐ Exkurs

Wem das stoppen und starten über die WAS AdministraDve Console zu mühsam ist benutzt folgendes Python Script: AdminControl.invoke('WebSphere:name=ApplicaDonManager,process=WAS_SERVERNAME,plaxorm=proxy,node=NODE_NAME,version=8.5.5.1,type=ApplicaDonManager,mbeanIdenDfier=ApplicaDonManager,cell=CELL_NAME,spec=1.0', 'stopApplicaDon', '[Common]', '[java.lang.String]') AdminControl.invoke('WebSphere:name=ApplicaDonManager,process=WAS_SERVERNAME,plaxorm=proxy,node=NODE_NAME,version=8.5.5.1,type=ApplicaDonManager,mbeanIdenDfier=ApplicaDonManager,cell=CELL_NAME,spec=1.0', 'startApplicaDon', '[Common]', '[java.lang.String]')

In unserem Beispiel: AdminControl.invoke('WebSphere:name=ApplicaDonManager,process=InfraCluster_server1,plaxorm=proxy,node=connecJonsNode01,version=8.5.5.1,type=ApplicaDonManager,mbeanIdenDfier=ApplicaDonManager,cell=connecJonsCell01,spec=1.0', 'stopApplicaDon', '[Common]', '[java.lang.String]') AdminControl.invoke('WebSphere:name=ApplicaDonManager,process=InfraCluster_server1,plaxorm=proxy,node=connecJonsNode01,version=8.5.5.1,type=ApplicaDonManager,mbeanIdenDfier=ApplicaDonManager,cell=connecJonsCell01,spec=1.0', 'startApplicaDon', '[Common]', '[java.lang.String]')


Benutzeroberfläche – Resultat – Farben und Logo

•  Refresh des Browsers


Benutzeroberfläche -‐ How to – Neues Menu und Link

•  Kopieren von header.jsp vom Ordner profiles_dir\AppSrv01\installedApps\connectionsCell01\Homepage.ear\homepage.war\nav\templates nach custom_dir\common\nav\templates



•  Öffnen von header.jsp mit einem Text Editor •  Verändern/Hinzufügen von einigen Zeilen am Ende der Datei



•  Kopieren des referenzierten Bildes question.png in den Ordner htdocs\images



•  Erstellen eines Orders mit dem Namen menu und erstellen der referenzierten jsp Datei ibmconnect14.jsp


Benutzeroberfläche – Resultat – Neues Menu und Link



Benutzeroberfläche – Ressourcen

•  Customizing the user interface hQp://www-‐01.ibm.com/support/knowledgecenter/SSYGQH_5.0.0/admin/customize/t_admin_common_customize_main.dita

•  Customizing the navigaDon bar

hQp://www-‐01.ibm.com/support/knowledgecenter/SSYGQH_5.0.0/admin/customize/t_admin_navbar_create_files.dita?lang=en


Login Seite – Einleitung

•  In diesem Teil werden wir: •  Einen ZusDmmungstext der Login Seite hinzufügen


Login Seite – Beispiel


Login Seite – How to – login.jsp

•  Die Datei login.jsp muss angepasst werden, um die Loginseite zu verändern. Zuerst wird die Datei aus dem Ordner profiles_dir/AppSrv01/installedApps/connectionsCell01/Blogs.ear/blogs.war/nav/templates/login.jsp in den Ordner custom_dir\common\nav\templates kopiert

•  Folgender Text in login.jsp wird ersetzt



•  Mit folgendem Text, welcher einen ZusDmmungstext hinzufügt und einen BuQon



•  Nun muss der Login BuQon deakDviert werden und eine ID assoziiert werden, damit wir in unserem Javascript darauf referenzieren können. Folgenden Code anpassen

•  Damit er so aussieht



•  Nun muss ein kleines Javascript hinzugefügt werden, welches kontrolliert, ob dem Text zugesDmmt wird und dann den BuQon akDviert

•  Dazu folgendes Javascript zum Script Teil der Datei hinzufügen


Login Seite – How to – Hinzufügen von property Datei(en)

•  Im letzten SchriQ müssen noch die property Dateien erstellt werden, welche den Text der angezeigt werden soll beinhalten. Dazu muss eine neue Datei zum Ordner custom_dir\strings hinzugefügt werden

•  Die Datei muss folgenden Namen haben: com.ibm.lconn.core.strings.templates.properties

•  Es können weitere Sprachen unterstützt werden, zB. muss com.ibm.lconn.core.strings.templates_de.properties für Deutsch erstellt werden


Login Seite – How to

•  Nun die Common und Homepage App stoppen und starten, am besten über das Python Script


Login Seite – Resultat



Login Seite – Ressourcen

•  Customizing IBM Lotus ConnecDons 3.0 hQp://public.dhe.ibm.com/soXware/dw/lotus/LC30CustomizeFinal.pdf

•  Customizing the login page hQp://www-‐01.ibm.com/support/knowledgecenter/SSYGQH_5.0.0/admin/customize/t_admin_common_customize_login_screen.dita


BenachrichDgungen – Einleitung

•  In diesem Teil werden wir: •  Den Standard Text von Mail BenachrichDgungen anpassen •  Den globalen Absender anpassen •  Die Standard Intervalle des Versendens anpassen •  Das Logo und Farben anpassen


BenachrichDgungen – Beispiel

Angepasster Sender

Angepasster Texte

Angepasste Farben und Logo


BenachrichDgungen – Beispiel

Alle wöchentlichen Newsle2er werden auf

täglich geändert


BenachrichDgungen – How to – Anpassen des Textes

•  Öffnen von notification(_de).properties im \resources\nls\ Ordner

•  Achtung, wir arbeiten hier direkt auf Original Dateien im Ordner D:\IBM\WebSphere\AppServer\profiles\Dmgr01\config\cells

\connectionsCell01\LotusConnections-config\notifications, biQe Originale vorher sichern



•  Anpassen des Textes IBM Connec9ons zu IBM Connect 14 •  Gleiche Anpassung für jegliche Sprache, welche man auch

verwenden will



•  Zurück zum notifications Ordner und nun öffnen von notification(_de).properties in \news\resources\nls\

•  Ändern von allen IBM Connec9ons Textstellen auf IBM Connect 14


BenachrichDgungen – How to – Logo und Farben

•  Zurück zum notifications Ordner und nun öffnen von style.ftl in \news\aggregated\

•  Ändern von allen Farbwerten •  auf #025d9c



•  Ändern des referenzierten footer Bildes von ibmLogoWhite23.png auf ibmconnect.png



•  Zurück zum notifications Ordner und kopieren von ibmconnect.png nach resources\images


BenachrichDgungen – How to – Standard Einstellungen

•  Starten des wsadmin Clients und ausführen von connectionsConfig.py

•  Auschecken von notification-config.xml LCConfigService.checkOutNo9fica9onConfig('D:/temp','connec9onsCell01')



•  Öffnen von notification-config.xml in D:\temp •  Ändern der Werte für Sender und mobile Links



•  Ändern aller defaultFollowFrequency="WEEKLY” auf defaultFollowFrequency=”DAILY”



•  Schliessen der Datei und einchecken LCConfigService.checkInNo9fica9onConfig()

•  Ausführen von newsAdmin.py



•  Ausführen des folgenden Befehls um die Standard Einstellungen für Benachrichtungen neu zu laden: NewsEmailDigestService.refreshDefaultEmailPrefsFromConfig()



•  Öffnen der WAS AdministraDve Console und navigieren zu “System administraDon – Nodes”

•  Node auswählen und auf „Full Resynchronize“ klicken, dadurch werden alle Änderungen auf dem Dmgr auf die Nodes verteilt




•  Stoppen und starten der News App


BenachrichDgungen – Resultat

•  Testen der neuen Einstellungen über das klicken auf “Standardwerte wiederherstellen”


BenachrichDgungen – Resultat – Logo und Farben

•  Man kann das Versenden von BenachrichDgungen durch das aufrufen folgendes Links auslösen (nur Admins erhalten BenachrichDgung) hQp://connecDons.demo.ch/news/web/testEmailDigestSendMail.acDon?type=daily

•  Für alle Benutzer hQp://connecDons.demo.ch/news/web/testEmailDigestSendMail.acDon?type=daily&initNextTranche=true


BenachrichDgungen – Resultat – Logo und Farben

•  Testen der NewsleQer im Mailclient oder auf dem Handy


BenachrichDgungen – Ressourcen

•  Customizing noDficaDons hQp://www-‐01.ibm.com/support/knowledgecenter/api/content/SSYGQH_5.0.0/admin/customize/c_customize_noDficaDons.html

•  Including mobile links in noDficaDons hQp://www-‐01.ibm.com/support/knowledgecenter/SSYGQH_5.0.0/admin/admin/t_admin_noDficaDons_include_mobile_links.dita

•  Sebng the default frequency of email digests hQp://www-‐01.ibm.com/support/knowledgecenter/SSYGQH_5.0.0/admin/admin/t_admin_common_specify_default_noDficaDon_frequency.dita

•  Verifying email digests hQp://www-‐01.ibm.com/support/knowledgecenter/SSYGQH_5.0.0/admin/troubleshoot/ts_t_trigger_email_noDficaDons.dita


Gebng Started Seite – Einleitung

•  In diesem Teil werden wir: •  Der Gebng Started Page einen weiteren Reiter hinzufügen


Gebng Started Seite – Beispiel


Gebng Started Seite – How to

•  Um der Gebng started page einen weiteren Reiter hinzuzufügen muss der wsadmin Client gestartet und homepageAdmin.py ausgeführt werden

•  Auschecken der gettingstarted-config.xml über HomepageCellConfig.checkOutGecngstartedConfig('D:/temp','connec9onsCell01’)



•  Folgendes muss der gebngstarted-‐config.xml Datei hinzugefügt werden

•  Jeglicher Inhalt muss auf dem gleichen Host abgelegt werden (hQp://connecDons.demo.ch). Am einfachsten nutzt man den IBM HQp server dazu



•  Um den Text des Reiters zu definieren muss eine ProperDes Datei zum Ordner custom_dir\strings hinzugefügt werden

•  Folgender Namen muss für die Datei verwendet werden und der Text des Reiters hinzugefügt werden: com.ibm.lconn.homepage.resources.nls.jsp.jsp_resources.properties

•  Auch hier können weitere Sprach ProperDes hinzugefügt werden



•  Schliessen der Datei und danach einchecken: HomepageCellConfig.checkInGecngstartedConfig()



•  Nun ausführen von connectionsConfig.py und folgende Befehl absetzen, um den Versionsstempel von ConnecDons anzupassen, damit die neuen Einstellungen im Browser geladen werden: LCConfigService.checkOutConfig('D:/temp','connec9onsCell01’) LCConfigService.updateConfig(“versionStamp”,””) LCConfigService.checkInConfig()




•  Stoppen und starten der Homepage App


Gebng Started Seite – Resultat



Gebng Started Seite – Ressourcen

•  Customizing the Gebng Started view hQp://www-‐01.ibm.com/support/knowledgecenter/SSYGQH_5.0.0/admin/customize/t_customize_gebng_started_page.dita


CommuniDes – Einleitung

•  In diesem Teil werden wir: •  Zwei zusätzliche Community Themes erstellen •  BeschriXung für diese neuen Themes definieren •  Die Themes hinzufügen •  Zwei simple Widgets erstellen •  Diese Widgets den CommuniDes hinzufügen


CommuniDes – Beispiel


CommuniDes – How to – Theme

•  ConnecDons 5 nutzt das NextGen Theme, dieses Theme muss darum auch als Vorlage für das Erstellen der Community Themes verwendet werden

•  Navigieren zum Ordner profiles_dir\AppSrv01\installedApps\connectionsCell01\Common.ear\connections.web.resources.war\WEB-INF\eclipse\plugins

•  Öffnen der Datei com.ibm.social.gen4.theme_4.0.0.20140708-0135.jar mit einem ZIP Program und navigieren nach resources\css\defaultTheme\

•  Kopieren der Datei defaultTheme.css



•  defaultTheme.css als Template verwenden für ein neues Theme css (nameTheme.css) im Verzeichnis custom_dir\themes\nameTheme\ -‐> Erstellen der Verzeichnisse webgateTheme und fumTheme und anlegen der Dateien webgateTheme.css sowie fumTheme.css in diesen Verzeichnissen



•  Öffnen der css Dateien (webgateTheme.css, fumTheme.css) •  Alle relaDven Pfade umwandeln in absolute Pfade

../../sprite/sprite16.png -‐ > /com.ibm.social.gen4.theme/sprite/sprite16.png

•  Anpassen der Farbegradienten in den Theme css Dateien (WebGate, FUM)



•  Auch hier verbergen des IBM Logos und hinzufügen eines neuen Logos über folgende CSS tags

•  Erstellen eines images Orders in custom_dir\themes\nameTheme\ und kopieren der Logos webgate.png/fum.png in diese neuen Order



•  Starten des wsadmin Clients und ausführen von communitiesAdmin.py

•  Auschecken von communities-config.xml Communi9esConfigService.checkOutConfig('D:/temp','connec9onsCell01')



•  Öffnen von communities-config.xml im Verzeichnis D:\temp •  Hinzufügen der neuen Themes (BeschriXung und Vorschaubilder

werden in den nächsten SchriQen hinzugefügt)



•  Einchecken von communities-config.xml Communi9esConfigService.checkInConfig()



•  Hinzufügen der Datei com.ibm.lconn.communities.strings.ui.properties zum custom_dir\strings Verzeichnis, sowie das Hinzufügen der BeschriXungen zu dieser Datei



•  Kopieren der Theme Vorschaubilder ins Verzeichnis custom_dir\communities\images



•  Öffnen der WAS AdministraDve Console und navigieren nach „ApplicaDons – WebSphere enterprise applicaDons“

•  Stoppen und starten der CommuniDes App


CommuniDes – Resultat – Theme

•  Öffnen einer Community und ändern des Theme in eines der zwei neuen Themes


CommuniDes – Beispiel – Widgets


CommuniDes – How to – Widgets

•  Wir werden zwei sehr simple Widgets der CommuniDes ApplikaDon hinzufügen. Eins davon ist ein iFrame Widget welches klickbare Bilder besitzt, welche uns durch die Community navigieren lassen. Das zweite Widget zeigt uns den Displayname und die Email Adresse des eingeloggten Benutzers an.

•  Die bereits erstellten Widgets werden in den Ordner für Community Anpassungen custom_dir\communities kopiert



•  Testen, ob der Widget descriptor im Browser geöffnet werden kann



•  Nun werden die Widgets zu unseren ConnecDons CommuniDes hinzugefügt, starten des wsadmin Clients und ausführen von communitiesAdmin.py

•  Auschecken von widgets-config.xml Communi9esConfigService.checkOutWidgetsConfig('D:/temp','connec9onsCell01')



•  Öffnen von widgets-config.xml in D:\temp •  Hinzufügen der neuenWidget definiDons

•  Einchecken von widgets-config.xml Communi9esConfigService.checkInWidgetsConfig()

Das bewirkt, dass das Widget in der miQleren Spalte einer Community angezeigt wird



•  Öffnen der WAS AdministraDve Console und navigieren nach „ApplicaDons – WebSphere enterprise applicaDons“

•  Stoppen und starten der CommuniDes App


CommuniDes – Resultat – Widgets

•  Öffnen einer Community und klick auf “Community AcDons – Add Apps”

•  Die neuen Widgets selekDeren und hinzufügen


CommuniDes – Ressourcen

•  Adding a custom theme to CommuniDes hQp://www-‐01.ibm.com/support/knowledgecenter/SSYGQH_5.0.0/admin/customize/c_admin_communiDes_create_custom_theme.dita

•  Branding CommuniDes in IBM ConnecDons (Jerald Mahurin)

hQp://www.sociallycurious.com/2013/05/21/branding-‐communiDes-‐ibm-‐connecDons

•  Enabling custom widgets for CommuniDes hQp://www-‐01.ibm.com/support/knowledgecenter/SSYGQH_5.0.0/admin/admin/t_admin_communiDes_develop_custom_widgets.dita


Wikis – Einleitung

•  In diesem Teil werden wir: •  Die Standard Willkommensseite von Wikis anpassen


Wikis – Beispiel


Wikis – How to – Willkommensseite

•  Erstellen eines neuen Wikis und dann klick auf edit •  Ändern der Willkommens Seite in die gewünschte Form, wir

werden dann diese Seite als Vorlage für unsere Anpassung verwenden

•  Wechseln in die „HTML Source“ Ansicht und kopieren des HTML code



•  Einfügen des HTML code in eine Textdatei und enxernen aller “end of lines” (EOL)



•  Erstellen der Datei com.ibm.lconn.share.services.handlers.wiki.nls.WikiWelcomeMessages_en.properties im Verzeichnis custom_dir\strings\ und hinzufügen des Titels einer neuen Seite sowie des HTML code (Eine Zeile!)

•  Erstellen einer Property Datei für jede Sprache, welche genutzt werden soll



•  Öffnen der WAS AdministraDve Console und navigieren nach “ApplicaDons – WebSphere enterprise applicaDons”

•  Stoppen und starten der Wikis App


Wikis – Resultat – Willkommensseite

•  Erstellen eines neuen Wikis


Wikis – Ressourcen

•  Customizing the Wikis welcome page hQp://www-‐01.ibm.com/support/knowledgecenter/SSYGQH_5.0.0/admin/admin/t_customize_wikis_welcome_page.dita


Profile – Agenda

•  Profil Felder hinzufügen •  Synchronisieren der neuen Profilfelder über TDI •  Profil Widget hinzufügen •  Profil Typ erstellen


Profile – Einleitung – Neue Felder

•  In diesem Teil werden wir: •  Profil Felder hinzufügen •  BeschriXungen erstellen •  Makros für das Layout erstellen •  Freemarker Vorlagen anpassen, damit die neuen Felder angezeigt werden


Profile – Beispiel – Neue Felder


Profile – How to – Neue Felder

•  Starten des wsadmin Clients und ausführen von profilesAdmin.py •  Auschecken von profiles-config.xml

ProfilesConfigService.checkOutConfig('D:/temp','connec9onsCell01')

•  Die neuen Felder müssen in der Datei profiles-‐config.xml erstellt werden, dazu wird die Datei mit einem Texteditor geöffnet



•  Folgende AQribute werden zum Profildatenmodell hinzugefügt



•  Nun müssen die neuen Felder mit einem Profiltyp verbunden werden

•  Dazu muss die Datei profiles-‐types.xml ediDert werden und wir fügen die neuen Felder dem default profile hinzu



•  Einchecken von profiles-config.xml ProfilesConfigService.checkInConfig()



•  Nun müssen die BeschriXungen hinzugefügt werden •  Dazu wird ein Ressourcen Bundle

com.connect.profiles.strings.uilabels.properties in dem Ordner custom_dir\strings erstellt

•  Erstellen einer Property Datei für jede Sprache, welche genutzt werden soll



•  Das neue Ressource Bundle muss nun registriert und für die Freemarker Vorlagen zugänglich gemacht werden

•  Für die Registrierung muss die ConnecDons KonfiguraDon ausgechecked werden. Ausführen von connectionsConfig.py und dann auschecken von LotusConnections-config.xml LCConfigService.checkOutConfig('D:/temp','connec9onsCell01')

•  Folgendes der Ressourcen SekDon in LotusConnections-config.xml hinzufügen



•  Einchecken von LotusConnections-config.xml LCConfigService.checkInConfig()

•  Auschecken von profiles-config.xml ProfilesConfigService.checkOutConfig('D:/temp','connec9onsCell01’)



•  EdiDeren von der Datei profiles-‐config.xml und hinzufügen der Referenz zum neu registrierten Bundle



•  Nun müssen einige Makros hinzugefügt werden, welche uns Listen oder Auswahlfelder im Profil ermöglichen. AnstaQ diese der Datei commonUtil.ftl hinzuzufügen (Standarddatei von ConnecDons) erstellen wir eine neue FTL Datei. Dies ermöglicht uns später ein einfacheres Upgraden oder Anpassen der Umgebung

•  Erstellen der Datei customControls.ftl in profiles_dir\Dmgr01\config\cells\connectionsCell01\LotusConnections-config\profiles\templates

•  Die Datei enthält Makros für Radio BuQons, MulDselect BuQons und Drop-‐down Listen. Ein Teil der Datei sieht man auf folgendem Slide.



•  Um die Möglichkeit zu haben das eigene Profil anzupassen muss zuerst die Datei profileEdit.Xl file in D:\temp angepasst werden

•  Die neuen Makros müssen dort imporDert werden

•  Des weiteren die Datei so anpassen, dass die neuen Felder angezeigt und die neuen Makros verwendet werden



•  Auch die Datei profileDetails.Xl in D:\temp muss angepasst werden, damit die neuen Felder mit Inhalt im non-‐edit mode auch angezeigt werden



•  Einchecken von profiles-config.xml und Synchronisieren aller nodes (dies kopiert customControls.ftl auf alle nodes). BEMERKUNG: Das template reloading wurde bereits auf 15 Sekunden eingestellt ProfilesConfigService.checkInConfig() synchAllNodes()


Profile – Einleitung – SynchronisaDon

•  In diesem Teil werden wir: •  Synchronisieren der neuen Profilfelder mit dem LDAP Server unter

Benutzung des TDI


Profile – How to – SynchronisaDon

•  Synchronisieren des neuen Feldes twiQer Id vom LDAP Server zur Profildatenbank mit TDI

•  Dazu muss folgendes hinzugefügt werden zur Datei tdi-profiles-config.xml in D:\IBM\TDI\V7_1_1\tdisol\TDI\conf\LotusConnections-config



•  Die Daten sind im Feld “twiQerid” auf dem LDAP Server

•  Ausführen des Sync Scripts



•  Öffnen der WAS AdministraDve Console und navigieren nach “ApplicaDons – WebSphere enterprise applicaDons”

•  Stoppen und starten der Profiles App


Profile – Resultat – SynchronisaDon

•  Öffnen des Profils und testen der neuen Felder


Profile – Einleitung – Widget

•  In diesem Teil werden wir ein neues Google Widget dem Profil hinzufügen: •  Erstellen des Widgets •  Hinzufügen des Widgets


Profile – Beispiel – Widget

Anzeige der Büroadresse in Google Maps


Profile – How to – Widget

•  Erstellen des Widgets im Verzeichnis custom_dir\profiles mit Namen googleMap.xml



hQp://kbild.ch/2014/02/google-‐maps-‐widget-‐ibm-‐connecDons-‐profiles/



•  Nun wird das Widget zu unseren ConnecDons Profilen hinzugefügt, dafür muss der wsadmin Client gestartet werden und profilesAdmin.py ausgeführt werden

•  Auschecken von widgets-config.xml ProfilesConfigService.checkOutWidgetConfig('D:/temp','connec9onsCell01')



•  Öffnen der Datei widgets-config.xml im Verzeichnis D:\temp •  Hinzufügen des neuen Widgets



•  Einchecken von widgets-config.xml ProfilesConfigService.checkInWidgetConfig()




•  Stoppen und starten der Profiles App (evtl. Profiles Temp löschen)


Profile – Resultat – Widget

•  Öffnen eines Profiles und testen des Widgets


Profile – Einleitung – Profile Types

•  In diesem Teil werden wir ein einen zweiten Profiltyp hinzufügen. Dieser Profil Typ wird nur über ein Sub Set der Profil AQribute verfügen. Auch werden wir einige Widgets für diesen Profil Typ deakDvieren

•  Was sind Profil Typen •  DefiniDon von verschiedenen Benutzergruppen •  Lassen und Look&Feel der Profil ApplikaDon anpassen •  Beispiele: Kunde, Angestellter, Contractor

•  Warum soll man verschiedene Profil Typen nutzen •  Anzeige von verschiedenen InformaDonen zu Benutzergruppen •  Blocken von einigen FunkDonen •  Blocken von Widgets •  Phasen Rollout


Profile – Beispiel – Profile Types


Profile – How to – Profile Types

•  Erst muss entschieden werden, anhand von welchem Feld im LDAP der Profil Typ besDmmt wird. In diesem Beispiel werden wir ein bereits vorhandenes Feld verwenden.

•  Nun muss TDI so konfiguriert werden, dass der Profil Typ zur Profile Datenbank hinzugefügt wird. Dazu muss die Datei map_dbrepos_from_source.properties im TDI SoluDon Ordner angepasst werden und der Wert profileType dem Feld im LDAP zugewiesen werden



•  Starten des TDI Sync Befehls

•  Folgendes sieht man nun in der Employee Datenbank



•  Starten des wsadmin Clients und ausführen von profilesAdmin.py •  Auschecken von profiles-config.xml

ProfilesConfigService.checkOutConfig('D:/temp','connec9onsCell01’)



•  Der Profil Typ und die dazugehörigen Profil Felder müssen in der Datei profiles-types.xml definiert werden



•  Nun können wir abhängig vom Profil Typ die Profil FunkDonen oder Widgets deakDvieren. Wir beginnen mit den FunkDonen

•  Öffnen der Datei profiles-policy.xml und hinzufügen der gewünschten KonfiguraDon



•  Einchecken der Profil KonfiguraDon ProfilesConfigService.checkInConfig()



•  Einloggen mit einem externen Benutzer

Tagging möglich



•  Einloggen mit internen Benutzer und öffnen das Profil eines Externen

Kein InvitaJon Bu2on

Tagging nicht möglich

FunkJonen deakJviert



•  Nun werden Widgets anhand des Profil Typ deakDviert •  Auschecken der Widget KonfiguraDon

•  DeakDvieren aller Widgets welche nicht angezeigt werden sollen in der Datei widgets-config.xml



•  Einchecken der Widget KonfiguraDon und Neustart der Profil ApplikaDon


Profile – Resultat – Profile Types

Tags vollständig enTernt

Tabs enTernt

Widgets enTernt


Profile – Ressourcen

•  Adding custom widgets to Profiles hQp://www-‐01.ibm.com/support/knowledgecenter/SSYGQH_5.0.0/admin/admin/c_admin_profiles_add_custom_widgets.dita

•  Customizing IBM ConnecDons – Modifying the Report-‐To Chain iWidget to include profile data retrieved via Ajax (Hunter Medney) hQps://www.ibm.com/developerworks/community/blogs/hmedney/entry/customizing_connecDons_modifying_the_report_to_chain_widget_using_profile_data

•  ConnecDons iWidget Development Guide hQp://www-‐10.lotus.com/ldd/lcwiki.nsf/dx/development-‐guide

•  Easy as a pie – CreaDng Widgets for IBM ConnecDons (Mikkel Heisterberg) hQp://www.slideshare.net/lekkim/bp207-‐easy-‐as-‐pie-‐creaDng-‐widgets-‐for-‐ibm-‐connecDons

•  Customizing IBM ConnecDons 4.0 Profiles hQp://www-‐10.lotus.com/ldd/lcwiki.nsf/dx/Customizing_IBM_ConnecDons_4.0_Profiles


Profile – Ressourcen

•  Customizing Profiles hQp://www-‐01.ibm.com/support/knowledgecenter/SSYGQH_5.0.0/admin/customize/c_admin_profiles_customizing.dita

•  Phasing an IBM ConnecDons Rollout? Profile Types May Be the Answer hQps://www-‐304.ibm.com/connecDons/blogs/socialbusiness/entry/phasing_an_ibm_connecDons_rollout_profile_types_may_be_the_answer4

•  Profile types and locking profile features hQp://www.slideshare.net/palmke/profile-‐types-‐and-‐locking-‐profile-‐features-‐15498931

•  How to Create a Perfect Profile: A Hitchiker’s Guide to A Smarter Workforce hQp://www.slideshare.net/curiousmitch/show304


Richtext Editor– Einleitung

•  In diesem Teil werden wir: •  Ein neues Plugin erstellen •  Das Plugin dem Richtext Editor hinzufügen


Richtext Editor – Beispiel


Richtext Editor – How to

•  Grundlagen für die Erweiterungen des RTE ist, wie man ein CKEditor Plugin erstellt hQp://docs.cksource.com/CKEditor_3.x/Tutorials

•  Erstellen eines Business Card plugins

hQp://kbild.ch/2014/02/business-‐card-‐funcDon-‐ibm-‐connecDons-‐richtext-‐editor/



•  Kopieren des Plugins ins Verzeichnis custom_dir\javascript\com\ibm\oneui\ckeditor\editor\plugins\



•  Öffnen von provision_dir\webresources\com.ibm.lconn.blogs.web.resources_*.jar mit einem Zip Programm und extrahieren der Datei ckeditor.js, welche im Verzeichnis \resources liegt



•  Kopieren der Datei ckeditor.js ins Verzeichnis custom_dir\javascript\lconn\blogs\ (oder wikis)



•  Öffnen der Datei ckeditor.js und hinzufügen des neuen Plugins




•  Stoppen und starten der Common App


Richtext Editor – Resultat

•  Refresh des Browsers Cache •  Erstellen eines neuen Blogbeitrags und testen des Plugins


Richtext Editor – Ressourcen

•  CKEditor Tutorials hQp://docs.cksource.com/CKEditor_3.x/Tutorials

•  Tutorial – Extending the IBM ConnecDons Rich Text Editor (Rob

Novak) hQp://ibmrockstar.com/2013/05/tutorial-‐extending-‐the-‐ibm-‐connecDons-‐rich-‐text-‐editor


Zweiter Teil (falls Zeit bleibt)

•  Mobile App •  Desktop Plugin


Mobile App – Beispiel


Mobile App – How to -‐ Vorbereitung

•  Folgende Bilder werden benöDgt (Bsp. Öffnen von SameDme und öffnen eines Links) •  iOS ReDna (48 x 48px) •  iOS Standard (24 x 24px) •  Low density für Android / BlackBerry (~24 x 24px) •  Medium density für Android / BlackBerry (~32 x 32px) •  High density für Android / BlackBerry (~48 x 48px)

Beispiele für die Bilder können unter profiles_dir\AppSrv01\installedApps\connectionsCell01\Mobile.ear

\mobile.web.war\extensibilityIcons

gefunden werden


Mobile App – How to

•  Kopieren der Bilder nach custom_dir\mobile\



•  Nun werden die neuen FunkDonen der Mobile App hinzugefügt, dazu muss der wsadmin Client gestartet und mobileAdmin.py ausgeführt werden

•  Auschecken von mobile-config.xml MobileConfigService.checkOutConfig('D:/temp','connec9onsCell01')



•  Öffnen von mobile-config.xml und hinzufügen folgender <ApplicaDons> SekDonen



•  Einchecken von mobile-config.xml MobileConfigService.checkInConfig()




•  Stoppen und starten der Mobile App


Mobile App – Resultat


Desktop Plugin – Beispiel


Desktop Plugin – How to

•  Folgende Bilder werden benöDgt: •  Desktop Image (256 x 256 .ico file) •  SystemTray busy image (16x16 .ico file) •  SystemTray idle image (16x16 .ico file) •  SystemTray pending image (16x16 .ico file) •  Context Menu image (13x13 .bmp file) •  Office Send To image (32x32.bmp file) •  Outlook Business card image (16x16.bmp file)



•  EdiDeren der Registry (zB. automaDsiert über Group Policies) •  Achtung: Je nach Windows Version (32-‐bit od.64-‐bit) werden

andere Registry Keys definiert •  Ändern / Hinzufügen von folgenden Registry Keys

•  HKEY_CLASSES_ROOT\CLSID\{21034BDC-‐B57E-‐400B-‐A5D5-‐2B1E98502805} •  (Default)=“Connect 2014” •  InfoTip=“Connect 2014”

•  HKEY_CLASSES_ROOT\CLSID\{21034BDC-‐B57E-‐400B-‐A5D5-‐2B1E98502805}\DefaultIcon

•  (Default)=“c:\rebrand-‐256x256.ico”



•  HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\IBM\Social Connectors\Branding •  Main Title=“Connect 2014”

•  HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\IBM\Social Connectors\Branding\Monitor •  SystemTray Busy Image=“c:\rebrand-‐16x16busy.ico” •  SystemTray PendingImage=“c:\rebrand-‐16x16pending.ico” •  SystemTray Idle Image=“c:\rebrand-‐16x16idle.ico” •  SystemTray Title=“Connect 2014”

•  HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\IBM\Social Connectors\Branding\Office •  Backstage SendTo Image=“c:\rebrand-‐32x32.bmp” •  BackStage SendTo Tiltle=“Connect 2014” •  RibbonTab Title=“Connect 2014”



•  HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\IBM\Social Connectors\Branding\Outlook •  ContextMenu ContactCard Image=“c:\rebrand-‐16x16.bmp” •  Explorer RibbonTab Title=“Connect 2014” •  Inspector RibbonTab Title=“Connect 2014” •  Menu Title=“Connect 2014” •  Toolbar Title=“Connect 2014” •  ContextMenu ContactCard Title=“Connect 2014”

•  HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\IBM\Social Connectors\Branding\ShellExt •  ContextMenu Image=“c:\rebrand-‐13x13.bmp” •  ContextMenu Title=“Connect 2014”


Desktop Plugin – Ressourcen

•  Customizing the branding strings and images for the desktop plug-‐in hQp://www-‐01.ibm.com/support/knowledgecenter/SSYGQH_5.0.0/connectors/admin/r_files_windows_ms_custom_branding.dita


Danke

Klaus Bild TwiQer: @kbild Mail: [email protected] Blog: www.kbild.ch Skype: kbuilder slideshare.net/kbild xing.com/profile/Klaus_Bild

Christoph Stö2ner TwiQer: @stoeps Mail: [email protected] Blog: www.stoeps.de Skype: christophstoeQner slideshare.net/ChristophStoeQner xing.com/profile/Christoph_StoeQner hQp://about.me/stoeps

AdminCamp 14: Make your IBM Connections deployment your own - Customize it!

Presentations & Public Speaking

Transcript of AdminCamp 14: Make your IBM Connections deployment your own - Customize it!