System console

System console if powerfull framework tool for clinet application debugging. It does not provide any functoinality that might activate business logic functions.

• Warning
• Console functions
  • Clear
• close / exit
• break
• debug
• verbose
• user
• show
• eval
• exec

Developers can use the system console which is a part of the AyMINE Business – client application. Primarily the console is used for runtime Debugging. It allows useful commands to analyse system behaviour.

Warning

Never trust the client Event the AyMINE Business client is not safe client because developers with the console access might start any server-published function with any attributes.

All function published by server should control the access and verify if user has right to start them. Authors of each module has responsibility to check it. AyMINE Framework just check that used has valid login account. Since module control is never sufficient, precise control should be made by business objects and their CheckRights methods.

Console functions

Clear

Clears the console.

Too many data in the console significantly hinder the programme execution so the clear the input when no needed is very useful step.

Double-click at the console content is much faster than writing the clear command and makes the same. So that the command is useful only when you have hands on the keyboard.

close / exit

Closes the console. Makes the same as clicking at the window close symbol

break

Writes break to the console output. Usable to distinguish the outputs.

debug

Starts the debug mode. See more about debugging at subordinate page

verbose

Specify what string is important for debugging.

Command related with the debugging – se the debugging page.

user

Checks if user has the uright assigned

user right sys@sysEverybody

checks if user has the sys@sysEverybody right.

show

Functions sets the string filter to the console output. It allows settings what information are important or uninteresting

show pattern user

The example set up filter that only lines with user in the text are printed to the console and all others are hidden. Function can be used several time to set more patterns to show or hide

   show pattern ?

The question mark displays the list of applied patterns.

eval

Starts internal evaluation of the command. The command is evaluated without context – so that obj. and attr. objects are both null.

Eval method is useful to check globally available data or check methods.

Example:

user.mParam('am')

returns client-defined module info about the am module.

exec

Start the command in the same way as the command from jsonc object description. As well as in the eval method, the command is started without object and attributes. The active fbase window for commands is the console window.

Examples:

exec window.shutdown

Comand closes the console widnow.

exex from.sysUserSettings

Command opens the user settings dialog.

Exec can call both internal (window) methods, methods from module specific modules (e.g. load new js from server) or call a server to start the method.

Remember: Each server method that is published to client application should check user rights to execute it. Neither native AyMINE application guarantee, that user starts only what he/she is allowed – system console, although available only for developer, can be used by anyone.