Table of Contents

App Installation

This section covers the installation of the COSMO Core Library AT app. Installation is typically performed once by an administrator, not by an end user.

SaaS Environment

In SaaS environments, the app is distributed as a library app and is therefore not visible in AppSource.
The app is installed automatically when your app declares a dependency on it.

Example excerpt from app.json:

{
  "id": "30fc15ec-0ec8-418f-a2f9-d113eb73cbaa",
  "name": "ALProject1",
  "publisher": "Default Publisher",
  "version": "1.0.0.0",
  "dependencies": [
    {
      "id": "6f1e3666-7813-4802-9e59-9f6a66cb3276",
      "name": "COSMO Core Library AT",
      "publisher": "Cosmo Consult",
      "version": "1.0.0.0"
    }
  ]
}

Depending on the current Microsoft upgrade policy, you may not have the latest version of the app. To upgrade to the latest version, open the Dynamics 365 Business Central Admin Center and run the app upgrade for your environment.


On-Premises Environment

Depending on the technology, different scripts are provided as a basis for installing the app and its dependencies in On-Premises environments. The compiler package for the app can be found in the COSMO CONSULT Solution Portal. Check the technical specifications for the version to find the minimum required version of Business Central and the Base Application. For customer installations without a Business Central developer license, you must create and install a runtime package of the app (Microsoft Documentation).

In addition to the Business Central Base Application, the app depends on the following app, which must be installed first:

  1. COSMO Licensing App

Docker

To install the apps in a Docker container, the BcContainerHelper module must be installed. Adjust the file names, container name, and credentials to match your system.

$licensingAppFileName   = Join-Path $PSScriptRoot "COSMO Licensing.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

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

Server Instance

Adjust the file names and server instance to match your system.

$licensingAppFileName   = Join-Path $PSScriptRoot "COSMO Licensing.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"

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

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.

Je nach der aktuellen Microsoft-Upgrade-Richtlinie verfügen Sie möglicherweise nicht über die aktuellste Version der App. Um auf die aktuellste Version zu aktualisieren, gehen Sie zum Dynamics 365 Business Central Admin Center und führen Sie das App-Upgrade für Ihre Umgebung durch.

AppSource

Besuchen Sie den AppSource und wählen Sie dann Kostenlose Testversion aus. 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 Document Set im Marktplatz und 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).

Important

Wenn OPplus installiert ist, muss zusätzlich die App COSMO Advance Payment OPplus Integration installiert werden.

Neben der Business Central Basisapplikation ist die App von einer weiteren Library App abhängig, die vorher installiert werden muss.

  1. COSMO Licensing App
  2. COSMO Anzahlungsverwaltung App

Docker

Um die Apps in einem 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"
$aptAppFileName         = Join-Path $PSScriptRoot "COSMO Advance Payment.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 $aptAppFileName

} 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"
$aptAppFileName         = Join-Path $PSScriptRoot "COSMO Advance Payment.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 $aptAppFileName -AppName "COSMO Anzahlungsverwaltung"

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

Siehe auch

App-Registrierung und Lizenzierung


Feedback

Submit feedback for this page.

Edit this page