Contacts Class Reference

Inheritance diagram for Contacts:

Collaboration diagram for Contacts:

Public Member Functions
	__construct ()
	Constructor.
	get ($id, $includecount=0, $includeroles=0)
	Get properties of a contact object.
	getByEmail ($email, $includecount=0, $includeroles=0)
	Get properties of a contact object by Email.
	index ($sortfield="t.rowid", $sortorder='ASC', $limit=100, $page=0, $thirdparty_ids='', $category=0, $sqlfilters='', $includecount=0, $includeroles=0, $properties='')
	List contacts.
	post ($request_data=null)
	Create contact object.
	put ($id, $request_data=null)
	Update contact.
	delete ($id)
	Delete contact.
	createUser ($id, $request_data=null)
	Create an user account object from contact (external user)
	getCategories ($id, $sortfield="s.rowid", $sortorder='ASC', $limit=0, $page=0)
	Get categories for a contact.
	addCategory ($id, $category_id)
	Add a category to a contact.
	deleteCategory ($id, $category_id)
	Remove the link between a category and a contact.
Public Member Functions inherited from DolibarrApi
	__construct ($db, $cachedir='', $refreshCache=false)
	Constructor.

Protected Member Functions
	_cleanObjectDatas ($object)
	Clean sensible object datas.
Protected Member Functions inherited from DolibarrApi
	_checkValForAPI ($field, $value, $object)
	Check and convert a string depending on its type/name.
	_filterObjectProperties ($object, $properties)
	Filter properties that will be returned on object.
	_checkFilters ($sqlfilters, &$error='')
	Return if a $sqlfilters parameter is valid Function no more used.

Private Member Functions
	_validate ($data)
	Validate fields before create or update object.

Additional Inherited Members
Static Protected Member Functions inherited from DolibarrApi
static	_checkAccessToResource ($resource, $resource_id=0, $dbtablename='', $feature2='', $dbt_keyfield='fk_soc', $dbt_select='rowid')
	Check access by user to a given resource.
static	_forge_criteria_callback ($matches)
	Function to forge a SQL criteria from a Generic filter string.

Detailed Description

Definition at line 31 of file api_contacts.class.php.

Member Function Documentation

_cleanObjectDatas()

Contacts::_cleanObjectDatas ( $object )

protected

Clean sensible object datas.

Parameters

Object

$object

Object to clean

Returns

Object Object with cleaned properties

Reimplemented from DolibarrApi.

Definition at line 566 of file api_contacts.class.php.

Referenced by addCategory(), deleteCategory(), get(), getByEmail(), and index().

_validate()

Contacts::_validate ( $data )

private

Validate fields before create or update object.

Parameters

array | null

$data

Data to validate

Returns

array

Exceptions

RestException

Definition at line 591 of file api_contacts.class.php.

Referenced by post().

addCategory()

Contacts::addCategory	(		$id,
			$category_id )

Add a category to a contact.

@url PUT {id}/categories/{category_id}

Parameters

int	$id	Id of contact
int	$category_id	Id of category

Returns

mixed

Exceptions

RestException	401 Insufficient rights
RestException	404 Category or contact not found

Definition at line 491 of file api_contacts.class.php.

References DolibarrApi\_checkAccessToResource(), and _cleanObjectDatas().

createUser()

Contacts::createUser	(		$id,
			$request_data = null )

Create an user account object from contact (external user)

Parameters

int	$id	Id of contact
array	$request_data	Request datas

Returns

int ID of user

@url POST {id}/createUser

Definition at line 404 of file api_contacts.class.php.

References DolibarrApi\_checkAccessToResource(), and Contact().

delete()

Contacts::delete

(

$id

)

Delete contact.

Parameters

int

$id

Contact ID

Returns

integer

Definition at line 378 of file api_contacts.class.php.

References DolibarrApi\_checkAccessToResource().

deleteCategory()

Contacts::deleteCategory	(		$id,
			$category_id )

Remove the link between a category and a contact.

