Migrating PCS 7 Multiprojects Across Major Releases: WinCC Project Migrator and Convert Project Data
When migrating a SIMATIC PCS 7 multiproject from V7.0 SP3 / V7.1 SP4 through V8.0 SP2 to V8.1 SP1, the WinCC Project Migrator does not trigger automatically between V8.0 and V8.1 because both versions share the same core Microsoft SQL Server database structure. To update graphic pictures, custom C-scripts, and faceplates in WinCC V7.3 (PCS 7 V8.1), you must open WinCC Explorer and manually execute 'Tools > Convert Project Data', selecting 'Pictures and Faceplates' and 'Global Script' with language set to English (USA). Additionally, legacy faceplate calls such as PCS7_openfaceplate must be updated to APL_OpenFaceplate.
Table of Contents
- Executive Summary
- Multi-Version Migration Architecture: V7.0 to V8.1 SP1
- Why WinCC Project Migrator Skips Between V8.0 and V8.1
- Legacy Faceplate Scripting and APL API Changes
- Migration Matrix and Database Evolution Across PCS 7 Releases
- Step-by-Step Multiproject Migration Procedure
- Verification
- Limitations and Operational Precautions
- Engineer FAQ
- Technical References
- Related Articles
- Related Tags
Executive Summary
Migrating legacy SIMATIC PCS 7 systems across multiple major releases—such as upgrading from PCS 7 V7.0 SP3 or V7.1 SP4 to V8.1 SP1—requires a structured, intermediate migration path to preserve engineering data, CFC charts, OS projects, and custom scripts. While transitioning from V7.x to V8.0 triggers the automatic WinCC Project Migrator to convert the Microsoft SQL Server database schema, moving from V8.0 SP2 to V8.1 SP1 often bypasses the migrator. This behavior leaves graphics files, faceplates, and project functions (.fct) unconverted, resulting in runtime script failures when opening faceplates. This article details the database transition mechanics, explains why automatic migration is bypassed, and outlines the mandatory manual conversion steps.
Multi-Version Migration Architecture: V7.0 to V8.1 SP1
Siemens PCS 7 migration rules do not permit direct project opening across multiple major generations without intermediate conversion stages. Upgrading an installed plant from V7.0 SP3 to V8.1 SP1 requires two intermediate steps:
- Stage 1: V7.0 SP3 to V7.1 SP4: Updates basic library blocks, STEP 7 database formats, and WinCC V6.2 to V7.0 SP3.
- Stage 2: V7.1 SP4 to V8.0 SP2: Converts classic engineering data to support the Advanced Process Library (APL) and migrates WinCC database formats from SQL Server 2005 to SQL Server 2008 R2.
- Stage 3: V8.0 SP2 to V8.1 SP1: Introduces WinCC V7.3 (SQL Server 2014) and modernized APL faceplate structures.
Why WinCC Project Migrator Skips Between V8.0 and V8.1
The WinCC Project Migrator is designed to execute only when the underlying WinCC database table schema versions differ fundamentally. In WinCC V7.2 (PCS 7 V8.0 SP2) and WinCC V7.3 (PCS 7 V8.1 SP1), the core configuration database structure (*.mdf / *.ldf) is backward compatible, leading the Migrator tool to report that the project 'does not require migration'.
However, internal graphic object structures (*.pdl), faceplate types (*.fpt), and compiled C-scripts (Global Script) require recompilation against the V7.3 graphics engine. When the automated migrator does not trigger, these files remain in their legacy binary format, causing runtime script crashes and rendering errors.
Legacy Faceplate Scripting and APL API Changes
A common failure during V7.x to V8.x migration is the breakdown of custom project functions and navigation buttons. In classic PCS 7 libraries, opening a faceplate relied on internal C-functions such as PCS7_openfaceplate(...) or direct calls to the Faceplate Designer (@screen).
In PCS 7 V8.1, the APL utilizes APL_OpenFaceplate(...) and standardized tag prefixing mechanisms (@PCS7_ prefix). Custom scripts that call obsolete V7 functions fail to compile or throw access violation errors in runtime. Engineers must run the OS Project Editor and update project-specific script calls to match the modernized APL calling conventions.
Migration Matrix and Database Evolution Across PCS 7 Releases
The following table details the intermediate software platforms, underlying database versions, and required migration actions:
Step-by-Step Multiproject Migration Procedure
Method 1: Converting Graphic Pictures and Global Scripts in WinCC V7.3
- Open the migrated OS project in WinCC Explorer on the PCS 7 V8.1 SP1 Engineering Station.
- Navigate to the menu bar and select Tools > Convert Project Data.
- In the conversion dialog, select the checkboxes for Pictures and Faceplates and Global Script.
- In the language selection drop-down, select English (USA) regardless of the target runtime language.
- Click OK and allow the batch conversion tool to recompile all
.pdl,.fpt, and.fctfiles.
Method 2: Running the OS Project Editor and Updating Block Icons
- In WinCC Explorer, double-click OS Project Editor.
- Under the Complete configuration tab, select the appropriate monitor resolution and layout.
- Click OK to regenerate standard system pictures (
@screen.pdl,@overview1.pdl,@alarmline.pdl). - In SIMATIC Manager, select the OS project and choose Options > Plant Hierarchy > Create/Update Block Icons.
- Perform a full compilation of the OS and test runtime activation.
Verification
To verify successful project migration and script compatibility:
- Script Syntax Check: In WinCC Explorer, open Global Script > C-Editor. Select Options > Compile All Scripts and confirm 0 compilation errors.
- Faceplate Activation: Activate WinCC Runtime. Click on multiple technological block icons (e.g., valves, motors, PID controllers). Confirm that standard and custom faceplates open immediately without script errors.
- Diagnostic Log Review: Open the diagnostic folder
C:\Program Files (x86)\Siemens\WinCC\Diagnostics\and inspectWinCC_Sys_01.logandPDLCS.log. Verify that noCall of undefined functionorSQL Errorentries appear.
Limitations and Operational Precautions
- Language Selection in Conversion: When running 'Convert Project Data', always select English (USA). Running conversion with a non-English language setting can cause corrupted static text strings in multilingual projects.
- Direct Migration Prohibition: Never attempt to open a PCS 7 V7.0 project directly in PCS 7 V8.1. Doing so permanently corrupts the internal cross-reference and CFC database structures.
- Backup Discipline: Create an uncompressed archive (
.zip) of the multiproject at each intermediate milestone before proceeding to the subsequent version hop.
Engineer FAQ
Why does WinCC Project Migrator state that my V8.0 project does not need migration in V8.1?
Because WinCC V7.2 and V7.3 share compatible SQL Server database tables. The Migrator updates SQL schemas, not picture binary formats, which requires the manual 'Convert Project Data' utility.
Can I migrate a PCS 7 multiproject with customized C-scripts without rewriting code?
Standard C-scripts migrate successfully, but scripts that invoke internal, undocumented Siemens faceplate APIs (such as PCS7_openfaceplate) must be adapted to modern APL functions.
Is it necessary to compile AS connections after upgrading to V8.1 SP1?
Yes. Upgrading WinCC drivers requires compiling the OS with the 'Tags and Messages' and 'SFC Visualization' options selected to rebuild communication mappings.
Technical References
- Siemens Industry Online Support Entry ID 109485962: Software update without utilization of new functions (PCS 7 V8.0 to V8.1)
- Siemens Industry Online Support Entry ID 39863898: Guide for PCS 7 Migration (V7.0 to V8.x)
- Siemens AG: SIMATIC Process Control System PCS 7 Engineering System Manual (Doc No. A5E34988772)
Related Articles
- https://industrialautomation.net/search?query=pcs7+multiproject+migration+procedure
- https://industrialautomation.net/search?query=wincc+convert+project+data+tools
- https://industrialautomation.net/search?query=apl+faceplate+scripting+api+changes
Related Tags
- https://industrialautomation.net/search?query=simatic-pcs7
- https://industrialautomation.net/search?query=migration
- https://industrialautomation.net/search?query=wincc
- https://industrialautomation.net/search?query=os-project-editor