service/v3_1/SugarWebServiceUtilv3_1.php

Show:

inherited

Classes
- \SugarWebServiceUtilv3_1

Table of Contents

\SugarWebServiceUtilv3_1
jump to top

Package:

Parent(s): \SugarWebServiceUtilv3 < \SoapHelperWebServices
Children: \SugarWebServiceUtilv4

Methods

addFieldLevelACLs(
          String $module_name, String $view_type, String $view, array $metadata
          )
        
        :
          \unknown

Add ACL values to metadata files.

Parameters

Name	Type	Description
$module_name	String
$view_type	String	(wireless or detail)
$view	String	(list, detail,edit, etc)
$metadata	array	The metadata for the view type and view.

Returns

Type	Description
\unknown

add_create_account(
           $seed
          )
        
        :
          void

inherited

Inherited from: \SoapHelperWebServices::add_create_account()\SugarWebServiceUtilv3::add_create_account()

Parameters

Name	Type	Description
$seed

array_get_name_value_list(
           $array
          )
        
        :
          void

inherited

Inherited from: \SoapHelperWebServices::array_get_name_value_list()\SugarWebServiceUtilv3::array_get_name_value_list()

Parameters

Name	Type	Description
$array

array_get_name_value_lists(
           $array
          )
        
        :
          void

inherited

Inherited from: \SoapHelperWebServices::array_get_name_value_lists()\SugarWebServiceUtilv3::array_get_name_value_lists()

Parameters

Name	Type	Description
$array

array_get_return_value(
           $array,  $module
          )
        
        :
          void

inherited

Inherited from: \SoapHelperWebServices::array_get_return_value()\SugarWebServiceUtilv3::array_get_return_value()

Parameters

Name	Type	Description
$array
$module

checkACLAccess(
           $bean,  $viewType,  $errorObject,  $error_key
          )
        
        :
          void

inherited

Inherited from: \SoapHelperWebServices::checkACLAccess()\SugarWebServiceUtilv3::checkACLAccess()

Parameters

Name	Type	Description
$bean
$viewType
$errorObject
$error_key

checkModuleRoleAccess(
          string $module
          )
        
        :
          array

Check a module for acces to a set of available actions.

Parameters

Name	Type	Description
$module	string

Returns

Type	Description
array	results containing access and boolean indicating access

checkQuery(
           $errorObject,  $query,  $order_by
              =
              ''
          )
        
        :
          void

inherited

Inherited from: \SoapHelperWebServices::checkQuery()\SugarWebServiceUtilv3::checkQuery()

Parameters

Name	Type	Description
$errorObject
$query
$order_by

checkSaveOnNotify(
          
          )
        
        :
          void

inherited

Inherited from: \SoapHelperWebServices::checkSaveOnNotify()\SugarWebServiceUtilv3::checkSaveOnNotify()

checkSessionAndModuleAccess(
           $session,  $login_error_key,  $module_name,  $access_level,  $module_access_level_error_key,  $errorObject
          )
        
        :
          void

inherited

Inherited from: \SoapHelperWebServices::checkSessionAndModuleAccess()\SugarWebServiceUtilv3::checkSessionAndModuleAccess()

Parameters

Name	Type	Description
$session
$login_error_key
$module_name
$access_level
$module_access_level_error_key
$errorObject

check_for_duplicate_contacts(
           $seed
          )
        
        :
          void

inherited

Inherited from: \SoapHelperWebServices::check_for_duplicate_contacts()\SugarWebServiceUtilv3::check_for_duplicate_contacts()

Parameters

Name	Type	Description
$seed

check_modules_access(
           $user,  $module_name,  $action
              =
              'write'
          )
        
        :
          void

inherited

Inherited from: \SoapHelperWebServices::check_modules_access()\SugarWebServiceUtilv3::check_modules_access()

Parameters

Name	Type	Description
$user
$module_name
$action

cmp_datedue(
          array $a, array $b
          )
        
        :
          int

staticinherited

Sort the array for upcoming activities based on the date due flag ascending.

Inherited from: \SugarWebServiceUtilv3::cmp_datedue()

Parameters

Name	Type	Description
$a	array
$b	array

Returns

Type	Description
int	Indicates equality for date due flag

