Extension Issues

This guide covers issues specific to the ACS extension generation and installation process.

Understanding the Extension

ACS generates a Business Central extension that implements your security rules. Common issues relate to:

• Code generation
• Compilation
• Installation
• Version conflicts

Generation Issues

Issue: Generation Hangs

Symptoms:

• Create Extension starts but never completes
• Progress indicator doesn't move

Solutions:

1. Wait longer (up to 5-10 minutes for large configurations)
2. Cancel and retry
3. Check for database locks
4. Restart the session

Issue: "No Security Features" Warning

Symptoms:

• Message says no features to generate

Solutions:

1. Verify security features exist
2. Check features have field/action/data controls
3. Features need content to generate code

Issue: Missing Page Extensions

Symptoms:

• Extension generates but some pages aren't controlled

Solutions:

1. Verify pages are added to features
2. Check page IDs are correct
3. Regenerate after adding pages

Compilation Errors

Issue: Field Not Found

Error Message:

Field 'Unit Cost' not found in Table 'Item'

Cause:

• Field was removed or renamed in BC
• Field ID changed

Solution:

1. Update the field reference in security feature
2. Remove obsolete field entries
3. Regenerate

Issue: Page Not Found

Error Message:

Page 'Customer Card Old' not found

Cause:

• Page was removed from BC
• Page ID changed

Solution:

1. Update page reference
2. Remove obsolete page entries
3. Regenerate

Issue: Syntax Error in Filter

Error Message:

Invalid filter expression

Cause:

• Malformed filter syntax
• Invalid characters in filter

Solution:

1. Review filter expressions
2. Fix syntax errors
3. Test filter manually in BC

Issue: Object ID Conflict

Error Message:

Object ID already in use

Cause:

• Another extension using same IDs
• Rare conflict scenario

Solution:

1. Contact support
2. May need configuration adjustment

Installation Errors

Issue: Schema Migration Failed

Error Message:

Cannot modify table schema

Cause:

• Data migration issue
• Field type changes

Solution:

1. Check for data in affected tables
2. May need manual data migration
3. Contact support for assistance

Issue: Dependency Not Found

Error Message:

Dependency 'AL Compiler' not found

Cause:

• Required dependency not installed

Solution:

1. Install the AL Compiler extension
2. Usually installs automatically with ACS

Issue: Permission Denied

Error Message:

You do not have permission to install extensions

Cause:

• User lacks admin permissions

Solution:

1. Use an admin account
2. Verify extension management permissions

Version Issues

Issue: Old Extension Still Active

Symptoms:

• New configuration not taking effect
• Old security rules still applied

Solution:

1. Verify new extension is installed
2. Check version number
3. Uninstall old, reinstall new if needed
4. Refresh browser

Issue: Cannot Update Extension

Error Message:

Cannot update extension: data incompatibility

Solution:

1. Backup current configuration
2. Uninstall old version
3. Install new version
4. Restore configuration if needed

Issue: Extension Version Mismatch

Symptoms:

• Features in configuration but not in extension

Solution:

• Regenerate extension to sync

Conflict Field Issues

Issue: "Cannot Modify Property" Error

Error Message:

Cannot modify Visible property - already has expression

Cause:

• Field has existing visibility expression
• Not handled as conflict field

Solution:

1. Open Handle Conflict Fields
2. Configure the conflict
3. Regenerate extension

Issue: Original Expression Overridden

Symptoms:

• Business logic not working
• Field always hidden/shown when it shouldn't be

Cause:

• Conflict resolution set to "Override"
• Original expression not preserved

Solution:

1. Change to "Combined" resolution
2. Regenerate extension
3. Test business logic

Runtime Issues

Issue: Extension Causes Page Errors

Symptoms:

• Error when opening pages
• Page crashes or shows error

Diagnostic Steps:

1. Identify the page
2. Check which features affect it
3. Review field/action configurations
4. Test without specific features

Solution:

1. Identify problematic configuration
2. Remove or fix the issue
3. Regenerate extension

Issue: Extension Slows Pages

Symptoms:

• Noticeable delay opening pages
• Slow list scrolling

Possible Causes:

• Complex filter expressions
• Many security features
• Unindexed filter fields

Solutions:

1. Simplify filters
2. Use indexed fields
3. Reduce feature complexity
4. Contact support for optimization

Rollback Procedures

Rolling Back to Previous Version

If a new extension causes problems:

1. Go to Extension Management
2. Find ACS Security Extension
3. View Version History
4. Select previous version
5. Revert to that version

Emergency Uninstall

If you need to remove ACS security immediately:

1. Go to Extension Management
2. Find ACS Security Extension
3. Uninstall (note: config preserved in ACS tables)
4. All ACS security removed until reinstalled

Preserving Configuration

Before major changes:

1. Document your security features
2. Export configuration if possible
3. Test in sandbox first

Preventing Issues

Best Practices

1. Test in Sandbox First
   • Always test configuration changes
   • Verify extension generates correctly
   • Test affected pages
2. Incremental Changes
   • Add features incrementally
   • Test after each addition
   • Easier to identify problems
3. Keep Records
   • Document configuration changes
   • Track what was changed when
   • Helps with troubleshooting
4. Regular Validation
   • Periodically verify extension is current
   • Check for BC updates that may impact
   • Review conflict fields after updates

Diagnostic Information

For Support Tickets

When reporting extension issues, provide:

Information	How to Get
ACS Version	From Extension Management
BC Version	From Settings → Help → About
Error Message	Screenshot or exact text
Steps to Reproduce	What you were doing
Configuration	Which features/fields involved

Log Information

ACS may log information to:

• Application Insights (if configured)
• Business Central event log
• Extension runtime logs

Related Topics

• Common Issues
• Support
• Create Extension
• Handle Conflict Fields