[civicrm-core.git] / xml / schema / Core / CustomField.xml

<?xml version="1.0" encoding="iso-8859-1" ?>

<table>
  <base>CRM/Core</base>
  <class>CustomField</class>
  <name>civicrm_custom_field</name>
  <comment>Stores info about an extended (custom) property (data and form field info).</comment>
  <add>1.1</add>
  <log>true</log>
  <field>
    <name>id</name>
    <type>int unsigned</type>
    <title>Custom Field ID</title>
    <required>true</required>
    <comment>Unique Custom Field ID</comment>
    <add>1.1</add>
  </field>
  <primaryKey>
    <name>id</name>
    <autoincrement>true</autoincrement>
  </primaryKey>
  <field>
    <name>custom_group_id</name>
    <type>int unsigned</type>
    <title>Custom Group</title>
    <required>true</required>
    <comment>FK to civicrm_custom_group.</comment>
    <add>1.1</add>
    <pseudoconstant>
      <table>civicrm_custom_group</table>
      <keyColumn>id</keyColumn>
      <labelColumn>title</labelColumn>
    </pseudoconstant>
    <html>
      <type>Select</type>
    </html>
  </field>
  <foreignKey>
    <name>custom_group_id</name>
    <table>civicrm_custom_group</table>
    <key>id</key>
    <add>1.1</add>
    <onDelete>CASCADE</onDelete>
  </foreignKey>
  <field>
    <name>name</name>
    <type>varchar</type>
    <title>Custom Field Name</title>
    <length>64</length>
    <comment>Variable name/programmatic handle for this group.</comment>
    <add>3.3</add>
  </field>
  <field>
    <name>label</name>
    <type>varchar</type>
    <title>Custom Field Label</title>
    <length>255</length>
    <required>true</required>
    <localizable>true</localizable>
    <comment>Text for form field label (also friendly name for administering this custom property).</comment>
    <add>1.1</add>
  </field>
  <field>
    <name>data_type</name>
    <type>varchar</type>
    <title>Custom Field Data Type</title>
    <length>16</length>
    <required>true</required>
    <comment>Controls location of data storage in extended_data table.</comment>
    <pseudoconstant>
      <callback>CRM_Core_BAO_CustomField::dataType</callback>
    </pseudoconstant>
    <add>1.1</add>
    <html>
      <type>Select</type>
    </html>
  </field>
  <field>
    <name>html_type</name>
    <type>varchar</type>
    <title>Custom Field HTMl Type</title>
    <length>32</length>
    <required>true</required>
    <comment>HTML types plus several built-in extended types.</comment>
    <pseudoconstant>
      <callback>CRM_Core_SelectValues::customHtmlType</callback>
    </pseudoconstant>
    <add>1.1</add>
  </field>
  <field>
    <name>default_value</name>
    <type>varchar</type>
    <title>Custom Field Default</title>
    <length>255</length>
    <comment>Use form_options.is_default for field_types which use options.</comment>
    <add>1.1</add>
  </field>
  <field>
    <name>is_required</name>
    <title>Custom Field Is Required?</title>
    <type>boolean</type>
    <comment>Is a value required for this property.</comment>
    <add>1.1</add>
  </field>
  <field>
    <name>is_searchable</name>
    <title>Allow Searching on Field?</title>
    <type>boolean</type>
    <comment>Is this property searchable.</comment>
    <add>1.1</add>
  </field>
  <field>
    <name>is_search_range</name>
    <type>boolean</type>
    <title>Search as a Range</title>
    <comment>Is this property range searchable.</comment>
    <add>1.4</add>
    <default>0</default>
  </field>
  <field>
    <name>weight</name>
    <type>int</type>
    <title>Order</title>
    <required>true</required>
    <default>1</default>
    <comment>Controls field display order within an extended property group.</comment>
    <add>1.1</add>
  </field>
  <field>
    <name>help_pre</name>
    <type>text</type>
    <title>Custom Field Pre Text</title>
    <localizable>true</localizable>
    <comment>Description and/or help text to display before this field.</comment>
    <add>1.1</add>
  </field>
  <field>
    <name>help_post</name>
    <type>text</type>
    <title>Custom Field Post Text</title>
    <localizable>true</localizable>
    <comment>Description and/or help text to display after this field.</comment>
    <add>1.1</add>
  </field>
  <field>
    <name>mask</name>
    <type>varchar</type>
    <title>Custom Field Formatting</title>
    <length>64</length>
    <comment>Optional format instructions for specific field types, like date types.</comment>
    <add>1.1</add>
  </field>
  <field>
    <name>attributes</name>
    <type>varchar</type>
    <title>Custom Field Attributes</title>
    <length>255</length>
    <comment>Store collection of type-appropriate attributes, e.g. textarea  needs rows/cols attributes</comment>
    <add>1.1</add>
  </field>
  <field>
    <name>javascript</name>
    <type>varchar</type>
    <title>Custom Field Javascript</title>
    <length>255</length>
    <comment>Optional scripting attributes for field.</comment>
    <add>1.1</add>
  </field>
  <field>
    <name>is_active</name>
    <type>boolean</type>
    <title>Custom Field Is Active?</title>
    <comment>Is this property active?</comment>
    <add>1.1</add>
  </field>
  <field>
    <name>is_view</name>
    <type>boolean</type>
    <title>Field is Viewable</title>
    <comment>Is this property set by PHP Code? A code field is viewable but not editable</comment>
    <add>1.1</add>
  </field>
  <field>
    <name>options_per_line</name>
    <type>int unsigned</type>
    <title>Field Options Per Line</title>
    <comment>number of options per line for checkbox and radio</comment>
  </field>
  <field>
    <name>text_length</name>
    <type>int unsigned</type>
    <title>Field Length</title>
    <comment>field length if alphanumeric</comment>
    <add>2.2</add>
  </field>
  <field>
    <name>start_date_years</name>
    <type>int</type>
    <title>Field Start Date</title>
    <comment>Date may be up to start_date_years years prior to the current date.</comment>
    <add>1.4</add>
  </field>
  <field>
    <name>end_date_years</name>
    <type>int</type>
    <title>Field End Date</title>
    <comment>Date may be up to end_date_years years after the current date.</comment>
    <add>1.4</add>
  </field>
  <field>
    <name>date_parts</name>
    <type>varchar</type>
    <length>255</length>
    <comment>which date part included in display </comment>
    <add>1.4</add>
    <drop>3.1</drop>
  </field>
  <field>
    <name>date_format</name>
    <type>varchar</type>
    <title>Field Data Format</title>
    <length>64</length>
    <comment>date format for custom date</comment>
    <add>3.1</add>
  </field>
  <field>
    <name>time_format</name>
    <type>int unsigned</type>
    <title>Field Time Format</title>
    <comment>time format for custom date</comment>
    <add>3.1</add>
  </field>
  <field>
    <name>note_columns</name>
    <type>int unsigned</type>
    <title>Field Note Columns</title>
    <comment> Number of columns in Note Field </comment>
    <add>1.4</add>
  </field>
  <field>
    <name>note_rows</name>
    <type>int unsigned</type>
    <title>Field Note Rows</title>
    <comment> Number of rows in Note Field </comment>
    <add>1.4</add>
  </field>
  <field>
    <name>column_name</name>
    <type>varchar</type>
    <title>Field Column Name</title>
    <length>255</length>
    <comment>Name of the column that holds the values for this field.</comment>
    <add>2.0</add>
  </field>
  <field>
    <name>option_group_id</name>
    <type>int unsigned</type>
    <title>Field Option Group</title>
    <comment>For elements with options, the option group id that is used</comment>
    <add>1.4</add>
  </field>
  <field>
    <name>filter</name>
    <type>varchar</type>
    <title>Field Filter</title>
    <length>255</length>
    <comment>Stores Contact Get API params contact reference custom fields. May be used for other filters in the future.</comment>
    <add>4.1</add>
  </field>
  <field>
    <name>in_selector</name>
    <type>boolean</type>
    <title>Field Display</title>
    <default>0</default>
    <comment>Should the multi-record custom field values be displayed in tab table listing</comment>
    <add>4.5</add>
  </field>
  <index>
    <name>UI_label_custom_group_id</name>
    <fieldName>label</fieldName>
    <fieldName>custom_group_id</fieldName>
    <unique>true</unique>
    <add>1.1</add>
  </index>
  <index>
    <name>UI_name_custom_group_id</name>
    <fieldName>name</fieldName>
    <fieldName>custom_group_id</fieldName>
    <unique>true</unique>
    <add>4.3</add>
  </index>
