OpenScape Contact Center Extensions V3R0 Integration Connector. Programmieranleitung A31003-S2230-R

Transkript

1 OpenScape Contact Center Extensions V3R0 Integration Connector Programmieranleitung

2 Our Quality and Environmental Management Systems are implemented according to the requirements of the ISO9001 and ISO14001 standards and are certified by an external certification company. Copyright Unify GmbH & Co. KG 2014 Hofmannstr. 51, Munich/Germany All rights reserved. Reference No.: The information provided in this document contains merely general descriptions or characteristics of performance which in case of actual use do not always apply as described or which may change as a result of further development of the products. An obligation to provide the respective characteristics shall only exist if expressly agreed in the terms of contract. Availability and technical specifications are subject to change without notice. Unify, OpenScape, OpenStage and HiPath are registered trademarks of Unify GmbH & Co. KG. All other company, brand, product and service names are trademarks or registered trademarks of their respective holders. unify.com

3 Inhalt Inhalt 1 Über dieses Handbuch Wichtige Produkt Info Inhaltsüberblick Schreibweise CTI Grundlagen Systemarchitektur Anwendungsentwicklung Registrierung der Schnittstellen-Bibliothek Anwendungsbeispiele Synchrone und asynchrone ausführung Fehlerbehandlung Statusänderungen bei Nebenstellen und Agenten Aufzählungstypen CTI (Enum) Klasse CocCtiConnector AvailableLicences ConfigData ServerConnectionMode ServerConnectionState AcdAvailable AcdCheckPassword AcdExitPostProcessingState AcdGetBusinessUnitForExtension AcdGetBusinessUnitForUserId AcdGetBusinessUnits AcdGetCallInformation AcdGetPostProcessingReasons AcdGetPostProcessingState AcdGetQueues AcdGetTeams AcdGetUnavailableReasons AcdGetUserIdForUserName AcdGetUsers AcdGetUserState AcdGetWorkReasons AcdGetWrapupReasons AcdLogoff AcdLogon AcdRegisterForFunctions AcdRegisterForGlobalEvents AcdRegisterForNodeEvents AcdSaveWrapupData AcdSetPostProcessingState...30 OpenScape Contact Center Extensions V3R0, Integration Connector, Programmieranleitung 3

4 Inhalt AcdSetPrimaryContact AcdUnavailable AcdUnregisterForFunctions AcdUnregisterForGlobalEvents AcdUnregisterForNodeEvents AcdWork AgentAvailable AgentLogoff AgentLogon AgentUnavailable AgentWork AlternateCall AnswerCall CheckMonitoringDevice ClearConnection Close ConferenceCall ConsultCall CreateCallback DeflectCall DeleteCallback DialDigits GetAgentState GetAgentStateOsvHuntgroup GetDoNotDisturb GetErrorAsString GetExtensionCallList GetForwarding GetPhoneState HoldCall IsExtensionOutOfService MakeCall Open ReconnectCall RetrieveCall SendDTMF SetAgentStateOsvHuntgroup SetForwarding SingleStepTransferCall SnapshotDevice SnapshotDeviceAdvanced StartMonitorDevice StopMonitorDevice TransferCall Ereignisse OnAcdAgentStateChangeInfoEvent (nur mit OSCC) OnAcdAvailableEvent OnAcdCallbackDeliveredInfoEvent OnAcdCheckPasswordEvent OnAcdContactStateChangeInfoEvent OpenScape Contact Center Extensions V3R0, Integration Connector, Programmieranleitung

