Common Issues
This page covers the most frequently encountered issues when working with APD and their solutions.
Action Issues
Action Not Found
Symptoms:
- 404 or "Action not found" error
- Blank page
- Redirect to default action
Causes & Solutions:
| Cause | Solution |
|---|---|
| Action code typo | Verify exact action code |
| Action not compiled | Recompile the action |
| Wrong company | Check user's company assignment |
| Action disabled | Enable the action |
Action Returns Blank Page
Symptoms:
- Page loads but content is empty
- No errors shown
Causes & Solutions:
| Cause | Solution |
|---|---|
| Template not set | Assign HTML template |
| Compilation error | Check compilation status |
| All content conditional | Review template conditions |
| Wrong action type | Verify action type setting |
Action Requires Authentication Error
Symptoms:
- Redirected to login when shouldn't be
- "Authentication required" message
Causes & Solutions:
| Cause | Solution |
|---|---|
| Require Authentication = Yes | Set to No if public |
| Session expired | Re-login |
| Cookie issues | Clear browser cookies |
Template Issues
Tags Not Processing
Symptoms:
<?field(Name)?>shows literally- Tags appear as text
Causes & Solutions:
| Cause | Solution |
|---|---|
| Not compiled | Recompile the action |
| Syntax error | Check tag syntax |
Missing ?> closure |
Add closing ?> |
| Wrong tag name | Use correct tag name |
Data Not Displaying
Symptoms:
- Fields show empty
- Loops don't iterate
- Filters return nothing
Causes & Solutions:
| Cause | Solution |
|---|---|
| No open tag | Add <?open(Table)?> |
| Filter too restrictive | Review filter conditions |
| Security filter | Check security setup |
| Wrong field name | Use exact BC field name |
Loop Shows Nothing
Symptoms:
<?loop?>...<?endloop?>produces no output (the<?endloop(TableName)?>form is required — table name argument)- Expected rows missing
Causes & Solutions:
| Cause | Solution |
|---|---|
| No records match | Verify filter criteria |
| Wrong table name | Check exact table name |
| Security filter active | Review user's filters |
| Missing loop end | Add <?endloop(TableName)?> — the table-name argument is required |
Authentication Issues
Can't Log In
Symptoms:
- Login always fails
- "Wrong password" repeated
Causes & Solutions:
| Cause | Solution |
|---|---|
| Wrong username | Verify user exists |
| Wrong password | Reset password |
| User blocked | Unblock user |
| Max attempts exceeded | Reset attempts counter |
| Wrong company | Check company assignment |
Session Expires Too Quickly
Symptoms:
- Frequent re-login required
- "Session expired" messages
Causes & Solutions:
| Cause | Solution |
|---|---|
| Short timeout | Increase session timeout |
| Cookie issues | Check cookie settings |
| Load balancer | Configure session affinity |
User Can't Access Action
Symptoms:
- Redirect to default action
- "Access denied" message
Causes & Solutions:
| Cause | Solution |
|---|---|
| Missing profile | Assign required profile |
| Action security profile | Remove or change requirement |
| Not authenticated | Require login first |
AJAX Issues
APD_Find Returns Nothing
Symptoms:
- JavaScript finds no data
- Empty results array
Causes & Solutions:
| Cause | Solution |
|---|---|
| Wrong table name | Use exact BC table name |
| Filter mismatch | Review filter criteria |
| Table permissions | Enable Allow Ajax Read on the Security Setup entry |
| Security filter | Check user's filters |
APD_Modify Fails
Symptoms:
- Changes don't save
- Error in callback
Causes & Solutions:
| Cause | Solution |
|---|---|
| Validation error | Check field constraints |
| Table permissions | Enable Allow Ajax Validate/Modify on the Security Setup entry |
| Record locked | Wait and retry |
| Missing key fields | Emit each primary-key field as a hidden input (<input type="hidden" name="TableNo:FieldNo" value="...">). <?key?> only builds URL query fragments, not hidden form fields. |
APD_validate Returns Error
Symptoms:
- Validation fails
- Error message returned
Causes & Solutions:
| Cause | Solution |
|---|---|
| Invalid value | Enter valid data |
| BC validation | Check BC field rules |
| Table relation | Use lookup for valid values |
| Required field empty | Provide value |
Security Issues
User Sees Too Much Data
Symptoms:
- User accesses other users' data
- All records visible
Causes & Solutions:
| Cause | Solution |
|---|---|
| No security filter | Add appropriate filters |
| Wrong filter value | Review placeholder usage |
| Profile missing filter | Add filter to profile |
| Navision Identification blank | Set user's mapping |
User Sees Too Little Data
Symptoms:
- Expected data missing
- "No records found"
Causes & Solutions:
| Cause | Solution |
|---|---|
| Filter too restrictive | Broaden filter criteria |
| Wrong Navision Identification | Correct user mapping |
| Multiple filters conflicting | Review all filters |
AJAX Permission Denied
Symptoms:
- JavaScript operations fail
- "Permission denied" errors
Causes & Solutions:
| Cause | Solution |
|---|---|
| Table permissions not set | Add table permission entry |
| Wrong profile | Check profile on permission |
| Operation not allowed | Enable specific operation |
Compilation Issues
Compilation Error
Symptoms:
- Action won't compile
- Error message shown
Causes & Solutions:
| Cause | Solution |
|---|---|
| Syntax error in template | Fix tag syntax |
| Unclosed tag | Add missing closing tag |
| Invalid table name | Use exact BC name |
| Invalid field name | Use exact BC field name |
Compilation Warning
Symptoms:
- Action compiles with warnings
- May work but with issues
Causes & Solutions:
| Cause | Solution |
|---|---|
| Deprecated syntax | Update to current syntax |
| Missing optional elements | Add recommended elements |
| Performance warning | Optimize template |
Performance Issues
Page Loads Slowly
Symptoms:
- Long page load times
- Timeouts
Causes & Solutions:
| Cause | Solution |
|---|---|
| Too many records | Add filters, use pagination |
| Complex calculations | Simplify template |
| Large images | Optimize image sizes |
| Many includes | Consolidate templates |
AJAX Calls Slow
Symptoms:
- JavaScript operations take long
- UI feels unresponsive
Causes & Solutions:
| Cause | Solution |
|---|---|
| Large result sets | Limit fields and records |
| No filters | Add appropriate filters |
| Network latency | Check hosting location |
Content Issues
Content Not Showing
Symptoms:
<?content(code)?>returns nothing- Markdown not rendering
Causes & Solutions:
| Cause | Solution |
|---|---|
| Wrong content code | Verify exact code |
| Content empty | Add content body |
| Security profile | Check content security |
| Wrong format | Use correct content type |
Markdown Not Rendering
Symptoms:
- Raw markdown shows
- Formatting not applied
Causes & Solutions:
| Cause | Solution |
|---|---|
| Not using markdown tag | Use markdown content type |
| Missing processor | Check markdown setup |
Browser Issues
Page Doesn't Work in IE
Symptoms:
- Features broken in Internet Explorer
- JavaScript errors
Causes & Solutions:
| Cause | Solution |
|---|---|
| Modern JS features | Add polyfills |
| CSS not supported | Use compatible styles |
| Consider dropping IE | Encourage modern browsers |
Mobile Display Issues
Symptoms:
- Layout broken on mobile
- Elements overlapping
Causes & Solutions:
| Cause | Solution |
|---|---|
| Not responsive | Add responsive CSS |
| Fixed widths | Use flexible units |
| Small touch targets | Increase button sizes |
Quick Diagnostic Steps
General Troubleshooting
- Check the obvious
- Is the action compiled?
- Is the user logged in?
- Is the user in correct company?
- Check logs
- Review APD logs
- Check browser console
- Review BC event log
- Simplify
- Remove conditions
- Test with minimal template
- Use test user with full access
- Verify setup
- Review action settings
- Check security configuration
- Verify user settings
When to Escalate
Contact support when:
- Issue persists after basic troubleshooting
- Error messages are unclear
- Suspected bug in APD
- Performance issues without obvious cause