Das ist eine für den Ausdruck optimierte Ansicht des gesamten Kapitels inkl. Unterseiten. Druckvorgang starten.

Zur Standardansicht zurückkehren.

Installation von Apps

Installationsliste der RELion Apps

Sobald eine Business Central Umgebung erstellt ist, umfasst sie ausschließlich den Microsoft-Standard. Alle weiteren Anwendungen, wie RELion, DATEV, Continia usw., müssen nach der Aktivierung in der vorgegebenen Reihenfolge installiert werden.

Installationsliste

BC und RELion App-HierarchieInstallationsreihenfolge (sofern lizensiert)
Business Central AppsContinia Document Capture
Sievers Apps(DATEV)Sievers DATEV
RELion DATEV ConnectorSievers DATEV Buchungsdatenservice
Continia AppsContinia Business Foundation
RELion Invoice Manager(RRM)Continia Connector App
RELion System ApplicationContinia Core
RELion ONEContinia Delivery Network
RELion DATEV ConnectorRELion System Application
RELion Invoice Manager(RRM)RELion ONE
RELion Archiv kompakt Connector(AAK)RELion DATEV Connector
RELion Konfipay Service IntegratorRELion Invoice Manager(RRM)
RELion VAT Export Germany(UVA DE)Archiv kompakt Connector
RELion VAT Export Austria(UVA AT)RELion Konfipay Service Integrator
RELion Default APIRELion Invoice Manager(RRM)
RELion Aareon ConnectRELion VAT Export Germany(UVA DE)
RELion VAT Export Austria(UVA AT)
RELion Default API
RELion Aareon Connect

1 - App-Updates in Business Central Online

Vorgehen bei Updates der RELion Apps in Business Central Online sowie die Folgen, wenn kein Update installiert wird.

Überblick

Die RELion Apps – RELion ONE, die RELion System Application sowie die Zusatz-Apps wie Rechnungsmanager, Archiv kompakt Connector, DATEV Connector oder Konfipay Service Integrator – werden über den Microsoft Marketplace (AppSource) bereitgestellt. Die vollständige Liste der Apps steht unter Installation von Apps.

Für ihre Aktualisierung gilt der Mechanismus, den Microsoft für alle Marketplace-Apps in Business Central Online anwendet. Er gilt ebenso für Apps anderer Hersteller, zum Beispiel Continia oder Sievers.

Eine App kann auf zwei Wegen aktualisiert werden:

  • Manuell: Der Administrator installiert das Update im Business Central Admin Center.
  • Automatisch: Die App wird zusammen mit einem Update der Business Central Version aktualisiert.

Wichtig

Support kann nur für die jeweils neuesten Releases der RELion Apps erfolgen. Möglicherweise ist vor der Bearbeitung einer Supportanfrage die Installation des Updates erforderlich.

Wie erfährt der Kunde von einem Update?

Veröffentlicht Aareon eine neue Version einer App, wird sie zunächst von Microsoft gegen die verfügbaren Business Central Versionen geprüft. Erst danach steht sie den Umgebungen zur Verfügung, die auf einer dafür freigegebenen Business Central Version betrieben werden. Die Installation in der Umgebung erfolgt nicht automatisch zum Zeitpunkt der Veröffentlichung.

  • Admin Center: Auf der Seite Manage Apps zeigt die Spalte Next Update an, ob für eine App ein Update verfügbar ist (in älteren Ansichten heißt die Spalte Available Update Action).
  • E-Mail: Für neue App-Versionen sieht die Microsoft-Übersicht der Benachrichtigungen keine E-Mail an die Benachrichtigungsempfänger vor. E-Mails gibt es für Updates der Business Central Version. Das Admin Center sollte daher regelmäßig geprüft werden.
  • Releaseinformationen: Die Neuerungen, Fehlerbehebungen und Voraussetzungen einer Version stehen in den Releaseinformationen für RELion ONE und für die Zusatz-Apps. Dort sind auch Mindestvoraussetzungen genannt, zum Beispiel die erforderliche Version von RELion ONE oder Business Central.

Warum wird kein Update angezeigt?

