Merge pull request #14667 from hoegrammer/master
[civicrm-core.git] / api / v3 / examples / RelationshipType / Create.ex.php
CommitLineData
6a488035 1<?php
50fb255d 2/**
a828d7b8 3 * Test Generated example demonstrating the RelationshipType.create API.
50fb255d 4 *
50fb255d 5 * @return array
6 * API result array
7 */
8function relationship_type_create_example() {
cf8f0fff 9 $params = [
50fb255d 10 'name_a_b' => 'Relation 1 for relationship type create',
11 'name_b_a' => 'Relation 2 for relationship type create',
12 'contact_type_a' => 'Individual',
13 'contact_type_b' => 'Organization',
14 'is_reserved' => 1,
15 'is_active' => 1,
16 'sequential' => 1,
cf8f0fff 17 ];
6a488035 18
50fb255d 19 try{
a828d7b8 20 $result = civicrm_api3('RelationshipType', 'create', $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 [
1d8ee3d6 28 'is_error' => 1,
29 'error_message' => $errorMessage,
50fb255d 30 'error_code' => $errorCode,
31 'error_data' => $errorData,
cf8f0fff 32 ];
50fb255d 33 }
34
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 relationship_type_create_expectedresult() {
6a488035 45
cf8f0fff 46 $expectedResult = [
50fb255d 47 'is_error' => 0,
48 'version' => 3,
49 'count' => 1,
50 'id' => 1,
cf8f0fff
CW
51 'values' => [
52 '0' => [
50fb255d 53 'id' => '1',
54 'name_a_b' => 'Relation 1 for relationship type create',
55 'label_a_b' => 'Relation 1 for relationship type create',
56 'name_b_a' => 'Relation 2 for relationship type create',
57 'label_b_a' => 'Relation 2 for relationship type create',
58 'description' => '',
59 'contact_type_a' => 'Individual',
60 'contact_type_b' => 'Organization',
61 'contact_sub_type_a' => '',
62 'contact_sub_type_b' => '',
63 'is_reserved' => '1',
64 'is_active' => '1',
cf8f0fff
CW
65 ],
66 ],
67 ];
6a488035 68
fb32de45 69 return $expectedResult;
6a488035
TO
70}
71
a828d7b8 72/*
50fb255d 73* This example has been generated from the API test suite.
a828d7b8
CW
74* The test that created it is called "testRelationshipTypeCreate"
75* and can be found at:
69d79249 76* https://github.com/civicrm/civicrm-core/blob/master/tests/phpunit/api/v3/RelationshipTypeTest.php
6a488035
TO
77*
78* You can see the outcome of the API tests at
8390b11b 79* https://test.civicrm.org/job/CiviCRM-Core-Matrix/
6a488035
TO
80*
81* To Learn about the API read
8390b11b 82* https://docs.civicrm.org/dev/en/latest/api/
6a488035 83*
8390b11b
SL
84* Browse the API on your own site with the API Explorer. It is in the main
85* CiviCRM menu, under: Support > Development > API Explorer.
6a488035
TO
86*
87* Read more about testing here
8390b11b 88* https://docs.civicrm.org/dev/en/latest/testing/
6a488035
TO
89*
90* API Standards documentation:
8390b11b 91* https://docs.civicrm.org/dev/en/latest/framework/api-architecture/
b259a4ab 92*/