private RequestFields getFileData(string filename)
{// get file details, (data, length, mimetype)
try
{
RequestFields file_data = new RequestFields();
if (File.Exists(filename))
{// file found
byte[] file_content = File.ReadAllBytes(filename);
file_data.Add("filepath", filename);
file_data.Add("filelength", file_content.Length);
string extension = filename.Substring(filename.LastIndexOf(".") + 1);
file_data.Add("mimetype", getFileMimeType(extension));
return(file_data);
}
else
{// file not found
throw new Exception(this.internal_errors(8));
}
}
catch (Exception e)
{// any error
throw e;
}
}
private void btnChangeWages_Click(object sender, EventArgs e)
{
try
{
//get first employee id
response = shiftPlanning.getEmployees();
int firstEmpId = int.Parse(response.Data["1"].Item["id"].Value);
//log
txtLog.AppendText("\r\n\r\nMethod: updateEmployee");
string wage = Interaction.InputBox("Please enter the wages", "C# SDK", null, 0, 0);
//preparing list of request field
RequestFields employee_data = new RequestFields();
employee_data.Add("id", firstEmpId);
employee_data.Add("wage", wage);
response = shiftPlanning.updateEmployee(employee_data);
if (response.Status.Code == "1")
{
txtLog.AppendText("\r\nEmployee record updated.");
}
}
catch (Exception ex)
{
txtLog.AppendText("\r\n\r\nException: " + ex.Message);
}
}
/// <summary>
/// Clock in a single employee using timeclock.clockin
/// </summary>
/// <param name="id">ShiftPlanning ID of the employee to clock in</param>
/// <returns>API response data for timeclock.clockin</returns>
public APIResponse clockInEmployee(int id)
{
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "timeclock.clockin");
requestFields.Add("method", "GET");
requestFields.Add("employee", id);
this.setRequest(requestFields);
return response;
}
public APIResponse getAPIMethods()
{// get API methods
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "api.methods");
requestFields.Add("method", "GET");
this.setRequest(requestFields);
return(response);
}
/*
* Staff Methods
*
*/
public APIResponse getEmployees()
{ // get a list of employees
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "staff.employees");
requestFields.Add("method", "GET");
this.setRequest(requestFields);
return(response);
}
public APIResponse getAdminBackups()
{// get admin files
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "admin.backups");
requestFields.Add("method", "GET");
this.setRequest(requestFields);
return(response);
}
/*
* API Methods
*
*/
public APIResponse getAPIConfig()
{// get API config
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "api.config");
requestFields.Add("method", "GET");
this.setRequest(requestFields);
return(response);
}
public APIResponse getStaffSkills()
{// get a list of staff skills
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "staff.skills");
requestFields.Add("method", "GET");
this.setRequest(requestFields);
return(response);
}
/*
* Administration Methods
*
*/
#region Settings
public APIResponse getAdminSettings()
{// get admin settings
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "admin.settings");
requestFields.Add("method", "GET");
this.setRequest(requestFields);
return(response);
}
public APIResponse getWallMessages()
{// get messages for the currently logged in user
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "messaging.wall");
requestFields.Add("method", "GET");
this.setRequest(requestFields);
return(response);
}
/*
* Schedules Methods
*
*/
public APIResponse getSchedules()
{// get a list of schedules
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "schedule.schedules");
requestFields.Add("method", "GET");
this.setRequest(requestFields);
return(response);
}
public APIResponse getShiftDetails(int id)
{// get shift detail by id
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "schedule.shift");
requestFields.Add("method", "GET");
requestFields.Add("id", id);
this.setRequest(requestFields);
return(response);
}
public APIResponse deleteAdminBackup(int id)
{// delete a employee by id
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "admin.file");
requestFields.Add("method", "DELETE");
requestFields.Add("id", id);
this.setRequest(requestFields);
return(response);
}
public APIResponse getAdminBackupDetails(int id)
{// get admin file details
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "admin.backup");
requestFields.Add("method", "GET");
requestFields.Add("id", id);
this.setRequest(requestFields);
return(response);
}
public APIResponse deleteVacationSchedule(int id)
{// delete a VacationSchedule by id
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "schedule.vacation");
requestFields.Add("method", "DELETE");
requestFields.Add("id", id);
this.setRequest(requestFields);
return(response);
}
public APIResponse deleteShift(int id)
{// delete a shift by id
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "schedule.shift");
requestFields.Add("method", "DELETE");
requestFields.Add("id", id);
this.setRequest(requestFields);
return(response);
}
public APIResponse getStaffSkillDetails(int id)
{// get skill detail by id
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "staff.skill");
requestFields.Add("method", "GET");
requestFields.Add("id", id);
this.setRequest(requestFields);
return(response);
}
public APIResponse getMessageDetails(int id)
{// get messages for the currently logged in user
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "messaging.message");
requestFields.Add("method", "GET");
requestFields.Add("id", id);
this.setRequest(requestFields);
return(response);
}
public APIResponse deleteStaffSkill(int id)
{// delete a staff skill by id
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "staff.skill");
requestFields.Add("method", "DELETE");
requestFields.Add("id", id);
this.setRequest(requestFields);
return(response);
}
public APIResponse deleteEmployee(int id)
{// delete a employee by id
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "staff.employee");
requestFields.Add("method", "DELETE");
requestFields.Add("id", id);
this.setRequest(requestFields);
return(response);
}
public APIResponse getEmployeeDetails(int id)
{// get employee details by id
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "staff.employee");
requestFields.Add("method", "GET");
requestFields.Add("id", id);
this.setRequest(requestFields);
return(response);
}
public APIResponse deleteMessage(int id)
{ // delete a message
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "messaging.message");
requestFields.Add("method", "DELETE");
requestFields.Add("id", id);
this.setRequest(requestFields);
return(response);
}
public APIResponse getVacationScheduleDetails(int id)
{// get VacationSchedule detail by id
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "schedule.vacation");
requestFields.Add("method", "GET");
requestFields.Add("id", id);
this.setRequest(requestFields);
return(response);
}
public APIResponse breakOut(string timeclock)
{
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "timeclock.event");
requestFields.Add("method", "CREATE");
requestFields.Add("timeclock", timeclock);
requestFields.Add("type", "breakout");
this.setRequest(requestFields);
return(response);
}
public APIResponse deleteWallMessage(int id, WallMessageDeleteType wmt)
{// delete a message
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "messaging.wall");
requestFields.Add("method", "DELETE");
requestFields.Add("id", id);
requestFields.Add("delete", wmt == WallMessageDeleteType.Comment ? "comment" : "message");
this.setRequest(requestFields);
return(response);
}
private void destroySession()
{// destroy the currently active session
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "staff.logout");
requestFields.Add("method", "GET");
this.setRequest(requestFields);
if (response.Status[0].Code == "1")
{// logout successful, remove local session data
this._token = null;
}
}
public APIResponse createPing(RequestFields ping_data)
{// create new staff skill
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "staff.ping");
requestFields.Add("method", "CREATE");
//append skill fields
foreach (KeyValuePair <string, object> fld in ping_data)
{
requestFields.Add(fld.Key, fld.Value);
}
this.setRequest(requestFields);
return(response);
}
public APIResponse updateAdminBackup(RequestFields details)
{// update admin file details
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "admin.backup");
requestFields.Add("method", "UPDATE");
//append employee details fields
foreach (KeyValuePair <string, object> fld in details)
{
requestFields.Add(fld.Key, fld.Value);
}
this.setRequest(requestFields);
return(response);
}
public APIResponse createEmployee(RequestFields employee_data)
{// create a employee
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "staff.employee");
requestFields.Add("method", "CREATE");
//append employee details fields
foreach (KeyValuePair <string, object> fld in employee_data)
{
requestFields.Add(fld.Key, fld.Value);
}
this.setRequest(requestFields);
return(response);
}
public APIResponse createWallMessage(RequestFields message_details)
{// create a new message
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "messaging.wall");
requestFields.Add("method", "CREATE");
//append message fields
foreach (KeyValuePair <string, object> fld in message_details)
{
requestFields.Add(fld.Key, fld.Value);
}
this.setRequest(requestFields);
return(response);
}
/*
* User Authentication Methods
*
*/
public APIResponse doLogin(RequestFields login_details)
{// perform a login api call
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "staff.login");
requestFields.Add("method", "GET");
//append message fields
foreach (KeyValuePair <string, object> fld in login_details)
{
requestFields.Add(fld.Key, fld.Value);
}
this.setRequest(requestFields);
return(response);
}
public APIResponse createAdminBackup(RequestFields details)
{
// create new admin file
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "admin.backup");
requestFields.Add("method", "CREATE");
//append details
foreach (KeyValuePair<string, object> fld in details)
requestFields.Add(fld.Key, fld.Value);
//append filedetails
RequestFields file_details = getFileData(details["filename"].ToString());
foreach (KeyValuePair<string, object> fld in file_details)
requestFields.Add(fld.Key, fld.Value);
this.setRequest(requestFields);
return response;
}
public APIResponse getStaffSkills()
{
// get a list of staff skills
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "staff.skills");
requestFields.Add("method", "GET");
this.setRequest(requestFields);
return response;
}
public APIResponse getShifts(RequestFields filter)
{
// get a list of shift
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "schedule.shifts");
requestFields.Add("method", "GET");
//append fields
foreach (KeyValuePair<string, object> fld in filter)
requestFields.Add(fld.Key, fld.Value);
this.setRequest(requestFields);
return response;
}
public APIResponse getStaffSkillDetails(int id)
{
// get skill detail by id
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "staff.skill");
requestFields.Add("method", "GET");
requestFields.Add("id", id);
this.setRequest(requestFields);
return response;
}
/*
* Schedules Methods
*
*/
public APIResponse getSchedules()
{
// get a list of schedules
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "schedule.schedules");
requestFields.Add("method", "GET");
this.setRequest(requestFields);
return response;
}
public APIResponse getShiftDetails(int id)
{
// get shift detail by id
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "schedule.shift");
requestFields.Add("method", "GET");
requestFields.Add("id", id);
this.setRequest(requestFields);
return response;
}
public APIResponse getWallMessages()
{
// get messages for the currently logged in user
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "messaging.wall");
requestFields.Add("method", "GET");
this.setRequest(requestFields);
return response;
}
/*
* User Authentication Methods
*
*/
public APIResponse doLogin(RequestFields login_details)
{
// perform a login api call
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "staff.login");
requestFields.Add("method", "GET");
//append message fields
foreach (KeyValuePair<string, object> fld in login_details)
requestFields.Add(fld.Key, fld.Value);
this.setRequest(requestFields);
return response;
}
public APIResponse getEmployeeDetails(int id)
{
// get employee details by id
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "staff.employee");
requestFields.Add("method", "GET");
requestFields.Add("id", id);
this.setRequest(requestFields);
return response;
}
/*
* Staff Methods
*
*/
public APIResponse getEmployees()
{
// get a list of employees
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "staff.employees");
requestFields.Add("method", "GET");
this.setRequest(requestFields);
return response;
}
private RequestFields getFileData(string filename)
{
// get file details, (data, length, mimetype)
try
{
RequestFields file_data = new RequestFields();
if (File.Exists(filename))
{// file found
byte[] file_content = File.ReadAllBytes(filename);
file_data.Add("filepath", filename);
file_data.Add("filelength", file_content.Length);
string extension = filename.Substring(filename.LastIndexOf(".") + 1);
file_data.Add("mimetype", getFileMimeType(extension));
return file_data;
}
else
{// file not found
throw new Exception(this.internal_errors(8));
}
}
catch (Exception e)
{// any error
throw e;
}
}
public APIResponse getAPIMethods()
{
// get API methods
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "api.methods");
requestFields.Add("method", "GET");
this.setRequest(requestFields);
return response;
}
public APIResponse updateVacationSchedule(RequestFields vacation_details)
{
// update VacationSchedule
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "schedule.vacation");
requestFields.Add("method", "UPDATE");
//append fields
foreach (KeyValuePair<string, object> fld in vacation_details)
requestFields.Add(fld.Key, fld.Value);
this.setRequest(requestFields);
return response;
}
public APIResponse updateShift(RequestFields shift_details)
{
// update shift
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "schedule.shift");
requestFields.Add("method", "UPDATE");
//append fields
foreach (KeyValuePair<string, object> fld in shift_details)
requestFields.Add(fld.Key, fld.Value);
this.setRequest(requestFields);
return response;
}
public APIResponse updateAdminFile(RequestFields details)
{
// update admin file details
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "admin.file");
requestFields.Add("method", "UPDATE");
//append employee details fields
foreach (KeyValuePair<string, object> fld in details)
requestFields.Add(fld.Key, fld.Value);
this.setRequest(requestFields);
return response;
}
public APIResponse getVacationScheduleDetails(int id)
{
// get VacationSchedule detail by id
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "schedule.vacation");
requestFields.Add("method", "GET");
requestFields.Add("id", id);
this.setRequest(requestFields);
return response;
}
public APIResponse getMessageDetails(int id)
{
// get messages for the currently logged in user
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "messaging.message");
requestFields.Add("method", "GET");
requestFields.Add("id", id);
this.setRequest(requestFields);
return response;
}
public APIResponse getVacationSchedules(RequestFields time_period)
{
// get schedule vacations, pass start and end params to get vacations within a certian time-period
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "schedule.vacations");
requestFields.Add("method", "GET");
//append fields
foreach (KeyValuePair<string, object> fld in time_period)
requestFields.Add(fld.Key, fld.Value);
this.setRequest(requestFields);
return response;
}
public APIResponse getScheduleConflicts(RequestFields fields)
{
// get schedule conflicts
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "schedule.conflicts");
requestFields.Add("method", "GET");
//append time_period fields
foreach (KeyValuePair<string, object> fld in fields)
requestFields.Add(fld.Key, fld.Value);
this.setRequest(requestFields);
return response;
}
public APIResponse getAdminBackups()
{
// get admin files
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "admin.backups");
requestFields.Add("method", "GET");
this.setRequest(requestFields);
return response;
}
public APIResponse deleteWallMessage(int id, WallMessageDeleteType wmt)
{
// delete a message
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "messaging.wall");
requestFields.Add("method", "DELETE");
requestFields.Add("id", id);
requestFields.Add("delete", wmt == WallMessageDeleteType.Comment ? "comment" : "message");
this.setRequest(requestFields);
return response;
}
public APIResponse updateAdminSettings(RequestFields settings)
{
// update admin settings
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "admin.settings");
requestFields.Add("method", "UPDATE");
//append fields
foreach (KeyValuePair<string, object> fld in settings)
requestFields.Add(fld.Key, fld.Value);
this.setRequest(requestFields);
return response;
}
public APIResponse getAdminFileDetails(int id)
{
// get admin file details
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "admin.file");
requestFields.Add("method", "GET");
requestFields.Add("id", id);
this.setRequest(requestFields);
return response;
}
public APIResponse updateStaffSkill(RequestFields skill_details)
{
// update staff skill
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "staff.skill");
requestFields.Add("method", "UPDATE");
//append skill fields
foreach (KeyValuePair<string, object> fld in skill_details)
requestFields.Add(fld.Key, fld.Value);
this.setRequest(requestFields);
return response;
}
public APIResponse getAdminSettings()
{
// get admin settings
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "admin.settings");
requestFields.Add("method", "GET");
this.setRequest(requestFields);
return response;
}
private void destroySession()
{
// destroy the currently active session
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "staff.logout");
requestFields.Add("method", "GET");
this.setRequest(requestFields);
if (response.Status.Code == "1")
{// logout successful, remove local session data
this._token = null;
}
}
/*
* API Methods
*
*/
public APIResponse getAPIConfig()
{
// get API config
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "api.config");
requestFields.Add("method", "GET");
this.setRequest(requestFields);
return response;
}
public APIResponse createEmployee(RequestFields employee_data)
{
// create a employee
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "staff.employee");
requestFields.Add("method", "CREATE");
//append employee details fields
foreach (KeyValuePair<string, object> fld in employee_data)
requestFields.Add(fld.Key, fld.Value);
this.setRequest(requestFields);
return response;
}
public APIResponse deleteVacationSchedule(int id)
{
// delete a VacationSchedule by id
RequestFields requestFields = new RequestFields();
requestFields.Add("module", "schedule.vacation");
requestFields.Add("method", "DELETE");
requestFields.Add("id", id);
this.setRequest(requestFields);
return response;
}