Beautiful Webforms views updater¶

What is it?¶

The Beautiful Webforms View Updater (BWVU) is an utility designed to simplify and automate the process of upgrading a webform view designed with a previous version of Module Suite. Module Suite IDEs allows you to keep working with the views created using the widget library shipped with a previous version of Module Suite, nevertheless, in order to leverage the widgets introduced in a newer version of the widget's library an upgrade is required.

This tool aims to simplify the upgrade procedure.

Tool setup¶

Installing the BWVU, is a straight forward procedure which consists of just two steps:

BWVU dependecies

BWVU is a Module Suite application that leverage extensively the jdbc extension package. It requires you to have it installed and to have the proper JDBC drivers for your Content Server DBMS deployed in the OTHOME/module/anscontentscript_X_y_Z/amlib/jdbc folder.

Run the BWVU installer on a server on which both Content Server and Module Suite have been installed and configured. The installation program will ask for the location of the Content Server's installation folder.

Cluster installation

If you are working with a cluster and want to be able to run the tool from any server of the cluster, you should perform this step on each one of them

Run the installation script http://your.contentsuite.com/otcs/cs.exe?func=amcs.executeadmcs&script=bwfupdater_install.cs and click "Install" : The application will perform some pre-installation checks and will eventually inform you regarding errors that prevent the successful completion of the installation procedure.

Installation completed

If the installation was completed without errors, you should see a message like the one below

Tool usage¶

The main entry point for using the tool is the webform Beautiful WebForms Updater Form created in the OTCS Enterprise Workspace in the BWF Updater folder .

Move and rename

Upon import is completed, the root folder and tool objects (WebForms and Form Template) can be renamed and moved according to your needs without problems.

Running the above mentioned WebForm you'll enter the tool's dashboard. From here you can either review the results of previous updates or, by clicking on the Update button, run a new one.

Before trying to perform the update of an existing Beautiful WebForms view you have to update the widgets library version using the the FormBuilder (e.g. from V1 to V3). After having changed the widgets library and saved the modified view you can come back to the BWVU tool.

Once the view's widgets library version is up to date you can execute the desired upgrade using the BWVU tool, simply enter the view unique id (DataId) and click Update. The result of the update together with the detailed list of operations performed will be available for review in the tools dashboard.