5 Inhalt OnAcdContactStateInfoEvent OnAcdExitPostProcessingStateEvent OnAcdGetBusinessUnitForExtensionEvent OnAcdGetBusinessUnitForUserIdEvent OnAcdGetBusinessUnitsEvent OnAcdGetCallInformationEvent OnAcdGetPostProcessingReasonsEvent OnAcdGetPostProcessingStateEvent OnAcdGetQueuesEvent OnAcdGetTeamsEvent OnAcdGetUnavailableReasonsEvent OnAcdGetUserIdForUserNameEvent OnAcdGetUsersEvent OnAcdGetUserStateEvent OnAcdGetWorkReasonsEvent OnAcdGetWrapupReasonsEvent OnAcdLogoffEvent OnAcdLogonEvent OnAcdRegisterForFunctionsEvent OnAcdRegisterForGlobalEventsEvent OnAcdRegisterForNodeEventsEvent OnAcdSaveWrapupDataEvent OnAcdSetPostProcessingStateEvent OnAcdSetPrimaryContactEvent OnAcdUnavailableEvent OnAcdUnregisterForFunctionsEvent OnAcdUnregisterForGlobalEventsEvent OnAcdUnregisterForNodeEventsEvent OnAcdUserStateChangeInfoEvent OnAcdVoiceRingingInfoEvent OnAcdWorkEvent OnAgentAvailableEvent OnAgentLogoffEvent OnAgentLogonEvent OnAgentStateChangeInfoEvent OnAgentUnavailableEvent OnAgentWorkEvent OnAlternateCallEvent OnAnswerCallEvent OnCallbackInfoEvent OnCallDisconnectOnHeldInfoEvent OnCallEstablishedInfoEvent OnCallPickupInfoEvent OnCheckMonitoringDeviceEvent OnClearConnectionEvent OnConferenceCallEvent OnConferenceInfoEvent OnConfiguredSiteListInfoEvent OnConsultCallEvent OnCreateCallbackEvent OnDeflectCallEvent OnDeleteCallbackEvent...56 OpenScape Contact Center Extensions V3R0, Integration Connector, Programmieranleitung 5

6 Inhalt OnDialDigitsEvent OnErrorEvent OnFailoverInfoEvent OnGetAgentStateEvent OnGetAgentStateOsvHuntgroupEvent OnGetDoNotDisturbEvent OnGetForwardingEvent OnHoldCallEvent OnLoggingEvent OnMakeCallEvent OnPhoneCallStateChangeInfoEvent OnPhoneClearedInfoEvent OnPhoneDialingInfoEvent OnPhoneRingingInfoEvent OnPhoneStateBusyInfoEvent OnPhoneStateChangeInfoEvent OnReconnectCallEvent OnRetrieveCallEvent OnSendDTMFEvent OnServerConnectionStateChangeEvent OnSetAgentStateOsvHuntgroupEvent OnSetForwardingEvent OnSingleStepTransferCallEvent OnSiteStateInfoEvent OnSnapshotDeviceAdvancedEvent OnSnapshotDeviceEvent OnStartMonitorDeviceEvent OnStopMonitorDeviceEvent OnTransferCallEvent OnTransferCompletedInfoEvent OnTransferedInfoEvent Sonstige Klassen AcdContactDataListParamX AcdFunctionTypeListParamX AcdWrapupReasonKeyDataListParamX IAcdAgentStateChangeInfoDataX IAcdAvailableDataX IAcdBusinessUnitsDataX IAcdBusinessUnitsListX IAcdCallbackCallDataX IAcdCallbackDeliveredInfoDataX IAcdCallbackSchedulesDataX IAcdCallbackSchedulesDataListX IAcdCheckPasswordDataX IAcdContactDataListX OpenScape Contact Center Extensions V3R0, Integration Connector, Programmieranleitung

