Changes for page Helpdesk Web Interface installieren

Summary

• Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

...	...	@@ -11,7 +11,7 @@
11	11	* .NET Framework 4.6.2 is already installed or will be installed when you install Internet Information Service
12	12	* Port 80 or the port set in the IIS settings must be accessible.
13	13
14		-To be able to use the helpdesk to its full extent, first install IIS and the .NET Framework. Only then should you enter the necessary configurations in the ACMP Console.
	14	+To be able to use the helpdesk to its full extent, first install IIS and the .NET Framework. Only then should you enter the necessary configurations in the acmp Console.
15	15
16	16	== Installation under Windows Server 2016, 2019 or 2022 ==
17	17
...	...	@@ -55,15 +55,20 @@
55	55
56	56	IIS is included as an additional Windows component by default, but must be installed in advance in order to be used. The following section therefore explains the installation of IIS for the following Windows Server versions: IIS 10: Windows Server 2016, Windows Server 2019 and Windows Server 2022.
57	57
	58	+{{box}}
	59	+**Tip: Loading times in the Web Interface**
	60	+Loading times in the Web Interface can sometimes be very long, which may affect your workflow. Check the Internet Information Services (IIS) Manager to see how the start mode is set for this.
	61	+You can access it as follows: Open the IIS Manager and select your server in the right-hand navigation pane. Then click on “Application Pools” and select the entry "ACMPWebInterfaces" from the list. Now right-click to open the advanced settings and check the start mode in the //General //section, if it be set to “AlwaysRunning”.
	62	+{{/box}}
58	58
59		-= Configurations in the ACMP Console =
	64	+= Configurations in the acmp Console =
60	60
61		-Follow the steps to complete the configuration for using the Web Interface in the ACMP Console.
	66	+Follow the steps to complete the configuration for using the Web Interface in the acmp Console.
62	62	)))
63	63
64	64	== 1. Classify IP address as trusted ==
65	65
66		-In the ACMP Console, navigate to //System// > //Settings// > //ACMP// //Server// > //Networks//. To allow all requests from the Web Interface, you must first classify the IP address of the web server as trusted. Under //Trusted Web Servers//, insert the server on which the Web Interface is installed and whose requests are to be allowed. If the Web Interface is installed on the same computer as the ACMP server, it is already entered with the address 127.0.0.1. If this is not the case, you must enter the network address manually. To do this, click on //Add//, enter the network address and then click on //OK//. The IP address now appears below the trusted web servers.
	71	+In the acmp Console, navigate to //System// > //Settings// > //acmp// //Server// > //Networks//. To allow all requests from the Web Interface, you must first classify the IP address of the web server as trusted. Under //Trusted Web Servers//, insert the server on which the Web Interface is installed and whose requests are to be allowed. If the Web Interface is installed on the same computer as the acmp server, it is already entered with the address 127.0.0.1. If this is not the case, you must enter the network address manually. To do this, click on //Add//, enter the network address and then click on //OK//. The IP address now appears below the trusted web servers.
