Telerik Deliveries Enterprise Sample App for PhoneGap/Cordova

• Overview
• Requirements
• Configuration
• Running the Sample
• Testing the Sample

Overview

This repository contains the Telerik Deliveries Enterprise app for PhoneGap/Cordova. It is a sample mobile app demonstrating how to connect to data in a corporate database with added Offline Support and Caching Support.

The detailed list of showcased features includes:

• Data Connectors
  • Creating a Data Connector from a demo Data Link Server
  • Creating a content type from a Microsoft SQL Server table
  • Connecting the application to the SQL data
• Offline Support
  • Switching between online and offline mode
  • Data synchronization
  • ClientWins conflict resolution strategy
  • Offline files
  • UI integration
• Caching
• Authentication Persistence

Similarly to all other Telerik hybrid apps, Telerik Deliveries runs on iOS, Android, and Windows Phone 8.

Screenshots

Login Screen	Main Menu	All Orders, Offline

Requirements

Before you begin, you need to ensure that you have the following:

• An active Telerik Platform Enterprise account Ensure that you can log in to a Telerik Platform account with Enterprise subscription. This can be a free Enterprise trial account. All features included in the sample app work during the free trial period.

• Telerik AppBuilder The sample app requires Telerik AppBuilder to run. This can be the in-browser client, the desktop client or the extension for Visual Studio.

Configuration

The Deliveries sample app comes fully functional, but to see it in action you must link it to your own Telerik Platform account.

To do that, set the API Key for your Telerik Backend Services project. This is a unique string that links the sample mobile app to a project in Telerik Backend Services where all the data is read from/saved.

1. Click the "Try in AppBuilder" button to clone the repository in AppBuilder.
   An app called "My App" is created for you with an AppBuilder project set up.
2. Click My App in the navigation bar at the top to go the app home.
3. Create a Backend Services project.
4. Once the Backend Services project is ready, go to Overview > API Keys.
5. Take note of your API Key and API Master Key.
6. Go back to the AppBuilder project.
7. Open the config.js file.
8. Set the Config.ApiKey value to the API key of your Backend Services project.
9. Set the Config.MasterKey value to the API Master Key of your Backend Services project.

Running the Sample

Once the app is configured, you can run it either on a real device or in the Telerik AppBuilder simulator.

To run it, follow the steps in the product's documentation: Running Apps on Devices.

After you run the app successfully, it guides you through a data initialization process. It includes setting up a Data Connector from the Demo Data Link server and creating a content type from an underlying relational database table.

Testing the Sample

For your convenience, the app always displays whether it works online or offline. You can simulate lack of Internet connection from the AppBuilder simulator. If you are testing on a device, you have to turn off the WiFi and the data connection to go in offline mode.

Ensure that the emulator or the device that you are using has Internet connectivity when running the sample.

One way to test the app is to follow this work flow:

1. Make sure the Internet connection is on.
2. Log in and browse the delivery orders.
3. Turn off the Internet connection and restart the application.
   Result: you can still browse the delivery orders.
4. Change an existing item (enter comment or change status).
5. Turn on the Internet connection.
   Result: Your change is synchronized to the cloud and you can see it in the Telerik Platform portal.

You can toggle the network connection mode from the simulator as explained here