3be81314907cca0e95133af84d6de3e67ebe6b33
[civicrm-core.git] / xml / schema / Member / Membership.xml
1 <?xml version="1.0" encoding="iso-8859-1" ?>
2
3 <table>
4 <base>CRM/Member</base>
5 <class>Membership</class>
6 <name>civicrm_membership</name>
7 <comment>Contact Membership records.</comment>
8 <add>1.5</add>
9 <log>true</log>
10 <field>
11 <name>id</name>
12 <uniqueName>membership_id</uniqueName>
13 <type>int unsigned</type>
14 <required>true</required>
15 <import>true</import>
16 <title>Membership ID</title>
17 <headerPattern>/^(m(embership\s)?id)$/i</headerPattern>
18 <comment>Membership Id</comment>
19 <add>1.5</add>
20 </field>
21 <primaryKey>
22 <name>id</name>
23 <autoincrement>true</autoincrement>
24 </primaryKey>
25
26 <field>
27 <name>contact_id</name>
28 <uniqueName>membership_contact_id</uniqueName>
29 <type>int unsigned</type>
30 <required>true</required>
31 <title>Contact ID</title>
32 <headerPattern>/contact(.?id)?/i</headerPattern>
33 <dataPattern>/^\d+$/</dataPattern>
34 <import>true</import>
35 <comment>FK to Contact ID</comment>
36 <add>1.5</add>
37 <html>
38 <type>EntityRef</type>
39 </html>
40 </field>
41 <foreignKey>
42 <name>contact_id</name>
43 <table>civicrm_contact</table>
44 <key>id</key>
45 <add>1.5</add>
46 <onDelete>CASCADE</onDelete>
47 </foreignKey>
48 <field>
49 <name>membership_type_id</name>
50 <type>int unsigned</type>
51 <title>Membership Type Id</title>
52 <import>true</import>
53 <headerPattern>/^(m(embership\s)?type)$/i</headerPattern>
54 <export>false</export>
55 <required>true</required>
56 <comment>FK to Membership Type</comment>
57 <pseudoconstant>
58 <table>civicrm_membership_type</table>
59 <keyColumn>id</keyColumn>
60 <labelColumn>name</labelColumn>
61 </pseudoconstant>
62 <html>
63 <type>Select</type>
64 </html>
65 <add>1.5</add>
66 </field>
67 <foreignKey>
68 <name>membership_type_id</name>
69 <table>civicrm_membership_type</table>
70 <key>id</key>
71 <add>1.5</add>
72 <onDelete>CASCADE</onDelete>
73 </foreignKey>
74 <field>
75 <name>join_date</name>
76 <title>Member Since</title>
77 <type>date</type>
78 <import>true</import>
79 <headerPattern>/^join|(j(oin\s)?date)$/i</headerPattern>
80 <dataPattern>/\d{4}-?\d{2}-?\d{2}/</dataPattern>
81 <comment>Beginning of initial membership period (member since...).</comment>
82 <add>1.5</add>
83 <html>
84 <type>Select Date</type>
85 <formatType>activityDate</formatType>
86 </html>
87 </field>
88 <field>
89 <name>start_date</name>
90 <uniqueName>membership_start_date</uniqueName>
91 <title>Membership Start Date</title>
92 <type>date</type>
93 <import>true</import>
94 <headerPattern>/(member(ship)?.)?start(s)?(.date$)?/i</headerPattern>
95 <dataPattern>/\d{4}-?\d{2}-?\d{2}/</dataPattern>
96 <comment>Beginning of current uninterrupted membership period.</comment>
97 <add>1.5</add>
98 <html>
99 <type>Select Date</type>
100 <formatType>activityDate</formatType>
101 </html>
102 </field>
103 <field>
104 <name>end_date</name>
105 <uniqueName>membership_end_date</uniqueName>
106 <title>Membership Expiration Date</title>
107 <type>date</type>
108 <import>true</import>
109 <headerPattern>/(member(ship)?.)?end(s)?(.date$)?/i</headerPattern>
110 <dataPattern>/\d{4}-?\d{2}-?\d{2}/</dataPattern>
111 <comment>Current membership period expire date.</comment>
112 <add>1.5</add>
113 <html>
114 <type>Select Date</type>
115 <formatType>activityDate</formatType>
116 </html>
117 </field>
118 <field>
119 <name>source</name>
120 <uniqueName>membership_source</uniqueName>
121 <title>Source</title>
122 <import>true</import>
123 <headerPattern>/^(member(ship?))?source$/i</headerPattern>
124 <type>varchar</type>
125 <length>128</length>
126 <add>1.5</add>
127 <html>
128 <type>Text</type>
129 </html>
130 </field>
131 <field>
132 <name>status_id</name>
133 <title>Membership Status Id</title>
134 <import>true</import>
135 <headerPattern>/(member(ship|).)?(status)$/i</headerPattern>
136 <type>int unsigned</type>
137 <export>false</export>
138 <required>true</required>
139 <comment>FK to Membership Status</comment>
140 <pseudoconstant>
141 <table>civicrm_membership_status</table>
142 <keyColumn>id</keyColumn>
143 <labelColumn>label</labelColumn>
144 </pseudoconstant>
145 <html>
146 <type>Select</type>
147 </html>
148 <add>1.5</add>
149 </field>
150 <foreignKey>
151 <name>status_id</name>
152 <table>civicrm_membership_status</table>
153 <key>id</key>
154 <add>1.5</add>
155 <onDelete>CASCADE</onDelete>
156 </foreignKey>
157 <field>
158 <name>is_override</name>
159 <title>Status Override</title>
160 <import>true</import>
161 <headerPattern>/override$/i</headerPattern>
162 <type>boolean</type>
163 <comment>Admin users may set a manual status which overrides the calculated status. When this flag is true, automated status update scripts should NOT modify status for the record.</comment>
164 <html>
165 <type>CheckBox</type>
166 </html>
167 <add>1.5</add>
168 </field>
169 <field>
170 <name>status_override_end_date</name>
171 <title>Status Override End Date</title>
172 <type>date</type>
173 <default>NULL</default>
174 <import>true</import>
175 <comment>Then end date of membership status override if 'Override until selected date' override type is selected.</comment>
176 <add>4.7</add>
177 <html>
178 <type>Select Date</type>
179 </html>
180 </field>
181 <field>
182 <name>owner_membership_id</name>
183 <type>int unsigned</type>
184 <title>Primary Member ID</title>
185 <comment>Optional FK to Parent Membership.</comment>
186 <export>true</export>
187 <add>1.7</add>
188 </field>
189 <foreignKey>
190 <name>owner_membership_id</name>
191 <table>civicrm_membership</table>
192 <key>id</key>
193 <add>1.7</add>
194 <onDelete>SET NULL</onDelete>
195 </foreignKey>
196 <index>
197 <name>index_owner_membership_id</name>
198 <fieldName>owner_membership_id</fieldName>
199 <add>1.7</add>
200 </index>
201 <field>
202 <name>max_related</name>
203 <type>int</type>
204 <comment>Maximum number of related memberships (membership_type override).</comment>
205 <add>4.3</add>
206 <html>
207 <type>Text</type>
208 </html>
209 </field>
210 <field>
211 <name>is_test</name>
212 <title>Test</title>
213 <uniqueName>member_is_test</uniqueName>
214 <type>boolean</type>
215 <default>0</default>
216 <import>true</import>
217 <headerPattern>/(is.)?test(.member(ship)?)?/i</headerPattern>
218 <html>
219 <type>CheckBox</type>
220 </html>
221 </field>
222 <field>
223 <name>is_pay_later</name>
224 <uniqueName>member_is_pay_later</uniqueName>
225 <title>Is Pay Later</title>
226 <type>boolean</type>
227 <default>0</default>
228 <import>true</import>
229 <headerPattern>/(is.)?(pay(.)?later)$/i</headerPattern>
230 <add>2.1</add>
231 <html>
232 <type>CheckBox</type>
233 </html>
234 </field>
235 <field>
236 <name>contribution_recur_id</name>
237 <title>Membership Recurring Contribution</title>
238 <type>int unsigned</type>
239 <comment>Conditional foreign key to civicrm_contribution_recur id. Each membership in connection with a recurring contribution carries a foreign key to the recurring contribution record. This assumes we can track these processor initiated events.</comment>
240 <add>3.3</add>
241 </field>
242 <foreignKey>
243 <name>contribution_recur_id</name>
244 <table>civicrm_contribution_recur</table>
245 <key>id</key>
246 <add>3.3</add>
247 <onDelete>SET NULL</onDelete>
248 </foreignKey>
249 <field>
250 <name>campaign_id</name>
251 <uniqueName>member_campaign_id</uniqueName>
252 <type>int unsigned</type>
253 <title>Campaign</title>
254 <import>true</import>
255 <comment>The campaign for which this membership is attached.</comment>
256 <pseudoconstant>
257 <table>civicrm_campaign</table>
258 <keyColumn>id</keyColumn>
259 <labelColumn>title</labelColumn>
260 </pseudoconstant>
261 <add>3.4</add>
262 <html>
263 <type>Select</type>
264 </html>
265 </field>
266 <foreignKey>
267 <name>campaign_id</name>
268 <table>civicrm_campaign</table>
269 <key>id</key>
270 <onDelete>SET NULL</onDelete>
271 </foreignKey>
272 </table>