User defined settings are the global settings defined in Miracle Studio and can be accessed through Miracle Mobile App.  


Default User Defined Settings

There are a few settings which are already added when you create an app:

smtp

This setting is used to email PDF output of the data collected via forms.


embeHtmlInEmail

This is a flag setting. When turned on, the html of forms will be embeded in the body of emailed PDFs. Otherwise, you can put a custom message in the email body using the Email PDF trigger.


htmlTemplate

This is an HTML template which contains the formatting of PDFs. You can override this template by using custom PDF templates.


Additional Pre-Defined Settings 

There are other pre-defined settings which can be included in Miracle Mobile App.


maxPageImages

This setting defines the maximum number of images you can attach with a form.


Fields
Values
Key    
maxPageImages
Domain
Client
Type
Simple
Section
Images [Or Any]
Settings
10
Display Text
Maximum Image Attachments
Value Type
Picker/Autocomplete/Textbox
Datasource
max_images



maxImageResolution

This setting defines which resolution Image Picker images will be resized to match when saving and submitting forms.


Fields
Values
Key    
maxImageResolution
Domain
Client
Type
Simple
Section
Images [Or Any]
Settings
Any
Display Text
Maximum Image Resolution
Value Type
Picker/Autocomplete/Textbox
Datasource
max_resolution 




Creating New Settings of Your Own

You can create new settings of your own in Miracle Studio. In the process, you will come across the following fields.


Key

This is the key to access an app setting in any form.  An example of this is AppSettings["embeHtmlInEmail"].Value.


Domain

This determines whether a setting is accessible on the server or client.


Type

This determines whether a setting has a single value or multiple key pair values.


Section

This determine the section heading under which the setting will be shown on the mobile app.


Settings

This is the pre-defined or default value(s) for a setting.


Under the Advanced Section, you will find the following fields. 

Display Text

This is the label of the setting shown in the mobile app.


Value Type

Settings can have different types of selection or input values like Picker, Autocomplete, Label, or Textbox.


Datasource

In the case of Picker or Autocomplete controls, settings can have multiple options which can be defined here. Datasource can be string lines or an expression bound to any entity or variables.


Display Expression

When using a Picker or Autocomplete control where datasource is expression-based, you can define which field of the datasource will be shown through this setting.


Value Expression

When using a Picker or Autocomplete control where datasource is expression-based, you can define which field of the datasource will be used for the value.