</table>
Commit	Line	Data
6a488035 TO	1	<?xml version="1.0" encoding="iso-8859-1" ?>
	2
	3	<table>
	4	<base>CRM/Core</base>
	5	<class>CustomField</class>
	6	<name>civicrm_custom_field</name>
	7	<comment>Stores info about an extended (custom) property (data and form field info).</comment>
	8	<add>1.1</add>
	9	<log>true</log>
	10	<field>
186e0984 EM	11	<name>id</name>
186e0984 EM	12	<type>int unsigned</type>
56b7523d	13	<title>Custom Field ID</title>
186e0984 EM	14	<required>true</required>
	15	<comment>Unique Custom Field ID</comment>
	16	<add>1.1</add>
6a488035 TO	17	</field>
6a488035 TO	18	<primaryKey>
186e0984 EM	19	<name>id</name>
186e0984 EM	20	<autoincrement>true</autoincrement>
6a488035 TO	21	</primaryKey>
6a488035 TO	22	<field>
186e0984 EM	23	<name>custom_group_id</name>
186e0984 EM	24	<type>int unsigned</type>
56b7523d	25	<title>Custom Group</title>
186e0984 EM	26	<required>true</required>
	27	<comment>FK to civicrm_custom_group.</comment>
	28	<add>1.1</add>
	29	<pseudoconstant>
	30	<table>civicrm_custom_group</table>
	31	<keyColumn>id</keyColumn>
	32	<labelColumn>title</labelColumn>
	33	</pseudoconstant>
	34	<html>
	35	<type>Select</type>
	36	</html>
