BTT Workplace Area is described by XML and mostly related to the client browser. So what happens if an end-user triggers the saving function?
When an end-user interacts with the Workplace Area, the HTML DOM event on the view component causes triggering the control function, which manipulates the models as shown in the following figure. When the saving function is triggered, the models are reconstructed in a dom tree structure and delivered to the server side. The saving function is implemented by the server program, such as JSP/Servlet or ASP.Net. In other words, it's up to the developers to decide how to save the posted XML dom tree structure, using DB or file system.
The following image is the flow when an end-user makes some changes in the customizable items. For example, the user adds a new tab. The saving function is called to save this Workplace Area. The client sends the XML description for the Workplace Area to the Servlet on the server, as is shown in the 10th step in the following image. The responsibility of the Servlet is to parse the XML string into the desired format and save it. Whether to use the file system or the database is decided by developers.
In the example, the Servlets save the XML strings into file system as shown in the following figure:
In the Step 10, the client sends the XML strings to the server. You can config your Servlet URL in BTTWeb20/Common/config.js, which is designed for configuration of the global variable, such as the URL or the HTML dom element Id .
Servlet URL | XML |
---|---|
ComponentPath | Component.xml |
BasicInfrastructurePath | BasicInfrastructure.xml |
DefaultAppPath | DefaultApp.xml |
UserLayoutPath | UserLayout.xml |
UserPortalPath | UserPortal.xml |
SaveUserLayoutPath | save XML string to UserPageLayout.xml |
SaveUserPortalPath | save XML string to UserPortal.xml |
ServiceListPath | Service.xml |
WidgetCatalogPath | WidgetCatalog.xml |
XML File | XML Schema | Function |
---|---|---|
UserLayout.xml | UserLayout.xsd | Restore the customized UI elements |
BasicInfrastructure.xml | BasicInfrastructure.xsd | Restore the manageable UI Elements |
DefaultApp.xml | DefaultApp.xsd | Design for the metadata for newly created UI elements |
BTT Workplace Area is manly related to the above three XML files. Refer to the corresponding files in the Reference section to get more information.