Views

Difference between revisions of "OpenScape Business Interfaces"

The Wiki of Unify contains information on clients and devices, communications systems and unified communications. - Unify GmbH & Co. KG is a Trademark Licensee of Siemens AG.

Jump to: navigation, search
(Created page with "Many CTI and CRM applications on the market use the Microsoft TAPI interface for connecting to the telephone system. With OpenScape Business TAPI 120 V1 and OpenScape Business...")
 
Line 1: Line 1:
 +
{{Breadcrumb|0|0|Unified Communications|OpenScape Business}}
 +
 +
 +
[[OpenScape Business]] offers different types of '''Open Interfaces''' which can be used for integration of OpenScape Business features into applications and IT landscapes.
 +
 +
Interface descriptions of this site refer to OpenScape Buisness V1.
 +
 +
== Physical interfaces ==
 +
 +
* LAN Ethernet 10/100 base T
 +
* Upo E(OpenScape Office X3,X5 and X8)
 +
* S0 / S2m (OpenScape Office X3,X5 and X8)
 +
* a/b (OpenScape Office X3,X5 and X8))
 +
 +
== Protocols ==
 +
 +
=== Web Services Interface (HTTP / HTTPS) ===
 +
 +
The realization of the HTTP(S) protocol is done by the WebServices.
 +
 +
