Installation & Konfiguration

Installation und Update
Installation
Setup herunterladen
AKTUELLE VERSION
TEST VERSION
ÄLTERE VERSIONEN
Installationsschritte
Starten Sie die Installation mit der "SelectLine.ghost Setup  xx.x.x.xxxxxx.exe". Der Ordner-Name wird für den Namen des "Dienstes" und der Bezeichnung des Browser-Tap übernommen.
Aktivieren Sie den Punkt "Öffne SelectLine.ghost im Browser" und gehen auf "Fertigstellen".
Im geöffnetem Standard Browser können Sie mit der Anpassung der Einstellungen vom SelectLine.ghost beginnen.
Update
Durch die Schnittstellen- Funktionen der SelectLine-API und der Shopify-API sowie die Wünsche der Anwender, wird die Anwendung ständig weiterentwickelt.
In der Fußzeile des Browser finden Sie die Version ihrer Installation. Die Version sollte immer der aktuell gültigen SelectLine Version entsprechen.
Auf der Startseite des SelectLine.ghosts sehen Sie neben den News den Changelog und bekommen angezeigt, ob ein Update verfügbar ist.
Ab Version 23.1.6.240831
Tastenkombination:
strg + alt + u
Damit starten Sie ein Update vom Ghost. Dies wird vollständig automatisch im Hintergrund durchgeführt
Bei älteren Versionen
Nach dem Herunterladen des Setups führen Sie die gleichen Schritte wir bei der Installation durch. Beachten Sie dabei, den selben Ordner für das Installationsverzeichnis zu wählen:
Diesen Dialog können Sie bestätigen.
Nach Abschluss des Updates prüfen Sie bitte, ob sich der Ghost über den Browser starten lässt. Ist dies erfolgreich, ist das Update abgeschlossen.

