Module: ACH::File::TransmissionHeader

Extended by:
ActiveSupport::Concern
Included in:
ACH::File
Defined in:
lib/ach/file/transmission_header.rb

Overview

Hosts functionality required to append TransmissionHeader to a file. TransmissionHeader is optional and inherited from ACH::Record::Dynamic class, which means it may have variable number of fields with custom formatting. TransmissionHeader may be defined only once per file. You may specify default value for custom fields during definition

Example

class MyFile < ACH::File
  trasmission_header do
    starting      '->1' => '<'
    receiver_name '->10'
    ending        '->1' => '>'
  end
  # other definitions
end

file = MyFile.new do
  receiver_name 'MY PROVIDER'
end

Defined Under Namespace

Modules: ClassMethods Classes: EmptyTransmissionHeaderError, RedefinedTransmissionHeaderError

Instance Method Summary collapse

Instance Method Details

#have_transmission_header? ⇒ Boolean

Helper instance method. Returns true if TransmissionHeader is defined within scope of it’s class

Returns:

  • (Boolean) 


60
61
62
 
# File 'lib/ach/file/transmission_header.rb', line 60

def have_transmission_header?
  self.class.have_transmission_header?
end

#transmission_header(fields = {}, &block) ⇒ Object

Builds TransmissionHeader record for self. Yields it to block, if passed. Returns nil if no TransmissionHeader is defined within scope of class.



66
67
68
69
70
71
72
73
74
75
 
# File 'lib/ach/file/transmission_header.rb', line 66

def transmission_header(fields = {}, &block)
  return nil unless have_transmission_header?

  merged_fields = fields_for(self.class::TransmissionHeader).merge(fields)

  @transmission_header ||= self.class::TransmissionHeader.new(merged_fields)
  @transmission_header.tap do |head|
    head.instance_eval(&block) if block
  end
end