Installation (ArcFlow.Next) - Versionsgeschichte

Jens: Stand 4.1.16

2026-04-07T13:58:04Z

Stand 4.1.16

← Nächstältere Version		Version vom 7. April 2026, 13:58 Uhr
Zeile 122:		Zeile 122:
	== Erneuerung des Zertifikats ==		== Erneuerung des Zertifikats ==

	Zur Erneuerung des Zertifikats muss das neue Zertifikat in den Zertifikatsspeicher des Computers (nicht des Benutzers) als exportierbares Zertifikat eingelesen werden. Anschließend wird der "Thumbprint" in die "settings.json" in den Eintrag <~~pre~~ class=source>"JwtTokenSecret": "..."</~~pre~~> kopiert. Nach einem Neustart des Dienstes, wird das neue Zertifikat verwendet.		Zur Erneuerung des Zertifikats muss das neue Zertifikat in den Zertifikatsspeicher des Computers (nicht des Benutzers) als exportierbares Zertifikat eingelesen werden. Anschließend wird der "Thumbprint" in die "settings.json" in den Eintrag <font class=source>"JwtTokenSecret": "..."</font> kopiert. Nach einem Neustart des Dienstes, wird das neue Zertifikat verwendet.

	== Deinstallation ==		== Deinstallation ==

	Zu Deinstallation des Dienstes reicht es aus, den Dienst zu entfernen. Dazu können entweder die Funktionen des Betriebssystems verwendet oder das Betriebssystem-Skript "Service_uninstall.cmd" als Administrator ausgeführt werden. Der Dienst wird dann gestoppt und von den Diensten entfernt. Die Dateien im Installationsverzeichnis können anschließend gelöscht werden.		Zu Deinstallation des Dienstes reicht es aus, den Dienst zu entfernen. Dazu können entweder die Funktionen des Betriebssystems verwendet oder das Betriebssystem-Skript "Service_uninstall.cmd" als Administrator ausgeführt werden. Der Dienst wird dann gestoppt und von den Diensten entfernt. Die Dateien im Installationsverzeichnis können anschließend gelöscht werden.

Jens: Stand 4.1.16 Eintrag TokenTimeOut hinzugefügt / Erneuerung des Zertifikats

2026-04-07T13:55:41Z

Stand 4.1.16 Eintrag TokenTimeOut hinzugefügt / Erneuerung des Zertifikats

