Update your KB to WorkWithPlus 12

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

Use WorkWithPlus 12 with the theme that you already have

In this scenario, install the WorkWithPlus 12 setup, open your KB, and add the following User Control in your Master Page (according to the Font Awesome version that you want to use):

Keep using Font Awesome 4:

UpdateKB12Img010

You should also set the following property:

UpdateKBImg012

Upgrade to Font Awesome 5:

UpdateKBImg011

You should also set the following property:

UpdateKBImg013

Important: If you are using Font Awesome 4, you can update to Font Awesome 5 according to the steps defined by Font Awesome: https://fontawesome.com/how-to-use/on-the-web/setup/upgrading-from-version-4

As explained on Font Awesome upgrade manual, you should include v4-shims.min.css to properly visualise your current icons. This file is already included in the KB resources under DVelop\Bootstrap\Shared\fontawesome_v5\css folder, you should include that css in the Master Page as follows:

Form.HeaderRawHTML += '<link rel="stylesheet" type="text/css" href="DVelop\Bootstrap\Shared\fontawesome_v5\css\v4-shims.min.css">'

UpdateKB12iMG015

You also need to add the following class in the theme object:

UpdateKB12Img016

You can check Font Awesome 5 icons at: https://fontawesome.com/icons?d=gallery.

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. After this process, you will be ready to use the new features!

If you don't want to add any new feature, just run your KB as you always do.

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

Use  WorkWithPlus 12 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

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 enioy 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: