App Settings

From Lianjapedia
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: From Lianja v4.2 App Settings are selected in the Attributes Tab when the App Inspector is open.

Select App Settings in App Inspector


General

Attribute Description
App Doc App Doc file. This html file will be included at the beginning of the App Doc when it is generated.
Build mode The type of build for Web/Mobile Apps. Use Debug when testing and Release when deploying (Debug | Release)
Published App is published in the App Center (True | False)
Use wizards/builders Use wizards/builders during development (True | False)
Event tracking Trace App events in Web/Mobile Apps. This is only effective in Debug mode. (From v4.2).
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)
Enable guest access Enable this App to be run as a guest without App Center login (True | False)
Timelines Enabled Enable database timelines for sections that have timelines enabled (True | False)
Ask Before Deleting Ask before deleting a record (True | False)
Add Form Section Always add a form section when creating a new blank page (True | False)
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).
Help provider homepage URL Context sensitive help provider URL to use when editing.
Help provider search URL Context sensitive help provider search URL to use when editing. Use {keyword} for item to search for.

Editor

Attribute Description
Use External Editor Use External Editor for editing (True | False).
External Editor The External Editor for editing.
External Editor Extensions A comma separated list of file extensions that will be edited externally.
Activate Completion Activate statement completion (Always | Manually | Never).
Activate completion timeout Activate statement completion timeout.
Enable Intellitips Enable Intellitips (True | False).
Enable code snippets Enable code snippets (True | False).
Enable command syntax hints Enable command syntax hints (True | False).
Enable function parameter hints Enable function parameter hints (True | False).
Enable command parameter hints Enable command window parameter hints (True | False).
Insert matching characters Automatically insert matching characters (True | False).
Enable code folding Enable code folding (True | False).
Enable word highlighting Enable highlighting of words in file as typed (True | False).
Enable smart indenting Enable smart indenting of code blocks (True | False).
Enable object naming conventions Enable object naming conventions to display property/method pick lists based on identifier prefixes (True | False).
Refresh advanced panel Always refresh the editor advanced panel when a file is edited (True | False).
Theme The editor theme (Default | Visual Studio Dark | Visual Studio Light | Eclipse | Dreamweaver).
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).
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).

Embedded HTTP Server

Attribute Description
Listen on The interface the HTTP server should listen for requests on
Port The port that the embedded HTTP server uses
Runtime Port The port that the embedded HTTP server uses at runtime (App Center).
API key The API key that should be specified to invoke desktop web services.
Enable services Enable embedded web services (True | False)

Sessionstorage

Attribute Description
Sessionstorage size The size of the shared sessionstorage
Session data changed The delegate procedure for the session data changed event
Session data changed interval The interval in msecs that checks for session data changes will be made at runtime

Directories

Attribute Description
Storage location Storage location for Data, Apps and Library. If you use Dropbox, OneDrive or GoogleDrive then your development work can be synced between devices automatically (Filesystem | Dropbox | OneDrive | GoogleDrive)
Data directory The database directory where your databases are located.
Apps directory The apps directory where your apps are located.
Library directory The library directory where your libraries are located.
Templates directory The template directory where your templates are located.
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.

Deployment

Attribute Description
Publisher The way to publish the Apps (Copy | SFTP | Custom).
Publisher path The optional full path of the publisher program, e.g. /usr/bin/rsync.
Publisher arguments The optional arguments to the publisher program, e.g. -avc for rsync.
Server The server IP address or nodename where the App will be deployed, e.g. localhost or myserver.mydomain.com.
Directory The root lianja directory on the LAN or server where the Apps will be deployed.
Build an installer Build an installer for Windows desktop deployment (True | False).
Username The optional username to authenticate with the remote server.
Password The optional password to authenticate with the remote server.
Private key (.pem file) The (optional) private key (.pem file) to authenticate with the remote server.

App Center Tile

Attribute Description
Author The App author displayed in the App Center.
Category The category for the App displayed in the App Center.
Version The version for the App displayed in the App Center.
Caption The caption for the App displayed in the App Center.
Icon The icon for the App displayed in the App Center.
Description The description for the App displayed in the App Center.
Background color The background color for the App displayed in the App Center.
Tile size The size of the tile in the App Center.
Dynamic contents The tile in the App Center contains dynamic contents only (True | False).
Tile order The category position for the tile in the App Center.
Tile URL The URL to invoke when this tile is clicked at runtime.
Dynamic tile producer The dynamic tile producer used to update the dynamic tile in the App Center. This can be a procedure or a Lianja/VFP Server Page (.rsp) or JavaScript Server Page (.jssp).
Dynamic tile timer interval The timer interval in seconds to update the dynamic tile in the App Center.

General App Configuration

