Successfully reported this slideshow.
We use your LinkedIn profile and activity data to personalize ads and to show you more relevant ads. You can change your ad preferences anytime.

AD1545 - Extending the XPages Extension Library

391 views

Published on

Presentation from Brian Gleeson and Padraic Edwards at IBM Connect 2016 on Extending the XPages OpenNTF Extension Library.

Published in: Software
  • Be the first to comment

  • Be the first to like this

AD1545 - Extending the XPages Extension Library

  1. 1. AD1545 – Extending the XPages Extension Library 04:00 PM-05:00 PM, 2nd February, 2016 Orange G Padraic Edwards – IBM Ireland Brian Gleeson – IBM Ireland
  2. 2. Please Note: • IBM’s statements regarding its plans, directions, and intent are subject to change or withdrawal without notice at IBM’s sole discretion. • Information regarding potential future products is intended to outline our general product direction and it should not be relied on in making a purchasing decision. • The information mentioned regarding potential future products is not a commitment, promise, or legal obligation to deliver any material, code or functionality. Information about potential future products may not be incorporated into any contract. • The development, release, and timing of any future features or functionality described for our products remains at our sole discretion. • 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.
  3. 3. Agenda • Introductions • ExtLib - A Brief History • The ExtLib Contribution Process • Hands-On: Making an ExtLib Contribution • Extending Domino Designer • ExtLibX – The Innovation Incubator • Summary
  4. 4. Brian Gleeson Software Developer @BGleesonIE Padraic Edwards Software Developer @paidi_ed Introductions…
  5. 5. Agenda • Introductions • ExtLib - A Brief History • The ExtLib Contribution Process • Hands-On: Making an ExtLib Contribution • Extending Domino Designer • ExtLibX – The Innovation Incubator • Summary
  6. 6. A Brief History of the XPages Extension Library • 1st Release: OpenNTF - September 2010 • Upgrade Pack 1 for IBM Domino 8.5.3 – December 2011  Promoted to IBM Domino 9.0 GA - March 2013 • Innovation Highlights from 2013 • New REST Calendar Service API and Mail API • Single Page App Wizard for Mobile • OneUI302 theme fixes • Infinite scrolling property for the Data view
  7. 7. A Short History of the XPages Extension Library • 9 OpenNTF releases in 2014 • XPages JUnit Test Framework enhancements • Mobile TypeAhead support • Relational support JDBC & DBCP • Responsive Web Design – Bootstrap • Community Contributions • Continued Advancements in 2015 • More Responsive improvements • Additional community contributions • Bluemix Designer tooling Over 85000 Downloads
  8. 8. Agenda • Introductions • ExtLib - A Brief History • The ExtLib Contribution Process • Hands-On: Making an ExtLib Contribution • Extending Domino Designer • ExtLibX – The Innovation Incubator • Summary
  9. 9. Overview of Github ExtLib Integration • Contributions are submitted via pull requests • Merged into ExtLib after a bluewash review  XPages Team code standards are applied… • Code must build properly • JUnit tests must pass • Tagging of UI strings for localization • Pull requests are closed once code is delivered
  10. 10. Overview of Github ExtLib Integration
  11. 11. Agenda • Introductions • ExtLib - A Brief History • The ExtLib Contribution Process • Hands-On: Making an ExtLib Contribution • Extending Domino Designer • ExtLibX – The Innovation Incubator • Summary
  12. 12. How to start contributing today! Tools BuildSubmit Code
  13. 13. Getting Started! • Set up your IDE • Eclipse - http://www.eclipse.org/downloads/ • XPages SDK for Eclipse RCP - http://bit.ly/1OCVYDI • Optional Extras • EGit - www.eclipse.org/egit • Maven - http://download.eclipse.org/technology/m2e/releases • Domino Debug Plugin - http://ibm.co/1OEWS8Z • Become an active member of OpenNTF • http://tinyurl.com/joinOpenNTF
  14. 14. Create your Fork https://github.com/OpenNTF/XPagesExtensionLibrary
  15. 15. Next Steps with your ExtLib Repository ExtLib Main Repository Local Repo Remote Repo Bug Fix Feature Branch Master Fetch Push Fetch Pull Request Commit and Push Clone Periodic Push ExtLibUser
  16. 16. Community Contributed Fixes • PR31 - Fixed a typo  – Jesse Gallagher • PR16 - InPlaceFormAction – Cameron Gregor • PR14 - Picker Enhancements – Paul Withers • PR5 - Add collection support to JSONBuilder – Nathan Freeman • PR27 - New convenience method for ExtlibUtil – Jesse Gallagher • PR21 - Fixed NPE in relational – Serdar Basegmez • PR26 - Added “notes-platform” property for Maven Profile - Jesse
  17. 17. Thanks to our great community!
  18. 18. But we want MORE ! • What can you contribute ?  Bug fixes  A new control  A new property for an existing control  A new data source  New Complex types – validators, converters, simple actions…  Localization & Accessibility fixes  Convenience methods that will help other developers  Maven build enhancements
  19. 19. Where do I get help? • Extensibility API’s - ibm.co/1UeZh8B • Domino App Dev Wiki – articles on…  Creating a control  Creating a library • Mastering XPages Books and Extension Library Book
  20. 20. Where do I get help? • New Slack channel for Extension library  https://openntf.slack.com/messages/extensionlibrary/  Sign up here https://openntfslackin.mybluemix.net/  XPages Team members active • StackOverflow  Nearly 4k of questions  Over 80% answered  http://stackoverflow.com/questions/tagged/xpages
  21. 21. Building a Contribution • Maven – build automation framework • Each plugin in the Extlib has been Mavenized • M2e provides Maven integration in Eclipse • Tycho configurator for Eclipse • Window -> Preferences -> Maven -> Discovery ->Open Catalog • Provides deployable UpdateSite for Notes/Domino testing
  22. 22. Building a Contribution • IBM Domino Build Management UpdateSite  http://tinyurl.com/extlibBuildManagement
  23. 23. Testing a Contribution – optional • Manually validate that your code works – no, really !  Test your code changes locally  Consider getting a code review from a colleague • Optionally… you could create JUnit Tests!  Use the XPages runtime JUnit Test Framework • Also open sourced as part of the ExtLib project  Existing Extlib JUnit test projects • com.ibm.xsp.extlib.test, com.ibm.xsp.extlib.relational.test  Run GreenExtlibTestSuite before committing a contribution
  24. 24. Localizing a contribution – optional • XPages Runtime String Localization Tool
  25. 25. Agenda • Introductions • ExtLib - A Brief History • The ExtLib Contribution Process • Hands-On: Making an ExtLib Contribution • Extending Domino Designer • ExtLibX – The Innovation Incubator • Summary
  26. 26. IBM Domino Designer Tooling Extensions • IBM Domino Designer also provides Extensibility API’s  Create your own Designer wizard  Contribute your own property panels  Add design time visualizations  Add your own theme • More information  ibm.co/1RCWS8d
  27. 27. Creating a new wizard • Wizards are great for generating XPages markup  No need to understand all the properties of a palette item in advance  XSP markup is generated based on some simple questions and answers • How it works  Drag and Drop a control  Pop up a wizard  Gather some design information  Generate XSP markup • Let’s take an example…
  28. 28. Demo
  29. 29. Agenda • Introductions • ExtLib - A Brief History • The ExtLib Contribution Process • Hands-On: Making an ExtLib Contribution • Extending Domino Designer • ExtLibX – The Innovation Incubator • Summary
  30. 30. ExtLibX – Where New Ideas Take Hold ! • Incubator for Innovations, Experiments, PoCs • Currently includes Bootstrap4 Alpha support  A head start on the next major release  “The world’s most popular HTML, CSS and JS framework” • Projects have a lighter review process  Quicker Results • Contributions merged directly into GitHub  Quicker Turnaround
  31. 31. Overview of ExtLibX Integration • Pull requests are merged into main ExtLibX repository ExtLib Repo IBM XPages Product Stream ExtLibX Repo Community Repo’s Forks Submissions Bluewash
  32. 32. Bootstrap 4 αlpha • How to get it?  Download from http://tinyurl.com/extlibx  Install update site  Or install as part of latest ExtLib • How to contribute  Fork repository - https://github.com/OpenNTF/XPagesExtLibX  Write code  Validate results  Submit pull request
  33. 33. Bootstrap 4 – Implemented so far • New Bootstrap plugin  Plugin infrastructure + Bootstrap4.theme  Bootstrap 4 αlpha.2 resources  XPages specific CSS & JS resources  Navbar Renderer  2x Application Layout renderers  Pager Renderer  Dashboard Renderer  Navigator Renderer  Data View Renderer • What’s missing? https://github.com/OpenNTF/XPagesExtLibX/issues
  34. 34. Demo
  35. 35. Get Involved • Learn new skills • Give back…  Over 85,000 users have consumed ExtLib  Less than 30 have contributed …. • Get what you need !  A fix for the bug that impacts you!  A feature that benefits YOUR app! • Have fun collaborating with community colleagues
  36. 36. Summary • We learned how to setup an IDE • How to create a Pull Request for ExtLib • How to build a contribution • How to test a contribution • How to extend Extension Library Tooling • How to contribute to ExtLibX
  37. 37. Sessions of Interest • AD1548 - Building Responsive XPages Applications 9:15AM -10:15AM 3rd February 2016 - Orange F
  38. 38. Your Feedback Is Important! Based upon your session attendance, a customized list of surveys will be built for you. Please complete your surveys via the conference kiosks or any web enabled device here: https://www.connectsurveys.com or IBM Event Connect.
  39. 39. Thank You !
  40. 40. Notices and Disclaimers Copyright © 2015 by International Business Machines Corporation (IBM). No part of this document may be reproduced or transmitted in any form without written permission from IBM. U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM. Information in these presentations (including information relating to products that have not yet been announced by IBM) has been reviewed for accuracy as of the date of initial publication and could include unintentional technical or typographical errors. IBM shall have no responsibility to update this information. THIS DOCUMENT IS DISTRIBUTED "AS IS" WITHOUT ANY WARRANTY, EITHER EXPRESS OR IMPLIED. IN NO EVENT SHALL IBM BE LIABLE FOR ANY DAMAGE ARISING FROM THE USE OF THIS INFORMATION, INCLUDING BUT NOT LIMITED TO, LOSS OF DATA, BUSINESS INTERRUPTION, LOSS OF PROFIT OR LOSS OF OPPORTUNITY. IBM products and services are warranted according to the terms and conditions of the agreements under which they are provided. Any statements regarding IBM's future direction, intent or product plans are subject to change or withdrawal without notice. Performance data contained herein was generally obtained in a controlled, isolated environments. Customer examples are presented as illustrations of how those customers have used IBM products and the results they may have achieved. Actual performance, cost, savings or other results in other operating environments may vary. References in this document to IBM products, programs, or services does not imply that IBM intends to make such products, programs or services available in all countries in which IBM operates or does business. Workshops, sessions and associated materials may have been prepared by independent session speakers, and do not necessarily reflect the views of IBM. All materials and discussions are provided for informational purposes only, and are neither intended to, nor shall constitute legal or other guidance or advice to any individual participant or their specific situation. It is the customer’s responsibility to insure its own compliance with legal requirements and to obtain advice of competent legal counsel as to the identification and interpretation of any relevant laws and regulatory requirements that may affect the customer’s business and any actions the customer may need to take to comply with such laws. IBM does not provide legal advice or represent or warrant that its services or products will ensure that the customer is in compliance with any law
  41. 41. Notices and Disclaimers cont. Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products in connection with this publication and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products. IBM does not warrant the quality of any third-party products, or the ability of any such third-party products to interoperate with IBM’s products. IBM EXPRESSLY DISCLAIMS ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. The provision of the information contained herein is not intended to, and does not, grant any right or license under any IBM patents, copyrights, trademarks or other intellectual property right. •IBM, the IBM logo, ibm.com, Aspera®, Bluemix, Blueworks Live, CICS, Clearcase, Cognos®, DOORS®, Emptoris®, Enterprise Document Management System™, FASP®, FileNet®, Global Business Services ®, Global Technology Services ®, IBM ExperienceOne™, IBM SmartCloud®, IBM Social Business®, Information on Demand, ILOG, Maximo®, MQIntegrator®, MQSeries®, Netcool®, OMEGAMON, OpenPower, PureAnalytics™, PureApplication®, pureCluster™, PureCoverage®, PureData®, PureExperience®, PureFlex®, pureQuery®, pureScale®, PureSystems®, QRadar®, Rational®, Rhapsody®, Smarter Commerce®, SoDA, SPSS, Sterling Commerce®, StoredIQ, Tealeaf®, Tivoli®, Trusteer®, Unica®, urban{code}®, Watson, WebSphere®, Worklight®, X-Force® and System z® Z/OS, are trademarks of International Business Machines Corporation, registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at: www.ibm.com/legal/copytrade.shtml.

×