custom development with novell teaming

Custom Development with Novell® Teaming

Peter HurleySoftware Engineer ConsultantNovell, [email protected]

© Novell, Inc. All rights reserved.2

Customizing Your Novell® Teaming Site

• Basic customizations– No coding required

• Custom JSPs– Simple modifications using JSPs and JSTL

• Remote applications– Integration with other applications

• Extensions– Extending the teaming code

• Configuration files• Language translations


Basic Customizations (Quick Review)

• Standard out-of-the-box operations– No coding necessary

• Customization options– Branding

– Forms and views

– Landing pages

– Work-flows

– Templates

– Accessories


Branding (Example)


Branding (How to Add Branding)


Branding (How to Set Branding on the Log-in Page)

• If you are willing to show the top workspace to the world...

– Add “guest” as visitor to the top workspace

– Then, add “guest” visitor access to the guest workspace

• If not...

– Add “guest” access to the guest workspace

– Then, add the desired branding to the guest workspace


Branding (Tips)

• Anyone can add branding to their own work-spaces and folders

– Inherited by all work-spaces and folders below it

• You can add graphics and text

• Put company branding on the top workspace

– Sets the branding for the whole site (unless overridden below here)


Branding (Default Starting Page)

• Setting a landing page as the default starting page– Create a landing page (using the top workspace is good)– Make sure everyone has read access to this page

> Add “Guest” as visitor if you want this to be available before logging in

– Create a simple URL for this landing page> Click “Manage/Configure”, then create the simple URL

– Edit the config file: webapps/teaming/WEB-INF/web.xml> Change the “landingPagePath” value to be your simple URL

<context-param>

<param-name>landingPagePath</param-name>

<param-value>/ssf/a/</param-value>

</context-param>


Forms and Views (Example)


Forms and Views (Summary)

• Form and view designer– Create site wide designs– Create designs that are local to a folder or workspace

• Create new entry types– Add new form elements

> Radio buttons> Select boxes> Text

– Entry data is searchable– “Configure” folders to allow the new entry type

Use this to add additional user profile attributes


Additional User Profile Attributes(Areas of Expertise)


Form and View (Extend the User Profile)


Landing Pages (Examples)


Landing Pages (How to Create a Landing Page)


Landing Pages

• Provides a nice introduction to your workspace

• Cleaner layout, easier to understand

• Dynamically updated with the latest information

– Content is pulled from other folders and entries

• Easy to create and manage

– Multiple people feeding information onto the landing page


Work-flows

• Business processes• Content management

• Parallel processing• Filtered data

Orientation

Add User Profile to eDirectory™

Add E-mail Account

Contact Payroll

New Employee

Prepare Office

Turn on Phone

Tasks Completed

Process Completed

FacilitiesHR IT


Accessories (Example)


Accessories (Example)

• Add additional content to work-spaces and folders

– Search results

– Blog and wiki summaries

– Merged calendars

– Task lists

– External web pages (using an iframe)

– Remote applications


Templates

• User workspace configuration

– Default folders and accessories

– Default access controls

• Predefined project work-spaces

– Common layout for each project

– This can be done with Export/Import, too


Templates (Change User Workspace Default)


Templates (Change User Work-space Default)


Custom JSPs

• Custom forms and views

• Custom landing pages

• Custom JSP call-outs

• CSS, colors and images


Custom JSPs in Forms and Views


Custom JSP (W-4 Form - custom_jsps/samples/w4)


Custom JSPs in Forms and Views


Custom JSP on a Landing Page


Custom JSPs on Landing Pages

• webapps/ssf/WEB-INF/jsp/custom_jsps/samples


Custom JSP Call-outs

• Built-in hooks for adding custom code– Head, CSS, sidebar, search results, mobile head– webapps/ssf/WEB-INF/jsp/custom_jsps

ss_call_out_head.jspss_call_out_css_init.jspss_call_out_sidebar_top.jspss_call_out_sidebar_middle.jspss_call_out_sidebar_bottom.jspss_call_out_mobile_head.jspss_call_out_servlet_head.jspss_call_out_find_search_results.jsp


Add a Custom Toolbar Item (Example)

• How to add a new link to the footer toolbarss_call_out_head.jsp


Changing Teaming CSS and Colors

ss_call_out_css_init.jsp


Remote Applications

• Integration of external applications with teaming

– Data from external application is shown on teaming pages

• Multi-level security model

• Runs on a separate server (e.g., PHP)

– Can run under the same Tomcat used by teaming

• Integrated with teaming web services


Remote Application (Example)


Remote Application Security Model

• Administrator controlled– Administrator specifies who can use it– Administrator specifies the maximum set of rights it can use

• Workspace owner selects the remote application(s) to be shown

• Security token created for web services calls– Tokens valid through the current user's login session– Token limited to that user's session– Work-flow tokens valid for one execution of the

remote application


Remote Application Calling Sequence

1. User views a page2. Teaming calls the remote application

HTTP Posta) User Idb) Folder Idc) Application Idd) Security token

3. Remote application calls teaming via web servicesa) Uses security token to login as current userb) Retrieves any desired information from teaming

4. Remote application returns HTML to be displayed


Remote Application Examples

• The Kablink Source Kit has many examples

