Common Issues

Below are common problems you may encounter while using Process Vision and their solutions.

Application Won't Start

Symptom: Nothing happens when double-clicking the shortcut, or an error message appears.

Possible causes and solutions:

1. .NET Runtime not installed

   • Verify that .NET 8 Desktop Runtime is installed.
   • Contact your system administrator for the installer if needed.

2. Insufficient permissions

   • Right-click the application shortcut and select "Run as administrator".

3. Corrupted configuration file

   • Delete the deviceconfig.json file in the application data folder to allow the application to start with default settings.

UI Is Frozen / Not Responding

Symptom: The screen stops updating and buttons do not respond to clicks.

Possible causes and solutions:

1. Controller communication timeout

   • Check whether the controllers are properly connected.
   • The system may briefly freeze while waiting for a response from an offline controller.

2. Insufficient system resources

   • Close unnecessary programs to free up memory.
   • Check whether CPU usage is abnormally high.

3. Force close

   • If the application is completely unresponsive, use Task Manager to end the process, then restart.

Data Not Being Recorded

Symptom: No data files found after a process ends, or data files are empty.

Possible causes and solutions:

1. Storage path does not exist

   • Open "Device Configuration > General" and verify the database path exists and is writable.

2. Insufficient disk space

   • Ensure there is enough free space on the storage drive.

3. Process did not start properly

   • Confirm that the process state actually changed from Idle to Running.
   • Check for error messages in the status bar.

Video Recording Not Working

Symptom: No video preview during a process, or no video files are produced.

Possible causes and solutions:

1. Capture device not detected

   • Verify the capture card is properly connected.
   • Open "Device Configuration > Video" and click "Refresh" to re-detect devices.
   • Check Windows Device Manager to ensure the capture device is functioning normally.

2. Driver issues

   • Reinstall the capture card driver.

3. Output path issues

   • Verify the video output path exists and is writable.
   • Ensure the target drive has sufficient space.

4. Auto-record not enabled

   • Verify "Device Configuration > Video > Auto Record" is enabled.

License Issues

Symptom: License-related errors or prompts appear at startup.

Solution:

• Contact your system administrator for valid license information.
• Verify that the computer's hardware configuration has not changed significantly (e.g., motherboard replacement).

Exported Data Shows Garbled Characters

Symptom: CSV files display garbled characters when opened in Excel.

Solution:

• CSV files use UTF-8 encoding. When opening in Excel, use "Data > From Text/CSV" and specify UTF-8 encoding.
• Alternatively, use the "Export Excel" function to export as .xlsx format, which does not have encoding issues.