Editing OptFlux3:Serialization

{{DISPLAYTITLE: Serialization Plugin}}
__TOC__
=Purpose=
Since the release of OptFlux 3.3.0 the workspace of previous version became deprecated and are not loaded by this or recent versions.<br>
The '''Serialization Plugin''' was developed for the OptFlux 3.2 version to garantee the backward compatible of pre-3.3.0 workspaces with newer OptFlux versions.<br>
This plugin can convert most of the workspace items that OptFlux v3.2 can generate. (Check [[OptFlux3:Serialization:NonBackwardCompatible|not backward compatible items]])
*Backup the workspace before performing the conversion.

=Installation=

Before installing the 3.3.0 version, there are two ways to have the Serialization4OptFlux plugin. 

===3.2.10===
Install the 3.2.10 version if you don't want to perform updates on your current version of OptFlux.
<br>In this version all the plugins, along with the Serialization4OptFlux, will already be installed.
* Download link [https://sourceforge.net/projects/optflux/files/History/3.2.10/Installers/ here]. At the moment there is no MacOS version.

===3.2.7===

Install the 3.2.7 version of OptFlux and perform all updates, the Serialization4OptFlux plugin can be installed through the repository manager operation.
*You can access the '''Repository''' option under the '''Help -> Repository Manager''' menu.<br>
*See also [[KnownProblems:RepositoryManager|Problem with Repository Manager in 3.2 versions]]

[[Image:PluginManager2.jpg|800px]]


After the restart check if the plugin is installed by opening the '''Repository Manager'''.<br>

*'''Special Case:''' Sometimes some plugins may be disabled which results in a disabled '''Serialization Plugin'''. If that happens make sure all plugins are enabled.

[[Image:PluginManager4.png|800px]]


If all the plugins are installed and enabled the '''Serialization Plugin''' will also be enabled and the '''Repository Manager''' will be present like the following image

[[Image:PluginManager5.jpg|800px]]

=How to Use=

==Convert Workspace==
Clipboard must have at least one project to enable operation.<br>
*Projects can be either open or closed.
[[Image:Serialization1.jpg|800px]]

Select '''File -> Workspace -> Convert Workspace...'''

<br>The '''Convert Workspace''' window will be present.<br>
Select a folder that will be the workspace folder for the '''OptFlux v3.3 or newer'''.
*Folder must be empty.
[[Image:Serialization2.jpg|800px]]

<br>If everything went as expected the converter will present a successful message similar to the following image.

[[Image:Serialization3.jpg|550px]]

==Special cases==
Since there are some items that are [[OptFlux3:Serialization:NonBackwardCompatible|not backward compatible]] the converter will not present the previous successfull message.<br>
For that cases a message similar to the following image is present.<br>
*In this particular case the TNA items were not successfull converted.
[[Image:SerializationExtra.jpg|800px]]

==Workspace after conversion==
After a successfull conversion the new workspace will only be loaded by OptFlux v3.3 or newer and it will be similar to the original workspace.
*The following image represents the converted workspace loaded by the '''OptFlux 3.3.0''' version.
[[Image:SerializationFinal.jpg|800px]]