@url DELETE {id}/categories/{category_id}

Parameters

int	$id	Id of contact
int	$category_id	Id of category

Returns

mixed

Exceptions

RestException	401 Insufficient rights
RestException	404 Category or contact not found

Definition at line 531 of file api_contacts.class.php.

References DolibarrApi\_checkAccessToResource(), and _cleanObjectDatas().

get()

Contacts::get	(		$id,
			$includecount = 0,
			$includeroles = 0 )

Get properties of a contact object.

Return an array with contact informations

Parameters

int	$id	ID of contact
int	$includecount	Count and return also number of elements the contact is used as a link for
int	$includeroles	Includes roles of the contact

Returns

object data without useless information

Exceptions

RestException

Definition at line 72 of file api_contacts.class.php.

References DolibarrApi\_checkAccessToResource(), and _cleanObjectDatas().

getByEmail()

Contacts::getByEmail	(		$email,
			$includecount = 0,
			$includeroles = 0 )

Get properties of a contact object by Email.

Parameters

string	$email	Email of contact
int	$includecount	Count and return also number of elements the contact is used as a link for
int	$includeroles	Includes roles of the contact

Returns

array|mixed data without useless information

@url GET email/{email}

Exceptions

RestException	401 Insufficient rights
RestException	404 User or group not found

Definition at line 120 of file api_contacts.class.php.

References DolibarrApi\_checkAccessToResource(), and _cleanObjectDatas().

getCategories()

Contacts::getCategories	(		$id,
			$sortfield = "s.rowid",
			$sortorder = 'ASC',
			$limit = 0,
			$page = 0 )

Get categories for a contact.

Parameters

int	$id	ID of contact
string	$sortfield	Sort field
string	$sortorder	Sort order
int	$limit	Limit for list
int	$page	Page number

Returns

mixed

@url GET {id}/categories

Definition at line 461 of file api_contacts.class.php.

index()

Contacts::index	(		$sortfield = "t.rowid",
			$sortorder = 'ASC',
			$limit = 100,
			$page = 0,
			$thirdparty_ids = '',
			$category = 0,
			$sqlfilters = '',
			$includecount = 0,
			$includeroles = 0,
			$properties = '' )

List contacts.

Get a list of contacts

Parameters

string	$sortfield	Sort field
string	$sortorder	Sort order
int	$limit	Limit for list
int	$page	Page number
string	$thirdparty_ids	Thirdparty ids to filter contacts of (example '1' or '1,2,3') {@pattern /^[0-9,]*$/i}
int	$category	Use this param to filter list by category
string	$sqlfilters	Other criteria to filter answers separated by a comma. Syntax example "(t.ref:like:'SO-%') and (t.date_creation:<:'20160101')"
int	$includecount	Count and return also number of elements the contact is used as a link for
int	$includeroles	Includes roles of the contact
string	$properties	Restrict the data returned to theses properties. Ignored if empty. Comma separated list of properties names

Returns

array Array of contact objects

Exceptions

RestException

Definition at line 174 of file api_contacts.class.php.

References _cleanObjectDatas(), DolibarrApi\_filterObjectProperties(), Contact(), and forgeSQLFromUniversalSearchCriteria().

post()

Contacts::post

(

$request_data = null

)

Create contact object.

Parameters

array

$request_data

Request datas

Returns

int ID of contact

Definition at line 285 of file api_contacts.class.php.

References DolibarrApi\_checkValForAPI(), and _validate().

put()

Contacts::put	(		$id,
			$request_data = null )

Update contact.

Parameters

int	$id	Id of contact to update
array	$request_data	Datas

Returns

object Representation of the Contact

Exceptions

RestException	401
RestException	404
RestException	500

Definition at line 327 of file api_contacts.class.php.

References DolibarrApi\_checkAccessToResource(), and DolibarrApi\_checkValForAPI().

---

The documentation for this class was generated from the following file:

• dolibarr_19.0/htdocs/societe/class/api_contacts.class.php