tripal_chado.fields.inc 28 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804
  1. <?php
  2. /**
  3. * Implements hook_field_info().
  4. *
  5. * This function would normally provide a large info array for all of the
  6. * fields provided by this module. But instead it will call a hook that
  7. * can be implmented within each individual field file. This will allow
  8. * all of the code for a single field to be self contained in a single file.
  9. *
  10. * New fields can be added automatically by including a new file in the
  11. * tripal_chado/includes/fields directory. The file must be named with a
  12. * 'chado_' prefix and end with a '.inc' suffix. After adding the file,
  13. * the cache must be cleared.
  14. *
  15. */
  16. function tripal_chado_field_info() {
  17. $info = array();
  18. // Find all of the files in the tripal_chado/includes/fields directory.
  19. $fields_path = drupal_get_path('module', 'tripal_chado') . '/includes/fields';
  20. $field_files = file_scan_directory($fields_path, '/^chado_.*\.inc$/');
  21. // Iterate through the fields, include the file and run the info function.
  22. foreach ($field_files as $file) {
  23. $field_type = $file->name;
  24. module_load_include('inc', 'tripal_chado', 'includes/fields/' . $field_type);
  25. if (preg_match('/^chado/', $field_type) and class_exists($field_type)) {
  26. $field_obj = new $field_type();
  27. $info[$field_type] = $field_obj->field_info();
  28. }
  29. $function = $field_type . '_info';
  30. if (function_exists($function)) {
  31. $info[$field_type] = $function();
  32. }
  33. }
  34. return $info;
  35. }
  36. /**
  37. * Implements hook_field_widget_info().
  38. *
  39. * This function would normally provide a large info array for all of the
  40. * widgets provided by this module. But instead it will call a hook that
  41. * can be implmented within each individual field file. This will allow
  42. * all of the code for a single field to be self contained in a single file.
  43. */
  44. function tripal_chado_field_widget_info() {
  45. $widgets = array();
  46. $fields = field_info_fields();
  47. foreach ($fields as $field) {
  48. $field_type = $field['type'];
  49. if ($field['storage']['type'] == 'field_chado_storage') {
  50. module_load_include('inc', 'tripal_chado', 'includes/fields/' . $field_type);
  51. if (preg_match('/^chado/', $field_type) and class_exists($field_type)) {
  52. $field_obj = new $field_type();
  53. $widgets[$field_type . '_widget'] = $field_obj->widget_info();
  54. }
  55. $function = $field_type . '_widget_info';
  56. if (function_exists($function)) {
  57. $widgets[$field_type . '_widget'] = $function();
  58. }
  59. }
  60. }
  61. return $widgets;
  62. }
  63. /**
  64. * Implements hook_field_formatter_info().
  65. *
  66. * This function would normally provide a large info array for all of the
  67. * formatters provided by this module. But instead it will call a hook that
  68. * can be implmented within each individual field file. This will allow
  69. * all of the code for a single field to be self contained in a single file.
  70. */
  71. function tripal_chado_field_formatter_info() {
  72. $formatters = array();
  73. $fields = field_info_fields();
  74. foreach ($fields as $field) {
  75. $field_type = $field['type'];
  76. if ($field['storage']['type'] == 'field_chado_storage') {
  77. module_load_include('inc', 'tripal_chado', 'includes/fields/' . $field_type);
  78. if (preg_match('/^chado/', $field_type) and class_exists($field_type)) {
  79. $field_obj = new $field_type();
  80. $formatters[$field_type . '_formatter'] = $field_obj->formatter_info();
  81. }
  82. $function = $field_type . '_formatter_info';
  83. if (function_exists($function)) {
  84. $formatters[$field_type . '_formatter'] = $function();
  85. }
  86. }
  87. }
  88. return $formatters;
  89. }
  90. /**
  91. * Implements hook_field_settings_form()
  92. */
  93. function tripal_chado_field_settings_form($field, $instance, $has_data) {
  94. $form = '';
  95. $field_type = $field['type'];
  96. module_load_include('inc', 'tripal_chado', 'includes/fields/' . $field_type);
  97. if (preg_match('/^chado/', $field_type) and class_exists($field_type)) {
  98. $field_obj = new $field_type();
  99. $form = $field_obj->settings_form($field, $instance, $has_data);
  100. }
  101. $function = $field_type . '_settings_form';
  102. if (function_exists($function)) {
  103. $form = $function($field, $instance, $has_data);
  104. }
  105. return $form;
  106. }
  107. /**
  108. * Implements hook_field_formatter_settings_summary().
  109. */
  110. function tripal_chado_field_formatter_settings_summary($field, $instance, $view_mode) {
  111. $summary = '';
  112. $field_type = $field['type'];
  113. module_load_include('inc', 'tripal_chado', 'includes/fields/' . $field_type);
  114. if (preg_match('/^chado/', $field_type) and class_exists($field_type)) {
  115. $field = new $field_type();
  116. $summary = $field->formatter_settings_summary($field, $instance, $view_mode);
  117. }
  118. $function = $field_type . '_formatter_settings_summary';
  119. if (function_exists($function)) {
  120. $summary = $function($field, $instance, $view_mode);
  121. }
  122. return $summary;
  123. }
  124. /**
  125. * Implements hook_field_formatter_settings_form().
  126. */
  127. function tripal_chado_field_formatter_settings_form($field, $instance,
  128. $view_mode, $form, &$form_state) {
  129. $element = array();
  130. $field_type = $field['type'];
  131. form_load_include($form_state, 'inc', 'tripal_chado', 'includes/fields/' . $field_type);
  132. module_load_include('inc', 'tripal_chado', 'includes/fields/' . $field_type);
  133. if (preg_match('/^chado/', $field_type) and class_exists($field_type)) {
  134. $field_obj = new $field_type();
  135. $element = $field_obj->formatter_settings_form($field, $instance, $view_mode, $form, $form_state);
  136. }
  137. $function = $field_type . '_formatter_settings_form';
  138. if (function_exists($function)) {
  139. $element = $function($field, $instance, $view_mode, $form, $form_state);
  140. }
  141. return $element;
  142. }
  143. /**
  144. * Implements hook_field_formatter_view().
  145. */
  146. function tripal_chado_field_formatter_view($entity_type, $entity, $field,
  147. $instance, $langcode, $items, $display) {
  148. $element = array();
  149. $field_type = $field['type'];
  150. module_load_include('inc', 'tripal_chado', 'includes/fields/' . $field_type);
  151. if (preg_match('/^chado/', $field_type) and class_exists($field_type)) {
  152. $field_obj = new $field_type();
  153. $field_obj->formatter_view($element, $entity_type, $entity, $field, $instance, $langcode, $items, $display);
  154. }
  155. $function = $display['type'];
  156. if (function_exists($function)) {
  157. $function($element, $entity_type, $entity, $field, $instance, $langcode, $items, $display);
  158. }
  159. return $element;
  160. }
  161. /**
  162. * Implements hook_field_widget_form().
  163. */
  164. function tripal_chado_field_widget_form(&$form, &$form_state, $field,
  165. $instance, $langcode, $items, $delta, $element) {
  166. $widget = $element;
  167. $field_name = $instance['field_name'];
  168. $field_type = $field['type'];
  169. form_load_include($form_state, 'inc', 'tripal_chado', 'includes/fields/' . $field_type);
  170. module_load_include('inc', 'tripal_chado', 'includes/fields/' . $field_name);
  171. if (preg_match('/^chado/', $field_type) and class_exists($field_type)) {
  172. $field_obj = new $field_type();
  173. $field_obj->widget_form($widget, $form, $form_state, $field, $instance, $langcode, $items, $delta, $element);
  174. }
  175. $function = $field_type . '_widget';
  176. if (function_exists($function)) {
  177. $function($widget, $form, $form_state, $field, $instance, $langcode, $items, $delta, $element);
  178. }
  179. return $widget;
  180. }
  181. /**
  182. * Returns the values of the field from the $form_state.
  183. */
  184. function tripal_chado_get_field_form_values($field_name, $form_state, $delta = 0, $child = NULL) {
  185. $value = NULL;
  186. // The form_state must have the 'values' key. If not then just return.
  187. if (!array_key_exists('values', $form_state)) {
  188. return $value;
  189. }
  190. // If the field name is not in the form_state['values'] then return.
  191. if (!array_key_exists($field_name, $form_state['values'])) {
  192. return $value;
  193. }
  194. // Iterate through the values looking for the field_name provided.
  195. foreach ($form_state['values'][$field_name] as $langcode => $items) {
  196. if (!array_key_exists($delta, $items)) {
  197. continue;
  198. }
  199. $item = $items[$delta];
  200. if ($child){
  201. if(array_key_exists($child, $item) and $item[$child] != '') {
  202. $value = $item[$child];
  203. }
  204. }
  205. else {
  206. $value = $item['value'];
  207. }
  208. }
  209. return $value;
  210. }
  211. /**
  212. * Sets the values of the field from the $form_state.
  213. */
  214. function tripal_chado_set_field_form_values($field_name, &$form_state, $newvalue, $delta = 0, $child = NULL) {
  215. // The form_state must have the 'values' key. If not then just return.
  216. if (!array_key_exists('values', $form_state)) {
  217. return FALSE;
  218. }
  219. // If the field name is not in the form_state['values'] then reutrn.
  220. if (!array_key_exists($field_name, $form_state['values'])) {
  221. return FALSE;
  222. }
  223. foreach ($form_state['values'][$field_name] as $langcode => $items) {
  224. if ($child) {
  225. $form_state['values'][$field_name][$langcode][$delta][$child] = $newvalue;
  226. }
  227. else {
  228. $form_state['values'][$field_name][$langcode][$delta]['value'] = $newvalue;
  229. }
  230. }
  231. return TRUE;
  232. }
  233. /**
  234. * Implements hook_field_widget_form_alter().
  235. */
  236. function tripal_chado_field_widget_form_alter(&$element, &$form_state, $context) {
  237. if (array_key_exists('#field_name', $element)) {
  238. $field_name = $element['#field_name'];
  239. $matches = array();
  240. if (preg_match('/(.+?)__(.+?)$/', $field_name, $matches)) {
  241. $tablename = $matches[1];
  242. $colname = $matches[2];
  243. $schema = chado_get_schema($tablename);
  244. // The timelastmodified field exists in many Chado tables. We want
  245. // the form element to update to the most recent time rather than the time
  246. // in the database.
  247. if ($colname == 'timelastmodified' and $schema['fields'][$colname]['type'] == 'datetime') {
  248. // We want the default value for the field to be the current time.
  249. $element['#default_value']['value'] = format_date(time(), 'custom', "Y-m-d H:i:s", 'UTC');
  250. $element['#date_items']['value'] = $element['#default_value']['value'];
  251. }
  252. // We want the date combo fieldset to be collaspible so we will
  253. // add our own theme_wrapper to replace the one added by the date
  254. // module.
  255. if (array_key_exists($colname, $schema['fields']) and $schema['fields'][$colname]['type'] == 'datetime') {
  256. $element['#theme_wrappers'] = array('tripal_chado_date_combo');
  257. }
  258. }
  259. }
  260. }
  261. /**
  262. * Returns a $field_info array for a field based on a database column.
  263. *
  264. */
  265. function tripal_chado_add_bundle_fields_base__fields_defaults($table_name, $schema, $column_name) {
  266. $details = $schema['fields'][$column_name];
  267. // Create an array with information about this field.
  268. $field = array(
  269. 'field_type' => '',
  270. 'widget_type' => '',
  271. 'description' => '',
  272. 'label' => ucwords(preg_replace('/_/', ' ', $column_name)),
  273. 'is_required' => 0,
  274. 'storage' => 'field_chado_storage',
  275. 'widget_settings' => array(
  276. 'display_label' => 1
  277. ),
  278. 'field_settings' => array(
  279. // The table in Chado where this field maps to.
  280. 'chado_table' => $table_name,
  281. // The column in the Chado table that this field maps to.
  282. 'chado_column' => $column_name,
  283. 'semantic_web' => array(
  284. // The type is the term from a vocabulary that desribes this field..
  285. 'name' => '',
  286. // The accession ID for this term in the vocaulary.
  287. 'accession' => '',
  288. // The namepsace for the vocabulary (e.g. 'foaf').
  289. 'ns' => '',
  290. // The URL for the namespace. It must be that the type can be
  291. // appended to the URL.
  292. 'nsurl' => '',
  293. ),
  294. ),
  295. );
  296. // Alter the field info array depending on the column details.
  297. switch($details['type']) {
  298. case 'char':
  299. $field['field_type'] = 'text';
  300. $field['widget_type'] = 'text_textfield';
  301. $field['field_settings']['max_length'] = $details['length'];
  302. break;
  303. case 'varchar':
  304. $field['field_type'] = 'text';
  305. $field['widget_type'] = 'text_textfield';
  306. $field['field_settings']['max_length'] = $details['length'];
  307. break;
  308. case 'text':
  309. $field['field_type'] = 'text';
  310. $field['widget_type'] = 'text_textarea';
  311. $field['field_settings']['max_length'] = 17179869184;
  312. $field['field_settings']['text_processing'] = 1;
  313. $field['format'] = filter_default_format();
  314. break;
  315. case 'blob':
  316. // not sure how to support a blob field.
  317. continue;
  318. break;
  319. case 'int':
  320. $field['field_type'] = 'number_integer';
  321. $field['widget_type'] = 'number';
  322. break;
  323. case 'float':
  324. $field['field_type'] = 'number_float';
  325. $field['widget_type'] = 'number';
  326. $field['field_settings']['precision'] = 10;
  327. $field['field_settings']['scale'] = 2;
  328. $field['field_settings']['decimal_separator'] = '.';
  329. break;
  330. case 'numeric':
  331. $field['field_type'] = 'number_decimal';
  332. $field['widget_type'] = 'number';
  333. break;
  334. case 'serial':
  335. // Serial fields are most likely not needed as a field.
  336. break;
  337. case 'boolean':
  338. $field['field_type'] = 'list_boolean';
  339. $field['widget_type'] = 'options_onoff';
  340. $field['field_settings']['allowed_values'] = array(0 => "No", 1 => "Yes");
  341. break;
  342. case 'datetime':
  343. // Use the Drupal Date and Date API to create the field/widget
  344. $field['field_type'] = 'datetime';
  345. $field['widget_type'] = 'date_select';
  346. $field['widget_settings']['increment'] = 1;
  347. $field['widget_settings']['tz_handling'] = 'none';
  348. $field['widget_settings']['collapsible'] = TRUE;
  349. // TODO: Add settings so that the minutes increment by 1.
  350. // And turn off the timezone, as the Chado field doesn't support it.
  351. break;
  352. }
  353. // Set some default semantic web information
  354. if ($column_name == 'name') {
  355. $field['field_settings']['semantic_web']['name'] = 'name';
  356. $field['field_settings']['semantic_web']['accession'] = 'name';
  357. $field['field_settings']['semantic_web']['ns'] = 'foaf';
  358. $field['field_settings']['semantic_web']['nsurl'] = 'http://xmlns.com/foaf/0.1/';
  359. }
  360. if ($column_name == 'description' or $column_name == 'definition' or
  361. $column_name == 'comment') {
  362. $field['field_settings']['semantic_web']['name'] = 'description';
  363. $field['field_settings']['semantic_web']['accession'] = 'description';
  364. $field['field_settings']['semantic_web']['ns'] = 'hydra';
  365. $field['field_settings']['semantic_web']['nsurl'] = 'http://www.w3.org/ns/hydra/core#';
  366. }
  367. if ($field['label'] == 'Timeaccessioned') {
  368. $field['label'] = 'Time Accessioned';
  369. $field['description'] = 'Please enter the time that this record was first added to the database.';
  370. }
  371. elseif ($field['label'] == 'Timelastmodified') {
  372. $field['label'] = 'Time Last Modified';
  373. $field['description'] = 'Please enter the time that this record was last modified. The default is the current time.';
  374. }
  375. //
  376. // ORGANISM TABLE
  377. //
  378. elseif ($field['field_settings']['chado_table'] == 'organism' and $field['field_settings']['chado_column'] == 'comment') {
  379. $field['label'] = 'Description';
  380. }
  381. //
  382. // FEATURE TABLE
  383. //
  384. elseif ($field['field_settings']['chado_table'] == 'feature' and $field['field_settings']['chado_column'] == 'uniquename') {
  385. $field['field_type'] = 'text';
  386. $field['widget_type'] = 'text_textfield';
  387. $field['field_settings']['text_processing'] = 0;
  388. $field['field_settings']['semantic_web']['name'] = 'name';
  389. $field['field_settings']['semantic_web']['accession'] = 'name';
  390. $field['field_settings']['semantic_web']['ns'] = 'foaf';
  391. $field['field_settings']['semantic_web']['nsurl'] = 'http://xmlns.com/foaf/0.1/';
  392. }
  393. //
  394. // ANALYSIS TABLE
  395. //
  396. elseif ($field['field_settings']['chado_table'] == 'analysis' and $field['field_settings']['chado_column'] == 'program') {
  397. $field['field_settings']['semantic_web']['name'] = 'SoftwareApplication';
  398. $field['field_settings']['semantic_web']['accession'] = 'SoftwareApplication';
  399. $field['field_settings']['semantic_web']['ns'] = 'schema';
  400. $field['field_settings']['semantic_web']['nsurl'] = 'https://schema.org/';
  401. $field['description'] = 'The program name (e.g. blastx, blastp, sim4, genscan. If the analysis was not derived from a software package then provide a very brief description of the pipeline, workflow or method.';
  402. $field['label'] = 'Program, Pipeline, Workflow or Method Name.';
  403. }
  404. elseif ($field['field_settings']['chado_table'] == 'analysis' and $field['field_settings']['chado_column'] == 'sourceuri') {
  405. $field['field_type'] = 'text';
  406. $field['widget_type'] = 'text_textfield';
  407. $field['field_settings']['text_processing'] = 0;
  408. $field['label'] = 'Source URL';
  409. $field['description'] = 'The URL where the original source data was derived. Ideally, this should link to the page where more information about the source data can be found.';
  410. }
  411. elseif ($field['field_settings']['chado_table'] == 'analysis' and $field['field_settings']['chado_column'] == 'sourcename') {
  412. $field['label'] = 'Source Name';
  413. $field['description'] = 'The name of the source data. This could be a file name, data set or a small description for how the data was collected. For long descriptions use the larger description field.';
  414. }
  415. elseif ($field['field_settings']['chado_table'] == 'analysis' and $field['field_settings']['chado_column'] == 'sourceversion') {
  416. $field['label'] = 'Source Version';
  417. $field['description'] = 'If hte source data set has a version include it here.';
  418. }
  419. elseif ($field['field_settings']['chado_table'] == 'analysis' and $field['field_settings']['chado_column'] == 'algorithm') {
  420. $field['label'] = 'Source Version';
  421. $field['description'] = 'The name of the algorithm used to produce the dataset if different from the program.';
  422. }
  423. elseif ($field['field_settings']['chado_table'] == 'analysis' and $field['field_settings']['chado_column'] == 'programversion') {
  424. $field['label'] = 'Program Version';
  425. $field['description'] = 'The version of the program used to perform this analysis. (e.g. TBLASTX 2.0MP-WashU [09-Nov-2000]. Enter "n/a" if no version is available or applicable.';
  426. }
  427. //
  428. // PROJECT TABLE
  429. //
  430. elseif ($field['field_settings']['chado_table'] == 'project' and $field['field_settings']['chado_column'] == 'description') {
  431. $field['label'] = 'Short Description';
  432. }
  433. return $field;
  434. }
  435. /**
  436. * Implements hook_form_FORM_ID_alter().
  437. *
  438. * The field_ui_display_overview_form is used for formatting the display
  439. * or layout of fields attached to an entity and shown on the entity view page.
  440. *
  441. * This function removes the cvterm class and property adder field as those are
  442. * really not meant for users to show or manage.
  443. */
  444. function tripal_chado_form_field_ui_display_overview_form_alter(&$form, &$form_state, $form_id) {
  445. // Remove the kvproperty_addr field as it isn't ever displayed. It's just used
  446. // on the add/edit form of an entity for adding new property fields.
  447. $fields_names = element_children($form['fields']);
  448. foreach ($fields_names as $field_name) {
  449. $field_info = field_info_field($field_name);
  450. if ($field_info['type'] == 'kvproperty_adder') {
  451. unset($form['fields'][$field_name]);
  452. }
  453. if ($field_info['type'] == 'cvterm_class_adder') {
  454. unset($form['fields'][$field_name]);
  455. }
  456. }
  457. }
  458. /**
  459. * Implements hook_form_FORM_ID_alter().
  460. *
  461. * The field_ui_field_overview_form is used for ordering and configuring the
  462. * fields attached to an entity.
  463. *
  464. * This function removes the property adder field as that is really not meant
  465. * for users to show or manage.
  466. */
  467. function tripal_chado_form_field_ui_field_overview_form_alter(&$form, &$form_state, $form_id) {
  468. // Remove the kvproperty_addr field as it isn't ever displayed. It's just used
  469. // on the add/edit form of an entity for adding new property fields.
  470. $fields_names = element_children($form['fields']);
  471. foreach ($fields_names as $field_name) {
  472. $field_info = field_info_field($field_name);
  473. if ($field_info['type'] == 'kvproperty_adder') {
  474. unset($form['fields'][$field_name]);
  475. }
  476. if ($field_info['type'] == 'cvterm_class_adder') {
  477. unset($form['fields'][$field_name]);
  478. }
  479. }
  480. }
  481. /**
  482. * Implements hook_field_is_empty().
  483. */
  484. function tripal_chado_field_is_empty($item, $field) {
  485. // If there is no value field then the field is empty.
  486. if (!array_key_exists('value', $item)) {
  487. return TRUE;
  488. }
  489. // Iterate through all of the fields and if at least one has a value
  490. // the field is not empty.
  491. foreach ($item as $form_field_name => $value) {
  492. if (isset($value) and $value != NULL and $value != '') {
  493. return FALSE;
  494. }
  495. }
  496. // Otherwise, the field is empty.
  497. return TRUE;
  498. }
  499. /**
  500. * Implements hook_update_bundle_fields().
  501. *
  502. */
  503. function tripal_chado_update_bundle_fields($entity_type, $bundle, $term) {
  504. // Get the list of fields that should be attached to this bundle and
  505. // add them.
  506. $bundle_name = $bundle->name;
  507. $fields = tripal_chado_get_bundle_fields($entity_type, $bundle, $term);
  508. foreach ($fields as $field_name => $field_info) {
  509. tripal_update_bundle_field($field_name, $field_info, $entity_type, $bundle_name);
  510. }
  511. }
  512. /**
  513. * Implements hook_add_bundle_fields().
  514. */
  515. function tripal_chado_add_bundle_fields($entity_type, $bundle, $term) {
  516. // Get the list of fields that should be attached to this bundle and
  517. // add them.
  518. $bundle_name = $bundle->name;
  519. $fields = tripal_chado_get_bundle_fields($entity_type, $bundle, $term);
  520. foreach ($fields as $field_name => $field_info) {
  521. tripal_add_bundle_field($field_name, $field_info, $entity_type, $bundle_name);
  522. }
  523. }
  524. /**
  525. * Retreives a list of the fields that should be attached to the bundle.
  526. *
  527. * @return
  528. * An associative array of fields to attach to the bundle. The keys are the
  529. * field names and the values is an info array that can be passed to the
  530. * tripal_add_bundle_field() function.
  531. */
  532. function tripal_chado_get_bundle_fields($entity_type, $bundle, $term) {
  533. $fields = array();
  534. $bundle_name = $bundle->name;
  535. // This array will hold details that map the bundle to tables in Chado.
  536. $bundle_data = array();
  537. // Get the cvterm that corresponds to this TripalTerm object.
  538. $vocab = entity_load('TripalVocab', array($term->vocab_id));
  539. $vocab = reset($vocab);
  540. $match = array(
  541. 'dbxref_id' => array(
  542. 'db_id' => array(
  543. 'name' => $vocab->namespace,
  544. ),
  545. 'accession' => $term->accession
  546. ),
  547. );
  548. $cvterm = chado_generate_var('cvterm', $match);
  549. // The organism table does not have a type_id so we won't ever find
  550. // a record for it in the tripal_cv_defaults table.
  551. if ($cvterm->name == 'organism') {
  552. $bundle_data = array(
  553. 'cv_id' => $cvterm->cv_id->cv_id,
  554. 'cvterm_id' => $cvterm->cvterm_id,
  555. 'data_table' => 'organism',
  556. 'type_table' => 'organism',
  557. 'field' => '',
  558. );
  559. }
  560. // The analysis table does not have a type_id so we won't ever find
  561. // a record for it in the tripalcv_defaults table.
  562. else if ($cvterm->name == 'analysis') {
  563. $bundle_data = array(
  564. 'cv_id' => $cvterm->cv_id->cv_id,
  565. 'cvterm_id' => $cvterm->cvterm_id,
  566. 'data_table' => 'analysis',
  567. 'type_table' => 'analysis',
  568. 'field' => '',
  569. );
  570. }
  571. else if ($cvterm->name == 'project') {
  572. $bundle_data = array(
  573. 'cv_id' => $cvterm->cv_id->cv_id,
  574. 'cvterm_id' => $cvterm->cvterm_id,
  575. 'data_table' => 'project',
  576. 'type_table' => 'project',
  577. 'field' => '',
  578. );
  579. }
  580. else {
  581. // TODO: WHAT TO DO IF A VOCABULARY IS USED AS A DEFAULT FOR MULTIPLE
  582. // TABLES.
  583. // Look to see if this vocabulary is used as a default for any table.
  584. $default = db_select('tripal_cv_defaults', 't')
  585. ->fields('t')
  586. ->condition('cv_id', $cvterm->cv_id->cv_id)
  587. ->execute()
  588. ->fetchObject();
  589. if ($default) {
  590. $bundle_data = array(
  591. 'cv_id' => $cvterm->cv_id->cv_id,
  592. 'cvterm_id' => $cvterm->cvterm_id,
  593. 'data_table' => $default->table_name,
  594. 'type_table' => $default->table_name,
  595. 'field' => $default->field_name,
  596. );
  597. }
  598. }
  599. // Save the mapping information so that we can reuse it when we need to
  600. // look things up for later for an entity
  601. tripal_set_bundle_variable('chado_cvterm_id', $bundle->id, $bundle_data['cvterm_id']);
  602. tripal_set_bundle_variable('chado_table', $bundle->id, $bundle_data['data_table']);
  603. tripal_set_bundle_variable('chado_column', $bundle->id, $bundle_data['field']);
  604. // Find all of the files in the tripal_chado/includes/fields directory.
  605. $fields_path = drupal_get_path('module', 'tripal_chado') . '/includes/fields';
  606. $field_files = file_scan_directory($fields_path, '/^chado_.*\.inc$/');
  607. // Iterate through the fields, include the file and run the info function.
  608. foreach ($field_files as $file) {
  609. $field_type = $file->name;
  610. module_load_include('inc', 'tripal_chado', 'includes/fields/' . $field_type);
  611. if (preg_match('/^chado/', $field_type) and class_exists($field_type)) {
  612. $field_obj = new $field_type();
  613. $field_info = $field_obj->attach_info($entity_type, $bundle, $bundle_data);
  614. }
  615. $function = $field_type . '_attach_info';
  616. if (function_exists($function)) {
  617. $field_info = $function($entity_type, $bundle, $bundle_data);
  618. }
  619. if (!is_array($field_info) or count(array_keys($field_info)) == 0) {
  620. continue;
  621. }
  622. $field_name = $field_info['field_name'];
  623. $fields[$field_name] = $field_info;
  624. }
  625. // Adds any remaining base fields that may not have been dealt with
  626. // by a custom field.
  627. tripal_chado_add_bundle_fields_base__fields($fields, $entity_type, $bundle_name, $bundle_data);
  628. return $fields;
  629. }
  630. /**
  631. * Adds the fields for the base table to the entity.
  632. */
  633. function tripal_chado_add_bundle_fields_base__fields(&$fields, $entity_type_name, $bundle_name, $bundle_data) {
  634. $table_name = $bundle_data['data_table'];
  635. $type_table = $bundle_data['type_table'];
  636. $type_field = $bundle_data['field'];
  637. // Iterate through the columns of the table and see if fields have been
  638. // created for each one. If not, then create them.
  639. $schema = chado_get_schema($table_name);
  640. $columns = $schema['fields'];
  641. foreach ($columns as $column_name => $details) {
  642. $field_name = $table_name . '__' . $column_name;
  643. // Skip the primary key field.
  644. if ($column_name == $schema['primary key'][0]) {
  645. continue;
  646. }
  647. // Skip the type field.
  648. if ($table_name == $type_table and $column_name == $type_field) {
  649. continue;
  650. }
  651. // Get the field defaults for this column.
  652. $field_info = tripal_chado_add_bundle_fields_base__fields_defaults($table_name, $schema, $column_name);
  653. // TODO: add in a call to drupal_alter to allow other modules to change
  654. // the field settings.
  655. // Determine if the field is required.
  656. if (array_key_exists('not null', $details) and $details['not null'] === TRUE) {
  657. $field_info['is_required'] = array_key_exists('default', $details) ? 0 : 1;
  658. }
  659. // If we don't have a field type then we don't need to create a field.
  660. if (!$field_info['field_type']) {
  661. // If we don't have a field type but it is required and doesn't have
  662. // a default value then we are in trouble.
  663. if ($field_info['is_required'] and !array_key_exists('default', $details)) {
  664. throw new Exception(t('The %table.%field type, %type, is not yet supported for Entity fields, but it is required,',
  665. array('%table' => $table_name, '%field' => $column_name, '%type' => $details['type'])));
  666. }
  667. continue;
  668. }
  669. // If this field is a foreign key field then we will have a custom field.
  670. $is_fk = FALSE;
  671. if (array_key_exists('foreign keys', $schema)) {
  672. foreach ($schema['foreign keys'] as $remote_table => $fk_details) {
  673. if (array_key_exists($column_name, $fk_details['columns'])) {
  674. $is_fk = TRUE;
  675. }
  676. }
  677. }
  678. // Add the field to the bundle.
  679. $fields[$field_name] = $field_info;
  680. //tripal_add_bundle_field($field_name, $field_info, $entity_type_name, $bundle_name);
  681. }
  682. }
  683. /**
  684. * Implements hook_field_attach_validate().
  685. *
  686. * This function is used to validate entity-wide validation any of the fields
  687. * attached to an entity.
  688. */
  689. function tripal_chado_field_attach_validate($entity_type, $entity, &$errors) {
  690. $bundle_name = $entity->bundle;
  691. $bundle = tripal_load_bundle_entity(array('name' => $bundle_name));
  692. $term = tripal_load_term_entity(array('term_id' => $bundle->term_id));
  693. // Provide some higher-level validation for the organism type.
  694. if ($term->name == 'organism') {
  695. }
  696. }