7 Inhalt IAcdContactDataX IAcdContactStateAdvancedDataListX IAcdContactStateAdvancedDataX IAcdContactStateChangeInfoDataX IAcdContactStateDataListX IAcdContactStateDataX IAcdContactStateInfoDataX IAcdExitPostProcessingStateDataX IAcdFunctionTypeDataX IAcdFunctionTypeListX IAcdGetBusinessUnitForExtensionDataX IAcdGetBusinessUnitForUserIdDataX IAcdGetBusinessUnitsDataX IAcdGetCallInformationDataX IAcdGetPostProcessingReasonsDataX IAcdGetPostProcessingStateDataX IAcdGetQueuesDataX IAcdGetTeamsDataX IAcdGetUnavailableReasonsDataX IAcdGetUserIdForUserNameDataX IAcdGetUsersDataX IAcdGetUserStateDataX IAcdGetWorkReasonsDataX IAcdGetWrapupReasonsDataX IAcdLogoffDataX IAcdLogonDataX IAcdMediaTypeDataX IAcdMediaTypeListX IAcdPostProcessingReasonsDataX IAcdPostProcessingReasonsListX IAcdPostProcessingServPermFlagsX IAcdQueueDataListX IAcdQueueDataX IAcdRegisterForFunctionsDataX IAcdRegisterForGlobalEventsDataX IAcdRegisterForNodeEventsDataX IAcdSaveWrapupDataX IAcdSetPostProcessingStateDataX IAcdSetPrimaryContactDataX IAcdTeamDataListX IAcdTeamDataX IAcdUnavailableDataX IAcdUnavailableReasonDataListX...90 OpenScape Contact Center Extensions V3R0, Integration Connector, Programmieranleitung 7

8 Inhalt IAcdUnavailableReasonDataX IAcdUnregisterForFunctionsDataX IAcdUnregisterForGlobalEventsDataX IAcdUnregisterForNodeEventsDataX IAcdUserConfigDataX IAcdUserDataX IAcdUserDataListX IAcdUserStateChangeInfoDataX IAcdVoiceRingingInfoDataX IAcdWorkDataX IAcdWorkReasonDataListX IAcdWorkReasonDataX IAcdWrapupReasonDataX IAcdWrapupReasonKeyDataListX IAcdWrapupReasonKeyDataX IAcdWrapupReasonDataListX IAgentAvailableDataX IAgentLogoffDataX IAgentLogonDataX IAgentStateChangeInfoDataX IAgentUnavailableDataX IAgentWorkDataX IAlternateCallDataX IAnswerCallDataX ICallbackInfoDataX ICallDisconnectOnHeldInfoDataX ICallEstablishedInfoDataX ICallPickupInfoDataX ICheckMonitoringDeviceDataX IClearConnectionDataX ICommonConfigDataX IConferenceCallDataX IConferenceInfoDataX IConfigDataX IConnectBalancingConfigDataX IConnectionDataX IConnectionListX IConsultCallDataX ICreateCallbackDataX ICstaErrorX ICtiConnectivityConfigDataX OpenScape Contact Center Extensions V3R0, Integration Connector, Programmieranleitung

9 Inhalt IDeflectCallDataX IDeleteCallbackDataX IDialDigitsDataX IExtensionCallDataX IExtensionCallListX IFailoverInfoDataX IGetAgentStateDataX IGetAgentStateOsvHuntgroupDataX IGetDoNotDisturbDataX IGetExtensionCallListDataX IGetForwardingDataX IGetPhoneStateDataX IHoldCallDataX ILoggingConfigDataX IMakeCallDataX IOldCallIdListX IPartyDataX IPartyListX IPhoneCallStateChangeInfoDataX IPhoneClearedInfoDataX IPhoneDialingInfoDataX IPhoneRingingInfoDataX IPhoneStateBusyInfoDataX IPhoneStateChangeInfoDataX IReconnectCallDataX IRetrieveCallDataX ISendDTMFDataX IServerConnectionStateChangeDataX IServPermFlagsX ISetAgentStateOsvHuntgroupDataX ISetForwardingDataX ISingleStepTransferCallDataX ISiteIdDataX ISiteIdListX ISiteStateInfoDataX ISnapshotAdvCallListX ISnapshotAdvCallX ISnapshotDeviceAdvancedDataX ISnapshotDeviceDataX IStartMonitorDeviceDataX IStopMonitorDeviceDataX ITransferCallDataX ITransferCompletedInfoDataX OpenScape Contact Center Extensions V3R0, Integration Connector, Programmieranleitung 9

