November 2012
GroupWise Web Services lets you access Novell GroupWise data from the server. It uses industry standards to directly communicate with GroupWise Post Office Agent (POA). This protocol uses a combination of HTTP, SOAP, and XML to create a GroupWise Web service.
To see what has changed for each version of GroupWise, see Revision History
in GroupWise SDK: Web Services and Revision History
in GroupWise SDK: Web Services Events.
You can download an evaluation copy of GroupWise from the Novell Downloads site.
For complete installation instructions, see the GroupWise 2012 Installation Guide.
Your download includes various files in the following subdirectories:
Each subdirectory has its own readme.text file the provides additional details.
The files in the New to GroupWise Web Services directory have been used to teach GroupWise Web Services in hands-on classes to help developers gain a quick understanding and experience with GroupWise Web Services.
GW Web Services Slides.pdf contains the slides from the developer hands-on session at BrainShare and gives an overview of how GroupWise and the SOAP protocol work together.
MSNET Setup.pdf explains how to set up your environment to run the included .NET applications.
NetBeans Setup.pdf explains how to set up your environment to run the included Java NetBean programs.
tracing SOAP messages.txt explains how to set up a trace utility that captures the SOAP/XML data on the wire. If SSL is used, this trace utility does not display the XML data.
The WSDL and Schemas directory includes the following files:
readme.txt explains WSDL and schema files.
groupwise.wsdl is a GroupWise Web Services Description Language (WSDL) file.
methods.xsd is an XML schema that describes the GroupWise methods and actions.
types.xsd is an XML schema that describes GroupWise data elements.
events.xsd is an XML schema that describes GroupWise events.
There is a subdirectory called MS.NET that contains modified schema files for Microsoft .NET. The readme.txt file contains more information about this subdirectory.
The errorCodes directory contains the engwerr.txt file that defines the error codes returned by GroupWise Web Services.
Client examples that demonstrate how to use GroupWise Web Services are written in Java, .Net, and C++.
The clients directory contains the following subdirectories under the \Java\JAX-RPC subdirectory:
JavaClient contains a feature-rich Java program that demonstrates more of the features that are available in GroupWise Web Services.
gwws contains precompiled GroupWise Web Services libraries that are included in the JavaClient and BrainShare06 clients.
The clients directory also contains the following subdirectories under the \MS subdirectory. All of the examples were written in .NET 2005.
beepClient contains a VC6 example program that demonstrates the GroupWise SOAP protocol without using the WSDL and schemas to generate a library. The readme.txt file in the clients directory contains information on how to run this program.
eventListener contains a .NET VB program that demonstrates GroupWise events. It registers for events for all users on a post office, listens for changes, and performs some actions based on the event.
populateMailboxes contains a .NET VB program that demonstrates GroupWise Web Services. It randomly populates all mailboxes on a post office and is a great tool to test scalability.
vcsClient contains a C# application that demonstrates how to log in to GroupWise and retrieve the folder and item list.
You can view the Web Services documentation on the Novell Developer Web site.
Please direct technical questions and comments to the Novell Developer Forum.
You can also find helpful information in GroupWise Cool Solutions.
Novell, Inc. makes no representations or warranties with respect to the contents or use of this documentation, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further, Novell, Inc. reserves the right to revise this publication and to make changes to its content, at any time, without obligation to notify any person or entity of such revisions or changes.
Further, Novell, Inc. makes no representations or warranties with respect to any software, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further, Novell, Inc. reserves the right to make changes to any and all parts of Novell software, at any time, without any obligation to notify any person or entity of such changes.
Any products or technical information provided under this Agreement may be subject to U.S. export controls and the trade laws of other countries. You agree to comply with all export control regulations and to obtain any required licenses or classification to export, re-export, or import deliverables. You agree not to export or re-export to entities on the current U.S. export exclusion lists or to any embargoed or terrorist countries as specified in the U.S. export laws. You agree to not use deliverables for prohibited nuclear, missile, or chemical biological weaponry end uses. Please refer to http://www.novell.com/info/exports/ for more information on exporting Novell software. Novell assumes no responsibility for your failure to obtain any necessary export approvals.
All files provided in this release are subject to the Novell Developer License Agreement, which can be found in the license.txt file provided in this download.
Copyright © 2006-2007, 2012 Novell, Inc. All rights reserved. No part of this publication may be reproduced, photocopied, stored on a retrieval system, or transmitted without the express written consent of the publisher.
For Novell trademarks, see the Novell Trademark and Service Mark list.
All third-party trademarks are the property of their respective owners.