From a developer’s perspective, the Accelrys ELN Home Page is a container of widgets. It manages the layout of widgets, and handles the persistence of their settings. Several widgets are provided with the application: one for creating new experiments, another for tracking work in progress, and an inbox widget for messages sent through the notebook. This out-of-the-box set can be supplemented by building custom widgets. This session will show several custom widgets examples to demonstrate the basic concepts of widget development and the API they implement. We will also discuss best practices, and how to make your widget a good citizen of the Home Page.

1. (ATS6-DEV07) Building Widgets for
the Accelrys ELN Home Page
Bill Buote
CTO ADQM
ADQM Business Unit
Bill.Buote@accelrys.com

2. • The information on the roadmap and future software
development efforts are intended to outline general
product direction and should not be relied on in making a
purchasing decision.

3. Home Page
• The Home Page is a container of widgets
• Handles widget layout and persistence of widget settings

4. Home Page

5. Demo
• A quick overview of the home page and out-of-the-box
widgets

6. HomePageWidget
• To start developing a custom widget, extend
HomePageWidget (Widget SDK)
• Subclass is responsible for returning factory classes that
create:
– widget view
– widget settings view
• Subclass must also manage widget settings

7. • Primary Namespaces
– Symyx.Notebook.HomePage
– Symyx.Notebook.Applications.HomePage
• New widget
– Main class derives from
• Symyx.Notebook.Applications.HomePage.HomePageWidget
– View class derives from
• Symyx.Notebook.HomePage.UserControlWidgetView
– Factory class derives from
• Symyx.Notebook.HomePage.WidgetViewBuilder
– Custom configuration? Derive from
• Symyx.Notebook.HomePage.UserControlConfigurationView
• Symyx.Notebook.HomePage.ConfigurationViewBuilder
– Custom configuration storage
• Symyx.Notebook.HomePage.Widget.WidgetMemento
Widget Development

8. Demo
• First example: RSS Feed Widget
– Display

9. RSS Feed Widget

10. Widget View
• The widget view is the user control that appears on the
home page
• Create your view by extending UserControlWidgetView

11. Publishing a Widget
• See the sample code in the PublishWidgetToVault project
• Command line utility takes 6 parameters:
– Server
– Username
– Password
– Vault path of widget folder
– Widget title
– Assembly-qualified name of the main widget class

12. Refreshing the Widget View
• View may need to periodically refresh (ex., inbox widget)
• Manual refresh supported by refresh button in widget
title bar
• Refresh button triggers call to RefreshView
• If you want auto-refresh, your view must handle this
• Use ShowBusySpinner and HideBusySpinner while view is
updating

13. Widget View
• Use DisplayMessage for messages such as errors
• Override Dispose to dispose of resources

14. Demo
• Second example: RSS Feed Widget
– Settings

15. RSS Feed Widget

16. Adding Widget Settings - Overview
• Extend WidgetMemento to persist settings
• Extend UserControlConfigurationView for settings UI
• Extend ConfigurationViewBuilder as a factory for the
settings UI
• Modify the widget view to respond to settings

17. Settings Persistence
• Extend Widget.WidgetMemento
• Implement properties for settings in the memento
• Add serialization decorators (DataContract and DataMember)
• Use your memento in the main widget class by overriding
SaveToMemento and RestoreFromMemento
• Implement properties for settings in the main widget
• Also override ResetDefaultValues so the Reset button works
OK

18. Settings UI
• Extend UserControlConfigurationView
• Override OnWidgetSet or use Widget property to access the
main widget and its state
• Override SetConfigurationView, and update the UI based on
the state of the main widget
• Add event handlers to set the state of the main widget as UI is
manipulated
• Widget view subscribes to ConfigurationChanged event of the
main widget in its override of OnWidgetSet

19. ConfigurationViewBuilder
• ConfigurationViewBuilder is a factory that creates the
settings UI
• Extend ConfigurationViewBuilder, overriding
CreateConfigurationView and CreateConfigurationView
• Override ConfigurationViewBuilders in the main widget
to return this new class

20. Demo
• Third example: Structure Search Widget

21. Structure Search Widget

22. Widgets that Search
• Work in Progress widget is an example of a widget that presents
search results
• Extend QueryWidget to implement the main widget class for a
query-based widget
• QueryWidgetViewBuilder can be used as is to create widget views
that execute a query and present the results in a grid
• Auto-refresh also handled for you
• Extend QueryWidgetConfigurationView to implement the settings
UI
• The configuration view sets the main widget’s Query property,
when the settings UI is changed

23. Demo
• Fourth example: Pipeline Pilot Protocol Widget

24. Pipeline Protocol Widget

25. ProtocolWidget
• ProtocolWidget can be configured to run a Pipeline Pilot
protocol that produces HTML
• Views the result in the WebBrowser control
• Modify the PipelinePilot | RunProtocol application permission
to add a new configuration key that specifies the location in
the protocol tree where you will publish widget protocols
– Name: WidgetProtocolRoot
– Value: Protocols/Web Services/Accelrys/Notebook Widgets
• If you need to pass parameters to a protocol, override the
GenerateProtocolParameters method

26. Performance Considerations
• Performance and memory profiling are critical
• Widgets that refresh periodically can have a significant negative
impact on performance
• Consider adding random amount to refresh interval to avoid
simultaneous refreshes (QueryWidgetView will handle this for you)
• Notebook has 2 connections to Vault, so Widgets that refresh and
talk to Vault have the biggest potential to degrade system
performance
• QueryWidgetView handles connection limitation for you
(VaultObjectGrid.GridLoader set to a
KeyedAsynchronousGridLoadStrategy that uses "share" as a key)

27. Summary
• Learned how to build custom widgets
– Extend base classes in Symyx.Notebook.Applications.HomePage
and Symyx.Notebook.HomePage
– QueryWidget base classes can be extended for widgets that
search
– Performance and memory considerations
• Sample widgets and documentation in the Notebook SDK

28. 28
Thank you.
Accelrys, Inc.
9 Industrial Road
Milford, MA 01757