| Table of Contents | ||
|---|---|---|
|
Installation des File Service
...
Vor der Ausführung des Setups muss der IIS-Manager geschlossen sein, achten Sie bitte darauf. Ansonsten kann es zu Problemen bei der Installation kommen.
Starten Sie das Setup_All.exe unter dem Benutzer "nbauen" auf dem Web Server.
...
Bestätigen Sie die Abfrage mit "JA".
...
Das Setup wird Ihnen direkt mitteilen, dass .NET Framework 4.8 nachinstalliert werden muss; stimmen Sie zu.
...
Der Default-Browser wird sich öffnen und Sie direkt zum Download von .NET 4.8 führen; führen Sie das Downloadpaket direkt aus.
...
Anschließend sehen Sie, wie sich das Setup von .NET öffnet.
...
Stimmen Sie den Lizenz-Bestimmungen zu und klicken Sie auf "Installieren".
...
Bitte warten Sie einen Augenblick, bis .NET installiert ist.
...
.NET ist nun installiert, klicken Sie auf "Fertigstellen".
...
Danach wird das Setup Sie darauf hinweisen, dass der Rechner neu gestartet werden muss; klicken Sie auf "Neustarten".
...
Führen Sie danach das Setup_All.exe erneut aus.
...
Bestätigen Sie mit "Ja".
...
Einleitung
Der „File Service“ bietet die Möglichkeit, die im Netzwerk verstreuten Daten zu zentralisieren, um so einen eventuellen Umstieg auf Cloudspeicherlösungen, zum Beispiel „Azure Storage-Plattform“, zu vereinfachen.
Der „File Service“ ist ein IIS-Dienst, der bestimmte Speicherorte, Dokumente und Dateien verwaltet, auf die über HTTPS per REST-API zugegriffen werden kann.
Speicherorte, die über den „File Service“ verwaltet werden sollen, sind einem bestimmten „Tenant“ untergeordnet. Hierbei ist „Tenant“ ein Oberbegriff, der vom Administrator frei gewählt werden kann.
Es können beliebig viele „Tenants“ und Speicherorte angelegt werden.
Weiterhin wird bei den Speicherorten zwischen „Internen“ (zentrale Speicherorte) und „Externen“ (dezentrale Speicherorte) unterschieden.
Für die Anlage von zentralen Speicherorten (Intern) ist nur die Bezeichnung des gewünschten Speicherortes notwendig.
Der genaue Ablageort wird automatisch vom „File Service“ bestimmt. Der zentrale Ablageort ist in einer Konfigurationsdatei hinterlegt und kann vom Administrator geändert werden.
Der Ablageort von dezentralen Speicherorten (Extern) ist individuell und muss bei der Anlage angegeben werden.
Dateien und Dokumente, die in den angelegten, bzw. bekannt gemachten Speicherorten liegen, werden vom „File Service“ automatisch erkannt und müssen nicht „bekannt gemacht“ werden.
Der File Service wird auf dem Webserver installiert und ist auch nur auswählbar im Zusammenhang mit dem Webserver.
Wählen Sie hier bitte "Benutzerdefiniert".
...
Wählen Sie hier bitte nur den Eintrag "File Service " aus. Klicken Sie anschließend auf "Weiter".
...
Bitte geben Sie hier den Port ein, unter dem File Service erreichbar sein soll.
Beim Dienstkonto und Passwort handelt es sich um die Zugangsdaten, unter denen der File Service auf die Base URI zugreifen soll. Dieser Benutzer muss berechtigt sein auf Ihre UNC-Pfade und lokalen Pfade zuzugreifen. Höchstwahrscheinlich bei Ihnen der Service-Benutzer der Mittelschicht.
Die Base URI ist der Pfad unter dem der File Service die eigentlichen Daten ablegt. Dies kann ein normaler lokaler Pfad auf dem Webserver sein. Voraussetzung ist, dass die Zugangsdaten Lese- und Schreibrechte auf den Pfad besitzen.
Bestätigen Sie mit "Weiter".
...
Klicken Sie auf "Jetzt installieren".
...
Der File Service ist nun installiert.
...
Dies können Sie folgendermaßen überprüfen:
...
Unter: http://IPDESSERVERS:PORTBEIDERINSTALLATION/swagger/index.html können Sie prüfen, ob die Schnittstelle erreichbar ist.
Es wird eine Anmeldung abgefragt. Geben Sie hier den Benutzernamen und das Passwort ein, welches Sie zuvor beim Setup angegeben haben.
Unter:
...
ist der Ort, unter dem der File Service installiert wird.
...
| Info |
|---|
Der File Service wird jetzt standardmäßig mit der Basic Auth eingerichtet, deswegen ist die SSL-Verschlüsselung nun nicht mehr optional, sondern Pflicht. Legen Sie die https-Bindung zuerst auf 7081 fest. Anschließend löschen Sie die standardmäßige http-Bindung auf 7080 und stellen dann die https-Bindung auf Port 7080 oder den passenden Port Ihrer Wahl um.  |
Der Benutzername und das Passwort, welches Sie für die Einrichtung im Webclient im nächsten Kapitel verwenden, sollte das Konto sein, welches Sie bei der Einrichtung im Setup schon einmal angegeben haben.
...
Die Einrichtung für den „File Service“ sollte vom Administrator durchgeführt werden und kann in Finance wie folgt aufgerufen werden:
Über die Suche nach „Einrichtung Dateiverwaltung“
...
2. Über Rolle (IT-Management) -> Benutzerverwaltung -> Zugriffspfade -> Vorbereiten -> Einrichtung Dateiverwaltung
Notwendige Einrichtungen
Um den „File Service“ betriebsbereit einzurichten, führen Sie folgende Schritte aus:
„Basis Url“ eintragen.
„Tenant“ eintragen.
"Benutzername" eintragen.
"Passwort" eintragen.
„Verbindung prüfen“ ausführen.
„Aktiviert“ auf ja setzen.
Sobald der "File Service" korrekt eingerichtet ist, können Speicherorte und Dateien wie folgt verwaltet werden:
Über die Funktionen der "Einrichtung Dateiverwaltung". (Siehe Funktionen - "Einrichtung Dateiverwaltung")
Über die Funktionen der Übersicht "Zugriffspfade". (Siehe Funktionen - "Migration Dateisystem nach Fileservice (mit dezentraler Verwaltung)" )
Einrichtungsfelder
Folgende Einrichtungen sind für den „File Service“ möglich:
...
Standardimplementierung
Gibt die Implementierung der Dateiverwaltung an. Um den „File Service“ nutzen zu können, muss hier die Auswahl auf „File Service“ erfolgen.
...
Tenant
Gibt den Tenant an, der im System bei im System bei den „File Service“ Operationen verwendet wird. „Tenant“ ist ein Oberbegriff, der vom Administrator frei gewählt werden kann. Falls Tenants bereits angelegt wurden, kann ein Tenant hier bequem über „Assist Edit“ ausgewählt werden.
...
Folgende Funktionen stehen in der „Einrichtung Dateiverwaltung“ zur Verfügung:
...
Verbindung prüfen
Prüft die Verbindung des „File Service“. Gibt je nach Erreichbarkeit des „File Service“ eine positive oder negative Meldung zurück. Wenn der „File Service“ erreichbar ist, wird das Feld „Interne Basisadresse“ automatisch gefüllt.
...
Weiterhin können in dieser Übersicht Tenants entfernt werden (Achtung, dabei werden auch alle unter dem Tenant bekannt gemachten Speicherorte entfernt) und die jeweils tenantbezogenen Speicherorte angezeigt werden.
...
Tenants anlegen
Gibt die Möglichkeit, im „File Service“ neue Tenants anlegen zu können / bekannt zu machen.
Nachdem die gewünschten Tenants eingetragen wurden (Code und Name des Tenants), können Sie über die Funktion „Tenants anlegen“ im „File Service“ angelegt werden. Dann stehen diese Tenants als Auswahl zur Verfügung.
...
Speicherorte anzeigen
Zeigt alle Speicherorte an, die mit dem Tenant bekannt gemacht worden sind, der in der „Einrichtung Dateiverwaltung“ eingerichtet ist. Wenn man Speicherorte einsehen möchte, die unter einem anderen Tenant als dem in der Einrichtung hinterlegten angelegt worden sind, kann man wie folgt vorgehen:
„Einrichtung Dateiverwaltung“ -> „Tenants anzeigen“ -> Tenant auswählen -> „Speicherorte anzeigen“
...
Weiterhin können in dieser Übersicht Speicherorte entfernt werden (Speicherorte und Dateien werden dabei nicht gelöscht, sondern nur aus der „Verwaltung“ des „Files Service“ entfernt).
...
Gibt die Möglichkeit, im „File Service“ neue Speicherorte anlegen zu können / bekannt zu machen.
...
Der „Tenant“ wird bei der Eingabe immer mit dem Tenant aus der Einrichtung vorbelegt.
Im Code kann man den gewünschten Code für den Tenant hinterlegen. Wenn man einen Speicherort unter einem anderem anlegen möchten (Unterverzeichnis), kann man über den „Assist Edit“ den jeweiligen Speicherort auswählen, in dem man den neuen Speicherort anlegen möchte und das Feld „Code“ um den gewünschten Speicherort ergänzen.
Beispiel:
Speicherort „FIBU“ ist bereits vorhanden.
Man möchte einen weiteren Speicherort „STEUER“ im Speicherort „FIBU“ anlegen.
Man wählt den Speicherort „FIBU“ über den „Assist Edit“ -> Im Feld „Code“ steht „FIBU\“
Das kann man nun um den gewünschten Speicherort „STEUER“ erweitern und erhält -> „FIBU\STEUER\“
Den Namen der Speicherorte kann man hier frei vergeben. Über das Feld „Extern“ wird gesteuert, ob der Speicherort „Intern“ oder „Extern“ angelegt wird.
...
Hier kann man eine Datei in einem bestimmten Speicherort ablegen.
Auswahl des Speicherortes (hier Storage)
Benennung der Datei im Feld „Name“
Linksklick auf das Feld „Name mit Pfad“ Auswahl der Datei
Funktion „Datei ablegen“ legt die Datei im jeweiligen Speicherort ab.
Anmerkungen
Das Anlegen / Bekanntmachen von Speicherorten kann auch unter „Zugriffspfade“ erfolgen.
Der in der Einrichtung hinterlegte Tenant muss nicht aktiv angelegt werden, wenn Speicherorte über „Zugriffspfade“ angelegt werden. Die Anlage, falls der Tenant nicht vorhanden ist, erfolgt im System automatisch.
Über die relevanten Einrichtungsfelder für Speicherorte kann der Benutzer nicht vorhandene Speicherorte automatisch anlegen lassen. Der Benutzer wird abgefragt, ob der nicht vorhandene Speicherort automatisch angelegt werden soll.
Hierbei müssen folgende Voraussetzungen erfüllt sein: Speicherort ist nicht vorhanden; der Benutzer hat die notwendigen Rechte, um Einträge in "Zugriffspfade" zu tätigen; File Service ist aktiviert.
Info: Die jeweilige "Gruppen - ID" muss in der Übersicht "Zugriffspfade" im Anschluss ergänzt werden. Die automatisch erstellten Zugriffspfade haben keine Zuordnung der Gruppen ID und können somit von allen Benutzern verwendet werden.
Migration Dateisystem nach Fileservice (mit dezentraler Verwaltung)
...
Um bestehenden Kunden eine einfache und schnelle Nutzungsmöglichkeit für den „File Service“ bieten zu können, wurde folgende Vorgehensweise entwickelt:
Alle bestehenden und verwendeten Speicherorte (Verzeichnisse) sollen in der Übersicht „Zugriffspfade“ eingetragen / nachgetragen werden. Hierzu stehen hilfreiche Übersichten („Zugriffspfade der Einrichtungen“) und Hilfsfunktionen („Mehrere Pfade zuordnen“) zur Verfügung. Im Idealfall sind die meisten / alle Speicherorte, die vom System benutzt werden, bereits in der Übersicht enthalten. ACHTUNG! Speicherorte sollten keine Laufwerksbuchstaben enthalten.
Bei Bedarf können hier auch Rollenberechtigungen je Speicherort vergeben werden. Die Funktionen „Berechtigte Benutzer“ und „Nicht berechtigte Benutzer“ geben dem Benutzer eine ausführliche Übersicht über die Berechtigungen für den jeweiligen Speicherort.
Sobald die Übersicht „Zugriffspfade“ wie gewünscht eingerichtet wurde, können alle Speicherorte bequem über die Funktion „Alle Speicherorte einrichten“ im „File Service“ angelegt / bekannt gemacht werden. Die Information, ob die Speicherorte „Intern“ oder „Extern“ angelegt werden, wird aus „Einrichtung Dateiverwaltung“ entnommen.
Über die Hilfsfunktion „Speicherorte erreichbar“ kann im Nachgang geprüft werden, welche Speicherorte vom „File Service“ erreichbar sind.
Einzelne Speicherorte können im Nachgang über die Funktion „Einen Speicherort einrichten“ ergänzt werden. Hierbei wird dann nur der jeweilige Speicherort im „File Service“ angelegt / bekannt gemacht.
(Optional) Falls beim Erstellen der Speicherorte ein Fehler unterlaufen ist und man mehrere Speicherorte wieder entfernen möchte, kann die Funktion "Mehrere Speicherorte entfernen" ausgeführt werden.
Zugriffspfade
Die Übersicht „Zugriffspfade“ zeigt Speicherorte und die Zuordnung der jeweiligen Rollenberechtigung.
Die „Zugriffspfade“ können in Finance wie folgt aufgerufen werden:
Über die Suche nach „Zugriffspfade“
...
2. Über Rolle (IT-Management) -> Benutzerverwaltung -> Zugriffspfade
...
Funktionen
Neu
Erstellt einen neuen Datensatz. Hier kann ein neuer oder bestehender Speicherort eingetragen werden und die jeweilige Berechtigung zugeordnet werden.
...