EDI TOOLKIT for RUBY (edi4r)
This is Ruby gem edi4r version :include:VERSION
Edi4r was created to greatly simplify the creation and processing of data for Electronic Data Interchange (EDI). In particular, it supports the UN/EDIFACT syntax (ISO 9573) and optionally SAP IDocs. Limited support is offered for ANSI X.12 and SEDAS.
Installation
Install it as any other Ruby gem, e.g.:
sudo gem install edi4r-<version>.gem
With administrator privileges and network access, just type:
gem install edi4r
Usage
require 'edi4r' # Older installations: require_gem 'edi4r'
require 'edi4r/edifact' # optional
# Build a UN/EDIFACT interchange from its character representation in a file:
ic = nil
File.open("received.edi") {|hnd| ic = EDI::E::Interchange.parse( hnd ) }
ic.each do |msg|
# Process message, here: Just list document numbers from (only) segment BGM
puts msg['BGM'].first.d1004
end
# Create a minimalistic interchange
ic = EDI::E::Interchange.new # Default: syntax version=3, charset = UNOB
msg = ic. # Default: ORDERS D.96A
bgm = msg.new_segment('BGM') # Obtain an empty segment
bgm.cC002.d1001 = '220' # Add some content to mandatory elements
bgm.d1004 = 'PO-54321'
dtm = msg.new_segment('DTM')
dtm.cC507.d2005 = '137'
uns = msg.new_segment('UNS')
uns.d0081 = 'S'
[bgm, dtm, uns].each {|seg| msg.add seg} # Add segments to message
ic.add msg # Add message to interchange - ready to go!
ic.header.cS002.d0004 = 'sender'; ic.header.cS003.d0010 = 'recipient' # UNB
ic.validate # Conforming to standard?
print ic # Could be sent that way!
See also
-
Background info about data structure and classes.
-
A Tutorial for examples of use.
-
A Changelog is maintained since version 0.8
-
Finally, see TO-DO for the current wish list.
-
This code is put under the Ruby license, see COPYING for details.
:include:AuthorCopyright
Enjoy,
Heinz