Warning:
To be able to use the following code, you need to have valid Genesys license for related libraries. What you will find below is given here for experimental purposes.
Introduction
As you know, retrieving real-time data from StatServer requires an additional product. Well, if you want to implement a stand-alone service that queries StatServer for current-, average-, total-, or stat-related data, then you need to use Stat Server Java libraries.
Plus, please keep in your mind that I am not here to reveal Genesys secrets. These libraries are open. What you need is to have a related Genesys license for development.
This entry focuses on how to query StatServer using related Java libraries. Here, what you have found are some code snippets.
Libraries
There exist two main Genesys libraries:
icom.genesyslab.statistics.lib.*;
Genesys.ComLib.TKV.TKVList;
You need to declare them beforehand.
Arguments
- Hostname or IP address of the StatServer
- Port of the StatServer
- Name of the tenant (e.g., “Resources”)
- Object_Type:
0 → Agent
1 → Place
2 → RegDN
3 → Queue
4 → Routing Point
5 → Group Agents
6 → Group Places - Object_ID (e.g., “Agent_5610”, “CreditCards”, and etc.)
- StatType (e.g., “CurrNumberNotReadyStatuses”)
- Subject (int)
- Category (int)
- Notification Mode (int)
- Main Mask (BitMap)
- Rel(ative) Mask (BitMap)
Declaration:
public static String SS_hostname;
public static String SS_port;
public static String SS_tenant="Resources"; // "Resources is the default"
public static int SS_objectType;
public static String SS_objectID;
public static String SS_statType;
public static int SS_subject;
public static int SS_category;
public static int SS_notificationMode=1; // 1 is the default
public static String SS_mainMask;
public static String SS_relMask;
public static String Hostname;
public static int Port;
public static String GUID;
Connecting StatServer
QueryStatServer statlibtest = new QueryStatServer();
// Connect to the given Stat Server:
int rx;
rx=(int)(Math.random()*100);
// 0x1122f
int chk = statlib.SOpenServerEx(SS_hostname, SS_port, null, "Stn666", rx, statlibtest, 0);
Where,
SOpenServerEx is used to get connected to the given statServer.
Once you have connected, you should notify StatServer with your tenant profile:
STenantProfile stenantprofile = new STenantProfile(SS_tenant, "");
int j = statlib.SSetNextTenantProfile(stenantprofile);
SRequestParams srequestparams = getStatRequest();
Querying StatServer
At first, initialize KVList (assuming that you all know what the heck KVPair/KVList is):
TKVList tkvlist = new TKVList();
tkvlist.TKVListAddString("value", "A");
Well, let’s query StatServer, for example, TotalLoginTime,
statlib.SLOpenStat(SS_objectType, SS_objectID, SS_statType, tkvlist, 0, 0);
int k = statlib.SOpenStat(srequestparams);
Where,
public static SRequestParams [b]getStatRequest[/b]()
{
int num;
int i,n=0;
String dummy;
SRequestParams srequestparams = new SRequestParams();
srequestparams.objectID = SS_objectID;
srequestparams.objectType = SS_objectType;
srequestparams.subject = SS_subject;
srequestparams.category = SS_category;
srequestparams.notificationMode = 1; //SS_notificationMode;
// Configuration
srequestparams.tmNotificationFrequency = 3;
//srequestparams.insensitivityPercentage = 90;
// Setting the Main Mask
SActionsMask sactionsmask = new SActionsMask();
// Here, we have to check out the first two bytes
// of the given hash -- it gives us the number of
// bytes to be set.
// If the first two bytes = "00", then it means CLEAR ALL
// If the first two bytes = "FF", then it means SET ALL
// If the numerical value of the first two bytes <0,
// then set ALL except the given
// If the numerical value of the first two bytes >0,
// then set the given bits only.
// With the light of this knowledge,
dummy=SS_mainMask.substring(0, 2);
sactionsmask.clearAll(); // First clear the bitmap
if (dummy.equalsIgnoreCase("FF"))
sactionsmask.setAll(); // Set all bits
else if (dummy.equalsIgnoreCase("00"))
dummy="kek";// Nope
else
{
num=Integer.parseInt(dummy);
// just set the given bits
if(num>0)
{
n=0;
for(i=0;i<num;i++)
{
n=n+2;
sactionsmask.setBit(Integer.parseInt(SS_mainMask.substring(n, n+2)));
}
}
else
// set all except the given
// e.g., in CME, "*, ~CallOutbound, ~WaitForVic"
{
sactionsmask.setAll();
n=0;
for(i=0;i<num;i++)
{
n=n+2;
sactionsmask.clearBit(Integer.parseInt(SS_mainMask.substring(n, n+2)));
}
}
}
srequestparams.MainActionsMask = sactionsmask.getBytes();
// Setting the Relative (Rel) Mask:
srequestparams.interval = 0;
srequestparams.tmLength = 10;
SActionsMask sactionsmask1 = new SActionsMask();
dummy=SS_relMask.substring(0, 2);
if (dummy.equalsIgnoreCase("FF"))
sactionsmask1.setAll(); // Set all bits
else if (dummy.equalsIgnoreCase("00"))
sactionsmask1.clearAll(); // First clear the bitmap
else if (dummy.equalsIgnoreCase("DN"))
dummy="kedi";// Do Nothing!!!
else
{
num=Integer.parseInt(dummy);
// just set the given bits:
if(num>0)
{
n=0;
for(i=0;i<num;i++)
{
n=n+2;
sactionsmask1.setBit(Integer.parseInt(SS_mainMask.substring(n, n+2)));
}
}
else
// set all except the given
// e.g., in CME, "*, ~CallOutbound, ~WaitForVic"
{
sactionsmask1.setAll();
n=0;
for(i=0;i<num;i++)
{
n=n+2;
sactionsmask1.clearBit(Integer.parseInt(SS_mainMask.substring(n, n+2)));
}
}
}
srequestparams.RelActionsMask = sactionsmask1.getBytes();
return srequestparams;
}
Nice, eh? ;D
Cheers,
Ali
P.S. What given above belongs to former versions of Genesys Framework. Well, it might not work with current versions. On the other hand, here, my aim is to give you a clue about Genesys-programming.