6a488035 TO	37	</field>
6a488035 TO	38	<foreignKey>
186e0984 EM	39	<name>custom_group_id</name>
	40	<table>civicrm_custom_group</table>
	41	<key>id</key>
	42	<add>1.1</add>
	43	<onDelete>CASCADE</onDelete>
6a488035 TO	44	</foreignKey>
6a488035 TO	45	<field>
186e0984 EM	46	<name>name</name>
186e0984 EM	47	<type>varchar</type>
56b7523d	48	<title>Custom Field Name</title>
186e0984 EM	49	<length>64</length>
	50	<comment>Variable name/programmatic handle for this group.</comment>
	51	<add>3.3</add>
6a488035 TO	52	</field>
6a488035 TO	53	<field>
186e0984 EM	54	<name>label</name>
186e0984 EM	55	<type>varchar</type>
56b7523d	56	<title>Custom Field Label</title>
186e0984 EM	57	<length>255</length>
	58	<required>true</required>
	59	<localizable>true</localizable>
	60	<comment>Text for form field label (also friendly name for administering this custom property).</comment>
	61	<add>1.1</add>
6a488035 TO	62	</field>
6a488035 TO	63	<field>
186e0984 EM	64	<name>data_type</name>
186e0984 EM	65	<type>varchar</type>
56b7523d	66	<title>Custom Field Data Type</title>
186e0984 EM	67	<length>16</length>
	68	<required>true</required>
	69	<comment>Controls location of data storage in extended_data table.</comment>
	70	<pseudoconstant>
	71	<callback>CRM_Core_BAO_CustomField::dataType</callback>
	72	</pseudoconstant>
	73	<add>1.1</add>
	74	<html>
	75	<type>Select</type>
	76	</html>
6a488035 TO	77	</field>
6a488035 TO	78	<field>
186e0984 EM	79	<name>html_type</name>
186e0984 EM	80	<type>varchar</type>
56b7523d	81	<title>Custom Field HTMl Type</title>
186e0984 EM	82	<length>32</length>
	83	<required>true</required>
	84	<comment>HTML types plus several built-in extended types.</comment>
	85	<pseudoconstant>
	86	<callback>CRM_Core_SelectValues::customHtmlType</callback>
	87	</pseudoconstant>
	88	<add>1.1</add>
6a488035 TO	89	</field>
6a488035 TO	90	<field>
186e0984 EM	91	<name>default_value</name>
186e0984 EM	92	<type>varchar</type>
56b7523d	93	<title>Custom Field Default</title>
186e0984 EM	94	<length>255</length>
	95	<comment>Use form_options.is_default for field_types which use options.</comment>
	96	<add>1.1</add>
6a488035 TO	97	</field>
6a488035 TO	98	<field>
186e0984	99	<name>is_required</name>
56b7523d	100	<title>Custom Field Is Required?</title>
186e0984 EM	101	<type>boolean</type>
	102	<comment>Is a value required for this property.</comment>
	103	<add>1.1</add>
