rtml 1.2.2

data/app_generators/rtml/templates/rtml/components/rtml/widgets/form_submit_widget.rb

@@ -0,0 +1,65 @@
+module Rtml
+  module Widgets
+    # Constructs a "submit" TML tag to submit data to the server.
+    #
+    # Example:
+    #   def index
+    #     . . .
+    #     screen :do_submit, :next => :submit_err do
+    #       submit :target => url_for(:action => "auth") do
+    #         on_error :submit_err
+    #         get_variables 'amount', 'card.issue_number',
+    #                       'card.cardholder_name'
+    #       end
+    #     end
+    #   end
+    #
+    class FormSubmitWidget < Rtml::Widgets::Widget
+      # the location to send the POST data to
+      property :target
+      # the screen on the current page (or a URL to it) to go to in the event of an error
+      property :on_error
+      # true if the terminal is allowed to cache the server's response
+      # defaults to false
+      property :cache
+      
+      accessor Screen
+      accessor_alias :form_submit, :submit
+      
+      def init_properties
+        cache false
+      end
+      
+      def to_tml
+        tgt = url_for(target)
+        err = url_for(on_error)
+        cch = ((cache) ? :allow : :deny)
+        
+        raise "No :target URL specified" if tgt.blank?
+        raise "No :on_error screen specified" if err.blank?
+
+        scr = parent
+        if parent.kind_of? Rtml::Core::Screen
+          parent.next err rescue nil
+        else
+          scr = parent.screen("sub_#{element_id}", :next => err)
+        end
+        scr.build :submit, :tgt => tgt, :econn => err, :cache => cch do |sub|
+          sub.getvar :name => 'authenticity_token' if document.variables.find_by_name('authenticity_token')
+          sub.concat render_widget_tml
+        end
+        nil
+      end
+      
+      private
+      def url_for(a)
+        r = nil
+        if a.kind_of? String or a.kind_of? Symbol then r = a.to_screen_ref
+        elsif a.kind_of? Hash then r = action_view.url_for a
+        else raise "Invalid type specified for URL (#{a.inspect})"
+        end
+        r
+      end
+    end
+  end
+end

data/app_generators/rtml/templates/rtml/components/rtml/widgets/get_transaction_variables_widget.rb

@@ -0,0 +1,33 @@
+module Rtml
+  module Widgets
+    class GetTransactionVariablesWidget < Rtml::Widgets::Widget
+      accessor DisplayWidget, FormSubmitWidget
+      accessor_alias :get_transaction_variables
+      
+      def to_tml #:nodoc:
+        # card variables
+        parent.get_variables %W(
+          cardholder_name effective_date expiry_date input_type issue_number issuer_name
+          pan scheme pin
+        ).collect { |c| "card.#{c}" }
+        # emv variables
+        parent.get_variables %W(
+          aac aid aip app_pan_seq arqc atc auc cvmr iac_default iac_denial iac_online iad
+          iso_track2 last_attempt signature tc tvr unumber
+        ).collect { |c| "card.emv.#{c}"}
+        # pin variables
+        parent.get_variables %W( length smid array ).collect { |c| "card.pin.#{c}"}
+        # mag variables
+        parent.get_variables %W( iso1_track iso2_track iso3_track service_code ).collect { |c| "card.mag.#{c}" }
+        # card parser variables
+        parent.get_variables %W( type reject_reason verdict cvm cvr ).collect { |c| "card.parser.#{c}" }
+        # OEBR variables
+        parent.get_variables %W( submit_mode time_zone ).collect { |c| "oebr.#{c}" }
+        # transaction payment variables
+        parent.get_variables %W( trans_type amount amount_other ).collect { |c| "payment.#{c}" }
+        
+        nil
+      end
+    end
+  end
+end

data/app_generators/rtml/templates/rtml/components/rtml/widgets/get_variable_widget.rb