67	67
68	68
69	69	[[Enter IP address as trusted server>>image:69_Helpdesk Web Interface Vertrauenswürdige Webserver_746.png]]
...	...	@@ -73,7 +73,6 @@
73	73	{{/aagon.warnungsbox}}
74	74
75	75
76		-
77	77	== 2. Enable Web Interface ==
78	78
79	79	In the settings, open //Web Interface// > //General//. Enable the checkbox //Helpdesk Web Interface is active// and save the configuration via the ribbon bar.
...	...	@@ -86,17 +86,19 @@
86	86	There are three ways to access the Web Interface:
87	87
88	88	|(% style="width:147px" %)**Access**|(% style="width:270px" %)**Call**|(% style="width:1276px" %)**Description**
89		-|(% style="width:147px" %)Self Service|(% style="width:270px" %)http:~/~/[Server-IP]/Self-Service/|(% style="width:1276px" %)The Self Service Web Interface enables employees to create tickets, which can then be edited by helpdesk staff. To access the Self Service Web Interface, a user account must be created in the ACMP Console (see User Management).
90		-|(% style="width:147px" %)Self Service SSO|(% style="width:270px" %)http:~/~/[Server-IP]/Self-Service/SSO|(% style="width:1276px" %)You can enable Single Sign-On for the Self Service Web Interface. To do this, the user must be logged on to an [[Active Directory>>doc:ACMP.69.ACMP-Solutions.System.Einstellungen.ACMP Server.WebHome||anchor="HActiveDirectory"]] and [[AD authentication>>doc:ACMP.69.ACMP-Solutions.System.Einstellungen.ACMP Server.WebHome||anchor="HActiveDirectory"]] must also be activated in the ACMP Console.
	93	+|(% style="width:147px" %)Self Service|(% style="width:270px" %)http:~/~/[Server-IP]/Self-Service/|(% style="width:1276px" %)The Self Service Web Interface enables employees to create tickets, which can then be edited by helpdesk staff. To access the Self Service Web Interface, a user account must be created in the acmp Console (see User Management).
	94	+|(% style="width:147px" %)Self Service SSO|(% style="width:270px" %)http:~/~/[Server-IP]/Self-Service/SSO|(% style="width:1276px" %)You can enable Single Sign-On for the Self Service Web Interface. To do this, the user must be logged on to an [[Active Directory>>doc:ACMP.610.ACMP-Solutions.System.Einstellungen.ACMP Server.WebHome||anchor="HActiveDirectory"]] and [[AD authentication>>doc:ACMP.610.ACMP-Solutions.System.Einstellungen.ACMP Server.WebHome||anchor="HActiveDirectory"]] must also be activated in the acmp Console.
91	91	|(% style="width:147px" %)Helpdesk|(% style="width:270px" %)http:~/~/[Server-IP]/Helpdesk/|(% style="width:1276px" %)As a helpdesk employee, you have access to the helpdesk and to the tickets assigned to you, which you can also edit.
92	92
93	93
94	94
95		-= Updating the web interfaces =
	99	+= Updating the Web Interfaces =
