App installieren

Welcher Weg für dich der richtige ist, hängt davon ab, wo deine Business-Central-Umgebung läuft.

Voraussetzungen

• Business Central 26 oder neuer.
• Ein Benutzer mit ausreichenden Rechten zum Installieren von Erweiterungen (online: Administrator im Microsoft-365-Tenant; OnPrem: Benutzer mit SUPER-Berechtigung, der Apps auf der BC-Server-Instanz veröffentlichen darf).
• Für Business Central Online und uneingeschränkte OnPrem-Netze sind keine Firewall-Anpassungen nötig. Wenn du AutoFlow OnPrem hinter einem ausgehenden Proxy oder einem Egress-Filter betreibst, beachte die Netzwerkanforderungen am Ende dieser Seite.

Business Central Online (SaaS) — über AppSource

1. Melde dich an deiner Business-Central-Umgebung an.
2. Öffne den Erweiterungs-Marketplace (Suche nach Erweiterungs-Marketplace in der Tell-Me-Leiste).
3. Suche dort nach AutoFlow von mse Software GmbH oder öffne den AppSource-Eintrag direkt unter marketplace.microsoft.com/.../autoflow.
4. Wähle Jetzt herunterladen und folge dem AppSource-Dialog. Du wirst aufgefordert,
   • die Nutzungsbedingungen zu akzeptieren und
   • die Umgebung auszuwählen, in der AutoFlow installiert werden soll.
5. AppSource installiert AutoFlow sowie die erforderlichen Komponenten. Die Installation läuft im Hintergrund und kann einige Minuten dauern.
6. Öffne anschließend die Zielumgebung und fahre mit Produkt aktivieren fort.

tipp

AutoFlow wird pro Umgebung installiert. Wenn du mehrere Umgebungen betreibst (z.B. Sandbox und Produktion), installiere AutoFlow in jeder Umgebung separat, in der du es nutzen möchtest.

Business Central OnPrem — über das mse-Download-Portal

1. Öffne das AutoFlow-Download-Portal unter support.mse365.de/support/solutions/57000022346 und lade den passenden AutoFlow-Release für deine Business-Central-Version herunter. Das Archiv enthält die .app-Dateien von AutoFlow sowie aller erforderlichen Abhängigkeiten.

2. Kopiere die .app-Dateien auf den Business-Central-Server.

3. Öffne auf dem Server eine Business Central Administration Shell (PowerShell) und veröffentliche die Apps:

   Publish-NAVApp -ServerInstance <DeineInstanz> -Path "<pfad>\AutoFlow.app" -PackageType Extension -SkipVerification

   Wiederhole den Schritt für jede .app-Datei im Paket. Installiere zuerst die Abhängigkeiten, anschließend AutoFlow selbst.

4. Synchronisiere und installiere die App in jedem Mandanten, in dem du AutoFlow nutzen möchtest:

   Sync-NAVApp    -ServerInstance <DeineInstanz> -Name "AutoFlow" -Version <Version> -Tenant <TenantId>
   Install-NAVApp -ServerInstance <DeineInstanz> -Name "AutoFlow" -Version <Version> -Tenant <TenantId>

5. Fahre mit Produkt aktivieren fort.

tipp

Bei einer Single-Tenant-Installation ersetzt du <TenantId> durch default.

Nach der Installation

Nach Abschluss der Installation ist AutoFlow im System vorhanden, aber noch nicht aktiv. Beim Öffnen der meisten Rollencenter erscheint eine Benachrichtigung, die dich zur Aktivierung auffordert. Das nächste Kapitel führt dich durch diesen Schritt.

Berechtigungssätze

AutoFlow liefert zwei Berechtigungssätze aus, die du den Benutzern zuweist:

Berechtigungssatz	Für wen	Was er gewährt
AUTOFLOW ALL	jeder AutoFlow-Benutzer	minimaler Satz, der nötig ist, um Flows auszuführen und den Aktivierungsstatus zu sehen — bewusst klein gehalten, ohne eigene Tabellenzugriffe auf Lizenzdaten
AUTOFLOW SUB MGT	Admins / Power-User	Aktivierungs-Assistent, Paketbuchung, Rechnungsdaten bearbeiten, Gutschein einlösen — alles, was zur Verwaltung von Abonnements nötig ist

Öffne Benutzer-Berechtigungssätze und weise allen AutoFlow-Anwendern AUTOFLOW ALL zu. Den ein bis zwei Personen, die Abonnements verwalten, gibst du zusätzlich AUTOFLOW SUB MGT. Bestehende Berechtigungssätze für Finanz- oder IT-Rollen können beide Sätze über Enthaltene Berechtigungssätze übernehmen, sodass eine einzige Zuweisung alles abdeckt.

Netzwerkanforderungen

Dieser Abschnitt ist nur relevant, wenn du AutoFlow OnPrem hinter einem ausgehenden Proxy oder einem Egress-Filter betreibst. Auf Business Central Online erlaubt Microsoft die relevanten Hosts bereits; die meisten OnPrem-Kundennetze lassen ausgehendes HTTPS ohnehin uneingeschränkt zu – in dem Fall ist hier nichts zu tun. Wenn deine Firewall ausgehenden Verkehr einschränkt, muss sie die folgenden Hosts erlauben.

Erforderlich

Host	Protokoll/Port	Zweck	Wann AutoFlow den Host kontaktiert
licensing.mse365.de	HTTPS / TCP 443	Produktaktivierung, Tenant-Registrierung, Paketverwaltung, Lizenzprüfung	Bei der Aktivierung, bei jedem Flow-Lauf (für einige Minuten gecacht) und beim periodischen Hintergrund-Validierungslauf

Empfohlen

Host	Protokoll/Port	Zweck	Wenn blockiert
statics.autoflow.mse365.de	HTTPS / TCP 443	Step-Icons und Status-Badges im Flow-Editor	Nur kosmetisch – Flows laufen weiter; der Flow-Editor verwendet ein Standard-Icon
docs.autoflow.mse365.de	HTTPS / TCP 443	Mehr erfahren-Links aus der App öffnen diese Doku-Seite	Die Links sind tot, sonst keine Auswirkung

Einmalig, während der Installation

Host	Protokoll/Port	Zweck	Wann
support.mse365.de	HTTPS / TCP 443	mse-Download-Portal – zum Herunterladen der .app-Dateien	Einmalig durch den Admin

Hinweise

• Per Hostname freigeben, nicht per fester IP. licensing.mse365.de läuft auf Azure mit einem Azure-managed Zertifikat; die Menge der Egress-IPs ist nicht stabil genug, um sie zu veröffentlichen.
• TLS 1.2 minimum. AutoFlow nutzt den Standard-HttpClient aus Business Central, der TLS mit dem Server aushandelt.
• Ausgehender Proxy. Wenn der BC-Server den Zugriff über einen Proxy bezieht, konfiguriere den Proxy gemäß Microsoft-Vorgaben auf der BC-Server-Instanz – AutoFlow verwendet den System-Proxy automatisch.

Fehlerbehebung

• Aktivierungs-Assistent hängt oder meldet „keine Lizenz" – prüfe, ob das BC-Server-Konto licensing.mse365.de erreichen kann.
• Im Flow-Editor fehlen Step-Icons – prüfe statics.autoflow.mse365.de. Nur kosmetisch; Flows laufen weiter.