The document discusses a session at IBM Connect 2014 about using the Domino Data Service (DDS) to build native mobile applications with IBM Worklight. The session will cover what DDS is, how to enable it, how to use it to access data from Domino databases via REST APIs, and demonstrate building a first mobile app by installing and configuring Worklight and creating an adapter to connect to a Notes database. The session aims to show how mobile apps can be developed in just 5 minutes by leveraging DDS and Worklight.
2. 22
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.
Please Note
3. 3
Session Description
IBM Domino 9 easily exposes the Domino Data Service (DDS) to enable you to
access data in IBM Notes Databases utilising REST APIs. But how do you get
started building native mobile applications? With IBM Worklight, and DDS! We will
demonstrate how to install, configure and then build your first mobile application.
4. 4
What we'll cover
What is the Domino Data Service (DDS)
How to enable DDS
How to use it
6. 6
Domino 9 = XPages Extension Library + Mobile Controls
Out-Of-TheBox Mobile app toolkit
Awesome Tutorial By Paul Hannan:
– http://tinyurl.com/2014AD50101
Develop a mobile application in 5 Minutes
9. 9
Ever used a JSONFORMAT url in Domino?
/database.nsf/viewname?ReadViewEntries&outputformat=json
Eg:
http://lotusphere.turtleweb.com/sphere2014.nsf/vwSessionsID?ReadViewEntries&outputformat=json
10. 10
Domino Data Service
Rest API that exposes data in a Domino database
Uses internet standard protocols
Build NATIVE applications
12. 12
DDS Exposes JSON in ANY enabled
Notes application
* both VIEWS and DOCUMENTS *
13. 13
DDS Object URL's
FilePath/Databasename.nsf
– The base notes application URL
FilePath/Databasename.nsf/api/data
– The api path when notes application is enabled for DDS
FilePath/Databasename.nsf/api/data/collections
– The path to access Views
FilePath/Databasename.nsf/api/data/documents
– The path to access Documents (Notes/Records)
14. 14
DDS – Working with Views
FilePath/Databasename.nsf/api/data/collections
– The path to access Views
– If called will return a list of views
– Can now navigate those objects by ID or Name
[
{
"@title":"($All)",
"@folder":false,
"@private":false,
"@modified":"2013-09-27T02:17:03Z",
"@unid":"88B0527841D435A648257BF2002DFE4B",
"@href":"http://domain.com:80/folderpath/filename.nsf/api/data/collections/unid/88B0527841D435A648257BF2002DFE4B"
},
{
"@title":"By Category",
"@folder":false,
"@private":false,
"@modified":"2013-09-27T01:39:22Z",
"@unid":"BA68A00AE98C6FB148257BF30006AA52",
"@href":"http://domain.com:80/folderpath/filename.nsf/api/data/collections/unid/BA68A00AE98C6FB148257BF30006AA52"
}
]
15. 15
DDS – Working with Views … cont
Remember the back-end collection is a DOMINO view
As a Domino Developer, you can use all the view commands you are used to: eg
– ?Search
– ?Start=1&count=50
FilePath/Databasename.nsf/api/data/collections/name/ViewName?Command
– No different to calling a view url using standard HTTP
16. 16
DDS – Working with Documents
FilePath/Databasename.nsf/api/data/documents
Lists all the documents in the database
– Includes all “available” item/note/field contents (even rich text)
Get a specific document easily by referring to it's UNID
– FilePath/Databasename.nsf/api/data/documents/unid/88B0527841D435A648257BF2002DFE4B
17. 17
DDS – Working with Documents - Operations
Get
Patch
Put
Delete
FilePath/Databasename.nsf/api/data/documents
Lists all the documents in the database
– Includes all “available” item/note/field contents (even rich text)
Get a specific document easily by referring to it's UNID
– FilePath/Databasename.nsf/api/data/documents/unid/88B0527841D435A648257BF2002DFE4B
19. 19
Enabling DDS - Components
DDS Extended Service – Per Domino Site
– Internet Configuration Documents need to be in use
Per Database
– Each Database is enabled individually
– Access Choices:
● Views Only
● Views and Documents
20. 20
Ensure your Domino Server is using “Internet Sites”
More configuration choices and features than traditional “Web Server Configurations”
Been around for a while...
Enabled per server
Site documents can be multi-server
21. 21
Configuring the web site document is EASY
Web Site Document
Domino Access Services
Enabled Services:
– Data
Restart HTTP task
22. 22
Enabling the Database for DDS
Open the Database Properties
Advanced Tab
Allow Domino Data Service:
– Never (default)
– Views Only
– Views and documents
25. 25
How can we use DDS to build a Native Application
New Notes Database:
– Create a Notes database
– Build some features
– Enable DDS
Existing Notes Database:
– No design changes required!
– Enable DDS
Install IBM Worklight
Create a project
Connect it to your NOTES database
47. 4747
Engage Online
SocialBiz User Group socialbizug.org
– Join the epicenter of Notes and Collaboration user groups
Follow us on Twitter
– @IBMConnect and @IBMSocialBiz
LinkedIn http://bit.ly/SBComm
– Participate in the IBM Social Business group on LinkedIn:
Facebook https://www.facebook.com/IBMSocialBiz
– Like IBM Social Business on Facebook
Social Business Insights blog ibm.com/blogs/socialbusiness
– Read and engage with our bloggers
Engage Online
48. 48
Access Connect Online to complete your session surveys using any:
– Web or mobile browser
– Connect Online kiosk onsite
48