10 Inhalt ITransferedInfoDataX IUserAgentServPermFlagsX Realtime Grundlagen Systemarchitektur Anwendungsbeispiel COM DLL Registrierung der Schnittstellen-Bibliothek Aufbau einer Verbindung zum Connectivity Server Empfangen der Daten Agenten Anwendungsentwicklung Java API Einbinden der Java API Aufbau einer Verbindung zum Connectivity Server Empfangen der Daten Aufzählungstypen Realtime (Enum) EnumAgentColumnType EnumAgentState (nur OSCC V7) EnumCallType EnumDataType EnumErrorCode EnumGroupColumnType EnumLoggedOnMedia EnumMediaType EnumNodeType EnumQueueColumnType EnumServerErrorType EnumServerState EnumUserHandlingState (nur OSCC V8) EnumUserPresenceState (nur OSCC V8) EnumUserRoutingState (nur OSCC V8) EnumValid Klassen IRealtimeLink Ereignisse IAcdContact IAcdContactList IAcdStep IAcdStepList IAgentColumnConfig OpenScape Contact Center Extensions V3R0, Integration Connector, Programmieranleitung

11 Inhalt IAgentColumnConfigList IAgentConfig IAgentObject IAgentObjectList IAgentsData IColumnConfig IConfiguredViewsEvent IGroupColumnConfig IGroupColumnConfigList IGroupConfig IGroupObject IGroupObjectList IGroupsData ILogoffResponse ILogonResponse IQueueColumnConfig IQueueColumnConfigList IQueueConfig IQueueObject IQueueObjectsList IQueuesData IQueueVirtualAgentObject IQueueVirtualAgentObjectsList ITeamConfig ITeamEntry ITeamList IServerErrorEvent IVirtualAgentObject IVirtualAgentObjectsList IVirtualAgentsData OpenScape Contact Center Extensions V3R0, Integration Connector, Programmieranleitung 11

12 Über dieses Handbuch Wichtige Produkt Info 1 Über dieses Handbuch 1.1 Wichtige Produkt Info Diese Dokumentation beschreibt die Schnittstellen-Bibliothek des Integration Connectors. Die CTI Schnittstellen-Bibliothek ermöglicht die Realisierung von Anwendungsprogrammen mit Telefonie- und Agentensteuerungsfunktionen auf Basis des Integration Connectors. Mit Hilfe der Realtime Schnittstellen-Bibliothek können Realtime-Frontend- Applikationen erstellt werden. Diese Dokumentation ist für Software-Entwickler und Projektverantwortliche gedacht. Dieses Handbuch gilt für OSCC-E sowie für Solution Kit. Es beinhaltet die komplette Palette der Schnittstellen-Bibliothek. Folgende Features sind nicht Bestandteil des OSCC-E: CallCoding Journal über Journal Server. Sprachaufzeichnung über ASC Node. 1.2 Inhaltsüberblick Abschnitt 2.1 umreißt die Grundlagen, die für die Anwendungsentwicklung mit der CTI- Schnittstellen-Bibliothek des OSCC-E Servers benötigt werden. An ausgewählten Stellen werden im Folgenden Beispiele in VisualBasic angeführt. Abschnitt 2.2 erläutert die Aufzählungstypen (Enumerationen) der CTI-Bibliothek. Abschnitt 2.3 beschreibt die Klasse CocCtiConnector detailliert nach Eigenschaftsprozeduren, und Ereignissen. Abschnitt 2.4 beschreibt sonstigen Klassen der CTI-Bibliothek. Abschnitt 2.5 beschreibt die der CTI-Bibliothek. Abschnitt 3.1 umreißt die Grundlagen, die für die Anwendungsentwicklung mit der Realtime Schnittstellen-Bibliothek des OSCC-E Servers benötigt werden. In den folgenden Unterkapiteln befinden sich Anwendungsbeispiele in den Sprachen C# und Java. Abschnitt 3.2 Erläutert die Aufzählungstypen (Enumerationen) der Realtime Bibliothek. 12 OpenScape Contact Center Extensions V3R0, Integration Connector, Programmieranleitung

