WD97: Word 97 Supports ODMA

Last reviewed: November 17, 1997
Article ID: Q159963
The information in this article applies to:
  • Microsoft Word 97 for Windows
  • Microsoft Office 97 for Windows

SUMMARY

ODMA is a standardized, high-level interface that enables you to transparently access a document management system (DMS) from your desktop program.

ODMA makes DMS services available to you through a desktop program, such as Microsoft Word 97 for Windows. With ODMA, these services appear to be an extension of the program.

Common DMS software packages will replace the standard Open and Save dialog boxes in Word with customized dialog boxes that provide security and version control functions such as:

  • a way to enter or remove a document
  • controlled access to documents
  • locks on any document when checked out
  • some degree of security when distributing documents
  • a means for quick searches on the names of documents in the system
  • a means of tracking access to the document system

In order to enable ODMA functionality in Word or Office, you must install a DMS system along with the Word or Office software.

MORE INFORMATION

Described below are the specific files and steps an application goes through during integration.

Opening an ODMA-compliant Application

  1. The application looks to see if an ODMA compliant document management product is installed. It does this by first looking in the Windows Registry.

    Using Regedit and doing a search on ODMA32 will display the ODMA key.

  2. After finding the ODMA32 entry, the application will look under the key to find which document management product is installed.

    In this case the entry GRPWISE will be found. The value for this key is Gwodm132.dll.

  3. After finding that ODMA is registered, the application then redirects certain calls to the Odma32.dll.

  4. The Odma32.dll then calls two GroupWise DLLs which handle the application's function calls. These files are Gwodm132.dll and Gwdm1us.dll. All three of these files are located in the Windows\System directory.

Point-to-Point Integrations

Point-to-Point integrations involve applications that are not ODMA compliant. Novell has written macros for various applications that allow these applications to integrate with GroupWise 5 and achieve the same functionality as ODMA compliant applications. Currently there are only two of these applications: Microsoft Word 7.x and Excel 7.x.

Opening a Point-to-Point Integrated Application

  1. When the application starts it looks in its startup directory for any macros to load. The startup directory for Excel 7.x is Xlstart; the Word 7.x startup directory is Startup. When the GroupWise client is installed, it will copy the appropriate macro to the startup directory. The Excel 7.x macro is Gwxlus.Xla and the Word 7.x macro is Gwnormus.dot (the letters "us" in the macro name designate language and will be different depending upon the language of the add-in or template).

  2. Steps 2, 3 and 4 are the same in the earlier section "Opening an ODMA Application." The only difference is that the macro is responsible for making the appropriate calls, rather than the application itself.

Installing a Point-to-Point Integrated Application after GroupWise Client

To do this, follow these steps:

  1. Copy the appropriate file for Excel 7.x or Word 7.x from the GroupWise Client directory to the startup directory for the application as listed earlier in this article.

  2. Edit the Gwappint.inf file located in the Windows\System directory.

    This is a text file, not a Windows installation file.

  3. Find the [Word 7] or [Excel 7] section.

  4. Change the Integrations line to read "INTEGRATIONS=1"

  5. Open GW5 and create a New Document for that program (Word / Excel). Open the document and integrations should now appear.

Windows Registry

The GroupWise 5 Document Management places the following two keys in the Windows Registry:

Path: HKEY_CURRENT_USER\Software\Novell\GroupWise\Client Key: Integration First Time Value Name: (Default) Value Data: Done\Yes

Path: HKEY_CURRENT_USER\Software\Novell\GroupWise\Client Key: Library Value Name: Integrations Value Data: Enable\Disabled

DOCUMENT MANAGEMENT SYSTEM SOFTWARE VENDORS

 PC DOCS, Inc.
 124 Marriott Drive
 Tallahassee, Florida 32301
 Telephone:      (800) 933-3627
 Internet Site:  http://www.pcdocs.com/

 DOCUMENTUM, INC.
 5671 Gibraltar Drive
 Pleasanton, CA 94588-8547
 Telephone:      (510) 463-6800
                 (888) 362-3367
 Fax Number:     (510) 463-6850
 Internet Site:  http://www.documentum.com/

 SAROS
 10900 N.E. 8th St.
 700 Plaza Center
 Bellevue, WA 98004
 Telephone:      (425) 646-1066
                 (800) 827-2767
 Fax Number:     (425) 462-0879
 Internet Site:  http://www.saros.com/

 Groupwise
 Novell
 1555 North Technology Way
 Orem, UT 84097
 Telephone:      (801) 222-6000
 Internet Site:  http://www.novell.com/groupwise

The third-party products discussed here are manufactured by vendors independent of Microsoft; we make no warranty, implied or otherwise, regarding these products' performance or reliability.

The third-party contact information included in this article is provided to help you find the technical support you need. This contact information is subject to change without notice. Microsoft in no way guarantees the accuracy of this third-party contact information.


KBCategory: kbref kb3rdparty
KBSubcategory:
Additional query words: 8.0 word8 word97 odma api
Keywords : kb3rdparty kbref
Version : 97
Platform : WINDOWS


THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY.

Last reviewed: November 17, 1997
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.