TIA Portal V17 Update 4: Fixing Browse Button and Save As Crash

David Krause10 min read
SiemensTIA PortalTroubleshooting
Licensed PE Working through this on a live machine? A Maine-licensed engineer can take it from here — included with IMD hardware, by the hour for everything else. Book an engineer

Overview

Engineers running TIA Portal V17 Update 4 on Windows 10/11 workstations report that the engineering framework terminates unexpectedly when invoking the Browse file dialog (folder picker) or executing Save As on a project. The crash is silent: no Siemens error dialog appears, no APLog.xml is generated at the expected location, and the Windows event log records only a generic application fault. This document consolidates the field-verified root cause, the underlying registry/option path that triggers the failure, and the complete set of workarounds that restore stable operation without requiring administrative change to the company domain.

Engineering impact: The crash destroys the in-progress Save As metadata transaction. Any project rename attempted via the dialog is lost, and the source project may be left in a half-renamed state on disk if the crash occurs after the framework has issued the rename system call but before commit. Always keep a .zap17 backup under version control before performing rename operations.

Symptoms and Error Conditions

Symptom Trigger Frequency Log Evidence
Process terminates while Browse dialog opens Clicking the folder icon next to any path field (project location, library path, HMI source path) Reproducible on affected installations Windows Application Error 1000; no Siemens AP log
Process terminates on Save As File → Save As → selecting destination Intermittent to consistent Same as above
Process terminates on project close after Save As attempt Window close while rename transaction is open Sporadic *.ap17 project fragment left in original folder
No Siemens "Tia encountered a problem and needs to close" dialog All crash scenarios Always Dialog suppressed by V17 U4 build under specific option combinations

The absence of a Siemens-branded crash dialog distinguishes this failure mode from generic TIA Portal faults and is a reliable diagnostic fingerprint. A standard Application Error event is written to Windows Event Viewer → Windows Logs → Application with Event ID 1000 and the faulting module named S7WsiF.dll or Siemens.Automation.Portal.exe depending on the call stack.

Root Cause Analysis

The fault is reproducible only when the framework attempts to populate the Recently Used Storage Location list during file system enumeration. Specifically, the option is located at:

Menu path: Options → Settings → General → Storage settings → Recently used storage location

When this checkbox is enabled, TIA Portal V17 Update 4 records the absolute path of every project the user opens in the user profile and replays that list whenever a file dialog is constructed. If any entry in the persisted list refers to a path that no longer exists — for example, a network share that has been unmounted, a redirected %USERPROFILE%\Documents folder that has been remapped by Group Policy, or a folder on a removable drive that has been ejected — the dialog code path performs an unguarded SHParseDisplayName followed by an IFileDialog::SetFolder call. The Windows shell COM object returns E_INVALIDARG or E_FAIL on the missing path, and the TIA Portal wrapper does not catch the resulting System.Runtime.InteropServices.COMException, causing the process to terminate.

The crash is therefore a path validation gap in the recently-used persistence layer and is independent of project content. Opening two projects side by side — one whose last-saved location still exists and one whose last-saved location has been deleted — demonstrates the asymmetry: only the project with the stale path crashes. The list is stored per-project in the project metadata, which explains why the failure tracks with individual .ap17 archives and not with the user profile alone.

Affected Versions and Configuration

Product Version Status
TIA Portal V17 Update 4 (17.4.0) Confirmed affected
TIA Portal V17 Update 3 and earlier Not reported; absence of regression in U4 changelog
STEP 7 Professional V17 Update 4 Affected (shared runtime)
WinCC Professional V17 Update 4 Affected (shared runtime)
PLCSIM V17 Update 4 Not a direct cause; co-installed

The condition is independent of TIA Portal project type — it reproduces on S7-1200/1500 CPU projects, S7-300/400 retrofits, HMI Tag-based projects, and SINAMICS Startdrive topologies. The Windows edition (Windows 10 21H2, 22H2, Windows 11 22H2) is also non-determinative; the failure is in the application layer above the shell version.

Domain-managed profile warning: When the user's My Documents folder is redirected to a UNC path via Group Policy (Folder Redirection) and the network location is intermittently unavailable, the persistence file at %APPDATA%\Siemens\Automation\Portal V17\StorageLocations.xml is created but the resolved UNC path is captured at write time. On the next dialog open, TIA Portal attempts to bind to the UNC path which may be offline, and the COM exception is raised.

