Merge remote-tracking branch 'upstream/4.5' into 4.5-master-2015-02-09-11-44-07
[civicrm-core.git] / api / v3 / examples / Contact / GetActions.php
1 <?php
2 /**
3 * Test Generated example of using contact getactions API.
4 *
5 * Getting the available actions for an entity.
6 *
7 * @return array
8 * API result array
9 */
10 function contact_getactions_example() {
11 $params = array();
12
13 try{
14 $result = civicrm_api3('contact', 'getactions', $params);
15 }
16 catch (CiviCRM_API3_Exception $e) {
17 // Handle error here.
18 $errorMessage = $e->getMessage();
19 $errorCode = $e->getErrorCode();
20 $errorData = $e->getExtraParams();
21 return array(
22 'error' => $errorMessage,
23 'error_code' => $errorCode,
24 'error_data' => $errorData,
25 );
26 }
27
28 return $result;
29 }
30
31 /**
32 * Function returns array of result expected from previous function.
33 *
34 * @return array
35 * API result array
36 */
37 function contact_getactions_expectedresult() {
38
39 $expectedResult = array(
40 'is_error' => 0,
41 'version' => 3,
42 'count' => 17,
43 'values' => array(
44 '0' => 'create',
45 '1' => 'delete',
46 '2' => 'get',
47 '3' => 'getactions',
48 '4' => 'getcount',
49 '5' => 'getfields',
50 '6' => 'getlist',
51 '7' => 'getoptions',
52 '8' => 'getquick',
53 '9' => 'getrefcount',
54 '10' => 'getsingle',
55 '11' => 'getvalue',
56 '12' => 'merge',
57 '13' => 'proximity',
58 '14' => 'replace',
59 '15' => 'setvalue',
60 '16' => 'update',
61 ),
62 'deprecated' => array(
63 'getquick' => 'The "getquick" action is deprecated in favor of "getlist".',
64 'update' => 'The "update" action is deprecated. Use "create" with an id instead.',
65 ),
66 );
67
68 return $expectedResult;
69 }
70
71 /**
72 * This example has been generated from the API test suite.
73 * The test that created it is called
74 * testGetActions
75 * and can be found in
76 * https://github.com/civicrm/civicrm-core/blob/master/tests/phpunit/api/v3/ContactTest.php
77 *
78 * You can see the outcome of the API tests at
79 * https://test.civicrm.org/job/CiviCRM-master-git/
80 *
81 * To Learn about the API read
82 * http://wiki.civicrm.org/confluence/display/CRMDOC/Using+the+API
83 *
84 * Browse the api on your own site with the api explorer
85 * http://MYSITE.ORG/path/to/civicrm/api
86 *
87 * Read more about testing here
88 * http://wiki.civicrm.org/confluence/display/CRM/Testing
89 *
90 * API Standards documentation:
91 * http://wiki.civicrm.org/confluence/display/CRM/API+Architecture+Standards
92 */