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 objects for mobile applications development.

Scope

Objects: Menu, Data Provider, Procedure, Panel, Theme, Work With
Generators: Android, Apple

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 webserver. On the other hand, if the value is set to offline, native code for devices will be generated 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 object for mobile development, 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

Since 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 work 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