decrypt_string(
          \$string $string
          )
        
        :
          \a

inherited

decrypt a string use the TripleDES algorithm. This meant to be modified if the end user chooses a different algorithm

Inherited from: \SoapHelperWebServices::decrypt_string()\SugarWebServiceUtilv3::decrypt_string()

Parameters

Name	Type	Description
$string	\$string	the string to decrypt

Returns

Type	Description
\a	decrypted string if we can decrypt, the original string otherwise

filter_fields(
           $value,  $fields
          )
        
        :
          void

inherited

Inherited from: \SugarWebServiceUtilv3::filter_fields()

Parameters

Name	Type	Description
$value
$fields

format_upcoming_activities_entries(
          array $list, string $date_field
          )
        
        :
          array

inherited

Given a list of bean entries, format the expected response.

Inherited from: \SugarWebServiceUtilv3::format_upcoming_activities_entries()

Parameters

Name	Type	Description
$list	array	An array containing a bean list.
$date_field	string	Name of the field storing the date field we are examining

Returns

Type	Description
array	The results.

generateUnifiedSearchFields(
          string $moduleName
          )
        
        :
          array

Generate unifed search fields for a particular module even if the module does not participate in the unified search.

Parameters

Name	Type	Description
$moduleName	string

Returns

Type	Description
array	An array of fields to be searched against.

generateUpcomingActivitiesWhereClause(
           $seed,  $meta
          )
        
        :
          void

inherited

Inherited from: \SugarWebServiceUtilv3::generateUpcomingActivitiesWhereClause()

Parameters

Name	Type	Description
$seed
$meta

getFieldLevelACLValue(
          String $module, String $field,  $current_user
              =
              null
          )
        
        :
          int

Return the field level acl raw value. We cannot use the hasAccess call as we do not have a valid bean record at the moment and therefore can not specify the is_owner flag. We need the raw access value so we can do the computation on the client side. TODO: Move function into ACLField class.

Parameters

Name	Type	Description
$module	String	Name of the module
$field	String	Name of the field
$current_user

Returns

Type	Description
int

getModulesFromList(
          array $list, array $availModules
          )
        
        :
          void

Convert modules list to Web services result

Parameters

Name	Type	Description
$list	array	List of module candidates (only keys are used)
$availModules	array	List of module availability from Session

getRelationshipResults(
          String $bean, String $link_field_name, Array $link_module_fields, String $optional_where
              =
              '',  $order_by
              =
              ''
          )
        
        :
          Array

inherited

Fetch and array of related records

Inherited from: \SugarWebServiceUtilv3::getRelationshipResults()

Parameters

Name	Type	Description
$bean	String	-- Primary record
$link_field_name	String	-- The name of the relationship
$link_module_fields	Array	-- The keys of the array are the SugarBean attributes, the values of the array are the values the attributes should have.
$optional_where	String	-- IGNORED
$order_by

Returns

Type	Description
Array	'rows/fields_set_on_rows' -- The list of records and what fields were actually set for thos erecords

get_data_list(
           $seed,  $order_by
              =
              "",  $where
              =
              "",  $row_offset
              =
              0,  $limit
              =
              -1,  $max
              =
              -1,  $show_deleted
              =
              0,  $favorites
              =
              false,  $singleSelect
              =
              false
          )
        
        :
          void

Equivalent of get_list function within SugarBean but allows the possibility to pass in an indicator if the list should filter for favorites. Should eventually update the SugarBean function as well.

Parameters

Name	Type	Description
$seed
$order_by
$where
$row_offset
$limit
$max
$show_deleted
$favorites
$singleSelect

get_field_list(
           $value,  $fields,  $translate
              =
              true
          )
        
        :
          void

Parameters

Name	Type	Description
$value
$fields
$translate

get_file_contents_base64(
          string $filename, bool $remove
              =
              FALSE
          )
        
        :
          string

Return the contents of a file base64 encoded

Parameters

Name	Type	Description
$filename	string	Full path of filename
$remove	bool	Indicates if the file should be removed after the contents is retrieved.

Returns

Type	Description
string	- Contents base64'd.

get_module_view_defs(
           $module_name,  $type,  $view
          )
        
        :
          void

Parameters

Name	Type	Description
$module_name
$type
$view