6a488035 TO	104	</field>
6a488035 TO	105	<field>
186e0984	106	<name>is_searchable</name>
56b7523d	107	<title>Allow Searching on Field?</title>
186e0984 EM	108	<type>boolean</type>
	109	<comment>Is this property searchable.</comment>
	110	<add>1.1</add>
6a488035 TO	111	</field>
6a488035 TO	112	<field>
186e0984 EM	113	<name>is_search_range</name>
186e0984 EM	114	<type>boolean</type>
56b7523d	115	<title>Search as a Range</title>
186e0984 EM	116	<comment>Is this property range searchable.</comment>
	117	<add>1.4</add>
	118	<default>0</default>
6a488035 TO	119	</field>
6a488035 TO	120	<field>
186e0984 EM	121	<name>weight</name>
186e0984 EM	122	<type>int</type>
7ecddde4	123	<title>Order</title>
186e0984 EM	124	<required>true</required>
	125	<default>1</default>
	126	<comment>Controls field display order within an extended property group.</comment>
	127	<add>1.1</add>
6a488035 TO	128	</field>
6a488035 TO	129	<field>
186e0984 EM	130	<name>help_pre</name>
186e0984 EM	131	<type>text</type>
56b7523d	132	<title>Custom Field Pre Text</title>
186e0984 EM	133	<localizable>true</localizable>
	134	<comment>Description and/or help text to display before this field.</comment>
	135	<add>1.1</add>
6a488035 TO	136	</field>
6a488035 TO	137	<field>
186e0984 EM	138	<name>help_post</name>
186e0984 EM	139	<type>text</type>
56b7523d	140	<title>Custom Field Post Text</title>
186e0984 EM	141	<localizable>true</localizable>
	142	<comment>Description and/or help text to display after this field.</comment>
	143	<add>1.1</add>
6a488035 TO	144	</field>
6a488035 TO	145	<field>
186e0984 EM	146	<name>mask</name>
186e0984 EM	147	<type>varchar</type>
56b7523d	148	<title>Custom Field Formatting</title>
186e0984 EM	149	<length>64</length>
	150	<comment>Optional format instructions for specific field types, like date types.</comment>
	151	<add>1.1</add>
6a488035 TO	152	</field>
6a488035 TO	153	<field>
186e0984 EM	154	<name>attributes</name>
186e0984 EM	155	<type>varchar</type>
56b7523d	156	<title>Custom Field Attributes</title>
186e0984 EM	157	<length>255</length>
	158	<comment>Store collection of type-appropriate attributes, e.g. textarea needs rows/cols attributes</comment>
	159	<add>1.1</add>
6a488035 TO	160	</field>
6a488035 TO	161	<field>
186e0984 EM	162	<name>javascript</name>
186e0984 EM	163	<type>varchar</type>
56b7523d	164	<title>Custom Field Javascript</title>
186e0984 EM	165	<length>255</length>
	166	<comment>Optional scripting attributes for field.</comment>
	167	<add>1.1</add>
6a488035 TO	168	</field>
6a488035 TO	169	<field>
186e0984 EM	170	<name>is_active</name>
186e0984 EM	171	<type>boolean</type>
56b7523d	172	<title>Custom Field Is Active?</title>
186e0984 EM	173	<comment>Is this property active?</comment>
186e0984 EM	174	<add>1.1</add>
6a488035 TO	175	</field>
6a488035 TO	176	<field>
186e0984 EM	177	<name>is_view</name>
186e0984 EM	178	<type>boolean</type>
56b7523d	179	<title>Field is Viewable</title>
186e0984 EM	180	<comment>Is this property set by PHP Code? A code field is viewable but not editable</comment>
186e0984 EM	181	<add>1.1</add>
6a488035 TO	182	</field>
6a488035 TO	183	<field>
186e0984 EM	184	<name>options_per_line</name>
186e0984 EM	185	<type>int unsigned</type>
56b7523d	186	<title>Field Options Per Line</title>
186e0984	187	<comment>number of options per line for checkbox and radio</comment>
6a488035 TO	188	</field>
6a488035 TO	189	<field>
186e0984 EM	190	<name>text_length</name>
186e0984 EM	191	<type>int unsigned</type>
56b7523d	192	<title>Field Length</title>
186e0984 EM	193	<comment>field length if alphanumeric</comment>
186e0984 EM	194	<add>2.2</add>
6a488035 TO	195	</field>
6a488035 TO	196	<field>
186e0984 EM	197	<name>start_date_years</name>
186e0984 EM	198	<type>int</type>
56b7523d	199	<title>Field Start Date</title>
186e0984 EM	200	<comment>Date may be up to start_date_years years prior to the current date.</comment>
186e0984 EM	201	<add>1.4</add>
6a488035 TO	202	</field>
6a488035 TO	203	<field>
186e0984 EM	204	<name>end_date_years</name>
186e0984 EM	205	<type>int</type>
56b7523d	206	<title>Field End Date</title>
186e0984 EM	207	<comment>Date may be up to end_date_years years after the current date.</comment>
186e0984 EM	208	<add>1.4</add>
6a488035 TO	209	</field>
6a488035 TO	210	<field>
186e0984 EM	211	<name>date_parts</name>
	212	<type>varchar</type>
	213	<length>255</length>
	214	<comment>which date part included in display </comment>
	215	<add>1.4</add>
	216	<drop>3.1</drop>