Step-by-Step Resolution

Workaround A — Disable Recently Used Storage Location (fastest fix)

  1. Open TIA Portal V17 Update 4.
  2. From the menu bar select Options → Settings.
  3. In the left navigation tree, expand General and select Storage settings.
  4. Uncheck the box labelled Recently used storage location.
  5. Click OK to commit. No restart is required.
  6. Test by performing a Save As on a project that previously crashed.

With the option disabled, TIA Portal no longer persists per-project path history, and the Browse dialog uses the Default storage location field as the initial folder. The crash no longer occurs because the stale path list is never queried.

Workaround B — Specify a Valid Default Storage Location

  1. Navigate to Options → Settings → General → Storage settings.
  2. With Recently used storage location disabled, set the Default storage location to a fully qualified local path such as D:\TIA_Projects.
  3. Verify the folder exists, is writable by the current user, and is on an NTFS volume with FILE_TREE_INSERTION_FILE_BUFFER_SIZE-class attributes — in practice any standard local folder is sufficient.
  4. Click OK and test the Save As workflow.

Workaround C — Pin Project Path to a Local Folder (domain-laptop scenario)

Engineers who do not control Group Policy and whose My Documents is redirected to a network share should follow this sequence to neutralise path volatility:

  1. Create a folder at a fixed local path, for example C:\Automation.
  2. Move (do not copy, to avoid dual-path persistence) all active .ap17 archives to C:\Automation.
  3. Open TIA Portal and confirm Options → Settings → General → Storage settings → Default storage location points to C:\Automation.
  4. Disable Recently used storage location (Workaround A).
  5. Open each project directly via File → Open → Project from file system using the new path.
  6. Perform a Save (not Save As) on each project once to re-anchor the in-project path metadata.

Domain Profile Hardening

On corporate laptops where My Documents is redirected via Folder Redirection, the underlying fault becomes more frequent as the share availability fluctuates. The defensive pattern is to keep project storage on local NTFS and back it up with a controlled mirror script rather than relying on the redirected profile.

Robocopy Mirror Script (project-to-backup)

@echo off
REM Mirror local Automation folder to redirected Documents for backup compliance
robocopy "C:\Automation" "%USERPROFILE%\Documents\Automation" /MIR /Z /XA:H /R:3 /W:5 /MT:8 /LOG+:C:\Logs\portal_mirror.log
exit /b 0

Launch Wrapper (backup-after-close)

@echo off
REM Launch TIA Portal and run mirror script after the process exits
start "" /WAIT "C:\Program Files\Siemens\Automation\Portal V17\Bin\Siemens.Automation.Portal.exe"
call "C:\Scripts\portal_mirror.bat"

Place the wrapper on the desktop or taskbar. Every close of the engineering environment is followed by a deterministic mirror to the network share, satisfying corporate backup policy without coupling TIA Portal to share availability at runtime.

Settings Export and Import Workflow

Engineers who manage multiple TIA Portal installations — for example, lab benches, commissioning laptops, and engineering office PCs — benefit from a portable settings file. The export/import flow is the cleanest way to guarantee that the disabled Recently used storage location setting travels with the user.

  1. On a known-good installation, navigate to Options → Settings.
  2. Configure Default storage location to the agreed fixed path (for example D:\TIA_Projects).
  3. Disable Recently used storage location.
  4. Click Export in the lower-left of the settings dialog and save the file as portal_settings.tia17cfg at a network-accessible location.
  5. On each target installation, open TIA Portal, navigate to Options → Settings, and click Import.
  6. After import, manually verify the Default storage location field on the target machine — the importer can leave a path that does not exist on the new host.
Verification step: Always re-check the resolved path after import. The import substitutes the user identifier token in the original path, and on a host with a different %USERNAME% the result may not exist.

Registry and Configuration File Reference

For engineers who script deployment, the relevant registry keys are:

Key Value Effect
HKCU\Software\Siemens\Automation\Portal V17\Settings\UseRecentStorage 0 (DWORD) Disables Recently used storage location
HKCU\Software\Siemens\Automation\Portal V17\Settings\DefaultStoragePath "D:\TIA_Projects" (REG_SZ) Sets default storage location
HKCU\Software\Siemens\Automation\Portal V17\StorageLocations (subtree) Persisted recent paths — delete to clear stale entries

