649 lines
23 KiB
PHP
649 lines
23 KiB
PHP
<?php
|
|
/*********************************************************************************
|
|
*
|
|
* TimeTrex is a Workforce Management program developed by
|
|
* TimeTrex Software Inc. Copyright (C) 2003 - 2021 TimeTrex Software Inc.
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify it under
|
|
* the terms of the GNU Affero General Public License version 3 as published by
|
|
* the Free Software Foundation with the addition of the following permission
|
|
* added to Section 15 as permitted in Section 7(a): FOR ANY PART OF THE COVERED
|
|
* WORK IN WHICH THE COPYRIGHT IS OWNED BY TIMETREX, TIMETREX DISCLAIMS THE
|
|
* WARRANTY OF NON INFRINGEMENT OF THIRD PARTY RIGHTS.
|
|
*
|
|
* This program is distributed in the hope that it will be useful, but WITHOUT
|
|
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
|
|
* FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
|
|
* details.
|
|
*
|
|
*
|
|
* You should have received a copy of the GNU Affero General Public License along
|
|
* with this program; if not, see http://www.gnu.org/licenses or write to the Free
|
|
* Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
|
|
* 02110-1301 USA.
|
|
*
|
|
*
|
|
* You can contact TimeTrex headquarters at Unit 22 - 2475 Dobbin Rd. Suite
|
|
* #292 West Kelowna, BC V4T 2E9, Canada or at email address info@timetrex.com.
|
|
*
|
|
*
|
|
* The interactive user interfaces in modified source and object code versions
|
|
* of this program must display Appropriate Legal Notices, as required under
|
|
* Section 5 of the GNU Affero General Public License version 3.
|
|
*
|
|
*
|
|
* In accordance with Section 7(b) of the GNU Affero General Public License
|
|
* version 3, these Appropriate Legal Notices must retain the display of the
|
|
* "Powered by TimeTrex" logo. If the display of the logo is not reasonably
|
|
* feasible for technical reasons, the Appropriate Legal Notices must display
|
|
* the words "Powered by TimeTrex".
|
|
*
|
|
********************************************************************************/
|
|
|
|
/**
|
|
* Class SugarCRM
|
|
*/
|
|
class SugarCRM {
|
|
private $soap_client_obj = null;
|
|
private $session_id = null;
|
|
|
|
private $sugarcrm_url = null;
|
|
private $sugarcrm_user_name = null;
|
|
private $sugarcrm_password = null;
|
|
|
|
/**
|
|
* SugarCRM constructor.
|
|
* @param null $url
|
|
*/
|
|
function __construct( $url = null ) {
|
|
if ( $url != '' ) {
|
|
$this->sugarcrm_url = $url;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @return null|SoapClient
|
|
*/
|
|
function getSoapObject() {
|
|
if ( $this->soap_client_obj == null ) {
|
|
ini_set( 'default_socket_timeout', 300 ); //This helps prevent "Error fetching HTTP headers" SOAP error.
|
|
$this->soap_client_obj = new SoapClient( null, [
|
|
'location' => $this->sugarcrm_url,
|
|
'uri' => 'urn:http://www.sugarcrm.com/sugarcrm',
|
|
'style' => SOAP_RPC,
|
|
'use' => SOAP_ENCODED,
|
|
'encoding' => 'UTF-8',
|
|
'connection_timeout' => 30,
|
|
'keep_alive' => false, //This prevents "Error fetching HTTP headers" SOAP error.
|
|
'compression' => SOAP_COMPRESSION_ACCEPT | SOAP_COMPRESSION_GZIP,
|
|
'trace' => 1,
|
|
'exceptions' => 0,
|
|
]
|
|
);
|
|
}
|
|
|
|
return $this->soap_client_obj;
|
|
}
|
|
|
|
/**
|
|
* @param $data
|
|
* @return array|bool
|
|
*/
|
|
function convertToNameValueList( $data ) {
|
|
if ( is_array( $data ) ) {
|
|
|
|
$retarr = [];
|
|
foreach ( $data as $key => $value ) {
|
|
$row = new stdClass();
|
|
$row->name = $key;
|
|
$row->value = $value;
|
|
$retarr[] = $row;
|
|
unset( $row );
|
|
}
|
|
|
|
return $retarr;
|
|
}
|
|
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* @param null $user_name
|
|
* @param null $password
|
|
* @return bool
|
|
*/
|
|
function login( $user_name = null, $password = null ) {
|
|
if ( $user_name == '' ) {
|
|
$user_name = $this->sugarcrm_user_name;
|
|
}
|
|
|
|
if ( $password == '' ) {
|
|
$password = $this->sugarcrm_password;
|
|
}
|
|
$user_auth = [
|
|
'user_name' => $user_name,
|
|
'password' => md5( $password ),
|
|
'version' => '0.1',
|
|
];
|
|
$result = $this->getSoapObject()->login( $user_auth, 'timetrex' );
|
|
|
|
//echo "Request :\n".htmlspecialchars($this->getSoapObject()->__getLastRequest()) ."\n";
|
|
//echo "Response :\n".htmlspecialchars($this->getSoapObject()->__getLastResponse()) ."\n";
|
|
//Debug::Arr($result, 'bSOAP Result Array: ', __FILE__, __LINE__, __METHOD__, 10);
|
|
|
|
//( isset($result->error) AND isset($result->error->number) AND $result->error->number == 0 ) )
|
|
if ( is_object( $result ) && ( isset( $result->id ) && strlen( $result->id ) > 0 ) ) {
|
|
$this->session_id = $result->id;
|
|
Debug::Text( 'aSugarCRM Login Success! Session ID: ' . $this->session_id, __FILE__, __LINE__, __METHOD__, 10 );
|
|
|
|
return true;
|
|
} else {
|
|
//Retry login
|
|
sleep( 5 );
|
|
$result = $this->getSoapObject()->login( $user_auth, 'timetrex' );
|
|
if ( is_object( $result ) && ( isset( $result->id ) && strlen( $result->id ) > 0 ) ) {
|
|
$this->session_id = $result->id;
|
|
Debug::Text( 'bSugarCRM Login Success! Session ID: ' . $this->session_id, __FILE__, __LINE__, __METHOD__, 10 );
|
|
|
|
return true;
|
|
} else {
|
|
Debug::Text( 'bSugarCRM Login failed!', __FILE__, __LINE__, __METHOD__, 10 );
|
|
}
|
|
}
|
|
|
|
Debug::Arr( $result, 'SOAP Login Result Array: ', __FILE__, __LINE__, __METHOD__, 10 );
|
|
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* @return mixed
|
|
*/
|
|
function getUserGUID() {
|
|
$user_guid = $this->getSoapObject()->get_user_id( $this->session_id );
|
|
Debug::Text( 'User GUID: ' . $user_guid, __FILE__, __LINE__, __METHOD__, 10 );
|
|
|
|
return $user_guid;
|
|
}
|
|
|
|
/**
|
|
* @return bool
|
|
*/
|
|
function getAvailableModules() {
|
|
$result = $this->getSoapObject()->get_available_modules( $this->session_id );
|
|
Debug::Arr( $result, 'bSOAP Result Array: ', __FILE__, __LINE__, __METHOD__, 10 );
|
|
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Search by account name as well, if the email doesn't match but company name does.
|
|
* @param $search_field
|
|
* @param $search_value
|
|
* @param string $select_fields
|
|
* @param string $limit
|
|
* @return SugarCRMReturnHandler
|
|
*/
|
|
function getLeads( $search_field, $search_value, $select_fields = '', $limit = '' ) {
|
|
switch ( $search_field ) {
|
|
case 'id':
|
|
$query = "( leads.id = '" . $search_value . "' )";
|
|
break;
|
|
case 'email':
|
|
//This query can take around 1 second to run.
|
|
//Don't restrict the query to just specific lead_sources, as that can cause emails to be missed.
|
|
//$query = "leads.lead_source = 'Web Site' AND leads.assigned_user_id != 1 AND leads.id in ( SELECT eabr.bean_id FROM email_addr_bean_rel eabr LEFT JOIN email_addresses ea ON eabr.email_address_id = ea.id WHERE eabr.bean_module = 'Leads' AND ea.email_address = '".$search_value."' AND ( eabr.deleted = 0 AND ea.deleted = 0 ) )";
|
|
//$query = "( leads.lead_source = 'Web Site' OR leads.lead_source = 'Cold Call' ) AND leads.assigned_user_id != 1 AND leads.id in ( SELECT eabr.bean_id FROM email_addr_bean_rel eabr LEFT JOIN email_addresses ea ON eabr.email_address_id = ea.id WHERE eabr.bean_module = 'Leads' AND ea.email_address = '".$search_value."' AND ( eabr.deleted = 0 AND ea.deleted = 0 ) )";
|
|
$query = "leads.assigned_user_id != 1 AND leads.id in ( SELECT eabr.bean_id FROM email_addr_bean_rel eabr LEFT JOIN email_addresses ea ON eabr.email_address_id = ea.id WHERE eabr.bean_module = 'Leads' AND ea.email_address = '" . $search_value . "' AND ( eabr.deleted = 0 AND ea.deleted = 0 ) )";
|
|
break;
|
|
case 'any_phone':
|
|
$query = "( replace(replace(replace(replace(replace(leads.phone_work, ' ', ''), '.', ''), '-', ''), '(', ''), ')', '') = '" . $search_value . "' OR replace(replace(replace(replace(replace(leads.phone_mobile, ' ', ''), '.', ''), '-', ''), '(', ''), ')', '') = '" . $search_value . "' OR replace(replace(replace(replace(replace(leads.phone_home, ' ', ''), '.', ''), '-', ''), '(', ''), ')', '') = '" . $search_value . "' OR replace(replace(replace(replace(replace(leads.phone_other, ' ', ''), '.', ''), '-', ''), '(', ''), ')', '') = '" . $search_value . "' OR replace(replace(replace(replace(replace(leads.phone_fax, ' ', ''), '.', ''), '-', ''), '(', ''), ')', '') = '" . $search_value . "' )";
|
|
break;
|
|
case 'status':
|
|
$query = "( leads.status LIKE '" . $search_value . "' )";
|
|
break;
|
|
}
|
|
|
|
// get_entry_list($session, $module_name, $query, $order_by, $offset, $select_fields, $max_results, $deleted ) {
|
|
$result = $this->getSoapObject()->get_entry_list( $this->session_id, 'Leads', $query, '', 0, $select_fields, $limit, false );
|
|
//Debug::Arr($result, 'bSOAP Result Array: ', __FILE__, __LINE__, __METHOD__, 10);
|
|
|
|
//return $result;
|
|
return new SugarCRMReturnHandler( $result, $select_fields, $limit );
|
|
}
|
|
|
|
/**
|
|
* Search by account name as well, if the email doesn't match but company name does.
|
|
* @param $search_field
|
|
* @param $search_value
|
|
* @param string $select_fields
|
|
* @param string $limit
|
|
* @return SugarCRMReturnHandler
|
|
*/
|
|
function getContacts( $search_field, $search_value, $select_fields = '', $limit = '' ) {
|
|
switch ( $search_field ) {
|
|
case 'email':
|
|
//This query can take around 1 second to run.
|
|
$query = "contacts.assigned_user_id != 1 AND contacts.id in ( SELECT eabr.bean_id FROM email_addr_bean_rel eabr LEFT JOIN email_addresses ea ON eabr.email_address_id = ea.id WHERE eabr.bean_module = 'contacts' AND ea.email_address = '" . $search_value . "' AND ( eabr.deleted = 0 AND ea.deleted = 0 ) )";
|
|
break;
|
|
case 'any_phone':
|
|
$query = "( replace(replace(replace(replace(replace(contacts.phone_work, ' ', ''), '.', ''), '-', ''), '(', ''), ')', '') = '" . $search_value . "' OR replace(replace(replace(replace(replace(contacts.phone_mobile, ' ', ''), '.', ''), '-', ''), '(', ''), ')', '') = '" . $search_value . "' OR replace(replace(replace(replace(replace(contacts.phone_home, ' ', ''), '.', ''), '-', ''), '(', ''), ')', '') = '" . $search_value . "' OR replace(replace(replace(replace(replace(contacts.phone_other, ' ', ''), '.', ''), '-', ''), '(', ''), ')', '') = '" . $search_value . "' OR replace(replace(replace(replace(replace(contacts.phone_fax, ' ', ''), '.', ''), '-', ''), '(', ''), ')', '') = '" . $search_value . "' )";
|
|
break;
|
|
case 'status':
|
|
$query = "( contacts.status LIKE '" . $search_value . "' )";
|
|
break;
|
|
}
|
|
|
|
// get_entry_list($session, $module_name, $query, $order_by, $offset, $select_fields, $max_results, $deleted ) {
|
|
$result = $this->getSoapObject()->get_entry_list( $this->session_id, 'Contacts', $query, '', 0, $select_fields, $limit );
|
|
//Debug::Arr($result, 'bSOAP Result Array: ', __FILE__, __LINE__, __METHOD__, 10);
|
|
|
|
//return $result;
|
|
return new SugarCRMReturnHandler( $result, $select_fields, $limit );
|
|
}
|
|
|
|
/**
|
|
* @param $search_field
|
|
* @param $search_value
|
|
* @param string $select_fields
|
|
* @param string $limit
|
|
* @return SugarCRMReturnHandler
|
|
*/
|
|
function getEmails( $search_field, $search_value, $select_fields = '', $limit = '' ) {
|
|
Debug::Text( 'Get Emails for Field: ' . $search_field . ' Value: ' . $search_value, __FILE__, __LINE__, __METHOD__, 10 );
|
|
|
|
switch ( $search_field ) {
|
|
case 'lead_id':
|
|
$query = "emails.id in ( SELECT email_id FROM emails_beans WHERE bean_module = 'Leads' AND bean_id = '" . $search_value . "' )";
|
|
break;
|
|
}
|
|
|
|
$result = $this->getSoapObject()->get_entry_list( $this->session_id, 'Emails', $query, '', 0, $select_fields, $limit );
|
|
|
|
return new SugarCRMReturnHandler( $result, $select_fields, $limit );
|
|
}
|
|
|
|
/**
|
|
* @param $search_field
|
|
* @param $search_value
|
|
* @param string $select_fields
|
|
* @param string $limit
|
|
* @return SugarCRMReturnHandler
|
|
*/
|
|
function getCalls( $search_field, $search_value, $select_fields = '', $limit = '' ) {
|
|
Debug::Text( 'Get Calls for Field: ' . $search_field . ' Value: ' . $search_value, __FILE__, __LINE__, __METHOD__, 10 );
|
|
|
|
switch ( $search_field ) {
|
|
case 'id':
|
|
//Get a call by call_id.
|
|
$query = "calls.id = '" . $search_value . "'";
|
|
break;
|
|
case 'lead_id':
|
|
$query = "calls.id in ( SELECT call_id FROM calls_leads WHERE lead_id = '" . $search_value . "' )";
|
|
break;
|
|
}
|
|
|
|
$result = $this->getSoapObject()->get_entry_list( $this->session_id, 'Calls', $query, '', 0, $select_fields, $limit );
|
|
|
|
//Debug::Arr($result, 'bSOAP Result Array: ', __FILE__, __LINE__, __METHOD__, 10);
|
|
|
|
return new SugarCRMReturnHandler( $result, $select_fields, $limit );
|
|
}
|
|
|
|
/**
|
|
* @param string $id UUID
|
|
* @param $status
|
|
* @return bool
|
|
*/
|
|
function setLeadStatus( $id, $status ) {
|
|
|
|
$data = [
|
|
[ 'name' => 'status', 'value' => $status ],
|
|
[ 'name' => 'id', 'value' => $id ],
|
|
];
|
|
|
|
$result = $this->getSoapObject()->set_entry( $this->session_id, 'Leads', $data );
|
|
|
|
if ( $result->error->number == 0 ) {
|
|
Debug::Text( 'Changed lead status success! ID: ' . $id . ' Status: ' . $status, __FILE__, __LINE__, __METHOD__, 10 );
|
|
|
|
//Send out an email to sales@timetrex.com stating that the lead was converted?
|
|
|
|
return true;
|
|
} else {
|
|
Debug::Text( 'Changed lead status FAILED!: ' . $id, __FILE__, __LINE__, __METHOD__, 10 );
|
|
}
|
|
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* @param $data
|
|
* @return SugarCRMReturnHandler
|
|
*/
|
|
function setContact( $data ) {
|
|
/*
|
|
Fields:
|
|
array( 'name' => 'first_name', 'value' => $this->getFirstName() ),
|
|
array( 'name' => 'last_name', 'value' => $this->getLastName() ),
|
|
array( 'name' => 'phone_work', 'value' => $this->getPhone() ),
|
|
array( 'name' => 'phone_mobile', 'value' => $this->getPhone() ),
|
|
array( 'name' => 'account_name', 'value' => $this->getCompanyName() ),
|
|
array( 'name' => 'email1', 'value' => $this->getEmail() ),
|
|
array( 'name' => 'primary_address_city', 'value' => $this->getCity() ),
|
|
array( 'name' => 'primary_address_country', 'value' => $this->getCountry() ),
|
|
array( 'name' => 'lead_source', 'value' => 'Web Site' ),
|
|
array( 'name' => 'description', 'value' => $request_text_arr['body'] ),
|
|
array( 'name' => 'assigned_user_id', 'value' => '8db3bb58-8203-7ef3-b33f-4db9e7891adc' ), //Murray
|
|
*/
|
|
$result = $this->getSoapObject()->set_entry( $this->session_id, 'Contacts', $this->convertToNameValueList( $data ) );
|
|
Debug::Arr( $result, 'SOAP Result Array: ', __FILE__, __LINE__, __METHOD__, 10 );
|
|
|
|
return new SugarCRMReturnHandler( $result );
|
|
}
|
|
|
|
/**
|
|
* @param $data
|
|
* @return SugarCRMReturnHandler
|
|
*/
|
|
function setLead( $data ) {
|
|
/*
|
|
Fields:
|
|
array( 'name' => 'first_name', 'value' => $this->getFirstName() ),
|
|
array( 'name' => 'last_name', 'value' => $this->getLastName() ),
|
|
array( 'name' => 'phone_work', 'value' => $this->getPhone() ),
|
|
array( 'name' => 'account_name', 'value' => $this->getCompanyName() ),
|
|
array( 'name' => 'email1', 'value' => $this->getEmail() ),
|
|
array( 'name' => 'primary_address_city', 'value' => $this->getCity() ),
|
|
array( 'name' => 'primary_address_country', 'value' => $this->getCountry() ),
|
|
array( 'name' => 'Employees_c', 'value' => $this->getEmployee() ),
|
|
array( 'name' => 'time_zone_c', 'value' => $this->getTimeZone() .' ('. $time_zone_offset .')' ),
|
|
array( 'name' => 'status', 'value' => 'New' ),
|
|
array( 'name' => 'lead_source', 'value' => 'Web Site' ),
|
|
array( 'name' => 'opportunity_amount', 'value' => $this->getBudgetAmount() ),
|
|
array( 'name' => 'description', 'value' => $request_text_arr['body'] ),
|
|
//array( 'name' => 'assigned_user_id', 'value' => $user_guid ),
|
|
array( 'name' => 'assigned_user_id', 'value' => '8db3bb58-8203-7ef3-b33f-4db9e7891adc' ), //Murray
|
|
*/
|
|
$result = $this->getSoapObject()->set_entry( $this->session_id, 'Leads', $this->convertToNameValueList( $data ) );
|
|
Debug::Arr( $result, 'SOAP Result Array: ', __FILE__, __LINE__, __METHOD__, 10 );
|
|
|
|
return new SugarCRMReturnHandler( $result );
|
|
}
|
|
|
|
/**
|
|
* @param $data
|
|
* @return SugarCRMReturnHandler
|
|
*/
|
|
function setCall( $data ) {
|
|
/*
|
|
Fields:
|
|
Name (subject)
|
|
Description
|
|
duration_hours
|
|
duration_minutes //15 minute increments only.
|
|
date_start
|
|
date_entered
|
|
status (Planned, Held, Not Held)
|
|
direction (Inbound/Outbound)
|
|
assigned_user_id
|
|
parent_type (Module related too: Leads, Accounts, Contacts)
|
|
parent_id (module object id)
|
|
*/
|
|
$result = $this->getSoapObject()->set_entry( $this->session_id, 'Calls', $this->convertToNameValueList( $data ) );
|
|
Debug::Arr( $result, 'SOAP Result Array: ', __FILE__, __LINE__, __METHOD__, 10 );
|
|
|
|
return new SugarCRMReturnHandler( $result );
|
|
}
|
|
|
|
/**
|
|
* @param $data
|
|
* @return SugarCRMReturnHandler
|
|
*/
|
|
function setEmail( $data ) {
|
|
// - http://panther.sugarcrm.com/forums/showthread.php?t=68490&highlight=set_entry+email
|
|
/*
|
|
Fields:
|
|
from_addr
|
|
to_addrs
|
|
status (Sent/Read/UnRead/Replied)
|
|
name (subject)
|
|
description (body?)
|
|
date_start (Date/Time email was sent.)
|
|
assigned_user_id
|
|
parent_type (Module related too: Leads, Accounts, Contacts)
|
|
parent_id (module object id)
|
|
*/
|
|
$result = $this->getSoapObject()->set_entry( $this->session_id, 'Emails', $this->convertToNameValueList( $data ) );
|
|
Debug::Arr( $result, 'SOAP Result Array: ', __FILE__, __LINE__, __METHOD__, 10 );
|
|
|
|
return new SugarCRMReturnHandler( $result );
|
|
}
|
|
|
|
/**
|
|
* @param $module1
|
|
* @param string $module1_id UUID
|
|
* @param $module2
|
|
* @param string $module2_id UUID
|
|
* @return SugarCRMReturnHandler
|
|
*/
|
|
function setRelationship( $module1, $module1_id, $module2, $module2_id ) {
|
|
//Examples on relating contacts/leads to emails.
|
|
//$result = $sugarcrm->setRelationship( 'Contacts', '5b3826da-78d8-568a-73f3-43d92903b54d', 'Emails', '5c5a8553-f3d1-ce01-3b66-4dbc746092d7' );
|
|
//$result = $sugarcrm->setRelationship( 'Leads', '5f1f58a8-45c4-15da-ea0e-4d3f43f0f71f', 'Emails', '5c5a8553-f3d1-ce01-3b66-4dbc746092d7' );
|
|
//$result = $sugarcrm->setRelationship( 'Contacts', '5b3826da-78d8-568a-73f3-43d92903b54d', 'Accounts', '5c5a8553-f3d1-ce01-3b66-4dbc746092d7' );
|
|
$data = [
|
|
'module1' => $module1,
|
|
'module1_id' => $module1_id,
|
|
'module2' => $module2,
|
|
'module2_id' => $module2_id,
|
|
];
|
|
|
|
//Debug::Arr($data, 'Relationship Data: ', __FILE__, __LINE__, __METHOD__, 10);
|
|
$result = $this->getSoapObject()->set_relationship( $this->session_id, $data );
|
|
|
|
//Debug::Arr($result, 'SOAP Result Array: ', __FILE__, __LINE__, __METHOD__, 10);
|
|
|
|
return new SugarCRMReturnHandler( $result );
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Class SugarCRMReturnHandler
|
|
*/
|
|
class SugarCRMReturnHandler {
|
|
protected $result_data = null;
|
|
protected $select_fields = [];
|
|
protected $limit = null;
|
|
|
|
/**
|
|
* SugarCRMReturnHandler constructor.
|
|
* @param $result_data
|
|
* @param array $select_fields
|
|
* @param string $limit
|
|
*/
|
|
function __construct( $result_data, $select_fields = [], $limit = '' ) {
|
|
$this->result_data = $result_data;
|
|
$this->select_fields = $select_fields;
|
|
$this->limit = $limit;
|
|
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* @param $data
|
|
* @return array|bool
|
|
*/
|
|
function convertFromNameValueList( $data ) {
|
|
//Debug::Arr($data, 'Raw data to convert: ', __FILE__, __LINE__, __METHOD__, 10);
|
|
if ( isset( $data->name_value_list ) ) {
|
|
|
|
$retarr = [];
|
|
foreach ( $data->name_value_list as $field ) {
|
|
$retarr[$field->name] = $field->value;
|
|
}
|
|
if ( isset( $retarr ) ) {
|
|
return $retarr;
|
|
}
|
|
}
|
|
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* @return bool
|
|
*/
|
|
function isFault() {
|
|
if ( get_class( $this->result_data ) == 'SoapFault' ) {
|
|
return true;
|
|
}
|
|
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* @return bool
|
|
*/
|
|
function isValid() {
|
|
if ( $this->isFault() == true && is_soap_fault( $this->result_data ) ) {
|
|
trigger_error( 'SOAP Fault: (Code: ' . $this->result_data->faultcode . ', String: ' . $this->result_data->faultstring . ')', E_USER_NOTICE );
|
|
} else {
|
|
if ( isset( $this->result_data->error ) && $this->result_data->error->number == 0 ) {
|
|
return true;
|
|
} else if ( isset( $this->result_data->number ) && $this->result_data->number == 0 ) { //For set_relationship()
|
|
return true;
|
|
}
|
|
}
|
|
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* @return bool|int
|
|
*/
|
|
function getRecordCount() {
|
|
if ( isset( $this->result_data->result_count ) ) {
|
|
return (int)$this->result_data->result_count;
|
|
}
|
|
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* Returns the array of just one row.
|
|
* @param array $select_fields
|
|
* @return array|bool
|
|
*/
|
|
function getRow( $select_fields = [] ) {
|
|
if ( $this->result_data->error->number == 0 && isset( $this->result_data->result_count ) && $this->result_data->result_count == 1 && count( $this->result_data->entry_list ) == 1 ) {
|
|
//One row
|
|
Debug::Text( 'Single row...', __FILE__, __LINE__, __METHOD__, 10 );
|
|
$tmp_data = $this->convertFromNameValueList( $this->result_data->entry_list[0] );
|
|
if ( is_array( $tmp_data ) ) {
|
|
Debug::Arr( $tmp_data, 'Tmp Data', __FILE__, __LINE__, __METHOD__, 10 );
|
|
$retarr = $tmp_data;
|
|
}
|
|
|
|
//Debug::Arr($retarr, 'Handle Result Array: ', __FILE__, __LINE__, __METHOD__, 10);
|
|
|
|
if ( isset( $retarr ) ) {
|
|
return $retarr;
|
|
}
|
|
}
|
|
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* Returns one column from one row returned.
|
|
* @return bool|mixed
|
|
*/
|
|
function getOne() {
|
|
//Debug::Arr($this->result_data, 'Handle Result Array: ', __FILE__, __LINE__, __METHOD__, 10);
|
|
if ( $this->result_data->error->number == 0 && isset( $this->result_data->result_count ) && $this->result_data->result_count == 1 && count( $this->result_data->entry_list ) == 1 ) {
|
|
//One row
|
|
Debug::Text( 'Single row...', __FILE__, __LINE__, __METHOD__, 10 );
|
|
$tmp_data = $this->convertFromNameValueList( $this->result_data->entry_list[0] );
|
|
if ( is_array( $tmp_data ) ) {
|
|
//Debug::Arr($tmp_data, 'Tmp Data', __FILE__, __LINE__, __METHOD__, 10);
|
|
|
|
//Check for one field too
|
|
if ( count( array_keys( $tmp_data ) ) == 1 ) {
|
|
Debug::Text( 'Single field...', __FILE__, __LINE__, __METHOD__, 10 );
|
|
$key = key( $tmp_data );
|
|
$retarr = $tmp_data[$key];
|
|
}
|
|
}
|
|
|
|
//Debug::Arr($retarr, 'Handle Result Array: ', __FILE__, __LINE__, __METHOD__, 10);
|
|
|
|
if ( isset( $retarr ) ) {
|
|
return $retarr;
|
|
}
|
|
} else if ( $this->result_data->error->number == 0 && isset( $this->result_data->id ) ) {
|
|
//Saved record, just return the ID.
|
|
return $this->result_data->id;
|
|
}
|
|
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* Used by getResult()
|
|
* @param $result
|
|
* @param array $select_fields
|
|
* @param string $limit
|
|
* @return array|bool
|
|
*/
|
|
function handleResult( $result, $select_fields = [], $limit = '' ) {
|
|
if ( !is_array( $select_fields ) ) {
|
|
$select_fields = [ $select_fields ];
|
|
}
|
|
|
|
if ( $result->error->number == 0 && isset( $result->result_count ) && $result->result_count > 0 ) {
|
|
|
|
$retarr = [];
|
|
|
|
if ( is_array( $result->entry_list ) ) {
|
|
//Use getOne or getRow() if only one result is returned.
|
|
foreach ( $result->entry_list as $row ) {
|
|
//Debug::Arr($row, 'zSOAP Result Array: ', __FILE__, __LINE__, __METHOD__, 10);
|
|
$retarr[] = $this->convertFromNameValueList( $row );
|
|
}
|
|
}
|
|
//Debug::Arr($retarr, 'Handle Result Array: ', __FILE__, __LINE__, __METHOD__, 10);
|
|
|
|
if ( isset( $retarr ) ) {
|
|
return $retarr;
|
|
}
|
|
} else if ( $result->error->number == 0 && !isset( $result->result_count ) ) {
|
|
//Saving a record, Sugar returns just the ID and any error message?
|
|
if ( isset( $result->id ) ) {
|
|
return $result->id;
|
|
}
|
|
}
|
|
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* @param array $select_fields
|
|
* @param string $limit
|
|
* @return array|bool
|
|
*/
|
|
function getResult( $select_fields = [], $limit = '' ) {
|
|
if ( count( $select_fields ) == 0 ) {
|
|
$select_fields = $this->select_fields;
|
|
}
|
|
|
|
if ( $limit == '' ) {
|
|
$limit = $this->limit;
|
|
}
|
|
|
|
return $this->handleResult( $this->result_data, $select_fields, $limit );
|
|
}
|
|
|
|
}
|
|
|
|
?>
|