Class: DatashiftJourney::Collector::BaseCollectorForm

Inherits:
Reform::Form
  • Object
show all
Includes:
FormMixin
Defined in:
app/forms/datashift_journey/collector/base_collector_form.rb

Overview

This class represents the View backing Form

Reform API :

initialize always requires a model that the form represents.
validate(params) updates the form's fields with the input data (only the form, not the model) and then runs all validations. The return value is the boolean result of the validations.
errors returns validation messages in a classic ActiveModel style.
sync writes form data back to the model. This will only use setter methods on the model(s).
save (optional) will call #save on the model and nested models. Note that this implies a #sync call.
prepopulate! (optional) will run pre-population hooks to "fill out" your form before rendering.

Instance Attribute Summary collapse

Attributes included from FormMixin

#journey_plan, #redirection_url

Instance Method Summary collapse

Methods included from FormMixin

#redirect?, #validate

Constructor Details

#initialize(journey_plan) ⇒ BaseCollectorForm

Called from CONTROLLER

Creates a form object backed by the current Plan object

Data is collected generically from fields defined by FormDefinition and stored in data nodes associated with current JourneyPlan instance (through polymorphic plan association)



32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
 
# File 'app/forms/datashift_journey/collector/base_collector_form.rb', line 32

def initialize(journey_plan)
  super(journey_plan)

  @journey_plan = journey_plan

  @definition = DatashiftJourney::Collector::FormDefinition.where(klass: self.class.name).first

  # For brand new forms, add one data node per form field - data nodes hold the COLLECTED VALUES
  # If this page already been visited we should have a completed data node already
  form_definition.form_fields.map(&:id).each do |id|
    next if journey_plan.data_nodes.where('form_field_id = ?', id).exists?
    journey_plan.data_nodes << DatashiftJourney::Collector::DataNode.new(plan: journey_plan, form_field_id: id)
  end

end

Instance Attribute Details

#definition ⇒ Object

Returns the value of attribute definition.



23
24
25
 
# File 'app/forms/datashift_journey/collector/base_collector_form.rb', line 23

def definition
  @definition
end

Instance Method Details

#params_key ⇒ Object

Over ride in your form if your view forms have non standard key field.

The default naming format for form elements in the view is : “#params_key[field_value]”

For example:

<%= select_tag "#{params_key}[data_nodes][field_value][#{i}]"....  %>



54
55
56
 
# File 'app/forms/datashift_journey/collector/base_collector_form.rb', line 54

def params_key
  DatashiftJourney::FormObjectFactory.state_name(self.class.name)
end