76.3 Customizing User Functionality

You can control the functionality of certain aspects of the GroupWise WebAccess user interface. Any changes you make take effect the next time users log in to WebAccess.

76.3.2 Controlling the WebAccess New Item Notification Sound

Customizing the New Item Notification Sound

You can customize the sound that WebAccess users hear when a new item arrives in their GroupWise Mailbox. The default sound file is named notifyClient.wav.

  1. Copy the desired sound file to a location on your web server where it can be played by specifying a URL.

    The sound file must reside on the same server with the WebAccess Application that you are configuring. You can put it in a subfolder under your web server’s document root folder.

  2. Open the webacc.cfg file in a text editor.

  3. Search to find the following line:

    Notification.NewMail.sound=
    
  4. Replace the default URL with the URL for the desired sound file.

  5. Save the webacc.cfg file.

  6. Skip to Section 76.1.7, Putting WebAccess Configuration Changes into Effect.

Turning Off the New Item Notification Sound

  1. Open the webacc.cfg file in a text editor.

  2. Search to find the following line:

    Notification.enabled=true
    
  3. Change true to false.

  4. Save the webacc.cfg file.

  5. Skip to Section 76.1.7, Putting WebAccess Configuration Changes into Effect.

76.3.3 Customizing Auto-Refresh Functionality

WebAccess automatically refreshes users’ web browsers so that the current contents of their mailboxes are always displayed.

By default, WebAccess uses 5 threads for polling, with a maximum of 20 threads allowed, and polling takes place on port 8500.

By default, WebAccess starts actively polling for updates from the POA after 10 minutes of inactivity, and keeps checking every minute until it is contacted by the POA

You can change these behaviors as needed.

  1. Open the webacc.cfg file in a text editor.

  2. Search to find the following lines:

    #SOAP.Poll.port=8500
    #SOAP.Poll.Threads.default=5
    #SOAP.Poll.Threads.max=20
    
  3. Remove the pound sign (#) to activate the setting.

  4. Adjust a poll settings as needed for your WebAccess users.

  5. Search to find the following lines:

    Poll.Idle.timeout=10
    Poll.Idle.interval=1
    
  6. Save the webacc.cfg file.

  7. Skip to Section 76.1.7, Putting WebAccess Configuration Changes into Effect.

76.3.4 Controlling Viewable Attachment Types

By default, WebAccess allows users to view attachments in their native file formats for all file extensions except .rar (Roshall Archive, a compressed archive format) and .avi (Audio Visual Interleaf format). For all other file types, the View link is available in WebAccess. You can configure the WebAccess Application so that the View link is not available for additional file types.

To add to the list of file types that WebAccess users cannot view in native file format:

  1. Open the webacc.cfg file in a text editor.

  2. Search to find the following line:

    Document.View.excludeDocExtensions=
    
  3. Add file extensions to the list, separating each file extension with a comma.

    Do not include periods on the file extensions or spaces between the file extensions.

  4. Save the webacc.cfg file.

  5. Skip to Section 76.1.7, Putting WebAccess Configuration Changes into Effect.

76.3.5 Controlling Viewable Attachment Size

By default, users can view allowable attachment types that are less than 1 MB is size. Increasing the maximum viewable attachment size increases the load on the web server. Decreasing the maximum viewable attachment size decreases the load on the web server.

For allowable attachment types that do not exceed the size limit, the View link is available in WebAccess. For allowable attachment types that exceed the size limit, the View link is not available, and users must save the large attachments in order to view them.

To adjust the viewable attachment size limit:

  1. Open the webacc.cfg file in a text editor.

  2. Search to find the following line:

    Document.View.maxSize=
    
  3. Increase or decrease the size as needed.

    Specify the size in bytes. For example, 1024000 is 1 MB.

  4. Save the webacc.cfg file.

  5. Skip to Section 76.1.7, Putting WebAccess Configuration Changes into Effect.

76.3.6 Customizing the Default Calendar View

By default, WebAccess displays the Week view of the calendar.

You can change the default to the Day view.

Or you can change the default to the month view.

The default you select affects how the Calendar displays for GroupWise users to access their mailboxes through this instance of the WebAccess Application.

To change the default Calendar view:

  1. Open the webacc.cfg file in a text editor.

  2. Search to find the following line:

    User.Calendar.defaultView=
    
  3. Change Week to Day or Month.

  4. Save the webacc.cfg file.

  5. Skip to Section 76.1.7, Putting WebAccess Configuration Changes into Effect.

76.3.7 Customizing the Default List Functionality

By default, in lists of items, contacts, and Find results, GroupWise WebAccess users can Shift+click and Ctrl+click to select multiple items to perform an action on.

Some web-based interfaces use check boxes for multiple selection. This interface option is also available for GroupWise WebAccess.

To configure WebAccess to display check boxes:

  1. Open the webacc.cfg file in a text editor.

  2. Search to find the following line:

    List.Checkboxes.show=
    
  3. Change false to true.

  4. Save the webacc.cfg file.

  5. Skip to Section 76.1.7, Putting WebAccess Configuration Changes into Effect.

76.3.8 Customizing New Item Handling for Tablet Users

By default, WebAccess Mobile previews the first unread message when the user logs in. You can configure WebAccess Mobile to open the first unread message rather than previewing it, if that is more convenient for users.

  1. Open the webacc.cfg file in a text editor.

  2. Search to find the following line:

    Mobile.Interface.UnreadItem.showMessagePreview=true
    
  3. Change true to false.

  4. Save the webacc.cfg file.

  5. Skip to Section 76.1.7, Putting WebAccess Configuration Changes into Effect.

76.3.9 Enabling an LDAP Address Book

You can configure WebAccess to access an LDAP directory as if it is a GroupWise address book.

  1. Open the webacc.cfg file in a text editor.

  2. Search to find the following line:

    User.Access.LDAP=false
    
  3. Change false to true to enable users to access an LDAP address book.

  4. Save the webacc.cfg file.

  5. Open the ldap.cfg file in a text editor.

  6. Replace the sample information in the ldap.cfg file with the specific information for the LDAP directory that you want users to access as a GroupWise address book.

  7. Save the ldap.cfg file.

  8. Follow the instructions in Section 76.1.7, Putting WebAccess Configuration Changes into Effect.

  9. Verify that the LDAP directory is available as a GroupWise address book:

    1. In WebAccess, open a new item.

    2. Click Address, then click the Plus icon.

    3. Expand the list of address books, then select the LDAP address book.

  10. (Conditional) If the LDAP address book does not appear in the list:

    1. Check your modifications to the webacc.cfg file and ldap.cfg file for errors.

    2. Check the WebAccess Application log file for error messages.

      For assistance, see Section 77.2, Using WebAccess Application Log Files.

    3. Resolve the problem, so that the LDAP address book appears in the list of address books.

  11. Verify that the LDAP address book works as expected:

    1. Send a message to a recipient in the LDAP address book.

    2. Verify that the message was delivered successfully.

  12. Notify GroupWise users that the LDAP address book is available, and explain to them how to access it.

    The LDAP address book is available only in the Address Selector and only in WebAccess. It is not available in the GroupWise client.