get_name_value(
           $field,  $value
          )
        
        :
          void

inherited

Inherited from: \SugarWebServiceUtilv3::get_name_value()

Parameters

Name	Type	Description
$field
$value

get_name_value_list(
           $value
          )
        
        :
          void

inherited

Inherited from: \SoapHelperWebServices::get_name_value_list()\SugarWebServiceUtilv3::get_name_value_list()

Parameters

Name	Type	Description
$value

get_name_value_list_for_fields(
           $value,  $fields
          )
        
        :
          void

inherited

Inherited from: \SoapHelperWebServices::get_name_value_list_for_fields()\SugarWebServiceUtilv3::get_name_value_list_for_fields()

Parameters

Name	Type	Description
$value
$fields

get_report_value(
          \SavedReport $seed,  $select_fields
          )
        
        :
          array

inherited

Return the data from a report

Inherited from: \SoapHelperWebServices::get_report_value()\SugarWebServiceUtilv3::get_report_value()

Parameters

Name	Type	Description
$seed	\SavedReport
$select_fields

Returns

Type	Description
array	- output_list - the rows of the reports, field_list - the fields in the report.

get_return_module_fields(
           $value,  $module,  $fields,  $translate
              =
              true
          )
        
        :
          void

Parameters

Name	Type	Description
$value
$module
$fields
$translate

get_return_value(
           $value,  $module
          )
        
        :
          void

inherited

Inherited from: \SoapHelperWebServices::get_return_value()\SugarWebServiceUtilv3::get_return_value()

Parameters

Name	Type	Description
$value
$module

get_return_value_for_fields(
           $value,  $module,  $fields
          )
        
        :
          void

inherited

Inherited from: \SoapHelperWebServices::get_return_value_for_fields()\SugarWebServiceUtilv3::get_return_value_for_fields()

Parameters

Name	Type	Description
$value
$module
$fields

get_return_value_for_link_fields(
           $bean,  $module,  $link_name_to_value_fields_array
          )
        
        :
          void

inherited

Inherited from: \SoapHelperWebServices::get_return_value_for_link_fields()\SugarWebServiceUtilv3::get_return_value_for_link_fields()

Parameters

Name	Type	Description
$bean
$module
$link_name_to_value_fields_array

get_subpanel_defs(
           $module,  $type
          )
        
        :
          void

inherited

Inherited from: \SugarWebServiceUtilv3::get_subpanel_defs()

Parameters

Name	Type	Description
$module
$type

get_upcoming_activities(
          
          )
        
        :
          array

inherited

Retrieve all of the upcoming activities for a particular user.

Inherited from: \SugarWebServiceUtilv3::get_upcoming_activities()

Returns

Type	Description
array

get_user_module_list(
           $user
          )
        
        :
          void

inherited

Inherited from: \SoapHelperWebServices::get_user_module_list()\SugarWebServiceUtilv3::get_user_module_list()

Parameters

Name	Type	Description
$user

get_visible_mobile_modules(
          array $availModules
          )
        
        :
          array

Examine the wireless_module_registry to determine which modules have been enabled for the mobile view.

Parameters

Name	Type	Description
$availModules	array	An array of all the modules the user already has access to.

Returns

Type	Description
array	Modules enalbed for mobile view.

get_visible_modules(
          array $availModules
          )
        
        :
          array

Examine the application to determine which modules have been enabled..

Parameters

Name	Type	Description
$availModules	array	An array of all the modules the user already has access to.

Returns

Type	Description
array	Modules enabled within the application.

isLogLevelDebug(
          
          )
        
        :
          void

inherited

Inherited from: \SoapHelperWebServices::isLogLevelDebug()\SugarWebServiceUtilv3::isLogLevelDebug()

is_valid_ip_address(
          string $session_var
          )
        
        :
          bool

inherited

Use the same logic as in SugarAuthenticate to validate the ip address

Inherited from: \SoapHelperWebServices::is_valid_ip_address()\SugarWebServiceUtilv3::is_valid_ip_address()

Parameters

Name	Type	Description
$session_var	string

Returns

Type	Description
bool	- true if the ip address is valid, false otherwise.

login_success(
           $name_value_list
              =
              array()
          )
        
        :
          void

inherited