← Nächstältere Version		Version vom 7. April 2026, 13:55 Uhr
Zeile 52:		Zeile 52:
	"ClientConfigDirectoryName": "spa",		"ClientConfigDirectoryName": "spa",
	"ClientConfigFileName": "js\\config.js",		"ClientConfigFileName": "js\\config.js",
	"JwtTokenSecret": "..."		"JwtTokenSecret": "...",
			"TokenTimeOut": 28800
	},		},
	"Service": {		"Service": {
Zeile 97:		Zeile 98:
	:* <font class=source>JwtTokenSecret</font> - Das Verwalten der Sessions des Web-Clients und der WebApi erfolgt über [https://jwt.io/introduction JSON Web Tokens]. Der hier angegebene Schlüssel wird für die initiale Kontaktaufnahme benötigt. Anschließend werden Authentifizierungstoken und Sessiontoken ausgetauscht.		:* <font class=source>JwtTokenSecret</font> - Das Verwalten der Sessions des Web-Clients und der WebApi erfolgt über [https://jwt.io/introduction JSON Web Tokens]. Der hier angegebene Schlüssel wird für die initiale Kontaktaufnahme benötigt. Anschließend werden Authentifizierungstoken und Sessiontoken ausgetauscht.
	::<pre class=source>"JwtTokenSecret": "..."</pre>		::<pre class=source>"JwtTokenSecret": "..."</pre>
			:*<font class=source>TokenTimeOut</font> - Timeout des Sitzungstokens in Sekunden. Der Standardwert sind 8 Stunden (28800 Sekunden).
			::<pre class=source>"TokenTimeOut": 28800</pre>

	* <font class=source>Service</font>		* <font class=source>Service</font>
Zeile 118:		Zeile 121:

	== Erneuerung des Zertifikats ==		== Erneuerung des Zertifikats ==

			Zur Erneuerung des Zertifikats muss das neue Zertifikat in den Zertifikatsspeicher des Computers (nicht des Benutzers) als exportierbares Zertifikat eingelesen werden. Anschließend wird der "Thumbprint" in die "settings.json" in den Eintrag <pre class=source>"JwtTokenSecret": "..."</pre> kopiert. Nach einem Neustart des Dienstes, wird das neue Zertifikat verwendet.

	== Deinstallation ==		== Deinstallation ==

	Zu Deinstallation des Dienstes reicht es aus, den Dienst zu entfernen. Dazu können entweder die Funktionen des Betriebssystems verwendet oder das Betriebssystem-Skript "Service_uninstall.cmd" als Administrator ausgeführt werden. Der Dienst wird dann gestoppt und von den Diensten entfernt. Die Dateien im Installationsverzeichnis können anschließend gelöscht werden.		Zu Deinstallation des Dienstes reicht es aus, den Dienst zu entfernen. Dazu können entweder die Funktionen des Betriebssystems verwendet oder das Betriebssystem-Skript "Service_uninstall.cmd" als Administrator ausgeführt werden. Der Dienst wird dann gestoppt und von den Diensten entfernt. Die Dateien im Installationsverzeichnis können anschließend gelöscht werden.

Jens: /* Konfigurationsdatei */ Stand 4.1.16 Beschreibung angepasst

2026-03-04T08:53:04Z

Konfigurationsdatei: Stand 4.1.16 Beschreibung angepasst

← Nächstältere Version		Version vom 4. März 2026, 08:53 Uhr
Zeile 61:		Zeile 61:
	}</pre>		}</pre>

	Die Einstellungen des ArcFlow ~~WebApi~~ Dienstes erfolgen in der Datei "settings.json". In der Datei können folgende Einstellungen vorgenommen werden:		Die Einstellungen des ArcFlow Next Dienstes erfolgen in der Datei "settings.json". In der Datei können folgende Einstellungen vorgenommen werden:

	* <font class=source>LogLevel</font>		* <font class=source>LogLevel</font>
Zeile 101:		Zeile 101:
	:In diesem Bereich befinden sich Informationen zur Installation des Programms als Dienst. Änderungen in diesem Bereich sind erst nach einer erneuten Installation wirksam.		:In diesem Bereich befinden sich Informationen zur Installation des Programms als Dienst. Änderungen in diesem Bereich sind erst nach einer erneuten Installation wirksam.
	:* <font class=source>Description</font> - Beschreibung des Dienstes		:* <font class=source>Description</font> - Beschreibung des Dienstes
	::<pre class=source>"Description": "~~ArcFlowWebApiService~~"</pre>		::<pre class=source>"Description": "ArcFlow.Next.Service"</pre>
	:* <font class=source>DisplayName</font> - Anzeigename des Dienstes		:* <font class=source>DisplayName</font> - Anzeigename des Dienstes
	::<pre class=source>"DisplayName": "~~ArcFlowWebApiService~~"</pre>		::<pre class=source>"DisplayName": "ArcFlow Next Service"</pre>
	:* <font class=source>Name</font> - Name des Dienstes. Der Name muss unter den Diensten auf dem System eindeutig sein.		:* <font class=source>Name</font> - Name des Dienstes. Der Name muss unter den Diensten auf dem System eindeutig sein.
	::<pre class=source>"Name": "~~ArcFlowWebApiService~~"</pre>		::<pre class=source>"Name": "ArcFlow.Next.Service"</pre>

	=== Anpassungen für den Zugriff nicht nur von Außen ===		=== Anpassungen für den Zugriff nicht nur von Außen ===

Jens: /* Konfigurationsdatei */ Stand 4.1.16 "Service" in Konfigurationsdatei geändert

2026-03-04T08:50:43Z

Konfigurationsdatei: Stand 4.1.16 "Service" in Konfigurationsdatei geändert

← Nächstältere Version		Version vom 4. März 2026, 08:50 Uhr
Zeile 55:		Zeile 55:
	},		},
	"Service": {		"Service": {
	"Description": "~~ArcFlowWebApiService~~",		"Description": "ArcFlow.Next.Service",
	"DisplayName": "~~ArcFlowWebApiService~~",		"DisplayName": "ArcFlow Next Service",
	"Name": "~~ArcFlowWebApiService~~"		"Name": "ArcFlow.Next.Service"
	}		}
	}</pre>		}</pre>

