Customizing SmartDevicesPlus Templates

The templates are a new type of object named SmartDevicesPlus Template.

The SD Panels and Work With for Smart Devices can be generated based on an SmartDevicesPlus template, and you will generate them much faster and with an attractive and standarized look & feel. 

When you import an SmartDevicesPlus Theme, the templates of that SmartDevicesPlus Theme will be imported:

CustomizingSDPTemplatesImg01

In order to create a new SmartDevicesPlus template you just have to create a new object and select this type. And in order to modify a template it is needed to open it like any other object. There is another option, that is by saving one SD Panel as an SmartDevicesPlus template.

You can add in an SmartDevicesPlus template all the same controls as an SD Panel, and some specific controls that are mentioned below in the document.

CustomizingSDPTemplatesImg02

Also, this object can use Theme classes, so you can assign theme classes to the controls and them define them in the respective themes. If the layout is created for Android you will have to define the class in Andoid Theme, and if the layout is created for iOS you will have to define it for iOS Theme. If the layout is for both platforms you will have to generate them in both Themes.

CustomizingSDPTemplatesImg03

Each SmartDevicesPlus template has the following properties:

Category Property  
SmartDevicesPlus Template Template Category CustomizingSDPTemplatesImg04
Template Preview
Template can be applied to Work With
Tabular sections display template
Tabular sections edit template
Grid sections template
Component template name

SmartDevicesPlus Template Properties

Template Category:

Specifies the name of the category/folder where this SmartDevicesPlus template will be located. When you create an SD Panel and you have to select an SmartDevicesPlus template, they are organized in categories (and also in the Folder View they are arranged by their category inside a folder named SDPTemplates).

In the example above, the SmartDevicesPlus template is located in List folder.  

CustomizingSDPTemplatesImg05

Template Preview:

Specifies the image that will be shown when you select this SmartDevicesPlus template in order to create an SD Panel or Work With for SD based on this SmartDevicesPlus template.

The Preview image will be displayed when selecting an SmartDevicesPlus template or when you have to set the configuration to some SmartDevicesPlus template when using it in some SD Panel:

CustomizingSDPTemplatesImg06

CustomizingSDPTemplatesImg07

You can set another image to this SmartDevicesPlus template by selecting a new image or by changing the resource of the image itself:

CustomizingSDPTemplatesImg08

In order to create a new image of the SmartDevicesPlus template you can make screen of some SD Panel which is created based on this SmartDevicesPlus template.

Template can be applied to Work With:

Specifies whether this SmartDevicesPlus template can be applied to a Work With for Smart Devices object.

When the SmartDevicesPlus template can be applied to a Work With for Smart Devices object, it is needed to specify which SmartDevicesPlus template will be assigned to each Detail Section (tabular in view and edit mode, and grid section) So, in case the previous property is True, the following properties appears:

Tabular sections display template:

Specifies the SmartDevicesPlus template that will be assigned to the tabular sections in display mode (layout View) when applying Work With for Smart Devices selecting this SmartDevicesPlus template.

 

Tabular sections edit template:

Specifies the SmartDevicesPlus template that will be assigned to the tabular sections in edit mode (layout Edit) when applying Work With for Smart Devices selecting this SmartDevicesPlus template.

 

Grid sections template:

Specifies the SmartDevicesPlus template that will be assigned to the grid sections when applying Work With for Smart Devices selecting this SmartDevicesPlus template.

Component template name:

Name of the control that can be used as a component template. If you leave this field empty, it will take the main table us default.


Create a new SmartDevicesPlus template

In order to create a new SmartDevicesPlus template you have to maKe File -> New -> Object (Control + N) and select the type 'SmartDevicesPlus Template':

CustomizingSDPTemplatesImg09

Then you would have to set the properties associated to the SmartDevicesPlus template:

CustomizingSDPTemplatesImg10

Modify the layout (creating as many layouts as wanted) using the components provided by the SmartDevicesPlus toolbar:

CustomizingSDPTemplatesImg11

Modify an existing one

In order to modify an existing template, you have to open the SmartDevicesPlus template object and make the modifications in their properties, layouts, etc.

After you press the option to save the object, if the SmartDevicesPlus template have some modifications in layouts, and control properties, SmartDevicesPlus will show a message asking whether you want to propagate the changes made in the SmartDevicesPlus template to the SD Panels based on that template:

CustomizingSDPTemplatesImg12

If you press Yes the changes will be propagated.

If you press No it will display another confirmation message, because if you select that you do not want to propagate changes, then all the SD Panels won't be updated with the changes that are being saved in the correspondent SmartDevicesPlus template.

CustomizingSDPTemplatesImg13

If you select Yes in this option, then when you want to propagate the changes made now in the SmartDevicesPlus template you will have to do it manually one by one.

But for further modifications in future to the SmartDevicesPlus template, you will be able to propagate them (so, selecting Yes does not mean that the SD Panels will be disassociated from the SmartDevicesPlus template. It only means that for these changes it won't be propagated to SD Panels based on that SmartDevicesPlus template).

Save an SD Panel into an SmartDevicesPlus template

In order to Save an SD Panel into an SmartDevicesPlus template you have to follow the steps mentioned in the following link: Save an SD Panel into an SmartDevicesPlus template