Seitenhistorie

Die Klingelstrategie "iQueue" (siehe auch "043 - iQueue auf der STARFACE konfigurieren" und "Auswertung für die iQueue konfigurieren") bietet für externe Anwendungen einen Zugriff auf die Live-Daten, wie auch auf History-Daten. Für die beiden Schnittstellen wird die XML-RPC Technologie genutzt. Die Live-Daten einer iQueue werden über die XML-RPC-Funktion "Queue.getLiveData" aufgerufen, welche einen Eingabeparameter erwartetLa stratégie de sonnerie « iQueue » (voir aussi « Configurer l’iQueue sur STARFACE » und « Configurer l’analyse pour l’iQueue ») permet aux applications externes d'accéder à des données en direct et à des données historiques. La technologie XML-RPC est utilisée pour les deux interfaces. Les données en direct d'une iQueue sont appelées à l'aide de la fonction XML-RPC « Queue.getLiveData », qui attend un paramètre d'entrée :

<name>queueName</name> <string>…</string>

Diese Funktion liefert folgende RückgabewerteCette fonction renvoie les valeurs suivantes :

callersLiveData (LIST) - Dieser Rückgabewert ist eine Liste, die wiederum Maps als Elemente enthält. Jede Map enthält Informationen (Schlüssel -> Wert) über genau einen Anrufer, der sich zu dieser Zeit in der Warteschlange befindet. Die Liste ist nach der Position des Anrufers in der Queue sortiert. Jede Map enthält die folgenden Schlüssel:Cette valeur de retour est une liste, qui à son tour contient des maps comme éléments. Chaque mappe contient des informations (clé -> valeur) sur exactement un appelant qui se trouve dans la queue à ce moment-là. La liste est triée en fonction de la position de l'appelant dans la queue. Chaque mappe contient les clés suivantes :

agentsLiveData (MAP) - Dieser Rückgabeparameter ist eine Map, die wiederum Maps als Elemente enthält. Schlüssel der Map ist die Login-ID des Agenten. Jede Element-Map enthält Informationen (Schlüssel -> Wert) über einen Agenten:Ce paramètre de retour est une map, qui à son tour contient des mappes comme éléments. La clé de la map est le ID de connexion de l'agent. Chaque map d'éléments contient des informations (clé -> valeur) sur un agent :

History Schnittstelle

Die historischen Daten einer iQueue werden über die XML-RPC-Funktion "Queue.getHistoryData" aufgerufen. Der Eingabeparameter hierfür ist ein "struct" mit drei Wertangaben:

Interface d'historique

Les données historiques d'une iQueue sont appelées à l'aide de la fonction XML-RPC « Queue.getHistoryData ». Le paramètre d'entrée pour cela est une « struct » avec trois spécifications de valeur :

Diese Funktion hat einen RückgabewertCette fonction a une valeur de retour :

queueHistoryData (LIST) - Die Elemente der Liste sind Maps und jede Map enthält Informationen über genau einen Anruf. Die Liste ist nach dem Timestamp der Anrufe sortiert. Jedes Element der Liste enthält die folgenden Schlüssel:Les éléments de la liste sont des mappes et chaque map contient des informations sur un appel précis. La liste est triée en fonction de l'horodatage des appels. Chaque élément de la liste contient les clés suivantes :

Beispiel

Exemple

Par la méthode post Per Post Methode :

http://IP-ADRESSE/xml-rpc?de.vertico.starface.auth=$LoginID:SHA512($LoginID*SHA512($Passwort))

Das Passwort wird im ersten Schritt mit SHA512 gehasht. Danach wird dieser Hash nochmals mit der LoginID als Präfix und dem Trennzeichen * erneut gehasht. Für einen Benutzer mit den folgenden EckdatenLe mot de passe est d'abord haché avec SHA512. Ensuite, ce hachage est à nouveau haché avec le LoginID comme préfixe et le séparateur *. Pour un utilisateur ayant les données clés suivantes :

LoginID = 0001
Passwort Mot de passe = starface
IP-Adresse der Starface Adresse IP du Starface = 192.168.0.100

ergibt sich als Aufruf-URL für résulte en une URL d'appel pour XML-RPC :

http://192.168.0.100/xml-rpc?de.vertico.starface.auth=0001:5273503e607e5b24eeb48a3f71c53eb50df6b6622839ecd7149e248893f627d05d8d4af88cf36b3d7d5cd5d1d559dfa1c10404067d8c0f37a138c6546dad7ef7Der Body würde dann z.B. so aussehen

Le corps ressemblerait alors à ceci, par exemple :

<?xml version="1.0" encoding="UTF-8"?>
<methodCall>
   <methodName>Queue.getHistoryData</methodName>
   <params>
      <param>
         <value>
            <struct>
               <member>
                  <name>queueName</name>
                  <value>
                     <string>testIq</string>
                  </value>
               </member>
               <member>
                  <name>from</name>
                  <value>
                     <dateTime.iso8601>20150701T12:59:05</dateTime.iso8601>
                  </value>
               </member>
               <member>
                  <name>to</name>
                  <value>
                     <dateTime.iso8601>20160701T12:59:05</dateTime.iso8601>
                  </value>
               </member>
            </struct>
         </value>
      </param>
   </params>
</methodCall>

...