The XML persistence file is located at:

%APPDATA%\Siemens\Automation\Portal V17\StorageLocations.xml

To forcibly clear the corrupted cache after upgrading to a fixed U4 build, close TIA Portal, delete the file above, and reopen. The framework regenerates it on the next dialog close.

Diagnostic Checklist

When the crash recurs after applying the workarounds, run the following verification sequence before opening a Siemens support ticket:

  1. Confirm TIA Portal build: Help → About — should read V17.4.0.x or later cumulative build.
  2. Confirm Windows event log entry: Event ID 1000, faulting module S7WsiF.dll or Siemens.Automation.Portal.exe.
  3. Confirm the Recently used storage location checkbox is cleared.
  4. Confirm Default storage location resolves to an existing, writable local path.
  5. Run Project → Cleanup → Reorganize to clear orphan references inside the .ap17 archive.
  6. Test the Save As on a freshly created throwaway project to isolate the failure from existing project metadata.
  7. If the throwaway project succeeds, the original project has a stale internal path record — extract it with Project → Archive → Retrieve to a new folder, then continue working from the retrieved copy.

Verification Steps

  1. Open TIA Portal V17 Update 4.
  2. Open a previously crashing project.
  3. Invoke File → Save As; the dialog should open without termination.
  4. Click the Browse button next to Path; the folder picker should open and accept selection without termination.
  5. Save the project to a new local path; confirm the .ap17 archive exists at the target and the source remains intact (regression guard for partial rename).
  6. Close and reopen the project from the new path; verify all device and connection data round-trips correctly.

Field-Proven Caveats

  • The crash can resurface if a user re-enables Recently used storage location after the workaround is applied. Communicate the setting change to all engineering team members.
  • Antivirus software that virtualises file I/O on %USERPROFILE%\Documents (notably some endpoint protection products) can also produce E_INVALIDARG at dialog open. Exclude %APPDATA%\Siemens and the project root from real-time scanning.
  • OneDrive's Files On-Demand feature can place %USERPROFILE%\Documents in a state where folders exist as cloud placeholders only; TIA Portal V17 U4 does not handle the cloud placeholder attribute correctly. Move projects to a non-OneDrive-managed path.
  • Some users have reported that the crash correlates with the Automatic save interval. Disabling Options → Settings → General → Automatic save while troubleshooting isolates the failure from the autosave thread.

Related Siemens Documentation

For engineers tracking the underlying product behaviour, the following Siemens knowledge base and manual references are the authoritative starting points:

Frequently Asked Questions

Why does TIA Portal V17 Update 4 crash only on some projects and not others?

The crash is triggered by the per-project Recently used storage location list. Projects whose last-saved path still exists succeed; projects whose last-saved path has been deleted, unmounted, or redirected fail with a COM exception in the file dialog code. The persistence is stored inside the .ap17 archive, not in the user profile.

Is the TIA Portal V17 U4 crash fixed in a later update?

Siemens has not published a public hotfix for this specific failure mode. The reliable resolution is to disable Options → Settings → General → Storage settings → Recently used storage location and set a valid local Default storage location. Always check the latest TIA Portal V17 service pack readme on the Siemens support portal before deploying to production.

Can I keep projects on a network share with this fix?

Not directly during active editing — the dialog code still validates the default storage path. Use a local folder (for example C:\Automation) for live work and mirror the folder to the network share with robocopy after each TIA Portal session close. This pattern is also faster because the engineering tool is not waiting on network round-trips per save.

Does the crash affect Save As only, or all file dialogs?

All file dialogs are affected because they share the same Recently used storage location code path. This includes Open Project, Open Library, Import/Export of PLC tags, and the Browse button on any path field. Disabling the option resolves all of them simultaneously.

What Windows event log entry should I capture for a Siemens support ticket?

Capture Windows Logs → Application Event ID 1000 with the faulting application name Siemens.Automation.Portal.exe and the faulting module name from the Application tab. Include the V17 build number from Help → About and the Windows 10/11 build number from winver. Attach the %APPDATA%\Siemens\Automation\Portal V17\StorageLocations.xml file with personal paths redacted.

Back to blog