Inherited from: \SoapHelperWebServices::login_success()\SugarWebServiceUtilv3::login_success()

Parameters

Name	Type	Description
$name_value_list

metdataAclParserWirelessEdit(
          String $module_name, array $metadata
          )
        
        :
          array

Parse wireless detailview metadata and add ACL values.

Parameters

Name	Type	Description
$module_name	String
$metadata	array

Returns

Type	Description
array	Metadata with acls added

metdataAclParserWirelessList(
          String $module_name, array $metadata
          )
        
        :
          array

Parse wireless listview metadata and add ACL values.

Parameters

Name	Type	Description
$module_name	String
$metadata	array

Returns

Type	Description
array	Metadata with acls added

name_value_lists_get_array(
           $list
          )
        
        :
          void

inherited

Inherited from: \SoapHelperWebServices::name_value_lists_get_array()\SugarWebServiceUtilv3::name_value_lists_get_array()

Parameters

Name	Type	Description
$list

new_handle_set_entries(
           $module_name,  $name_value_lists,  $select_fields
              =
              FALSE
          )
        
        :
          void

inherited

Inherited from: \SoapHelperWebServices::new_handle_set_entries()\SugarWebServiceUtilv3::new_handle_set_entries()

Parameters

Name	Type	Description
$module_name
$name_value_lists
$select_fields

new_handle_set_relationship(
          String $module_name, String $module_id, String $link_field_name, Array $related_ids, Array $name_value_list, int $delete
          )
        
        :
          true

inherited

Inherited from: \SoapHelperWebServices::new_handle_set_relationship()\SugarWebServiceUtilv3::new_handle_set_relationship()

Parameters

Name	Type	Description
$module_name	String	-- The name of the module that the primary record is from. This name should be the name the module was developed under (changing a tab name is studio does not affect the name that should be passed into this method).
$module_id	String	-- The ID of the bean in the specified module
$link_field_name	String	The relationship name for which to create realtionships.
$related_ids	Array	-- The array of ids for which we want to create relationships
$name_value_list	Array	-- The array of name value pair of additional attributes to be set when adding this relationship
$delete	int	delete -- If 0 then add relationship else delete this relationship data

Returns

Type	Description
true	on success, false on failure

returnFieldsWithAccess(
          object $seed, array $select_fields
              =
              array()
          )
        
        :
          array

inherited

returnFieldsWithAccess

Inherited from: \SoapHelperWebServices::returnFieldsWithAccess()\SugarWebServiceUtilv3::returnFieldsWithAccess()

Parameters

Name	Type	Description
$seed	object	an instance of the bean we are checking acl's on
$select_fields	array	array of fields being explicitly checked for access, empty array means check all

Returns

Type	Description
array	Array of the fields for this bean that passed the acl filter test

setFaultObject(
           $errorObject
          )
        
        :
          void

inherited

Inherited from: \SoapHelperWebServices::setFaultObject()\SugarWebServiceUtilv3::setFaultObject()

Parameters

Name	Type	Description
$errorObject

trackView(
          \SugarBean $seed, string $current_view
          )
        
        :
          void

Track a view for a particular bean.

Parameters

Name	Type	Description
$seed	\SugarBean
$current_view	string

validate_authenticated(
          String $session_id
          )
        
        :
          truefalse

inherited

Validate the provided session information is correct and current. Load the session.

Inherited from: \SoapHelperWebServices::validate_authenticated()\SugarWebServiceUtilv3::validate_authenticated()

Parameters

Name	Type	Description
$session_id	String	-- The session ID that was returned by a call to login.

Returns

Type	Description
truefalse	-- If the session is valid and loaded.-- if the session is not valid.

validate_user(
          string $user_name, string $password
          )
        
        :
          truefalse

inherited

Validate the user session based on user name and password hash.

Inherited from: \SoapHelperWebServices::validate_user()\SugarWebServiceUtilv3::validate_user()

Parameters

Name	Type	Description
$user_name	string	-- The user name to create a session for
$password	string	-- The MD5 sum of the user's password

Returns

Type	Description
truefalse	-- If the session is created-- If the session is not created

service/v3_1/SugarWebServiceUtilv3_1.php

\SugarWebServiceUtilv3_1jump to top

Methods

\SugarWebServiceUtilv3_1
jump to top