Websydian Express FAQ

Contents

• Administration
• Development
• Installation

Administration

Basic administration

• How do I re-activate a user that has been deactivated
• User receives error "An error occurred. Please contact web administrator
• I have created a new frameset site element, but some frames are missing
• Collapse markers do not change when tree structure is expanded
• The frame is not populated when a menu item is pressed

Site structure

• How to make use of the site structure tree
• Add a menu to the site structure
• Add a frameset to the site structure
• Add a business process to the site structure
• Add a URL to the site structure
• Remove a site element from the site structure

Content loaders and presentations

• Create a new process
• Move business process to production
• Change the layout of a process
• Activating a menu item from another location (menu service)

Miscellaneous

• Create a new user
• Diagnose errors
• Change the theme of the site
• An error has been reported for a page. How do I find the corresponding HTML template
• Customize content for specific users
• Extending the Administration Interface

Development

Basic development

• I receive the error "Unable to open Document Template...". What is wrong?
• Understanding how the folder list is found for a session
• Move Business Process to Production
• Create a New Presentation
• Move Business Process to Test Environment
• Use a URL in the Application
• Create a Menu
• Split Page in Frames
• Define a Business Process in the Administration interface for test purposes
• What replacement markers are available by Websydian Express PageGenerators
• Extending the Administration Interface

Plex/Websydian development

• Create a Business Process
• Create a Grid on a Page
• Create a User Self-registration Process
• Create and Use a Child Page
• Create a Dynamic Child Page
• Use a Menu Item Outside the Menus
• Insert a Dynamically Loaded Drop Down Box
• Reload Page With Errors

Installation

Q: When trying to access the demosite in my browser I get the error "Could not identify site from entry URL. Please check URL".

This indicates that WebsydianExpress™ was unable to resolve to the demosite.

 

Administration

Q: How do I re-activate a user that has been deactivated?

Use the "User Management -> Users" menu item in the administration menu.

Use the search facility to find the user, who have been deactivated. Press "Update" on the entry in the grid.

On the detail page change the user status to "Active". Press "Update".

The user will now be able to access the site again.

Q: User receives error "An error occurred. Please contact web administrator"

This is a generic error shown to the user whenever a programming error or an error in the site definitions occur.

Of security reasons the user will not get any more specific information about the error.

To facilitate finding the reason for the error the Websydian Express runtime can throw a number of messages depending on the cause of the error. These errors can be found in the message log.

Use the menu item "Utilities->Message log" in the administration menu to check whether any messages has been thrown.

By pressing the Help icon for an message entry in the message log you will get a detailed description of the message and an explanation of what you should do to rectify the situation.

These descriptions are delivered as part of the runtime. In some cases we will have updated the explanation to make it more meaningful. If you receive an error stating the the page containing the description can't be found, or if you do not think the explanation is good enough you can check the list of the newest version of the error descriptions here.

I have created a new frameset site element, but some frames are missing

If you have defined all the frames as children to the frameset site element check that the HTML template for the frameset defines the right number of frames.

E.g. if you have defined 4 frames for the frameset site element, the HTML template for the frameset should contain the following HTML code:

...

<FRAMESET ROWS="74,50,*,40" ...>

....

Please note that it is the ROWS attribute in the template that define the number of rows (in this case 4 rows).

Collapse markers do not change when tree structure is expanded

This will happen with the Mozilla Firefox browser if the feature "Change images" in the Advanced JavaScript Options is disabled.

The frame is not populated when a menu item is pressed

First, check whether any messages have be written to the message log.

If a message has been thrown, please see the help for this message for further information.

If no relevant messages can be found in the message log, there are two possible reasons for the problem.

 

• The frame, which the menu item must populate has not been defined correctly

  Go to the "Site Structure -> Site Structure", select the menu item in the site structure tree. Press "View". In the section "Menu Site Element behavior in Site Tree" find the property "Frame" and check whether this is the frame that ought to be populated. If it is not use the update functionality to correct the frame name.

   

• No call has been entered in the ProcessEntryPoint function.

  If this is the case no PageGenerator function will ever be called. This means that no errors has occurred - and because of this no messages has been written to the message log. On the other hand - as no PageGenerator has been called - no function has populated the frame.

  Contact the responsible developer to make sure whether an actual call has been added to the action diagram - and that it has been added in the edit point "Call to first pagegenerator".

   

I receive the error "Unable to open Document Template..." What is wrong?

Sometimes a business process can return a page that contains the error message [Unable to open Document Template in function "..\html\MyTemplate.HTM" in function "MyFunction"].

See below for reasons to this error and how to resolve it.

Reason

This error comes in three different variations:

1. The folder and template name are as expected.
2. The referenced folder is not correct - it specifies the root folder of the site instead.
3. The folder is correct - but a file with an unexpected suffix is referenced (e.g. MyErrorPage_XXX).

1. The folder and template name are as expected.

This will almost always be because the template has not been generated - or has not been moved to the correct folder.

2. The referenced folder is not correct

This can typically happen if the PageGenerator does not inherit from PageGeneratorForProcess or if the PageGenerator also inherits from a WSYBASE/WSYUTIL pattern.

The reason is that the option "WSYD Read external path", which is set to "No" for the PageGeneratorForProcess, has been overwritten by "Yes" from another pattern.

3. Correct folder - file with unexpected suffix

This will typically occur if a suffix have been defined for the current presentation - but not all templates used by the process have been copied.

This will typically occur for templates used by either error pages or dynamically loaded drop down generators.

Action

1. The folder and template name are as expected.

Generate the template if it has not already been.

Copy the template to the correct folder.

2. The referenced folder is not correct

Ensure that the PageGenerator does inherit from PageGeneratorForProcess.

Set the option "WSYD Read external path" to "No" for the PageGenerator.

3. Correct folder - file with unexpected suffix

Copy the file to a file with the specified filename.