13 Über dieses Handbuch Schreibweise Abschnitt 3.3 Beschreibt die Klasse RealtimeLink detailliert nach Eigenschaftsprozeduren, und Ereignissen. Abschnitt 3.4 Beschreibt die der Realtime Bibliothek. 1.3 Schreibweise Courier wird für und Konstanten verwendet. Courier fett wird für - und Ereignisnamen sowie allgemein für Quellcode-Beispiele und Nutzereingaben verwendet. Courier kursiv wird bei - und Ereignisbeschreibungen für Typbezeichner verwendet. Bei den Detailbeschreibungen von werden arten wie folgt unterschieden: Wertparameter ohne besondere Kennzeichnung (z.b. CallID), Rückgabeparameter durch Unterstreichung (z.b. New_CallID), optionale durch den tiefgestellten Zusatz opt (z.b. Sync opt ), der Standardwert wird in der beschreibung in eckigen Klammern aufgeführt. OpenScape Contact Center Extensions V3R0, Integration Connector, Programmieranleitung 13

14 Grundlagen 2 CTI 2.1 Grundlagen Wichtiger HINWEIS vorab: Mehrfachinstanzierung der Dll wird nicht überstützt Systemarchitektur Der OSCC-E Server verwaltet eine oder mehrere Telephonieanlagen und stellt Funktionen für die Steuerung von Nebenstellen und Agenten bereit. Die Nutzung dieser Funktionen in Anwendungsprogrammen ist über die Schnittstellen-Bibliothek möglich. Die Schnittstellen-Bibliothek ist eine COM DLL, die die CTI- und Agentensteuerungsfunktionen des OSCC-E Servers zur Verfügung stellt. Die Schnittstellen-Bibliothek kann daher in jeder Programmiersprache verwendet werden, für die eine COM-Implementierung existiert, also z.b. Visual Basic, Visual C# oder Delphi. Wie die folgende Abbildung beispielhaft zeigt, sind der OSCC-E Server und die Schnittstellen-Bibliothek Komponenten einer dreischichtigen CTI- Systemarchitektur, die auf der Switch-Ebene verschiedene Telephonieanlagen und Call-Center / Contact Center umfassen kann und auf der Interface-Ebene die Komponenten des OSCC-E Servers enthält, der dann auf der Applikations-Ebene über die Schnittstellen-Bibliothek angesprochen wird. 14 OpenScape Contact Center Extensions V3R0, Integration Connector, Programmieranleitung

15 Grundlagen Anwendungsentwicklung Wie die Abbildung zeigt, kommuniziert der OSCC-E Server mit jeder Telephonieanlage über einen sog. Knoten (Node). Ein Knoten ist einer Telefonanlage eindeutig zugeordnet und wird über einen Knotennamen identifiziert. Dieser Knoten kommuniziert mit dieser Anlage über das CSTA- Protokoll. Ist die Telephonieanlage zusätzlich mit einem Call-Center / Contact Center verbunden was in der Regel der Fall ist werden die Steuerungsfunktionen ebenfalls über den Knoten realisiert, und zwar über die Call-Center-spezifischen SDK-Funktionen. Eventuelle Versionsanpassungen im Contact Center und dem dazugehörigen SDK ziehen somit keine Anpassungen in der Client-Applikation mehr nach sich. In einer Client-Applikation ist jedes Verbindungsobjekt ein Objekt der unten beschriebenen Klasse CustPABXCtiLink der Schnittstellen- Bibliothek genau einem Knoten zugeordnet. Die Schnittstellen-Bibliothek kommuniziert über Nachrichten mit dem OSCC- E Server via TCP/IP. Es muss daher von den Client-Rechnern eine Socket- Verbindung über einen definierten Port zum OSCC-E Server möglich sein. WICHTIGER HINWEIS: Die Schnittstellen-Bibliothek bietet einen CTI-Funktionsumfang, der dem des OpenScape Contact Center Desktop vergleichbar ist und in eigenen Entwicklungsprojekten genutzt werden kann. Die CTI-Funktionen und -Events der Schnittstellen-Bibliothek basieren auf Funktionen und Meldungen der CSTA-Schnittstelle der Telefonanlage. Die Signalisierung und der Leistungsumfang dieser Schnittstelle unterscheiden sich vom Leistungsumfang der HFA-Endgeräte (HiPath Feature Access), u.a. in passiv-gehaltenen Gesprächssituationen sowie in Konferenz- und Transfersituationen. Es ist daher möglich, dass die über die Schnittstellen-Bibliothek angebotenen Funktionen und Information situativ von den an einem Endgerät angebotenen abweichen können Registrierung der Schnittstellen-Bibliothek Anwendungsbeispiele Vor Verwendung der Schnittstellen-Bibliothek muss diese im Betriebssystem registriert werden. Dies kann über die Entwicklungsumgebung oder direkt unter Windows mit z.b. folgendem Kommando geschehen: regsvr32.exe coccustcticonlib.dll Die nachfolgend gegebenen Beispiele sind in C# geschrieben. In anderen, COM-kompatiblen Programmiersprachen ist die Verwendung vergleichbar. Deklarieren eines Verbindungsobjekts using coccustcticonlib; private CocCtiConnector cticonnector; Instantiierung des Verbindungsobjekts Vor der Verwendung muss das Verbindungsobjekt instanziiert werden. OpenScape Contact Center Extensions V3R0, Integration Connector, Programmieranleitung 15

