Merge pull request #19280 from eileenmcnaughton/params
[civicrm-core.git] / xml / schema / Contact / RelationshipCache.xml
1 <?xml version="1.0" encoding="iso-8859-1" ?>
2
3 <table>
4 <base>CRM/Contact</base>
5 <class>RelationshipCache</class>
6 <name>civicrm_relationship_cache</name>
7 <comment>The cache permutes information from the relationship table to facilitate querying. Every relationship is mapped to multiple records in the cache. Joins should begin on the near side and extract info from the far side.</comment>
8 <add>5.29</add>
9 <log>false</log>
10 <icon>fa-handshake-o</icon>
11 <title>Related Contact</title>
12 <field>
13 <name>id</name>
14 <type>int unsigned</type>
15 <title>Relationship Cache ID</title>
16 <required>true</required>
17 <comment>Relationship Cache ID</comment>
18 <add>5.29</add>
19 </field>
20 <primaryKey>
21 <name>id</name>
22 <autoincrement>true</autoincrement>
23 </primaryKey>
24
25 <field>
26 <name>relationship_id</name>
27 <type>int unsigned</type>
28 <title>Relationship</title>
29 <required>true</required>
30 <comment>id of the relationship (FK to civicrm_relationship.id)</comment>
31 <add>5.29</add>
32 </field>
33 <foreignKey>
34 <name>relationship_id</name>
35 <table>civicrm_relationship</table>
36 <key>id</key>
37 <add>5.29</add>
38 <onDelete>CASCADE</onDelete>
39 </foreignKey>
40
41 <field>
42 <name>relationship_type_id</name>
43 <type>int unsigned</type>
44 <title>Relationship Type</title>
45 <required>true</required>
46 <comment>id of the relationship type</comment>
47 <add>5.29</add>
48 </field>
49 <foreignKey>
50 <name>relationship_type_id</name>
51 <table>civicrm_relationship_type</table>
52 <key>id</key>
53 <add>5.29</add>
54 <onDelete>CASCADE</onDelete>
55 </foreignKey>
56
57 <field>
58 <name>orientation</name>
59 <type>char</type>
60 <length>3</length>
61 <title>Orientation (a_b or b_a)</title>
62 <required>true</required>
63 <pseudoconstant>
64 <callback>CRM_Core_SelectValues::relationshipOrientation</callback>
65 </pseudoconstant>
66 <comment>The cache record is a permutation of the original relationship record. The orientation indicates whether it is forward (a_b) or reverse (b_a) relationship.</comment>
67 <add>5.29</add>
68 </field>
69
70 <field>
71 <name>near_contact_id</name>
72 <type>int unsigned</type>
73 <title>Contact ID (Near side)</title>
74 <required>true</required>
75 <comment>id of the first contact</comment>
76 <add>5.29</add>
77 <html>
78 <type>EntityRef</type>
79 </html>
80 </field>
81 <foreignKey>
82 <name>near_contact_id</name>
83 <table>civicrm_contact</table>
84 <key>id</key>
85 <add>5.29</add>
86 <onDelete>CASCADE</onDelete>
87 </foreignKey>
88
89 <field>
90 <name>near_relation</name>
91 <type>varchar</type>
92 <title>Relationship Name (to related contact)</title>
93 <length>64</length>
94 <comment>name for relationship of near_contact to far_contact.</comment>
95 <add>5.29</add>
96 <pseudoconstant>
97 <callback>CRM_Core_PseudoConstant::relationshipTypeOptions</callback>
98 </pseudoconstant>
99 </field>
100
101 <field>
102 <name>far_contact_id</name>
103 <type>int unsigned</type>
104 <title>Contact ID (Far side)</title>
105 <required>true</required>
106 <comment>id of the second contact</comment>
107 <add>5.29</add>
108 <html>
109 <type>EntityRef</type>
110 </html>
111 </field>
112 <foreignKey>
113 <name>far_contact_id</name>
114 <table>civicrm_contact</table>
115 <key>id</key>
116 <add>5.29</add>
117 <onDelete>CASCADE</onDelete>
118 </foreignKey>
119
120 <field>
121 <name>far_relation</name>
122 <type>varchar</type>
123 <title>Relationship Name (from related contact)</title>
124 <length>64</length>
125 <comment>name for relationship of far_contact to near_contact.</comment>
126 <add>5.29</add>
127 <pseudoconstant>
128 <callback>CRM_Core_PseudoConstant::relationshipTypeOptions</callback>
129 </pseudoconstant>
130 </field>
131
132 <index>
133 <name>UI_relationship</name>
134 <fieldName>relationship_id</fieldName>
135 <fieldName>orientation</fieldName>
136 <unique>true</unique>
137 <add>5.29</add>
138 </index>
139 <index>
140 <!-- Ex: select ... from contact inner join relcache on contact.id=relcache.near_contact_id and near_relation = 'Parent of' -->
141 <name>index_nearid_nearrelation</name>
142 <fieldName>near_contact_id</fieldName>
143 <fieldName>near_relation</fieldName>
144 <add>5.29</add>
145 </index>
146 <index>
147 <!-- Ex: select ... from contact inner join relcache on contact.id=relcache.near_contact_id and far_relation = 'Child of' -->
148 <name>index_nearid_farrelation</name>
149 <fieldName>near_contact_id</fieldName>
150 <fieldName>far_relation</fieldName>
151 <add>5.29</add>
152 </index>
153 <index>
154 <!-- Ex: select relation, count(*) from relcache group by near_relation -->
155 <name>index_near_relation</name>
156 <fieldName>near_relation</fieldName>
157 <add>5.29</add>
158 </index>
159
160 <!-- Passive mirror fields -->
161
162 <field>
163 <name>is_active</name>
164 <type>boolean</type>
165 <title>Relationship Is Active</title>
166 <default>1</default>
167 <comment>is the relationship active ?</comment>
168 <add>5.29</add>
169 <html>
170 <type>CheckBox</type>
171 </html>
172 </field>
173 <field>
174 <name>start_date</name>
175 <uniqueName>relationship_start_date</uniqueName>
176 <type>date</type>
177 <title>Relationship Start Date</title>
178 <comment>date when the relationship started</comment>
179 <add>5.29</add>
180 <html>
181 <type>Select Date</type>
182 <formatType>activityDate</formatType>
183 </html>
184 </field>
185 <field>
186 <name>end_date</name>
187 <uniqueName>relationship_end_date</uniqueName>
188 <type>date</type>
189 <title>Relationship End Date</title>
190 <comment>date when the relationship ended</comment>
191 <add>5.29</add>
192 <html>
193 <type>Select Date</type>
194 <formatType>activityDate</formatType>
195 </html>
196 </field>
197 </table>