@@ -0,0 +1,39 @@
+module Rtml
+  module Widgets
+    # Constructs a "getvar" tag for a single TML variable.
+    #
+    # Examples:
+    #   get_variable 'card.pan'
+    #      => <getvar name="card.pan" />
+    #   variable_for 'card.cardholder_name'
+    #      => <getvar name="card.cardholder_name" />
+    #   getvar :amount, :format => '^00'
+    #      => <getvar name="amount" format="^00" />
+    # 
+    class GetVariableWidget < Rtml::Widgets::Widget
+      # The name of the variable
+      property :name => :name_assigned
+      # Format, if any (see TML "getvar" format attribute)
+      property :format
+      
+      accessor Widget
+      accessor_alias :get_variable, :variable_for, :getvar
+
+      def init_properties
+        name :required
+        name arguments.first
+      end
+      
+      def name_assigned(n)
+        n
+        #qualified_variable_name n
+      end
+      
+      def to_tml
+        fmt = ""
+        fmt = " format=\"#{format}\"" unless format.blank?
+        "<getvar name=\"#{name}\"#{fmt} />"
+      end
+    end
+  end
+end

data/app_generators/rtml/templates/rtml/components/rtml/widgets/receipt_widget.rb

@@ -0,0 +1,66 @@
+module Rtml
+  module Widgets
+    # Assists in printing receipts by combining the <screen> and the
+    # necessary <print> TML tags into a single RTML method call.
+    #
+    # Like the Rtml::TMLDocument#screen method, an ID value is required.
+    # The ID is expected to be a Symbol.
+    #
+    # The second argument should be a reference to the next screen, like 
+    # the TMLDocument#screen method.
+    #
+    # You can also pass the content as the last argument, or a Block with which
+    # to construct the content. (The Block can use the #display method
+    # to render a View, as with Screen). The content for the second argument
+    # is built using the Widget#display method.
+    #
+    # If a both a Block and a content argument are specified, the Block will take
+    # priority and the argument will be ignored.
+    #
+    # Examples:
+    #   def index
+    #     receipt :example_1, :example_2 { concat "This is a receipt example!" }
+    #     receipt :example_2, :example_3 { display }
+    #     receipt :example_3, :example_4, "This is another example!"
+    #     receipt :example_4, :example_5, :partial => "receipts/content_for_receipt_example_4"
+    #   end
+    class ReceiptWidget < Rtml::Widgets::Widget
+      property :screen_id
+      property :next
+      property :inner
+      
+      accessor TMLDocument
+      accessor_alias :receipt
+      accessor_alias :printscr
+      
+      def init_properties #:nodoc:
+        screen_id :required
+        
+        screen_id arguments.first if arguments.first.kind_of? Symbol or arguments.first.kind_of? String or arguments.length == 1
+        if @receipt_block
+          next_screen arguments[1]
+        else
+          inner arguments.last
+        end
+      end
+      
+      def next_screen(*a,&b) self.send(:next, *a, &b); end
+      
+      def initialize(*a, &b) #:nodoc:
+        @receipt_block = b if block_given?
+        super(*a) {}
+      end
+      
+      def to_tml(&block) #:nodoc:
+        parent.screen screen_id, :next => next_screen do |scr|
+          scr.build :print do |builder|
+            if @receipt_block then builder.yield_with_optional_param self, &@receipt_block
+            else display inner if inner
+            end
+          end
+        end
+        nil
+      end
+    end
+  end
+end

data/app_generators/rtml/templates/rtml/components/rtml/widgets/screen_builder_widget.rb