16 Grundlagen cticonnector = new CocCtiConnector();Aufbau einer Verbindung zum OSCC-E Server Zuerst muss nach Instantiierung die Verbindung zum OSCC-E Server aufgebaut werden. Dafür sind minimal die aufgeführten Verbindungsparameter anzugeben (Werte hier nur beispielhaft). this.cticonnector.configdata.cticonnectivityconfigd ata.ipaddress = ; this.cticonnector.configdata.cticonnectivityconfigd ata.port = 17010; this.cticonnector.configdata.cticonnectivityconfigd ata.siteid = LOC001 ; this.cticonnector.configdata.cticonnectivityconfigd ata.extension = 1234 ; cticonnector.configdata.cticonnectivityconfigdata.c onnectandmonitor = true; ErrorEnum result = this.cticonnector.open(false); if (result == ErrorEnum.glbOK) { } cticonnector.configdata.cticonnectivityconfigd ata.autoreconnect = true; Innerhalb einer Anwendung kann nur ein Verbindungsobjekt instanziiert werden. Wenn die Verbindung erfolgreich aufgebaut werden konnte, liefert die Funktion Open den Wert glbok zurück. Im anderen Fall ist ein Fehler aufgetreten, dessen Beschreibung mit der Funktion GetErrorAsString abgerufen werden kann (siehe unten). Beenden der Verbindung Beim Programmende sollte die Verbindung zum OSCC-E Server beendet und der Verweis auf das Objekt freigegeben werden. cticonnector.close(); cticonnector = null; Synchrone und asynchrone ausführung Steuerungsfunktionen für Nebenstellen und Agenten senden intern Nachrichten an den OSCC-E Server und werten deren Antworten aus. Daher können diese Steuerungsfunktionen entweder synchron oder asynchron ausgeführt werden. Bei der synchronen Ausführung wird die Beendigung der Methode solange verzögert, bis die entsprechenden Antworten des OSCC-E Servers eingetroffen sind und alle Resultate vorliegen. Beim ende sind den Rückgabeparametern Werte zugewiesen und das ergebnis (Fehler oder kein Fehler) wird auf Basis der Server-Antworten bestimmt 16 OpenScape Contact Center Extensions V3R0, Integration Connector, Programmieranleitung

