1C:Enterprise 8.3. Administrator Guide. Contents
CONFIGURING WEB BROWSERS FOR WEB CLIENT OPERATION
This chapter covers configuration of web browsers that is required for web client operation.
8.1. GENERAL SETUP
If the computer the web client runs on has any software running that blocks web browser windows from opening or HTTP-queries from sending, the respective websites (infobase URLs) should be added to the exception lists.
8.2. MOZILLA FIREFOX
8.2.1. Connection Setup
First implement the following settings:
Start up the web browser.
Open the options window: Firefox – Tools – Options.
This opens the window from where you must go to the Content section and implement the following settings:
○ Check the Enable JavaScript box;
○ Check the Load images automatically box. When doing this, make sure that the required web sites (infobase addresses) are not included in the exception list in the Block status.
Go to the Privacy section and do the following:
○ Set the Firefox will parameter values to Remember history or Use custom settings for history in the History group.
○ If the Use custom settings for history value is selected, check Accept cookies from sites checkbox. When doing this, make sure that any required web sites (infobase addresses) are not included in the exception list in the Block status.
To ensure that the web client works properly when an unlocalized version of Mozilla Firefox is used, do the following (menu item names are provided according to the English version):
Open your web browser.
Open the setup window: Firefox – Tools – Options.
Click the Advanced button in the Fonts & Colors group of the Content section.
Select Unicode in the Default Character Encoding parameter.
We recommend that you enable query for the saved file location. To do this:
Open your web browser.
Open the setup window: Firefox – Tools – Options.
Select Always ask me where to save files in the General section.
To work in Mozilla Firefox, we recommend that you enable 1C:Enterprise Extension; you are then prompted to "install now" when you first attempt to access the 1C:Enterprise infobase, and it can be installed later by means of the Tools – Web Browser Setup command.
Fig. 68. Prompt for browser extension installation
This will establish the settings required for system operation:
pop-up windows on a page will be allowed;
switching between application windows will be allowed;
non-Latin characters in startup command line options will be allowed;
keyboard commands for switching between application windows will be allowed;
file operation extensions, cryptography extensions, and external components will be available. Extensions and external components will be available provided that the 1C:Enterprise Extension web browser extension is installed.
When working with the extension disabled, you can perform a number of settings manually:
Open your web browser.
Enable pop-up windows:
○ Open the options window: Firefox – Tools – Options.
○ This opens the window, where you go to the Content section.
○ Uncheck Block pop-up windows.
To allow switching between application windows by using keyboard commands:
○ Enter about:config in the web browser address bar.
○ Find the dom.disable_window_flip parameter.
○ Set the parameter to false.
○ Find the parameter dom.popup_allowed_events.
○ Add the keydown event to the value of this setting (use a space to separate it from other parameters).
To allow non-Latin characters in the startup command line options:
○ Enter about:config in the web browser address bar.
○ Find the network.standard-url.encode-query-utf8 parameter or, if the network. standard-url.encode-query-utf8 cannot be found, the browser.fixup.use-utf8 parameter.
○ Set the parameter to true.
8.2.2. Automatic Authentication
It is possible to configure the web browser to use automatic operating system authentication for Mozilla Firefox.
These settings may also be enabled manually:
Open your web browser.
Type about:config in the browser address bar.
Type the name of the parameter in the search field of the settings page.
This setting is applied to three parameters:
○ network.automatic-ntlm-auth.trusted-uris,
○ A specific network and web server configuration may require setting the network.negotiate-auth.trusted-uris and network.negotiate-auth.delegationuris parameters.
Next you should specify a list of web servers to work with the 1C:Enterprise base.
For details about this feature, see the article at: https://developer.mozilla.org/En/ Integrated_Authentication.
The description of the above parameters functions when different authentication tools are used is provided below:
The web server supports NTLM authentication.
If the web server attempted to be connected to is listed in the network.automatic-ntlm-auth.trusted-uris parameter names, automatic authentication will be attempted. If the web server is not listed, the browser will display a dialog to enter user login and password to access the web server.
The web server supports Kerberos authentication.
To access the web server using this authentication type, add the web server name to the parameter network.negotiate-auth.trusted-uris. This will be sufficient for file infobase. When client/server 1C:Enterprise version is used and automatic authentication is required for web client users, add the DNS Name of this web server to the parameter network.negotiate-auth.delegation-uris. If the accessed web server name cannot be found in the network.negotiate-auth.trusted-uris parameter, authentication will not be carried out and the user will see the following error message displayed: 401 Unauthorized. The administrator can modify the 401 error page to display the information on the suggested actions for a user (see the documentation for the web server used).
Use of External Components, the Clipboard, File System Extensions and Cryptography Extensions and Switching Windows from the Keyboard.
8.3. MICROSOFT INTERNET EXPLORER
For web client operation under Windows XP SP 2, jscript.dll system library should be present, version 5.6.0.8834 or later. The library is located in the system32 directory of the operating system. If you have an earlier version of the library installed on your computer, web client performance could be significantly slower. To update the version, you will need to download the update pack available at http://support.microsoft.com/kb/942840/en-us.
NOTE
At first launch of the web client under Microsoft Internet Explorer 6.0, an alert will appear stating that the web browser’s performance may be low. Microsoft Internet Explorer 7 and later or another web browser is then recommended (see page 18).
8.3.1. Connection Setup
Perform the following settings to start operation:
Launch a web browser.
Select Internet options in the Tools menu.
○ Enable JavaScript:
□ On the Security tab, for the Internet zone click the Custom level button.
• In the Scripting section, set the Active scripting parameter to Enable and click OK.
• In the Miscellaneous section, set the Display mixed content parameter to Enable (only for Microsoft Internet Explorer 8).
• In the Downloads section, set the Automatic prompting for file downloads parameter to Enable (only for Microsoft Internet Explorer 8).
• Click OK.
○ Enable pop-up windows:
□ Go to the Privacy tab.
□ In the Pop-up Blocker section, uncheck Block Pop-ups.
□ In the Pop-up Blocker section, clear the Block Pop-ups check box. If the interface mode is Forms in tabs or Taxi and modal windows are not used, selecting this option is not required.
○ Enable cookies:
□ On the Privacy tab, use the controller to set the cookie usage level not higher than Medium High.
8.3.2. Use of External Components, File System Extensions
and Cryptography Extensions
If you plan to use a barcode scanner, electronic scales or other external components, configure the following web browser settings:
On the Security tab click the Custom level button.
In the window that opens, select Enable for the following options:
○ Automatic prompting for ActiveX controls
○ Download signed ActiveX controls
○ Run ActiveX controls and plug-ins
○ Script ActiveX controls marked safe for scripting
Every time an auxiliary window is opened, the keyboard layout is selected based on the operating system settings. If the layout does not match the data entry language, you will need to specify the input language in the settings to avoid switching between languages. To set a default entry language:
1. Open the Regional and Languages Options section of the operating system.
2. On the Languages tab, in the Text services and input languages section click Details...
3. In the window that opens, on the Settings tab, in the Default input language section, select the language you need.
4. Click OK.
In Internet Explorer 8, navigating to an open window may display a dialog reading "Click OK to navigate to the window". This dialog also contains the OK button. When you click on this button, you will navigate to the window.
ActiveX may also be set up with the help of the ActiveX installation service (for Windows Vista, Windows 7, Windows Server 2008, and Windows Server 2008 R2).
See the following resources for a detailed description of the setup:
for Windows Vista, Windows Server 2008:
http://technet.microsoft.com/en-us/library/cc721964(WS.10).aspx; for Windows 7, Windows Server 2008 R2:
http://technet.microsoft.com/en-us/library/dd631688%28WS.10%29.aspx.
8.4. GOOGLE CHROME
Perform the following settings to start operation:
Launch a web browser.
Select Options in the menu.
Click Content settings on the Advanced tab.
On the Cookies tab, select the Allow local data to be set (recommended) checkbox or add infobase addresses to the exceptions list.
On the JavaScript security tab, select the Allow all sites to run JavaScript (recommended) checkbox or add infobase addresses to the exceptions list.
On the Popups tab, select the Allow all sites to show pop-ups checkbox or add infobase addresses to the exceptions list.
Enabling the saved file location prompt is recommended. To do this:
Open the web browser.
Select Options in the menu.
In the Load section of the Advanced tab, select the Ask where to save each file before download checkbox.
8.5. SAFARI
Perform the following settings to start operation:
Launch the web browser.
Select Options in the menu.
Select the Connect JavaScript checkbox on the Security tab.
Select Only from sites I visit in the Accept Cookies group of the Security tab.
Uncheck Block popups on the Security tab.
Uncheck Ctrl-click opens a link in a new tab on the Tabs tab.
Enabling the saved file location prompt is recommended. To do this:
Open a web browser.
Select Options in the menu.
Check Always prompt before downloading on the General tab.
NOTE
Safari for Mac OS does not prompt you to specify the location in which to save the file.
8.6. WEB CLIENT SPECIFIC FEATURES
For details on web client specific features, see "1C:Enterprise 8.3. Developer Guide".