DIGITAL_Office_Server_Web_Interface___________ Setting Up and Customizing Revision/Update Information: Updated for Version 5.01 Operating system: Windows NT Version 4.0 for Intel and Alpha, DIGITAL UNIX Version 4.0B, OpenVMS Versions 6.2 to 7.1 Software version: Version 5.01 Digital Equipment Corporation Maynard, Massachusetts __________________________________________________________ March 1998 Possession, use, or copying of the software described in this documentation is authorized only pursuant to a valid written license from DIGITAL or an authorized sublicensor. While DIGITAL believes the information included in this publication is correct as of the date of publication, it is subject to change without notice. Digital Equipment Corporation makes no representations that the use of its products in the manner described in this publication will not infringe on existing or future patent rights, nor do the descriptions contained in this publication imply the granting of licenses to make, use, or sell equipment or software in accordance with the description. © Digital Equipment Corporation 1998. All Rights Reserved. The following are trademarks of Digital Equipment Corporation: ALL-IN-1, DIGITAL UNIX, OpenVMS, TeamLinks, VAX, WPS-PLUS and the DIGITAL logo Windows NT is a trademark of Microsoft Corporation. Netscape is a registered trademark of Netscape Communications Corporation. Netscape branded products are trademarks of Netscape Communications Corporation. Purveyor is a trademark of Process Software Corporation. WordPerfect is a trademark of Corel Corporation. UNIX is a registered trademark in the US and other countries, licensed exclusively through X/Open Company Ltd. All other trademarks and registered trademarks are the property of their respective holders. This document was prepared using VAX DOCUMENT, Version 2.1. ________________________________________________________________ Contents Preface.................................................. v 1 Setting Up the DIGITAL Office Server Web Interface 1.1 Supported Clients and Servers................ 1-1 1.2 Installing the Web Interface Kit............. 1-2 1.2.1 Post-Installation Tasks.................. 1-3 1.2.1.1 Post-Installation Tasks for Microsoft Internet Information Server (IIS)...... 1-3 1.2.1.2 Post-Installation Tasks for Netscape FastTrack Server on Windows NT......... 1-5 1.2.1.3 Post-Installation Tasks for DIGITAL UNIX Installations..................... 1-8 1.2.1.4 Post-Installation Tasks for OpenVMS Installations.......................... 1-9 1.3 Installing the Distributed Sharing Option (DSO) License................................ 1-10 1.4 Setting up Web Access on Your DIGITAL Office Server or ALL-IN-1 System.................... 1-10 1.5 Setting up the Drawers You Want to Make Available.................................... 1-13 1.6 Checking that Installation is Successful..... 1-13 2 Customizing the DIGITAL Office Server Web Interface 2.1 Customizing the Configuration File Settings..................................... 2-2 2.1.1 Anonymous User Settings.................. 2-6 2.1.2 Conversion Settings...................... 2-7 2.2 Customizing the Configuration File Boilerplates................................. 2-8 iii 2.2.1 Customizing Boilerplate Settings to Not Use Frames............................... 2-17 2.2.2 Customizing the Logon Form to Log On to a Different Port (Windows NT only)......... 2-18 2.3 Using the DIGITAL Office Server Web Interface Boilerplate Directives....................... 2-19 2.3.1 Web Interface Boilerplate Directive Modifiers................................ 2-25 2.4 Using the DIGITAL Office Server Web Interface Special Directives........................... 2-26 2.4.1 $BEGINLOOP and $ENDLOOP.................. 2-26 2.4.2 $FOREACH and $ENDFOREACH................. 2-27 2.4.3 $IF, $ELSE, and $ENDIF................... 2-28 2.5 Customizing the MIME Types Mapping File...... 2-29 2.6 Setting Up Indirect (Brokered) Connections... 2-30 2.7 Creating URLs for File Cabinet Objects....... 2-31 3 Security Implications 3.1 Anonymous Access (Non-Logged-in Users)....... 3-1 3.2 Logged-On Users.............................. 3-1 4 Troubleshooting Tables 1-1 Web Interface Setup Tasks................ 1-1 2-1 Settings You May Want to Customize....... 2-2 2-2 Anonymous User Settings You May Want to Customize................................ 2-7 2-3 Conversion Settings...................... 2-8 2-4 Boilerplate Elements..................... 2-9 2-5 Web Interface Boilerplate Directives..... 2-19 2-6 Boolean Expressions used with $IF, $ELSE and $ENDIF............................... 2-29 2-7 Using the DirectConnect and BrokerNode Fields................................... 2-30 4-1 Problems and Solutions................... 4-1 iv ________________________________________________________________ Preface About This Guide This guide explains how to set up and customize the DIGITAL Office Server Web Interface. Prerequisite Knowledge This guide assumes that you are familiar with the web server software at your site. If you plan to customize the default displays, you need experience of creating web pages. You must also be familiar with DIGITAL Office Server or ALL-IN-1 system management and have access to the DIGITAL Office Server or ALL-IN-1 system management subsystem. Related Documents DIGITAL Office Server Management from a VT Terminal DIGITAL Office Server Web Interface Release Notes v 1 ________________________________________________________________ Setting Up the DIGITAL Office Server Web Interface This chapter describes the tasks that you must do to install and set up your DIGITAL Office Server Web Interface software. When you have completed the setup tasks, users will be able to use web browsers to access the documents that you make available from your DIGITAL Office Server File Cabinet. Table 1-1 lists the tasks that you must do. Table_1-1_Web_Interface_Setup_Tasks_______________________ Task______________________________________See_____________ Installing the kit Section 1.2 Performing post-installation tasks Section 1.2.1 Installing the Distributed Sharing Section 1.3 Option License (ALL-IN-1 systems only) Setting up web access on your DIGITAL Section 1.4 Office Server system Setting up the drawers that you want to Section 1.5 make available Checking_that_installation_is_successful__Section_1.6_____ 1.1 Supported Clients and Servers The Web Interface supports the following clients: o Netscape Navigator 3.01 o Netscape Communicator 4.04 o Microsoft Internet Explorer 4.01 Setting Up the DIGITAL Office Server Web Interface 1-1 Setting Up the DIGITAL Office Server Web Interface 1.1 Supported Clients and Servers The Web Interface supports the following servers: o For Windows NT for Intel and Alpha - Microsoft Internet Information Server Version 3.0 - Netscape FastTrack Server Version 2.01 o For OpenVMS - Process Software Purveyor Version 2.0 o For DIGITAL UNIX - Netscape FastTrack Server Version 2.01 1.2 Installing the Web Interface Kit To install the kit, make sure that the web server and all running applications are shut down, then: o From Windows NT, run setup.exe. o On OpenVMS, enter @SYS$UPDATE:VMSINSTAL DOSWI050 Where is the directory where you have loaded the kit. ________________________Note ________________________ You must install the Web Interface under Purveyor's scripts directory in order for the Web Interface to function. One way to do this is to start the Purveyor server before installing, then take the default installation path. _____________________________________________________ o On DIGITAL UNIX, use setld -l , where is the directory where you have loaded the kit. ________________________Note ________________________ The Web Interface software does not support multiple installation. DIGITAL cannot be held responsible for 1-2 Setting Up the DIGITAL Office Server Web Interface Setting Up the DIGITAL Office Server Web Interface 1.2 Installing the Web Interface Kit the consequences of multiple installations of the Web Interface. _____________________________________________________ When the kit is installed, you must perform some additional post-installation tasks-see Section 1.2.1. 1.2.1 Post-Installation Tasks There are post-installation tasks that you must perform to add the Web Interface virtual directory, and to check that the images (such as the buttons on the toolbar) and the online help are displayed correctly. The installation will prompt you to check this section for these post- installation tasks. The post-installation tasks that you must perform depend on whether you are running Microsoft Internet Information Server (IIS), Netscape FastTrack Server, or Process Software Purveyor Server. 1.2.1.1 Post-Installation Tasks for Microsoft Internet Information Server (IIS) __________________________________________________________ Step_Action_______________________________________________ 1 If you are upgrading from a previous version and have not deleted the previous version from your system: a. Make sure that you have deleted awi.exe. b. Check that the Web Interface works correctly. If it does not, move to step 2. If it does, move to step 3. Setting Up the DIGITAL Office Server Web Interface 1-3 Setting Up the DIGITAL Office Server Web Interface 1.2 Installing the Web Interface Kit __________________________________________________________ Step_Action_______________________________________________ 2 Make sure that the Web Interface virtual directory is correctly defined by doing the following: a. Start the web server by running the Microsoft Internet Service Manager. b. From the Internet Service Manager, click Properties/Service Properties. c. At the Service properties screen, click Directories. d. At the Directories screen, check for an existing virtual directory for the Web Interface. If there is an existing virtual directory, move to Step 3. e. At the Directories screen, click Add... f. Enter the directory name for the Web Interface-by default this is: C:\Program Files\Digital Office Server\Web Interface\bin g. Enter the virtual directory name for the Web Interface, for example, /doswi h. Make sure that the Read box is unchecked, and that the Execute box is checked. i. Click OK. __________________________________________________________ 1-4 Setting Up the DIGITAL Office Server Web Interface Setting Up the DIGITAL Office Server Web Interface 1.2 Installing the Web Interface Kit __________________________________________________________ Step_Action_______________________________________________ 3 Check to see that the image files (such as the toolbar buttons) and the online help are displayed correctly. If they are both displayed correctly, there are no further post-installation tasks. If the images and help are not displayed, do the following: a. From the Internet Service Manager, select Properties/Service Properties. b. At the Service properties screen, click Directories. c. At the Directories screen, click Add... d. Enter the directory name for the images. e. Enter the virtual directory name for the images, /doswiimage f. Make sure that the Read box is checked, and that the Execute box is unchecked. g. Click OK. h. Return to the Service properties screen, and click Directories. i. At the Directories screen, click Add... j. Enter the directory name for the help. k. Enter the virtual directory name for the help, /doswihelp l. Make sure that the Read box is checked, and that the Execute box is unchecked. m. Click OK. __________________________________________________________ 1.2.1.2 Post-Installation Tasks for Netscape FastTrack Server on Windows NT In the following steps, it is important that you use lower case and upper case letters as shown, and use only forward slashes (/) in path names. Setting Up the DIGITAL Office Server Web Interface 1-5 Setting Up the DIGITAL Office Server Web Interface 1.2 Installing the Web Interface Kit __________________________________________________________ Step_Action_______________________________________________ 1 Edit the configuration file obj.conf in the web server subdirectory httpd-\config, where is the name of your server 2 Search for the lines containing Init fn=, and at the end of those lines, add the following (all on one line): Init fn="load-modules" shlib="/Bin/ns- awi.dll" funcs="nsdoswi-init,nsdoswi-service" where is the path name to where you installed the kit. For example, the line might read: Init fn="load-modules" shlib="C:/Program Files/DIGITAL Office Server/ Web Interface/Bin/ns-awi.dll" funcs="nsdoswi- init,nsdoswi-service" 3 Immediately after the line you added in Step 2, add the following: Init fn="nsdoswi-init" 1-6 Setting Up the DIGITAL Office Server Web Interface Setting Up the DIGITAL Office Server Web Interface 1.2 Installing the Web Interface Kit __________________________________________________________ Step_Action_______________________________________________ 4 Search for the line , and immediately after that line, add: NameTrans from="/doswiimage" fn="pfx2dir" dir="/doswiimage" NameTrans from="/doswihelp" fn="pfx2dir" dir="/doswihelp" NameTrans from="" fn="pfx2dir" dir="" name="doswi" where: o is the path to /doswiimage o is the path to /doswihelp o is the path to where you installed the kit o is the name that you define for the Web Interface URL, for example, /doswi For example, the lines might read: NameTrans from="/doswiimage" fn="pfx2dir" dir="c:/Program Files/ DIGITAL Office Server/Web Interface/doswiimage" NameTrans from="/doswihelp" fn="pfx2dir" dir="c:/Program Files/ DIGITAL Office Server/Web Interface/doswihelp" NameTrans from="/doswi" fn="pfx2dir" dir="c:/Program Files/ DIGITAL Office Server/Web Interface" name="doswi" 5 At the end of obj.conf, add the following lines: Service fn="nsdoswi-service" method="(GET|POST)" _________________________________________________ Setting Up the DIGITAL Office Server Web Interface 1-7 Setting Up the DIGITAL Office Server Web Interface 1.2 Installing the Web Interface Kit 1.2.1.3_Post-Installation_Tasks_for_DIGITAL_UNIX_Installations__ Step_Action_______________________________________________ 1 Enter the following: cd /usr/opt/DOSWI ./setup If you have more than one Netscape server installed, the Netscape servers will be listed, and you will be asked which one you want to use. For example: You have the following Netscape servers: doswi-svr (port 12345) www-web (port 80) Which server do you want to use DOSWI with? [www-web] The default is the server on port 80, but you can specify which one you want to choose. 2 When you have chosen the server, or have pressed RETURN to use the default, the setup displays the following: Desired URL for NSAPI extension [/doswi]: Enter the URL or press return to accept the default. The setup then confirms where the obj.conf file has been created, and displays the following message: You can now: 1. Let setup replace the existing obj.conf file and restart the server (the existing obj.conf file will be saved). 2. Exit setup and review the changes. Should you decide to keep the changes, you will have to manually replace the obj.conf file and restart the server. Your choice (1, 2)? [1] 1-8 Setting Up the DIGITAL Office Server Web Interface Setting Up the DIGITAL Office Server Web Interface 1.2 Installing the Web Interface Kit __________________________________________________________ Step_Action_______________________________________________ 3 If you choose option 1, the old obj.conf file is saved as obj.conf.sav, and the setup confirms where it has saved the file. Your web server will be restarted automatically. If you choose option 2, review the file obj.conf.doswi, and replace obj.conf. Stop the web server, then start the web server. __________________ Note __________________ If you upgraded to Version 5.01 without deleting the old kit, you must choose option 2. You must then edit the obj.conf.doswi file, delete the line Init fn = "nsapi-init", and move obj.conf.doswi to obj.conf. __________________________________________ 4 To check that the Web Server is running NSAPI, make _____sure_that_you_can_log_on_and_log_off_successfully.___ 1.2.1.4_Post-Installation_Tasks_for_OpenVMS_Installations_______ Step_Action_______________________________________________ 1 Define the system logical DOSWI$ROOT to be the directory where the Web Interface is installed, for example, PURVEYOR_ROOT:[PURVEYOR.SAMPLES.SCRIPTS.DOSWI]. Add this logical to your system startup procedure. 2 Using the Purveyor Remote Server Manager utility interface, Add a new virtual path. You can specify any name, as long as it begins with a tilde character (~) - for example, ~doswi - but you must specify the path to be the Web Interface binary directory, for example, PURVEYOR_ROOT:[PURVEYOR.SAMPLES.SCRIPTS.DOSWI.BIN] Read the Purveyor documentation, especially when setting up privileges for the configuration database file and for the Purveyor directory. Setting Up the DIGITAL Office Server Web Interface 1-9 Setting Up the DIGITAL Office Server Web Interface 1.2 Installing the Web Interface Kit __________________________________________________________ Step_Action_______________________________________________ 3 When you have entered these details, click Submit. 4 Apply the server changes by clicking Apply all the server changes. 5 Set the MetaHttpEquiv setting to 1 in config.awi. 6 Add an Access Control List (ACL) for the worker process to give read, write, execute and delete access to the directory where the Web Interface is installed. 7 Start the server. To check that the installation is successful, make sure that you can log on using a URL, for example, http:///~doswi/awi.dll Note: awi.dll must _____always_be_in_lowercase_letters.______________________ 1.3 Installing the Distributed Sharing Option (DSO) License For ALL-IN-1 Version 3.2 systems, if you want to allow users to browse anonymously, and use List Available Drawers, you must install the Distributed Sharing Option (DSO) license, A1-DIST-SHR, on each node that you want to allow the Web Interface to access. The DSO license allows remote access to your DIGITAL Office Server or ALL-IN-1 File Cabinet. Register the license using the OpenVMS[TM] License Management Facility (LMF). ________________________Note ________________________ After installing the DSO license, you must stop and then restart the File Cabinet Server. _____________________________________________________ 1.4 Setting up Web Access on Your DIGITAL Office Server or ALL-IN-1 System If you want to allow anonymous user access, you must have a DIGITAL Office Server or ALL-IN-1 account called WEB$ACCESS on your DIGITAL Office Server or ALL-IN-1 system. 1-10 Setting Up the DIGITAL Office Server Web Interface Setting Up the DIGITAL Office Server Web Interface Setting up Web Access on Your DIGITAL Office Server or ALL-IN-1 System ________________________Note ________________________ Do not use a privileged account for the WEB$ACCESS account. Privileged accounts are those in UIC groups 1-10. _____________________________________________________ You may have a WEB$ACCESS account already set up on your system. However, if you do not, do the following: __________________________________________________________ Step_Action_______________________________________________ 1 Create an account template by entering: MGT DTC C Set up the following attributes in the template: _____________________________________________________ Attribute__________________Value_____________________ privileges TMPMBX and NETMBX Mail Destination NO MAIL X500_UPDATE________________N_________________________ __________________________________________________________ 2 Create an account called WEB$ACCESS. Enter: MGT MUA C CU The account name contains a $ character so that DIGITAL Office Server or ALL-IN-1 displays a message to say that the $ character is not recommended in an account name. Enter Y in response to the message and continue. Enter the name of the template created in Step 1 in the Account template: field. __________________________________________________________ Setting Up the DIGITAL Office Server Web Interface 1-11 Setting Up the DIGITAL Office Server Web Interface 1.4 Setting up Web Access on Your DIGITAL Office Server or ALL-IN-1 System __________________________________________________________ Step_Action_______________________________________________ 3 Classify WEB$ACCESS as a utility account by doing the following: a. Enter MGT MSY CUA b. Enter WEB$ACCESS access in the Account name: field c. Check that the template has set up NO MAIL in the Mail destination: field. d. Enter U in the Utility Account: field __________________________________________________________ 4 Using the AUTHORIZE utility, you can provide additional security on the OpenVMS account by setting up the following: o DISMAIL o RESTRICTED o GENPWD o Login restrictions for when the account can be accessed o Any additional site-specific restrictions __________________ Note __________________ You must maintain LOCAL and REMOTE access on the OpenVMS account. __________________________________________ For example: $ RUN SYS$SYSTEM:AUTHORIZE UAF> MODIFY WEB$ACCESS/FLAGS=(DISMAIL,RESTRICTED,GENPWD) UAF> EXIT _____$____________________________________________________ 1-12 Setting Up the DIGITAL Office Server Web Interface Setting Up the DIGITAL Office Server Web Interface 1.5 Setting up the Drawers You Want to Make Available 1.5 Setting up the Drawers You Want to Make Available You can use the options on the Drawer Management (DRM) menu to define access to the world-readable drawers that you want to make available on the web. To do this, you can add WEB$ACCESS to the list of users or groups that can access a particular drawer, and set it to Y. You can also set up *WORLD access to allow full public access, including web access. If you want to deny web access with the *WORLD access setting, set WEB$ACCESS to N. 1.6 Checking that Installation is Successful Make sure that the server is started, then to check that you have set everything up correctly, do the following: __________________________________________________________ Step_Action_______________________________________________ 1 Using a web browser, specify the URL that you have set up for the Web Interface executable file. See Section 1.2.1. For example: http:/webserver.mycompany.com/doswi/awi.dll where webserver.mycompany.com is the address of the web server where you installed the Web Interface, and /doswi is the virtual directory that you defined in Section 1.2.1. __________________________________________________________ 2 Click the Logon button, enter logon details as _____prompted,_and_list_your_File_Cabinet.________________ Now that the Web Interface is up and running, you may want to customize the way it works or the display that it provides. See Chapter 2. If you have any problems with installation checks, see Chapter 4. Setting Up the DIGITAL Office Server Web Interface 1-13 2 ________________________________________________________________ Customizing the DIGITAL Office Server Web Interface This chapter explains the different ways that you can customize the DIGITAL Office Server Web Interface. You can customize the forms, the way in which folders and documents are displayed, and the document attributes that are displayed. In order to customize the Web Interface, you need to understand the way that the default configuration file is organized. __________________________________________________________ For information, Topic________________________________see..._______________ Customizing the configuration file Section 2.1 settings Customizing the configuration file Section 2.2 boilerplates Customizing the logon form Section 2.2.2 Using the Web Interface boilerplate Section 2.3 directives Using the Web Interface special Section 2.4 directives Customizing the MIME types mapping Section 2.5 file Setting up indirect connections to Section 2.6 other File Cabinets Creating URLs for File Cabinet Section 2.7 Objects___________________________________________________ Customizing the DIGITAL Office Server Web Interface 2-1 Customizing the DIGITAL Office Server Web Interface 2.1 Customizing the Configuration File Settings 2.1 Customizing the Configuration File Settings The Web Interface configuration file is in the Web Interface subdirectory and is called CONFIG.AWI. It contains the following sections: [settings] [anonymous] [boilerplates] [conversion] To change configuration file settings, you need to remove the semi-colon (;) from the beginning of the setting in the configuration file. When you have finished changing the configuration file, you must restart the server for the changes to take effect. If a section, or section options, are missing, defaults are used. CONFIG.AWI shows the defaults as listed in the following tables. The section names and section option names are case insensitive. Table 2-1 lists the default settings that you may want to customize. Table_2-1_Settings_You_May_Want_to_Customize______________ Option__________________Default___Description_____________ LIFOInbox 1 Defines the order in which messages in the Inbox are listed. When set to 1, the messages in the Inbox are listed with the newest message at the top; when set to 0, the messages are listed with the newest message at the bottom. Unless_otherwise_described,_a_value_of_1_means_true,_and_a value of 0 means false. (continued on next page) 2-2 Customizing the DIGITAL Office Server Web Interface Customizing the DIGITAL Office Server Web Interface 2.1 Customizing the Configuration File Settings Table_2-1_(Cont.)_Settings_You_May_Want_to_Customize______ Option__________________Default___Description_____________ ReadPPOption 1 Defines what happens to a unread message after it has been read. When set to 0, read messages are left in the Inbox as NOTED; when set to 1, read messages are left in the Inbox as READ; when set to 2, read messages are filed in the Read folder as READ. TimeOut 720 Defines the time, in minutes, before a user is timed out. TimeoutWait 300 Defines the time, in seconds, before the next timeout check is performed. The default is five minutes-300 seconds. Unless_otherwise_described,_a_value_of_1_means_true,_and_a value of 0 means false. (continued on next page) Customizing the DIGITAL Office Server Web Interface 2-3 Customizing the DIGITAL Office Server Web Interface 2.1 Customizing the Configuration File Settings Table_2-1_(Cont.)_Settings_You_May_Want_to_Customize______ Option__________________Default___Description_____________ SecureLogon 0 When set to 1, this only allows cookies to be transmitted successfully back to browsers when done over a secure link (SSL). When set, logons and confidentiality checks of messages will not work. Set this value to 0 if you want cookies to be transmitted successfully whether or not over a secure link. DownloadPersonal 0 This controls the downloading of Personal sensitivity messages. When set to 0, Personal messages are always downloaded. If you do not want to allow a user to be able to download a Personal message, set this value to 1. If you want to allow a user to be prompted before downloading Personal messages, set this value to 2. Unless_otherwise_described,_a_value_of_1_means_true,_and_a value of 0 means false. (continued on next page) 2-4 Customizing the DIGITAL Office Server Web Interface Customizing the DIGITAL Office Server Web Interface 2.1 Customizing the Configuration File Settings Table_2-1_(Cont.)_Settings_You_May_Want_to_Customize______ Option__________________Default___Description_____________ DownloadPrivate 0 This controls the downloading of Private sensitivity messages. When set to 0, Private messages are always downloaded. If you never want to allow a user to be able to download a Private message, set this value to 1. If you want to allow a user to be prompted before downloading Private messages, set this value to 2. DownloadCompanyConfident1al This controls the downloading of Company Confidential sensitivity messages. When set to 1, a user is prompted before downloading Company Confidential messages. If you do not want to allow a user to be able to download a Company Confidential message, set this value to 0. If you want Company Confidential messages to be always downloaded, set this value to 2. Unless_otherwise_described,_a_value_of_1_means_true,_and_a value of 0 means false. (continued on next page) Customizing the DIGITAL Office Server Web Interface 2-5 Customizing the DIGITAL Office Server Web Interface 2.1 Customizing the Configuration File Settings Table_2-1_(Cont.)_Settings_You_May_Want_to_Customize______ Option__________________Default___Description_____________ TimeFormat 0 This controls the time /date format when a date is displayed to the user, for example when a message is being read and when a folder is listed. The time is always shown in 24- hour clock format. The following are valid formats: ________________________ For_format...____Use..._ Fri, 25 Dec 98 0 or 7 14:20:00 25-Dec-1997 1, 2 or 14:20:00 3 1998-Dec-25 4, 5 or 14:20:00 6 25-12-1998 8 14:20:00 12-25-1998 9 14:20:00________________ Unless_otherwise_described,_a_value_of_1_means_true,_and_a value of 0 means false. __________________________________________________________ You do not need to change any of the other settings in the configuration file. 2.1.1 Anonymous User Settings Table 2-2 lists the default anonymous user settings that you may want to customize. These are valid only for users who are not logged in. 2-6 Customizing the DIGITAL Office Server Web Interface Customizing the DIGITAL Office Server Web Interface 2.1 Customizing the Configuration File Settings Table 2-2 Anonymous User Settings You May Want to __________Customize_______________________________________ Option__________________Default___Description_____________ BrokerNode - Use to specify a node for indirect connections. Use in conjuction with DirectConnect. This setting does not apply to users who are logged in. See Section 2.6. DirectConnect 1 Means the Web Interface always connects to the node that the user specifies in the URL or at the user request form. You may want to change this if you want to set up an indirect connection to other File Cabinets, for example, those that do not have TCP/IP connections. This setting does not apply to users who are logged in. __________________________________See_Section_2.6.________ 2.1.2 Conversion Settings Conversion Settings allow you to control conversion of WPS-PLUS or Word documents. Customizing the DIGITAL Office Server Web Interface 2-7 Customizing the DIGITAL Office Server Web Interface 2.1 Customizing the Configuration File Settings Table_2-3_Conversion_Settings_____________________________ Option__________________Default___Description_____________ WPSPLUS 1 Enables conversion of WPS-PLUS documents, so that you can read them using the Web Interface. Set this value to 0 if you do not want to enable conversion. WPCORP 0 Enables conversion of WordPerfect documents, so that you can read them using the Web Interface. You may want to keep this value at 0 if you have WordPerfect installed and want to view the documents using WordPerfect. To enable WordPerfect conversion, __________________________________set_this_value_to_1.____ 2.2 Customizing the Configuration File Boilerplates The configuration file boilerplate section lists all the elements that you can use to create web pages, or edit those supplied. In the default configuration file, some of the elements use the default boilerplate files that are supplied with the DIGITAL Office Server Web Interface. You can create your own files to replace the defaults and create new files to provide the elements that do not have defaults. The boilerplates section of the DIGITAL Office Server Web Interface configuration file supports the elements shown in Table 2-4. 2-8 Customizing the DIGITAL Office Server Web Interface Customizing the DIGITAL Office Server Web Interface 2.2 Customizing the Configuration File Boilerplates Table_2-4_Boilerplate_Elements____________________________ Element_________________Default_____Description___________ DefaultFrame frame.blp Used as the frame if no other is specified. DefaultToolbar toolbar.blp Used as the toolbar if no other is specified. DefaultMailtoolbar mailtoolbar.Used as the toolbar for create, answer and forward message forms if no other is specified DefaultHead header.blp Used as the header if no other is specified. For example, you could use this to provide a corporate logo at the head of each page DefaultTail footer.blp Used as the footer if no other is specified. For example, you could use this to provide a Home page URL. MainScreenFrame mainscr.blp Used as the main screen frame LogonFrame logonfrm.blpUsed as the logon frame LogonToolbar logontb.blp Used as the logon toolbar Logon logon.blp Used as the logon form LogonHead header.blp[1Used as header for the logon form [1]This_setting_is_the_same_as_DefaultHead;_if_you_have___ specified another setting for DefaultHead, the latest default value will be used. (continued on next page) Customizing the DIGITAL Office Server Web Interface 2-9 Customizing the DIGITAL Office Server Web Interface 2.2 Customizing the Configuration File Boilerplates Table_2-4_(Cont.)_Boilerplate_Elements____________________ Element_________________Default_____Description___________ LogonTail footer.blp[2Used as the footer for the logon form FileCabinetDrawerFrame fcframe.blp Used as the File Cabinet drawer frame FileCabinetDrawerToolbarfctool.blp Used as the File Cabinet drawer toolbar FileCabinetDrawerHead header.blp[1Used as header for the file cabinet drawer frame FileCabinetDrawerTail footer.blp[2Used as the footer for the file cabinet drawer frame FileCabinetDrawers listfc.blp Used as the File Cabinet drawers form FolderFrame frame.blp Used as the frame when listing folders. FolderToolbar toolbar.blp[Used as the toolbar when listing folders. FolderHead header.blp[1Used as the header when listing folders. FolderTail footer.blp[2Used as the footer when listing folders. Folders listdrw.blp Used when listing the folders in a drawer. [1]This_setting_is_the_same_as_DefaultHead;_if_you_have___ specified another setting for DefaultHead, the latest default value will be used. [2]This setting is the same as DefaultTail; if you have specified another setting for DefaultTail, the latest default value will be used. [3]This setting is the same as DefaultToolbar; if you have specified another setting for DefaultToolbar, the latest default value will be used. (continued on next page) 2-10 Customizing the DIGITAL Office Server Web Interface Customizing the DIGITAL Office Server Web Interface 2.2 Customizing the Configuration File Boilerplates Table_2-4_(Cont.)_Boilerplate_Elements____________________ Element_________________Default_____Description___________ DocumentFrame frame.blp Used as the frame when listing documents. DocumentToolbar toolbar.blp[Used as the toolbar when listing documents. DocumentHead header.blp[1Used as the header when listing documents. DocumentTail footer.blp[2Used as the footer when listing documents. Documents listfold.blpUsed when listing the documents in a folder. MessageContentFrame frame.blp Used as the frame on the Message Contents form. MessageContentToolbar toolbar.blp[Used as the toolbar on the Message Contents. MessageContentHead header.blp[1Used as the header on the Message Contents form. MessageContentTail footer.blp[2Used as the footer on the Message Contents form. MessageContents readmsg.blp Used as the Message Contents form [1]This_setting_is_the_same_as_DefaultHead;_if_you_have___ specified another setting for DefaultHead, the latest default value will be used. [2]This setting is the same as DefaultTail; if you have specified another setting for DefaultTail, the latest default value will be used. [3]This setting is the same as DefaultToolbar; if you have specified another setting for DefaultToolbar, the latest default value will be used. (continued on next page) Customizing the DIGITAL Office Server Web Interface 2-11 Customizing the DIGITAL Office Server Web Interface 2.2 Customizing the Configuration File Boilerplates Table_2-4_(Cont.)_Boilerplate_Elements____________________ Element_________________Default_____Description___________ LADRequestFrame ladrfrm.blp Used as the frame for the List Available Drawers search criteria form LADRequestToolbar ladtool.blp Used as the toolbar for the List Available Drawers search criteria form LADRequestHead header.blp[1Used as the header on the List Available Drawers search criteria form LADRequestTail footer.blp[2Used as the footer on the List Available Drawers search criteria form LADRequest ladr.blp Used as the List Available Drawers search criteria form ListAvailableDrawerFrameladframe.blpUsed as the frame for the List Available Drawers results form ListAvailableDrawerToolbladtool.blp Used as the toolbar for the List Available Drawers results form ListAvailableDrawerHead header.blp[1Used as the header on the List Available Drawers results form [1]This_setting_is_the_same_as_DefaultHead;_if_you_have___ specified another setting for DefaultHead, the latest default value will be used. [2]This setting is the same as DefaultTail; if you have specified another setting for DefaultTail, the latest default value will be used. (continued on next page) 2-12 Customizing the DIGITAL Office Server Web Interface Customizing the DIGITAL Office Server Web Interface 2.2 Customizing the Configuration File Boilerplates Table_2-4_(Cont.)_Boilerplate_Elements____________________ Element_________________Default_____Description___________ ListAvailableDrawerTail footer.blp[2Used as the footer on the List Available Drawers results form ListAvailableDrawers lad.blp Used as the List Available Drawers results form FindRequestFrame findfrm.blp Used as the frame for the Find request form FindRequestToolbar findtb.blp Used as the toolbar for the Find request form FindRequestHead header.blp[1Used as the header on the Find request form FindRequestTail footer.blp[2Used as the footer on the Find request form FindRequest findr.blp Used as the Find request form FindFrame findfrm.blp Used as the frame for the Find results form FindToolbar findtb.blp Used as the toolbar for the Find results form FindHead header.blp[1Used as the header on the Find results form FindTail footer.blp[2Used as the footer on the Find results form Find find.blp Used as the Find results form [1]This_setting_is_the_same_as_DefaultHead;_if_you_have___ specified another setting for DefaultHead, the latest default value will be used. [2]This setting is the same as DefaultTail; if you have specified another setting for DefaultTail, the latest default value will be used. (continued on next page) Customizing the DIGITAL Office Server Web Interface 2-13 Customizing the DIGITAL Office Server Web Interface 2.2 Customizing the Configuration File Boilerplates Table_2-4_(Cont.)_Boilerplate_Elements____________________ Element_________________Default_____Description___________ LogoffFrame lofframe.blpUsed as the frame for the logoff form LogoffToolbar logontb.blp Used as the toolbar for the logoff form LogoffHead header.blp[1Used as the header on the Logoff form LogoffTail footer.blp[2Used as the footer on the Logoff form Logoff logoff.blp Used as the Logoff form AnonListFrame anonfrm.blp Used as the frame for the form that you want to use to list public drawers AnonListToolbar anontool.blpUsed as the toolbar for the the form that you want to use to list public drawers AnonListHead header.blp[1Used as the header on the form that you want to use to list public drawers AnonListTail footer.blp[2Used as the footer on the form that you want to use to list public drawers [1]This_setting_is_the_same_as_DefaultHead;_if_you_have___ specified another setting for DefaultHead, the latest default value will be used. [2]This setting is the same as DefaultTail; if you have specified another setting for DefaultTail, the latest default value will be used. (continued on next page) 2-14 Customizing the DIGITAL Office Server Web Interface Customizing the DIGITAL Office Server Web Interface 2.2 Customizing the Configuration File Boilerplates Table_2-4_(Cont.)_Boilerplate_Elements____________________ Element_________________Default_____Description___________ AnonList anonform.blpUsed as the form that you want to use to list public drawers PromptFrame prmframe.blpUsed as the frame for the prompt for sensitivity settings PromptToolbar prmtool.blp Used as the toolbar for the prompt for sensitivity settings PromptHead header.blp[1Used as the header for the prompt for sensitivity settings PromptTail footer.blp[2Used as the footer for the prompt for sensitivity settings PromptSensitivity senprmpt.blpUsed as the form for the prompt for sensitivity settings CreateFrame createframe.Used as the frame for the Create Message form. CreateToolbar toolbar.blp[Used as the toolbar for the Create Message form. [1]This_setting_is_the_same_as_DefaultHead;_if_you_have___ specified another setting for DefaultHead, the latest default value will be used. [2]This setting is the same as DefaultTail; if you have specified another setting for DefaultTail, the latest default value will be used. [3]This setting is the same as DefaultToolbar; if you have specified another setting for DefaultToolbar, the latest default value will be used. (continued on next page) Customizing the DIGITAL Office Server Web Interface 2-15 Customizing the DIGITAL Office Server Web Interface 2.2 Customizing the Configuration File Boilerplates Table_2-4_(Cont.)_Boilerplate_Elements____________________ Element_________________Default_____Description___________ CreateHead header.blp[1Used as the header for the Create Message form. CreateTail footer.blp[2Used as the footer for the Create Message form. CreateForm createform.bUsed as the Create Message form. ForwardFrame forwardframeUsed as the Forward Message form. ForwardToolbar toolbar.blp[Used as the toolbar for the Forward Message form. ForwardHead header.blp[1Used as the header for the Forward Message form. ForwardTail footer.blp[2Used as the footer for the Forward Message form. ForwardForm forwardform.Used as the Forward Message form. AnswerFrame answerframe.Used as the frame for the prompt for sensitivity settings [1]This_setting_is_the_same_as_DefaultHead;_if_you_have___ specified another setting for DefaultHead, the latest default value will be used. [2]This setting is the same as DefaultTail; if you have specified another setting for DefaultTail, the latest default value will be used. [3]This setting is the same as DefaultToolbar; if you have specified another setting for DefaultToolbar, the latest default value will be used. (continued on next page) 2-16 Customizing the DIGITAL Office Server Web Interface Customizing the DIGITAL Office Server Web Interface 2.2 Customizing the Configuration File Boilerplates Table_2-4_(Cont.)_Boilerplate_Elements____________________ Element_________________Default_____Description___________ AnswerToolbar toolbar.blp[Used as the toolbar for the prompt for the Answer Message form AnswerHead header.blp[1Used as the header for the Answer Message form AnswerTail footer.blp[2Used as the footer for the Answer Message form AnswerMsg answerform.bUsed as the for the Answer Message form [1]This_setting_is_the_same_as_DefaultHead;_if_you_have___ specified another setting for DefaultHead, the latest default value will be used. [2]This setting is the same as DefaultTail; if you have specified another setting for DefaultTail, the latest default value will be used. [3]This setting is the same as DefaultToolbar; if you have specified another setting for DefaultToolbar, the latest default value will be used. __________________________________________________________ 2.2.1 Customizing Boilerplate Settings to Not Use Frames If you decide to create a user interface that does not use frames, there are a number of extra steps that you need to take: Customizing the DIGITAL Office Server Web Interface 2-17 Customizing the DIGITAL Office Server Web Interface 2.2 Customizing the Configuration File Boilerplates __________________________________________________________ Step_Action_______________________________________________ 1 In config.awi, change the nameFrame setting (where name is the variable, as shown in Table 2-4) to refer to the same boilerplate as the appropriate main page setting. For example, in the folder list, where the frame setting is DocumentFrame and the main page setting is Folders, these should refer to the same file: FolderFrame=my_listfold.blp Folders=my_listfold.blp __________________________________________________________ 2 Repeat this for all the nameFrame settings. For example, you may set the logon settings as follows: LogonFrame=logon.blp Logon=logon.blp __________________________________________________________ The following restrictions apply if you turn off the use of frames: o The xHead and xTail settings (where x is the variable) are ignored. o You must provide a directive in your pages at the point you want to see a toolbar, or no toolbar will be shown. 2.2.2 Customizing the Logon Form to Log On to a Different Port (Windows NT only) The Web Interface by default uses the logon.blp boiler- plate as the logon form. You can customize the logon.blp boilerplate if you want to change the port number that the Web Interface uses to connect to DIGITAL Office Server. To change the port number: 1. In the logon.blp boilerplate, enter: 2-18 Customizing the DIGITAL Office Server Web Interface Customizing the DIGITAL Office Server Web Interface 2.2 Customizing the Configuration File Boilerplates 2. Then, either o To define a port number that users cannot change, enter: Port number: where n is the port number that you want to define. OR o To allow users to be able to define a port number, enter the following in the logon.blp boilerplate: Port number: 2.3 Using the DIGITAL Office Server Web Interface Boilerplate Directives DIGITAL Office Server Web Interface boilerplate directives allow you to display document attributes, for example, the document author. The Web Interface boilerplate directives are of the form . Table 2-5 shows the directives that you can use in your customized boilerplate files. ________________________Note ________________________ In the frame or toolbar boilerplates, you can only use the directives beginning with and , and the directive . _____________________________________________________ Table_2-5_Web_Interface_Boilerplate_Directives____________ Directive_____________________Description_________________ The path taken by the web server to access the Web Interface. The URL of the Search button The current URL (continued on next page) Customizing the DIGITAL Office Server Web Interface 2-19 Customizing the DIGITAL Office Server Web Interface 2.3 Using the DIGITAL Office Server Web Interface Boilerplate Directives Table_2-5_(Cont.)_Web_Interface_Boilerplate_Directives____ Directive_____________________Description_________________ The current URL, minus the script name The URL of the last accessed object (if a document is refiled, this is not modified) For a File Cabinet only server (with no mail), this has a value of 1 The URL of the file cabinet list The URL of the Inbox The URL of the mail drawer This is set to 1 if you are logged on, 0 if not The first TO addressee of the message. The first CC addressee of the message. The first BCC addressee of the message. When embedded in a $FOREACH special directive, this will display all values of the specified directive. See Section 2.4.2. The number of TO addressees on the message. The number of CC addressees on the message. The number of BCC addressees on the message. (continued on next page) 2-20 Customizing the DIGITAL Office Server Web Interface Customizing the DIGITAL Office Server Web Interface Using the DIGITAL Office Server Web Interface Boilerplate Directives Table_2-5_(Cont.)_Web_Interface_Boilerplate_Directives____ Directive_____________________Description_________________ The total number of addressees (TO, CC and BCC) on the message. The subject of the message. The sensitivity of the message. The system sensitivity default value - the values are 0-not sensitive; 1- personal; 2-private; 3- company confidential The download value for Personal documents-the values are 0-allow; 1- disallow; 2-prompt. The default value is 0 The download value for Private documents-the values are 0-allow; 1-disallow; 2-prompt. The default value is 0 The "From" mail address of the sender. The department of the sender of the message. The telephone number of the message's sender. (continued on next page) Customizing the DIGITAL Office Server Web Interface 2-21 Customizing the DIGITAL Office Server Web Interface 2.3 Using the DIGITAL Office Server Web Interface Boilerplate Directives Table_2-5_(Cont.)_Web_Interface_Boilerplate_Directives____ Directive_____________________Description_________________ The "Sent by" address of the message. The contents of the message, or hyperlinks if the message is not displayable. The status of the message. The value of MAIL or DOCUMENT Whether with attachments or not-1 is has attachments, 0 is has no attachments Importance-High, Normal, or Low The document number Read receipt request-yes or no Delivery receipt request-yes or no Mail priority-2nd Class, 1st Class or Express Whether forwardable (yes or no) The owner of the drawer. The description of the drawer. The modified date of the document. The created date of the document. The title of the document, or subject if there is no title. (continued on next page) 2-22 Customizing the DIGITAL Office Server Web Interface Customizing the DIGITAL Office Server Web Interface Using the DIGITAL Office Server Web Interface Boilerplate Directives Table_2-5_(Cont.)_Web_Interface_Boilerplate_Directives____ Directive_____________________Description_________________ Adds RE: to the title. Adds FWD: to the title The author of the document. The FORMAT of the document. The DSAB of the document. The unique name of the container object, for example, the folder of a document The name of the drawer or folder, depending on the context. The nickname of the drawer The approximate size of the document in bytes. The approximate size of the document in kilobytes. The file extension of the document, for example, TXT. The EUID of the File Cabinet object in HTML-friendly form. Use in most normal cases. The structural type of the document. Used by the DIGITAL Office Server Web Interface internally. The MIME type of the document. This is generated by the Web Interface if the document does not have a mimeid. (continued on next page) Customizing the DIGITAL Office Server Web Interface 2-23 Customizing the DIGITAL Office Server Web Interface 2.3 Using the DIGITAL Office Server Web Interface Boilerplate Directives Table_2-5_(Cont.)_Web_Interface_Boilerplate_Directives____ Directive_____________________Description_________________ The document's DOCDB customer field. The document's DAF customer1 field. The document's DAF customer2 field. The document's DAF customer3 field. The document's DAF customer4 field. The document's DAF customer5 field. This is the URL of the File Cabinet object and it is generated by the DIGITAL Office Server Web Interface. Use in preference to the EUID. DIGITAL Office Server Web Interface generated attribute-the format /handling of the document, which is derived from FORMAT and DSAB. This can be used to position a toolbar. The path taken by the web server to access the image (.GIF) files. The path taken by the web server to access the Web Interface help files. (continued on next page) 2-24 Customizing the DIGITAL Office Server Web Interface Customizing the DIGITAL Office Server Web Interface Using the DIGITAL Office Server Web Interface Boilerplate Directives Table_2-5_(Cont.)_Web_Interface_Boilerplate_Directives____ Directive_____________________Description_________________ Allows insertion of URL query string attribute values, where x is the name of the attribute. For example, for the query string ?user=me&sys=tem, is replaced by the string me, and is replaced by the string tem. If the directive is misspelled (for example, is spelled ) it generates an empty string of text. Allows pre-completion of text fields in the framed user interface by allowing replacement by a query string, and addition of &frame=toolbar. Allows pre-completion of text fields in the framed user interface by allowing replacement by a query string, and addition of &frame=body. The character or characters used to define a command ______________________________string._____________________ 2.3.1 Web Interface Boilerplate Directive Modifiers There are three modifiers that can be used with the boilerplate directives listed in Table 2-5 (with the exception of !EACHVAL, !COMMANDPREFIX and !DOSWI_ LOGGEDON). These modifiers are :E, :D, and :U and are used with the directive in the format . :E Customizing the DIGITAL Office Server Web Interface 2-25 Customizing the DIGITAL Office Server Web Interface 2.3 Using the DIGITAL Office Server Web Interface Boilerplate Directives stands for encoding, :D stands for decoding, and :U stands for untranslated. :E encodes a directive's value so that no other characters that would have meaning in a URL (such as the ampersand character (&)) are present. :D does the reverse; it decodes the directive's value. For :D to generate meaningful results, the directive's value must have been encoded using :E. If :U is used with a directive, it returns values that are in their untranslated form. 2.4 Using the DIGITAL Office Server Web Interface Special Directives There are some additional special directives that you can use: o $BEGINLOOP and $ENDLOOP o $FOREACH and $ENDFOREACH o $IF, $ELSE and $ENDIF 2.4.1 $BEGINLOOP and $ENDLOOP The following notes apply to the use of these directives: o The directives must appear on a line of their own, without any whitespace. o The directives bound the section of the boilerplate that is to be repeated for every File Cabinet object the boilerplate is showing. The following example shows the use of some of these special directives: Documents Documents in folder
    $BEGINLOOP

  • ( document, bytes, last modified )
    Created , Mimetype
    Customer0 = 2-26 Customizing the DIGITAL Office Server Web Interface Customizing the DIGITAL Office Server Web Interface 2.4 Using the DIGITAL Office Server Web Interface Special Directives
    Customer1 =
    Customer2 =
    Customer3 =
    Customer4 =
    Customer5 = $ENDLOOP
) 2.4.2 $FOREACH and $ENDFOREACH The $FOREACH and $ENDFOREACH special directives are used to include multi-valued attributes in boilerplates. The following notes apply to the use of the $FOREACH and $ENDFOREACH special directives: o The $FOREACH and $ENDFOREACH special directives cannot be nested, and are case-insensitive. o The $FOREACH special directive must have a white space followed by a , and must be on a line of its own. o The $ENDFOREACH special directive must appear on a line of its own, without being preceded by white space. o There must be one $ENDFOREACH for every $FOREACH in a boilerplate. o The special directives bound the section of the boilerplate that is to be repeated for every occurrence of the directive, using the directive EACHVAL. The following example shows the use of these special directives: Test Message . . . $FOREACH TO: $ENDFOREACH Customizing the DIGITAL Office Server Web Interface 2-27 Customizing the DIGITAL Office Server Web Interface 2.4 Using the DIGITAL Office Server Web Interface Special Directives 2.4.3 $IF, $ELSE, and $ENDIF The $IF, $ELSE and $ENDIF special directives are used to include text and directives in boilerplates when certain conditions are TRUE or not. The following notes apply to the use of these directives: o The $IF, $ELSE and $ENDIF special directives can be nested. o The $IF, $ELSE and $ENDIF special directives are case- insensitive. o The $IF special directive must have a white space followed by a boolean expression, and must be on a line of its own. o There must be one $ENDIF for every $IF in a boiler- plate. o $ELSE is optional, but, if used, must appear after the $IF and before the $ENDIF special directives. o Everything between the $IF and the first $ELSE or $ENDIF is included in the boilerplate if the boolean expression is TRUE. o Everything between the $ELSE and the $ENDIF is included in the boilerplate if the boolean expression with the associated $IF is FALSE. The following example shows the use of these special directives: Test Message . . . $IF LE 5 $FOREACH TO: $ENDFOREACH $ENDIF . . . 2-28 Customizing the DIGITAL Office Server Web Interface Customizing the DIGITAL Office Server Web Interface 2.4 Using the DIGITAL Office Server Web Interface Special Directives The boolean expressions that can be used with $IF, $ELSE and $ENDIF are shown in Table 2-6. Table 2-6 Boolean Expressions used with $IF, $ELSE and __________$ENDIF__________________________________________ ExpressionMeaning_________________________________________ EQS Equals string NES Not equals string GTS Greater than string GES Greater than or equal to string LTS Less than string LES Less than or equal to string EQ Equal number NE Not equal to number GT Greater than number GE Greater than or equal to number LT Less than number AND And (value) OR________Or_(value)______________________________________ 2.5 Customizing the MIME Types Mapping File You may need to customize the MIME types mapping file if the MIME type generated by DIGITAL Office Server or ALL-IN-1 is not what you want. The default MIME types mapping file, mimemap.awi, contains lines of MIME type and Office Server format pairs. The Office Server type is listed first. If none of the mappings matches a file type, one of the lines must be the special mapping: *=application/x-* In the special mapping, * always matches, and the * in the MIME type is replaced by the lowercase version of the Office Server type. This mapping is also built into the DIGITAL Office Server Web Interface, and is used if the MIME mapping file is missing. Customizing the DIGITAL Office Server Web Interface 2-29 Customizing the DIGITAL Office Server Web Interface 2.6 Setting Up Indirect (Brokered) Connections 2.6 Setting Up Indirect (Brokered) Connections As the default for anonymous (non-logged-in) users, DIGITAL Office Server Web Interface always tries to connect directly to the File Cabinet Server on the node that the user specifies. For example, the user may specify the node directly as part of the URL or supply it in the System: field on the displayed request form. In the Web Interface configuration file, CONFIG.AWI, the settings that define this behavior are DirectConnect 1 and no value for the BrokerNode field. You can customize the DIGITAL Office Server Web Interface to define a broker node which is used by the Web Interface to connect indirectly to File Cabinets on other nodes. This allows you to make File Cabinets available on nodes which do not have TCP/IP installed. To allow brokered connections, you must define BrokerNode in the Web Interface configuration file. Table 2-7 shows the types of connections that you can set up. Table_2-7_Using_the_DirectConnect_and_BrokerNode_Fields___ Field_______Value_____Meaning_____________________________ DirectConnec1 DIGITAL Office Server Web Interface and always contacts the node specified by the Web client BrokerNode Not defined __________________________________________________________ DirectConnec0 DIGITAL Office Server Web Interface and always contacts the File Cabinet Server on the node specified in the BrokerNode field BrokerNode Defined (continued on next page) 2-30 Customizing the DIGITAL Office Server Web Interface Customizing the DIGITAL Office Server Web Interface 2.6 Setting Up Indirect (Brokered) Connections Table 2-7 (Cont.) Using the DirectConnect and BrokerNode __________________Fields__________________________________ Field_______Value_____Meaning_____________________________ __________________________________________________________ DirectConnec1 and BrokerNode Defined ____________________________________ If the address Then the DIGITAL that the user Office Server Web entered...______Interface...________ contains a always contacts the period (.), File Cabinet Server it is an IP on the specified address node does not always contacts the contain a File Cabinet Server period (.), it on the node defined is not an IP as the BrokerNode address_____________________________ __________________________________________________________ 2.7 Creating URLs for File Cabinet Objects You may link directly to drawers, documents or folders from any HTML page. To do this, you must specify the URL for each File Cabinet object that you want to create a link to. The easiest way to do this is to access the URL from the Web Interface, then cut and paste the displayed URL from the location field into your HTML page. The format of the URL is: where: o doswi is the mapping to the DIGITAL Office Server Web Interface software that you have set up, see Section 1.2.1 Customizing the DIGITAL Office Server Web Interface 2-31 Customizing the DIGITAL Office Server Web Interface 2.7 Creating URLs for File Cabinet Objects o node is the name of the node that you are connecting to o /owner/drawer/folder is the specification for the folder that you want to access 2-32 Customizing the DIGITAL Office Server Web Interface 3 ________________________________________________________________ Security Implications This chapter explains the different levels of security available for DIGITAL Office Server and ALL-IN-1 Version 3.2 systems. 3.1 Anonymous Access (Non-Logged-in Users) Access to the Web Interface is through a special account called WEB$ACCESS. The File Cabinet Server performs authentication checks on the WEB$ACCESS OpenVMS account. This allows you to control access to this WEB$ACCESS account at the drawer level. You can control Web Interface access to world readable drawers by adding the WEB$ACCESS account to the list of users and setting leaving Read access blank or setting it to No. 3.2 Logged-On Users Access for logged-on users is defined by the Office Server Drawer Manageemnt facilities. Security Implications 3-1 4 ________________________________________________________________ Troubleshooting This chapter gives troubleshooting hints for problems you may encounter after installing the Web Interface. Table_4-1_Problems_and_Solutions__________________________ After OpenVMS in- This is probably because stallation, trying to Web Interface has not been access the Web Interface installed under Purveyor's generates the error The scripts directory. See requested URL is invalid. Section 1.2. HTTP status code: 404 Cannot see images or help This is probably because the virtual directories for /doswiimage and /doswihelp are not defined correctly. See Section 1.2.1. Clicking Search generates The Find Results page stays old data in cache. If you click Search, then before performing the same search again, the drawer contents have changed, a second search may generate an outdated list. Click Reload or Refresh to load the correct information. (continued on next page) Troubleshooting 4-1 Troubleshooting Table_4-1_(Cont.)_Problems_and_Solutions__________________ Drawers or folders do not Lists of drawers or folders seem to be up to date stay in cache. This means that when redisplaying the page, a cached list may displayed. Click Reload or Refresh to load the correct information. Buttons do not work with This is probably because you a Netscape browser are using Netscape Navigator 3.00, which is not supported with Version 5.01 of the Web Interface. Upgrade your browser to a later version of Netscape Navigator-such as version 3.01. Setting automatic If, in a previous logged-on refreshing of folders session, you selected not to does not seem to work refresh folders automatically, then you log on and select automatic refeshing of folders, pages that you viewed in the previous session will not be refreshed automatically. Press the Reload (or Refresh) browser button to make sure they are refreshed. Clicking on the Inbox This is because the Inbox is button generates a "not empty. found"_error______________________________________________ 4-2 Troubleshooting