@@ -0,0 +1,49 @@
+module Rtml
+  module Widgets
+    # Used to build a set of screens without having to call the Rtml::TMLDocument#screen
+    # method for each one.
+    #
+    # Within the block you pass to this Widget, anything that would normally cause a
+    # NoMethodError will instead create a new screen of the same name. If a second argument
+    # is supplied, it will be used for the :next attribute (linking this screen to the
+    # next). If any other arguments are supplied, they will be passed directly into
+    # the Screen initializer. Also, if a block is supplied, it is passed into the Screen
+    # initializer. If a block is NOT supplied, a default block is created calling "display",
+    # which will cause the Screen to build a Display element and render its corresponding View.
+    #
+    # See also Rtml::Helpers::ChildElements#screens
+    # 
+    # Examples:
+    #
+    #   def index
+    #     screens do
+    #       init  :index                            # => screen :init,  :next => :index { display }
+    #       index :menu { card_parser . . . }       # => screen :index, :next => :menu  { card_parser . . . }
+    #     end
+    #   end
+    #
+    class ScreenBuilderWidget < Rtml::Widgets::Widget
+      accessor TMLDocument
+
+      def respond_to?(a) #:nodoc:
+        super #true
+      end
+      
+      def method_missing(name, *args, &block) #:nodoc:
+        if args.length == 1 and not args[0].kind_of? Hash
+          if block_given? then parent.screen name, :next => args[0], &block
+          else parent.screen(name, :next => args[0]) { display }
+          end
+        else
+          if block_given? then parent.screen name, *args, &block
+          else parent.screen(name, :next => args[0]) { display }
+          end
+        end
+      end
+
+      def to_tml #:nodoc:
+        ''
+      end
+    end
+  end
+end

data/app_generators/rtml/templates/rtml/db/migrate/20090825132217_create_rtml_states.rb

@@ -0,0 +1,15 @@
+class CreateRtmlStates < ActiveRecord::Migration
+  def self.up
+    create_table :rtml_states do |t|
+      t.string :signature
+      t.text   :state
+      
+      t.timestamps
+    end
+  rescue # because of the move from Rtml::Migrator to ActiveRecord::Migrator
+  end
+
+  def self.down
+    drop_table :rtml_states
+  end
+end

data/app_generators/rtml/templates/rtml/db/migrate/20090825132401_create_rtml_terminals.rb

@@ -0,0 +1,16 @@
+class CreateRtmlTerminals < ActiveRecord::Migration
+  def self.up
+    create_table :rtml_terminals do |t|
+      t.string  :itid
+      t.integer :state_id
+      t.string :type, :default => 'Rtml::Terminal'
+      
+      t.timestamps
+    end
+  rescue # because of the move from Rtml::Migrator to ActiveRecord::Migrator
+  end
+
+  def self.down
+    drop_table :rtml_terminals
+  end
+end

data/app_generators/rtml/templates/rtml/db/migrate/20090825132530_create_rtml_transactions.rb

@@ -0,0 +1,24 @@
+class CreateRtmlTransactions < ActiveRecord::Migration
+  def self.up
+    create_table :rtml_transactions do |t|
+      %W(action message auth_code currency_code txn_mode).each do |i|
+        t.string i
+      end
+      t.string :state
+      t.float :duration
+      t.decimal :amount, :precision => 2
+      t.decimal :amount_other, :precision => 2
+      t.string :txn_type
+      t.datetime :post_date
+      t.integer :post_id
+      
+      t.references :rtml_terminal
+      t.timestamps
+    end
+  rescue # because of the move from Rtml::Migrator to ActiveRecord::Migrator
+  end
+
+  def self.down
+    drop_table :rtml_transactions
+  end
+end

data/app_generators/rtml/templates/rtml/db/migrate/20090825134118_create_rtml_cards.rb

@@ -0,0 +1,23 @@
+class CreateRtmlCards < ActiveRecord::Migration
+  def self.up
+    create_table :rtml_cards do |t|
+      t.string :cardholder_name
+      t.datetime :effective_date
+      t.datetime :expiry_date
+      t.string :input_type
+      t.integer :issue_number
+      t.string :issuer_name
+      t.string :pan
+      t.string :scheme
+      
+      t.references :data, :polymorphic => true
+      t.references :transaction
+      t.timestamps
+    end
+  rescue # because of the move from Rtml::Migrator to ActiveRecord::Migrator
+  end
+
+  def self.down
+    drop_table :rtml_cards
+  end
+end

data/app_generators/rtml/templates/rtml/db/migrate/20090825134622_create_rtml_emv_card_data.rb

