App Settings
Contents
- 1 Overview
- 2 Getting and Setting Attributes Programatically
- 3 General
- 4 CSS theming
- 5 Editor
- 6 Embedded HTTP Server
- 7 Sessionstorage
- 8 Directories
- 9 Deployment
- 10 App Center Tile
- 11 General App Configuration
- 12 Locale Configuration
- 13 Web/Mobile App Configuration
- 14 Page defaults
- 15 Section defaults
- 16 Delegates
- 17 Permissions and Roles
- 18 UI Presentation Rules
Overview
Click the Settings icon in the ModeBar to open up the App Settings dialog. Select a setting category from the pulldown and/or use the scrollbar to browse the settings. With the settings grid selected, type a letter to jump to the first setting that starts with that letter. Typing the same letter again will move to the next setting starting with that letter.
When you have finished editing the settings, click Done to save the changes and close the dialog or Cancel to close the dialog without saving.
Note: App Settings are selected in the Attributes tab when the App Inspector is open.
Getting and Setting Attributes Programatically
The Lianja system object has desktop methods allowing App Settings to be queried and set programmatically:
Lianja.getAttr(name)
Lianja.setAttr(name,value)
e.g.
lIsPublished = Lianja.getAttr("apppublished") Lianja.setAttr("apppublished","true")
See Custom Builders for details on intercepting the new App operation to allow it to be handled programmatically and for developer customizations to be applied.
General
Attribute | Description | Name | Type |
---|---|---|---|
App Doc | App Doc file. This html file will be included at the beginning of the App Doc when it is generated. | appdoc | Character |
Keep attribute versions | Keep attribute versions in appname_appdoc.txt for diff comparison when the App is saved. From v6.3. | keepappdocversions | Boolean |
Build mode | The type of build for Web/Mobile Apps. Use Debug when testing and Release when deploying (Debug | Release). | appbuildtype | Character |
Published | App is published in the App Center (True | False). | apppublished | Boolean |
Use wizards/builders | Use wizards/builders during development (True | False). | usewizards | Boolean |
Check for updates | Check for Lianja App Builder updates at startup (True | False). From v5.2. | checkforupdates | Boolean |
Event tracking | Trace App events in Web/Mobile Apps (True | False). This is only effective in Debug mode. | appeventtracking | Boolean |
Turn Password on | Enter password when starting Lianja (True | False). | ||
Password | Password value. | ||
Confirm Password | Confirm password value. | ||
Restore previous session on startup | Restore the previous session on startup. If checked, then the last App and editor files are reopened (True | False). | ||
Login required | Authentication required to run App (True | False). | apploginrequired | Boolean |
Enable guest access | Enable this App to be run as a guest without App Center login (True | False). | appenableexternal | Boolean |
Database switcher list | Comma separated list of databases that can be switched to. From v6.3. |
appdatabaseswitcherlist | Character |
Timelines Enabled | Enable database timelines for sections that have timelines enabled (True | False). | timelinesenabled | Boolean |
Ask Before Deleting | Ask before deleting a record (True | False). | confirmdeleterecord | Boolean |
Add Form Section | Always add a form section when creating a new blank page (True | False). | addblankformsection | Boolean |
Table information | Query for Table information in the data trees when an App is opened or a database is opened in the Data workspace (True | False). |
||
Deferred load | When this is checked all pages will be loaded with data only when they are first activated (speeds up App load time). (True | False). |
deferredload | Boolean |
Help provider homepage URL | Context sensitive help provider URL to use when editing. | helpproviderurl | Character |
Help provider search URL | Context sensitive help provider search URL to use when editing. Use {keyword} for item to search for. | helpprovidersearchurl | Character |
CSS theming
Attribute | Description | Name | Type |
---|---|---|---|
Desktop CSS style | Specify the global Desktop App CSS style for UI theming. From v6.3. |
cssstyle | Character |
Web CSS style | Specify the global Web App CSS style for UI theming. From v6.3. | cssstyle_web | Character |
Tablet CSS style | Specify the global Tablet App CSS style for UI theming. From v6.3. | cssstyle_tablet | Character |
Phone CSS style | Specify the global Phone App CSS style for UI theming. From v6.3. | cssstyle_phone | Character |
Editor
Attribute | Description | Name | Type |
---|---|---|---|
Use External Editor | Use External Editor for editing (True | False). | useexternaleditor | Boolean |
External Editor | The External Editor for editing. | externaleditor | Character |
External Editor Extensions | A comma separated list of file extensions that will be edited externally. | externaleditorextensions | Character |
Activate Completion | Activate statement completion (Always | Manually | Never). | activatecompletion | Character |
Activate completion timeout | Activate statement completion timeout. | activatecompletiontimeout | Int |
Enable Intellitips | Enable Intellitips (True | False). | enableintellitips | Boolean |
Enable code snippets | Enable code snippets (True | False). | enablecodesnippets | Boolean |
Enable command syntax hints | Enable command syntax hints (True | False). | enablesyntaxhints | Boolean |
Enable function parameter hints | Enable function parameter hints (True | False). | enableparameterhints | Boolean |
Enable command parameter hints | Enable command window parameter hints (True | False). | enableparametercommandhints | Boolean |
Insert matching characters | Automatically insert matching characters (True | False). | automaticallyaddmatchingcharacters | Boolean |
Enable code folding | Enable code folding (True | False). | enablecodefolding | Boolean |
Enable word highlighting | Enable highlighting of words in file as typed (True | False). | enablehighlightwords | Boolean |
Enable smart indenting | Enable smart indenting of code blocks (True | False). | smartindent | Boolean |
Enable object naming conventions | Enable object naming conventions to display property/method pick lists based on identifier prefixes (True | False). | objectnamingconventions | Boolean |
Refresh advanced panel | Always refresh the editor advanced panel when a file is edited (True | False). |
refresheditoradvanced | Boolean |
Theme | The editor theme (Default | Visual Studio Dark | Visual Studio Light | Eclipse | Dreamweaver). | editortheme | Character |
App files search path | A semi-colon (;) separated list of directories to search and refresh in the editor advanced panel when an App file is edited. (From v5.0). | appeditorsearchpath | Character |
Library files search path | A semi-colon (;) separated list of directories to search and refresh in the editor advanced panel when a Library file is edited. (From v5.0). | libeditorsearchpath | Character |
Embedded HTTP Server
Attribute | Description | Name | Type |
---|---|---|---|
Listen on | The interface the HTTP server should listen for requests on | httpnodename | Character |
Port | The port that the embedded HTTP server uses | httpport | Character |
Runtime Port | The port that the embedded HTTP server uses at runtime (App Center). |
runtimehttpport | Character |
API key | The API key that should be specified to invoke desktop web services. | httpapikey | Character |
Enable services | Enable embedded web services (True | False) | httpenableservices | Boolean |
Sessionstorage
Attribute | Description | Name | Type |
---|---|---|---|
Sessionstorage size | The size of the shared sessionstorage | sessionstoragesize | Int |
Session data changed | The delegate procedure for the session data changed event | sessiondatachangedaction | Character |
Session data changed interval | The interval in msecs that checks for session data changes will be made at runtime | sessiondatachangedinterval | Int |
Directories
Attribute | Description | Name | Type |
---|---|---|---|
Data directory | The database directory where your databases are located. | datadir | Character |
Apps directory | The apps directory where your apps are located. | appsdir | Character |
Library directory | The library directory where your libraries are located. | libdir | Character |
Templates directory | The template directory where your templates are located. | templatesdir | Character |
Deployment directory | The deployment directory. This should contain apps, data and library sub-directories. It can be on a network drive to provide shared App and Data access. | runtimerootdir | Character |
Deployment
Attribute | Description | Name | Type |
---|---|---|---|
Publisher | The way to publish the Apps (Copy | SFTP | Custom). | apppublisher | Character |
Publisher path | The optional full path of the publisher program, e.g. /usr/bin/rsync. | apppublisherpath | Character |
Publisher arguments | The optional arguments to the publisher program, e.g. -avc for rsync. | apppublisherarguments | Character |
Server | The server IP address or nodename where the App will be deployed, e.g. localhost or myserver.mydomain.com. | apppublisherserver | Character |
Directory | The root lianja directory on the LAN or server where the Apps will be deployed. | apppublisherdirectory | Character |
Build an installer | Build an installer for Windows desktop deployment (True | False). | ||
Username | The optional username to authenticate with the remote server. | apppublisherusername | Character |
Password | The optional password to authenticate with the remote server. | apppublisherpassword | Character |
Private key (.pem file) | The (optional) private key (.pem file) to authenticate with the remote server. | apppublisherpemfile | Character |
App Center Tile
Attribute | Description | Name | Type |
---|---|---|---|
Author | The App author displayed in the App Center. | appauthor | Character |
Category | The category for the App displayed in the App Center. | appsidebarcategory | Character |
Version | The version for the App displayed in the App Center. | appversion | Character |
Caption | The caption for the App displayed in the App Center. | appsidebarcaption | Character |
Icon | The icon for the App displayed in the App Center. | appsidebaricon | Character |
Description | The description for the App displayed in the App Center. | appdescription | Character |
Background color | The background color for the App displayed in the App Center. | apptilebackcolor | Character |
Tile size | The size of the tile in the App Center. | apptilesize | Character |
Dynamic contents | The tile in the App Center contains dynamic contents only (True | False). | apptiledynamiccontents | Boolean |
Tile order | The category position for the tile in the App Center. | apptileorder | Character |
Tile URL | The URL to invoke when this tile is clicked at runtime. | apptileurl | Character |
Dynamic tile producer | The dynamic tile producer used to update the dynamic tile in the App Center. This can be a procedure or a URL. | timeraction | Character |
Dynamic tile timer interval | The timer interval in seconds to update the dynamic tile in the App Center. | timerinterval | Int |
Dynamic badge producer | The dynamic badge producer used to update the dynamic badge in the tile in the App Center. This can be a procedure or a URL. | countertimeraction | Character |
Dynamic badge timer interval | The timer interval in seconds to update the dynamic badge in the tile in the App Center. | countertimerinterval | Int |
General App Configuration
Attribute | Description | Name | Type |
---|---|---|---|
Window Title | The window title for this App. | apptitle | Character |
Window Width | The window width for this App. | appwidth | Character |
Window Height | The window height for this App. | appheight | Character |
Maximize Window | Maximize the window for this App (True | False). | appmaximize | Boolean |
Window Resizable | Allow the user to resize the App window (True | False). | appresizable | Boolean |
Hide Header Bar | Hide header bar at runtime (True | False). | hideheaderbar | Boolean |
Show navigation history | Show pages navigation history buttons in page header. | showbackbutton | Character |
Show navigation menu | Show pages navigation menu in page header (True | False). | showpagesmenu | Boolean |
Show Page Center | Show Page Center when navigation menu clicked (True | False). | showpagecenter | Boolean |
Disable VT requery when parentdatachanged | This will handle legacy VT usage prior to Lianja 6.3 (True | False). From v6.3. | vtparentrequerydisabled | Boolean |
Navigation menu caption | Navigation menu caption text in the page header. | pagesmenucaption | Character |
Hide header icons | Hide the header icons in the page header bars (True | False). | hideheadericons | Boolean |
Desktop theme | Desktop theme for this App (Default | Android | iOS | Modern | Modern2 | ... (read from themes directory). | theme | Character |
Help table | Context sensitive help table for this App. | helptable | Character |
Meta types file | The Meta types file for this App. | metatypestable | Character |
Meta types library | The Meta types library for this App. | metatypeslib | Character |
Component library | The Component library for this App. Components that are generated are saved here. (From v5.0). | componentlib | Character |
Components | The Components needed for this App. Separate each with a ';' to specify more than one, e.g. example_component.name;example_component.*. (From v5.0). |
components | Character |
CSS libraries | The CSS libraries for this App. Separate each filename with a ; to specify more than one. | csslibs | Character |
Additional file path | A semi-colon (;) separated list of additional path locations to search for App specific files. | addinspath | Character |
Autoload libraries | If True, then libraries are auto loaded if a file of the same name as the directory exists in the additional file paths (True | False). | addinsautoload | Boolean |
UI states table | UI states table for this App. | uistatestable | Character |
Initial UI state | The initial UI state for this App. This will be applied to all pages, sections and fields/gadgets. | uistateinit | Character |
Home page app | The App to load when the Home icon is clicked. | homeapp | Character |
Initial page | The first page to view for this App at runtime. | firstpage | Character |
HTML editor | Choose the HTML editor to use in this App (Desktop | Web | Mobile). | htmleditor | Character |
Runtime connection | The connection string to use for 'local' virtual tables. This will be substituted when the App is deployed at runtime in the App Center or the Web/Mobile clients. | runtimeconnstr | Character |
Runtime database | The database that will be substituted when the App is deployed at runtime in the App Center or the Web/Mobile clients. | runtimedatabase | Character |
Include in HTML HEAD | Include HTML file contents into the HTML5 Client. | includehtmlhead | Character |
Enable as PWA | Enable as a Progressive Web App when generating web/mobile/tablet Apps. | pwa | Boolean |
Enable user translate | Enable user translation in web/mobile/tablet Apps. From v5.5. | enableusertranslation | Boolean |
Enable text translator | Enable text translation in web/mobile/tablet Apps. This enables dynamic language translation of captions in the UI. From v5.5. | enabletranslation | Boolean |
Enable google translate | Enable google translate in web/mobile/tablet Apps. This enables dynamic language translation of captions in the UI. From v5.5. | enablegoogletranslation | Boolean |
Readonly fields backcolor | The background color that readonly fields should be displayed in. | readonlybackcolor | Character |
App CSS style | Specify the global App CSS style for UI theming. | cssstyle | Character |
Disable inline editing | Disable inline editing (True | False). | disableinlineediting | Boolean |
Show PerfMeter in console | Show PerfMeter in the Console (True | False). | consoleperfmeter | Boolean |
Locale Configuration
Attribute | Description | Name | Type |
---|---|---|---|
Currency character | The currency character to use for this App (default $). |
localecurrencycharacter | Character |
Separator character | The separator character to use in number formatting for this App (default ,). |
localeseparatorcharacter | Character |
Point character | The point character to use in number formatting for this App (default .). |
localepointcharacter | Character |
Web/Mobile App Configuration
Attribute | Description | Name | Type |
---|---|---|---|
Character encoding | Character encoding for Web/Mobile Apps (utf-8 is recommended). |
htmlencoding | Character |
Language locale | Locale for Web/Mobile Apps (affects date picker and various captions). | htmllocale | Character |
Header icon type | Icon to be displayed in the page header bar in Web/Mobile (Default | Custom | None). |
webheadericon | Character |
Custom header icon | Custom icon to be displayed in the page header bar in Web/Mobile. | customwebheadericon | Character |
Disable right click | Disable right click context menu in Web Apps (True | False). | disablerightclick | Boolean |
Disable success notifications | Disable success notifications in Web/Mobile apps (True | False). From v7.2. |
disablesysmessages | Boolean |
Enable animations | Enable animated section transitions in Web/Mobile Apps (True | False). |
enableanimations | Boolean |
Web Theme | Web theme for this App (Default | AndroidBlackGreen | AndroidBlackBlue | AndroidBlackOrange | AndroidBlackPurple | AndroidBlackRed | AndroidBlackWhite | AndroidWhiteGreen | AndroidWhiteBlue | AndroidWhiteOrange | AndroidWhitePurple | AndroidWhiteRed | iOS | Modern). | webtheme | Character |
Mobile Theme | Mobile theme for this App (Default | AndroidBlackGreen | AndroidBlackBlue | AndroidBlackOrange | AndroidBlackPurple | AndroidBlackRed | AndroidBlackWhite | AndroidWhiteGreen | AndroidWhiteBlue | AndroidWhiteOrange | AndroidWhitePurple | AndroidWhiteRed | iOS | Modern). | mobiletheme | Character |
Mini navigation panel | Always show mini (phone) navigation panel on tablets (True | False). |
showmininavigationpanel | Boolean |
Page defaults
Attribute | Description | Name | Type |
---|---|---|---|
Navigation bar type | Choose the appearance of the data navigation bar to use in this App (Flat | Gradient). | navbartype | Character |
Hide navigation bar slider | Hide navigation bar slider (True | False). | hideslider | Boolean |
Navigation bar CSS | Custom navigation bar CSS. | navbarcss | Character |
Page menu | Choose the appearance of the page navigation menu to use in this App (Menu | Panel). | pagemenutype | Character |
Page menu theme | Choose the page meu theme to use in this App (Dark | Light). From v9.0. |
pagemenutheme | Character |
Page menu row height | The row height for the page menu items in this App. | pagemenurowheight | Character |
Page menu CSS | CSS for the page menu in this App. | pagemenucss | Character |
Additional page menuitems | Additional menuitems (that can call showdocument() actions) for the page menu in this App. From v5.3. | custompagesmenuitems | Character |
Left sidebar visible | Show left sidebar (True | False). | pagedefault_leftsidebarvisible | Boolean |
Right sidebar visible | Show right sidebar (True | False). | pagedefault_rightsidebarvisible | Boolean |
Hide search box | Hide the search box in the page header bar (True | False). | pagedefault_hidesearchbox | Boolean |
Hide notifications icon | Hide the notifications icon in the page header bar (True | False). | pagedefault_hidenotificationsicon | Boolean |
Hide search icon | Hide the custom search icon in the page header bar (True | False). | pagedefault_hidecustomsearchicon | Boolean |
Hide fullscreen icon | Hide the fullscreen icon in the page header bar (True | False). | pagedefault_hidefullscreenicon | Boolean |
Hide share icon | Hide the share icon in the page header bar (True | False). | pagedefault_hideshareicon | Boolean |
Hide home icon | Hide the home icon in the page header bar (True | False). | pagedefault_hidehomeicon | Boolean |
Section defaults
Attribute | Description | Name | Type |
---|---|---|---|
Inherit dictionary rules | Inherit the data dictionary rules (True | False) | pagesectioninheritdictionary | Boolean |
Header type | Choose the appearance of the section headers to use in this App (Flat | Gradient). |
pagesectionheadertype | Character |
Icon set | Choose the icon set to use for the section headers in this App (Gradient | Black | White | Blue | Gray | Darkgray). |
pagesectionheadericonset | Character |
Header height | The header height for the section headers in this App. | pagesectionheaderheight | Character |
Header background color | The background color for the section headers in this App. | pagesectionheaderbackcolor | Character |
Header foreground color | The foreground color for the section headers in this App. | pagesectionheaderforecolor | Character |
Header font size | The font size for the section headers in this App. | pagesectionheaderfontsize | Character |
Header CSS | The CSS for the section headers in this App. | pagesectionheadercss | Character |
Section CSS | The CSS for the sections in this App. | pagesectioncss | Character |
Delegates
Attribute | Description | Name | Type |
---|---|---|---|
Scripting language | The default scripting language for custom code in this App (Recital | Visual FoxPro | Python | JavaScript | TypeScript | Babel | PHP). | scriptinglanguage | Character |
Custom library | The filename of the library containing code for event handlers and custom procedures/functions. | customlibrary | Character |
Hotkey | The delegate procedure for the Hotkey event. | hotkeyaction | Character |
Init | The delegate procedure for the Init event. | initaction | Character |
Destroy | The delegate procedure for the Destroy event. | destroyaction | Character |
Load | The delegate procedure for the Load event. | loadaction | Character |
Ready | The delegate procedure for the Ready event. | readyaction | Character |
Unload | The delegate procedure for the Unload event. | unloadaction | Character |
Database changed | The delegate procedure for the Database changed event. From v6.3. |
databasechangedaction | Character |
State Changed | The delegate procedure for the State Changed event. | statechangedaction | Character |
Text Translator | The delegate procedure for translating text messages. | texttranslatoraction | Character |
File System Watcher | The delegate procedure for watching for changes to directories and/or files. | watchaction | Character |
Orientation Changed | The delegate procedure for the Orientation Changed event. From v6.0. |
orientationchangedaction | Character |
Device Motion Changed | The delegate procedure for the Device Motion Changed event. From v6.0. |
devicemotionchangedaction | Character |
Connection State Changed | The delegate procedure for the Connection State Changed event. From v6.0. |
connectionchangedaction | Character |
Inactive | The delegate procedure for the Inactive event. | inactiveaction | Character |
Inactive interval | The inactive interval in seconds that the inactive delegate procedure will be called at runtime. | inactiveinterval | Int |
Before preview | The delegate procedure for the before preview event. From v6.3. |
beforepreviewaction | Character |
Permissions and Roles
Attribute | Description | Name | Type |
---|---|---|---|
Available roles | A comma separated list of roles that are available for the App | permavailable | Character |
Admin roles | A comma separated list of roles that can perform admin operations on the App | permadmin | Character |
Create roles | A comma separated list of roles that can perform create operations on data in the App | permcreate | Character |
Read roles | A comma separated list of roles that can read (and execute) the App | permread | Character |
Update roles | A comma separated list of roles that can perform update operations on data in the App | permupdate | Character |
Delete roles | A comma separated list of roles that can perform delete operations on data in the App | permdelete | Character |
UI Presentation Rules
Attribute | Description | Name | Type |
---|---|---|---|
Standalone | Build this App in a Standalone client (True | False). From v7.0. | standaloneui | Boolean |
Desktop | Include this App in a Desktop client (True | False). | desktopui | Boolean |
Web | Include this App in a Web client (True | False). | webui | Boolean |
Tablet | Include this App in a Tablet client (True | False). | mobileui | Boolean |
Phone | Include this App in a Phone client (True | False). | phoneui | Boolean |