Jens: /* Starten des Dienstes */ Programmname angepasst Stand 4.1.09

2025-02-27T09:32:57Z

Starten des Dienstes: Programmname angepasst Stand 4.1.09

← Nächstältere Version		Version vom 27. Februar 2025, 09:32 Uhr
Zeile 25:		Zeile 25:
	[[Datei:DE Start ArcFlowWebApiService.jpg\|thumb\|bottom\|Anzeige, nachdem das Programm gestartet wurde]]		[[Datei:DE Start ArcFlowWebApiService.jpg\|thumb\|bottom\|Anzeige, nachdem das Programm gestartet wurde]]

	Das Programm "~~ArcFlowWebApiService~~.exe" kann mit einem Doppelklick gestartet werden. Sollte in den Einstellungen der verwendetet Port auf einen Wert kleiner 9000 geändert werden, muss das Programm über den Menüpunkt "Als Administrator ausführen" des Kontextmenü des Explorers gestartet werden.		Das Programm "ArcFlow.Next.Service.exe" kann mit einem Doppelklick gestartet werden. Sollte in den Einstellungen der verwendetet Port auf einen Wert kleiner 9000 geändert werden, muss das Programm über den Menüpunkt "Als Administrator ausführen" des Kontextmenü des Explorers gestartet werden.

	Mit den jetzigen Einstellungen in der "settings.json" kann von der gleichen Maschine aus über den Link [http://localhost:9000 http://localhost:9000] die Web-Oberfläche von ArcFlow aufgerufen werden. Die Anmeldung erfolgt mit dem Benutzer "admin" und dem in ArcFlow hinterlegten Kennwort. Alle weiteren Benutzer in ArcFlow benötigen zur Anmeldung das Applikationsrecht "ArcFlow.Next Lese-Modus".		Mit den jetzigen Einstellungen in der "settings.json" kann von der gleichen Maschine aus über den Link [http://localhost:9000 http://localhost:9000] die Web-Oberfläche von ArcFlow aufgerufen werden. Die Anmeldung erfolgt mit dem Benutzer "admin" und dem in ArcFlow hinterlegten Kennwort. Alle weiteren Benutzer in ArcFlow benötigen zur Anmeldung das Applikationsrecht "ArcFlow.Next Lese-Modus".

Jens: /* Voraussetzungen für die Installation */

2024-01-22T14:07:48Z

Voraussetzungen für die Installation

← Nächstältere Version		Version vom 22. Januar 2024, 14:07 Uhr
Zeile 1:		Zeile 1:
	== Voraussetzungen für die Installation ==		== Voraussetzungen für die Installation ==

	Der ArcFlow WebApi Dienst kann auf einem Windows System ab der Version Microsoft Windows Server 2016 mit .NET Framework 4.~~7.2~~ installiert werden. Da das System für den Zugriff von außerhalb des eigenen Netzes gedacht ist, sollte das aktuelle Windows Betriebssystem mit den letzten Updates verwendet werden. Für die spätere Kommunikation über HTTPS muss ein Zertifikat vorhanden sein. Alle weiteren Voraussetzungen (Web-Server usw.) werden bei der Installation des Dienstes mit installiert.		Der ArcFlow WebApi Dienst kann auf einem Windows System ab der Version Microsoft Windows Server 2016 mit .NET Framework 4.8 installiert werden. Da das System für den Zugriff von außerhalb des eigenen Netzes gedacht ist, sollte das aktuelle Windows Betriebssystem mit den letzten Updates verwendet werden. Für die spätere Kommunikation über HTTPS muss ein Zertifikat vorhanden sein. Alle weiteren Voraussetzungen (Web-Server usw.) werden bei der Installation des Dienstes mit installiert.

	== Installation ==		== Installation ==

Jens am 21. Juli 2021 um 14:59 Uhr

2021-07-21T14:59:01Z

← Nächstältere Version		Version vom 21. Juli 2021, 14:59 Uhr
Zeile 1:		Zeile 1:
	== Voraussetzungen für die Installation ==		== Voraussetzungen für die Installation ==

	Der ArcFlow WebApi Dienst kann auf einem Windows System ab der Version Microsoft Windows Server 2016 mit .NET ~~Famework~~ 4.7.2 installiert werden. Da das System für den Zugriff von außerhalb des eigenen Netzes gedacht ist, sollte das aktuelle Windows Betriebssystem mit den letzten Updates verwendet werden. Für die spätere Kommunikation über HTTPS muss ein Zertifikat vorhanden sein. Alle weiteren Voraussetzungen (Web-Server usw.) werden bei der Installation des Dienstes mit installiert.		Der ArcFlow WebApi Dienst kann auf einem Windows System ab der Version Microsoft Windows Server 2016 mit .NET Framework 4.7.2 installiert werden. Da das System für den Zugriff von außerhalb des eigenen Netzes gedacht ist, sollte das aktuelle Windows Betriebssystem mit den letzten Updates verwendet werden. Für die spätere Kommunikation über HTTPS muss ein Zertifikat vorhanden sein. Alle weiteren Voraussetzungen (Web-Server usw.) werden bei der Installation des Dienstes mit installiert.

	== Installation ==		== Installation ==

Jens: /* Konfigurationsdatei */

2021-02-22T15:56:50Z

Konfigurationsdatei

← Nächstältere Version		Version vom 22. Februar 2021, 15:56 Uhr
Zeile 72:		Zeile 72:
	* <font class=source>Database</font>		* <font class=source>Database</font>
	:In diesem Bereich werden Einstellungen zur Datenbankverbindung angegeben. Änderungen in diesem Bereich sind erst nach einem Neustart des Dienstes wirksam.		:In diesem Bereich werden Einstellungen zur Datenbankverbindung angegeben. Änderungen in diesem Bereich sind erst nach einem Neustart des Dienstes wirksam.
	:* <font class=source>PgixMode</font> - Die Verbindung zur ArcFlow-Datenbank wird über eine DLL hergestellt. Diese DLL steht in unterschiedlichen Ausprägungen zur Verfügung. Mit der Angabe von <font class=source>Bit64</font>, <font class=source>Bit32</font> bzw. <font class=source>~~Extendes32~~</font> wird die 64-, 32-Bit DLL oder die 32-Bit DLL mit erweitertem Funktionsumfang geladen. Durch die Angabe von <font class=source>Auto</font> wird die für das System geeignete DLL geladen.		:* <font class=source>PgixMode</font> - Die Verbindung zur ArcFlow-Datenbank wird über eine DLL hergestellt. Diese DLL steht in unterschiedlichen Ausprägungen zur Verfügung. Mit der Angabe von <font class=source>Bit64</font>, <font class=source>Bit32</font> bzw. <font class=source>Extended32</font> wird die 64-, 32-Bit DLL oder die 32-Bit DLL mit erweitertem Funktionsumfang geladen. Durch die Angabe von <font class=source>Auto</font> wird die für das System geeignete DLL geladen.
	::<pre class=source>"PgixMode": "Auto"</pre>		::<pre class=source>"PgixMode": "Auto"</pre>
	:<font class=source>ServerName</font> - Name oder IP-Adresse des ArcFlow Datenbankservers. Ist der Datenbankserver auf der gleichen Maschine gestartet, kann auch "" angegeben werden.		:<font class=source>ServerName</font> - Name oder IP-Adresse des ArcFlow Datenbankservers. Ist der Datenbankserver auf der gleichen Maschine gestartet, kann auch "" angegeben werden.

Jens: /* Starten des Dienstes */

2021-02-22T15:54:49Z

Starten des Dienstes

← Nächstältere Version		Version vom 22. Februar 2021, 15:54 Uhr
Zeile 27:		Zeile 27:
	Das Programm "ArcFlowWebApiService.exe" kann mit einem Doppelklick gestartet werden. Sollte in den Einstellungen der verwendetet Port auf einen Wert kleiner 9000 geändert werden, muss das Programm über den Menüpunkt "Als Administrator ausführen" des Kontextmenü des Explorers gestartet werden.		Das Programm "ArcFlowWebApiService.exe" kann mit einem Doppelklick gestartet werden. Sollte in den Einstellungen der verwendetet Port auf einen Wert kleiner 9000 geändert werden, muss das Programm über den Menüpunkt "Als Administrator ausführen" des Kontextmenü des Explorers gestartet werden.

	Mit den jetzigen Einstellungen in der "settings.json" kann von der gleichen Maschine aus über den Link [http://localhost:9000 http://localhost:9000] die Web-Oberfläche von ArcFlow aufgerufen werden. Die Anmeldung erfolgt mit dem Benutzer "admin" und dem in ArcFlow ~~hinterlegtem~~ Kennwort. Alle weiteren Benutzer in ArcFlow benötigen zur Anmeldung das Applikationsrecht "ArcFlow.Next Lese-Modus".		Mit den jetzigen Einstellungen in der "settings.json" kann von der gleichen Maschine aus über den Link [http://localhost:9000 http://localhost:9000] die Web-Oberfläche von ArcFlow aufgerufen werden. Die Anmeldung erfolgt mit dem Benutzer "admin" und dem in ArcFlow hinterlegten Kennwort. Alle weiteren Benutzer in ArcFlow benötigen zur Anmeldung das Applikationsrecht "ArcFlow.Next Lese-Modus".

	Zur Installation als Dienst muss das Programm wieder beendet werden und das Betriebssystem-Skript "Service_install.cmd" als Administrator ausgeführt werden. Das Skript installiert das Programm als Dienst und startet es.		Zur Installation als Dienst muss das Programm wieder beendet werden und das Betriebssystem-Skript "Service_install.cmd" als Administrator ausgeführt werden. Das Skript installiert das Programm als Dienst und startet es.

Jens am 12. Februar 2021 um 08:26 Uhr

2021-02-12T08:26:14Z

← Nächstältere Version		Version vom 12. Februar 2021, 08:26 Uhr
Zeile 52:		Zeile 52:
	"ClientConfigDirectoryName": "spa",		"ClientConfigDirectoryName": "spa",
	"ClientConfigFileName": "js\\config.js",		"ClientConfigFileName": "js\\config.js",
	~~"CertificateThumbprint": "",~~
	"JwtTokenSecret": "..."		"JwtTokenSecret": "..."
	},		},