The WebServices are fully integrated into HiPath OpenScape Business V1 software.  No SW download and no external PC are required for use of the WebServices. Administration is done by Web Based Administration (WBM) of OpenScape Business.
 +
 +
{| {{DefaultTable}}
 +
! width="25%" | Documentation
 +
! width="20%" | Version / Date
 +
! width="10%" | File
 +
! width="45%" | Disclaimer
 +
|-
 +
|
 +
OpenScape Business V1
 +
 +
Web Services Interface Manual
 +
|
 +
V1.0 / dd.mm.yyyy
 +
|
 +
{{File-DL|OSOV3_WSI|pdf}}
 +
<!-- Placeholder -->
 +
 +
|
 +
You may download and use this file only if you agree to the [[About This Wiki#Disclaimer|DISCLAIMER]]. If You disagree, your are not allowed to download the file.
 +
 +
Any support regarding the WebServices interface implemtation is only be given to registered partners within the  [http://www.unify.com/us/partners/technology-partner.aspx]
 +
 +
|-
 +
|}
 +
 +
 +
 +
 +
 +
 +
 +
=== CSTA protocol ===
 +
 +
CSTA protocol implementation is based on following ECMA recommendations:
 +
 +
* [http://www.ecma-international.org/publications/standards/Ecma-269.htm ECMA-269] Services for Computer Supported Telecommunications Applications (CSTA) Phase III
 +
* [http://www.ecma-international.org/publications/standards/Ecma-285.htm ECMA-285] Protocol for Computer Supported Telecommunications Applications (CSTA) Phase III
 +
 +
 +
The CSTA interface of Open Scape Office LX/MX is licensed per CSTA link.
 +
 +
Physically it is available on Ethernet LAN 10/100 base T interface with TCP/IP.
 +
 +
Default IP address is 192.168.1.2 (OpenScape Office MX only).
 +
Default port number is 8800.
 +
 +
OpenScape Office LX/MX specific CSTA implemtation is described within:
 +
 +
 +
{| {{DefaultTable}}
 +
! width="25%" | Documentation
 +
! width="20%" | Version / Date
 +
! width="10%" | File
 +
! width="45%" | Disclaimer
 +
|-
 +
|
 +
OpenScape Office V3
 +
 +
CSTA Interface Manual
 +
|
 +
V1.0 / 04.04.2011
 +
|
 +
{{File-DL|OSOV3_CSTA|zip}}
 +
<!-- Placeholder -->
 +
 +
|
 +
You may download and use this file only if you agree to the [[About This Wiki#Disclaimer|DISCLAIMER]]. If You disagree, your are not allowed to download the file.
 +
 +
Any support regarding the CSTA implemtation is only be given to registered partners within the  http://www.unify.com/us/partners/technology-partner.aspx
 +
|-
 +
|}
 +
 +
=== Proprietary protocol for CDR-Transmission ===
 +
 +
OpenScape Office LX/MX collects data about outbound (incoming and outgoing) calls within an internal file.
 +
 +
This file can be transmitted via Ethernet LAN to external computers. To avoid inconsistencies by multiple transmission of the same file, the file should be deleted after transmission. More information about the handling, link establishing and the call data record content is given within the following document. An asynchonous transfer of single data records, as HiPath 3000 does, is not supported by OpenScape Office LX/MX.
 +
 +
 +
{| {{DefaultTable}}
 +
! width="25%" | Documentation
 +
! width="20%" | Version / Date
 +
! width="10%" | File
 +
! width="45%" | Remark
 +
|-
 +
|
 +
OpenScape Office V3
 +
 +
CDR Transmission
 +
|
 +
Axxxxx-Pyyyy-Tzzz-1-18
 +
 +
0x/2011
 +
|
 +
{{File-DL|OSOV3CDR|pdf}}
 +
|
 +
This document is currently only available in German language
 +
|-
 +
|}
 +
 +
=== SIP (Session Initiation Protocol) ===
 +
 +
SIP is physically available at the Ethernet LAN-Interface. Implementations is done according to the following RFC:
 +
 +
* VoIP overSIP
 +
** RFC 2198 RTP Payload for Redundant Audio Data
 +
** RFC 2327 SDP Session Description Protocol
 +
** RFC 2617 HTTP Authentication: Basic and Digest Access Authentication
 +
** RFC 2782 DNS RR for specifying the location of services (DNS SRV)
 +
** RFC 2833 RTP Payload for DTMF Digits, Telephony Tones and Telephony Signals
 +
** RFC 3261 SIP Session Initiation Protocol
 +
** RFC 3262 Provisional Response Acknowledgement (PRACK) Early Media
 +
** RFC 3263 SIP Locating Servers
 +
** RFC 3264 An Offer/Answer Model with the Session Description Protocol
 +
** RFC 3310 HTTP Digest Authentication
 +
** RFC 3311 Session Initiation Protocol (SIP)UPDATE Method
 +
** RFC 3323 A Privacy Mechanism for the Session Initiation Protocol (SIP)
 +
** RFC 3325 Private Extensions to the Session Initiation Protocol (SIP) for Asserted Identity within Trusted Networks
 +
** RFC 3326 The Reason Header Field for the Session Initiation Protocol (SIP)
 +
** RFC 3489 STUN - Simple Traversal of User Datagram Protocol (UDP)Through Network Address Translators (NATs)
 +
** RFC 3515 The Session Initiation Protocol (SIP) Refer Method
 +
** RFC 3550 RTP: Transport Protocol for Real-Time Applications
 +
** RFC 3551 RTP Profile for Audio and Video Conferences with Minimal Control
 +
** RFC 3581 An Extension to the Session Initiation Protocol (SIP) for Symmetric Response Routing
 +
** RFC 3891 The Session Initiation Protocol (SIP) Replaces Header
 +
 +
SIP protocol is available at subscriber lines and at trunk lines. For interoperability with VoIP Providers (SIP trunking) see [[Collaboration with VoIP Providers]].
 +
 +
== Application Interfaces ==
 +
 +
=== Microsoft TAPI ===
 
Many CTI and CRM applications on the market use the Microsoft TAPI interface for connecting to the telephone system. With OpenScape Business TAPI 120 V1 and OpenScape Business TAPI 170 V1, two new and powerful TAPI Service Providers (TSP), which are optimized for the system architecture and network topology of OpenScape Business, are now available for connecting TAPI-based applications in addition to the CallBridge Collection.<br>
 
Many CTI and CRM applications on the market use the Microsoft TAPI interface for connecting to the telephone system. With OpenScape Business TAPI 120 V1 and OpenScape Business TAPI 170 V1, two new and powerful TAPI Service Providers (TSP), which are optimized for the system architecture and network topology of OpenScape Business, are now available for connecting TAPI-based applications in addition to the CallBridge Collection.<br>
 
<br>
 
<br>
 
The choice of the appropriate TAPI Service Provider essentially depends on the number of client PCs to be connected with TAPI applications as well as the existing IT infrastructure and the phone devices used.<br>
 
The choice of the appropriate TAPI Service Provider essentially depends on the number of client PCs to be connected with TAPI applications as well as the existing IT infrastructure and the phone devices used.<br>
 
<br>
 
<br>
* [[CallBridge Collection]]<br>
+
 
is used as a traditional first-party TAPI Service Provider on system terminals that have a LAN or USB interface. It is suitable for installations with just a few PCs. A LAN is not necessary for the operation of the CallBridge Collection. The CallBridge Collection is installed on each PC that is running a TAPI application. Analog, Cordless and system devices without USB/IP interfaces are not supported. TAPI connections via the CallBridge Collection are not licensed
+
 
<br>
 
 
* [[OpenScape Business TAPI 120]]<br>
 
* [[OpenScape Business TAPI 120]]<br>
 
is used as the preferred first-party TAPI Service Provider in Microsoft networks with or without a domain controller when analog, Cordless and system devices without IP/USB interfaces are also to be operated in conjunction with TAPI applications. The TAPI 120 Service Provider is installed on each PC client that is running a TAPI application. Connections via TAPI 120 are subject to licensing within OpenScape Business. To connect to OpenScape Business, only one CSTA link is required, regardless of how many TAPI 120 clients are being operated.
 
is used as the preferred first-party TAPI Service Provider in Microsoft networks with or without a domain controller when analog, Cordless and system devices without IP/USB interfaces are also to be operated in conjunction with TAPI applications. The TAPI 120 Service Provider is installed on each PC client that is running a TAPI application. Connections via TAPI 120 are subject to licensing within OpenScape Business. To connect to OpenScape Business, only one CSTA link is required, regardless of how many TAPI 120 clients are being operated.
Line 18: Line 169:
  
 
OpenScape Business TAPI 170 is subject to licensing within OpenScape Business. To connect to OpenScape Business, one CSTA link is required, regardless of how many TAPI 170 stations are being operated.
 
OpenScape Business TAPI 170 is subject to licensing within OpenScape Business. To connect to OpenScape Business, one CSTA link is required, regardless of how many TAPI 170 stations are being operated.
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
OpenScape Office LX/MX provides three TAPI service providers (TSP) for implementation in Microsoft TAPI based applications:
 +
 +
* [[HiPath TAPI 170 TSP]] (3rd party)
 +
* [[HiPath TAPI 120 TSP]] (1st party)
 +
* [[CallBridge Collection]] (1st party for openStage Phones)
 +
 +
TAPI 120 and 170 is connected to OpenScape Office LX/MX via LAN interface .
 +
Callbridge Collection is connected directly to OpenStage phones using USB or LAN interface.
 +
 +
Manufacturer specific implementations are described within these documents.
 +
 +
 +
{| {{DefaultTable}}
 +
! width="25%" | Documentation
 +
! width="20%" | Version / Date
 +
! width="10%" | File
 +
! width="45%" | Disclaimer
 +
|-
 +
|
 +
TAPI Application Developer´s Guide
 +
 +
HiPath TAPI 170 V2.0
 +
|
 +
V1.3 / 28.11.2007
 +
|
 +
{{File-DL|TAPI170 Developers Guide|pdf}}
 +
|
 +
You may download and use this file only if you agree to the [[About This Wiki#Disclaimer|DISCLAIMER]]. If You disagree, your are not allowed to download the file.
 +
 +
Any support regarding the TAPI implentation is only be given to registered partners within the  [http://www.unify.com/us/partners/technology-partner.aspx HiPath Technologie Partner Program]
 +
|-
 +
|
 +
CallBridge Collection
 +
 +
 +
 +
CorNet TS TAPI Service Provider
 +
 +
Supplement to the
 +
Microsoft Windows Telephony Application
 +
Programmer's Guide
 +
Version 2.0
 +
|
 +
V2.0 / November 2004
 +
|
 +
{{File-DL|CBV2_PG|zip}}
 +
|
 +
You may download and use this file only if you agree to the [[About This Wiki#Disclaimer|DISCLAIMER]]. If You disagree, your are not allowed to download the file.
 +
 +
Any support regarding the TAPI implentation is only be given to registered partners within the  [http://www.unify.com/main/Partners/Technology-Partners.aspx HiPath Technologie Partner Program]
 +
|}

Revision as of 14:56, 18 October 2013


OpenScape Business offers different types of Open Interfaces which can be used for integration of OpenScape Business features into applications and IT landscapes.

Interface descriptions of this site refer to OpenScape Buisness V1.

Physical interfaces

  • LAN Ethernet 10/100 base T
  • Upo E(OpenScape Office X3,X5 and X8)
  • S0 / S2m (OpenScape Office X3,X5 and X8)
  • a/b (OpenScape Office X3,X5 and X8))

Protocols

Web Services Interface (HTTP / HTTPS)

The realization of the HTTP(S) protocol is done by the WebServices.

The WebServices are fully integrated into HiPath OpenScape Business V1 software. No SW download and no external PC are required for use of the WebServices. Administration is done by Web Based Administration (WBM) of OpenScape Business.

Documentation Version / Date File Disclaimer

OpenScape Business V1

Web Services Interface Manual

V1.0 / dd.mm.yyyy

pdf.png  OSOV3_WSI

You may download and use this file only if you agree to the DISCLAIMER. If You disagree, your are not allowed to download the file.

Any support regarding the WebServices interface implemtation is only be given to registered partners within the [1]




CSTA protocol

CSTA protocol implementation is based on following ECMA recommendations:

  • ECMA-269 Services for Computer Supported Telecommunications Applications (CSTA) Phase III
  • ECMA-285 Protocol for Computer Supported Telecommunications Applications (CSTA) Phase III


The CSTA interface of Open Scape Office LX/MX is licensed per CSTA link.

Physically it is available on Ethernet LAN 10/100 base T interface with TCP/IP.

Default IP address is 192.168.1.2 (OpenScape Office MX only). Default port number is 8800.

OpenScape Office LX/MX specific CSTA implemtation is described within:


Documentation Version / Date File Disclaimer

OpenScape Office V3

CSTA Interface Manual

V1.0 / 04.04.2011

zip.png  OSOV3_CSTA

You may download and use this file only if you agree to the DISCLAIMER. If You disagree, your are not allowed to download the file.

Any support regarding the CSTA implemtation is only be given to registered partners within the http://www.unify.com/us/partners/technology-partner.aspx

Proprietary protocol for CDR-Transmission

OpenScape Office LX/MX collects data about outbound (incoming and outgoing) calls within an internal file.

This file can be transmitted via Ethernet LAN to external computers. To avoid inconsistencies by multiple transmission of the same file, the file should be deleted after transmission. More information about the handling, link establishing and the call data record content is given within the following document. An asynchonous transfer of single data records, as HiPath 3000 does, is not supported by OpenScape Office LX/MX.


Documentation Version / Date File Remark

OpenScape Office V3

CDR Transmission

Axxxxx-Pyyyy-Tzzz-1-18

0x/2011

pdf.png  OSOV3CDR

This document is currently only available in German language

SIP (Session Initiation Protocol)

SIP is physically available at the Ethernet LAN-Interface. Implementations is done according to the following RFC:

  • VoIP overSIP
    • RFC 2198 RTP Payload for Redundant Audio Data
    • RFC 2327 SDP Session Description Protocol
    • RFC 2617 HTTP Authentication: Basic and Digest Access Authentication
    • RFC 2782 DNS RR for specifying the location of services (DNS SRV)
    • RFC 2833 RTP Payload for DTMF Digits, Telephony Tones and Telephony Signals
    • RFC 3261 SIP Session Initiation Protocol
    • RFC 3262 Provisional Response Acknowledgement (PRACK) Early Media
    • RFC 3263 SIP Locating Servers
    • RFC 3264 An Offer/Answer Model with the Session Description Protocol
    • RFC 3310 HTTP Digest Authentication
    • RFC 3311 Session Initiation Protocol (SIP)UPDATE Method
    • RFC 3323 A Privacy Mechanism for the Session Initiation Protocol (SIP)
    • RFC 3325 Private Extensions to the Session Initiation Protocol (SIP) for Asserted Identity within Trusted Networks
    • RFC 3326 The Reason Header Field for the Session Initiation Protocol (SIP)
    • RFC 3489 STUN - Simple Traversal of User Datagram Protocol (UDP)Through Network Address Translators (NATs)
    • RFC 3515 The Session Initiation Protocol (SIP) Refer Method
    • RFC 3550 RTP: Transport Protocol for Real-Time Applications
    • RFC 3551 RTP Profile for Audio and Video Conferences with Minimal Control
    • RFC 3581 An Extension to the Session Initiation Protocol (SIP) for Symmetric Response Routing
    • RFC 3891 The Session Initiation Protocol (SIP) Replaces Header

SIP protocol is available at subscriber lines and at trunk lines. For interoperability with VoIP Providers (SIP trunking) see Collaboration with VoIP Providers.

Application Interfaces

Microsoft TAPI

Many CTI and CRM applications on the market use the Microsoft TAPI interface for connecting to the telephone system. With OpenScape Business TAPI 120 V1 and OpenScape Business TAPI 170 V1, two new and powerful TAPI Service Providers (TSP), which are optimized for the system architecture and network topology of OpenScape Business, are now available for connecting TAPI-based applications in addition to the CallBridge Collection.

The choice of the appropriate TAPI Service Provider essentially depends on the number of client PCs to be connected with TAPI applications as well as the existing IT infrastructure and the phone devices used.


is used as the preferred first-party TAPI Service Provider in Microsoft networks with or without a domain controller when analog, Cordless and system devices without IP/USB interfaces are also to be operated in conjunction with TAPI applications. The TAPI 120 Service Provider is installed on each PC client that is running a TAPI application. Connections via TAPI 120 are subject to licensing within OpenScape Business. To connect to OpenScape Business, only one CSTA link is required, regardless of how many TAPI 120 clients are being operated.

is a classic "third-party" TAPI Service Provider that is installed on a server on the LAN and connected centrally to the OpenScape Business System. TAPI 170 can be used as an alternative to TAPI 120 if there is a domain controller in the Microsoft network. When using the so-called remote TAPI function, it is not necessary to install the TAPI Service Provider on the client PCs. This offers significant time savings in installations with many client PCs.
Please note, however, that the use of OpenScape Business TAPI 170 is mandatory in the following constellations:

  • Connection of TAPI stations in networked OpenScape Business systems when the TAPI stations are located in different nodes.
  • Connection to TAPI applications running on a terminal server
  • Connection to server-based TAPI applications

OpenScape Business TAPI 170 is subject to licensing within OpenScape Business. To connect to OpenScape Business, one CSTA link is required, regardless of how many TAPI 170 stations are being operated.





OpenScape Office LX/MX provides three TAPI service providers (TSP) for implementation in Microsoft TAPI based applications:

TAPI 120 and 170 is connected to OpenScape Office LX/MX via LAN interface . Callbridge Collection is connected directly to OpenStage phones using USB or LAN interface.

Manufacturer specific implementations are described within these documents.


Documentation Version / Date File Disclaimer

TAPI Application Developer´s Guide

HiPath TAPI 170 V2.0

V1.3 / 28.11.2007

pdf.png  TAPI170 Developers Guide

You may download and use this file only if you agree to the DISCLAIMER. If You disagree, your are not allowed to download the file.

Any support regarding the TAPI implentation is only be given to registered partners within the HiPath Technologie Partner Program

CallBridge Collection


CorNet TS TAPI Service Provider

Supplement to the Microsoft Windows Telephony Application Programmer's Guide Version 2.0

V2.0 / November 2004

zip.png  CBV2_PG

You may download and use this file only if you agree to the DISCLAIMER. If You disagree, your are not allowed to download the file.

Any support regarding the TAPI implentation is only be given to registered partners within the HiPath Technologie Partner Program