Continia Document Capture On-Premises installieren
In diesem Artikel wird beschrieben, wie Sie Document Capture in On-Premises-Bereitstellungen von Microsoft Dynamics 365 Business Central installieren. Bei der Installation der Software benötigen Sie stets die Unterstützung Ihres Continia-Partners.
Der Installationsprozess umfasst Runtime Packages, da alle Continia-Apps so herausgegeben werden. So kann jede Erweiterung in einem Runtime Package – in diesem Fall die Document Capture-App – auf Servern installiert werden kann, die über keine Entwicklerlizenz verfügen. Weitere Informationen finden Sie unter Create runtime packages for Business Central on-premises (Microsoft-Artikel).
Continia veröffentlicht Code für alle verfügbaren kumulativen Updates (CUs) für Business Central, wenn eine Version von Document Capture veröffentlicht wird (gilt sowohl für Hauptversionen als auch für Service Packs). Jedes neue CU von Microsoft wird erst ab dem nächsten von Continia veröffentlichten Service Pack unterstützt. Wenn Sie auf ein derzeit nicht unterstütztes Business Central CU aktualisieren müssen – beispielsweise auf das neueste – und nicht warten können, bis Continia ein Document Capture-Service Pack veröffentlicht, das dies unterstützt, wenden Sie sich bitte an das Continia-Supportteam, indem Sie ein Supportticket erstellen. Continia stellt Ihnen dann ein voll funktionsfähiges Paket bereit, das das entsprechende Business Central CU unterstützt.
So installieren Sie Document Capture
Um den Installationsprozess zu vereinfachen, hat Continia ein PowerShell-Skript entwickelt, das sicherstellt, dass Document Capture korrekt installiert wird und alle Abhängigkeiten wie vorgesehen funktionieren.
Wenn Sie das Skript ausführen, durchsucht es automatisch den Ordner, in dem es ausgeführt wird (einschließlich aller Unterordner), nach vorhandenen Instanzen von Document Capture und anderen Continia-Apps. Wenn eine frühere Version einer App erkannt wird, werden die App und alle Abhängigkeiten aktualisiert und alle alten Versionen deinstalliert. Wenn keine App erkannt wird, installiert das Skript die App automatisch zusammen mit allen anderen erforderlichen Apps.
Hinweis
Document Capture besteht aus zwei Apps:
- Continia Document Capture – die Basis-App, die die meisten Funktionen enthält. Diese App ist identisch mit der in Business Central Online veröffentlichten App.
- Continia Document Capture OnPremise – eine App, die Ihnen Zugriff auf Funktionen gibt, die nur in On-Premises-Installationen von Business Central verfügbar sind. Diese App ist erforderlich, wenn Sie den Dokumentenspeichertyp Dateisystem verwenden möchten. Wenn Sie Document Capture mit dem PowerShell-Skript installieren, wie in dieser Anleitung beschrieben, wird die Document Capture OnPremise-App nicht standardmäßig installiert. Befolgen Sie zur Installation Schritt 11 in der Anleitung. Außerdem müssen Sie die Document Capture-Serverkomponenten (Service Tier-Bibliotheken) installieren, bevor Sie die OnPremise-App veröffentlichen und installieren.
So installieren Sie Document Capture mit diesem Skript:
Gehen Sie zum Download Center in der Continia PartnerZone.
Verwenden Sie die Filter, um die neueste Version von Document Capture zu finden, und klicken Sie auf Download, um das Installationspaket herunterzuladen.
Wichtig
Nachdem Sie das Installationspaket heruntergeladen haben, müssen Sie es entsperren, um es ordnungsgemäß extrahieren zu können:
- Klicken Sie mit der rechten Maustaste auf die heruntergeladene Datei und wählen Sie Eigenschaften, um das Fenster mit den Dateieigenschaften zu öffnen.
- Wählen Sie auf der Registerkarte Allgemein unter Sicherheit die Option Entsperren und dann Übernehmen. Schließen Sie das Fenster, wenn Sie fertig sind.
Extrahieren Sie das Produktpaket in einen Ordner auf dem Computer mit der Business Central Service-Tier. Führen Sie in diesem Ordner die Datei setup.exe aus, um das Document Capture-Installationsprogramm zu öffnen.
Wählen Sie im Installationsprogramm Server Components und dann Ihre Version von Business Central aus.
Hinweis
Das Installationsprogramm aktualisiert den Ordner Add-ins (Client und/oder Server) im Standardinstallationspfad. Wenn Ihr Installationspfad also vom Microsoft-Standardpfad abweicht, müssen Sie den neuen Ordner Add-ins in den Ordner kopieren, in dem sich Ihre Installation befindet.
Wählen Sie im App-Ordner den Ordner aus, der Ihrer Business Central-Version (Ihrer Plattform) entspricht, einschließlich des richtigen kumulativen Updates.
Wichtig
Da Continia-Apps als Runtime Packages verteilt werden, müssen Sie die richtige Version auswählen. Die Funktionsfähigkeit von Runtime Packages wird garantiert, wenn sie auf einer Plattform mit derselben Version veröffentlicht werden, auf der sie erstellt wurden.
Das Installationsskript kann folgendermaßen ausgeführt werden:
- Klicken Sie in dem Ordner, den Sie im vorherigen Schritt ausgewählt haben, mit der rechten Maustaste auf Install.ps1 und wählen Sie Mit PowerShell ausführen.
- Führen Sie das Skript in einer PowerShell-Shell aus.
Wichtig
Das Skript Install.ps1 unterstützt keine Installation in Multi-Tenant-Umgebungen. Um Document Capture in Multi-Tenant-Umgebungen zu installieren, müssen Sie die Befehle im Installationsskript manuell ausführen. Weitere Informationen finden Sie unter Continia-Apps in Multi-Tenant-Umgebungen installieren oder aktualisieren.
Wenn Sie unterschiedliche Versionen von Business Central installiert haben, wählen Sie im Skript die entsprechende Version aus.
Wenn Sie aufgefordert werden, die zu installierende Lösung auszuwählen, wählen Sie Document Capture.
Wählen Sie die Serverinstanz aus, auf der die App installiert werden soll.
Dadurch wird die Installation von Document Capture gestartet, die je nach Größe Ihrer Datenbank 1–2 Minuten dauern kann. Wenn Sie fertig sind, drücken Sie zum Beenden eine beliebige Taste.
Wichtig
Wenn Sie Business Central auf eine andere Version oder ein kumulatives Upgrade aktualisieren, müssen Sie Document Capture deinstallieren und dann das Document Capture-Runtime Package installieren, das der neuen Version von Business Central entspricht.
Weitere Informationen finden Sie unter Upgrades für Business Central On-Premises installieren.