Merge pull request #9769 from scardinius/crm-19958
[civicrm-core.git] / api / v3 / examples / Tag / GetReturnArray.php
CommitLineData
6a488035 1<?php
50fb255d 2/**
a828d7b8 3 * Test Generated example demonstrating the Tag.get API.
50fb255d 4 *
5c49fee0 5 * Demonstrates use of Return as an array.
50fb255d 6 *
7 * @return array
8 * API result array
9 */
10function tag_get_example() {
11 $params = array(
12 'id' => '8',
13 'name' => 'New Tag3',
14 'return' => array(
6a488035
TO
15 '0' => 'name',
16 ),
50fb255d 17 );
6a488035 18
50fb255d 19 try{
a828d7b8 20 $result = civicrm_api3('Tag', 'get', $params);
50fb255d 21 }
22 catch (CiviCRM_API3_Exception $e) {
23 // Handle error here.
24 $errorMessage = $e->getMessage();
25 $errorCode = $e->getErrorCode();
26 $errorData = $e->getExtraParams();
27 return array(
1d8ee3d6 28 'is_error' => 1,
29 'error_message' => $errorMessage,
50fb255d 30 'error_code' => $errorCode,
31 'error_data' => $errorData,
32 );
33 }
6a488035 34
50fb255d 35 return $result;
6a488035
TO
36}
37
fb32de45 38/**
50fb255d 39 * Function returns array of result expected from previous function.
40 *
41 * @return array
42 * API result array
6a488035 43 */
50fb255d 44function tag_get_expectedresult() {
6a488035 45
ee600d6f 46 $expectedResult = array(
50fb255d 47 'is_error' => 0,
48 'version' => 3,
49 'count' => 1,
50 'id' => 8,
51 'values' => array(
fb32de45 52 '8' => array(
50fb255d 53 'id' => '8',
54 'name' => 'New Tag3',
55 ),
6a488035 56 ),
50fb255d 57 );
6a488035 58
fb32de45 59 return $expectedResult;
6a488035
TO
60}
61
a828d7b8 62/*
50fb255d 63* This example has been generated from the API test suite.
a828d7b8
CW
64* The test that created it is called "testGetReturnArray"
65* and can be found at:
69d79249 66* https://github.com/civicrm/civicrm-core/blob/master/tests/phpunit/api/v3/TagTest.php
6a488035
TO
67*
68* You can see the outcome of the API tests at
69d79249 69* https://test.civicrm.org/job/CiviCRM-master-git/
6a488035
TO
70*
71* To Learn about the API read
69d79249 72* http://wiki.civicrm.org/confluence/display/CRMDOC/Using+the+API
6a488035 73*
69d79249 74* Browse the api on your own site with the api explorer
41d4d31f 75* http://MYSITE.ORG/path/to/civicrm/api
6a488035
TO
76*
77* Read more about testing here
78* http://wiki.civicrm.org/confluence/display/CRM/Testing
79*
80* API Standards documentation:
81* http://wiki.civicrm.org/confluence/display/CRM/API+Architecture+Standards
b259a4ab 82*/