Connectivity Support property

Official Content
This documentation is valid for:
Indicates whether an object is going to be executed online or offline.

Values

Inherit This value is only available for non-main objects. The value of the property will be inherited from the caller object at runtime.
Offline The object is executed completely offline with no automatic communication to the server.
Online The object will execute on an online environment communicating with the server via REST services. This is the default value for main Smart Devices objects.

Scope

Objects: Menu for Smart Devices, Data Provider, Procedure, Panel for Smart Devices, Theme for Smart Devices, Work With for Smart Devices
Platforms: Smart Devices(Android, IOS)

Description

This property enables Offline Native Mobile Applications Generation.

It sets whether an object is generated online or offline. When an object is set to execute online, GeneXus will generate REST services in order to enable communication between the device and the web server. On the other hand, if the value is set to offline, native code for Smart Devices will be generated in order to execute every action on the device without invoking a REST service on a web server.

When this property is set to Offline in a main Smart Device object, it means two things:

  • A local database will be generated in the device.
  • A new GeneXus object appears on the Folder View, under the Main Object: the Offline Database object.

 

Considerations

As from GeneXus X Evolution 3 RC (codename: Tilo) this property is also available for Procedures and Business Components. This feature makes it easier to call Web Services in an offline application; before, when HttpClient was used, it was necessary to perform this kind of calls.

Now, calling a Procedure that is exposed as a REST service from an offline application is as simple as setting the Connectivity Support property of that Procedure to Online. Then, every time you call that Procedure from your application, it is going to be called via REST services.

Restrictions

  • If the Business Component is edited in the layout of some Work With object, then the Connectivity Support property of the Business Component is discarded, and the device uses the Connectivity Support property of the WWSD object instead.
  • The Connectivity Support property over Procedures, Data Providers, and Business Components works only when these objects are called from Client Events; otherwise, the called object inherits the Connectivity Support property value from the caller object. This means, for example, that if an Online Procedure is called from an Offline Procedure, the Online Procedure is called Offline.

How to apply changes

To apply the corresponding changes when the property value is configured, execute a Rebuild All.

Availability

This property is available since GeneXus X Evolution 3.

See Also