Frequently Asked Questions & Support (FAQ & Support)

I. General Questions

• Q: What should I do if the plugin cannot be installed?
  A: Please confirm that your IDE version meets the plugin's minimum requirements (e.g., VS Code ≥ 1.82). If it still fails, try:

  • Restart the IDE and retry installation
  • Manually download the .vsix file for offline installation
  • Check network proxy or corporate firewall settings

• Q: What causes login failures?
  A: Possible reasons include:

  • Network connection异常 (unable to access authentication services)
  • Incorrect account password or inactive account
  • Large deviation between local time and server time (affects Token verification)

  Please check your network, credentials, and ensure system time accuracy sequentially.

• Q: The plugin runs slowly or lags?
  A: It is recommended to:

  • Reduce the AI response concurrency in the plugin settings
  • Close unnecessary background plugins to free up resources If the problem persists, please provide log files for analysis.

II. Database-Related Questions

• Q: The database or workflow page opens, but no data loads?
  A: Please troubleshoot step by step:

  1. Confirm JDK Version
     Ensure you are using JDK versions between JDK 8 and JDK 17 (JDK 21+ non-LTS versions are not supported).
  2. Check Configuration File
     Verify if the database connection information (URL, username, password, driver class) in vjspai-link.yml is correct.
  3. Verify File Location
     vjspai-link.yml must be located in the project root directory (at the same level as pom.xml), otherwise it cannot be loaded during startup.
  4. Check Startup Logs
     Check the console for errors like Connection refused, ClassNotFoundException, etc.

  If the configuration is correct but still no data, confirm whether the backend interface returns an empty result set, or contact technical support.

• Q: There is no "Edit Form" option in the right-click menu?
  A: Please confirm:

  • The VJSP plugin is successfully installed and enabled
  • The currently selected file is an .html file (only VJSP standard form formats are supported)

• Q: Code is not updated after saving?
  A: Possible reasons:

  • The file is locked by another program (e.g., Git, antivirus software)
  • The file is in read-only state Solution: Close and reopen the file, or manually refresh the explorer.

• Q: Are custom controls supported?
  A: Yes. You can register custom component templates via vjsp.config.js to implement personalized UI elements.

---

III. Workflow-Related Questions

• Q: Clicking "Workflow" displays a blank page?
  A: Please confirm:

  • Valid process definition files exist in the project (e.g., workflow.json, process.yaml, or Java classes with @Workflow annotations)
  • The database connection configuration is correct (some processes rely on metadata storage)
  • For new projects, you can first generate an initial process template via AI

• Q: Node information is displayed incompletely?
  A: Please ensure:

  • Relevant configuration files or Java classes have been saved
  • For dynamic processes (e.g., generated at runtime), the workflow view needs to be refreshed after the application starts

• Q: Can I edit the workflow directly on the diagram?
  A: The current version only supports read-only viewing and interaction. Drag-and-drop modeling, condition editing, and other capabilities will be available in future versions. Stay tuned.

IV. Self-Help Troubleshooting Guide

If you encounter issues not listed, please troubleshoot in the following order:

1. ✅ Confirm Compatibility

   • Plugin version matches the IDE version
   • Operating system meets minimum requirements (Windows 10+/macOS 12+)

2. 🌐 Check Network Environment

   • Can you normally access internal services like the VJSP website
   • Whether the corporate network intercepts WebSocket or HTTPS requests

3. 🔒 Eliminate Security Software Interference

   • Temporarily disable firewall or antivirus software for testing
   • Add the IDE and plugin directories to the whitelist

4. 🧩 Check for Plugin Conflicts

   • Disable other AI/database-related plugins and retry

5. 📄 Check Detailed Logs

   • Logs are key for locating issues (see below)

How to View Logs

Plugin logs are stored by default in the following paths:

System	Log Path
Windows	%USERPROFILE%\.vjsp\logs\
macOS	~/Library/Logs/VJSP/

You can access logs through:

• Clicking "Open Log Directory" in the plugin settings interface
• Selecting the "VJSP" channel in the IDE output panel for real-time viewing
• Using terminal commands (e.g., tail -f ~/.vjsp/logs/vjsp.log)

---

V. Contact Us

If the problem remains unresolved, please feel free to contact the VJSP technical support team:

• 📧 Email: support@vjsp.cn
• 🕒 Service Hours: Weekdays 9:00–18:00 (excluding holidays)
• 📎 When submitting an issue, please include:
  • IDE type and version
  • Plugin version number
  • Relevant log snippets (after desensitization)
  • Screenshots or reproduction steps

We will assist you as soon as possible!