EdiTools is a PowerShell module to support searching, filtering, and displaying EDI file contents.
When creating EdiTools, I had specific design goals in mind:
I wanted the cmdlets to be as fast as possible without sacrificing usability. The "heavy lifting" of the file parsing is done in C# code. PowerShell provides the usability with the pipeline and cmdlets.
Each cmdlet works together, using the previous cmdlet output as input. For example, Get-EdiFile | Get-TransactionSet | Get-Edi835. The first cmdlets are general EDI functions, where the last cmdlet is a specific EDI format, in this case 835. The Get-Edi835 is the only format-specific cmdlet currently.
Each cmdlet exposes more properties on the output object. In addition, the first cmdlet, Get-EdiFile, support piped input from both Get-ChildItem and Select-String, to simplify searching for specific files while leveraging this module.
This is not a full-fledged EDI parser. The primary focus was an easy way to search, filter, and display EDI file contents. As such, only certain values of the segments and elements are promoted as properties.
This is a personal constraint, but as of now, I needed the module to be PowerShell 2 compatible. As such, the C# code is written in a .net 2.0 style. I had to avoid some newer features else it would not run on PowerShell 2.0. Once I can move the minimum supported version to at least 3.0, then I can "modernize" the C# a bit.
The parsing process needed to be agnostic to "wrapped" (single line), or "unwrapped" (CR/LF, or LF-only) files
Certain segment/element values from the EDI file are promoted for convenience. These convenience properties are converted to data types designated in the specification.
For example, the Interchange segments ISA09 and ISA10 are interchange date and time, respectively. These properties are combined into property Interchange.Date of type System.DateTime.
If you don't want to clone the repo, and just want to install the PowerShell module:
Save the file to c:\Users\
Right-click on the file and choose Properties -> Click the Unblock button
From a PowerShell prompt, type "Import-Module EdiTools -Verbose" (the -Verbose is optional, but will give you conformation the cmdlets installed).
Future development may include: