Skip to main content link. Accesskey S
  • Log In
  • Help
  • IBM Logo
  • IBM Notes and Domino wiki
  • All Wikis
  • All Forums
  • Home
  • Product Documentation
  • Community Articles
  • Learning Center
  • IBM Redbooks
  • API Documentation
Search
Community Articles > Lotus Domino > Gadget data flow
  • New Article
  • Share Show Menu▼
  • Subscribe Show Menu▼

About the Original Author

Click to view profileIBM contributorStanton Sievers
Contribution Summary:
  • Articles authored: 16
  • Articles edited: 0
  • Comments Posted: 3

Recent articles by this author

Integration with XPage Embedded Experiences

XPages can be leveraged as embedded experiences in Notes and iNotes. This article outlines the considerations one should make to enable this functionality.

Gadget data flow

OpenSocial Component functionality in Notes and iNotes relies on several different pieces of data, including proxy rules, OAuth consumer information, and gadget capability information. This article outlines how this data is used and how its use can be customized.

Collecting support data

In the event that verification of the OpenSocial Component fails an administrator will need to collect support data. This article outlines how an administrator can collect support data for Notes, iNotes, and Domino.

Verification

Once the OpenSocial Component is installed and configured, administrators need to verify that their environment is working properly. This article outlines how an administrator can do such verification.

Troubleshooting

In the event that verification of the OpenSocial Component fails an administrator may need to troubleshoot his or her environment. This article outlines how an administrator can do such troubleshooting.
Community articleGadget data flow
Added by IBM contributorStanton Sievers | Edited by IBM contributorStanton Sievers on April 18, 2013 | Version 16
expanded Abstract
collapsed Abstract
OpenSocial Component functionality in Notes and iNotes relies on several different pieces of data, including proxy rules, OAuth consumer information, and gadget capability information. This article outlines how this data is used and how its use can be customized.
ShowTable of Contents
HideTable of Contents
  • 1 Overview
  • 2 Widget Trust
    • 2.1 Widget Trust in Notes
    • 2.2 Widget Trust in iNotes
  • 3 Gadget Capabilities
    • 3.1 Gadget Capabilities in Notes
    • 3.2 Gadget Capabilities in iNotes
    • 3.3 Gadget Capabilities on the Domino Server with Shindig
  • 4 Proxy Rules
    • 4.1 Proxy Rules in Notes
    • 4.2 Proxy Rules on the Domino Server with Shindig
  • 5 OAuth Information
    • 5.1 Types of OAuth Information
  • 6 Notes.ini Settings for Customization

< Previous | Cookbook Contents


Overview


OpenSocial Component functionality in Notes and iNotes relies on several pieces of data that control what OpenSocial gadgets are allowed to render, how they are allowed to render, what information they are allowed to have access to on the network, and what authorization protocols they are allowed to use. These will be referred to as widget trust, gadget capabilities, proxy rules, and OAuth data, respectively. Much of this data is generated during the Widget approval process and is utilized during the Gadget rendering process. This article will detail the data that is created, where it is created, and when it is available to be utilized, with the purpose of educating administrators so they know at what point after Widget creation and approval the Widget will be able to work as expected in Notes and iNotes.

In each section below, several questions will be answered:
  1. Where is this data stored?
  2. When is this data read?
  3. Can the behavior of #2 be customized?

Note: Any data stored in the Credential Store application can be viewed there but it SHOULD NOT be modified in the credential store application itself. All modifications should occur through the Widget Catalog. For more information, see Widgets created from an OpenSocial gadget and its child articles.

Widget Trust


As described in the Widget approval process, OpenSocial gadgets and Embedded Experiences require a Widget to be trusted by an administrator before they will work in the Notes and iNotes clients. Trust is established once an administrator approves the Widget in the catalog, signing the document in the process.

Widget Trust in Notes


  1. Where is this data stored? The data is stored is stored in and derived from the local replica of the Widget Catalog.
  2. When is this data read? The data is read at Widget install time and the trust established at that time is only recalculated when there are updates to the particular Widget.
  3. Can the behavior of #2 be customized? No.

Widget Trust in iNotes


  1. Where is this data stored? The data is stored in a hidden column in the Widget Catalog and is calculated when the widget document is approved and when the view updates
  2. When is this data read? The data is read when iNotes starts, when Widgets are installed, updated, or removed, and every hour
  3. Can the behavior of #2 be customized? Yes. See "iNotes_WA_WidgetDataRefreshInterval". One can also execute the "Update Widgets" action in the My Widgets sidebar menu to force an update.

Gadget Capabilities