17 Grundlagen Bei der asynchronen Ausführung wird die Methode nach dem Senden der Nachrichten an den OSCC-E Server beendet, ohne dessen Antworten abzuwarten. Beim ende sind den Rückgabeparametern keine Werte zugewiesen, daher können beim Aufruf der Methode diesen n auch literale Werte übergeben werden. Das ergebnis hat den Wert glbok (kein Fehler, falls die prüfung unmittelbar nach aufruf keine Fehler festgestellt hat). Das zur ausführung gehörige Ereignis liefert dann das ergebnis und die Werte der Rückgabeparameter (z.b. zur Methode MakeCall das Ereignis OnMakeCallEvent). Der Modus der ausführung wird über einen gesteuert. Synchrone Ausführung ist sinnvoll bei einfachen Anwendungen, wenn mit dem ergebnis unmittelbar Rückmeldungen oder Änderungen an der Bedienoberfläche der Anwendung verbunden sind (z.b. Änderung eines Schaltflächenzustandes) oder mehrere aufrufe in Abhängigkeit der einzelnen Ergebnisse aufeinander folgen müssen. HINWEIS: Bei komplexen Anwendungen mit hoher Ereignisrate oder Verbindungsparallelität ist die asynchrone ausführung bevorzugt zu verwenden. Die optionalen der Funktionen sind in VB.NET verwendbar, jedoch nicht in C#. Der Standardwert für den optionalen Sync ist false, d.h. die Methode wird standardmäßig asynchron ausgeführt. Das Aufrufen von Kommandos und das Behandeln von Ereignissen muss in dem Thread der Anwendung erfolgen, in dem das Verbindungsobjekt erzeugt worden ist Fehlerbehandlung Fehler bei aufrufen werden auf zwei Arten gemeldet: oder durch das Ergebnis einer Methode bei synchronem Aufruf (im Fehlerfall ungleich glbok), durch die Ergebnisdaten eines Ereignisses bei asynchronem Aufruf. Sonstige Fehler werden gemeldet durch OnErrorEvent. Zu jedem Fehlercode kann mit der Methode GetErrorAsString eine textuelle Beschreibung für die Anzeige oder Logdateiausgabe geholt werden. Zeigt der Fehlercode einen CSTA-Fehler an, dann liefert die Property CstaError eine Beschreibung des Fehlers nach Fehlerklasse und Fehlerwert. Neben Fehlercodes, die von verschiedenen zurückgegeben werden können, gibt es spezifische Fehlercodes, die bei den beschreibungen unten im Einzelnen aufgeführt werden Statusänderungen bei Nebenstellen und Agenten Die Zustände von Nebenstellen und Agenten können sich sowohl aufgrund von Aktionen des Anwendungsprogramms als auch durch externe Ereignisse ändern. (z.b. durch einen ankommenden Anruf). OpenScape Contact Center Extensions V3R0, Integration Connector, Programmieranleitung 17

18 Grundlagen Änderungen am Zustand einer Nebenstelle meldet das Ereignis OnPhoneStateChangeInfoEvent, Änderungen beim Agentenzustand das Ereignis OnAcdUserStateChangeInfoEvent. Nach dem erfolgreichen Aufruf eines CTI-Kommandos sollte die Anwendung keine weiteren CTI-Befehle erlauben, bis im nachfolgenden OnPhoneStateChangeInfoEvent die aktuell gültigen Kommando mitgeteilt werden. 18 OpenScape Contact Center Extensions V3R0, Integration Connector, Programmieranleitung

