2.2. Application URLs

To improve URL handling the Naos Framework introduces the following URL schemes. These are translated automatically to the corresponding context-dependent http[s]:// schemes. Mainly they are introduced because of the transparent AJAX support. Using this URL schemes you do not have to worry about the current status of the application.

vapp:/<module>/<controller>/<action>[@<view>][:<node>][?<parameter>]

This scheme is the commonly used URL scheme in applications based on the Naos Framework. In general it allows you to address an action. If you use this scheme in context of a view you do not have to specify the <view> and the <node> parameter as it will default to the current view and datanode, otherwise you have to specify a view and a datanode. <parameter> is optional and follows the common URL parameter scheme, e.g. ?name=Marcos&country=Germany.

Example 2.7. A vapp:/ URL

vapp:/timetool/installation/step1@mainview:default

vmenu:/<menu>/<item>

The vmenu:/ scheme addresses a menu item in an menu defined in the application.conf or in the database.

Example 2.8. A vmenu:/ URL

vmenu:/default/home

Example 2.9. Definition of a menu item in the file application.conf section menu

						menu.default.items = home,myinfo,mydocs,mycoll,search		; comma separated list
						menu.default.item_defaults = home							; comma separated list
						
						menu.default.item.home.id = home
						menu.default.item.home.title = tr: Home
						menu.default.item.home.position = 1						; menu position
						menu.default.item.home.locales = *						; comma separated list of locale codes or all = *
						menu.default.item.home.layout = myinfo					; layout identifier
						menu.default.item.home.view.page.node = dv
						menu.default.item.home.view.page.module = myinfo		; view "main": module we want to call
						menu.default.item.home.view.page.controller = dummy		; view "main": controller we want to call
						menu.default.item.home.view.page.action = dummy			; view "main": action we want to call
						menu.default.item.home.view.page.parameter = 
						menu.default.item.home.view.main_menu.node = dv
						menu.default.item.home.view.main_menu.module = myinfo
						menu.default.item.home.view.main_menu.controller = main-menu
						menu.default.item.home.view.main_menu.action = output
						menu.default.item.home.view.main_menu.parameter = 
						

res:/<path>

The res:/ scheme gives access to the web folders of the Naos Framework, the application and their modules.

Valid URL paths are:

res:/naos/*

Points to the naos.framework.v5/web/ directory.

res:/application/*

Points to the <your application>/web/ directory.

res:/layout/<layout>/*

Points to the web/ directory of the specified <layout>, e.g. <your application>/layout/<layout>/web/ or naos.framework.v5/layout/<layout>/web/ which depends on the context of the layout.

res:/module/<module>/*

Points to the web/ directory of the specified <module>, e.g. <your application>/module/<module>/web/ or naos.framework.v5/module/<module>/web/ which depends on the context of the module.