SelectLine - Einstellungen
Start der SelectLine-Einstellungen
Nach einer erfolgreichen Installation haben Sie mit dem Link über den Browser das Back End des FINN.ghost|Dienst aufgerufen.
Über das Menü wechseln Sie auf SelectLine -> Einstellungen
Hier werden alle Anpassungen zur Integration in ihre Datenstruktur vorgenommen. Der Zugriff auf ihre Daten wird über die SL API (Bestandteil von SL Mobile) und die SL SQL Datenbank hergestellt.
Konfigurationsbereiche
Datenbank
An dieser Stelle wird die Verbindung zu der MS-SQL Datenbank der SelectLine hergestellt.
Name
Name der SQL Datenbank des gewünschten SL Mandant (Beispiel: SL_MMandant)
Host
SQL Server Instanz
(Beispiel: srv_ghost\sqlexpress)
Nutzer & Passwort
An dieser Stelle wird ein Benutzer der SQL-Servers benötigt, der entsprechende Rechte auf die Tabellen der Datenbank besitzt. (Beispiel: sa)
API
Hier erfolgt die Verbindung zu der SelectLine-API.
URL
URL zum Aufruf der API. Nehmen Sie die URL zum SL-Mobile und ändern "slmobile" zu "slmobileApi". (Beispiel: https://localhost/slmobileApi)
AppKey
tragen Sie den AppKey "SelectLine.ghost" ein (nicht erforderlich bei der SelectLine Shopify Anbindung).
Diesen haben Sie beim Erwerb der API Schnittstelle von SelectLine vorab angegeben.
Die kann auch in SelectLine unter Hilfe -> Lizenzierung -> AppKeys eingesehen werden.
Sind hier Abweichungen, muss der aus Key aus SelectLine in den Ghost übernommenen werden.
Nutzer & Passwort
tragen Sie hier den in der SL-API-Konfiguration (SL Mobile) konfigurierten API-Benutzer ein
Lizenz
Die Lizenz wird vom Fachhändler oder Dako-IT bereitgestellt. Sie steuert, welche Module des SelectLine.ghosts freigeschalten werden.
FINN.ghost
Port
Über diesen Port ist die Oberfläche des SelectLine.ghots aufzurufen. Planen Sie mehrere Ghosts zu betrieben, empfiehlt es sich, diesen Port anzupassen.
Bildformat
Hier legen Sie fest, in welchem Bildformat die Bilder aus der SelectLine an das angeschlossene Shopsystem übertragen werden. Dabei spielt es keine Rolle, in welchem Format die Bilder in SL gespeichert sind.
Sie können aktuell zwischen png, jpg, webp und original wählen.
Nutzeranmeldung
Bei Aktivierung ist eine Benutzeranmeldung erforderlich.
Die Login Daten entsprechen den API Benutzern aus SL-Mobile.
EU-Auslands-Kontogruppen (OSS-Verfahren)
An dieser Stelle kann das OSS-Verfahren konfiguriert werden. Sie können für jedes Land festlegen, welche Kontengruppe bei dem Import von Bestellungen für den Kunden verwendet werden soll. Hierbei wird das Land der Lieferadresse berücksichtigt.
Zertifikat
Damit das Zertifikat im Browser als sicher angezeigt wird, muss dieses Installiert werden. Siehe hierzu: Zertifikat einrichten
E-Mail
Die Konfiguration für den  E-Mail Versand (SMTP)  ist optional. Die E-Mail-Funktion dient dem Versand von Log Informationen.
Host
SMTP Server
Port
Port des Protokolls
Verschlüsselte Verbindung
aktiviert Verschlüsselung
Microsoft365
aktiviert die Verwendung eines Microsoft365 Account
Nutzer
Benutzername
Passwort
Kennwort
Absender
Absender Mail Adresse
Absender Name
Absender Anzeigename
Empfänger
Ziel Mailadresse
Betreff
Individueller Mail Betreff
Intervall
Zeit Intervall zum versenden von Mails (in Minuten)
E-Mail - M365 OAuth
Um OAuth zu aktivieren muss im Azure Portal eine neue App Registrierung angelegt werden. Dabei sollte ein eindeutiger Name vergeben werden und die Umleitungs-URI muss die URL der FINN.ghost Installation sein die auf 
/api/settings/oauth/redirect endet.
Als nächstes muss im Reiter Zertifikate & Geheimnisse ein neuer Clientschlüssel erstellt werden. 
Nach der Erstellung wird ihnen der Wert angezeigt, diesen fürs erste abspeichern.
Als letzten Schritt müssen wir im Reiter API-Berechtigungen zwei neue Berechtigungen hinzufügen und diese einwilligen.
Microsoft Graph -> Delegierte Berechtigungen -> offline_access
Microsoft Graph -> Delegierte Berechtigungen -> SMTP.Send
Jetzt muss lediglich aus dem Reiter Übersicht die Daten in die FINN.ghost Konfiguration übernommen werden.
Azure Feld
FINN.ghost Feld
Anwendungs-ID (Client)
Client ID
Verzeichnis-ID (Mandant)
Tenant ID
Die Redirect URI ist der Wert der beim Anlegen der App hinterlegt wurde.
( in unserem Fall https://192.168.2.35:8083/api/settings/oauth/redirect )
Und als Client Secret wird der zuvor abgespeicherte Wert eingefügt.
Nachdem Klick auf Verbinden, werden Sie aufgefordert sich mit einem Microsoft Konto anzumelden.
E-Mail - M365 App-Only
Um App-Only zu aktivieren muss im Azure Portal eine neue App Registrierung angelegt werden. Dabei sollte ein eindeutiger Name vergeben werden.
Als nächstes muss im Reiter Zertifikate & Geheimnisse ein neuer Clientschlüssel erstellt werden. 
Nach der Erstellung wird ihnen der Wert angezeigt, diesen fürs erste abspeichern.
Als letzten Schritt müssen wir im Reiter API-Berechtigungen eine neue Berechtigungen hinzufügen und diese einwilligen.
Microsoft Graph -> Anwendungsberechtigungen -> Mail.Send
Jetzt muss lediglich aus dem Reiter Übersicht die Daten in die FINN.ghost Konfiguration übernommen werden.
Azure Feld
FINN.ghost Feld
Anwendungs-ID (Client)
Client ID
Verzeichnis-ID (Mandant)
Tenant ID
Nachdem Klick auf Speichern, wird versucht eine Test Email an das angegeben Konto zu schicken.
Wenn dies geklappt hat, ist die App-Only Authentifizierung erfolgreich eingerichtet.
Weitere Module
Je nach erworbener Lizenz, werden weitere Module als Menü eingeblendet.

Zertifikat einrichten
Das der Browser beim Zugriff auf den Ghost eine sichere Verbindung erkennt, muss ein Zertifikat eingerichtet werden.
Dazu sind zwei Schritte erforderlich.
Voraussetzung:
Im Link zum Ghost muss der PC Name und nicht die IP enthalten sein.
https://ihrghostserver:8084
1. Zertifikat auf in der Ghost Installation hinterlegen
SelecLine -> Einstellung -> FINN.ghost
Mit dem Button "ZERTIFIKAT DOWNLOAD" bitte die Datei cert.zip runterladen und entpacken.
Die beiden Dateien (server.cert, server,key) in das folgende Verzeichnis ihrer Ghost-Installation verschieben.
C:\DAKO\FINN.ghost\data\ssl
Die Dateien im Ordner "ssl" können Sie überschreiben. Danach bitte unter "Dienste" den Ghost Dienst neu starten.
2. Zertifikat am Client PC installieren
Dazu laden Sie sich dieses mit dem Button "ROOT ZERTIFIKAT DOWNLOAD" herunter und installieren es, je nach verwendetem Browser. Die Schritte zur Einrichtung weichen je nach verwendetem Browser ab.
Firefox
Firefox verwaltet die Zertifikate in den eigenen Einstellungen unter
Hier "Importieren" Sie bitte die heruntergeladenen Datei "RootCA.crt"
Chrome und andere
Verwaltung über das Betriebssystem Windows.
Installieren Sie das Zertifikat mit einem Doppelklick auf die Datei "RootCA.crt".
in diesem Dialog wählen Sie bitte das aus und bestätigen alle weiteren Dialoge

Makros
In den Ghost Modulen finden Sie den Punkt Makro. Hier können in SL erstellte Makros eingetragen werden, um Daten selektiert vor bzw. nach der Übertragung zu bearbeiten.
Tragen Sie im entsprechendem Feld den Dateinamen (nicht die Bezeichnung) den SL automatisch vergibt ein. 
Wenn Sie den Kurser im Feld haben, werden ihnen die erforderlichen "Parameter" des Makros angezeigt. Diese müssen gleichlautend vorhanden sein.