Die App installieren

In diesem Abschnitt geht es um die Installation der COSMO E-Bilanz App. Üblicherweise wird die Installation einmalig ausgeführt und nicht von einem Benutzer, sondern einem Administrator. Die Installation unterscheidet sich bei SaaS und On-Premises (OnPrem) Umgebungen.

In SaaS Umgebung installieren

In SaaS Umgebungen kann die App unmittelbar aus dem AppSource installiert werden. Dabei gibt es zwei Wege die App zu installieren, extern und intern von Business Central. Alle Abhängigkeiten werden automatisch mit installiert. Deinstallieren und Installieren Sie die App erneut um ein Upgrade auf die aktuellste Version auszuführen.

AppSource

Besuchen Sie den AppSource und wählen Sie Kostenlose Testversion. Sie werden auf eine Seite weitergeleitet, auf der Sie sich in Business Central anmelden und die Umgebung zum Installieren auswählen müssen. Folgen Sie den Anweisungen des Assistenten um die Installation abzuschließen.

AppSource

Erweiterungen

Die Seite Erweiterungen wird über Tell Me aufgerufen. Wählen Sie das Symbol Glühbirne, die die Tell Me Funktion öffnet aus, geben Sie Erweiterungen ein und wählen Sie dann den entsprechenden Link. Suchen Sie nach COSMO E-Bilanz im Marktplatz wählen Sie Kostenlose Testversion. Folgen Sie den Anweisungen des Assistenten um die Installation abzuschließen.

Extension Marketplace

In On-Premises Umgebung installieren

Abhängig von der Technologie werden unterschiedliche Skripte als Basis bereitgestellt um die App und ihre Abhängigkeiten in On-Premises Umgebungen zu installieren. Das Compiler-Paket der App finden Sie im COSMO CONSULT Solution Portal. Prüfen Sie die technischen Spezifikationen der Version, um die minimal abhängige Version von Business Central und der Basisapplikation (Base Application) zu finden. Für Kundeninstallationen ohne Business Central-Entwicklerlizenz müssen Sie ein Laufzeitpaket der App erstellen und installieren (Microsoft Dokumentation).

Neben der Business Central Basisapplikation ist die App von weiteren Library Apps abhängig, die vorher in der richtigen Reihenfolge installiert werden müssen.

  1. COSMO Licensing App
  2. COSMO E-Balance App

Docker

Um die Apps in einen Docker-Container zu installieren, muss das Modul BcContainerHelper installiert sein. Ändern Sie die Dateinamen, den Container-Namen und die Anmeldeinformationen gemäß den Werten Ihres Systems.

$licensingAppFileName   = Join-Path $PSScriptRoot "COSMO Licensing.app"
$ebAppFileName          = Join-Path $PSScriptRoot "COSMO E-Balance.app"
$Global:containerName   = "your-container-name"
$Global:credential      = "your-credential"

function Install-CosmoAppToContainer {
    Param (
        [Parameter(Mandatory=$true)]
        [string] $AppFileName
    )
    
    Publish-BcContainerApp `
        -appFile $AppFileName `
        -containerName $Global:containerName `
        -credential $Global:credential `
        -install `
        -sync `
        -skipVerification `
        -scope "Global" `
        -syncMode "Add"
}

try {
    if (!(Get-Module -ListAvailable -Name "BcContainerHelper")) { throw "BcContainerHelper must be installed to run this script." }

    Install-CosmoAppToContainer -AppFileName $licensingAppFileName
    Install-CosmoAppToContainer -AppFileName $ebAppFileName

} catch {
    throw "Error on installation: $($_.Exception.Message)"
}

Serverinstanz

Ändern Sie die Dateinamen und die Serverinstanz gemäß den Werten Ihres Systems.

$licensingAppFileName   = Join-Path $PSScriptRoot "COSMO Licensing.app"
$ebAppFileName          = Join-Path $PSScriptRoot "COSMO E-Balance.app"
$Global:serverInstance  = "your-server-instance"

function Install-CosmoAppToServerInstance {
    Param (
        [Parameter(Mandatory=$true)]
        [string] $AppFileName,
        [Parameter(Mandatory=$true)]
        [string] $AppName
    )
    
    Publish-NAVApp `
        -ServerInstance $Global:serverInstance `
        -Path $AppFileName `
        -SkipVerification `
        -Scope Global

    Sync-NAVApp `
        -ServerInstance $Global:serverInstance `
        -Name $AppName

    Install-NAVApp `
        -ServerInstance $Global:serverInstance `
        -Name $AppName
}

try {
    Install-CosmoAppToServerInstance -AppFileName $licensingAppFileName -AppName "COSMO Licensing"
    Install-CosmoAppToServerInstance -AppFileName ebAppFileName -AppName "COSMO E-Balance"

} catch {
    throw "Error on installation: $($_.Exception.Message)"
}

Siehe auch

App-Registrierung und Lizenzierung

Feedback

Senden Sie Feedback für diese Seite . (Beachten Sie, dass diese Umfrage auf Englisch ist.)