/// <summary>
/// returns a single PhoneSystem object from an ObjectId string passed in.
/// </summary>
/// <param name="pConnectionServer">
/// Connection server that the phone system is homed on.
/// </param>
/// <param name="pObjectId">
/// The ObjectId of the phone system to load
/// </param>
/// <param name="pPhoneSystem">
/// The out param that the filled out instance of the PhoneSystem class is returned on.
/// </param>
/// <param name="pDisplayName">
/// Optional display name
/// </param>
/// <returns>
/// Instance of the WebCallResults class containing details of the items sent and recieved from the CUPI interface.
/// </returns>
public static WebCallResult GetPhoneSystem(out PhoneSystem pPhoneSystem, ConnectionServerRest pConnectionServer, string pObjectId,
string pDisplayName = "")
{
WebCallResult res = new WebCallResult {
Success = false
};
pPhoneSystem = null;
if (pConnectionServer == null)
{
res.ErrorText = "Null Connection server object passed to GetPhoneSystem";
return(res);
}
//you need an objectID and/or a display name - both being blank is not acceptable
if (string.IsNullOrEmpty(pObjectId) & string.IsNullOrEmpty(pDisplayName))
{
res.ErrorText = "Empty objectId and DisplayName passed to GetPhonesystem";
return(res);
}
//create a new PhoneSystem instance passing the ObjectId (or display name) which fills out the data automatically
try
{
pPhoneSystem = new PhoneSystem(pConnectionServer, pObjectId, pDisplayName);
res.Success = true;
}
catch (UnityConnectionRestException ex)
{
return(ex.WebCallResult);
}
catch (Exception ex)
{
res.ErrorText = "Failed to fetch phone system in GetPhonesystem:" + ex.Message;
}
return(res);
}
/// <summary>
/// Adds a new phone system with the display name provided
/// </summary>
/// <param name="pConnectionServer">
/// The Connection server to add the phone system to
/// </param>
/// <param name="pDisplayName">
/// Name of the phone system to add. Display name should be unique among phone systems.
/// </param>
/// <param name="pPhoneSystem">
/// If the phone system is added, an instance of it is created and passed back on this out parameter.
/// </param>
/// <returns>
/// Instance of the WebCallResults class containing details of the items sent and recieved from the CUPI interface.
/// </returns>
public static WebCallResult AddPhoneSystem(ConnectionServerRest pConnectionServer, string pDisplayName, out PhoneSystem pPhoneSystem)
{
pPhoneSystem = null;
WebCallResult res = AddPhoneSystem(pConnectionServer, pDisplayName);
//if the create goes through, fetch the phone system as an object and return it.
if (res.Success)
{
res = GetPhoneSystem(out pPhoneSystem, pConnectionServer, res.ReturnedObjectId);
}
return(res);
}