Date here Client Company Name
T-CONNECT EDI SPLITTER
Installation and User Guide
1/22/2015
DOCUMENT CREATED BY:
Tallan BizTalk Development Team
WE BUILD SOFTWARE
THAT HELPS OUR CLIENTS GROW
©2014 Tallan Confidential Information: Reprduction or disclosure prohibited. Page 2 of 15
1/22/2015 T-Connect EDI Splitter Tech Doc
Table of Contents
OVERVIEW ......................................................................................................................................................3
INSTALLATION .................................................................................................................................................3
STEP 1: RUN THE MSI ........................................................................................................................................................................3 STEP 2: IN SETUP SCREEN PRESS NEXT....................................................................................................................................................3 STEP 3: CHECK THE “I ACCEPT THE TERMS IN THE LICENSE AGREEMENT” AND PRESS NEXT ............................................................................4 STEP 4: SELECT THE INSTALLATION FOLDER AND PRESS NEXT .....................................................................................................................4 STEP 5: CHECK “START DEPLOYING TO BIZTALK WHEN I CLICK FINISH” AND PRESS FINISH .............................................................................5 STEP 6: TYPE THE USER ACCOUNT USED BY BITTALK HOST INSTANCE..........................................................................................................5 STEP 7: SELECT THE ENVIRONMENT FILE AND PRESS NEX T.........................................................................................................................6 STEP 8: IF NEEDED CHECK “THIS IS THE LAST SERVER IN THE BIZTALK GROUP” ..........................................................................................7 STEP 9: COPY LICENSE.CONFIG .............................................................................................................................................................8 STEP 10: ADD BIZTALK ASSEMBLIES TO “BIZTALK APPLICATION 1” ...........................................................................................................9
REFERENCES .................................................................................................... ERROR! BOOKMARK NOT DEFINED.7
©2014 Tallan Confidential Information: Reprduction or disclosure prohibited. Page 3 of 15
1/22/2015 T-Connect EDI Splitter Tech Doc
OVERVIEW
This document outlines the process of installing, configuring and using a 30 day evaluation version of the T-Connect EDI Splitter. The pipeline component is installed to its own BizTalk Application, Tallan.TConnect.EDISplitter. Once installed, the pipeline component can be added to any BizTalk Application; this document uses the Default BizTalk Application (normally “BizTalk Application 1”) as an example. The document also illustrates how to use application references to utilize the component in other applications.
The included license will grant you use of the tool for 30 days. After that, continued use will result in an error in the Event Log stating “License expired.” You can extend the license of this tool at any time. Contact [email protected] to inquire.
INSTALLATION
STEP 1: RUN THE MSI
STEP 2: IN SETUP SCREEN PRESS NEXT
©2014 Tallan Confidential Information: Reprduction or disclosure prohibited. Page 4 of 15
1/22/2015 T-Connect EDI Splitter Tech Doc
STEP 3: CHECK THE “I ACCEPT THE TERMS IN THE LICENSE AGREEMENT” AND PRESS NEXT
STEP 4: SELECT THE INSTALLATION FOLDER AND PRESS NEXT
©2014 Tallan Confidential Information: Reprduction or disclosure prohibited. Page 5 of 15
1/22/2015 T-Connect EDI Splitter Tech Doc
STEP 5: CHECK “START DEPLOYING TO BIZTALK WHEN I CLICK FINISH” AND PRESS FINISH
STEP 6: ENTER THE USER ACCOUNT USED BY BITTALK HOST INSTANCE
For example, BizTalkService
©2014 Tallan Confidential Information: Reprduction or disclosure prohibited. Page 6 of 15
1/22/2015 T-Connect EDI Splitter Tech Doc
STEP 7: SELECT THE ENVIRONMENT FILE AND PRESS NEXT
Enviroment files can be found in this path:
%installation Directory%\EDISplitter\1.0\Deployment\EnvironmentSettings
©2014 Tallan Confidential Information: Reprduction or disclosure prohibited. Page 7 of 15
1/22/2015 T-Connect EDI Splitter Tech Doc
STEP 8: IF NEEDED, CHECK “TH IS IS THE LAST SERVER IN THE BIZTALK GROUP”; CLICK FINISH
©2014 Tallan Confidential Information: Reprduction or disclosure prohibited. Page 8 of 15
1/22/2015 T-Connect EDI Splitter Tech Doc
CONFIGURING THE PIPELINE COMPONENT
1. Open the Pipeline Configuration properties:
2. Enter EdiTransactionType 3. Enter “OutFolder”
4. Enter “LicenseFilePath” 5. Enter desired value for “SplitAfterOccurances”
6. Enter desired value for “ReleaseAfterXSeconds” (Full configuration description on following page)
©2014 Tallan Confidential Information: Reprduction or disclosure prohibited. Page 9 of 15
1/22/2015 T-Connect EDI Splitter Tech Doc
Property name Description Default value
Required
EdiTransactionType Type of EdiTransaction is defined here
Possible values are :
X12_00501_270
X12_00501_271
X12_00501_276
X12_00501_277
X12_00501_278
X12_00501_810
X12_00501_820
X12_00501_832
X12_00501_834
X12_00501_835
X12_00501_837D
X12_00501_837P
X12_00501_837I
X12_00501_846
X12_00501_850
X12_00501_856
Empty Yes
EnableLineBreaks Sepcifies whether line breaks are enabled for splitter.
False Yes
©2014 Tallan Confidential Information: Reprduction or disclosure prohibited. Page 10 of 15
1/22/2015 T-Connect EDI Splitter Tech Doc
LicenseFilePath Specifies the location of the License configuration file. Set to
%InstallPath%\License.config.
Default Installation
Location
Yes
OutFolder Specifies the local directory or file share path for storing. (A folder or directory path, e.g. C:\Archive.)
Empty Yes (if enabled)
ReleaseAfterXSeconds Number of seconds delay is induced before the next EDI file written into output folder
0 No
SegmentTerminator Edi segment terminator is defined ~ Yes
SplitAfterOccurances Minimum number of records in an EDI file before it written to out folder
1 Yes
2. Open the installation path specified in Step 4 1 . Run “SSOSettingsEditor.exe”
2. After the changing the delimiter setting for each EDI Transaction press save
SSO Confiuration for EDI 834 and sample EDI File:
©2014 Tallan Confidential Information: Reprduction or disclosure prohibited. Page 11 of 15
1/22/2015 T-Connect EDI Splitter Tech Doc
ISA*00*...................................~GS*.......................................~ST*.......................................~BHT*......................................~HL*HL01**20*1~ <<Count 1>>...HL*HL01**20*1~ <<Count 2>>...HL*HL01**20*1~ <<Count 3>>...HL*HL01**20*1~ <<Count 15000>>PLB*.......................................~PLB*.......................................~PLB*.......................................~SE*........................................~GE*........................................~IEA*.......................................~
Header Information
HL*HL01 is repeated 15000 times. The EDI Splitter will count each occurrence of the HL segment and will split the file after the predetermined number of segments is found
Trailer Information
OPTIONAL CONFIGURATION: ADD BIZTALK ASSEMBLIES TO “BIZTALK APPLICATION 1”
If desired, the EDI Splitter pipeline component can be used within other applications either by
reference or by adding the assemblies. This example shows how to do that with BizTalk Application 1.
3. Open BizTalk administration console.
4. Right click on BizTalk Application 1 goto Add -> BizTalk Assemblies
©2014 Tallan Confidential Information: Reprduction or disclosure prohibited. Page 12 of 15
1/22/2015 T-Connect EDI Splitter Tech Doc
5. Press add in “Add Resource” popup
6. Goto the installation path from Step 4 and select and add these DLLs 1. Tallan.BizTalk.TConnect.PipelineComponents.EDISplitter 2. Tallan.BizTalk.TConnect.PipelineComponents.Helper
3. Tallan.BizTalk.TConnect.PipelineComponents.Pipeline
©2014 Tallan Confidential Information: Reprduction or disclosure prohibited. Page 13 of 15
1/22/2015 T-Connect EDI Splitter Tech Doc
7. Check these option and complete the process 1. “Add to the global assembly cache on add resource (gacutil)” 2. “Add to the global assemnly cache on MSI file import (gacutil)”
3. “Add to the global assembly cache on MSI file install (gacutil)”
©2014 Tallan Confidential Information: Reprduction or disclosure prohibited. Page 14 of 15
1/22/2015 T-Connect EDI Splitter Tech Doc
8. Add “BizTalk Application 1” as reference. Right click on the application where the edi splitter will be used goto Add->References
9. Select “BizTalk Application 1”
10. Create a New Recevie Port which accepts Flat Files
©2014 Tallan Confidential Information: Reprduction or disclosure prohibited. Page 15 of 15
1/22/2015 T-Connect EDI Splitter Tech Doc
11. Select “Rcv_EDISplitter” in the receive pipeline options
Top Related