remove print icon
[civicrm-core.git] / api / v3 / examples / OptionValue / SortOption.ex.php
CommitLineData
6a488035 1<?php
50fb255d 2/**
a828d7b8 3 * Test Generated example demonstrating the OptionValue.getsingle API.
50fb255d 4 *
5c49fee0 5 * Demonstrates use of Sort param (available in many api functions). Also, getsingle.
50fb255d 6 *
7 * @return array
8 * API result array
9 */
10function option_value_getsingle_example() {
cf8f0fff 11 $params = [
50fb255d 12 'option_group_id' => 1,
cf8f0fff 13 'options' => [
6a488035
TO
14 'sort' => 'label DESC',
15 'limit' => 1,
cf8f0fff
CW
16 ],
17 ];
6a488035 18
50fb255d 19 try{
a828d7b8 20 $result = civicrm_api3('OptionValue', 'getsingle', $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();
cf8f0fff 27 return [
5be22f39 28 'is_error' => 1,
29 'error_message' => $errorMessage,
50fb255d 30 'error_code' => $errorCode,
31 'error_data' => $errorData,
cf8f0fff 32 ];
50fb255d 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 option_value_getsingle_expectedresult() {
6a488035 45
cf8f0fff 46 $expectedResult = [
50fb255d 47 'id' => '4',
48 'option_group_id' => '1',
49 'label' => 'SMS',
50 'value' => '4',
5be22f39 51 'name' => 'SMS',
50fb255d 52 'filter' => 0,
53 'weight' => '4',
54 'is_optgroup' => 0,
55 'is_reserved' => 0,
56 'is_active' => '1',
cf8f0fff 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 "testGetSingleValueOptionValueSort"
65* and can be found at:
69d79249 66* https://github.com/civicrm/civicrm-core/blob/master/tests/phpunit/api/v3/OptionValueTest.php
6a488035
TO
67*
68* You can see the outcome of the API tests at
8390b11b 69* https://test.civicrm.org/job/CiviCRM-Core-Matrix/
6a488035
TO
70*
71* To Learn about the API read
8390b11b 72* https://docs.civicrm.org/dev/en/latest/api/
6a488035 73*
8390b11b
SL
74* Browse the API on your own site with the API Explorer. It is in the main
75* CiviCRM menu, under: Support > Development > API Explorer.
6a488035
TO
76*
77* Read more about testing here
8390b11b 78* https://docs.civicrm.org/dev/en/latest/testing/
6a488035
TO
79*
80* API Standards documentation:
8390b11b 81* https://docs.civicrm.org/dev/en/latest/framework/api-architecture/
89ab5601 82*/