As described in the Gadget rendering process, OpenSocial gadgets and Embedded Experiences rely on capabilities to define what APIs they have access to at runtime. For OpenSocial gadgets, this correlates to the OpenSocial features the gadget is requesting to use. For Embedded Experiences, there are special capabilities that indicate if an OpenSocial gadget or web widget is able to render as an Embedded Experience in e-mail. The runtime checks occur in Notes for local rendering and on the Domino Server with Shindig for iNotes gadgets and Notes remote rendering. The Embedded Experiences capabilities check occurs client-side in iNotes and Notes, regardless of whether the rendering in Notes is local or remote.

Gadget Capabilities in Notes


  1. Where is this data stored? This data is stored in the My Widgets palette store, which is persisted to disk across Notes client restarts.
  2. When is this data read? This data is read when the My Widgets framework is initialized, is updated when Widgets are installed, updated, or removed, and persisted to disk.
  3. Can the behavior of #2 be customized? There is no need to customize the behavior of #2, as all of the data is always current and does not rely on periodic refreshes.

Gadget Capabilities in iNotes


  1. Where is this data stored? The data is stored in the Widget Catalog replica on the iNotes server and is manifested in client-side memory when iNotes starts.
  2. When is this data read? The data is read when iNotes starts, when Widgets are installed, updated, or removed, and every hour
  3. Can the behavior of #2 be customized? Yes. See "iNotes_WA_WidgetDataRefreshInterval". One can also execute the "Update Widgets" action in the My Widgets sidebar menu to force an update.

Gadget Capabilities on the Domino Server with Shindig


  1. Where is this data stored? This data is stored in the Credential Store application on the Domino Server with Shindig
  2. When is this data read? This data is read when the web application defined by the com.ibm.fiesta.inotes OSGi bundle loads on the Domino Server with Shindig and every hour thereafter.
  3. Can the behavior of #2 be customized? Yes. See "SocialCapabilitiesRefreshInterval". One can also execute tell http osgi social refresh capabilities to force an update.

Proxy Rules


Proxy rules are used by Notes for local rendering and on the Domino Server with Shindig for iNotes and Notes remote rendering. For more information on proxy rules, see the "Proxy Settings" section of Widgets created from an OpenSocial gadget.

Proxy Rules in Notes


  1. Where is this data stored? This data is stored in the local replica of the Widget Catalog
  2. When is this data read? The data is read the when the web application defined by the com.ibm.fiesta.notes OSGi bundle loads in Notes, when Widget preferences for server or database name change, or when the local Widget Catalog replicates.
  3. Can the behavior of #2 be customized? There is no need to customize the behavior of #2, as all of the data is always current and does not rely on periodic refreshes.

Proxy Rules on the Domino Server with Shindig


  1. Where is this data stored? This data is stored in the Credential Store application on the Domino Server with Shindig
  2. When is this data read? This data is read when the web application defined by the com.ibm.fiesta.inotes OSGi bundle loads on the Domino Server with Shindig and every hour thereafter.
  3. Can the behavior of #2 be customized? Yes. See "SocialProxyRefreshInterval". One can also execute tell http osgi social refresh proxy to force an update

OAuth Information


As described in the Gadget rendering process, OpenSocial gadgets that use OAuth always render using the Domino Server with Shindig. This means that OAuth data is read by the Notes client, nor is there ever a need to.

For more information, see the OAuth Configuration section of Widgets created from an OpenSocial gadget.
  1. Where is this data stored? This data is stored in the Credential Store application on the Domino Server with Shindig
  2. When is this data read? This data is read when the web application defined by the com.ibm.fiesta.inotes OSGi bundle loads on the Domino Server with Shindig and every hour thereafter.
  3. Can the behavior of #2 be customized? Yes. See "SocialOAuthRefreshInterval". One can also execute tell http osgi social refresh oauthconsumers or tell http osgi social refresh oauthtokens to force an update

Types of OAuth Information


Four types of OAuth information is stored in the Credential Store application. The OpenSocial Component supports both OAuth1.0a and OAuth2, and each version of OAuth has OAuth consumer and OAuth access information. The OAuth consumer information is what is configured during the Widget approval process. The OAuth access information is created dynamically as end users "do the OAuth dance" to authorize the applications on their own behalf.

Notes.ini Settings for Customization