6a488035 TO	217	</field>
6a488035 TO	218	<field>
186e0984 EM	219	<name>date_format</name>
186e0984 EM	220	<type>varchar</type>
56b7523d	221	<title>Field Data Format</title>
186e0984 EM	222	<length>64</length>
	223	<comment>date format for custom date</comment>
	224	<add>3.1</add>
6a488035 TO	225	</field>
6a488035 TO	226	<field>
186e0984 EM	227	<name>time_format</name>
186e0984 EM	228	<type>int unsigned</type>
56b7523d	229	<title>Field Time Format</title>
186e0984 EM	230	<comment>time format for custom date</comment>
186e0984 EM	231	<add>3.1</add>
6a488035 TO	232	</field>
6a488035 TO	233	<field>
186e0984 EM	234	<name>note_columns</name>
186e0984 EM	235	<type>int unsigned</type>
56b7523d	236	<title>Field Note Columns</title>
186e0984 EM	237	<comment> Number of columns in Note Field </comment>
186e0984 EM	238	<add>1.4</add>
6a488035 TO	239	</field>
6a488035 TO	240	<field>
186e0984 EM	241	<name>note_rows</name>
186e0984 EM	242	<type>int unsigned</type>
56b7523d	243	<title>Field Note Rows</title>
186e0984 EM	244	<comment> Number of rows in Note Field </comment>
186e0984 EM	245	<add>1.4</add>
6a488035 TO	246	</field>
6a488035 TO	247	<field>
186e0984 EM	248	<name>column_name</name>
186e0984 EM	249	<type>varchar</type>
56b7523d	250	<title>Field Column Name</title>
186e0984 EM	251	<length>255</length>
	252	<comment>Name of the column that holds the values for this field.</comment>
	253	<add>2.0</add>
6a488035 TO	254	</field>
6a488035 TO	255	<field>
186e0984 EM	256	<name>option_group_id</name>
186e0984 EM	257	<type>int unsigned</type>
56b7523d	258	<title>Field Option Group</title>
186e0984 EM	259	<comment>For elements with options, the option group id that is used</comment>
186e0984 EM	260	<add>1.4</add>
6a488035 TO	261	</field>
6a488035 TO	262	<field>
186e0984 EM	263	<name>filter</name>
186e0984 EM	264	<type>varchar</type>
56b7523d	265	<title>Field Filter</title>
186e0984 EM	266	<length>255</length>
	267	<comment>Stores Contact Get API params contact reference custom fields. May be used for other filters in the future.</comment>
	268	<add>4.1</add>
6a488035	269	</field>
5a205b89 PJ	270	<field>
	271	<name>in_selector</name>
	272	<type>boolean</type>
56b7523d	273	<title>Field Display</title>
5a205b89 PJ	274	<default>0</default>
	275	<comment>Should the multi-record custom field values be displayed in tab table listing</comment>
	276	<add>4.5</add>
	277	</field>
6a488035 TO	278	<index>
	279	<name>UI_label_custom_group_id</name>
	280	<fieldName>label</fieldName>
	281	<fieldName>custom_group_id</fieldName>
	282	<unique>true</unique>
	283	<add>1.1</add>
	284	</index>
	285	<index>
	286	<name>UI_name_custom_group_id</name>
	287	<fieldName>name</fieldName>
	288	<fieldName>custom_group_id</fieldName>
	289	<unique>true</unique>
	290	<add>4.3</add>
	291	</index>
	292	</table>