View source for AlphaCom SDK Stentofon.AlphaCom.Example.CallRequests.exe

{{A}}
{{stub}}

== AlphaCom SDK Stentofon.AlphaCom - Call Reqeuest Handling ==


=== About the application ===


[[Image:AlphaComSDK_ExampleAppConfig.JPG|thumb|200px]]
[[Image:AlphaComSDK ExampleApp CallRequests.JPG|thumb|300px]]

==== Config ====

The application is a Windows Forms project with two Forms, the Main Window and Config window for inserting the IP address of the AlphaCom. 
The application config file is the default config file for the [[Stentofon.AlphaCom.AlphaNet.dll]] named '''Stentofon.AlphaCom.AlphaNet.xml''' defined in the namespace
'''Stentofon.AlphaCom.AlphaNet.Config'''. 

If no config file at startup the application will open the config window. The config window can also be opened by clicking the 'Config' button in the Main Window.

==== Application Initialisation ====


The '''AlphaNetClient''' object is initialized with the '''AlphaNetClientConfig''' object containing the IP address etc. The '''AutoDiscoverAllNodes''', '''AutoGetStationState ''' and '''AutoSyncCallRequests''' properties is also set to get all StationState objects, and sync Call Requests:

<code>_client = new AlphaNetClient(_formConfig.ClientConfig) { AutoDiscoverAllNodes = true, AutoGetStationState = true, AutoSyncCallRequests = trus };</code>

All The StationState objects will be stored in InMemory structure using the [[Stentofon.AlphaCom.Data.dll]]:

<code>_stateStorage = new AlphaComState(AlphaComStateStorages.IN_MEMORY);</code>

Handlers For TCP Up/Down, Node Connection Up/down, StationState, StationBusy/StationFree, StationConnect/StationDisconnect is registered:

<code>
_client.OnTCPConnectionUp += HandleTCPUp;<br/>
_client.OnTCPConnectionDown += HandleTCPDown;<br/>
_client.OnNodeConnectionUp += HandleNodeUp;<br/>
_client.OnNodeConnectionDown += HandleNodeDown;<br/>
_client.OnStationStateReceived += HandleStationState;<br/>
_client.OnStationBusyReceived += HandleStationBusy;<br/>
_client.OnStationFreeReceived += HandleStationFree;<br/>
_client.OnStationConnect += HandleStationConnect;<br/>
_client.OnStationDisconnect += HandleStationDisconnect;<br/>
_client.OnCallRequest += HandleCallRequestReceived;<br/>
_client.OnCallRequestRemoved += HandleCallRequestRemoved;<br/>
...
</code>

Do the connection:

<code>
try{<br/>               
_client.StartListening();<br/>           
_client.StartMonitorThread();<br/>        
}<br/> 
catch (Exception ex){<br/>
connected = false;<br/>
}
</code>

==== Storing State info ====

Adding or updating on a StationState messages:

<code>
if (_stateStorage.UpdateStation(st) > 0)       // If added<br/>
_registeredStationCounter++;
</code>

Update the station busy flag in the state storage on StationFree Message received:

<code>
var station = _stateStorage.GetStationState(sf.Station);<br/>
if (station != null)<br/>
station.SetBusyState(false);    // Update the state storage object <br/>
</code>

Add a CallRequest:
<code>
_stateStorage.AddCallRequest(cr);
</code>

Remove a CallRequest:
<code>
_stateStorage.RemoveCallRequest(cr);
</code>

==== Retrieving StationState and CallRequest objects ====

Get a list of StationStates objects matching the Display Text or Directory number (if string is numeric):

<code>
var stList = GetStationList(textBoxStationSearch.Text);
</code>

Get a list of CallRequest objects on Directory number:

<code>
var callRequestList = _stateStorage.GetCallRequestListOnReceivingStation(_selectedStation.DirectoryNumber);
</code>

[[Category:SDK]]