- Contents
SOAP API Developer's Guide
CIC and SOAP API Developer's Guide overview
Audience
SOAP stands for Simple Object Access Protocol. SOAP is an XML-based protocol specification that defines how information can be exchanged between computers. SOAP supplies the conventions used to invoke methods on servers, services, components and objects. This document introduces XML/SOAP concepts and explains how SOAP facilitates robust data interactions between CIC and remote web services. SOAP supplies the conventions used to invoke methods on remote servers, services, components and objects.
This publication is for managers, technical implementers, and other decision-makers who need to understand the practical implications of SOAP technology in the CIC environment. The introduction is written for a general audience who may not be familiar with XML or SOAP technology. Subsequent sections of this document guide technical implementers through the process of preplanning, installing and configuring the SOAP ISAPI Listener Task and SOAP Notifier COM Components. Instructions for using the SOAP Tracer utility are also provided.
Organization of Material
This documentation is divided into logical, easy-to-digest sections that gradually introduce concepts and specific product features. To fully understand the material, we recommend that you read topics in order. However, most topics are hyperlinked for those who prefer to read in non-linear fashion.
-
Introduction to SOAP in the CIC Environment provides short primers on XML and SOAP, and explains the relationship between XML, SOAP and the Interaction Center platform. It introduces CIC's SOAP Components.
-
Install and Configure SOAP ISAPI Listener explains how to select a host server, apply prerequisite service packs and hotfixes, and then install SOAP Listener components. This section also explains how to configure the server to prevent denial of service attacks, and how to modify the configuration so that only supported SOAPActions are forwarded to CIC for processing.
-
Install SOAP Notifier COM explains how to install and register components needed to run or develop third-party SOAPNotifierCOM applications on a desktop PC.
-
Appendix A (SOAP Transport Information) describes HTTP schema used to transport SOAP packets in the CIC environment. This appendix is for advanced readers who are curious about SOAP transport mechanisms used in CIC.
-
Appendix B (SOAP Tools) describes tools in Interaction Designer that process SOAP requests and responses.
-
Appendix C (Structure of IP Notification Messages) explains the notification message format and protocols used to send requests to and from CIC's Notifier subsystem.
-
Appendix D (SOAP ISAPI Listener Fault Messages) is a reference about fault messages returned by the SOAP ISAPI Listener.
-
Special terms used with SOAP technology are defined in a Glossary.
-
Change Log describes what's new by release.
Related Documentation
-
CIC and SOAP API Developer's Guide (this document). This paper provides primers on SOAP and XML, and discusses the components that must be installed to implement SOAP functionality in CIC.
-
Interaction Center SOAP Listener Setup installs SOAP ISAPI components on an IIS server. We highly recommend that you read Install and Configure SOAP ISAPI Listener before running the install.
-
The SOAP Notifier COM Components Install installs and registers component software used by developers to create high-performance SOAP applications.
-
SOAP Notifier COM setup optionally installs the SOAP Notifier COM API Developer's Guide (Soap_Notifier_COM_API_DG.chm). This windows help file cross-references the interfaces, methods, and properties exposed by SOAP Notifier COM objects.
-
SOAP Tools are documented in Interaction Designer help. These help topics appear when a SOAP tool or toolstep has focus and the F1 key is pressed in Interaction Designer.
Recommended Web Links
- XML Home Page at the World Wide Web Consortium (W3C)
- XML Tutorial by W3Schools
- O'Reilly XML.COM
- W3C SOAP specification document:
- SOAP Tutorial by W3Schools
- Web Services Description Language (WSDL) 1.1
- Namespaces in XML