Zeile 96:		Zeile 95:
	:* <font class=source>ClientConfigFileName</font> - In dieser Datei sind weitere Einstellungen für den Web-Client enthalten. Die Angabe erfolgt relativ zum Verzeichnis des Web-Clients. In dem Beispiel ist das der Pfad "...\Services\WebApi\spa\js\config.js".		:* <font class=source>ClientConfigFileName</font> - In dieser Datei sind weitere Einstellungen für den Web-Client enthalten. Die Angabe erfolgt relativ zum Verzeichnis des Web-Clients. In dem Beispiel ist das der Pfad "...\Services\WebApi\spa\js\config.js".
	::<pre class=source>"ClientConfigFileName": "js\\config.js"</pre>		::<pre class=source>"ClientConfigFileName": "js\\config.js"</pre>
	:* <font class=source>CertificateThumbprint</font> - Der Fingerabdruck des verwendeten Zertifikats. Der Fingerabdruck kann über die Zertifikatsverwaltung den Details des Zertifikats entnommen werden. Der Eintrag ist für zukünftige Erweiterungen vorhanden, um die Erneuerung von Zertifikaten zu vereinfachen.
	~~::<pre class=source>"CertificateThumbprint": ""</pre>~~
	:* <font class=source>JwtTokenSecret</font> - Das Verwalten der Sessions des Web-Clients und der WebApi erfolgt über [https://jwt.io/introduction JSON Web Tokens]. Der hier angegebene Schlüssel wird für die initiale Kontaktaufnahme benötigt. Anschließend werden Authentifizierungstoken und Sessiontoken ausgetauscht.		:* <font class=source>JwtTokenSecret</font> - Das Verwalten der Sessions des Web-Clients und der WebApi erfolgt über [https://jwt.io/introduction JSON Web Tokens]. Der hier angegebene Schlüssel wird für die initiale Kontaktaufnahme benötigt. Anschließend werden Authentifizierungstoken und Sessiontoken ausgetauscht.
	::<pre class=source>"JwtTokenSecret": "..."</pre>		::<pre class=source>"JwtTokenSecret": "..."</pre>
Zeile 114:		Zeile 111:
	Mit den Einstellungen nach der Installation kann der Dienst nur von der lokalen Maschine aus aufgerufen werden. Um den Zugriff von einer anderen Maschine zu ermöglichen, muss der Eintrag <font class=source>Host</font> auf den Namen der Maschine oder die IP-Adresse geändert werden.		Mit den Einstellungen nach der Installation kann der Dienst nur von der lokalen Maschine aus aufgerufen werden. Um den Zugriff von einer anderen Maschine zu ermöglichen, muss der Eintrag <font class=source>Host</font> auf den Namen der Maschine oder die IP-Adresse geändert werden.

	Soll die Kommunikation der Web-Clients mit der WebApi über HTTPS abgesichert werden, wird ein Zertifikat benötigt. Das Zertifikat kommt in der Form einer PFX-Datei. Es muss mit Hilfe des "Zertifikatimport-Assistent" auf dem lokalen Computer gespeichert und der Schlüssel als exportierbar markiert ~~werden. In der Zertifikatsverwaltung kann der Fingerabdruck des Zertifikats kopiert und in der <font class=source>settings.json</font> unter <font class=source>CertificateThumbprint</font> eingetragen~~ werden. Zudem muss der Eintrag <font class=source>Scheme</font> in <font class=source>https</font> geändert werden.		Soll die Kommunikation der Web-Clients mit der WebApi über HTTPS abgesichert werden, wird ein Zertifikat benötigt. Das Zertifikat kommt in der Form einer PFX-Datei. Es muss mit Hilfe des "Zertifikatimport-Assistent" auf dem lokalen Computer gespeichert und der Schlüssel als exportierbar markiert werden. Zudem muss der Eintrag <font class=source>Scheme</font> in <font class=source>https</font> geändert werden.

	Bevor der Dienst für einen Zugriff freigegeben wird, sollten die Kennwörter des Benutzers "admin" und aller weiteren Benutzern, die Zugriff bekommen, überprüft werden. Innerhalb von ArcFlow können entsprechende [[Berechtigungen_-_Allgemein#Passwortrichtlinien\|Passwortrichtlinien]] definiert werden.		Bevor der Dienst für einen Zugriff freigegeben wird, sollten die Kennwörter des Benutzers "admin" und aller weiteren Benutzern, die Zugriff bekommen, überprüft werden. Innerhalb von ArcFlow können entsprechende [[Berechtigungen_-_Allgemein#Passwortrichtlinien\|Passwortrichtlinien]] definiert werden.