Update your KB to WorkWithPlus 13

Once you install WorkWithPlus 13, there are two possible scenarios:

Use WorkWithPlus 13 with the theme that you already have

In this scenario, install the WorkWithPlus 13 setup and open your KB.

When applying WorkWithPlus for the first time (for example, if you modify and save an instance), WorkWithPlus will import all the necessary resources so you can use the new features. Then, you should go to Tools-->WorkWithPlus-->Apply All Pattern Instances.

After this process, you will be ready to use the new features or to run your app as you usually do!

We always perform regression tests to ensure that the generated code within the versions remains the same, so you won't need to test again your screens.

Use  WorkWithPlus 13 and apply one of the new available designs

When you import a new theme from the "Design System Wizard", WorkWithPlus is going to replace the templates defined within the WorkWithPlus Settings so you will have to impact again the customizations made on them.

This customizations may include:

  • Event Blocks
  • Automatic Conditions
  • Automatic Rules
  • Customizations in the layouts of the screens
  • Etc.

UpgradeImg01

 

In order to keep these customizations with the new theme we suggest the following steps:

Step 1: Mark All Instances As Updated

You should mark your actual instances as updated so you will be sure that the only changes that will be applied are the ones regarding the new theme. This process should be done for Transaction template: 

UpdateKB12Img001

And also for each Web Panels template:

UpdateKB12Img002

Step 2: Import the new design

Import the desired settings and design from the Design System Wizard according to your needs. Once the import process is finished you can go on with the next step.

Step 3: Impact changes made in WorkWithPlus Settings

Open the WorkWithPlus Settings, as you can visualize it has the new theme and layout applied:

UpdateKB12Img003

Open its History:

UpgradeImg04

Select the latest version before the importing process as follows:

UpgradeInmg05

You will need to copy the customizations from the History version to the current WorkWithPlus Settings:

UpdateKB12Img004

You can copy and paste the nodes of Automatic Rules, Automatic Conditions, Event Blocks, etc. to do it faster. For the layout customizations you will need to copy the properties from the different nodes.

In this way, you will have the new theme and layouts with your previous customizations.

Important:

  • If you had customized the Object's name pattern or you are migrating from WorkWithPlus 9 or lower versions, you should also impact that changes in the new WorkWithPlus Settings. So, you can copy the names from the History version to the current WorkWithPlus Settings:

UpgradeImng07

  • The templates which you have before run the "Design System Wizard" that are used and are not in the new version are mantained. So you will need to modify manually these templates to adjust the design to the new version design, to do that you can compare with the "Transacion" and "Selection" designs.
     
  • If you are migrating from WorkWithPlus 10 and you were using Conditional Formatting, you should rename the following classes:

    UpgradeImg16

    And set the names that you had in WorkWithPlus 10:

    UpgradeImg17

Step 4: Update Instances

Update Instances in your Transaction templates and for each Web Panel template in order to impact the new theme in your instances:
UpdateKB12Img005

According to the theme and settings that you have selected during the "Design System Wizard", some messages like the following may appear:
UpdateKB12Img006

This messages ask you whether to delete some specific node from an instance or not. For example, the previous messages asks if you want to remove the "Dynamic Filters" of the Company Transaction as in the selected design the default filter is the "Full Text Search".

Once the "Update Instance" process is finished, if you open an instance, you will see that the new theme is applied but your previous customisations are still there:
UpdateKB12Img007???????

Important: When the Update Instance process is finished, you should go to Tools-->WorkWithPlus-->Apply All Pattern Instances.

Step 5: Recover your menu

If you are loading your menu data from the Data Provider "MenuOptionsData", you should recover its previous version ir order to display the same options you used to have.

Step 6: Run the application

Run your application and enjoy the new design:-)

UpdateKB12Img008

Migrating from HTML to Responsive Web Design

If your Knowledge Base is still in HTML (not responsive), we strongly suggest to also read the following links: