'', 'chado_column' => '', 'base_table' => '', 'semantic_web' => '', ); // Set this to the name of the storage backend that by default will support // this field. public static $default_storage = 'field_chado_storage'; /** * @see TripalField::create_info() */ function createInfo() { if (!$this->can_attach) { return; } $table_name = $this->details['chado_table']; $type_table = $this->details['chado_type_table']; $type_field = $this->details['chado_type_column']; $cv_id = $this->details['chado_cv_id']; $cvterm_id = $this->details['chado_cvterm_id']; $dbxref_table = $table_name . '_dbxref'; $schema = chado_get_schema($dbxref_table); $pkey = $schema['primary key'][0]; return array( 'field_name' => $this->field_name, 'type' => 'chado_linker__dbxref', 'cardinality' => FIELD_CARDINALITY_UNLIMITED, 'locked' => FALSE, 'storage' => array( 'type' => 'field_chado_storage', ), 'settings' => array( 'chado_table' => $dbxref_table, 'chado_column' => $pkey, 'base_table' => $table_name, 'semantic_web' => 'SBO:0000554', ), ); } /** * @see TripalField::createInstanceInfo() */ function createInstanceInfo() { if (!$this->can_attach) { return; } $table_name = $this->details['chado_table']; $type_table = $this->details['chado_type_table']; $type_field = $this->details['chado_type_column']; $cv_id = $this->details['chado_cv_id']; $cvterm_id = $this->details['chado_cvterm_id']; $dbxref_table = $table_name . '_dbxref'; return array( 'field_name' => $this->field_name, 'entity_type' => $this->entity_type, 'bundle' => $this->bundle->name, 'label' => 'Cross References', 'description' => 'The IDs where this record may be available in other external online databases.', 'required' => FALSE, 'settings' => array( 'auto_attach' => FALSE, ), 'widget' => array( 'type' => 'chado_linker__dbxref_widget', 'settings' => array( 'display_label' => 1, ), ), 'display' => array( 'default' => array( 'label' => 'inline', 'type' => 'chado_linker__dbxref_formatter', 'settings' => array(), ), ), ); } /** * @see TripalField::widgetInfo() */ public static function widgetInfo() { return array( 'chado_linker__dbxref_widget' => array( 'label' => t('Cross references'), 'field types' => array('chado_linker__dbxref'), 'description' => t('This record can be cross referenced with a record in another online database. This field is intended for the most prominent reference. At a minimum, the database and accession must be provided.'), ), ); } /** * @see TripalField::formatterInfo() */ static function formatterInfo() { return array( 'chado_linker__dbxref_formatter' => array( 'label' => t('Cross references'), 'field types' => array('chado_linker__dbxref'), 'settings' => array( ), ), ); } /** * @see TripalField::formatterView() */ static function formatterView(&$element, $entity_type, $entity, $field, $instance, $langcode, $items, $display) { $chado_table = $field['settings']['chado_table']; foreach ($items as $delta => $item) { if (!$item['value']) { continue; } $content = $item['value']['vocabulary'] . ':' . $item['value']['accession']; if ($item['value']['URL']) { $content = l($item['value']['URL'], $item['value']['URL']); } $element[$delta] = array( '#type' => 'markup', '#markup' => $content, ); } if (count($items) == 0) { $element[$delta] = array( '#type' => 'markup', '#markup' => '', ); } } /** * @see TripalField::widgetForm() */ public static function widgetForm(&$widget, &$form, &$form_state, $field, $instance, $langcode, $items, $delta, $element) { $field_name = $field['field_name']; $field_type = $field['type']; $field_table = $field['settings']['chado_table']; $field_column = $field['settings']['chado_column']; // Get the FK column that links to the base table. $chado_table = $field['settings']['chado_table']; $base_table = $field['settings']['base_table']; $schema = chado_get_schema($chado_table); $pkey = $schema['primary key'][0]; $fkeys = array_values($schema['foreign keys'][$base_table]['columns']); $fkey = $fkeys[0]; // Get the field defaults. $record_id = ''; $fkey_value = ''; $dbxref_id = ''; $db_id = ''; $accession = ''; $version = ''; $description = ''; // If the field already has a value then it will come through the $items // array. This happens when editing an existing record. if (array_key_exists($delta, $items)) { $record_id = $items[$delta][$field_table . '__' . $pkey]; $fkey_value = $items[$delta][$field_table . '__' . $fkey]; $dbxref_id = $items[$delta][$field_table . '__dbxref_id']; $db_id = $items[$delta][$field_table . '__dbxref_id--db_id']; $accession = $items[$delta][$field_table . '__dbxref_id--accession']; $version = $items[$delta][$field_table . '__dbxref_id--version']; $description = $items[$delta][$field_table . '__dbxref_id--description']; } // Check $form_state['values'] to see if an AJAX call set the values. if (array_key_exists('values', $form_state) and array_key_exists($delta, $form_state['values'])) { // $record_id = tripal_chado_get_field_form_values($field_name, $form_state, $delta, $field_table . '__' . $pkey); // $fkey_value = tripal_chado_get_field_form_values($field_name, $form_state, $delta, $field_table . '__' . $fkey); // $dbxref_id = tripal_chado_get_field_form_values($field_name, $form_state, $delta, $field_table . '__dbxref_id'); // $db_id = tripal_chado_get_field_form_values($field_name, $form_state, $delta, $field_table . '__dbxref_id--db_id'); // $accession = tripal_chado_get_field_form_values($field_name, $form_state, $delta, $field_table . '__dbxref_id--accession'); // $version = tripal_chado_get_field_form_values($field_name, $form_state, $delta, $field_table . '__dbxref_id--version'); // $description = tripal_chado_get_field_form_values($field_name, $form_state, $delta, $field_table . '__dbxref_id--description'); } $schema = chado_get_schema('dbxref'); $options = tripal_get_db_select_options(); $widget['#table_name'] = $chado_table; $widget['#fkey_field'] = $fkey; //$widget['#element_validate'] = array('chado_linker__dbxref_widget_validate'); $widget['#theme'] = 'chado_linker__dbxref_widget'; $widget['#prefix'] = ""; $widget['#suffix'] = ""; $widget['value'] = array( '#type' => 'value', '#value' => array_key_exists($delta, $items) ? $items[$delta]['value'] : '', ); $widget[$field_table . '__' . $pkey] = array( '#type' => 'value', '#default_value' => $record_id, ); $widget[$field_table . '__' . $fkey] = array( '#type' => 'value', '#default_value' => $fkey_value, ); $widget[$field_table . '__dbxref_id'] = array( '#type' => 'value', '#default_value' => $dbxref_id, ); $widget[$field_table . '__dbxref_id--dbxref_id'] = array( '#type' => 'value', '#default_value' => $dbxref_id, ); $widget[$field_table . '__dbxref_id--db_id'] = array( '#type' => 'select', '#title' => t('Database'), '#options' => $options, '#required' => $element['#required'], '#default_value' => $db_id, '#ajax' => array( 'callback' => "chado_linker__dbxref_widget_form_ajax_callback", 'wrapper' => "$field_name-dbxref--db-id-$delta", 'effect' => 'fade', 'method' => 'replace' ), ); $widget[$field_table . '__dbxref_id--accession'] = array( '#type' => 'textfield', '#title' => t('Accession'), '#default_value' => $accession, '#required' => $element['#required'], '#maxlength' => array_key_exists('length', $schema['fields']['accession']) ? $schema['fields']['accession']['length'] : 255, '#size' => 15, '#autocomplete_path' => 'admin/tripal/storage/chado/auto_name/dbxref/' . $db_id, '#ajax' => array( 'callback' => "chado_linker__dbxref_widget_form_ajax_callback", 'wrapper' => "$field_name-dbxref--db-id-$delta", 'effect' => 'fade', 'method' => 'replace' ), '#disabled' => $db_id ? FALSE : TRUE, ); $widget[$field_table . '__dbxref_id--version'] = array( '#type' => 'textfield', '#title' => t('Version'), '#default_value' => $version, '#maxlength' => array_key_exists('length', $schema['fields']['version']) ? $schema['fields']['version']['length'] : 255, '#size' => 5, '#disabled' => $db_id ? FALSE : TRUE, ); $widget[$field_table . '__dbxref_id--description'] = array( '#type' => 'textfield', '#title' => t('Description'), '#default_value' => $description, '#size' => 20, '#disabled' => $db_id ? FALSE : TRUE, ); if (!$db_id) { $widget['links'] = array( '#type' => 'item', '#markup' => l('Add a database', 'admin/tripal/legacy/tripal_db/add', array('attributes' => array('target' => '_blank'))) ); } } /** * @see TripalField::load() */ static function load($field, $entity, $details = array()) { $record = $details['record']; $field_name = $field['field_name']; $field_type = $field['type']; $field_table = $field['settings']['chado_table']; $field_column = $field['settings']['chado_column']; $base_table = $record->tablename; $schema = chado_get_schema($field_table); $pkey = $schema['primary key'][0]; $fkeys = array_values($schema['foreign keys'][$base_table]['columns']); $fkey = $fkeys[0]; // Set some defaults for the empty record. $entity->{$field_name}['und'][0] = array( 'value' => array(), $field_table . '__' . $pkey => '', $field_table . '__' . $fkey => '', $field_table . '__dbxref_id' => '', $field_table . '__dbxref_id--dbxref_id' => '', $field_table . '__dbxref_id--db_id' => '', $field_table . '__dbxref_id--accession' => '', $field_table . '__dbxref_id--version' => '', $field_table . '__dbxref_id--description' => '', ); $linker_table = $base_table . '_dbxref'; $options = array('return_array' => 1); $record = chado_expand_var($record, 'table', $linker_table, $options); if (count($record->$linker_table) > 0) { $i = 0; foreach ($record->$linker_table as $index => $linker) { $dbxref = $linker->dbxref_id; $URL = tripal_get_dbxref_url($dbxref); $entity->{$field_name}['und'][$i] = array( 'value' => array( 'vocabulary' => $dbxref->db_id->name, 'accession' => $dbxref->accession, 'URL' => $URL, ), $field_table . '__' . $pkey => $linker->$pkey, $field_table . '__' . $fkey => $linker->$fkey->$fkey, $field_table . '__dbxref_id' => $dbxref->dbxref_id, $field_table . '__dbxref_id--dbxref_id' => $dbxref->dbxref_id, $field_table . '__dbxref_id--db_id' => $dbxref->db_id->db_id, $field_table . '__dbxref_id--accession' => $dbxref->accession, $field_table . '__dbxref_id--version' => $dbxref->version, $field_table . '__dbxref_id--description' => $dbxref->description, ); $i++; } } } } /** * Theme function for the dbxref_id_widget. * * @param $variables */ function theme_chado_linker__dbxref_widget($variables) { $element = $variables['element']; // These two fields were added to the widget to help identify the fields // for layout. $table_name = $element['#table_name']; $fkey = $element['#fkey_field']; $layout = "
" . drupal_render($element[$table_name . '__dbxref_id--db_id']) . "
" . drupal_render($element[$table_name . '__dbxref_id--accession']) . "
" . drupal_render($element[$table_name . '__dbxref_id--version']) . "
" . drupal_render($element[$table_name . '__dbxref_id--description']) . "
" . drupal_render($element['links']) . "
"; return $layout; } /** * Callback function for validating the chado_linker__dbxref_widget. */ function chado_linker__dbxref_widget_validate($element, &$form_state) { $field_name = $element['#field_name']; $delta = $element['#delta']; $table_name = $element['#table_name']; $fkey = $element['#fkey_field']; $field = field_info_field($field_name); $field_type = $field['type']; $field_table = $field['settings']['chado_table']; $field_column = $field['settings']['chado_column']; $field_prefix = $field_table . '__dbxref_id'; // If the form ID is field_ui_field_edit_form, then the user is editing the // field's values in the manage fields form of Drupal. We don't want // to validate it as if it were being used in a data entry form. if ($form_state['build_info']['form_id'] =='field_ui_field_edit_form') { return; } // Get the field values. // $dbxref_id = tripal_chado_get_field_form_values($field_name, $form_state, $delta, $field_table . '__dbxref_id'); // $db_id = tripal_chado_get_field_form_values($field_name, $form_state, $delta, $field_prefix . '--db_id'); // $accession = tripal_chado_get_field_form_values($field_name, $form_state, $delta, $field_prefix . '--accession'); // $version = tripal_chado_get_field_form_values($field_name, $form_state, $delta, $field_prefix . '--version'); // $description = tripal_chado_get_field_form_values($field_name, $form_state, $delta, $field_prefix . '--description'); // Make sure that if a database ID is provided that an accession is also // provided. Here we use the form_set_error function rather than the // form_error function because the form_error will add a red_highlight // around all of the fields in the fieldset which is confusing as it's not // clear to the user what field is required and which isn't. Therefore, // we borrow the code from the 'form_error' function and append the field // so that the proper field is highlighted on error. if (!$db_id and $accession) { form_set_error(implode('][', $element ['#parents']) . '][' . $field_prefix . '--db_id', t("A database and the accession must both be provided.")); } if ($db_id and !$accession) { form_set_error(implode('][', $element ['#parents']) . '][' . $field_prefix . '--accession', t("A database and the accession must both be provided.")); } if (!$db_id and !$accession and ($version or $description)) { form_set_error(implode('][', $element ['#parents']) . '][' . $field_prefix . '--db_id', t("A database and the accession must both be provided.")); } // If the dbxref_id does not match the db_id + accession then the user // has selected a new dbxref record and we need to update the hidden // value accordingly. if ($db_id and $accession) { $dbxref = chado_generate_var('dbxref', array('db_id' => $db_id, 'accession' => $accession)); if ($dbxref and $dbxref->dbxref_id != $dbxref_id) { tripal_chado_set_field_form_values($field_name, $form_state, $dbxref->dbxref_id, $delta, $table_name . '__dbxref_id'); tripal_chado_set_field_form_values($field_name, $form_state, $dbxref->dbxref_id, $delta, $field_prefix . '--dbxref_id'); } } else { // If the db_id and accession are not set, then remove the linker FK value to the base table. tripal_chado_set_field_form_values($field_name, $form_state, '', $delta, $table_name . '__' . $fkey); } } /** * An Ajax callback for the dbxref widget. */ function chado_linker__dbxref_widget_form_ajax_callback($form, $form_state) { $field_name = $form_state['triggering_element']['#parents'][0]; $delta = $form_state['triggering_element']['#parents'][2]; $field = field_info_field($field_name); $field_type = $field['type']; $field_table = $field['settings']['chado_table']; $field_column = $field['settings']['chado_column']; $field_prefix = $field_table . '__dbxref_id'; // Check to see if this dbxref already exists. If not then // give a notice to the user that the dbxref will be added. $db_id = tripal_chado_get_field_form_values($field_name, $form_state, $delta, $field_prefix . '--db_id'); $accession = tripal_chado_get_field_form_values($field_name, $form_state, $delta, $field_prefix . '--accession'); if ($db_id and $accession) { $values = array( 'db_id' => $db_id, 'accession' => $accession, ); $options = array('is_duplicate' => TRUE); $has_duplicate = chado_select_record('dbxref', array('*'), $values, $options); if (!$has_duplicate) { drupal_set_message('The selected cross reference is new and will be added for future auto completions.'); } } return $form[$field_name]['und'][$delta]; }