@@ -0,0 +1,20 @@
+class CreateRtmlEmvCardData < ActiveRecord::Migration
+  def self.up
+    create_table :rtml_emv_card_data do |t|
+      t.string :aid
+      for i in %W(aip app_pan_seq atc auc last_attempt signature unumber)
+        t.integer i
+      end
+      for i in %W(aac arqc cvmr iac_default iac_denial iac_online iad iso_track2 tc tvr)
+        t.binary i
+      end
+      
+      t.timestamps
+    end
+  rescue # because of the move from Rtml::Migrator to ActiveRecord::Migrator
+  end
+
+  def self.down
+    drop_table :rtml_emv_card_data
+  end
+end

data/app_generators/rtml/templates/rtml/db/migrate/20090825134629_create_rtml_mag_card_data.rb

@@ -0,0 +1,17 @@
+class CreateRtmlMagCardData < ActiveRecord::Migration
+  def self.up
+    create_table :rtml_mag_card_data do |t|
+      t.string :iso1_track
+      t.string :iso2_track
+      t.string :iso3_track
+      t.string :service_code
+      
+      t.timestamps
+    end
+  rescue # because of the move from Rtml::Migrator to ActiveRecord::Migrator
+  end
+
+  def self.down
+    drop_table :rtml_mag_card_data
+  end
+end

data/app_generators/rtml/templates/rtml/db/migrate/20090825135838_create_rtml_card_parsers.rb

@@ -0,0 +1,19 @@
+class CreateRtmlCardParsers < ActiveRecord::Migration
+  def self.up
+    create_table :rtml_card_parsers do |t|
+      t.string :card_type     # => 'mag' or 'icc_emv'
+      t.string :reject_reason # => reason for transaction rejection
+      t.string :verdict       # => 'online', 'offline' or 'reject'
+      t.string :cvm           # => cardholder verification method
+      t.string :cvr           # => cardholder verification result
+      
+      t.references :card
+      t.timestamps
+    end
+  rescue # because of the move from Rtml::Migrator to ActiveRecord::Migrator
+  end
+
+  def self.down
+    drop_table :rtml_card_parsers
+  end
+end

data/app_generators/rtml/templates/rtml/db/migrate/20090826103509_create_reference_codes.rb

@@ -0,0 +1,14 @@
+class CreateReferenceCodes < ActiveRecord::Migration
+  def self.up
+    create_table :rtml_reference_codes do |t|
+      t.string :value
+      
+      t.references :transaction
+    end
+  rescue # because of the move from Rtml::Migrator to ActiveRecord::Migrator
+  end
+
+  def self.down
+    drop_table :rtml_reference_codes
+  end
+end

data/app_generators/rtml/templates/rtml/db/migrate/20090915030044_add_batch_to_rtml_transactions.rb

@@ -0,0 +1,10 @@
+class AddBatchToRtmlTransactions < ActiveRecord::Migration
+  def self.up
+    add_column :rtml_transactions, :batch, :string
+  rescue # because of the move from Rtml::Migrator to ActiveRecord::Migrator
+  end
+
+  def self.down
+    remove_column :rtml_transactions, :batch
+  end
+end

data/app_generators/rtml/templates/rtml/db/migrate/20090915031155_add_additional_data_to_rtml_transactions.rb

@@ -0,0 +1,10 @@
+class AddAdditionalDataToRtmlTransactions < ActiveRecord::Migration
+  def self.up
+    add_column :rtml_transactions, :additional_data, :text
+  rescue # because of the move from Rtml::Migrator to ActiveRecord::Migrator
+  end
+
+  def self.down
+    remove_column :rtml_transactions, :additional_data
+  end
+end

data/app_generators/rtml/templates/rtml/db/migrate/20090915031156_add_hidden_data_to_rtml_transactions.rb

@@ -0,0 +1,10 @@
+class AddHiddenDataToRtmlTransactions < ActiveRecord::Migration
+  def self.up
+    add_column :rtml_transactions, :hidden_data, :text
+  rescue # because of the move from Rtml::Migrator to ActiveRecord::Migrator
+  end
+
+  def self.down
+    remove_column :rtml_transactions, :hidden_data
+  end
+end