Web Applications on Server

You can create a web application under a website created using SMC or a third-party website listed under the Websites node in the SMC tree.

When you click Create Web Application , a new web application page provides you with the following expanders for creating a web application.

If an extension of Desigo CC supports web application extensibility then you can create a web application for that extension when you click Create Web Application and select .

Server Information Expander

This expander by default displays the Server name where you are creating the web application. You cannot edit this information.

Project Information: Web Server Communication

This expander allows you to select and link a project on Server to the web application. Depending on the Server project selected, the communication mode, the CCom port number, the system name, project path are automatically set. You cannot edit them here.

Information

NOTE:
With Version 5.0, the Unsecured communication type is replaced with Local. It is recommended to configure the communication of all remote web applications to Secured as Unsecured communication will not work.

When you link a Sever project to a web application, a URL is created that points to the linked project. You can work with Web/Windows App Client using this web application URL.

Ensure that both, the linked Server project and the parent website, are started. Only then can you launch the Web/Windows App Client. Web/Windows App clients cannot be launched if you create a web application without linking it to a project.

In distributed environment, in addition to the linked system name (system name associated with the project linked to the web application), the system names of all the projects in distribution with the project linked to the web application are also displayed. You can work with all the projects (whose system names are listed) in distribution with the linked project when you launch the Web/Windows App clients. Note that for this the web application user must be added in the list of allowed users in the Project Shares expander of the systems in the distribution.

Web Application Details Expander

This expander allows you to configure the web application details including name, path, certificate for web application signing, configuring the XBAP web application, and the user, and password.

Item	Description
Name	Allows you to type the name of the Web application. Provide a unique name. Following special characters are not permitted in the website name: ‘#’, \\', '/', '?', ';', ':', '@', '&', '=', '+', '$', ',', '\|', ' " ', '<', '>'.
Path	Browse for the location on the disk where you want to store the Web application. The default is [installation drive:]\[installation folder]\[Websites folder]\[Website name]. For a third-party Web application creation the default path is [installation drive:]\[installation folder]. Following special characters are not permitted in the website path: 'ä', 'ö', 'ü', '$', '@', '<', '>', '{', '}', '[', ']', '(', ')', ';', '=', '^', '\|', '*', '!', '/', '%', '?', ',', '\'', '"', '\t'.
Certificate issued to	Displays the default self-signed certificate. Otherwise, you can browse and select a certificate (host/self-signed) for web application signing using the Select Certificate dialog box. You need to select the certificate from the Personal tab of the store location Local machine certificates or User certificates. NOTE: A CNG certificate with ECDSA signature algorithm is not supported. This certificate can be different from the certificate you selected while creating a website.
Enable XBAP	Select the Enable XBAP check box if you want to launch Desigo CC using the XBAP web client. The Web Client option displays on the Desigo CC web page only when the web application is created using the Enable XBAP option.
Server Name	(Read only and only available on Server installation) Displays the name of the Server station.
Project Name	(Only available on Server installation) Allows you to select a project from a list of projects for linking to a web application. However, you can also create a web application without a project linked to it. NOTE: If a stopped/outdated project is linked to a web application, you cannot work with the Web or Windows App Client.
User	Browse and select a web application user using the Select User dialog box. NOTE 1: The web application user should be a member of IIS_IUSRS group. If you select a user who is not a member of the IIS_IUSRS group, the SMC prompts you to add the user to that group. NOTE 2: You can create a web application with a user different from the website user. NOTE 3: The web application user on a Client/FEP must be added in the list of allowed users in the Project Shares expander of the Server project that you want to link to the web application (see Modifying the Server Project Parameters, Step 6. Otherwise, the user cannot work with virtual directories (graphics, libraries, documents, shared, and devices folders) inside the Server project folder. For example, the user will not be able to save saving a graphics object in the graphics folder, and so on. NOTE 4:(Only applicable for projects in distribution) If the project that you are about to link is in distribution with other projects, all the projects in distribution with the linked project must be shared with the web application user. For example, if a WebApp1 is linked to a project P1 which is in distribution with a project P2, the WebAppUser1 should have access rights on the Project P1 and Project P2 both.
Password	Type the valid password of the selected user.

Web Application Toolbar

The web application toolbar contains the following icons.

Web Application Toolbar
Icon	Name	Description
	Edit	Allows you to modify the web application configuration parameters.
	Save	Saves the web application configuration.
	Sign Application	Allows you to sign the selected web application with the modified website data (for example, port, certificate and host name). You must sign the web application if you change the web application certificate.
	Upgrade Web application	This icon is enabled only when the web application status is `Outdated` (indicated in red). It allows you to upgrade the outdated web application (generally of a website created in an older version of Desigo CC).
	Delete	Deletes the current web application from the SMC tree and the disk.
	Check Consistency	This icon is available only when you edit the StartSmc.bat file located at [installation drive:]\[installation folder]\GMSMainProject\bin and add the /support switch. It is generally used to run diagnostics on web application before launching the Web/Windows App Clients. It checks the connectivity and validity for a website, web application, and project parameters and provides you with the diagnostic result in a log file in the default editor, such as Notepad. The log file is saved on the disk at the path [installation drive:]\[installation folder]\GMSMainProject\log in the format [Web application name]_[DD MM YYYY]_[HHMMSS]. NOTE: This icon is `not enabled` when you edit the web application or when it is `Outdated` (indicated in red).
	Align with Server	This icon is enabled only when you edit the web application. It allows you to align the web application with changed Server project data (for example, ports) for an already configured project in the web application.