Installation Overview

This guide helps you install and configure the Credit Device app in your Microsoft Dynamics 365 Business Central environment.

Pre-installation Checklist

System Requirements Verification

• Business Central version 23.0 or higher
• Required permissions for app installation
• Q-Team App Authenticator available
• Access to CreditDevice platform
• API credentials obtainable

Required Information

Gather the following information before you begin:

Installatiemethoden

Optie 1: Business Central SaaS (AppSource)

Voordelen: - Automatische updates - Eenvoudige installatie - Microsoft support - Integratie met andere AppSource apps

Stappen:

1. Open Business Central admin center
2. Ga naar "Extension Management"
3. Zoek naar "Credit Device" door Q-Team Solutions
4. Klik "Install" en volg de wizard
5. Wacht op installatiebevestiging

Optie 2: Business Central On-Premises

Voordelen: - Volledige controle over updates - Custom deployment opties - Lokale data opslag - Flexibele configuratie

Stappen:

1. Download .app bestand van Q-Team Solutions
2. Open Business Central Administration Shell
3. Installeer via PowerShell commando's
4. Configureer app permissions
5. Activeer licenties

Installatiestappen Detail

Stap 1: Pre-installatie Verificatie

# Verificeer Business Central versie
Get-NAVServerInstance | Select ServerInstance, Version

# Check beschikbare extensions
Get-NAVAppInfo -ServerInstance BC230

# Verificeer Q-Team App Authenticator
Get-NAVAppInfo -Name "*Q-Team*Authenticator*"

Stap 2: App Installatie (On-Premises)

# Publiceer app naar tenant
Publish-NAVApp -ServerInstance BC230 -Path "Q-Team Solutions_Credit Device_23.0.45337.0.app"

# Synchronize app data
Sync-NAVApp -ServerInstance BC230 -Name "Credit Device" -Version 23.0.45337.0

# Install app voor tenant
Install-NAVApp -ServerInstance BC230 -Name "Credit Device" -Version 23.0.45337.0

# Verificeer installatie
Get-NAVAppInfo -ServerInstance BC230 -Name "Credit Device"

Stap 3: Permissies Configuratie

Automatische Permissies: - QTEAMEssential.permissionset wordt automatisch geïnstalleerd - Basis permissies voor Credit Device functionaliteit - Role Center integratie permissies

Handmatige Permissies:

// Aan gebruiker toewijzen
permissionset 50100 "Credit Device User"
{
    Assignable = true;
    Access = Public;
    
    IncludedPermissionSets = "QTEAMEssential";
    
    Permissions = 
        tabledata "Customer" = RIMD,
        tabledata "Sales Invoice Header" = RIMD;
}

Stap 4: Licentie Activatie

SaaS Environment: - Licenties worden automatisch toegewezen - Per-user licensing model - Maandelijkse/jaarlijkse facturering

On-Premises Environment:

1. Ontvang licentie bestand van Q-Team Solutions
2. Import licentie via Business Central license management
3. Assign licenties aan benodigde gebruikers
4. Verificeer licentie status

Post-installatie Verificatie

Functionele Tests

Test 1: App Toegankelijkheid - Log in als test gebruiker - Navigeer naar Accountant Role Center - Verificeer "Credit Device Setup" actie zichtbaar - Open Credit Device Setup pagina

Test 2: Basis Configuratie - Open Credit Device Setup - Vul test API key in - Test API connectie (indien beschikbaar) - Verificeer error handling

Test 3: Permissies Verificatie - Test met verschillende gebruikersrollen - Verificeer toegang tot setup pagina - Test data read/write permissies

Technische Verificatie

// Code verificatie in AL Developer Environment
codeunit 50100 "Installation Test"
{
    procedure VerifyInstallation()
    var
        CreditDeviceSetup: Record "QTEAM Credit Device Setup";
        CreditDeviceMgt: Codeunit "QTEAM Credit Device Mgt";
    begin
        // Test record creation
        CreditDeviceSetup.Init();
        CreditDeviceSetup."Primary Key" := 'TEST';
        CreditDeviceSetup.Insert();
        
        // Test codeunit access
        CreditDeviceMgt.ValidateSetup();
        
        Message('Installation verified successfully');
    end;
}

Troubleshooting Installatie

Veelvoorkomende Problemen

Problem: App installatie mislukt Solution:

1. Verificeer Business Central versie compatibility
2. Check Q-Team App Authenticator installatie
3. Verificeer admin rechten
4. Review event log voor detail errors

Problem: Permissie fouten na installatie Solution:

1. Verificeer permission set assignment
2. Check user role configuration
3. Ensure proper license assignment
4. Test met SUPER user account

Problem: Setup pagina niet zichtbaar Solution:

1. Refresh Role Center pagina
2. Check page extension deployment
3. Verificeer user permissies voor Role Center
4. Test met andere user account

Logging en Diagnostiek

Event Log Monitoring:

# Monitor Business Central events
Get-WinEvent -LogName "Microsoft-DynamicsNAV-Server/Admin" | 
    Where-Object {$_.Message -like "*Credit Device*"}

# Application Insights query
traces
| where operation_Name contains "Credit Device"
| order by timestamp desc

Volgende Stappen

Na succesvolle installatie:

1. Configuratie: Setup van API credentials en webhook URLs
2. Eerste Setup: Uitvoeren van initiele configuratie wizard
3. Basis Gebruik: Leren gebruik van basis functionaliteiten

Support Resources

• Technische Support: support@q-teamsolutions.com
• Documentatie: https://www.q-teamsolutions.com/docs/credit-device/
• Knowledge Base: Q-Team Solutions Support Portal
• Community Forum: Business Central Community