App Settings

From Lianjapedia
(Redirected from Settings)
Jump to: navigation, search

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.

Open App Settings


Note: App Settings are selected in the Attributes tab when the App Inspector is open.

Select App Settings in App Inspector


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
Enable offline data Reserved for future use (True | False). appenableofflinedata Boolean
Offline tables Reserved for future use. appofflinetables Character
Page libraries The page libraries for this App. Comma-separate the filenames to specify more than one. From v9.1.4. pagelibs Character
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
Fast syntax highlighting Fast syntax highlighting (True | False).
Set to True by default. The syntax highlighter for LianjaScript is much more responsive in the debugger when opening large files.
(From v9.5).
minimalsyntaxhighlighting Boolean
Theme The editor theme (Default | Visual Studio Dark | Visual Studio Light | Eclipse | Dreamweaver). editortheme Character
Show Doc Show the editor Doc when editing (True | False). editorhelp Boolean
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
Browser Browser to use for Preview live in browser. From v9.1.5. browser Character
Custom browser location Location of browser to use for Preview live in browser.
From v9.1.5.
custombrowser Character
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

Standalone Options

Attribute Description Name Type
Standalone Lib Include library files in the standalone App directory
(True | False). From v9.5.
standalonelib Boolean
Standalone Zip Create a zip file for the standalone App
(True | False). From v9.5.
standalonezip Boolean
Standalone Exe Create an installer as a self-extracting exe file for the standalone App
(True | False). From v9.5.
standaloneexe Boolean
Standalone Login The standalone App requires login.
(True | False). From v9.5.
standalonelogin Boolean
Standalone Python modules The standalone App requires Python modules.
(True | False). From v9.5.
standalonepython Boolean
Standalone Data Include databases (comma separated list) in the standalone App directory
(True | False). From v9.5.
standalonedata Character

UI Presentation Rules

Attribute Description Name Type
Standalone Build this App as a Standalone app (True | False). standaloneui Boolean
Form Run this App as a Form (True | False). formui 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