8.3.2. Publish dialog box
The publish dialog box is used to create a publication or to prepare a template file for publication using the webinst utility (using the -descriptor command line parameter).
All parameters that can be edited when creating a publication are located in two tabs. For more details, see below.
8.3.2.1. Dialog buttons
The Publish button performs publication on the web server. When publishing, a directory is created on the hard drive and the web server is configured to operate with 1C:Enterprise. Note that publication on the IIS web server is always performed for the default website (Default Web Site) and for the default application pool (DefaultAppPool).
On Linux, the following actions are performed:
- For the directory where the default.vrd file is located, the group of the user on whose behalf the web server is running is set as the owner group.
- The group of the user on whose behalf the web server is running is assigned access rights to read the default.vrd file.
When publishing a file infobase, the group of the user on whose behalf the web server is running is set as the owner group of the infobase file directory. The owner group inheritance is configured to operate with the infobase. For more information, see article Recommendations for using file infobases.
Fig. 61. Publishing on web server
The Disable button removes the application from the web server and from the publication directory, if necessary.
The Save button saves the parameters specified in the publish dialog box to a file. When saving, you are prompted for the name and location of the file to be saved. Saving will be performed in the default.vrd file format. Using this command, you can create template files that will be used as the -descriptor parameter of the webinst utility. The parameters of the source infobase are written to the values of the ib and base attributes of the point element.
The Download button opens the default.vrd file for editing. When loading, the ib and base attributes of the point element in the file to be loaded are ignored.
The Close button closes the dialog box.
The Help button opens a window with reference information about the publication dialog.
8.3.2.2. Main tab
8.3.2.2.1. General parameters
In this tab, you can set the general parameters of the publication.
Fig. 62. Publishing on web server. Main tab.
Name. Specifies the publication name. When publishing using the webinst utility, it is described by the -wsdir parameter. In the default.vrd file, it corresponds to the base attribute of the point element.
Web server. Specifies web server used for publishing. Apache web servers are added to the list if they are found on the computer. When publishing using the webinst utility (see article Webinst utility), the web server used is indicated by one of the iis, apache2, apache22 or apache24 parameters. When operating in Linux, publishing is only possible for the Apache web server.
If the version of the Apache web server installed on the computer (2.2 or 2.4) cannot be determined, both versions of the web server will be listed. Please consider that for the Apache web server version 2.2 and 2.4 there are differences between the changes made in the configuration file of the web server. Therefore, the incorrectly specified version of the web server will result in the unavailability of the publication.
Directory. Specifies the physical directory on the hard drive in which the default.vrd file will be located and where the virtual directory of the web server will be displayed. The directory must already exist. When publishing using the webinst utility, it is described by the -dir parameter.
Publish access for client applications. Enables access to the published infobase using a thin client, mobile client, and web client. If the check box is selected, the published infobase can be accessed using a thin client, mobile client, or web client. In the default.vrd file, it corresponds to the enable attribute of the point element.
Publish standard OData interface. Enables access to the standard OData interface of the application. In the default.vrd file, it corresponds to the enableStandardOData attribute of the point element.
Publish 1C:Analytics. Enables interaction between 1C:Analytics server and 1C:Enterprise. After publication, the command to open 1C:Analytics web interface becomes available in the client application interface. In the default.vrd file, it corresponds to the analytics element.
Publish thin client distribution package. Determines whether the client application (thin client) can be obtained and installed if the versions of the client application and the server do not match. A distribution package is published as a ZIP archive. For the archive structure description, see article <point> (root element). For more information about methods to configure client application update, see article Automated client application update on a remote computer. In the default.vrd file, each row from the distribution package list corresponds to an attribute from the pubdst* family of the point element.
Use OS authentication. Allows OS authentication on IIS web server.
URL to open after exiting the web client. Allows you to specify the transition URL to open after the web client is closed. In the default.vrd file, it corresponds to the exitURL element (see article <exitURL>).
Progressive web application name. Allows you to specify a name to be displayed in the progressive web application title during its installation and operation. In the default.vrd file, it corresponds to the progressiveWebApplication element (see article <progressiveWebApplication>).
8.3.2.2.2. Web services tab
Publish Web services. If you select the check box, Web services created in the configuration and listed in the table below the check box will be published. In the default.vrd file, it corresponds to the enable attribute of the wselement. If the check box is cleared, this is equivalent to the absence of the ws element in the default.vrd file or the presence of the ws element with the enable attribute set to true value.
Fig. 63. Publishing web services
Publish Web services by default. Enables use of Web services that are published without explicit permission to use. In the default.vrd file, it corresponds to the pointEnableCommon attribute of the ws element.
The table below the Publish Web services check box contains a list of published Web services and allows you to manage publication of each Web service. The first column controls publication of each Web service. If the check box is cleared, the Web service will be disabled (it cannot be called). In the default.vrd file, it corresponds to the enable attribute of the point element.
The second column (Name) contains the name of the Web service as defined when it was created. In the default.vrd file, it corresponds to the name attribute of the point element.
The last column of the table (Address) contains the alias of the name of the published web service. The Web service can be accessed both by name and by alias. You can edit the Web service alias in the publish window. In the default.vrd file, it corresponds to the alias attribute of the point element.
Web services that are located in the connected extensions are not displayed in this table and can be published only by editing the default.vrd file manually.
Publish extensions Web services by default. Enables use of Web services supplied in configuration extensions. In the default.vrd file, it corresponds to the publishExtensionsByDefault attribute of the ws element (see article <ws>).
8.3.2.2.3. HTTP services tab
The HTTP services tab is designed to control the application access over HTTP services.
Fig. 64. Publishing HTTP services
Publish HTTP services by default. If you select the check box, HTTP services created in the configuration and listed in the table below the check box will be published. In the default.vrd file, it corresponds to the publishByDefault attribute of the httpServices element. If the check box is cleared, this is equivalent to the absence of the httpServices element in the default.vrd file or the presence of the httpServices element with the publishByDefault attribute set to false value.
The table below the Publish HTTP services by default check box contains a list of published HTTP services and allows you to manage the publication of each HTTP service. The first column controls publication of each HTTP service. If the check box is cleared, the HTTP service will be disabled (it cannot be called). In the default.vrd file, it corresponds to the enable attribute of the service element.
The second column (Name) contains the name of the HTTP service as defined when it was created. In the default.vrd file, it corresponds to the name attribute of the service element.
HTTP services that are located in the connected extensions are not displayed in this table and can be published only by editing the default.vrd file manually.
Publish extensions HTTP services by default. Enables use of HTTP services supplied in configuration extensions. In the default.vrd file, it corresponds to the publishExtensionsByDefault attribute of the httpServices element (see article <httpServices>).
8.3.2.3. OpenID tab
On this tab, you can configure the OpenID authentication settings for the publication to be performed.
Fig. 65. OpenID authentication settings
The Use OpenID authentication check box enables OpenID authentication for this infobase. In this case, the OpenID Provider Address property contains the address of the infobase that acts as OpenID provider. Access to this infobase is performed only over HTTPS. For more information, see article OpenID authentication support settings.
If the published infobase acts as an OpenID provider, it is necessary to select the Use as an OpenID provider check box.
In fact, this tab is used to configure the openid element of the default.vrd file. For more information, see article <openid>.
8.3.2.4. Additional tab
In this tab, you can set the auxiliary parameters of the publication.
Fig. 66. Auxiliary parameters of the publication on the web server
Temporary files directory. Specifies a temporary files directory for the web server extension or the infobase file mode. In the default.vrd file, it corresponds to the temp attribute of the point element. For more information, see article <point> (root element).
Connection pool group. Describes the pool element of the default.vrd file. For more information, see article <pool>. The parameters of this group also control the operation of the connection interruption tracking system.
Debugging tab. Describes the debug element of the default.vrd file. For more information, see article <debug>.
Data separation. Describes the zones element of the default.vrd file. For more information, see article <zones>. More detail on the structure of the separators table is provided below.
The table contains all independent separators that exist in a configuration or in a downloaded file. The first column (without a name) determines whether a zone element needs to be created for the selected separator. Remember that the element is mapped not by the name of the separator, but by its ordinal position in the list. If the first separator is disabled, it makes sense to disable all others, since the parameters of the zones element will be applied automatically to other separators.
The Name column contains the name of the separator as defined in the properties of the general attribute. The check box in the next column determines whether the separator value will be specified in the zone element. If the check box is selected, the value from the Value column will be used as the Value attribute.
The check boxes in the Safe and Specify columns are responsible for the safe and specify attributes of the zone element of the default.vrd file.
The parameter Background jobs in the file mode determines whether background jobs can be used in the file mode of the infobase (attribute allowexecutescheduledjobs of the root point element). For more information, see article <point> (root element).