13.17 Integrating GroupWise with Your Applications

GroupWise Integrations make it possible for you to link your applications to your GroupWise Mailbox. In an integrated application, you can see the documents in your Mailbox and folders when you select Open in the application. In addition, you can save a document as a new version using the application’s Save As feature. Integrating makes it possible for you to create, edit, and save GroupWise documents within your applications.

GroupWise can integrate with applications in one of two ways: through the Open Document Management API (ODMA) supplied by the application, or through a point-to-point integration macro.

ODMA is an open standard that makes it possible for GroupWise Library and other document management programs to communicate with your applications. Each application vendor is responsible for implementing ODMA standards. If an application is ODMA-compliant, you can integrate it with GroupWise Library.

This section contains the following topics:

13.17.1 Integrating Applications During Setup

If Setup detects that you have an ODMA-enabled application, such as WordPerfect, Microsoft Word, or Excel* properly installed, Setup prompts you to specify whether you want GroupWise to integrate with the application. If you integrate your applications and later want to disable the integration, you can turn off the integration in the Documents Setup dialog box.

13.17.2 Integrating Applications After Setup

If you don’t enable the integrations during Setup but later decide you do want to use integrations, you must run Setup again to install the integrations. After you’ve run Setup, you can turn integrations on or off for each application in the Integrations tab in Documents Setup.

After you’ve enabled integrations, you can turn them on or off at any time.

13.17.3 Turning Off Integrations

You can turn off integrations for one application or for all your applications. When you turn off integrations, your applications work like non-integrated applications, and GroupWise can’t monitor when you open and save documents. As a result, your documents are returned to the library when you close the application, not when you close the document.

This section contains the following topics:

Turning Off Integrations for All Your Applications

  1. Click Tools > Options, then double-click Documents.

  2. Click the Integrations tab.

    Documents Setup dialog box with the Integrations tab open

  3. Deselect the Enable integrations check box, then click OK.

Turning Off Integrations for One Application

  1. Click Tools > Options, then double-click Documents.

  2. Click the Integrations tab.

  3. Make sure the Enable integrations check box is selected.

  4. In the Registered applications box, click the application for which you want to turn off integrations.

  5. Click Disabled, then click OK.

When an application integration is disabled, no text displays to the right of the application name in the Registered Applications list box.

13.17.4 Turning On Integrations

Application integration is enabled during GroupWise Setup. After Setup is finished, you can turn integration on for one application or for all your eligible applications.

Before you turn on integration, verify that the application is ODMA-enabled or is supported by a point-to-point integration macro. The list of applications on the Integrations tab shows all the applications that are registered on your machine. It is not a list of ODMA-enabled applications; it is a list of registered applications. If you select an application that is not ODMA-enabled and try to turn on integration, GroupWise displays a message warning you that the application is not ODMA-enabled. If you proceed and register the non-ODMA application, the integration does not work for that application.

If the application for which you are turning on integrations has two executable files (for example, WordPerfect) you must specify the name of the main executable file (such as wpwin.exe for WordPerfect) on the Executable tab in Advanced Integrations. GroupWise launches the executable you specify, and that executable launches the application.

This section contains the following topics:

Turning On Integrations for All Your Applications

  1. Click Tools > Options, then double-click Documents.

  2. Click the Integrations tab.

  3. Select the Enable Integrations check box, then click OK.

This turns on integrations for all your integrated applications. It doesn’t have any affect on non-integrated applications.

Turning On Integrations for One Application

  1. Click Tools > Options, then double-click Documents

  2. Click the Integrations tab.

  3. Select the Enable integrations check box.

  4. In the Registered applications list box, click the application for which you want to turn on integration.

    The Registered Applications list box shows the applications that are registered on your machine. It doesn’t mean that the applications listed are ODMA-enabled.

  5. Most applications have only one executable filename; however, if the application you selected has two executable files, for example WordPerfect, click Advanced, then click the Executable tab. Type the name of the main executable file in the Dual-Executable filename field, then click OK.

  6. Click Enabled, then click OK.

13.17.5 Using Non-Integrated Applications

If you’re using non-integrated applications (most Windows 3.1 applications, MS-DOS applications, and many Windows 95 applications), you can’t integrate GroupWise with your application; however, you can still use GroupWise documents with these applications. You cannot take advantage of the integrated Open and Save features.

You can use the options on the Non-Integrated tab in Advanced Integration options to specify whether or not you want GroupWise to display a warning message when GroupWise loses contact with a non-integrated application. This message reminds you that you must manually return the document to the library. You can also specify how many seconds you want GroupWise to wait for non-integrated applications to open.

This section contains the following topics:

Turning the Warning Message for Non-Integrated Applications On or Off

GroupWise displays the warning message when it loses contact with the application. The message reminds you to manually return the document to the library.

  1. Click Tools > Options, then double-click Documents

  2. Click the Integrations tab, click Advanced, then click the Non-Integrated tab.

  3. To turn on the warning message, make sure the Display message check box is checked.

    or

    To turn off the warning message, deselect the Display message check box.

Specifying How Long GroupWise Should Wait for a Non-Integrated Application to Open

GroupWise waits the number of seconds you specify for the non-integrated application to open. If GroupWise doesn’t detect the application opening, GroupWise times out and loses contact with the document, which means GroupWise can’t return it to the library. If this happens, you must manually return the document.

If you have an application that loads very slowly, you can increase the wait interval to prevent GroupWise from timing out before the application opens.

  1. Click Tools > Options, then double-click Documents

  2. Click the Integrations tab.

  3. In the Registered applications list box, click the application for which you want to specify the wait interval.

  4. Click Advanced, then click the Non-Integrated tab.

    Document dialog box with the Non-Integrated tab open

  5. Click This application to apply the wait interval to the selected application.

    or

    Click Default for all applications to apply the wait interval to all non-integrated applications.

  6. In the Wait time to detect application field, type the number of seconds GroupWise should wait for the application to open.

  7. Click OK.