![Legal disclaimer Please delete all instructions (text in red) and insert this information at the end ofexternal publications. © IBM Corporation 2008. All Rights Reserved. The information contained in this publication is provided for informational purposes only. While efforts were made to verify the completeness and accuracy of the information contained in this publication, it is provided AS IS without warranty of any kind, express or implied. In addition, this information is based on IBM’s current product plans and strategy, which are subject to change by IBM without notice. IBM shall not be responsible for any damages arising out of the use of, or otherwise related to, this publication or any other materials. Nothing contained in this publication is intended to, nor shall have the effect of, creating any warranties or representations from IBM or its suppliers or licensors, or altering the terms and conditions of the applicable license agreement governing the use of IBM software. References in this presentation to IBM products, programs, or services do not imply that they will be available in all countries in which IBM operates. Product release dates and/or capabilities referenced in this presentation may change at any time at IBM’s sole discretion based on market opportunities or other factors, and are not intended to be a commitment to future product or feature availability in any way. Nothing contained in these materials is intended to, nor shall have the effect of, stating or implying that any activities undertaken by you will result in any specific sales, revenue growth or other results. If the text contains performance statistics or references to benchmarks, insert the following language; otherwise delete: Performance is based on measurements and projections using standard IBM benchmarks in a controlled environment. The actual throughput or performance that any user will experience will vary depending upon many factors, including considerations such as the amount of multiprogramming in the user's job stream, the I/O configuration, the storage configuration, and the workload processed. Therefore, no assurance can be given that an individual user will achieve results similar to those stated here. If the text includes any customer examples, please confirm we have prior written approval from such customer and insert the following language; otherwise delete: All customer examples described are presented as illustrations of how those customers have used IBM products and the results they may have achieved. Actual environmental costs and performance characteristics may vary by customer. Please review text for proper trademark attribution of IBM products. At first use, each product name must be the full name and include appropriate trademark symbols (e.g., IBM Lotus® Sametime® Unyte™). Subsequent references can drop “IBM” but should include the proper branding (e.g., Lotus Sametime Gateway, or WebSphere Application Server). Please refer to http://www.ibm.com/legal/copytrade.shtml for guidance on which trademarks require the ® or ™ symbol. Do not use abbreviations for IBM product names in your presentation. All product names must be used as adjectives rather than nouns. Please list all of the trademarks that you use in your presentation as follows; delete any not included in your presentation. IBM, the IBM logo, Lotus, Lotus Notes, Notes, Domino, Quickr, Sametime, WebSphere, UC2, PartnerWorld and Lotusphere are trademarks of International Business Machines Corporation in the United States, other countries, or both. Unyte is a trademark of WebDialogs, Inc., in the United States, other countries, or both. If you reference Adobe® in the text, please mark the first use and include the following; otherwise delete: Adobe, the Adobe logo, PostScript, and the PostScript logo are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States, and/or other countries. If you reference Java™ in the text, please mark the first use and include the following; otherwise delete: Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both. If you reference Microsoft® and/or Windows® in the text, please mark the first use and include the following, as applicable; otherwise delete: Microsoft and Windows are trademarks of Microsoft Corporation in the United States, other countries, or both. If you reference Intel® and/or any of the following Intel products in the text, please mark the first use and include those that you use as follows; otherwise delete: Intel, Intel Centrino, Celeron, Intel Xeon, Intel SpeedStep, Itanium, and Pentium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries. If you reference UNIX® in the text, please mark the first use and include the following; otherwise delete: UNIX is a registered trademark of The Open Group in the United States and other countries. If you reference Linux® in your presentation, please mark the first use and include the following; otherwise delete: Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both. Other company, product, or service names may be trademarks or service marks of others. If the text/graphics include screenshots, no actual IBM employee names may be used (even your own), if your screenshots include fictitious company names (e.g., Renovations, Zeta Bank, Acme) please update and insert the following; otherwise delete: All references to [insert fictitious company name] refer to a fictitious company and are used for illustration purposes only.](https://image.slidesharecdn.com/ad207-presentation-1233605107227680-1/85/AD207-Presentation-43-320.jpg)
AD207 Presentation
- 2. Building an "XPages-Powered" IBM Lotus Domino Application John Mackey | President | Groupware Solutions Inc. AD207
- 3. Agenda Presenter Profile XPages Overview Survey Tool Application Overview Demo Application Design Review Question/Answer Session
- 4. Presenter Profile Consultant for large corporations Started my own company – Groupware Solutions Inc. Working with Lotus Notes since 1993 Background in Websphere Portal technologies Design Partner for the Lotus Component Designer tool 6. The LCD technology is the predecessor for XPages Design Partner for Lotus Notes 8.5 release Contact Info: Home Page: www.GroupwareInc.com Email: John.Mackey@GroupwareInc.com Blog: www.jmackey.net
- 5. XPages Overview An XPage is a new design element based on JavaServer Faces (JSF) technology that lets developers create Web 2.0 enabled pages for use in Web browser applications running on Domino 8.5. XPages includes the following features: AJAX enabled Advanced Web control library Full support for styling by using CSS Fully extensible by using custom controls JavaScript scripting language support Pre-built simple actions Direct access to Java libraries on the server
- 6. Survey Tool Application Overview My objective when designing this session was to select an application that could not easily be built with the standard Domino Designer..... demonstrating the power of XPages. Secondly my goal was to utilize XPage controls to build a complex application with a minimum amount of code or workarounds. Thinking “Inside the Box”....
- 7. Survey Tool Application Overview A Survey Tool provides many challenges for Domino Designer It must allow an administrator to create an unlimited number of questions Change the order of the questions Select the type of input control to display: check box, radio buttons, text box, drop down list etc.,. Provide dynamic validation Provide dynamic navigation: one question per page, all per page Report on the data
- 8. Demo
- 9. Application Design Review Data Model End User Surveys * Response Doc Survey Document * Parent Doc Questions/Answers * Response to Response Doc Base Survey Questions * Response Doc
- 10. Application Design Review – Home Page
- 11. Application Design Review – Survey Details
- 12. Application Design Review – Survey Details
- 13. Application Design Review – Survey Details
- 14. Application Design Review – Survey Questions
- 15. Application Design Review – Questions design Read Mode Table Repeat Control Edit Mode Table Panel Control
- 16. Application Design Review – Repeat Control Repeat Control Properties The Collection name “docid” will contain the docUNIDs for each survey question .
- 17. Application Design Review – Repeat Control Repeat Control iteration formula Note the mixing of @Commands with JavaScript Tip: A Repeat control iteration formula must return an array. When using @DbLookup, an array is not returned if a single match is found. Force the result to an array by using @Explode.
- 18. Application Design Review – Panel Control A Panel Control is repeated for each question Each Panel control will be bound to each question response document using the “docid” variable from the Repeat control.
- 19. Application Design Review – Tables for Read/Edit Within the Panel control there are 2 tables. Each has a visibility formula to show/hide the different tables if the document is in read mode or in edit mode.
- 20. Application Design Review – Web Controls The controls are bound to the fields from the panel document
- 21. Application Design Review - Links Read Mode table: Edit Link Control – Simple Action
- 22. Application Design Review - Links Read Mode table: Delete Link control
- 23. Application Design Review – Add Questions Add New Question Button Control - script
- 24. Application Design Review – Move Questions Move Question down – onclick event action
- 25. Application Design Review – Reorder Questions Move Question – reorderQuestions() function
- 26. Application Design Review – Preview Survey Inline server side script Client side script
- 27. Application Design Review – Take Survey Screen Take Survey page – Displaying all questions on one page
- 28. Application Design Review – Take Survey Screen Take Survey page – Displaying one question per page
- 29. Application Design Review – Take Survey design Take Survey design Repeat Control Panel Control
- 30. Application Design Review – Take Survey design Repeat Control iteration formula
- 31. Application Design Review – Take Survey design Web Controls – Visibility formulas The Web Controls are visible only if the value of the “AnswerType” field is equal to the type of control.
- 32. Application Design Review – Take Survey design Web Controls – Data binding All the Web Controls are bound to the same “Answer” field on the response document. Only one control is visible at a time so there is no conflict.
- 33. Application Design Review – Take Survey design Web Controls – Values formula (only pertains to multivalue controls)
- 34. Application Design Review – Take Survey design Web Controls – Required field computed value formula The field's Required property are set based on the “Required” field
- 35. Application Design Review – Take Survey design Web Control – Display Error control binding The Display Error control dynamically shows errors based on the “AnswerType” field. The Editable controls are named to match the choices.
- 36. Application Design Review – Take Survey design Panel Control – Visibility formula The Panel control, which contains the bound Web controls, is repeated for each question. When the survey is set to only show one question per page, the only panel is visible is the one for the current question .
- 37. Application Design Review – Take Survey design Submit Survey Button – onclick event simple actions The Submit Survey button onclick event fires off 2 simple actions. It sets the status to “Complete” and then saves the survey and redirects the user to the 'ThankYou” XPage.
- 38. Application Design Review – Take Survey design Save and Return Later Button – onclick event JavaScript The Save and Return Later button onclick event fires off 3 simple actions. It sets the status to “Open”, and records the last question# answered, then saves the survey and redirects the user to the 'ReturnLater” XPage. Note that the “No data validation” is checked thus allowing us to save an uncompleted survey.
- 39. Application Design Review – Take Survey design Previous/Next Navigation Links
- 40. Related Sessions Other XPages Sessions AD201 IBM Lotus Domino Designer 8.5: A New Beginning AD204 XPages 101 AD205 XPages: Things You Can't Afford to Miss! AD206 "Super-Sleek" Your Apps with XPages Themes AD208 Teaching Old Docs New Tricks: Creating A New Front End With Xpages AD212 10 Web 2.0 User Interface Patterns for IBM Lotus Notes and Xpages AD220 Real World Examples of How Customers Are Utilizing Xpages BP105 Developing a World-class Web 2.0 Application with Xpages SHOW106 Building A Cool Web 2.0 Application With XPages
- 41. Xpage Related Resources Lotus Designer Wiki http://www-10.lotus.com/ldd/ddwiki.nsf Domino 8.5 Public Beta Discussion Forum http://www-10.lotus.com/ldd/nd85forum.nsf Tutorial: Harness the power of Xpages – by Chris Toohey http://www.ibm.com/developerworks/edu/ls-dw-ls-ddxpages.html XPage Blog Entries can be found at: Planet Lotus http://planetlotus.org/ XPages Distance Learning Courses: TLCC - The Learning Continuum Company http://www.tlcc.com/
- 42. Questions/Answers Thank You! Questions & Answers
- 43. Legal disclaimer Please delete all instructions (text in red) and insert this information at the end ofexternal publications. © IBM Corporation 2008. All Rights Reserved. The information contained in this publication is provided for informational purposes only. While efforts were made to verify the completeness and accuracy of the information contained in this publication, it is provided AS IS without warranty of any kind, express or implied. In addition, this information is based on IBM’s current product plans and strategy, which are subject to change by IBM without notice. IBM shall not be responsible for any damages arising out of the use of, or otherwise related to, this publication or any other materials. Nothing contained in this publication is intended to, nor shall have the effect of, creating any warranties or representations from IBM or its suppliers or licensors, or altering the terms and conditions of the applicable license agreement governing the use of IBM software. References in this presentation to IBM products, programs, or services do not imply that they will be available in all countries in which IBM operates. Product release dates and/or capabilities referenced in this presentation may change at any time at IBM’s sole discretion based on market opportunities or other factors, and are not intended to be a commitment to future product or feature availability in any way. Nothing contained in these materials is intended to, nor shall have the effect of, stating or implying that any activities undertaken by you will result in any specific sales, revenue growth or other results. If the text contains performance statistics or references to benchmarks, insert the following language; otherwise delete: Performance is based on measurements and projections using standard IBM benchmarks in a controlled environment. The actual throughput or performance that any user will experience will vary depending upon many factors, including considerations such as the amount of multiprogramming in the user's job stream, the I/O configuration, the storage configuration, and the workload processed. Therefore, no assurance can be given that an individual user will achieve results similar to those stated here. If the text includes any customer examples, please confirm we have prior written approval from such customer and insert the following language; otherwise delete: All customer examples described are presented as illustrations of how those customers have used IBM products and the results they may have achieved. Actual environmental costs and performance characteristics may vary by customer. Please review text for proper trademark attribution of IBM products. At first use, each product name must be the full name and include appropriate trademark symbols (e.g., IBM Lotus® Sametime® Unyte™). Subsequent references can drop “IBM” but should include the proper branding (e.g., Lotus Sametime Gateway, or WebSphere Application Server). Please refer to http://www.ibm.com/legal/copytrade.shtml for guidance on which trademarks require the ® or ™ symbol. Do not use abbreviations for IBM product names in your presentation. All product names must be used as adjectives rather than nouns. Please list all of the trademarks that you use in your presentation as follows; delete any not included in your presentation. IBM, the IBM logo, Lotus, Lotus Notes, Notes, Domino, Quickr, Sametime, WebSphere, UC2, PartnerWorld and Lotusphere are trademarks of International Business Machines Corporation in the United States, other countries, or both. Unyte is a trademark of WebDialogs, Inc., in the United States, other countries, or both. If you reference Adobe® in the text, please mark the first use and include the following; otherwise delete: Adobe, the Adobe logo, PostScript, and the PostScript logo are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States, and/or other countries. If you reference Java™ in the text, please mark the first use and include the following; otherwise delete: Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both. If you reference Microsoft® and/or Windows® in the text, please mark the first use and include the following, as applicable; otherwise delete: Microsoft and Windows are trademarks of Microsoft Corporation in the United States, other countries, or both. If you reference Intel® and/or any of the following Intel products in the text, please mark the first use and include those that you use as follows; otherwise delete: Intel, Intel Centrino, Celeron, Intel Xeon, Intel SpeedStep, Itanium, and Pentium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries. If you reference UNIX® in the text, please mark the first use and include the following; otherwise delete: UNIX is a registered trademark of The Open Group in the United States and other countries. If you reference Linux® in your presentation, please mark the first use and include the following; otherwise delete: Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both. Other company, product, or service names may be trademarks or service marks of others. If the text/graphics include screenshots, no actual IBM employee names may be used (even your own), if your screenshots include fictitious company names (e.g., Renovations, Zeta Bank, Acme) please update and insert the following; otherwise delete: All references to [insert fictitious company name] refer to a fictitious company and are used for illustration purposes only.