Wenn eine neue App-Version veröffentlicht wurde, in der Umgebung aber nicht angezeigt wird, befindet sich die Umgebung vermutlich noch auf einer Business Central Version, für die die neue App-Version nicht freigegeben ist. In diesem Fall ist zunächst die Business Central Version zu aktualisieren. Das Vorgehen dazu steht im Business Central Admin Center.

Update manuell installieren

Voraussetzung: Der Benutzer benötigt die Rolle Dynamics 365 Business Central-Administrator (siehe Verwaltung einer Business Central Umgebung).

  1. Empfohlen: Update vorab in einer Testumgebung prüfen. Hierzu wird aus der Produktivumgebung eine Sandbox erstellt (siehe Erstellung einer Sandbox), das Update dort installiert und die wichtigsten Geschäftsabläufe werden geprüft. Neue Versionen können bereits vor der Veröffentlichung als Release Candidate in einer Sandbox getestet werden.
  2. Das Admin Center öffnen (https://businesscentral.dynamics.com/<TENANT_ID>/admin), die Umgebung auswählen und Manage Apps öffnen. Als App-Typ Global wählen.
  3. Die Update-Aktion der betreffenden App in der Spalte Next Update auswählen. Installiert wird die höchste verfügbare Version, die zur Business Central Version der Umgebung passt.
  4. Den Zeitpunkt festlegen. Standardmäßig beginnt die Installation unmittelbar nach der Bestätigung. Mit der Option Schedule update in the next update window beginnt sie im nächsten Update-Fenster der Umgebung (Standard: 20:00 bis 06:00 Uhr).
  5. Prüfen, ob die Spalte auf Up to date wechselt. Den Verlauf zeigt die Seite Operations im Admin Center. Die installierte Version wird auch auf der Seite Erweiterungsverwaltung in Business Central angezeigt.

Die Installation sollte daher außerhalb der Arbeitszeiten erfolgen. Je nach Art der Änderung kann eine erneute Anmeldung erforderlich sein.

Ausführliche Beschreibungen mit allen Optionen bietet Microsoft hier:

Abhängigkeiten zwischen Apps

Setzt ein Update eine neuere Version einer anderen App voraus oder benötigt es eine zusätzliche App, zeigt das Admin Center in der Spalte Next Update den Eintrag Action Required. Die Seite Requirements for App Updates führt die vorab zu erfüllenden Voraussetzungen auf:

  • Update requirements: Bereits installierte Apps, die zuerst aktualisiert werden müssen. Das Update erfolgt auf der Seite Manage Apps in der beschriebenen Weise.
  • Install requirements: Noch nicht installierte Apps. Sie werden in Business Central über den Aufruf Microsoft AppSource installiert, nicht im Admin Center. Wahlweise gelangt man dorthin auch über den Absprung in der Erweiterungsverwaltung.

Ein Beispiel ist eine Zusatz-App, die eine neuere Version von RELion ONE voraussetzt. Die Reihenfolge und die Abhängigkeiten der RELion Apps zeigt die Installationsliste. Hinweise dazu stehen auch in den Releaseinformationen der Zusatz-Apps. Siehe auch Resolve requirements for app updates (Microsoft, englisch).

Wenn das Update fehlschlägt

Schlägt die Installation fehl, zeigt die Spalte Next Update den Eintrag Update failed. Details und mögliche Ursachen werden im Bereich App Update Details angezeigt.

  1. Die Aktion Retry wählen, da die Ursache vorübergehender Natur sein kann.
  2. Schlägt der erneute Versuch fehl, den Support über das Kundenportal kontaktieren und die Operation ID aus der Fehlermeldung angeben.

Automatische Updates

Einstellung „Apps Update Cadence“

Bei einem Update der Business Central Version (Major- oder Minor-Update) aktualisiert Microsoft installierte Apps automatisch. Wann dies geschieht, steuert die Einstellung Apps Update Cadence auf der Seite mit den Umgebungsdetails im Admin Center:

EinstellungApps werden automatisch aktualisiert …
Default (Standard)bei Major-Updates (April und Oktober). Bei Minor-Updates nur, wenn das App-Update für die neue Business Central Version zwingend erforderlich ist.
With minor and major updatesbei jedem Minor- und Major-Update.
With major updateswie Default, jedoch fest eingestellt. Microsoft kann das Verhalten von Default später ändern.

Unabhängig von der Einstellung wird ein App-Update stets mit installiert, wenn es für die neue Business Central Version zwingend erforderlich ist. Bei einem Major-Update werden alle Apps auf die jeweils neueste Version aktualisiert. Die Einstellung gilt nicht für kundenspezifische Erweiterungen (Per-Tenant Extensions).

Empfehlung

Aareon empfiehlt, die Einstellung With major updates zu verwenden, damit die RELion Apps mit jedem Major-Update von Business Central auf dem neuesten Stand bleiben. Siehe auch Business Central Admin Center.

Vor der Installation eines neuen Major-Updates von Business Central wird dringend empfohlen, auf die Freigabe von Aareon zu warten.

Weitere Informationen bietet Microsoft unter Update installed apps with environment updates (Microsoft, englisch).

Was passiert, wenn kein Update installiert wird?

  1. Solange kein Update der Business Central Version ansteht, bleibt die installierte App-Version unverändert. Support kann jedoch nur für die neuesten Releases erfolgen.
  2. Beim nächsten Update der Business Central Version terminiert Microsoft das Update der Umgebung selbständig, sofern der Administrator keinen Termin festlegt. Der Termin liegt mindestens sieben Tage in der Zukunft und wird den Benachrichtigungsempfängern per E-Mail mitgeteilt. Das Update wird im Update-Fenster der Umgebung ausgeführt. Die Apps werden dabei gemäß der Einstellung Apps Update Cadence aktualisiert.
  3. Ist eine App nicht kompatibel, schlägt das Update der Umgebung fehl. Die Umgebung verbleibt auf der bisherigen Version, und Microsoft wiederholt den Versuch nach sieben Tagen. Zusätzlich werden die Benachrichtigungsempfänger per E-Mail informiert, und in Business Central erscheinen entsprechende Hinweise. Wird die Ursache nicht behoben, wird die betreffende App durch Microsoft deinstalliert (siehe unten). Die Daten der App bleiben erhalten.

Fristen bei Major-Updates

Für Major-Updates gelten die folgenden Zeiträume:

PhaseZeitraumBedeutung
Update period5 Monate ab Veröffentlichung (April bzw. Oktober)Der Administrator kann das Update auf einen beliebigen Termin legen.
Grace period1 MonatDas Update kann nicht mehr auf einen späteren Termin verschoben werden.
Enforced update perioddanachApps, die das Update verhindern, können automatisch deinstalliert werden.

Zwischen der Veröffentlichung eines Major-Updates und dem erzwungenen Update liegen damit höchstens sechs Monate. Microsoft behält sich vor, diese Zeiträume anzupassen.

Wichtig

In der Enforced update period deinstalliert Microsoft Apps, die das Update verhindern, automatisch. Die Daten der App werden nicht gelöscht. Wenn später eine kompatible Version verfügbar ist, wird die App nicht automatisch wieder installiert, sondern muss manuell installiert werden. Anschließend stehen auch die Daten wieder zur Verfügung.

Zu blockierten Updates informiert Microsoft die Benachrichtigungsempfänger über mehrere Wochen per E-Mail. Anschließend werden Hinweise in Business Central eingeblendet, die allen Benutzern angezeigt werden. Details stehen unter Notification of blocked updates (Microsoft, englisch).

Empfehlungen

  • Benachrichtigungsempfänger pflegen: Im Admin Center sollte mindestens eine Administrator-Adresse als Notification recipient hinterlegt sein. Die E-Mails werden von no-reply-dynamics365@microsoft.com versendet und sollten nicht in einem Spam-Ordner abgelegt werden.
  • Apps Update Cadence setzen: Siehe die Empfehlung oben.
  • Auf die Freigabe von Aareon warten: Ein neues Major-Update von Business Central erst nach der Freigabe durch Aareon installieren.
  • Regelmäßig prüfen: Auf der Seite Manage Apps auf neue Versionen prüfen und die Releaseinformationen lesen.
  • Updates im Update-Fenster installieren: Dadurch werden Beeinträchtigungen für Benutzer vermieden.
  • Vorab testen: Das Update in einer Sandbox testen, die als Kopie der Produktivumgebung erstellt wurde.

Weitere Informationen von Microsoft

2 - Release Candidate App

Die Preview-Version einer RELion-App stellt den Release Candidate dar.

Vorbereitung

Die Preview Version einer RELion App stellt den Release Candidate dar.

Um diesen Link zu erhalten und zu konfigurieren, müssen folgende Informationen bereitgestellt werden:

Die RELion Candiate Apps können in den Testumgebungen über einen speziellen URL-Link installiert werden. Dieser Link startet die Installationsroutine direkt in Business Central Online.

Dabei ist es wichtig, die Tenant ID sowie die App ID entsprechend der Zielumgebung anzupassen, in der die App installiert werden soll.

Die Installations-Links für RELion Candidate Apps sind bereits vordefiniert. Um den Link zu vervollständigen, muss lediglich die TENANT_ID Ermittlung der Tenant des Kundentenants hinzugefügt werden.

Preview Install Link: https://businesscentral.dynamics.com/<TenantID>/?noSignUpCheck=1&filter='ID' IS '<AppID>' AND 'PreviewKey' IS '<PreviewKey>'&page=2503

RELion ONE

App IDApp ID: 4f2d5834-ba23-42e2-9a87-fab031ad70c6
Preview Key Release Candidatereliononereleasecandidate
Preview Install Link Release Candidatehttps://businesscentral.dynamics.com/<TenantID>/?noSignUpCheck=1&filter='ID' IS '4f2d5834-ba23-42e2-9a87-fab031ad70c6' AND 'PreviewKey' IS 'reliononereleasecandidate'&page=2503

Testumgebung für Sandbox

Um eine Candidate-App zu installieren, wird der vorbereitete Link in die Adresszeile des Browsers eingegeben. Anschließend wird die Umgebung (z. B. eine Sandbox) ausgewählt, in der die App installiert werden soll.

Hinweis

Candidate-Apps können ausschließlich in Sandbox-Umgebungen installiert werden.

test-image

Installationsassistent

Sobald die Testumgebung ausgewählt wurde, erscheint die Seite des Installationsassistenten.

test-image

Während dem Installationsprozess wird der aktuelle Stand der Installation angezeigt.

test-image

Nach Abschluss der Installation wird eine Bestätigungsmeldung angezeigt. Das Schließen dieser Meldung führt nicht automatisch zur Beendigung des Assistenten. Der Installationsdialog bleibt aktiv und muss manuell über das „X“-Symbol in der oberen rechten Ecke geschlossen werden. In einigen Fällen sind dafür mehrere Klicks erforderlich.

test-image

Erweiterungsverwaltung

Über die Seite Erweiterungsverwaltung lässt sich die installierte Version der Candiate-App überprüfen.

erweiterung

Weitere Hilfe und Informationen

Preview versions of AppSource apps: Managing Apps - Business Central | Microsoft Learn

Questions about AppSource app previews: Technical validation FAQ - Business Central | Microsoft Learn

AppSource ISV publishers can preview their AppSource apps with select customers: AppSource ISV publishers can preview their AppSource apps with select customers | Microsoft Learn

Ermittlung der Tenant

Wie ermittle ich eine Tenant ID in der Business Central Umgebung?

  1. Öffne das Microsoft Entra Admin Center Entra ID und Suche Tenant Properties.

Tenant

  1. Trage die Kunden Tenant ID ein das Feld ein.

Tenant-ID

  1. Öffne den Microsoft Account oder die Microsoft Office Startseite und Suche über App-Startfeld nach Business Central.

App-BC

  1. Die ID wird beim Aufrufen von Business Central in der Adressleiste ergänzt.

Adressleiste

  1. Der Business Central Client wird über die Einstellungen und das Admin Center geöffnet.

Admin Center

Zum Schluss wird die ID in der Adressleiste automatisch ergänzt.

Admin Center