adamjakab / SuiteCRM

service/core/REST/SugarRestRSS.php

Doc Comments +3 added lines

@@ -64,6 +64,9 @@
 		$this->generateResponseFooter();
 	} // fn
 
+	/**
+	 * @param integer $count
+	 */
 	protected function generateResponseHeader($count)
 	{
 	    global $app_strings, $sugar_version, $sugar_flavor;

service/core/SoapHelperWebService.php

Doc Comments +19 added lines, -5 removed lines

@@ -154,8 +154,8 @@ 
  *
  * @param string $user_name -- The user name to create a session for
  * @param string $password -- The MD5 sum of the user's password
- * @return true -- If the session is created
- * @return false -- If the session is not created
+ * @return boolean|null -- If the session is created
+ * @return boolean|null -- If the session is not created
  */
 function validate_user($user_name, $password){
 	$GLOBALS['log']->info('Begin: SoapHelperWebServices->validate_user');
@@ -193,8 +193,8 @@ 
 	 * Validate the provided session information is correct and current.  Load the session.
 	 *
 	 * @param String $session_id -- The session ID that was returned by a call to login.
-	 * @return true -- If the session is valid and loaded.
-	 * @return false -- if the session is not valid.
+	 * @return boolean -- If the session is valid and loaded.
+	 * @return boolean -- if the session is not valid.
 	 */
 	function validate_authenticated($session_id){
 		$GLOBALS['log']->info('Begin: SoapHelperWebServices->validate_authenticated');
@@ -303,6 +303,11 @@ 
 		return true;
 	} // fn
 
+	/**
+	 * @param string $viewType
+	 * @param SoapError $errorObject
+	 * @param string $error_key
+	 */
 	function checkACLAccess($bean, $viewType, $errorObject, $error_key) {
 		$GLOBALS['log']->info('Begin: SoapHelperWebServices->checkACLAccess');
 		if(!$bean->ACLAccess($viewType)) {
@@ -316,6 +321,9 @@ 
 		return true;
 	} // fn
 
+	/**
+	 * @param SoapError $errorObject
+	 */
 	function checkQuery($errorObject, $query, $order_by = '')
     {
         require_once 'include/SugarSQLValidate.php';
@@ -695,7 +703,7 @@ 
 	 * @param Array $related_ids -- The array of ids for which we want to create relationships
 	 * @param Array $name_value_list -- The array of name value pair of additional attributes to be set when adding this relationship
 	 * @param int delete -- If 0 then add relationship else delete this relationship data
-	 * @return true on success, false on failure
+	 * @return boolean on success, false on failure
 	 */
 	function new_handle_set_relationship($module_name, $module_id, $link_field_name, $related_ids, $name_value_list, $delete) {
 		$GLOBALS['log']->info('Begin: SoapHelperWebServices->new_handle_set_relationship');
@@ -743,6 +751,9 @@ 
 		}
 	}
 
+	/**
+	 * @param string $module_name
+	 */
 	function new_handle_set_entries($module_name, $name_value_lists, $select_fields = FALSE) {
 		$GLOBALS['log']->info('Begin: SoapHelperWebServices->new_handle_set_entries');
 		global $beanList, $beanFiles, $current_user, $app_list_strings;
@@ -907,6 +918,9 @@ 
 	}
 
 
+	/**
+	 * @param string $module
+	 */
 	function get_return_module_fields($value, $module,$fields, $translate=true){
 		$GLOBALS['log']->info('Begin: SoapHelperWebServices->get_return_module_fields');
 		global $module_name;

service/core/SugarRestService.php

Doc Comments -1 removed lines

@@ -177,7 +177,6 @@
 	 * This function registers implementation class name and creates an instance of rest implementation class
 	 * it will be made on this class object
 	 *
-	 * @param String $implementationClass
 	 * @access public
 	 */
 	function registerImplClass($className){

service/core/SugarWebServiceImpl.php

Doc Comments +1 added lines, -1 removed lines

@@ -73,7 +73,7 @@
  *
  * @param String $session -- Session ID returned by a previous call to login.
  * @param String $module_name -- The name of the module to return records 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)..
- * @param Array $ids -- An array of SugarBean IDs.
+ * @param string[] $ids -- An array of SugarBean IDs.
  * @param Array $select_fields -- A list of the fields to be included in the results. This optional parameter allows for only needed fields to be retrieved.
 * @param Array $link_name_to_fields_array -- A list of link_names and for each link_name, what fields value to be returned. For ex.'link_name_to_fields_array' => array(array('name' =>  'email_addresses', 'value' => array('id', 'email_address', 'opt_out', 'primary_address')))
 * @return Array

service/v3/SugarWebServiceImplv3.php

Doc Comments +1 added lines, -1 removed lines

@@ -309,7 +309,7 @@
      * Retrieve a list of recently viewed records by module.
      *
      * @param String $session -- Session ID returned by a previous call to login.
-     * @param String $modules -- An array of modules or 'Home' to indicate all.
+     * @param String $module_names -- An array of modules or 'Home' to indicate all.
      * @return Array The recently viewed records
      * @exception 'SoapFault' -- The SOAP error, if any
      */

service/v3_1/SugarWebServiceImplv3_1.php

Doc Comments +2 added lines, -2 removed lines

@@ -61,7 +61,7 @@ 
     * @param String $id -- The SugarBean's ID value.
     * @param Array  $select_fields -- A list of the fields to be included in the results. This optional parameter allows for only needed fields to be retrieved.
     * @param Array $link_name_to_fields_array -- A list of link_names and for each link_name, what fields value to be returned. For ex.'link_name_to_fields_array' => array(array('name' =>  'email_addresses', 'value' => array('id', 'email_address', 'opt_out', 'primary_address')))
-    * @param bool $trackView -- Should we track the record accessed.
+    * @param bool $track_view -- Should we track the record accessed.
     * @return Array
     *        'entry_list' -- Array - The records name value pair for the simple data types excluding link field data.
     *	     'relationship_list' -- Array - The records link field data. The example is if asked about accounts email address then return data would look like Array ( [0] => Array ( [name] => email_addresses [records] => Array ( [0] => Array ( [0] => Array ( [name] => id [value] => 3fb16797-8d90-0a94-ac12-490b63a6be67 ) [1] => Array ( [name] => email_address [value] => hr.kid.qa@example.com ) [2] => Array ( [name] => opt_out [value] => 0 ) [3] => Array ( [name] => primary_address [value] => 1 ) ) [1] => Array ( [0] => Array ( [name] => id [value] => 403f8da1-214b-6a88-9cef-490b63d43566 ) [1] => Array ( [name] => email_address [value] => kid.hr@example.name ) [2] => Array ( [name] => opt_out [value] => 0 ) [3] => Array ( [name] => primary_address [value] => 0 ) ) ) ) )
@@ -125,7 +125,7 @@ 
     * @param Array $ids -- An array of SugarBean IDs.
     * @param Array $select_fields -- A list of the fields to be included in the results. This optional parameter allows for only needed fields to be retrieved.
     * @param Array $link_name_to_fields_array -- A list of link_names and for each link_name, what fields value to be returned. For ex.'link_name_to_fields_array' => array(array('name' =>  'email_addresses', 'value' => array('id', 'email_address', 'opt_out', 'primary_address')))
-    * @param bool $trackView -- Should we track the record accessed.
+    * @param bool $track_view -- Should we track the record accessed.
     * @return Array
     *        'entry_list' -- Array - The records name value pair for the simple data types excluding link field data.
     *	     'relationship_list' -- Array - The records link field data. The example is if asked about accounts email address then return data would look like Array ( [0] => Array ( [name] => email_addresses [records] => Array ( [0] => Array ( [0] => Array ( [name] => id [value] => 3fb16797-8d90-0a94-ac12-490b63a6be67 ) [1] => Array ( [name] => email_address [value] => hr.kid.qa@example.com ) [2] => Array ( [name] => opt_out [value] => 0 ) [3] => Array ( [name] => primary_address [value] => 1 ) ) [1] => Array ( [0] => Array ( [name] => id [value] => 403f8da1-214b-6a88-9cef-490b63d43566 ) [1] => Array ( [name] => email_address [value] => kid.hr@example.name ) [2] => Array ( [name] => opt_out [value] => 0 ) [3] => Array ( [name] => primary_address [value] => 0 ) ) ) ) )

service/v4/SugarWebServiceUtilv4.php

Doc Comments +7 added lines, -1 removed lines

@@ -143,7 +143,7 @@ 
 	/**
 	 * Processes the filter_fields attribute to use with SugarBean::create_new_list_query()
 	 *
-	 * @param object $value SugarBean
+	 * @param SugarBean $value SugarBean
 	 * @param array $fields
 	 * @return array
 	 */
@@ -454,6 +454,12 @@ 
 	}
 
 
+    /**
+     * @param string $login_error_key
+     * @param string $access_level
+     * @param string $module_access_level_error_key
+     * @param SoapError $errorObject
+     */
     function checkSessionAndModuleAccess($session, $login_error_key, $module_name, $access_level, $module_access_level_error_key, $errorObject)
     {
           if(isset($_REQUEST['oauth_token'])) {

service/v4_1/SugarWebServiceImplv4_1.php

Doc Comments +1 added lines, -1 removed lines

@@ -75,7 +75,7 @@
      * @param Array $related_module_link_name_to_fields_array - For every related bean returrned, specify link fields name to fields info for that bean to be returned. For ex.'link_name_to_fields_array' => array(array('name' =>  'email_addresses', 'value' => array('id', 'email_address', 'opt_out', 'primary_address'))).
      * @param Number $deleted -- false if deleted records should not be include, true if deleted records should be included.
      * @param String $order_by -- field to order the result sets by
-     * @param Number $offset -- where to start in the return
+     * @param integer $offset -- where to start in the return
      * @param Number $limit -- number of results to return (defaults to all)
      * @return Array 'entry_list' -- Array - The records that were retrieved
      *               'relationship_list' -- Array - The records link field data. The example is if asked about accounts contacts email address then return data would look like Array ( [0] => Array ( [name] => email_addresses [records] => Array ( [0] => Array ( [0] => Array ( [name] => id [value] => 3fb16797-8d90-0a94-ac12-490b63a6be67 ) [1] => Array ( [name] => email_address [value] => hr.kid.qa@example.com ) [2] => Array ( [name] => opt_out [value] => 0 ) [3] => Array ( [name] => primary_address [value] => 1 ) ) [1] => Array ( [0] => Array ( [name] => id [value] => 403f8da1-214b-6a88-9cef-490b63d43566 ) [1] => Array ( [name] => email_address [value] => kid.hr@example.name ) [2] => Array ( [name] => opt_out [value] => 0 ) [3] => Array ( [name] => primary_address [value] => 0 ) ) ) ) )

service/v4_1/SugarWebServiceUtilv4_1.php

Doc Comments +4 added lines, -4 removed lines

@@ -45,8 +45,8 @@ 
    	 * Validate the provided session information is correct and current.  Load the session.
    	 *
    	 * @param String $session_id -- The session ID that was returned by a call to login.
-   	 * @return true -- If the session is valid and loaded.
-   	 * @return false -- if the session is not valid.
+   	 * @return boolean -- If the session is valid and loaded.
+   	 * @return boolean -- if the session is not valid.
    	 */
    	function validate_authenticated($session_id)
     {
@@ -103,12 +103,12 @@ 
      * getRelationshipResults
      * Returns the
      *
-     * @param Mixed $bean The SugarBean instance to retrieve relationships from
+     * @param SugarBean $bean The SugarBean instance to retrieve relationships from
      * @param String $link_field_name The name of the relationship entry to fetch relationships for
      * @param Array $link_module_fields Array of fields of relationship entries to return
      * @param string $optional_where String containing an optional WHERE select clause
      * @param string $order_by String containing field to order results by
-     * @param Number $offset -- where to start in the return (defaults to 0)
+     * @param integer $offset -- where to start in the return (defaults to 0)
      * @param Number $limit -- number of results to return (defaults to all)
      * @return array|bool Returns an Array of relationship results; false if relationship could not be retrieved
      */