Attribute Description
Window Title The window title for this App.
Window Width The window width for this App.
Window Height The window height for this App.
Maximize Window Maximize the window for this App (True | False).
Window Resizable Allow the user to resize the App window (True | False).
Hide Header Bar Hide header bar at runtime (True | False).
Show navigation history Show pages navigation history buttons in page header.
Show navigation menu Show pages navigation menu in page header (True | False).
Show Page Center Show Page Center when navigation menu clicked (True | False).
Navigation menu caption Navigation menu caption text in the page header.
Hide header icons Hide the header icons in the page header bars (True | False).
Desktop theme Desktop theme for this App (Default | Android | iOS | Modern | Modern2 | ... (read from themes directory).
Help table Context sensitive help table for this App.
Meta types file The Meta types file for this App.
Meta types library The Meta types library for this App.
Component library The Component library for this App. Components that are generated are saved here. (From v5.0).
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).
CSS libraries The CSS libraries for this App. Separate each filename with a ; to specify more than one.
Additional file path A semi-colon (;) separated list of additional path locations to search for App specific files.
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).
UI states table UI states table for this App.
Initial UI state The initial UI state for this App. This will be applied to all pages, sections and fields/gadgets.
Home page app The App to load when the Home icon is clicked.
Initial page The first page to view for this App at runtime.
HTML editor Choose the HTML editor to use in this App (Desktop | Web | Mobile).
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.
Runtime database The database that will be substituted when the App is deployed at runtime in the App Center or the Web/Mobile clients.
Include in HTML HEAD Include HTML file contents into the HTML5 Client.
Readonly fields backcolor The background color that readonly fields should be displayed in.
App CSS style Specify the global App CSS style for UI theming.
Disable inline editing Disable inline editing (True | False).

Locale Configuration

Attribute Description
Currency character The currency character to use for this App (default $).
Separator character The separator character to use in number formatting for this App (default ,).
Point character The point character to use in number formatting for this App (default .).

Web/Mobile App Configuration

Attribute Description
Character encoding Character encoding for Web/Mobile Apps (utf-8 is recommended).
Language locale Locale for Web/Mobile Apps (affects date picker and various captions).
Header icon type Icon to be displayed in the page header bar in Web/Mobile (Default | Custom | None).
Custom header icon Custom icon to be displayed in the page header bar in Web/Mobile.
Disable right click Disable right click context menu in Web Apps (True | False).
Enable animations Enable animated section transitions in Web/Mobile Apps (True | False).
Web Theme Web theme for this App (Default | AndroidBlackGreen | AndroidBlackBlue | AndroidBlackOrange | AndroidBlackPurple | AndroidBlackRed | AndroidBlackWhite | AndroidWhiteGreen | AndroidWhiteBlue | AndroidWhiteOrange | AndroidWhitePurple | AndroidWhiteRed | iOS | Modern).
Mobile Theme Mobile theme for this App (Default | AndroidBlackGreen | AndroidBlackBlue | AndroidBlackOrange | AndroidBlackPurple | AndroidBlackRed | AndroidBlackWhite | AndroidWhiteGreen | AndroidWhiteBlue | AndroidWhiteOrange | AndroidWhitePurple | AndroidWhiteRed | iOS | Modern).
Mini navigation panel Always show mini (phone) navigation panel on tablets (True | False).

Page defaults

Attribute Description
Navigation bar type Choose the appearance of the data navigation bar to use in this App (Flat | Gradient).
Hide navigation bar slider Hide navigation bar slider (True | False).
Navigation bar CSS Custom navigation bar CSS.
Page menu Choose the appearance of the page navigation menu to use in this App (Menu | Panel).
Page menu row height The row height for the page menu items in this App.
Page menu CSS CSS for the page menu in this App.
Left sidebar visible Show left sidebar (True | False).
Right sidebar visible Show right sidebar (True | False).
Hide search box Hide the search box in the page header bar (True | False).
Hide notifications icon Hide the notifications icon in the page header bar (True | False).
Hide search icon Hide the custom search icon in the page header bar (True | False).
Hide fullscreen icon Hide the fullscreen icon in the page header bar (True | False).
Hide share icon Hide the share icon in the page header bar (True | False).
Hide home icon Hide the home icon in the page header bar (True | False).

Section defaults

Attribute Description
Header type Choose the appearance of the section headers to use in this App (Flat | Gradient).
Icon set Choose the icon set to use for the section headers in this App (Gradient | Black | White | Blue | Gray | Darkgray).
Header height The header height for the section headers in this App.
Header background color The background color for the section headers in this App.
Header foreground color The foreground color for the section headers in this App.
Header font size The font size for the section headers in this App.
Header CSS The CSS for the section headers in this App.
Section CSS The CSS for the sections in this App.

Delegates

Attribute Description
Scripting language The default scripting language for custom code in this App (Recital | Visual FoxPro | Python | JavaScript | TypeScript | Babel | PHP).
Custom library The filename of the library containing code for event handlers and custom procedures/functions.
Hotkey The delegate procedure for the Hotkey event.
Init The delegate procedure for the Init event.
Destroy The delegate procedure for the Destroy event.
Load The delegate procedure for the Load event.
Ready The delegate procedure for the Ready event.
Unload The delegate procedure for the Unload event.
State Changed The delegate procedure for the State Changed event.
Text Translator The delegate procedure for translating text messages.
File System Watcher The delegate procedure for watching for changes to directories and/or files.
Inactive The delegate procedure for the Inactive event.
Inactive interval The inactive interval in seconds that the inactive delegate procedure will be called at runtime.

Permissions and Roles

Attribute Description
Admin roles A comma separated list of roles that can perform admin operations on the App
Create roles A comma separated list of roles that can perform create operations on data in the App
Read roles A comma separated list of roles that can read (and execute) the App
Update roles A comma separated list of roles that can perform update operations on data in the App
Delete roles A comma separated list of roles that can perform delete operations on data in the App

UI Presentation Rules

Attribute Description
Desktop Include this App in a Desktop client (True | False).
Web Include this App in a Web client (True | False).
Tablet Include this App in a Tablet client (True | False).
Phone Include this App in a Phone client (True | False).