– http://community.kablink.org/teaming/community

– Follow the link to the source code in SourceForge

– trunk/ssf/samples/remoteapp/...

> Hello World

> Twitter

> Google Wave

> Add Entry

> Task List

http://community.kablink.org/teaming/community


Extensions

• What is an extension?• Managing and packaging an extension• Examples

– New entry types– Landing page extensions– Workflow call-outs– Virus checker

• Kablink sample extensions:– http://community.kablink.org/teaming/extensions

> News Feed (show static HTML pages in a landing page)

> Landing page survey

> Flow Player Video Entry

> Twitter

http://community.kablink.org/teaming/extensions


What Is an Extension?

• A packaged add-on to teaming

– New entry types or work-flows

– New templates

– Work-flow call-out code

• Enabled by the site administrator

• Zone specific

• Cannot be used to “extend” controllers or modules


Managing Extensions

• Go to the “Site Administration” menu• Click on “Manage Extensions”


Extensions Packaging

install.xml


Workflow Call-out Extension

• Post a teaming entry to Twitter– When work-flow state is moved to “Twitter”, a Tweet is posted– The current user is the author of the Tweet– Entry title is sent as the Tweet text– A TinyURL is added that points back to the teaming entry


Twitter Work-flow


Workflow Call-Out Code


Landing Page Extension

• Four new landing page options

– Entry including author, date, description and replies

– Folder including entry author, date, description and replies

– Folder list including entry author and date

– Survey (or a list of surveys)

• Easily customized to display other entry attributes

– e.g., task priority, status and percentage completed

• http://community.kablink.org/teaming/extensions


Landing Page Extension (Example)


Configuration File Customizations

• ssf.properties– Enable/disable RSS– Disallow sending mail to “All Users”– Add/delete folder and workspace icons– Set the default lines per page– Add new mobile devices– Add “edit-in-place” editors– Make export/import available to everyone– Change quota algorithm from “Strict” to “Lenient”– Define new accessories

• Put changes in ssf-ext.properties


ssf-ext.properties(webapps/ssf/WEB-INF/classes/config/ssf-ext.properties)


How to Define a New Accessory

• Define the new accessory – ssf-ext.properties

• Add JSPs – configure and view (custom_jsps/weather)

• Extend the workspace controller if setup needed


Weather Accessory

• Configuration jsp (weather_config.jsp)

• View jsp (weather_view.jsp)– ${ssDashboard.dashboard.components[ssComponentId.data.zip}


Weather Accessory


Security Customizations

• ssf.properties

– Extend the XSS checking algorithms

– Enable/disable Web Services

– Enable/disable remote applications

– Disallow login via the login form


Language Translations

• Modify an existing translation– ssf/WEB-INF/messages/messages-ext_de.properties– navigation.findTeams=Teams finden

• Add a new translation– ssf-ext.properties

> i18n.locale.support=en,da,de,es,fr,hu_HU,it,ja_JP,nl,pl,pt_BR,ru_RU,sv,zh_CN,zh_TW,el

– webapps/WEB-INF/messages/messages_el.properties


What Happens on Upgrades?

• Not overwritten– Custom JSPs in ssf/WEB-INF/jsp/custom_jsps

– Extensions or Remote Applications

– ssf-ext.properties

– zone-ext.cfg.xml

– ssf/messages/message-ext_de.properties

• Overwritten– ssf/css, ssf/images, ssf/js

– New language files(e.g., ssf/messages/messages_el.properties)


Resources

• http://kablink.org or http://community.kablink.org– Teaming Library

> Extensions> Customizations

– Discussion Forum (General Information)

• Novell® Teaming 2.1 Administration Guide– http://www.novell.com/documentation– Documentation includes:

> Enabling custom JSPs to be used on your teaming site> Using remote applications on your teaming site> Adding software extensions to your teaming site

http://kablink.org/

http://community.kablink.org/

http://www.novell.com/documentation

Questions and Answers

Unpublished Work of Novell, Inc. All Rights Reserved.This work is an unpublished work and contains confidential, proprietary, and trade secret information of Novell, Inc. Access to this work is restricted to Novell employees who have a need to know to perform tasks within the scope of their assignments. No part of this work may be practiced, performed, copied, distributed, revised, modified, translated, abridged, condensed, expanded, collected, or adapted without the prior written consent of Novell, Inc. Any use or exploitation of this work without authorization could subject the perpetrator to criminal and civil liability.

General DisclaimerThis document is not to be construed as a promise by any participating company to develop, deliver, or market a product. It is not a commitment to deliver any material, code, or functionality, and should not be relied upon in making purchasing decisions. Novell, Inc. makes no representations or warranties with respect to the contents of this document, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. The development, release, and timing of features or functionality described for Novell products remains at the sole discretion of Novell. Further, Novell, Inc. reserves the right to revise this document and to make changes to its content, at any time, without obligation to notify any person or entity of such revisions or changes. All Novell marks referenced in this presentation are trademarks or registered trademarks of Novell, Inc. in the United States and other countries. All third-party trademarks are the property of their respective owners.

custom development with novell teaming

Documents

teaming site

landing page

landing pages

remote application

landing page

top workspace

custom jsps

guest workspace