skip to main content
OpenEdge Mobile 11.5.1 Updates : Creating OpenEdge Mobile Apps using the Telerik Platform
 

Creating OpenEdge Mobile Apps using the Telerik Platform

The Telerik Platform provides an entirely new environment for developing OpenEdge Mobile Apps with its own project structure, AppBuilder, and UI control set (Kendo UI®). It supports both Web and Hybrid App development using HTML5, JavaScript, jQuery, and Kendo UI, and supports Hybrid Apps using Cordova. OpenEdge Mobile adds support for accessing OpenEdge data from Kendo UI using OpenEdge JavaScript Data Object (JSDO) technology. For more information on the Telerik Platform, see http://docs.telerik.com/platform/help/getting-started/introduction. For more information on Kendo UI, see http://docs.telerik.com/kendo-ui/introduction.
This documentation describes the basic requirements for using Kendo UI features to access OpenEdge data using JSDO technology in new OpenEdge Mobile Apps that you build in the Telerik Platform.
To develop new OpenEdge Mobile Apps using the Telerik Platform, you need to:
*Manually update OpenEdge Business Entities — After you create a Business Entity in Progress® Developer Studio for OpenEdge, you need to modify it to be accessed as a Mobile resource from a JSDO that you create in the Telerik Platform. These manual modifications include additional code annotations for the read method, new ABL code for interpreting the read method's filter parameter as a JSON Filter Pattern, and adding a new invoke method to provide the total number of records in the result set returned for the single-temp-table dataset parameter or in the parent temp-table of a multi-table dataset parameter.
For more information, see Updating Business Entities for new Mobile Apps in the Telerik Platform.
*Create a Mobile service to generate and deploy a JSDO catalog — After you create and modify a Business Entity, you need to create a Mobile service for it to generate a JSDO catalog in Developer Studio, and deploy the Mobile service to a Mobile Web application that you can access from the Telerik Platform.
For more information, see the sections on creating Mobile services in OpenEdge Development: Mobile Applications and the online help in Progress Developer Studio for OpenEdge.
*Create a project for a new Mobile App in the Telerik Platform — After you have access to a JSDO catalog that defines the Mobile resource you want to access, you can build a new Mobile App to access it in the Telerik Platform. To begin creating this Mobile App in the Telerik Platform:
1. Create a Hybrid app with a blank starting point.
2. In the new Hybrid app, create an AppBuilder Hybrid project.
3. In the Create AppBuilder Hybrid project page, select Choose project template and click Progress Data Service.
4. Enter a Project name and optional Description.
5. Click Create project to create and open the new project in the Telerik AppBuilder.
6. Open the README.txt file in the project to get started.
*Access OpenEdge data using the JSDO dialect of the Kendo UI DataSource — As you develop the Mobile App, you will use one or more Kendo UI DataSources to bind a remote data service to Kendo UI widgets, like the Kendo UI Grid. To access OpenEdge data using these Kendo UI widgets, you need to use the JSDO dialect of the Kendo UI DataSource described in this document. This dialect of the Kendo UI DataSource is specifically implemented to access a JSDO instance as a remote data service for Kendo UI widgets. However, note that Kendo UI widgets have particular Kendo UI DataSource requirements, and not all of them support the JSDO dialect. The following table summarizes the Kendo UI widgets that support data access through a Kendo UI DataSource and if they support the JSDO dialect.
Table 1. Kendo UI support for DataSources
Widgets with a DataSource property
Support for the JSDO dialect?
Notes
ComboBox
Yes
DropDownlist
Yes
Gantt
No
Requires GanttDataSource
Grid
Yes
ListView
Yes
MultiSelect
Yes
PivotGrid
No
Requires PivotDataSource
Scheduler
No
Requires SchedulerDataSource
TreeList
No
Requires TreeListDataSource
TreeView
No
Requires HierarchicalDataSource
For an overview and reference to the JSDO dialect of the Kendo UI DataSource, see JSDO dialect of the Kendo UI DataSource .
*Manage JSDO login sessions and catalogs for the JSDO dialect of a DataSource using a JSDOSession object — To create a JSDO dialect of the Kendo UI DataSource, you need to provide access to a JSDO catalog to create the JSDO that the DataSource accesses. As in previous releases, you need to create a user login session to the Mobile Web application that hosts the Mobile service you want to access, and you need to load the JSDO catalog for that Mobile service into your user login session. To support the requirements of the Kendo UI DataSource, it is strongly recommended that you use an instance of the progress.data.JSDOSession class to login and load JSDO catalogs. This class provides similar features to the progress.data.Session class that you might know from previous releases, but it supports only asynchronous session management methods that return jQuery Promises to handle the results.
For an overview and reference to this class, see Session management updates.
Note: The section on session management updates also includes information on managing certificates for HTTPS testing that applies both to Mobile App development on the Telerik Platform as well as to Mobile App development in previous releases of OpenEdge. For more information, see Note about certificate management for HTTPS testing.