96	96
97		-After installing an ACMP update, it may be necessary to update the web interface for the helpdesk. When patching to a new ACMP version, all solutions that you have installed are usually updated and upgraded. One exception is the web interface, as it is a standalone application. Therefore, if an ACMP update affects the web interface, it must also be updated. You can find out whether an update is required and necessary in the respective [[Release Notes>>https://www.aagon.com/produkte/ueberblick/release-notes-acmp/]].
	101	+After installing an acmp update, it may be necessary to update the Web Interface for the helpdesk. When patching to a new acmp version, all solutions that you have installed are usually updated and upgraded. One exception is the web interface, as it is a standalone application. Therefore, if an acmp update affects the web interface, it must also be updated. You can find out whether an update is required and necessary in the respective [[Release Notes>>https://www.aagon.com/produkte/ueberblick/release-notes-acmp/]] and also in the installation instructions during the console update. The wizard will provide you with info on whether the Web Interface is also listed as an affected component.
98	98
	103	+[[Excerpt from the installation instructions (Web Interface update required)>>image:69_Web Interface Update_956.png]]
99	99
	105	+If an update is necessary, open //WebSetups.msi// (C:\Program Files (x86)\Aagon\ACMP Server\Clients\WebInterfaceSetup) and follow the steps to update the version to match that of the acmp Console. The update is now complete.
100	100
101	101	== Procedure for reinstalling the Web Interface ==
102	102
...	...	@@ -104,17 +104,17 @@
104	104
105	105	2. Run through the installation wizard. To install the web interfaces in the directory you have selected, select //Install //or specify a different installation path. The installation will begin.
106	106
107		-3. After the update, check that the correct port and IP address have been entered in the configuration files by the ACMP Server.
	113	+3. After the update, check that the correct port and IP address have been entered in the configuration files by the acmp Server.
108	108
109	109
110	110	[[Web Interface Installation Wizard>>image:69_ACMP Web Interface Installer_495.png]]
111	111
112	112	{{aagon.infobox}}
113		-By default, the server port is not transferred during installation or when updating the web interface if it was changed during the ACMP server installation. Therefore, the values must be checked in this step and customized if necessary!
	119	+By default, the server port is not transferred during installation or when updating the web interface if it was changed during the acmp server installation. Therefore, the values must be checked in this step and customized if necessary!
114	114	{{/aagon.infobox}}
115	115
116	116	{{aagon.infobox}}
117		-If you are unsure about the Server name and Server port, you can find the [[value in settings.ini>>doc:ACMP.69.Arbeiten mit der ACMP Console.Globale Elemente und Funktionen.Aufbau und Konfiguration der settings\.ini.WebHome]] in the ACMP network share in the ACMP Server > Clients folder. Otherwise, you can proceed directly to the next step.
	123	+If you are unsure about the Server name and Server port, you can find the [[value in settings.ini>>doc:ACMP.610.Arbeiten mit der ACMP Console.Globale Elemente und Funktionen.Aufbau und Konfiguration der settings\.ini.WebHome]] in the acmp network share in the acmp Server > Clients folder. Otherwise, you can proceed directly to the next step.
118	118	{{/aagon.infobox}}
119	119
120	120	[[Values in settings.ini>>image:69_Web Interface settings.ini_468.png]]
...	...	@@ -132,19 +132,17 @@
132	132
133	133	{{/code}}
134	134
	141	+== Special cases in Web.config (helpdesk web interface configuration file) ==
135	135
	143	+Some settings can be configured via the ‘Web.config’ (see above). Changes can be made primarily under <appSettings>. This includes, for example, the following setting:
136	136
137		-== Special case in web.config (helpdesk web interface configuration file) ==
138		-
139		-The following additional setting is available in web.config (see above):
140		-
141	141	{{code}}
142	142	<add key="HttpsHyperlinkCustomFieldsPrefix" value="true"/> - Default: True
143	143	{{/code}}
144	144
145		-If this row is not displayed, you can insert it under <appSettings>.
	149	+[[Inserted row>>image:69_Web Interface_Config Datei.png||alt="69_Web Interface_Sonderfall Config Datei_758.png"]]
146	146
147		-[[Inserted row>>image:69_Web Interface_Sonderfall Config Datei_758.png]]
	151	+__Tip__: If this row is not displayed, you can insert it under <appSettings>.
148	148
149	149	If the option is set to ‘True’, the hyperlink addresses of the CustomFields of the type //Hyperlink// that do not have an HTTP or HTTPS prefix are automatically assigned HTTPS in the Web Interface so that they can be accessed:
150	150
...	...	@@ -162,8 +162,19 @@
162	162
163	163	{{/code}}
164	164
165		-The update is now complete.
	169	+In addition, you can specify in Web.config whether the first element of the information and login page should always be opened when loading or not. With acmp version 6.9.2, you have the option of configuring this area and specifying whether the element is expanded (default) or not.
	170	+
166	166
	172	+{{code}}
	173	+<add key="InfoListOpenFirstItem" value="true"/>
	174	+<add key="InfoListLoginOpenFirstItem" value="true"/>
	175	+
	176	+ </appSettings>
	177	+
	178	+{{/code}}
	179	+
	180	+ The setting ‘InfoListOpenFirstItem’ specifies the default for the information page, while the row ‘InfoListLoginOpenFirstItem’ overrides this for the login page, where the user first logs in. The following possible values apply to both: The value ‘True’ means that the top (first) element is expanded, and ‘False’ means that it is collapsed (on both the information and login pages).
	181	+
167	167	{{aagon.infobox}}
168	168	The settings and configurations in web.config are retained during an update. To save all continuing individual settings of the Web Interface, such as customised and modified graphics or texts, you must create a backup and import it after updating the Web Interface!
169	169	{{/aagon.infobox}}