Connection Trouble Shooting Guide

INFO

Use this troubleshooting guide to help diagnose connection problems with Klai Studio and your FileMaker server

Start at the Helper File

The helper file is typically your first place to start your debugging. Every hook script call will have a record entry. If it does not, then the issue is happening before the request reaches the FileMaker Server.

Symptom	Solution
No records are created in helper file	- Check credentials in Klai Studio Editor and your helper file. - Check access privileges for Data API or XML. - Ensure a firewall is not blocking FMS access.
Hook runs from helper file, but not from the web	Check the access privileges of the BetterForms user account vs. your admin credentials. A script step you are running may not be supported by the CWP engine. Note that the CWP script engine is not the same as the FMS PSOS script engine.
Klai Studio is slow or unresponsive	- Server Load: Verify the server's load and performance. - Optimize Database Structure: Evaluate your FileMaker database structure and indexes. Poorly optimized databases can lead to slow data retrieval. - Optimize Scripts and Processes: Review any scripts or processes running on Klai Studio. Optimize or streamline them for faster execution. - Monitor Server Logs: Keep an eye on server logs for any errors or issues that could be affecting performance.
Other	- Verify Server Address: Double-check the FileMaker server address you have entered in the Klai Studio application. Make sure it is correct and does not contain any typos. - Firewall and Security Settings: Check if your network's firewall or security settings are blocking the connection. Temporarily disable any firewall or antivirus software and try connecting again. - FileMaker Server Status: Verify that the FileMaker server is up and running. Check if other users can access the server from different devices to confirm its availability. - Check FileMaker Server Configuration: Ensure that the FileMaker server has the correct configuration to allow external access. Verify that the proper ports (e.g., 5003) are open for external connections. - Clear Cache and Cookies: Clear the cache and cookies of your web browser or Klai Studio application. Sometimes, outdated cache data can cause connection issues. - Restart Devices: Reboot your computer, mobile device, and FileMaker server. This can help resolve temporary connection problems.