19 Aufzählungstypen CTI (Enum) 2.2 Aufzählungstypen CTI (Enum) Aufzählungstyp AcdCallbackSchedulesStateEnum AcdCallbackStateEnum AcdContactTypeEnum AcdDequeueReasonEnum AcdFunctionTypeEnum AcdHandlingStateEnum AcdMediaTypeEnum AcdPartyTypeEnum AgentStateOsvHuntgroupEnum ApplicationIdentifierEnum AutoAnswerFlagEnum BusyStateDetailEnum BusyStateEnum CallDirectionEnum CallListChangeNotificationEnum CallStateEnum ConferenceEventTypeEnum CstaVersionEnum DeviceTypeEnum DoNotDisturbFlagEnum ErrorEnum EventCauseEnum EventTypeEnum ForwardingStateEnum IPVersionEnum Beschreibung beschreibt den Status des Zeitplanes. beschreibt den Status der Callbacks. beschreibt den Medientyp und die Zustellungsart eines Kontakts im Call-Center. für zukünftige Funktionen. beschreibt die speziellen ACD-Funktionen. beschreibt den Bearbeitungszustand eines Kontakts im Call- Center. beschreibt den Medientyp eines Kontakts. beschreibt den Typ des Teilnehmers, dem ein ACD-Anruf aktuell zugeordnet ist. beschreibt den Verfügbarkeitszustand eines Agenten an einem Sammelanschluss. beschreibt den Typ der Applikation in Bezug auf die Verwendung der Schnittstellen-Bibliothek. beschreibt die Fähigkeit eines analogen oder digitalen Endgeräts, bei aufgelegtem Hörer zu wählen. beschreibt Details zum Belegt-Zustand einer Nebenstelle. beschreibt den Belegt-Zustand einer Nebenstelle. beschreibt die Richtungszustände eines Anrufes. beschreibt eine Änderung an einem mit einer Nebenstelle verbundenen Anruf. beschreibt die Zustände eines Anrufes. beschreibt die Änderung am Zustand einer Konferenz. beschreibt die Version der zugrunde liegenden CSTA. beschreibt einen Gerätetyp. beschreibt den Anrufschutzzustand einer Nebenstelle. beschreibt Fehlercodes (glbok bedeutet kein Fehler ). beschreibt den Ereignisgrund für ein CSTA-Kommando. für zukünftige Funktionen. für zukünftige Funktionen. beschreibt die verwendete IP-Protokollversion. OpenScape Contact Center Extensions V3R0, Integration Connector, Programmieranleitung 19

20 Aufzählungstypen CTI (Enum) Aufzählungstyp LocalConnectionStateEnum LogLevelEnum LogMessageDelimiterEnum MonitorDeviceHandlingFlagEnum MonitorStateEnum NodeTypeEnum ServerConnectionModeEnum ServerConnectionStateEnum ServerTypeEnum SetForwardingActionEnum SiteStateEnum SiteTypeEnum UserAgentStateEnum Beschreibung beschreibt den aktuellen Zustand einer Verbindung. beschreibt den Level einer Protokollnachricht. gibt das Trennzeichen für Einzelwerte in Protokollnachrichten an. beschreibt den Typ der Monitorbehandlung. beschreibt den Monitorzustand. beschreibt den Typ eines Knotens (Telephoniesystem, ACD usw.). beschreibt den Verbindungsmodus. beschreibt den Verbindungszustand zum OSCC-E Server. beschreibt den Typ des OSCC-E Server. beschreibt den Zustand der Rufumleitung. beschreibt den Zustand eines Knotens. beschreibt den Typ eines Knotens. beschreibt den Routing-Zustand, in dem sich ein Agent befinden kann. 20 OpenScape Contact Center Extensions V3R0, Integration Connector, Programmieranleitung

21 Klasse CocCtiConnector 2.3 Klasse CocCtiConnector AvailableLicences Ein Objekt der Klasse CocCtiConnector stellt eine Verbindung zum OSCC- E Server über eine Nebenstelle und für einen daran angemeldeten Agenten dar. Diese Eigenschaft enthält die Anzahl der für den Applikationstyp freien Lizenzen zum Verbindungszeitpunkt. AvailableLicences Integer ConfigData Diese Eigenschaft enthält sämtliche Konfigurations- und Einstellungsdaten. ConfigData IConfigDataX ServerConnectionMode Diese Eigenschaft enthält den Server-Verbindungsmodus. ServerConnectionMode ServerConnectionModeEnum ServerConnectionState Diese Eigenschaft enthält den Server-Verbindungszustand AcdAvailable AcdAvailable ServerConnectionState ServerConnectionStateEnum Diese Methode setzt den Agenten für einen Medientyp in den Zustand verfügbar. LocationId String Knotenname UserId String Nutzer-ID UserData String Nutzerzusatzdaten MediaType AcdMediaTypeEnum Medientyp Sync opt Boolean Ausführung synchron [false] OpenScape Contact Center Extensions V3R0, Integration Connector, Programmieranleitung 21