iConnect Client System
Contents
1. Delete Empty Trash d Enter the new name of your folder and click OK x 2 Please enter new name For this Folder qh Cancel II F Deleting Folders 1 Delete folders by a Select a folder b Go to Edit gt Folder gt Delete at the menu option or Ea iConnect Client System File Edit View Action Settings wt Message P 3 Folder k Rename F Contacts P OUTBOX SENT ACKNOWLEDGMENT DJ DRAFT C TRASH ORDERS SUPPLIER c Right click at the selected folder or anywhere in the folders view pane and select Delete os iConnect Client System File Edit View Action Settings rA o Folders Rez NECX T OUTBOX SENT DO ACKNOWLEDGMENT DO DRAFT TRASH ORDERS SUPPLIER Hew Rename Delete Empty Trash d Click Yes to delete the folder Confirm Delete Folder x 2 Do you really wank to delete Folder ORDERS SUPPLIER II G Moving Messages 1 Move message s by a Select message s to move b Go to Edit gt Message gt Move at the menu option or Ena iConnect Client System File Edit View Action Settings Help From Pe SUPPLIER El OUTBOX E E SENT SUPPLIER ED ACKNOWLEDGMENT SUPPLIER EL DRAFT SUPPLIER El TRASH ff ORDERS SUPPLIER 31 c Right click at the selected message s and select Move ettings Help Send x Receive From Party I2. 46 Example 2 Task for Scheduling Send XML Message to Server Time 9 30 AM to 11 00 PM Every 3 Hours Day Every Tuesday Thursday and Sunday Week Frequency Every 2 Weeks Start On Today Feb 14 2003 O Cal Schedule thls Task Tor autorated run ee Inport File to XML Message oll Export XML Message to File ee are 3 T By Range Send NL Massage to Sarver 4 E Receive AML Message from 5 12 0 AM fp E 4 Add To 1 DO PH Delete 5 terval ES Hou EE B set Day O Everyday C Weekdays ie Sperity Dim If Ties Tverd I Thurs Fri Sat A Sun 8 Every 25 25 meke 3 anion Feb 14 2003 Fri Steps o Click the task that will be configured for scheduling 2 Check the option box to specify that the selected task will be scheduled 3 Click the By Range option box to specify time entry values by range 4 Change the value in the From and To Time a to specify the range To change the value click on the value hour ae or time of day indicator and then click the tiny spinner buttons press the up down keyboard buttons or type the value Change a Interval value To change the value click on the tiny spinner buttons press the up down keyboard buttons o type the value set the Interval unit by clicking the down arrow button and select whether HOUR or MINUTE unit value 7 Click the Specify option and select the Day by checking the appropriate checkbox Change the Per Week Fre
3. _ _ Import Find Message E INBOX Empty Trash ECO OUTBOK gt EEE SENT StartiStop Scheduler Service ACKNOVYLEDGMENT EL DRAFT E TRASH Send Message e fecal Receive Receive Message Folders ED INBOX E OUTBOX E SENT ACKNOWLEDGMENT EL DRAFT E TRASH rom Party IL 19 Ea iConnect Client System E x File Edit View Action Settings Help Import E Sera Ga Receive puns mn o Folders est From Party ID To Party ID Message ID Document Type Timestamp Status Eos INBOX SUPPLIER RETAILER 2003 07 22TO PO 22 Jul 03 04 1 RECEIVED EL OUTBOX SUPPLIER RETAILER 2003 07 22TO PO 22 Jul 03 04 1 RECEIVED El SENT _ SUPPLIER RETAILER 2003 07 22TO PO 22 Jul 03 04 1 RECEIVED EL ACKNCWLEDGME SUPPLIER RETAILER 2003 07 22TO PO 22 Jul 03 04 1 RECEIVED EL DRAFT SUPPLIER RETAILER 2003 07 22TO 22 Jul 03 04 1 RECEIVED El TRASH SUPPLIER gt INBOX Folder 5 Mew Messagels 5 Total Messages Scheduler Service iz OFF 2 Export the XML messages as either CSV or XML file by selecting first the message s and by doing the following a Go to File gt Export ons iConnect Client System File Edit View Action Settings Help Pen k Export send A RECE Import From F SUPPLII SUPPLII SUPPLII SUPPLII H E ACKNOWLEDGMENT t DRAF
4. Documents and Settings _ stylesheet E Emis heap size editor bat H O Program Files En heap size editor sh H WINNT iconnect run bat E E BACKUP Ds l iconnect_run sh la Compact Disc G E log viemer bat E 7 Control Panel ka log_viewer sh an My Network Places A Recycle Bin 13 objectis Disk Free space 992 ME 1 52 KB My Computer 3 Run the iConnect Client App a Windows Explorer Go to the iconnect folder and double click iconnect run bat file b Command Line Go to the iconnect folder type iconnect_run bat and then press Enter c Torun iconnect on Linux use this command inside the iconnect folder sh iconnect_run sh Note Make sure that the file s executable permission is set correctly You can issue this command to make the script file executable to all users chmod 777 iconnect run sh 4 After launching iConnect the application will check if the JRE s security file is updated iConnect will automatically update JRE s security settings that will be used during runtime A message will be prompted that the security settings was updated Just restart the application after it shutdowns Java Environment Modified E x The iConneck system has just made additional modifications to your Java environment For it to run properly It will now shut down For these changes to take effect I C Setting Up Your Company s Identity Generating Key Pairs Public and Private keys generated by your
5. For Import folder as the Import task s directory bin and C Exported folder as the Export Task s directory bin Assuming that we have 3 document types namely PO PRICAT and PRODAT the following directory bin structure will be created after saving the scheduler settings 28g My Documents IES My Compucer tel 3 Hoppy a e EE WINDOWS iC e eg Document ard Settings Ea Exaorted AA E Connect E Progrem Ales o EO WINNT E Conpact Disc Dj Ha Contre Panel PRICAT 5 objects Disk Free space 662 MB O bytes My Computer Description G Directory Bin folder location Errors Folder all CSW files that were not imported due to errors will be moved here Imported Folder all CS files that were successfully imported will be moved ere a PO Folder place all PO CSW files for import here E PRICAT Folder place all PRICAT CSW files for import here f PRODAT Folder place all PRODAT Co files for import here The Errors and Imported folders are automatically generated by the Schedule Manager The Schedule Manager will create the Document Type PO PRICAT and PRODAT Folders based on the imported 49 schema file document type name If a schema file for a new document message type is imported in the Schema Path Configuration a new folder for this document type will be created in the Directory Bin for Import Task assuming that the Import Task is set for scheduling For example if a new document type named RETURN was
6. LOGIN l X Company Mare ty Company Party ID http www pane ora phiparty 2345670901 23 Passphrase OK Cancel I D Configuring the Display Style Sheets and Internet browser application Display Style sheets are used to format the XML message for HTML view using the Internet Browser Follow these steps to set the preferred display style sheets for each document type 1 Goto Settings gt Document Display to launch the Document Display Configuration window Exa iConnect Client System File Edit View Action Settings Help Security amp Identity Connections Document Schema H E INBOX OUTBOX SENT ACKNOVYWLEDGMEN EL DRAFT TRASH Mapper Document Display Schedule Manager 2 By clicking the Browse button set the location of the Internet browser application that will be used for viewing the XML messages in HTML format e g Internet Explorer or Netscape for Windows Konqueror or Mozilla for Linux 11 E Document Display Configuration Set Location of Browser feProgram Filesidrternet Explorerdexplore exe Double click to set the path forthe default Display Stylesheet PO PURCHASE ORDERS fetylesheetipo 21 0 displays Save Cancel 3 Set the Display Style sheet file for a particular document type by double clicking the table row to launch the Set Display XSL File dialog window The default values are already set for installed document types wi Docu
7. Thurs Fri Sal Suri Every TH weekts 3 Stert on Jan 22 2003 Wed 09 00 AM g Steps D Click the task that will be configured for scheduling 9 Check the option box to specify that the selected task will be scheduled O Click the Fer tem option box to specify time entry values per item 4 Change the value in the Time Spinner to specify the time value to be added To change the value click on the value Roo or time of day indicator and then click the tiny spinner buttons press the up down keyboard buttons c ype the value Click the Add button to add the value in the Time Spinner to the Time Entry listbox 5 ae of time values added To remove an item from the Time Entry list box select the item and then click the Delete utton 7 Click the Weekday option 8 The default value is 1 for every week Since the task will be executed every week we will use the default value set the start date The default value for the Start Date spinner is the current date value of the operating system For this case we will use the default value 45 If the current OS date time is Jan 22 2003 WED 4 30PM the Scheduler Service will execute the task on the next latest schedule which is Jan 22 2003 WED 5 59PM The table below shows the 1 week schedule that will be generated after saving the settings on Jan 22 2003 WED 4 30PM JAN 23 2003 THURS JAN 24 2003 FRI JAN 27 2003 MON JAN 28 2003 TUES 5 59 PM
8. imported in the Schema Path Configuration and the Import task is set for scheduling a RETURN document type folder will be created automatically in the C For Import directory bin All RETURN CSV files must be placed in the RETURN document type folder for automatic import by the Scheduler Service For Export Task the directory bin will consist only of document type subfolders All messages that are exported will be placed in the appropriate document type folder If a message was not successfully exported the message status will not change to EXPORTED at the Message View window Below is a sample view of the directory structure for Export Task EM C Exported File Edit view Favorites Tools Help sa Back gt SA search Gy Folders History LAS ee Es Address C Exported Folders Ge Desktop BEA My Documents PRICAT PRODAT E 12 My Computer E E 31 Floppy 0 a E WINDOWS C E A Documents and Settings H a For Import H iconnect E 1 Program Files CEDO WINNT po Ie Compact Disc D4 E f Control Panel 50 Starting Stopping the Scheduler Service After saving all the settings for each task click on the Start button to activate the Scheduler Service E Schedule Manager eme aginport File to XML Message oo Export XML Message to File Set Time 1 Per tem By Range eet Send XML Message to Server 120020 S pona a E amp Receive XML Message from E 12 00 AM Eror 09 00 A
9. indicator Clicking at a particular folder tells you the number of new messages and the total number of messages in that folder E ee Tela To Paty O FL A ee BFE MERDA Se Hee a E DER AA o MANTA A TCA Co A HIP ie O ima E urman food roo ais Sd rt x Menezes hie pie Diii ao AM ire caia e bip Ayem Sa oe Pe Pe ERP Fe Par dE nan Poor eo RA ci a lg Fi RET ar tanga E ret a tl a a ac Artery o to eee Tira 002 Jr 7770 ID ao BeOS Corrie 1 fad poi FEI aa Be Ss TT AO j i asd nEri T rr rey lo qa ds aja Re fio bee eee e ea p p INBOX Folder 4 New Message s 5 Total Message s II D Creating Folders iConnect Client System has 7 default folders found in the folders view pane 26 a iConnect Client System File Edit View Action Settings He H E NBOX H OUTBOX EH SENT ED ACKNOWLEDGMENT E DRAFT E TRASH Folders contains the other default folders INBOX contains all messages received from the server except for document type Acknowledment messages that are placed in the Acknowledgment folder OUTBOX contains messages successfully imported and for sending SENT contains sent messages ACKNOWLEDGMENT contains acknowledgment messages Acknowledgment messages signifies a confirmation that the message s sent was successfully delivered to the inbox of the recipient DRAFT contains draft messages Only messages from the OUTBOX folder can be
10. placed move here TRASH contains all deleted messages Note Default folders cannot be deleted or renamed 1 Create folders by a Select a folder b Goto File gt New gt Folder at the menu option or 2 Ea iConnect Client System File Edit wiew Action Settings Import Contact Export Exit E SENT ACKNOWLEDGMENT E DRAFT E TRASH ORDERS SUPPLIER c Right click at the selected folder or anywhere in the folders view pane and select New Folders F DJ OUTBOX SENT DJ ACKNOWLEDGMENT DO DRAFT O TRASH DJ ORDERS SUPPLIER Renaiie Delete Empty Trash d Enter the name of your folder you want to create and click OK Create New Folder xj 2 Please enter name of new Folder E po Cancel II E Renaming Folders 1 Rename folders by a Select a folder 28 b Go to Edit gt Folder gt Rename at the menu option or Exa iConnect Client System File Edit View Action Settings F Message P x Folder gt Rename Delete F Contacts P OUTBOX SENT Fl ACKNOWLEDGMENT DRAFT TRASH poe PORDERS SUPPLIER c Right click at the selected folder or anywhere in the folders view pane and select Rename Exa iConnect Client System File Edit View Action Settings Help rA pr Folders INBOX EL OUTBOX EL SENT ED ACKNOWLEDGMENT DRAFT E TRASH Rename
11. proxy settings using the Host IP Address and Port parameters Proxy server authentication can only be done with Java s http proxy settings which include a username password Host and Port parameters In the case of the iConnect client app the web server is accessed through a https connection If your computer is behind a firewall the proxy server must also handle HTTPS requests for you to visit a secure Web site on the Internet However there is one significant difference between a proxy server processing HTTP requests and HTTPS requests For HTTP requests the proxy server is able to parse the communication content and exercise a lot more discretion on policing the traffic including dropping the connection at the appropriate time a proxy server always assumes HTTP connections are non persistent On the other hand the proxy server will not be able to decipher HTTPS connections because of encryption so it has no choice but to relay the data intact and cannot drop the connection unless the client and or the server desires so Another secret of HTTPS proxy connections is that the actual client server communication need not to be encrypted or involve SSL even though this type of connection is often called SSL Tunneling Again this is because the proxy server assumes the subsequent communication will not be readable iConnect uses SSL for sending and receiving confidential XML messages SSL does not support proxies in the way that clear tex
12. D SUPPLIER RETAILER 200 SUPPLIER SUPPLIER view Document amp SUPPLIER SUPPLIER Delete Export as d Click the folder where you want to move your message s and click OK Move message s to folder i x Folders C INBOX C OUTBOX LJ SENT C ACKNOWLEDGMENT CJ DRAFT TRASH ORDERS SUPPLIER ik Cancel II H Deleting Messages 1 Delete message s by a Select message s to delete b Go to Edit gt Message gt Delete at the menu option or Exa iConnect Client System File Edit View Action Settings Help Move LJ OUTBOX t SENT E ACKNOWLEDGMENT L t DRAFT Sl t TRASH ORDERS SUPPLIER c Right click at the selected message s and select Delete Settings Help SUPPLIER SUPPLIER SUPPLIER Move SUPPLIER RETAILER View Document amp Export as d Click Yes to delete the message s Confirm Delete Message X 2 Do you really wank to delete selected 1 messagels Tip If you notice that your iConnect Client System is slowing down particularly in loading messages when clicking in folders segregate the messages in that folder by creating subfolders and move other messages to the subfolder Ea iConnect Client System File Edit wiew Action Settings He Eles Folders ER 07 21 03 EE 07 22 03 ACKNOWLEDGMENT e DRAFT Ean TRASH Tip For optimum performance on loading mes
13. G DB db 00005y exists 07 21 19 02 09 HS0LConnectionHandler DEBUG DB db 00006y exists 07 21 19 02 09 HS0LConnectionHandler DEBUG DB db O0007 exists 07 21 19 02 09 HS0LConnectionHandler DEBUG DB db 00008 exists 07 21 19 02 09 HS0LConnectionHandler DEBUG DB db 00009 exists 07 21 19 02 09 HS0LConmectionHandler INFO Database connection initialized to 07 21 19 02 09 ContigHsSQLConnectionHandler INFO Database connection 4 H Viewing realtime iConnect loga The number of lines that can be displayed at a time and the filtering level can be set by accessing the Options gt Realtime Log options or clicking on the Option button Log Files view Options 07 21 19 02 08 H QLConrnectionhHar 07 21 19 02 09 HSQLConnectionHar reat 1 Tire Fe nn We O aa ea a Dla Below is the Realtime Log Viewer Option window Realtime Log Viewer Options q x Scrollback lines 200 5000 200 Realtime Log Filter DEBLI Scrollback lines Sets the allowable lines to be displayed for the View Realtime Logging Realtime Log Filter Sets the Level of logs to limit This means that chosen level and higher will only be displayed This will not affect the actual content of the log file Note You can easily switch between views from the View menu except when Log Viewer was launched outside of the iConnect Client System 3 Toolbar Buttons Open Opens a log file with valid filename Thi
14. NT SPP c Right click at the selected message and select View Document gt in HTML From Part To Party ID SUPPLIER RETAILER 2003 07 22T08 10 3 SUPPLIER RETAILER 2003 07 22T08 10 3 SUPPLIED nETAN en ANNI az ATADA SUPP view Document P 0 3 SUPP Move in ML 0 4 Delete Export as 2 View message in XML by a Select a message b Go to View gt Message gt in XML at the menu option or Ena iConnect Client System File Edit view Action Settings Help Ae Message PF in HTML Impor inonbachs Folders Fror E E C ouTEOs E sur E SENT SHPBI Logs c Right click at the selected message and select View Document gt in XML Read From Part To Party ID Message ID SUPPLIER RETAILER 2003 07 22T08 10 3 SUPPLIER RETAILER 3 2003 07 22706 10 3 SUPPLIER RETAILER 2003 07 22706 10 3 SUPPLI wiew Document P In HTML SUPPLI a Move in PAL Delete Export as Note Only one message at a time can be viewed in HTML XML Note Newly received messages are in bold fonts Once viewed in either HTML or XML the Read status box will be checked and will change its font from bold to regular From Party ID To Party ID SUPPLIER RETAILER 2003 SUPPLIER RETAILER 2003 SUPPLIER RETAILER 2003 SUPPLIER RETAILER 2003 SUPPLIER RETAILER 2003 jm fo ra Note At the lower left of iConnect Client System window is the folder message status
15. NT GLN HERE 4808888023421 1 cContractNumber original 2002 07 01 Simple 8246951753 EN SET SENDER GLN HERE SET RECEPIENT GLN HERE 4808888023421 1 contractNumber original 2002 07 01 Simple 8246951753 EN SET SENDER GLN HERE SET RECEPIENT GLN HERE 4808888023421 1 contractNumber original 2002 07 01 Simple 8246951753 EN SET SENDER GLN HERE SET RECEPIENT GLN HERE 4808888023421 1 contractNumber original 2002 07 01 Simple 8246951753 EN SET SENDER GLN HERE SET RECEPIENT GLN HERE 4808888023421 1 contractNumber original 2002 07 01 Simple 8246951753 EN SET SENDER GLN HERE SET RECEFIENT GLN HERE 4809898023421 1 contractNumber original 2002 07 01 Simple 8246951753 EN SET SENDER GLN HERE SET RECEFIENT GLN HERE 4808888023421 1 contractNumber original 2002 07 01 Simple 8246951753 EN SET SENDER GLN HERE SET RECEPIENT GLN HERE 4808888023421 1 contractNumber original 2002 07 01 Simple 8246951753 EN SET SENDER GLN HERE SET RECEPIENT GLN HERE 4808888023421 1 contractNumber original 2002 07 01 Simple 8246951753 EN SET SENDER GLN HERE SET RECEPIENT GLN HERE 4808888023421 1 contractNumber original 2002 07 01 Simple 8246951753 EN SET SENDER GLN HERE SET RECEPIENT GLN HERE 4808888023421 1 contractNumber original 2002 07 01 Simple 8246951753 EN SET SENDER GLN HERE SET RECEPIENT GLN HERE 4808888023421 1 contractNumber original 2002 07 01 Simple 8246951753 EN SET SENDER GLN HERE SET RECEPIENT GLN HERE 4808888023421 1 contractNumb
16. O LEG H DRAFT H TRASH Timestamp 22 Jul 03 12 17 PM SEHT 22 Jul 03 01 03 PM SEHT 22 Jul 03 01 03 PM SEHT 22 Jul 03 01 03 PM SEHT 22 Jul 03 01 08 PM SEHT From Party ID Reference To Me Document Type RETAILER RETAILER RETAILER RETAILER RETAILER To Party ID SUPPLIER SUPPLIER SUPPLIER SUPPLIER SUPPLIER Message ID 2003 07 227T04 1 2003 07 227T05 0 2003 07 22T05 0 2003 07 22T05 0 2003 07 22T05 0 ontact List SUPPLIER SENT Folder 5 New Messages 5 Total Messages Scheduler Service iz OFF Receiving Acknowledgement from iConnect Server 1 Go to Action gt Receive Message or simply click Receive button to retrieve Acknowledgement messages from server Hi Connect Client System ee Connect Client System File Edit View Action Settings Help File Edit View Action Settings Helo pa Import E A Sen Gm Receive Ea FE in Send Message Receive Message Find Message Folders rom Party IL 3 INBOX Empty Trash ni NBOX E 2 ies StartiStop Scheduler Service ai ai Ee EC ACKNOWLEDGMENT E ACKNOWLEDGMENT EO DRAFT E DRAFT H E TRASH H E TRASH 18 2 All Acknowledgement messages will be placed in the ACKNOWLEDGEMENT folder These messages serve as a confirmation that the PO XML messages are now routed in the recipient s inbox at the server eF Connect Client System Ioj xj
17. Second Description 0 Number of Attempts specify the number of attempts to execute this tasks in case there was a connection problem Delay Between Attempts set the delay to execute tasks between attempts How To Define Schedules in the Schedule Manager There are 5 parameters that should be specified when defining a schedule in the Schedule Manager 1 Schedule Task Option parameter for specifying if the task will be scheduled for automated run 2 Time parameter for time entry values specified in the Set Time Per Time or Set Time By Range option 3 Day parameter for containing which day of the week the task will be executed 4 Week Frequency parameter for per week frequency i e if the task will be executed every week every 3 weeks etc 5 Start Date parameter for specifying the start date of task execution 43 Here s an example on how to set schedules using the Basic Schedule Controls Example 1 Task for Scheduling Import File to XML Message Time 9 00 AM 12 15 PM amp 5 59 PM Day Every Weekdays Week Frequency Every Week Start On Today Jan 22 2003 44 M Schecule this Task tor automaled run E Export XML Wessaqe to Fle ceed Send XML Message to Server dd Receve XML Message from E Set Time Fer tar C By Rage 05 59 FM 4 Fam Add 5 To 06 00 PM E Delete Intel f How set Day O fr Weekdays Specity Thor Tues are
18. System File Edit View Action Settings Help p Send Message Import Receive Message Find Message E INBOX E OUTBOX EL SENT ACKNOWLEDGMENT DRAFT EL TRASH Empty Trash Start Stop Scheduler Service 39 2 Enter the Message ID you want to find and press ENTER or click the Find button 0 Find Message x Message ID 5 47 39 1 S04 megi scn ph Folders SENT Row 14 Found 1 messagers Close 3 Click the item in the list box to automatically point to the folder at the Folder Tree Viewer and to the message at the Message Table Viewer B A 2003 07 16T05 47 37 16 Jul 03 01 47 PM a B 2003 07 16T05 47 39 eS E Tm DB A Find Message 416 Jul 03 04 47 PM aa B A PO 16 Jul 03 01 47 PM SEHT B A Message ID ins 47 3913042 mag1 sen ph Find T PO 16 Jul 03 04 47 PM SENT Po B A PO 16 Jul 03 01 47 PM SEHT O B A PO 16 Jul 03 01 47 PM SEHT Po B A PO 16 Jul 03 01 47 PM SEHT DB A PO 16 Jul 03 01 47 PM SEHT B A PO 16 Jul 03 01 47 PM SENT O B A PO 16 Jul 03 01 47 PM SEHT Po B A PO 16 Jul 03 01 47 PM SEHT Message Header Details From Party ID http Found 1 messager Close To Party ID httg i II P Schedule Manager The iConnect Schedule Manager lets users automate the 4 basic tasks of the client system 1 Import CSV files to generate the XML messages 2 Send XML messages to the iConnect server 3 Receive XML messages from the iConnect server and 4 E
19. T H E TRASH caac i Kado eo daar b Click the EXPORT button Exa iConnect Client System File Edit ghi tings Help Send a Receive From Party ID a H E OUTBOX SUPPLIER FL SENT SUPPLIER ACKNOWLEDGMENT SUPPLIER E DRAFT SUPPLIER TRASH hloccano Haardor Me c Right click on the selected message s to be exported and choose Export As ee Re ten del TO Intogl COST eee Message ID Refer View Document amp SUPPLIER RETAILER B a SUPPLIER RETAILER Move SUPPLIER RETAILER Delete SUPPLIER RETAILER Sa a 3 The Export XML to CSV XML File dialog will be shown Selected messages can be exported either in CSV or XML file format Click the BROWSE button to specify the target directory Click OK to start exporting the selected files ons Export XML message to CS 3ML file x Export As F CSi hL Directory Browse OK Cancel 21 II B Mapping Configurations Default mapping configurations for the pre installed document types are already specified for your convenience You can use these mapping configurations to import the sample CSV file inside the iconnect sample directory in the iconnect folder Reference for the mapping configurations for this CSV file is also located in the same directory To set iConnect on how to import CSV files to XML message and export XML message to the preferr
20. arty 1234567890999 GLN is 1234567890999 CN http www panc org ph party 1234567890999 OU Food Manufacturing O My Company L Quezon City ST Metro Manila C PH The iConnect System Administrator will notify you as soon as the Public Key is authenticated Note There is no need to click the Generate new Key Pair button when your Public Key is already authenticated by the iConnect System Administrator All you have to do is simply import your private key public key and public key certificate set its valid passphrase at the Security tab To import the files click Import button and specify the location of the needed file After setting all the required files and passphrase click the SAVE button This will check whether all entries are correct otherwise an error prompt will be shown 10 When you restart the application again you will be prompted to enter the passphrase for your Private Key file when the Require Passphrase at Login is checked at the Security tab in the Security and Identity Configurations window Exa Security amp Identity Configurations x Identity Security Certificates Private Key Secret Key lesiconnectiny private key ek Import Export Public Key esiconnectimy public key pk Import Expor Public Key Certificate Import Export Wey Passphrase rare Change Passphrase 10 11 Below is the iConnect Login window Enter the valid Passphrase to login iConnect Client System
21. connectiny public key pk Ea Security amp Identity Configurations Identity Security Certificates Global Location Murmber CL fi 234507390123 Local Party Do http ie panc org phiparty 234567890123 Edit Prefix Company Marie fy Company It is important that you keep the Private Key key pair with the sk extension name file from getting deleted or used by unauthorized persons We recommend that you backup this file and take note of its passphrase You can store the file in an access secured directory or in a diskette Just click the Browse button at the Security amp Identity settings to specify the location of the Private Secret key if you want to use it from a diskette of another folder The Public Key key pair with the pk extension name file must be submitted to the iConnect System Administrator for authentication otherwise the client application will not be able to access the iConnect server Send an email to support scn ph with the attached Public Key file and specify the following needed information in the email content CN Common Name Local Party ID used in generating the Public and Private keys OU Organizational Unit Type of Organization Unit ex Food Manufacturing O Organization Name of Organization Company L Locality City ST State State Province C Country Two Letter Country Code Here s an example Public Key application info assuming that the Local Party ID is http www panc org ph p
22. digression Log files give us details to help you troubleshoot the program II R Settings for Proxy Server Access Connect can access the Internet through a proxy server for sending receiving messages Go to Settings gt Connections to configure the application for proxy server access 1 Check the Use proxy checkbox 2 Specify Proxy IP address 3 Specify Proxy port Ea Connection Settings x Enter the URL of the Connect server Inttpss drwy iconmect com ph Use proxy 1 Proxy IP address 2 Proxy part 3 3128 In order for iConnect client system to connect to the iConnect server the proxy server must allow https connection and security policies i e user authentication should be configured properly to allow the client app to access the iConnect Server URL see Part 1 Section E for the default iConnect Server URL value If the client app is installed in a computer behind a firewall make sure that the firewall allows https connection via port 443 58 Notes on Proxy Server Setup Connect ebXML client system is a stand alone Java application that is capable of sending and receiving ebXML messages to from a secured web server iConnect is dependent on the environment settings in the Java Virtual Machine or JVM and by default the JVM is configured for a proxy server access By using the Connection Settings dialog window the JVM will be configured for proxy server access The JVM only supports HTTPS
23. dow for viewing importing the schema files that will be used to define the document type messages in the iConnect system E Connect Client System Folders Document Schema INBOX E OUTBOX EL SENT ACKNOWLEDGE DRAFT TRASH 2 By default there will be Document Types already installed in the system You can find the schema files for these document types by referring to the Location column oN Document Schema Configuration ORDERS PURCHASE ORDERS echemalorders dO xd PO PURCHASE ORDERS schemaipo 21 xsd PRODAT PRODUCT DATA schermalprodat 1 0 xsd 3 To create new document type click on the Import New Schema button to launch the dialog window for importing the new schema file Ea Import new schema x Document Type Description Location Browse Import Cancel 4 Fill up the following text fields and then click the Import button to create the new document type based on the schema file Document Type name of the message document ex PO PRODAT Description description for the message document ex PURCHASE ORDER PRODUCT DATA Location file location of the schema file click the Browse button to set the schema file s location I G Uninstalling iConnect Client System To uninstall the application simply delete the iconnect folder 15 II USING iCONNECT CLIENT SYSTEM II A Sending and Receiving Messages To test the iConnect Client System use the sample PO
24. e Contirm Passphrase Export Private Key As Browse Export Public Key ds Browse Generate Cancel New Passphrase password for the Public and Private Key and for login access in the iConnect client application Export Private Key As filename of the Private Key to be generated Note that the extension name sk will be automatically added at the end of the filename you specify The Private Key file will be saved inside the iconnect application folder Export Public Key As filename of the Public key to be generated Note that the extension name pk will be automatically added at the end of the filename you specify The Public key file will be saved inside the iconnect application folder Use file naming scheme to distinguish different key pair versions Ex Public key My Company01 pk My Company02 pk Secret key My Company01 sk My Company02 sk 7 Click Generate button to generate the key pairs This will take some minutes to finish depending on the speed of your computer Ea Generate New Key Pair x Old Passphrase Mew Passphrase rasa Confirm Passphrase rasa Export Private Key As ny _private_key sk Browse Export Public Key As ny _Public_key pk Browse 8 After the key pairs are generated a message box will appear specifying the location where the generated key pair was saved Click OK Message Ci Key pair generated Private Key CHliconnectimy private key sk Public Key CHli
25. e Settings button The next time iConnect starts up the Scheduler Service will automatically run 52 II Q Log Viewer To help keep track of the messages being transacted logging function has been implemented for this version of the IConnect Client System The logs will note every activity the program is doing Logging functions will also aid in troubleshooting the program in the event an error may occur 1 Running Log Viewer There are two ways to run the program a The Log Viewer can be launched without running iConnect Client System At the iconnect directory double click log viewer bat log viewer sh for Linux users ER C iconnect q JD x File Edit View Favorites Tools Help qa Back Gi search Fy Folders cs LS E mx o HER Address _ CHiconnect Folders oa cert H Desktop Ey My Documents SAB My Computer ee 314 Floppy f EEB WINDOWS C conf _Jlogs H Documents and Settings sample H iconnect schema H Program Files stylesheet e heap size editor bat a heap_size_editor sh iconnect run bat LO WINNT EE BACKUP D3 Fey Compact Disc 15 a Control Panel ar Tm log viewer bak Rue log_viewer sh Type M5 D05 Batch File Size 152 bytes 152 bytes My Computer D 53 b If the iConnect Client System is already running Log Viewer can be launched by clicking on View gt Logs menu Ea iConnect Client S
26. ed Operating System Any Operating System that supports Java Runtime Environment JRE 1 4 1 or higher Sample operating systems supported are Windows 95 98 ME Windows NT 4 0 service pack 5 Windows 2000 Windows XP Linux Intel kernel v2 2 12 Solaris Minimum screen area setting is 800 x 600 pixels Recommended value is 1024 x 768 for better viewing of the interface I B Installing amp Running the IConnect Client System I Install the Java Runtime Environment using the JRE installer included in the zip file or downloaded from http java sun com downloads html To check whether the JRE is installed in the system run java version on the command line prompt If JRE is properly installed you should see the following output at the screen C gt java version java version 1 4 1 03 Java TM 2 Runtime Environment Standard Edition build 1 4 1 03 b02 Java HotSpot TM Client VM build 1 4 1_03 b02 mixed mode 2 Extract the iConnect zip file to a specified directory location This extraction will create the iconnect folder which contains the needed files to run the application For example extracting the zip file to C will create iconnect folder in that directory EM Ci connect File Edit View Favorites Tools Help qa Back mb A Search GE Folders Eui Pr s Le PE co Er Address _ CHiconnect Folders E Jia My Documents E My Computer Egg 314 Floppy 43 si sample Fy WINDOWS C2 schema ED
27. ed CSV format specify the appropriate mapping columns for each document type 1 Go to Settings gt Mapper There are 2 options for this item Ea iConnect Client System File Edit View Action Settings Help ME Import A i Export Security amp Identity Connections Document Schema From Party ID To Parl on INBOX Mapper Qs Import Configurations Em OUTBOX Document Display Export Configurations SENT HO MEP EDGE Schedule Manager EL DRAFT EL TRASH a Import Configurations for setting the Import mapping configurations CSV to XML message b Export Configurations for setting the Export mapping configurations XML message to CSV 22 2 In the mapping configuration window choose the document type for specifying the column numbers for each element attribute of the XML message a b For Export mapping configurations specify the column number where the XML element attribute from the XML message will be placed in the generated CSV file Take note that empty field entries are not allowed and column values should be sequential For Import Configurations specify the column number where the XML element attribute is located in the CSV file You can leave the column number blank for optional elements attributes so that these data will not be included in generated XML message Be careful in specifying the column values to avoid parsing errors during import of CSV files Duplicate column value entrie
28. ed after the import operation 2 If you are not sure that the CSV file was already imported follow these steps to make sure that you don t generate duplicate messages in the OUTBOX folder a Check if there are messages in the OUTBOX folder b Determine the source CSV file for these messages c Delete all the messages inside the OUTBOX folder and re import the CSV file needed to generate the same messages again 3 If an error occurred while importing the CSV file possible errors are parsing problems or incomplete import operation delete the messages that were generated during the import process of the said file to prevent duplicate messages Re import the same CSV file to generate the messages again 4 Before sending the messages in the OUTBOX folder make a log file and record details specified below This will help users in determining which documents have been already sent a Number of messages in the OUTBOX folder prior to send operation b Source CSV file of messages in the OUTBOX folder c Start and End date time of send operation d Number of messages sent e Document Types and IDs III B Automated Import and Send Operation Scheduler Note This guideline assumes that you are comfortable in using the Scheduler Please refer to the Section II P Schedule Manager for guide in using the Scheduler 61 1 When invoking a manual operation like Import and Send while the Scheduler is running please take note of the fo
29. er original 2002 07 01 Simple 8246951753 EN SET SENDER GLN HERE SET RECEPIENT GLN HERE 4809898023421 1 contractNumber original 2002 07 01 Simple 246951753 EN SET SENDER GLN HERE SET RECEPIENT GLN HERE 4809898023421 1 contractNumber original 2002 07 01 Simple 8246951753 EN SET SENDER GLN HERE SET RECEPIENT GLN HERE 4808998023421 1 contractNumber original 2002 07 01 Simple 8246951753 EN SET SENDER GLN HERE SET RECEPIENT GLN HERE 4808888023421 1 contractNumber original 2002 07 01 Simple 8246951753 EN SET SENDER GLN HERE SET RECEPIENT GLN HERE 4808888023421 1 contractNumber original 2002 07 01 Simple 8246951753 EN SET SENDER GLN HERE SET RECEPIENT GLN HERE 4808888023421 2 Goto File gt Import or simply click IMPORT button to launch the Import CSV file to XML message window Ea iConnect Client System ons iConnect Client System File Edit View Action Set File Edit View Action Settings Help Import Export Exit C INBOX x E OUTBOX E SENT El ACKNOWLEDGMENT ED ACKNOWLEDGMENT H DRAFT W E DRAFT H TRASH E E TRASH 16 Exa Import C5 file to XML message l x Document Type AS O PR od D aa ey File Brovyse OH Cancel 3 Specify the document type of the CSV file to be imported Click the BROWSE button to specify the location of the CSV file then click OK to import it During import a progress window will be shown After successfully importing the CSV file you sh
30. ferring to the message s Timestamp value you can determine which messages were sent by the Scheduler on a certain date time value c After you have determined the messages that were sent check the Document ID by viewing the message s content in XML or HTML format With these Document IDs you can now determine which documents in the CSV file that were already sent Connect User Manual Revision 2 2 2003 Supply Chain Networks Inc
31. h Add To 06 00 PM Delete Interval Hour Set Day F Everyday C Weekdays O Specify Dor Tues Wed Thurs Fri Sat Sun Every 4 H Week s Starton Jul 18 2003 Fri E Location of Files Change File Type fe cesy KML save Settings Run Scheduler Service on iConnect startup Close Scheduler Servi The Scheduler Service can also be started by clicking Action gt Start Stop Scheduler Service menu item Exa iConnect Client System File Edit View Action Settings Help Send Message i EE Folders Find Message y i INBOX Empty Trash OUTBOX Start Stop Scheduler Service Receive Message SENT ACKNOWLEDGMENT HD DRAFT t TRASH When the Scheduler Service is successfully started the status message at the lower right corner of the main iConnect window will change from Scheduler Service is OFF to Scheduler Service is ON 51 a a rel ick Leer AT F F SS a A ee cpt ms a E qe rr a i r era E 2 Sy Ds er Eu E o a 1 5 T z pi E Es Fi ae Fhe T mi i Ea E i ai L ime Se Peal a ii Pio rs ato EITTE Ee er ey sy Try E rea Ed ama pe e 1 1 gt Starting the Scheduler Service when iConnect starts To start the Scheduler Service after launching the iConnect Client app check the Run Scheduler Service on iConnect Startup checkbox and then lick Sav
32. iConnect Client System E E a 5 iC Sa all Posverod p User Manual TABLE OF CONTENTS I INSTALLATION SETUP GUIDE IA System Requirements I B Installing and Running the iConnect Client System I C Setting Up Your Company s Identity Generating Key Pairs ID Configuring the Display Style Sheet and Internet Browser Application I E Setting the iConnect Server URL I F Schema File Configurations I G Uninstalling iConnect Client System II USING iCONNECT CLIENT SYSTEM II A Sending and Receiving Messages II B Mapping Configurations II C Viewing Message in HTML or XML II D Creating Folders I E Renaming Folders II F Deleting Folders II G Moving Messages II H Deleting Messages II I Emptying Trash II J Checking iConnect Version II K Adding New Contacts and Specifying Contact Display Style Sheets II L Editing Contacts II M Deleting Contacts II N Sorting Messages I O Finding Messages II P Schedule Manager II Q Log Viewer II R Setting Proxy Server II S Java Heap Size Settings III TIPS ON PREVENTING SENDING OF DUPLICATE MESSAGES III A Manual Operation of iConnect Import and Send Operations III B Automated Import and Send Operation Scheduler 11 13 14 15 16 22 25 26 28 30 31 32 34 35 36 38 38 39 39 40 53 58 59 61 61 I INSTALLATION SETUP GUIDE I A System Requirements 1 2 Pentium III 500Mhz or higher or equivalent CPU At least 128 MB RAM memory is requir
33. iConnect System information which will be useful for technical support 35 E About iConnect x yaten Information uild Yersion 2 0 0 2005 07 22 Java Version 1 4 1 01 aum Microsystems Inc Ci jesdkl 4 1 014 j4re Windows 2000 x66 5 0 ic Copyright Supply Chain Networks Inc ll Rights Reserved a II K Adding New Contacts and Specifying Contact Display Style Sheets You can add contacts containing company information such as Name and Party ID Contacts are useful to easily identify the sender or receiver of your messages in the message grid view You can also specify specific display style sheets for each contact 1 Add a contact list by a Right click at the Contact List window pane Choose New to launch the Create New Contact Information window or Edite Delete b Goto File gt New gt Contact at the menu option E Connect ebXML Client Sys File Edit view Action Settir Memo P Folder Import Contact Export Exit ZENT 36 2 Fill up the text fields and then click the Save button when finished Note Name and Party ID are required values E q ze Contact Information AI Mame My Suppliers 0000022 Party ID hte Jew panc org phiparty 234567890789 PRODUCT DATA TT PRICE CATALOG E PURCHASE ORDER Po 3 At the bottom of the Contact Information window you will see a grid table where you can specify display style sheet for a particu
34. iConnect client application will be used to identify your client PC when accessing the message service of the iConnect Server Please follow these steps to generate the key pairs 1 Go to Settings gt Security amp Identity at the menu options to launch the Security amp Identity Configurations window ons iConnect Client System File Edit View Action Settings Help Security amp Identity Connections Folders Document Schema El INBOX Mapper b Ha OUTBOX E E E q Document Display EO ACKNOVYLEDGMEN Schedule Manager ECO DRAFT EL TRASH 2 Below is the Security amp Identity Configurations window Click the Identity tab to view the Identity settings Ea Security amp Identity Configurations x Global Location Mumber LM Local Party Do tp iara panc org phiparty Edit Pretix Company Mare Global Location Number GLN a 13 digit number used to uniquely identify a location e Specify the Global Location Number or GLN of your company to set the Local Party ID to be used by the application Local Party ID identification name that will be registered to the iConnect server It consists of the URL prefix http www panc org ph pa GLNnumber e By default the prefix of the Local Party ID is http www panc org ph party Click the Edit Prefix button if you want to replace the prefix specified Company Name Specify the company name Click the Security tab to view the Security set
35. if you want to specify time values in a certain range Ch From Time Spinner set the start time here similar to Time Spinner on setting values Ci To Time Spinner set the end time here similarto Time Spinner on setting values db us Interval choose the interval of time values within specified range time intervals can be in per hour or per minute unit Q eo Day options specify whether the task will be execute Everyday Weekday or on specific ays only T Every Week interval choose the frequency per week a task should be executed m Start On date start date value wherein the task will start for automated execution 42 The following diagrams describe the Specific Controls for Import Export and Send Receive These controls can be found below the Basic Schedule Controls in the Schedule Control View IMPORT fEXPORT Tasks a Location of Files EtEsported Change b c File Type fe coy TO XML Description 2 Location of Files shows the current path location of the files to be imported and target locations for exported messages SL beara this will launch a File Location Chooser dialog box wherein yon cari ea the path location vou can also create the folder with the File Location Chooser dialog box File Type st eet choose the type to be used for Import Export for Import only CS file type is available SEND RECEIVE Tasks O Try to executa ths tesk by 0 Attem atls e Delay beh weer attempts 0 In
36. is box if you want Scheduler to run right after start up 1 Close button click this button to close the Scheduler Manager window The following diagram shows the Basic Schedule Controls in the Schedule Control View that can be used for setting the schedule for each task Set Time Per tern O C By Range a 12004M 5 o From f 09 C0 AM h c Ade e Te 06 C0 PM 1 Delete C Interv 1 Hour 1 Q Sel Day Byeryday I Weekdays O Specify Won Tues Wed P Thus Fri Sat Sun 1 Every 1 Weeks m Start on tar 22 2005 We Description Schedule Task checkbos check this box if you want to automate the selected task in the Task List view uncheck to disable automated run b Set Time Per Item option choose this option if you want to specify specific time values C Time Entry Listhox shows the time values that have been added Time Spinner click on the time element value that you want to change selected element s a value can be changed by clicking the tiny arrow buttons in the spinner pressing the keyboard upidown arrow keys or typing the value E ada button click this button to add the Time Spinner value to the Time Entry listbox Delete button click this button to remove the selected time entry in the Time Entry listbox you can select more than 1 item in the Time Entry listbox a Set Time By Range choose this option
37. lar contact Double click on the File Location s row to launch the Set File dialog window Choose the display style sheet file of the contact 4 Click the Save button to save all settings 37 II L Editing Contacts 1 Edit a contact list by a Go to Edit gt Contacts gt Edit View at the menu option or E Connect Client System File Edit View Action Settings He e Message P Folder F Contacts E OUTRO b Right click at the Contact List window pane Choose Edit View to launch the Create New Contact Information window Per Edit view Delete II M Deleting Contacts 1 Delete a contact by a Go to Edit gt Contacts gt Delete at the menu option or ons iConnect Client System File Edit View Action Settings He Message P Folder Contacts P H E OUTBOX Edit Delete 38 b Right click at the Contact List window pane Choose Delete to launch the Create New Contact Information window New Edit Pie II N Sorting Messages IConnect can sort messages either in ascending or descending order according to column by clicking at the table grid columns To Party ID From Party ID Ref To Message ID Message ID Message Type Timestamp Status Table Grid Columns II O Finding Messages Find Message lets users to locate a message with the specified Message ID value 1 Goto Action gt Find Message to use this tool Ea iConnect Client
38. llowing a If the Scheduler is currently executing a certain Task Import Send Receive or Export it will finish first its task before allowing the user to do a manual operation b When doing a manual operation the Scheduler will top and resume after you are finished executing a task 2 Read the Scheduler logs at the Scheduler Manager window or log files inside the conf folder to verify whether automated tasks were done properly With these logs you can verify if a CSV file was successfully imported or messages in the OUTBOX folder were sent properly 3 Before doing a manual import of a CSV file make sure that the Scheduler has not yet imported the said file refer to Section B 2 on how to do this Refer also Section A 2 and A 3 if an error occurred during the automated import These steps will help you do a manual import that will not generated duplicate messages in the OUTBOX folder 4 In case wherein only certain messages in the OUTBOX folder where automatically sent due to incomplete automatic Import operation possible errors are parsing problems or unfinished import operation here are some steps that you can do to determine which documents where already sent a Check the Scheduler log statements and determine the number of messages sent by the Scheduler Take note also the date and time of execution and completion b The messages in the SENT folder are sorted by TIMESTAMP in increasing order first to last date time By re
39. lower left panel To open a log file click on the file you wish to be displayed The content of the log file will be shown on the main panel You may cancel opening the log file by clicking on the cancel button which appears every time you open a log file b View Realtime Logging shows the logs of the current process being done by iConnect Client Upening database F E Log iewer i Created Created Created Created Created Created Created Created Created Created Database Only folders labeled in YEAR_MONTH format will be displayed Click on the folder you wish to show its content Log files in DE DE DE DE DE DE DE DE DE DE O x dh O dh O db 0 db 0 dh O db O db 0 db 0 dh O db 0 connect ConftighsQLConnectionHandler INFO PE H System This is the default view when launching LogViewer within the iConnect Client System 55 Logriewer l Log Files view Options 5 x 07 21 19 02 08 HSQLConmectionHandler INFO Upening database connection 07 21 19 02 09 HS0LConnectionHandler DEBUG DB db 00000 exists 07 21 19 02 09 HS0LConnectionHandler DEBUG DB db O00001 exists 07 21 19 02 09 HS0LConnectionHandler DEBUG DB db 00002 exists 07 21 19 02 09 HS0LConnectionHandler DEBUG DB dbY0000S exists 07 21 19 02 09 HS0LConnectionHandler DEBUG DB db 00004 exists 07 21 19 02 09 HS0LConnectionHandler DEBU
40. ment Display Configuration x Set Location of Browser feProgram Files Writernet Explorervexplore exe Browse Double click to set the path forthe detault Display Stylesheet Sue Tyge ORDERS PURCHASE ORDERS stylesheetiorders 1 OU display xsl PO PURCHASE ORDERS tylesheetipo 214 01 display xsl PRODAT PRODUCT DATA stylesheetipradat_1 O display xsl E Set Display XSL File Look in CA stylesnet tsi EE orders O dizplayxs po 24 MM display xs Recent prodat_ 1 0 display xsl Deskto a ER vex File nare Et rede Files of type Display Stylesheets xsl Cancel 4 Click SAVE button 12 I E Setting the iConnect Server URL 1 Go to Settings gt Connections to specify the URL location of iConnect server Ena iConnect Client System Fie Edit View Action Settings Help Security amp Identit ME Import E ti Connections Document Schema E INBOX Mapper b OUTBOX SSS SENT A ACKNOVYWLEDGMEN E DRAFT E TRASH Document Display Schedule Manager The default value is https www iconnect com ph Ea Connection Settings x Enter the URL of the Connect server figos vee iconnect com ph Use proxy Proxy IP address TE Proxy port a1 20 OK Cancel Note See Section II R on how to configure the settings on Proxy Server Access 13 I F Schema File Configurations 1 Go to Settings gt Document Schema to launch the win
41. o Fie Edit view Action Settings Help de Export a Send sa Receive q T From Party ID Folders E INBOX EL OUTBOX E SENT ERR a LED SMENT EL DRAFT ED TRASH To Party ID Message ID Reference To Message ID Document Type Timestamp SUPPLIER RETAILER 2003 07 22T0F 18 57 89207 2scn ph 2003 07 22707 18 48 38 Acknowledgment 22 Jul 03 0 RECEIVED SUPPLIER RETAILER 2003 07 22 T0f 18 57 89307scn ph o 2003 07 22707 18 53 93 Acknowledgment 22 Jul 03 0 RECEIVED SUPPLIER RETAILER 2003 07 22 T0F 18 59 03607 2scn ph 2003 07 22 TOF 18 53 12 Acknowledgment 22 Jul 03 0 RECEIVED SUPPLIER RETAILER 2003 07 22 T0f 15 59 22602 2ecn ph 2003 07 22707 18 49 55 Acknowledgment 22 Jul 03 0 RECEIVED SUPPLIER RETAILER 2003 07 22T0f 18 59 22702 ecn ph 2003 07 22707 18 49 63 Acknowledgment 22 Jul 03 0 RECEIVED 11101A ontact List SUPPLIER ACKNOWLEDGMENT Folder 5 Mew Messages 5 Total Messages Scheduler Service jz OFF If you are able to receive the acknowledgement messages properly your private key and public keys are properly set and your connection to the iConnect server is working Receiving XML Message 1 Go to Action gt Receive Message or simply click Receive button to retrieve XML messages from the server All XML messages will be placed in the INBOX folder Hi iConnect Client System s Connect Client System File Edit View Action Settings Help File Edit View Action Settings
42. ould see this info message window This will create PO XML messages in OUTBOX folder x Ci 5 messages Created 4 Check your OUTBOX folder There should be 5 messages in it Ena iConnect Client System E LO x File Edit View Action Settings Help Folders INBOX Fees POUTBOX E SENT E E ACKNOW LEC Ay H DRAFT H TRASH Reference To Message ID Document Type ime PREPARE PREPARED PREPARED PREPARED PREPARED Timestamp RETAILER RETAILER RETAILER RETAILER RETAILER SUPPLIER SUPPLIER SUPPLIER SUPPLIER SUPPLIER ontact List SUPPLIER gt OUTBOX Folder 5 New Message s 5 Total Messaqe s Scheduler Service if OFF 5 Go to Action gt Send Message or simply click SEND button to send PO XML messages from OUTBOX folder to iConnect server All messages successfully sent will be archived in the SENT folder 17 Ea iConnect Client System Exa iConnect Client System File Edit view Action Settings Help File Edit view Actio pmm Send Message Inport Receive Message Folders Find Message FD INBOX Empty Trash Start Stop Scheduler Service 1 0 SENT ACKNOWLEDGMENT 0 DRAFT TRASH ACKNOWLEDGMENT DRAFT H TRASH ei iConnect Client System 10 x File Edit View ction Settings Help dt moon BB co Soo Folders El INBOX El OUTBOX O El ACK
43. purchase order CSV files provided during installation found in iconnect v2 sample po directory Sending PO Messages 1 Before importing the sample CSV files set first the BUYER and SELLER GLN columns in the CSV file Replace the text SET SENDER GLN HERE with the buyer sender GLN and SET RECEPIENT GLN HERE with the seller receiver GLN B po_ 1 sample csy WordPad File Edit wiew Insert Format Help Delal eall al sael 1 contractNumber original 2002 07 01 Simple 8246951755 EN EANES ROR A A 4505555023421 1 contractNumber original 2002 07 01 Simple 8246951753 EN SET_SENDER_GLN_HERE SET RECEPIENT GLN HERE 4808888023421 1 contractNumber original 2002 07 01 Simple 8246951753 EN SET_SENDER_GLN_HERE SET RECEPIENT GLN HERE 4808888023421 1 contractNumber original 2002 07 01 Simple 8246951753 EN SET SENDER GLN HERE SET RECEPIENT GLN HERE 4808888023421 1 contractNumber original 2002 07 01 Simple 8246951753 EN SET_SENDER_GLN_ HERE SET RECEPIENT GLN HERE 4809898023421 1 contractNumber original 2002 07 01 Simple 8246951753 EN SET_SENDER_GLN_ HERE SET RECEFIENT GLN HERE 4809898023421 1 contractNumber original 2002 07 01 Simple 8246951753 EN SET SENDER GLN HERE SET RECEPIENT GLN HERE 4908998023421 1 contractNumber original 2002 07 01 Simple 6246951753 EN 3ET SENDER GLN HERE SET RECEPIENT GLN HERE 4808888023421 1 contractNumber original 2002 07 01 Simple 8246951753 EN SET SENDER GLN HERE SET RECEPIE
44. quency value by clicking on the tiny spinner buttons pressing the up down keyboard buttons or typing the value E set the start date The default value tor the Start Date spinner is the current date value of the operating system For this case select the date Par vou want to change and then press the tiny arrow buttons press the up down keyboard buttons or type the value 47 If the current OS date time is Jan 22 2003 WED 4 30PM the Scheduler Service will execute the task on the next latest schedule which is Feb 16 2003 SUN 9 30AM Feb 14 2003 is not the next latest schedule because this date falls on Friday The table below shows the 5 week schedule that will be generated after saving the settings on Jan 22 2003 WED 4 30PM WEEK DATE TIME FEB 16 2003 SUN FEB 18 2003 TUES FEB 20 2003 THURS MAR 2 2003 SUN 3rd MAR 4 2003 TUES MAR 6 2003 THURS MAR 16 2003 SUN 5th MAR 18 2003 TUES MAR 20 2003 THURS Note Week starts on Sunday 48 How To Use the Import Export Directory Bin To use the Import and Export task scheduler users must set the Directory Bin folder location wherein the CSV XML files will be placed for import or export To set the Directory Bin location set the Location of File parameter at the Specific Control for Import Export Tasks please refer to the Overview discussion The Directory Bin consists of subfolders inside the specified Directory Bin location Let s say that the user specified C
45. rity This priority provides details of the error Usually these messages are followed by a description and the location what module the error has occurred Here is an example of a log with ERROR level 06 03 15 07 57 Test ERROR Invalid Global Location Number java lang StringIndexOutOfBoundsException String index out of range 1 at java lang String charAt String java 460 at test Test main Test java 33 5 Understanding Log Files Log files are stored in the logs folder where your iConnect Client System has been installed Logs are kept in folders labelled in YYYY_MMM ex 2003 Jul to organize your log files Log files have the filename clientLog MMDD part N log ex clientLog 0720 part 01 109 to distinguish each log files by the day the loggings have been made Since these files can be very large especially when the 57 iConnect Client System has been doing a lot of processes their file size does not exceed 3mb of size In this regard loggings per day are separated into different parts Other folder in the logs folder are errorLogs and archivedLogs The folder errorLogs contains loggings made by logging program of the iConnect Client System The folder archivedLogs contains past log files zipped into one Zip file per month They can be unzipped with WinZip or any compression program that supports zip compression Log files are put to archive when they are three months old Delete them at your own
46. s are not allowed except for the Receiver s Party ID which is the GLN location of the receiver of your XML message document Ea Import CS to XML Mapping Configuration x b At which colurn iz the receiver s Global Location Number LMI E Order c CreationDate 4 Documenti Language 7 Murmmber Document Type opina pies Oks ite ible ic Ra Buyer Clr E Sanceliidotbelverede Date 115 Tire i a DeliveryDate Cwm F Save Cancel Description a Document Type combo box click on the down arrow button to view the document type available for mapping configuration b Receiver s Party ID Column value specify here the column number of the GLN of the receiver of this document type in the CSV file Y Elements Attributes Column value specify here the column number of the specific elements altributes of the AML message in the CSV file 23 Fa 4 Export ZML to C5 Mapping Configuration ORDERS PURCHASE ORDERS c documentID parameter should be set always to 1 d Click the Save button to save the settings 24 II C View Message in HTML or XML 1 View message in HTML by a Select a message b Go to View gt Message gt in HTML at the menu option or Exa iConnect Client System File Edit View Action Settings Help inHTML g Gonbacks In AML Folders Logs From ERES E SUPPL E OUTBOX SE
47. s can be also accessed in from the Log Files gt Open menubar Export Exports the log file currently being viewed Choose the folder where to save the log file Disabled when in View Realtime Logging This can be also accessed in from the Log Files gt Export menubar Reopen Reopens the log file currently being viewed Disabled when in View Realtime Logging Option Shows the options for View Realtime Logging Disabled when in View Log Files This can be also accessed in from the Options gt Realtime Log options of the menubar Clear Clears the view of View Realtime Logging Disabled when in View Log Files Find Finds a specific word in the view 4 Understanding Logs All logs are written in this format MM DD hh mm ss MODULE LEVEL MESSAGE MM month stamp of the log in number format DD day stamp of the log hh hour stamp of the log in military format mm minute stamp of the log ss seconds stamp of the log MODULE module of iConnect Client System currently running LEVEL level of priority of the log DEBUG Lowest level of priority This priority provides more detailed information of the current process These will be most helpful for troubleshooting possible error INFO This priority contains informative messages that states current status of the current process WARN This priority contains messages to warn potentially erroneous process ERROR FATAL Highest level of prio
48. sages in folders limit the maximum number of messages between 500 to 1000 entries II I Emptying and Recovering Message From Trash 1 Empty Trash by a Click TRASH Folder b Go to Action gt Empty Trash at the menu option or Exa iConneck Client System File Edit View Action Settings Help Send Message Import Receive Message Folders Find Message E NBOX Empty Trash OUTBOX SENT ACKNOWLEDGMENT DRAFT Start Stop Scheduler Service RETAILER RETAILER 34 c Right click at the TRASH folder or anywhere at the Folders window pane and select Empty trash Ea iConneck Client System File Edit View Action Setting B noen BB 5 Folders F E INBOX E OUTBOX E SENT ACKNOVYLEDGMENT DRAFT Peman Delete Empty Trash Note iConnect allows to restore messages once deleted by moving it to your desired folder However you cannot move messages from TRASH folder to either OUTBOX or DRAFT folders Tip It is recommended that the TRASH folder should be emptied on a regular basis Limit the number of deleted messages in the TRASH folder between 500 to 1000 for optimum performance when loading and emptying the TRASH folder II J Checking iConnect Version 1 Goto Help gt About iConnect menu option Connect Client System File Edit View Action Settings Help 2 Below is the About iConnect dialog window It serves as a quick reference for your
49. t HTTP does in terms of protocol design since an SSL connection is end to end Only the original server on the remote end can do the necessary decryption and encryption for communication Contrast this with Plain HTTP which is easily handled by a server such as Squid or MS Proxy Server because it takes requests as a server and makes requests as a client One possible approach to allow iConnect client app to connect to an HTTPS web server through a proxy server is to set per IP basis security policies Network Administrators can do this by relaxing the security policies for accessing the iConnect web server at https www iconnect com ph II S Java Heap Size Settings The Java heap size is set depending on the size of RAM installed in your PC This is done to enable the JVM run on the correct RAM settings and as a solution whenever your application encounters Out of Memory problem 1 To set the Java heap size double click heap_size_editor at the iConnect directory 59 EN C iconnect File Edit View Favorites Tools Help Back Gi search Fy Folders ca sux 7A EE Address E Ciconneck Go _jcert Folders 17 Desktop E My Documents SAB My Computer Ele 344 Floppy 4 3 A WINDOWS C2 E Documents and Settings Sy connect Aa Program Files ED WINNT SS BACKUP Ds EE Compact Disc 6 4 ER E Control Panel conf Jd lib E logs iph _ sample schema heap si
50. tings Ema Security amp Identity Configurations i x Private Key Secret Key Import Export Public Key LO Import Export Public Key Certificate Lo Import Export EW Passphrase Po Change Pazsphrase E Require passphrase at login Generate Mew Key Pair Private Key Secret Key contains the secret key file that will be used to identify the client user to the iConnect server Public Key contains the public key file to be submitted for authentication Public Key Certificate contains the certificate file which is issued after authenticating the public key file Passphrase private key password 4 Click the Generate New Key Pair button lt security amp Identity Configurations Private Key Secret Key Import Export Public Key a Import Export Public Key Certificate o mpo Export View Passphrase PO Change Passphrase i Require passphrase at login Generate Hew Key Pair SAVE Cancel 5 After clicking the Generate New Key pair button this warning message will appear Waming ss hm gt TF you generate a new key pair your old private and public keys will no longer be valid and the application will be locked to the Party ID vou specified Ore vou sure You want to continue Cancel 6 Click OK to launch the Generate New Key Pair dialog box Fill up the following fields Ea Generate New Key Pair x Old Passphrase Mew Passphras
51. xport XML messages to CSV or XML files To automate any of the 4 basic tasks users must specify schedule entries in the Scheduler Manager During the automated run of the specified tasks logs will be prompted on the log viewer See Section on How to use logs Users can do other operations like viewing a message in HTML or XML while the Scheduler Service is running To set the Scheduler settings go to Settings gt Schedule Manager to launch the Schedule Manager window 40 Exa iConneck ebXML Client System File Edit View Action Settings Help Security amp Identity Connections Document Schema Mapper b Document Display Schedule Manager Below is a brief description of the controls you will see in the Schedule Manager EA Schedule Manager Po o x ts Import File to XML Message aie Export XML Message to File REA Send XML Message to Server i Receive XML Message from gt 4 Cc a fe Save Settings 1 Scheduler Service Start stop Run Scheduler Service on iConneci startup Close Description G Task List list of tasks that can be scheduled b schedule Control Vlewshows the controls for specifying the schedule for a particular task c save Settings buttonciick this button to save the scheduler settings for all tasks Scheduler Service Control buttons start or stop the Scheduler Service by using these control buttons Run Scheduler Service checkboxbeck th
52. ystem File Edit View Action Settings Help Message k s ME npor Hontacts J E INBOX OUTBOX t SENT ACKNOWLEDGMENT tH DRAFT t TRASH 2 Views of Log Viewer Go to View menu option There are two views in Log Viewer Log Files View Options view Log Files view Realtime Logging O2 08 HSQdLConnectioi O 2l 19 02 09 HaQlCornectio 07 21 19 02 09 HaQLConnectiol 7 21 19 02 09 HSQLConnectiay a View Log Files gives access to all log files created by iConnect Client System This is the default view when launching Log Viewer without the iConnect Client System Take note that Log File Viewer only open log files with a valid filename so refrain from renaming these files to avoid inconveniences Log Files View Options 2003 Jul 07 21 Log Files sientLog 0721 part 01 07 21 07 21 07 21 07 21 HSQLCormmectionHandler HonLCormectionHandler HS0LConnectionHandler HSQLCommectionHandler HadLConnectionHandler HS0LConnectionHandler HS0LConnectionHandler HSQLCommectionHandler HonLCormectionHandler HS0LConnectionHandler HSadLConnectionHandler HadLConnectionHandler Reading Ciconnechlags 2003 Julyclentlog 0721 part 01 Jog INFO DEBOG DEBOG DEBUG DEBOG DEBUG DEBROG DEBUG DEBUG DEBOG DEBUG INFO The top left panel shows a list of folders located in the logs folder the selected folder will be listed at the
53. ze editor bat heap size editor sh EI E T J Dg iconnect run sh log viemer bat a log viewer sh Type MS DOS Batch File Size 64 bytes ad bytes My Computer A 2 Below is the Heap size editor window For example if the RAM installed is 128MB specify 128 for the initial heap size and maximum heap size Initial heap size MB Maximum heap size MB Save Cancel 3 Click Save and run iConnect III TIPS ON PREVENTING SENDING OF DUPLICATE MESSAGES Note e These tips assumes that the CSV file being used contains unique document records wherein after importing the CSV file it will not generate messages that contain duplicate payload contents or Document ID numbers e Importing a CSV file more than once will DEFINITELY create duplicate message documents in the OUTBOX folder III A Manual Operation of iConnect Import and Send Operations 1 Do a segregation scheme on CSV files that have been successfully imported This will make it easy for users to identify which file has been imported Here are some suggested schemes a Rename CSV files to make it easier to identify imported files Example P0123 csv before import PO123 csv imported after import b Move CSV files that have been imported to other folder location to segregate it from files that are not yet imported c Maintain an Import log operation file to keep track on CSV files that are imported and the number of messages generat
Download Pdf Manuals
Related Search