Errors and Troubleshooting
WebMAP: WinForms to Web is a tool designed to convert .NET Framework apps based on C# and Windows Forms to a modern web architecture. WebMAP WinForms Errors and Troubleshooting documentation.
Handling and fixing errors is important in order to have a better conversion performance and output compilation. Because of that, the most common errors will be detailed here for your information. In case the error you're experiencing is not listed here, please contact [email protected].
When a conversion is finished the log folder generated will contain the following:
- ConversionLog: general messages of the conversion process used to inform about the internal steps of the tool.
- ErrorLog: in case of an error, the errorLog file will be generated containing a summary of what went wrong.
The message of the logs is divided into four categories:
Information: messages detailing the steps of the conversion and are not considered errors.
Warning: we are confident the code as a whole was converted and will compile, however, some steps of conversion encountered some minor problems.
Error: an error indicates that an entire object could not be converted due to problems such as pending support for the object or original code not processed.
Critical: critical errors translate to WebMAP: WinForms to Web stopping the conversion and leading you to the log folder. Some examples of cases where this would happen are missing dependencies, requirements, or corrupt files of either the conversion tool or the input solution.
These are errors that would affect the conversion process, that is, if they are found, they would completely stop the operation of the application and then show an error on the screen.
While running the conversion of the original code an error may pop and display the following screen:
The cause of the error may vary but the likelihood is that WebMAP couldn't read or process a critical file in the input solution. For this reason, the first action to take is to open the input solution and make sure it can compile.
If you find the error "Critical: MSBuild error NETSDK1004" in the errorLog.log followed by:
To so solve the problem, make sure the input solution can be compiled in the same machine where WebMAP: WinForms to Web is located.
The error WFMAP0013 and WFMAP0048 are causes for this to occur and thus you should check the validity of the projects indicated in the message. For the WFMAP0054 error please insert a shorter path.
WebMAP: WinForm to Web requires some resources obtained via the internet, please check your connection if any of the following errors:
This error occurs when the configuration XML file called webmap.config has an invalid segment, the most common reason for this to happen is that the <API_KEY> was badly set, to fix it follow these steps.
The error.log will show a similar error indicating the line of the file with the problem:
If the configuration file was added as part of the optional settings and the following error appears, it is caused for specifying a bad set of packages resulting in missed dependencies or the tool not connecting to the necessary source.
These types of errors are related to unexpected malfunctions of the tools such as the corruption of the installation folder, the procedure to correct them is to reinstall the application. If this happens, WebMAP will write in the logs the following errors:
This section is related to errors that might affect the output code during the conversion of the solution, the effect of this error goes from not converting property of a class to not generate entire parts of the code.
Conversion issues may arise while executing the output application and manual work might be needed, the most common causes are WebMAP no having implemented a certain WinForms component or for the solution having a very particular implementation related to the business needs of the client. Please contact [email protected] to assist you.
To address these problems WebMAP: WinForms to Web has the stub generation mechanism that consists of generating an empty template for every component not implement with the intention of avoiding compilation error and the output code could compile and run.
All stubs will be located inside the project Stubs in the converted app.
The generation of the stub itself in rear occasions might fail and it will display some of the following errors:
The following errors are related to specific parts of the solution and in most cases, they will need assistance to ensure the full conversion of the input code to WebMAP: WinForms to Web.
Conversion of the C# classes:
Conversion of the Forms to Angular components:
As has been mentioned previously in this article, please reach out to us if you need more support. Mobilize.Net wants to be your partner in the conversion process, so let us know how we can help. You can email us at [email protected] or post a message to our forums. If you have a contract for support with Mobilize.Net, reach out to your sales engineer and they can direct your support needs.