tripal_chado.fields.inc 27 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808
  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. If no child
  213. * argument is specified then the 'value' field is set.
  214. *
  215. * @param $field_name
  216. * The name of the field to set.
  217. * @param $form_state
  218. * The form's form_state array.
  219. * @param $newvalue
  220. * The new value to set for the field.
  221. * @param $delta
  222. * If cardinality of a field is greater than 1 the delta indicates
  223. * which instance to set.
  224. * @param $child
  225. * The name of the property to set iff other than 'value'.
  226. *
  227. * @return
  228. * TRUE if the value was set, FALSE otherwise.
  229. */
  230. function tripal_chado_set_field_form_values($field_name, &$form_state, $newvalue, $delta = 0, $child = NULL) {
  231. // The form_state must have the 'values' key. If not then just return.
  232. if (!array_key_exists('values', $form_state)) {
  233. return FALSE;
  234. }
  235. // If the field name is not in the form_state['values'] then reutrn.
  236. if (!array_key_exists($field_name, $form_state['values'])) {
  237. return FALSE;
  238. }
  239. foreach ($form_state['values'][$field_name] as $langcode => $items) {
  240. if ($child) {
  241. $form_state['values'][$field_name][$langcode][$delta][$child] = $newvalue;
  242. }
  243. else {
  244. $form_state['values'][$field_name][$langcode][$delta]['value'] = $newvalue;
  245. }
  246. }
  247. return TRUE;
  248. }
  249. /**
  250. * Implements hook_field_widget_form_alter().
  251. */
  252. function tripal_chado_field_widget_form_alter(&$element, &$form_state, $context) {
  253. if (array_key_exists('#field_name', $element)) {
  254. $field_name = $element['#field_name'];
  255. $matches = array();
  256. if (preg_match('/(.+?)__(.+?)$/', $field_name, $matches)) {
  257. $tablename = $matches[1];
  258. $colname = $matches[2];
  259. $schema = chado_get_schema($tablename);
  260. if (!$schema) {
  261. return;
  262. }
  263. // The timelastmodified field exists in many Chado tables. We want
  264. // the form element to update to the most recent time rather than the time
  265. // in the database.
  266. if ($colname == 'timelastmodified' and $schema['fields'][$colname]['type'] == 'datetime') {
  267. // We want the default value for the field to be the current time.
  268. $element['#default_value']['value'] = format_date(time(), 'custom', "Y-m-d H:i:s", 'UTC');
  269. $element['#date_items']['value'] = $element['#default_value']['value'];
  270. }
  271. // We want the date combo fieldset to be collaspible so we will
  272. // add our own theme_wrapper to replace the one added by the date
  273. // module.
  274. if (array_key_exists($colname, $schema['fields']) and $schema['fields'][$colname]['type'] == 'datetime') {
  275. $element['#theme_wrappers'] = array('tripal_chado_date_combo');
  276. }
  277. }
  278. }
  279. }
  280. /**
  281. * Returns a $field_info array for a field based on a database column.
  282. *
  283. */
  284. function tripal_chado_get_bundle_fields_base__fields_defaults($table_name, $schema, $column_name) {
  285. $details = $schema['fields'][$column_name];
  286. // Create an array with information about this field.
  287. $field = array(
  288. 'field_type' => '',
  289. 'widget_type' => '',
  290. 'description' => '',
  291. 'label' => ucwords(preg_replace('/_/', ' ', $column_name)),
  292. 'is_required' => 0,
  293. 'storage' => 'field_chado_storage',
  294. 'widget_settings' => array(
  295. 'display_label' => 1
  296. ),
  297. 'field_settings' => array(
  298. // The table in Chado where this field maps to.
  299. 'chado_table' => $table_name,
  300. // The column in the Chado table that this field maps to.
  301. 'chado_column' => $column_name,
  302. 'semantic_web' => '',
  303. ),
  304. );
  305. // Alter the field info array depending on the column details.
  306. switch($details['type']) {
  307. case 'char':
  308. $field['field_type'] = 'text';
  309. $field['widget_type'] = 'text_textfield';
  310. $field['field_settings']['max_length'] = $details['length'];
  311. break;
  312. case 'varchar':
  313. $field['field_type'] = 'text';
  314. $field['widget_type'] = 'text_textfield';
  315. $field['field_settings']['max_length'] = $details['length'];
  316. break;
  317. case 'text':
  318. $field['field_type'] = 'text';
  319. $field['widget_type'] = 'text_textarea';
  320. $field['field_settings']['max_length'] = 17179869184;
  321. $field['field_settings']['text_processing'] = 1;
  322. $field['format'] = filter_default_format();
  323. break;
  324. case 'blob':
  325. // not sure how to support a blob field.
  326. continue;
  327. break;
  328. case 'int':
  329. $field['field_type'] = 'number_integer';
  330. $field['widget_type'] = 'number';
  331. break;
  332. case 'float':
  333. $field['field_type'] = 'number_float';
  334. $field['widget_type'] = 'number';
  335. $field['field_settings']['precision'] = 10;
  336. $field['field_settings']['scale'] = 2;
  337. $field['field_settings']['decimal_separator'] = '.';
  338. break;
  339. case 'numeric':
  340. $field['field_type'] = 'number_decimal';
  341. $field['widget_type'] = 'number';
  342. break;
  343. case 'serial':
  344. // Serial fields are most likely not needed as a field.
  345. break;
  346. case 'boolean':
  347. $field['field_type'] = 'list_boolean';
  348. $field['widget_type'] = 'options_onoff';
  349. $field['field_settings']['allowed_values'] = array(0 => "No", 1 => "Yes");
  350. break;
  351. case 'datetime':
  352. // Use the Drupal Date and Date API to create the field/widget
  353. $field['field_type'] = 'datetime';
  354. $field['widget_type'] = 'date_select';
  355. $field['widget_settings']['increment'] = 1;
  356. $field['widget_settings']['tz_handling'] = 'none';
  357. $field['widget_settings']['collapsible'] = TRUE;
  358. // TODO: Add settings so that the minutes increment by 1.
  359. // And turn off the timezone, as the Chado field doesn't support it.
  360. break;
  361. }
  362. // Set some default semantic web information
  363. if ($column_name == 'uniquename') {
  364. $field['widget_type'] = 'text_textfield';
  365. $field['field_settings']['text_processing'] = 0;
  366. }
  367. elseif ($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. // PUB TABLE
  383. //
  384. elseif ($field['field_settings']['chado_table'] == 'pub' 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. }
  389. //
  390. // ANALYSIS TABLE
  391. //
  392. elseif ($field['field_settings']['chado_table'] == 'analysis' and $field['field_settings']['chado_column'] == 'program') {
  393. $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.';
  394. $field['label'] = 'Program, Pipeline, Workflow or Method Name.';
  395. }
  396. elseif ($field['field_settings']['chado_table'] == 'analysis' and $field['field_settings']['chado_column'] == 'sourceuri') {
  397. $field['field_type'] = 'text';
  398. $field['widget_type'] = 'text_textfield';
  399. $field['field_settings']['text_processing'] = 0;
  400. $field['label'] = 'Source URL';
  401. $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.';
  402. }
  403. elseif ($field['field_settings']['chado_table'] == 'analysis' and $field['field_settings']['chado_column'] == 'sourcename') {
  404. $field['label'] = 'Source Name';
  405. $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.';
  406. }
  407. elseif ($field['field_settings']['chado_table'] == 'analysis' and $field['field_settings']['chado_column'] == 'sourceversion') {
  408. $field['label'] = 'Source Version';
  409. $field['description'] = 'If hte source data set has a version include it here.';
  410. }
  411. elseif ($field['field_settings']['chado_table'] == 'analysis' and $field['field_settings']['chado_column'] == 'algorithm') {
  412. $field['label'] = 'Source Version';
  413. $field['description'] = 'The name of the algorithm used to produce the dataset if different from the program.';
  414. }
  415. elseif ($field['field_settings']['chado_table'] == 'analysis' and $field['field_settings']['chado_column'] == 'programversion') {
  416. $field['label'] = 'Program Version';
  417. $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.';
  418. }
  419. //
  420. // PROJECT TABLE
  421. //
  422. elseif ($field['field_settings']['chado_table'] == 'project' and $field['field_settings']['chado_column'] == 'description') {
  423. $field['label'] = 'Short Description';
  424. }
  425. return $field;
  426. }
  427. /**
  428. * Implements hook_form_FORM_ID_alter().
  429. *
  430. * The field_ui_display_overview_form is used for formatting the display
  431. * or layout of fields attached to an entity and shown on the entity view page.
  432. *
  433. * This function removes the cvterm class and property adder field as those are
  434. * really not meant for users to show or manage.
  435. */
  436. function tripal_chado_form_field_ui_display_overview_form_alter(&$form, &$form_state, $form_id) {
  437. // Remove the kvproperty_addr field as it isn't ever displayed. It's just used
  438. // on the add/edit form of an entity for adding new property fields.
  439. $fields_names = element_children($form['fields']);
  440. foreach ($fields_names as $field_name) {
  441. $field_info = field_info_field($field_name);
  442. if ($field_info['type'] == 'kvproperty_adder') {
  443. unset($form['fields'][$field_name]);
  444. }
  445. if ($field_info['type'] == 'cvterm_class_adder') {
  446. unset($form['fields'][$field_name]);
  447. }
  448. }
  449. }
  450. /**
  451. * Implements hook_form_FORM_ID_alter().
  452. *
  453. * The field_ui_field_overview_form is used for ordering and configuring the
  454. * fields attached to an entity.
  455. *
  456. * This function removes the property adder field as that is really not meant
  457. * for users to show or manage.
  458. */
  459. function tripal_chado_form_field_ui_field_overview_form_alter(&$form, &$form_state, $form_id) {
  460. // Remove the kvproperty_addr field as it isn't ever displayed. It's just used
  461. // on the add/edit form of an entity for adding new property fields.
  462. $fields_names = element_children($form['fields']);
  463. foreach ($fields_names as $field_name) {
  464. $field_info = field_info_field($field_name);
  465. if ($field_info['type'] == 'kvproperty_adder') {
  466. unset($form['fields'][$field_name]);
  467. }
  468. if ($field_info['type'] == 'cvterm_class_adder') {
  469. unset($form['fields'][$field_name]);
  470. }
  471. }
  472. }
  473. /**
  474. * Implements hook_field_is_empty().
  475. */
  476. function tripal_chado_field_is_empty($item, $field) {
  477. // If there is no value field then the field is empty.
  478. if (!array_key_exists('value', $item)) {
  479. return TRUE;
  480. }
  481. // Iterate through all of the fields and if at least one has a value
  482. // the field is not empty.
  483. foreach ($item as $form_field_name => $value) {
  484. if (isset($value) and $value != NULL and $value != '') {
  485. return FALSE;
  486. }
  487. }
  488. // Otherwise, the field is empty.
  489. return TRUE;
  490. }
  491. /**
  492. * Implements hook_update_bundle_fields().
  493. *
  494. */
  495. function tripal_chado_update_bundle_fields($entity_type, $bundle, $term) {
  496. // Get the list of fields that should be attached to this bundle and
  497. // add them.
  498. $bundle_name = $bundle->name;
  499. $fields = tripal_chado_get_bundle_fields($entity_type, $bundle, $term);
  500. foreach ($fields as $field_name => $field_info) {
  501. tripal_update_bundle_field($field_name, $field_info, $entity_type, $bundle_name);
  502. }
  503. }
  504. /**
  505. * Implements hook_add_bundle_fields().
  506. */
  507. function tripal_chado_add_bundle_fields($entity_type, $bundle, $term) {
  508. // Get the list of fields that should be attached to this bundle and
  509. // add them.
  510. $bundle_name = $bundle->name;
  511. $fields = tripal_chado_get_bundle_fields($entity_type, $bundle, $term);
  512. foreach ($fields as $field_name => $field_info) {
  513. tripal_add_bundle_field($field_name, $field_info, $entity_type, $bundle_name);
  514. }
  515. }
  516. /**
  517. * Retreives a list of the fields that should be attached to the bundle.
  518. *
  519. * @return
  520. * An associative array of fields to attach to the bundle. The keys are the
  521. * field names and the values is an info array that can be passed to the
  522. * tripal_add_bundle_field() function.
  523. */
  524. function tripal_chado_get_bundle_fields($entity_type, $bundle, $term) {
  525. $fields = array();
  526. $bundle_name = $bundle->name;
  527. // This array will hold details that map the bundle to tables in Chado.
  528. $bundle_data = array();
  529. // Get the cvterm that corresponds to this TripalTerm object.
  530. $vocab = entity_load('TripalVocab', array($term->vocab_id));
  531. $vocab = reset($vocab);
  532. $match = array(
  533. 'dbxref_id' => array(
  534. 'db_id' => array(
  535. 'name' => $vocab->vocabulary,
  536. ),
  537. 'accession' => $term->accession
  538. ),
  539. );
  540. $cvterm = chado_generate_var('cvterm', $match);
  541. // The organism table does not have a type_id so we won't ever find
  542. // a record for it in the tripal_cv_defaults table.
  543. if ($cvterm->name == 'organism') {
  544. $bundle_data = array(
  545. 'cv_id' => $cvterm->cv_id->cv_id,
  546. 'cvterm_id' => $cvterm->cvterm_id,
  547. 'data_table' => 'organism',
  548. 'type_table' => 'organism',
  549. 'field' => '',
  550. );
  551. }
  552. // The analysis table does not have a type_id so we won't ever find
  553. // a record for it in the tripalcv_defaults table.
  554. else if ($cvterm->name == 'analysis') {
  555. $bundle_data = array(
  556. 'cv_id' => $cvterm->cv_id->cv_id,
  557. 'cvterm_id' => $cvterm->cvterm_id,
  558. 'data_table' => 'analysis',
  559. 'type_table' => 'analysis',
  560. 'field' => '',
  561. );
  562. }
  563. else if ($cvterm->name == 'project') {
  564. $bundle_data = array(
  565. 'cv_id' => $cvterm->cv_id->cv_id,
  566. 'cvterm_id' => $cvterm->cvterm_id,
  567. 'data_table' => 'project',
  568. 'type_table' => 'project',
  569. 'field' => '',
  570. );
  571. }
  572. else {
  573. // TODO: WHAT TO DO IF A VOCABULARY IS USED AS A DEFAULT FOR MULTIPLE
  574. // TABLES.
  575. // Look to see if this vocabulary is used as a default for any table.
  576. $default = db_select('tripal_cv_defaults', 't')
  577. ->fields('t')
  578. ->condition('cv_id', $cvterm->cv_id->cv_id)
  579. ->execute()
  580. ->fetchObject();
  581. if ($default) {
  582. $bundle_data = array(
  583. 'cv_id' => $cvterm->cv_id->cv_id,
  584. 'cvterm_id' => $cvterm->cvterm_id,
  585. 'data_table' => $default->table_name,
  586. 'type_table' => $default->table_name,
  587. 'field' => $default->field_name,
  588. );
  589. }
  590. }
  591. // Save the mapping information so that we can reuse it when we need to
  592. // look things up for later for an entity
  593. tripal_set_bundle_variable('chado_cvterm_id', $bundle->id, $bundle_data['cvterm_id']);
  594. tripal_set_bundle_variable('chado_table', $bundle->id, $bundle_data['data_table']);
  595. tripal_set_bundle_variable('chado_column', $bundle->id, $bundle_data['field']);
  596. // Find all of the files in the tripal_chado/includes/fields directory.
  597. $fields_path = drupal_get_path('module', 'tripal_chado') . '/includes/fields';
  598. $field_files = file_scan_directory($fields_path, '/^chado_.*\.inc$/');
  599. // Add fields from the base table.
  600. tripal_chado_get_bundle_fields_base__fields($fields, $entity_type, $bundle_name, $bundle_data);
  601. // Iterate through the fields, include the file and run the info function.
  602. foreach ($field_files as $file) {
  603. $field_type = $file->name;
  604. module_load_include('inc', 'tripal_chado', 'includes/fields/' . $field_type);
  605. if (preg_match('/^chado/', $field_type) and class_exists($field_type)) {
  606. $field_obj = new $field_type();
  607. $field_info = $field_obj->attach_info($entity_type, $bundle, $bundle_data);
  608. }
  609. $function = $field_type . '_attach_info';
  610. if (function_exists($function)) {
  611. $field_info = $function($entity_type, $bundle, $bundle_data);
  612. }
  613. if (!is_array($field_info) or count(array_keys($field_info)) == 0) {
  614. continue;
  615. }
  616. $field_name = $field_info['field_name'];
  617. $fields[$field_name] = $field_info;
  618. }
  619. // Add in the semantic web details
  620. foreach ($fields as $field_name => $field) {
  621. if (!array_key_exists('chado_table', $field['field_settings'])) {
  622. continue;
  623. }
  624. $chado_column = $field['field_settings']['chado_column'];
  625. $chado_table = $field['field_settings']['chado_table'];
  626. // Get the semantic web mapping for this field. First look for a
  627. // table specific mapping.
  628. $smweb = db_select('chado_semweb', 'CS')
  629. ->fields('CS')
  630. ->condition('chado_column', $chado_column)
  631. ->condition('chado_table', $chado_table)
  632. ->execute()
  633. ->fetchObject();
  634. // We don't have a table/column specific mapping, so let's look for a
  635. // generic column mapping.
  636. if (!$smweb) {
  637. $smweb = db_select('chado_semweb', 'CS')
  638. ->fields('CS')
  639. ->condition('chado_column', $chado_column)
  640. ->execute()
  641. ->fetchObject();
  642. }
  643. if ($smweb) {
  644. $cvterm = tripal_get_cvterm(array('cvterm_id' => $smweb->cvterm_id));
  645. $fields[$field_name]['field_settings']['semantic_web'] = $cvterm->dbxref_id->db_id->name . ':' . $cvterm->dbxref_id->accession;
  646. }
  647. }
  648. return $fields;
  649. }
  650. /**
  651. * Adds the fields for the base table to the entity.
  652. */
  653. function tripal_chado_get_bundle_fields_base__fields(&$fields, $entity_type_name, $bundle_name, $bundle_data) {
  654. $table_name = $bundle_data['data_table'];
  655. $type_table = $bundle_data['type_table'];
  656. $type_field = $bundle_data['field'];
  657. // Iterate through the columns of the table and see if fields have been
  658. // created for each one. If not, then create them.
  659. $schema = chado_get_schema($table_name);
  660. $columns = $schema['fields'];
  661. foreach ($columns as $column_name => $details) {
  662. $field_name = $table_name . '__' . $column_name;
  663. // Skip the primary key field.
  664. if ($column_name == $schema['primary key'][0]) {
  665. continue;
  666. }
  667. // Skip the type field.
  668. if ($table_name == $type_table and $column_name == $type_field) {
  669. continue;
  670. }
  671. // Get the field defaults for this column.
  672. $field_info = tripal_chado_get_bundle_fields_base__fields_defaults($table_name, $schema, $column_name);
  673. // TODO: add in a call to drupal_alter to allow other modules to change
  674. // the field settings.
  675. // Determine if the field is required.
  676. if (array_key_exists('not null', $details) and $details['not null'] === TRUE) {
  677. $field_info['is_required'] = array_key_exists('default', $details) ? 0 : 1;
  678. }
  679. // If we don't have a field type then we don't need to create a field.
  680. if (!$field_info['field_type']) {
  681. // If we don't have a field type but it is required and doesn't have
  682. // a default value then we are in trouble.
  683. if ($field_info['is_required'] and !array_key_exists('default', $details)) {
  684. throw new Exception(t('The %table.%field type, %type, is not yet supported for Entity fields, but it is required,',
  685. array('%table' => $table_name, '%field' => $column_name, '%type' => $details['type'])));
  686. }
  687. continue;
  688. }
  689. // If this field is a foreign key field then we will have a custom field.
  690. $is_fk = FALSE;
  691. if (array_key_exists('foreign keys', $schema)) {
  692. foreach ($schema['foreign keys'] as $remote_table => $fk_details) {
  693. if (array_key_exists($column_name, $fk_details['columns'])) {
  694. $is_fk = TRUE;
  695. }
  696. }
  697. }
  698. // Add the field to the bundle.
  699. $fields[$field_name] = $field_info;
  700. }
  701. }