Name Valid Values Default Value Where to set Description
iNotes_WA_WidgetDataRefreshInterval A positive integer of milliseconds 3600000 The iNotes server(s) The interval for how many miliseconds the iNotes client will wait until it tries to refetch the widget data from the server. The default is 1 hour.
SocialCapabilitiesRefreshInterval A positive integer of minutes 60 The Domino Server(s) with Shindig Interval in minutes at which to check for updates to Gadget Capabilities in order to refresh the cached information. A value of 0 or less disables the refresh check
SocialProxyRefreshInterval A positive integer of minutes 60 The Domino Server(s) with Shindig Interval in minutes at which to check for updates to proxy configuration rules. A value of 0 or less disables the refresh check
SocialOAuthRefreshInterval A positive integer of minutes 60 The Domino Server(s) with Shindig Interval in minutes at which to check for updates to OAuth client information. A value of 0 or less disables the refresh check

< Previous | Cookbook Contents

expanded Attachments (0)
collapsed Attachments (0)
expanded Versions (31)
collapsed Versions (31)
Version Comparison     
VersionDateChanged by              Summary of changes
31Sep 15, 2016, 4:15:53 PMSimon Hewett  IBM contributor
30Jan 28, 2014, 2:51:48 PMDoug MacDonald  IBM contributor
29Jan 27, 2014, 4:21:33 PMDoug MacDonald  IBM contributor
28Apr 19, 2013, 12:06:31 PMStanton Sievers  IBM contributorPublishing
26Apr 19, 2013, 12:06:01 PMStanton Sievers  IBM contributorMore clarification
25Apr 19, 2013, 12:03:43 PMStanton Sievers  IBM contributorClarifying trust and capabilities
24Apr 19, 2013, 8:07:58 AMStanton Sievers  IBM contributorAdding DOTS information
23Apr 19, 2013, 8:04:47 AMStanton Sievers  IBM contributorMinor Change
22Apr 18, 2013, 7:53:14 PMStanton Sievers  IBM contributorMinor Change
21Apr 18, 2013, 7:51:30 PMStanton Sievers  IBM contributor
20Apr 18, 2013, 7:47:15 PMStanton Sievers  IBM contributorUpdates based on review
19Apr 18, 2013, 1:16:32 PMStanton Sievers  IBM contributorMinor Change
18Apr 18, 2013, 1:15:56 PMStanton Sievers  IBM contributorClarifying OAuth info
17Apr 18, 2013, 1:11:41 PMStanton Sievers  IBM contributorMinor Change
This version (16)Apr 18, 2013, 1:05:42 PMStanton Sievers  IBM contributorMaking headers unique so TOC links are accurate
15Apr 18, 2013, 1:03:14 PMStanton Sievers  IBM contributor
14Apr 18, 2013, 12:50:19 PMStanton Sievers  IBM contributor
13Apr 18, 2013, 12:50:15 PMStanton Sievers  IBM contributor
12Apr 18, 2013, 12:44:50 PMStanton Sievers  IBM contributor
11Apr 18, 2013, 12:41:11 PMStanton Sievers  IBM contributor
10Apr 18, 2013, 12:40:15 PMStanton Sievers  IBM contributorAdding a table of values
9Apr 18, 2013, 11:47:36 AMStanton Sievers  IBM contributor
8Apr 18, 2013, 7:33:13 AMStanton Sievers  IBM contributorExpanding on trust
7Apr 17, 2013, 9:26:02 PMStanton Sievers  IBM contributorMinor Change
6Apr 17, 2013, 5:41:04 PMStanton Sievers  IBM contributorMinor Change
5Apr 17, 2013, 5:39:41 PMStanton Sievers  IBM contributorMinor Change
4Apr 17, 2013, 5:38:22 PMStanton Sievers  IBM contributorAnswering 3 key questions for each piece of data.
3Apr 17, 2013, 5:24:25 PMStanton Sievers  IBM contributor
2Apr 17, 2013, 12:20:08 PMStanton Sievers  IBM contributorAdding the overview
1Apr 17, 2013, 10:19:23 AMStanton Sievers  IBM contributorInitial commit
1Apr 17, 2013, 10:23:48 AMStanton Sievers  IBM contributorAdding navigation
Copy and paste this wiki markup to link to this article from another article in this wiki.
Go ElsewhereStay ConnectedHelpAbout
  • IBM Collaboration Solutions wikis
  • IBM developerWorks
  • IBM Software support
  • Twitter LinkIBMSocialBizUX on Twitter
  • FacebookIBMSocialBizUX on Facebook
  • ForumsLotus product forums
  • BlogsIBM Social Business UX blog
  • Community LinkThe Social Lounge
  • Wiki Help
  • Forgot user name/password
  • Wiki design feedback
  • Content feedback
  • About the wiki
  • About IBM
  • Privacy
  • Accessibility
  • IBM Terms of use
  • Wiki terms of use