Overview
Operator-driven parameter changes (for example, adjusting a pump's speed setpoint directly from a process overview) are a common requirement in WinCC v11 SCADA projects. The standard approach is to overlay a temporary pop-up screen on top of the active process screen when the operator clicks the equipment symbol, then dismiss the pop-up after the change is acknowledged or canceled. WinCC v11 (part of the TIA Portal engineering framework) provides three viable mechanisms for pop-up screens, each tied to a specific WinCC runtime edition and a specific graphical object model.
This reference covers the three production methods, the HMI tag wiring required to drive them, the differences between WinCC Professional Runtime and WinCC Advanced Runtime, and field-proven verification steps. It targets WinCC V11 SP2 Update 5 (the last V11 maintenance release) and the matching TIA Portal V11 SP2 Update 5 engineering environment; later TIA Portal V13/V15/V16/V17 versions keep the same object model and the same screen-window API, so the configuration is forward-compatible.
Prerequisites
- Installed: TIA Portal V11 SP2 with WinCC Professional or WinCC Advanced, build 11.0 SP2 Update 5 or later. See the SIMATIC TIA Portal V11 SP2 Update 5 readme for installation prerequisites.
- A configured HMI device (Comfort Panel, WinCC Runtime Advanced, or WinCC Runtime Professional) with an active HMI connection to the PLC.
- A PLC tag (for example,
Pump1_Speed_SPREAL) bound to the HMI via the project's HMI tag table. - A process screen containing the pump symbol that will act as the click trigger.
- An HMI-side Boolean tag (for example,
Pump1_Popup_Vis) of internal HMI scope, used to drive the pop-up visibility without disturbing the PLC scan.
190001 - Object is not supported in the current runtime.Runtime Edition Comparison
The two runtime editions bundled with TIA Portal V11 ship with different graphical object sets. The pop-up method must be selected accordingly.
| Feature | WinCC Runtime Advanced | WinCC Runtime Professional |
|---|---|---|
| Screen Window object | Not available | Available |
| Faceplate with visibility property | Available | Available |
| Group visibility animation | Available (per object) | Available (per group) |
| Direct screen change on click | Available | Available |
| Modal pop-up dialog | Via faceplate instance | Via Screen Window + modal flag |
| Typical panel targets | Comfort Panel TP700–TP2200, WinCC RT Advanced | WinCC RT Professional (PC-based) |
Reference: SIMATIC HMI WinCC V11 - Differences between WinCC Runtime Advanced and WinCC Runtime Professional (entry ID 48653336).
Method 1 — Screen Window (WinCC Runtime Professional)
The Screen Window object is the cleanest method for WinCC Runtime Professional. The screen window is a frame placed on the process screen; its Screen Name property is bound to an HMI string tag. Setting the tag to a target screen name displays the pop-up; setting it to an empty string closes the pop-up.
Configuration steps
- Create a new screen named
Pump1_Speed_Popupin the HMI project. Add an I/O field bound toPump1_Speed_SP, an OK button, and a Cancel button. - On the process screen, insert a Screen Window object from the toolbox (palette: Controls > Windows).
- Resize the screen window to match the pop-up dimensions and position it over the pump symbol.
- In the screen window properties, open Properties > General > Screen Name and bind it to an HMI string tag
Pump1_Popup_Screen. - Bind Properties > Display > Visible to the same string tag using a script:
Visible = (Len(Pump1_Popup_Screen) > 0), or use the visibility animation with a comparator. - On the pump symbol, configure the Click event: set
Pump1_Popup_Screen = "Pump1_Speed_Popup". - On the OK button of the pop-up: write the I/O field value to
Pump1_Speed_SPand setPump1_Popup_Screen = "". - On the Cancel button: set
Pump1_Popup_Screen = "".
For full object documentation, see the SIMATIC HMI WinCC V11 - Working with Screen Windows manual (entry ID 40263542) and the WinCC V11 Screen Window help topic.
Method 2 — Faceplate (WinCC Runtime Advanced)
WinCC Runtime Advanced does not include the Screen Window object. The recommended approach is a faceplate with a configurable visibility property. A faceplate is a reusable screen object created once in the faceplate editor and instanced on the process screen with tag interface properties.
Configuration steps
- In the project tree, right-click HMI Tags > Faceplates and create a new faceplate named
PumpSpeedPopup.fpt. - Inside the faceplate, add a numeric I/O field linked to a faceplate tag
Speed_SP(type REAL), an OK button, and a Cancel button. - Expose
Speed_SP,Visible(BOOL), andResult(BOOL) as faceplate interface tags. MapSpeed_SPto the PLC tagPump1_Speed_SPat instance level. - Add the faceplate instance to the process screen. Set its Visible property to
FALSEat startup. - On the pump symbol Click event: set the faceplate's Visible property to
TRUEvia a tag connection on the instance interface. - On the OK button: write the local value back to
Speed_SP(which propagates to the PLC tag), set Result = TRUE, set Visible = FALSE. - On the Cancel button: set Result = FALSE and Visible = FALSE.
For object documentation, see the SIMATIC HMI WinCC V11 - Faceplates manual (entry ID 40628066) and the TIA Portal V11 SP2 Update 5 readme.
Method 3 — Group Visibility Animation (Both Runtimes)
The simplest, runtime-agnostic method uses a group of objects on the same screen, with the visibility of each object driven by an HMI tag. The group has no inherent visibility property; the individual member objects are animated.
Configuration steps
- On the process screen, draw the pop-up rectangle, label, I/O field, and buttons. Select all pop-up objects and group them with Format > Group.
- For every object inside the group, open Properties > Animations > Visibility and bind it to the HMI tag
Pump1_Popup_Vis(BOOL). Configure: Tag value = 0 → Invisible; Tag value = 1 → Visible. - On the pump symbol Click event: set
Pump1_Popup_Vis = TRUE. - On the OK button Click: write the speed to
Pump1_Speed_SPand setPump1_Popup_Vis = FALSE. - On the Cancel button Click: set
Pump1_Popup_Vis = FALSE.
HMI Tag Wiring
All three methods rely on HMI-side tags. Use the following table as a starting template; rename tags to match your project's naming convention.
| Tag name | PLC connection | HMI scope | Data type | Use |
|---|---|---|---|---|
Pump1_Speed_SP |
Yes (PLC tag) | PLC | REAL | Pump speed setpoint written by pop-up I/O field |
Pump1_Popup_Vis |
No | Internal HMI | BOOL | Drives visibility animation (group method) |
Pump1_Popup_Screen |
No | Internal HMI | STRING[20] | Drives Screen Window display (Professional method) |
Pump1_FP_Visible |
No | Internal HMI | BOOL | Drives faceplate instance visibility (Advanced method) |
Pump1_Popup_Result |
No | Internal HMI | BOOL | Optional - tracks whether pop-up closed via OK (1) or Cancel (0) |
Tags marked Internal HMI are not synchronized to the PLC and incur zero PLC scan load. Tag configuration procedure: open HMI Tags in the project tree, double-click the table, add a new entry, set Connection to <Internal tag>, and set the data type. See SIMATIC HMI WinCC V11 - Configuring HMI Tags.
Event Script for Click Trigger (VBScript)
The click event on the pump symbol can use a VBScript function. In the property view, Events > Click, add a VBScript action:
' Pump1_Pump_Click - show pop-up
If SmartTags("Pump1_Popup_Vis") = False Then
SmartTags("Pump1_Popup_Vis") = True
SmartTags("Pump1_Popup_Screen") = "Pump1_Speed_Popup"
End If
The pop-up dismiss button uses:
' Pump1_Popup_OK_Click
SmartTags("Pump1_Speed_SP") = CDbl(SmartTags("Pump1_Popup_Value"))
SmartTags("Pump1_Popup_Result") = True
SmartTags("Pump1_Popup_Vis") = False
SmartTags("Pump1_Popup_Screen") = ""
VBScript reference: SIMATIC HMI WinCC V11 - VBScript reference.
Verification Procedure
-
Compile check: In TIA Portal, right-click the HMI device and choose Compile > Software (rebuild all). Resolve every entry in the Messages pane. Common error
190001indicates an object not supported by the selected runtime — verify the runtime edition in the HMI device properties. - Tag consistency: Right-click the HMI tag table and choose Check consistency. Confirm every internal HMI tag exists and is typed correctly.
- Simulation: Use the Start simulation toolbar button (WinCC Runtime Professional only) or transfer the project to a Comfort Panel and use the Online > Watch & force tool to force the popup tag on.
- Click test: Click the pump symbol. The pop-up must appear above the process graphic and acquire focus. Type a new speed setpoint and press OK. The pop-up must close and the value at the PLC must update — verify with a watch table or HMI tag monitoring.
- Cancel test: Click the pump symbol, type a new value, press Cancel. The pop-up must close and the PLC value must remain unchanged.
- Multiple-instance test: Duplicate the pop-up pattern for a second pump and verify that the two pop-up tags are independent (a click on Pump 2 must not toggle Pump 1's pop-up).
Troubleshooting Matrix
| Symptom | Likely cause | Resolution |
|---|---|---|
| Compile error 190001 Object is not supported in the current runtime | Screen Window used on Advanced runtime, or faceplate compiled against Professional target | Switch object family to match the runtime, or change the HMI device's runtime edition |
| Click does nothing on the pump symbol | Click event has no configured action, or the event is disabled by the security configuration | Verify Properties > Events > Click has a function, and that the user group permits the action |
| Pop-up appears but does not dismiss | OK/Cancel buttons do not write the visibility tag, or they write the wrong tag | Verify the buttons' VBScript actions reference the correct tag name; check with the HMI tag monitor |
| Speed setpoint does not reach the PLC | Tag connection is read-only, or the PLC connection is offline | Open HMI Connections and check the connection status; verify the tag's Access is Read/Write |
| Pop-up flashes briefly on screen change | Internal HMI tag retains value across screen changes because it is not reset on screen unload | Add a reset on the Loaded event of the process screen, or use the screen-window string tag (which is naturally empty at load) |
| Faceplate does not display on WinCC Advanced | Faceplate visibility interface tag is not connected at the instance | Open the faceplate instance properties and bind the Visible interface property to the HMI tag |
| Group visibility animation has no effect on Advanced | Animation applied at the group level, not per object | Open each child object and apply the visibility animation individually |
Field-Commissioning Notes
- For operator permissions, attach the click event to a user-group check. In the security settings of the HMI device, add the popup-triggering action to the Operator group, and the OK-button write to the Engineer group. The pump click will then be allowed for operators, but the value commit will require an engineer login. See SIMATIC HMI WinCC V11 - User Administration.
- For audit trail compliance (21 CFR Part 11 style), enable the Audit Trail option in the HMI runtime settings; the speed setpoint change via the OK button will be logged with operator, timestamp, old value, and new value.
- For modal behavior (block the underlying screen while the pop-up is open), use the Modal property of the Screen Window in WinCC Runtime Professional. On Advanced, the modal effect is achieved implicitly because faceplate I/O fields consume focus.
- For multi-language deployments, configure the pop-up screen text via the text list of the HMI project rather than hard-coded labels.
Performance and Resource Notes
Screen Windows in WinCC Runtime Professional are cached after the first instantiation and reused on subsequent calls; switching the screen name triggers a frame buffer redraw. The group-visibility method is the cheapest at runtime but the most verbose at engineering time. Faceplates scale best across many similar pop-ups because the faceplate body is compiled once and instanced per pump — a 10-pump overview screen with a pop-up per pump costs roughly the same as a 1-pump project in faceplate mode, but grows linearly in object count for the group method.
For Comfort Panel targets, prefer the faceplate method; Comfort Panel firmware versions V11.0.2.0 and later include the faceplate visibility property. The exact firmware matrix is published in the TIA Portal V11 SP2 Update 5 readme.
FAQ
Which WinCC runtime edition do I need to use the Screen Window pop-up method?
Screen Window is exclusive to WinCC Runtime Professional and the matching TIA Portal V11/V13/V15/V16/V17 engineering environments. WinCC Runtime Advanced panels and PC runtime do not include the Screen Window object — use a faceplate with a visibility property instead.
Can I toggle the visibility of an entire group at once in WinCC Runtime Advanced?
No. WinCC Runtime Advanced supports visibility animations only on individual objects, not on groups as a whole. You must apply the visibility animation to every member of the group, bound to the same HMI tag, to get a synchronized show/hide effect.
What HMI tag type should I use to control the pop-up visibility?
Use a BOOL internal HMI tag (for example, Pump1_Popup_Vis) for group and faceplate visibility, and a STRING internal HMI tag for Screen Window screen name binding. Internal HMI tags are local to the panel/PC and do not consume PLC scan time.
Why does the pop-up appear but the speed setpoint does not write to the PLC?
Most often the HMI tag connection is read-only, or the OK button's VBScript writes to the wrong tag. Open the HMI tag table, confirm the Access column is Read/Write, and verify the OK button script references the correct tag name with the same spelling and case as the HMI tag table.
Is the same pop-up pattern available in newer TIA Portal versions (V13/V15/V17)?
Yes. The Screen Window, faceplate, and group-visibility methods all carry forward into TIA Portal V13, V15, V16, and V17 with the same object model. The V11 SP2 Update 5 configuration transfers cleanly via TIA Portal project upgrade, with no rework required for the pop-up itself.