iConnect ebXML Client System v1
Contents
1. In the mapping configuration window choose the document type for specifying the column numbers for each element attribute of the XML message a For Import mapping 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 entries are not allowed except for the Receiver s Party ID which is the GLN location of the receiver of your XML message document Y Import CS to XML message Mapping Configuration Document Type glee n EU ui At which column is the Recerver s Party ID s order c reference 2 Status 3 creationDate ls documentiD h type ng buyer gin fe seller gin b deliveryLocation gin ho Description 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 Elements Attributes Column value specify here the column number of the specific elements attributes of the XML message in the CSV file b For Export mapping configurations specify the column number where the XML element attribute from2. JE send AL Message wo Server 5 Receive XML Message from S 2 03 Ald From 09 30 AM 7 uk To E 00 Phy i Delete 5 terval ta poa 8 seb Day Everyday Weekdays v Sperify tan Ties Tverd I Thurs Fri Sot Sun 3 Every 21 weeks 3 Stari on 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 pU to specify the range Ta change the value click on the value hour uie or time of day indicator and then click the tiny spinner buttons press the up down keyboard buttons or type the value Change du Interval value Ta change the value click on the tiny spinner buttons press the up down keyboard buttons o type the value cet 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 Frequency value by clicking on the tiny spinner buttons pressing the up down keyboard buttons or typing the value 8 oet the start date The default value for the Start Date spinner is the current date value of the operating system For this casa select the date poeter you want ta change and then press the tiny arrow b
3. 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 Wo ee ir ee mr eal daa lime eka rores und oleae dne hee tie a 4 47 Every ol weekts 5 Start on Jan 22 2003 Wed 23 Here s an example on how to set schedules using the Basic Schedule Controls Example 1 Task for Scheduling 7 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 o IY Schecule this Task for autamated run Irspart File to XML hdozaacc 3 Export XML Wessaqe to Fle ne d G r9 Send XML Message to Server SES e pes DE Euer 4 Receve XML Message from 05 59 Phl E 4 From 03 00 AM Add 5 To 06 00PM Delete Inte val Hou set Day 7 v 9 Weekdays T Spcoify Than Tus vusd There Fri Sul Suri Every TH weekts 3 stert on Jan 22 2003 Wed Steps a 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 Per Item option box to specify time entry values per item 4 Change the value in the Time Spinner to specify the time value ta be added To change the value click on the value AMT E or time of day indicator and
4. 07 01 Simple 8246951753 EN SET BUYER GLN HERE SET SELLER GLN HERE 4808888023421 contractNumber original 2002 07 01 Simple 8246951753 EN SET BUYER GLN HERE SET SELLER GLN HERE 4808888023421 NO CS 0UWS WO Cw Cow Two o Ww Ww WS ow 00 V M oM M M BH M 0 C C I9 I9 I9 IN I9 NN N N 9 B PPP H H Hd H 2 GotoFile Import or simply click IMPORT button to launch the Import CSV file to XML message window This will create PO XML messages in OUTBOX folder vx Import C5 file to XML message E x Document Type PURCHASE ORDER CS File Browse OR Cancel 3 Browse for the CSV file then click OK You should see this message window 13 xi Lx 5 message s Created 4 Check your OUTBOX folder There should be 5 messages in it 5 Click SEND button to send PO XML messages from OUTBOX folder to iConnect ebXML server All messages successfully sent will be archived in the SENT folder Receiving Acknowledgement from iConnect ebXML Server 1 Go to File gt Export or simply click receive button to retrieve Acknowledgement messages from server 2 All Acknowledgement messages will be placed in the ACKNOWLEDGEMENT folder 3 These messages serve as a confirmation that the PO XML messages are now routed in the recipient s inbox at the server If you are able to receive the acknowledgement messages properly your private key and public k
5. Mapping Configurations I Document Display Configuration URL of iconnect Server Below is a brief description of the controls you will see in the Schedule Manager 19 schedule Manager Scedile Tasks Service Log ea Be Import Fileto XML Message oi Exaort AML Message to Hle Rd Sond EML Message to Servo 4 Receive XML Message from Server O Save Setings Scheduler service Stert Slop Description 2 Schedule Task Service Log tabsclick on these tabs to view task schedule options or scheduler service logs 5 Task List list of tasks that can be scheduled c Schedule Control View shows the controls for specifying the schedule for a particular task o Save Settings button click this button to save the scheduler settings for all tasks 2 Scheduler Service Control huttonsstart or stop the Scheduler Service by using these contro buttons Q 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 20 Set Time Per tem b By Range 12 004M 1 From 09 C0 Aw h c Add e f 06 C0 PM 5 Delete Cr Inter a 1 Hour C Q Sel Day Everyday C Weekdays C Specify F ron Tues Wed Thurs Fri sa sun C Every 1 m eekiz m Start on Jan 22 Z003 vvei Description a Schedule Task ch
6. and Identity pe Schedule Manager Import Schema Path Configuration Mapping Configurations som Hl Outbox El Tent Document Display Configuration LRL of iconnect Server 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 p Document Display Configuration C Program Files Wnternet Explorer EXPLORE EAE Set Location af Browser Double click to set the path forthe Default Display Stylesheet DOCUMENT TYPE DESCRIPTION LOCATION PO PURCHASE ORDER DisplayXSLsin v2 01 dlispla PRICAT PRICE CATALOG Displays sLaJpricat_v1_O dis PRODAT PRODUCT DATA Displays SLs prodat w1 _0 dis 3 Set the Display Style sheet file for a particular document type by double clicking the table row to launch the Set File dialog window The default values are already set for installed document types VA Document Display Configuration j 7 x Set Location of Browser C Program Files internet ExplorervEXPLORE EXE Browse Double click fo zet the path for the Default Display Stylesheet PRICE CATALOG JDisplayXSLsdpricat v1 Ois PRODUCT DATA DisplayxSLeiprodat vi Dads po v2 0l display xal pricat vt Q display xsl prodat wi 0 deplay xsl Files of typ
7. settings in the Java Virtual Machine or JVM and by default the JVM is configured for a proxy server access By using the iConnectRunProxy bat batch program the JVM will be configured for proxy server access The JVM only supports HTTPS 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 SS
8. 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 E EH Export XML message to C5V Mapping Continuen PURCHASE ORDER c documentlD parameter should be set always to 1 d Click the Save button to save the settings 16 II C 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 clicking at the Contact List window pane Choose New Contact to launch the edit window or 1 T d gr rhi WE fice My Suppliers New C m a ct Y Delete Contacts Folder Inbox has 0 message s b Goto File New Contact at the menu option File Edit Message Options Abo Folder Falder b Contact E Import d amp Export Exit 17 2 Fill up the text fields and then click the Save button when finished Note Name and Party ID are required values i r Contact Information al fields with asterisk are required Marne Wy Suppliers Party ID https panc orgphiparty i234567890788 0000 Type EE CS Address Line 1 Eee Address Line 2 E Cibv Towwrn NENNEN
9. to view the Security amp Identity settings vx Security amp Identity Configurations E X security amp Identity Server Certificates Global Location Number CLINT f 234567090999 Local Party ID rtt dAvww pane org phiparty 234567890999 Edit Prefix Company Mame Fest Location of Private Key secret key Browse Location of Public Key Certificate Browse Passphraze Change Passphrase i Require passphrase at login View Certificate Details Save Cancel Global Location Number GLN a 13 digit number used to uniquely identify a location a 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 party GLNnumber a By default the prefix of the Local Party ID is http Awww panc org ph party Click the Edit Prefix button if you want to replace the prefix specified Company Name Specify the company name Location of Private Key secret key contains the secret key file that will be used to identify the client user to the iConnect server Location of Public Key certificate contains the certificate file which is issued after authenticating the public key file Passphrase private key password 3 Click the Generate new Key Pair button to launch the Generate New Key Pair dialog box Fil
10. 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 An appropriate log message will also be shown at the Service Log tab in the Schedule Manager and saved on log files located in the logs folder inside the iConnect application folder Below is a sample view of the directory structure for Export Task EX C Exported Fie Edit view Favorites Tools Help i qa Back Gh search B Folders EW History AS D x um zz Address C Exported Folders Desktop a yA My Documents FRICAT PRODAT EI 12 My Computer E E 316 Floppy A ET ES WINDOWS C 4 c _ Documents and Settings Or Sa Fo v Impait 3 L1 iConnect 3 1 Program Files BRI WINNT E 29 Compact Disc Di DRE Control Panel 29 Starting Stopping the Scheduler Service After saving all the settings for each tasks click on the Start button to activate the Scheduler Service os Schedule Manager Schedule Tasks Service Log Tasks Ree port File to XML Message H Export XML Message to File H Send XML Message to Se
11. ERE SET SELLER GLN HERE 4808888023421 contractNumber original 2002 07 01 Simple 8246951753 EN SET BUYER GLN HERE SET SELLER GLN HERE 4808888023421 contractNumber original 2002 07 01 Simple 8246951753 EN SET BUYER GLN HERE SET SELLER GLN HERE 4808888023421 contractNumber original 2002 07 01 Simple 8246951753 EN SET BUYER GLN HERE SET SELLER GLN HERE 4808888023421 contractNumber original 2002 07 01 Simple 8246951753 EN SET BUYER GLN HERE SET SELLER GLN HERE 4808888023421 contractNumber original 2002 07 01 Simple 8246951753 EN SET BUYER GLN HERE SET SELLER GLN HERE 4808888023421 contractNumber original 2002 07 01 Simple 8246951753 EN SET BUYER GLN HERE SET SELLER GLN HERE 4808888023421 contractNumber original 2002 07 01 Simple 8246951753 EN SET BUYER GLN HERE SET SELLER GLN HERE 4808888023421 contractNumber original 2002 07 01 Simple 8246951753 EN SET BUYER GLN HERE SET SELLER GLN HERE 4808888023421 contractNumber original 2002 07 01 Simple 8246951753 EN SET BUYER GLN HERE SET SELLER GLN HERE 4808888023421 contractNumber original 2002 07 01 Simple 8246951753 EN SET BUYER GLN HERE SET SELLER GLN HERE 4808888023421 contractNumber original 2002 07 01 Simple 8246951753 EN SET BUYER GLN HERE SET SELLER GLN HERE 4808888023421 contractNumber original 2002 07 01 Simple 8246951753 EN SET BUYER GLN HERE SET SELLER GLN HERE 4808888023421 contractNumber original 2002
12. L 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 text 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 32 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 Il F Sorting Messages iConnect v1 3 2 offers a new feature wherein you 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 Il G Java Heap Size Settings The Java heap size can be 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 error To set the Java
13. Province Po Country Ee Tel e Fax SS i Email Address llc ct url Contact Person eee Location of Display Stylesheets Document Type File Location PRODUCT DATA PRICE CATALOG PURCHASE ORDER Save Cancel At the bottom of the Contact editing window you will see a grid table where you can specify display style sheet for a particular 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 Click the Save button to save all settings 18 ll E 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 Export 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 screen and saved also to a file 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 Options Schedule Manager to launch the Schedule Manager window vx iConneck ebXML Client System File Edit Message Options About Import Security and IdentiE Schedule Manager Schema Path Configuration
14. RICE CATALOG schemaszi pricat v1 xsd IPRODAT PRODUCT DATA chemas pradat_ v1 O xsd Save Cancel 3 To create new document type click on the Import New Schema button to launch the dialog window for importing the new schema file EI Import New Schema E EE xj 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 PRICAT Description description for the message document ex PURCHASE ORDER PRICE CATALOG 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 12 Il USING ICONNECT ebXML CLIENT SYSTEM I A Sending and Receiving Messages To test the iConnect ebXML Client System use the sample PO purchase order CSV files provided during installation found in iConnect TestCsv 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 BUYER GLN HERE with the buyer sender GLN and SET SELLER GLN HERE with the seller receiver GLN sample po v2 01 csv WordPad File Edit View Insert Format Help Ciega SIC al S contractNumber original 2002 07 01 Simple 8246951753 EN po 4E 609 5 ee een eee weet OO Oooo02 3421 contr
15. actNumber original 2002 07 01 Simple 8246951753 EN SET BUYER GLN HERE SET SELLER GLN HERE 4808888023421 contractNumber original 2002 07 01 Simple 8246951753 EN SET BUYER GLN HERE SET SELLER GLN HERE 4808888023421 contractNumber original 2002 07 01 Simple 8246951753 EN SET BUYER GLN HERE SET SELLER GLN HERE 4808888023421 contractNumber original 2002 07 01 Simple 8246951753 EN SET BUYER GLN HERE SET SELLER GLN HERE 4808888023421 contractNumber original 2002 07 01 Simple 8246951753 EN SET BUYER GLN HERE SET SELLER GLN HERE 4808888023421 contractNumber original 2002 07 01 Simple 8246951753 EN SET BUYER GLN HERE SET SELLER GLN HERE 4808888023421 contractNumber original 2002 07 01 Simple 8246951753 EN SET BUYER GLN HERE SET SELLER GLN HERE 4808888023421 contractNumber original 2002 07 01 Simple 8246951753 EN SET BUYER GLN HERE SET SELLER GLN HERE 4808888023421 contractNumber original 2002 07 01 Simple 8246951753 EN SET BUYER GLN HERE SET SELLER GLN HERE 4808888023421 contractNumber original 2002 07 01 Simple 8246951753 EN SET BUYER GLN HERE SET SELLER GLN HERE 4808888023421 contractNumber original 2002 07 01 Simple 8246951753 EN SET BUYER GLN HERE SET SELLER GLN HERE 4808888023421 contractNumber original 2002 07 01 Simple 8246951753 EN SET BUYER GLN HERE SET SELLER GLN HERE 4808888023421 contractNumber original 2002 07 01 Simple 8246951753 EN SET BUYER GLN H
16. e uris v Cancel 4 Click SAVE button 10 I E Setting the iConnect Server URL 1 Go to Options gt URL of iConnect Server to specify the URL location of iConnect ebXML server Xs Connect ebXML Client System File Edit Message Options About Security and Identity Schedule Manager Schema Path Configuration Folders scm Outbox E Tent Mapping Configurations b isplay Configuration The default value is https www iconnect com ph Change URL X Enter the URL of Ehe iCannectE server Cancel I F Schema File Configurations 1 Go to Options gt Schema Path Configuration to launch the window for viewing importing the schema files that will be used to define the document type messages in the iConnect system Xs Connect ebXML Client System File Edit Message Options About Security and Identity Schedule Manager Schema Path Configuration _ Folders Mapping Configurations Ea Inbox Document Display Configuration oo piney URL of iconnect cem E 53 cent 11 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 f Schema Path Configuration i x Click button to generate new Document Type aas click ta delete Document Type EHE MEME TYPE DESCRIPTION LOCATION PO JURCHASE ORDER schemazipa v2 xzd PRICAT P
17. eckbox 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 T value can be changed by clicking the tiny arrow buttons in the spinner pressing the keyboard up down arrow keys or typing the value E add 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 if you want to specify time values in a certain range Ch From Time Spinner set the start time here similar ta Time Spinner on setting values Ta Time Spinner set the end time here similar ta Time Spinner on setting values Ci Time Interval choose the interval of time values within specified range time intervals can be in per hour or per minute unit k Set 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 The following diagrams descr
18. eys are properly set and your connection to the iConnect ebXML server is working Receiving PO XML Message 1 Click RECEIVE button to retrieve PO XML messages from the server All PO XML messages will be placed in the INBOX folder 2 Export the PO XML messages as either CSV or XML file by selecting a file and clicking the EXPORT button 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 TestCsv directory in the iConnect folder Reference for the mapping configurations for this CSV file is also located in the TestCsv directory To set iConnect on how to import CSV files to XML message and export XML message to the preferred CSV format specify the appropriate mapping columns for each document type 1 Goto Options Mapping Configurations There are 2 options for this item a Import CSV to XML message for setting the Import mapping configurations b Export XML message to CSV for setting the Export mapping configurations 14 2 Xs Connect ebsML Client System File Edit Message Options About Security and Identity Schedule Manager Schema Path Configuration Falders Mapping Configurations Eas Inbox Document Display Configuration Export XML message ka CSV Outbox me URL of Connect Server Sent rm ea
19. heap size edit the iConnectRun bat using any text editor application In the batch file you will see the following command java cp other parameters For example if the RAM installed is 128MB insert the following after the word java Xmsl128m Xmx128m The batch file should contain the following after editing java Xms128m Xmx128m cp other parameters where 128 is the allocated heap size in megabytes Save the batch file and run iConnect iConnect User Manual Revision 1 5 2003 Supply Chain Networks Inc 33
20. his 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 app will not be able to access the iConnect server Send an email to scni asia com 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 Semi Conductor Firm Name of Organization Company City otate Province Two Letter Country Code O Organization L Locality ST State C Country Heres an example Public Key application info assuming that the Local Party ID is http www panc org ph party 123456 7890999 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 Admi
21. iConnect ebXML Client System Jae Powered DE m ser Manua TABLE OF CONTENTS I INSTALLATION SETUP GUIDE I A System Requirements B Installing and Running the iConnect Client System I C Setting Up Your Company s Identity Generating Key Pairs I D 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 G Il USING ICONNECT ebXML CLIENT SYSTEM II A Sending and Receiving Messages II B Mapping Configurations II C Adding New Contacts and Specifying Contact Display Style Sheets Il D Schedule Manager I E Settings for Proxy Server Access I F Sorting Messages Il G Java Heap Size Settings I INSTALLATION SETUP GUIDE ILA System Requirements 1 Pentium II 450Mhz or higher or equivalent CPU At least 128 MB RAM 2 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 VVVVV V 3 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 1 Install the Java Runtime Environment using the JRE installer included in the zip file or downloaded from http java sun com dow
22. ibe the Specific Controls for Import Export and Send Receive These controls can be found below the Basic Schedule Controls in the Schedule Control View 21 IMPORT EXPORT Tasks 2 Location af Files exported Chang t c ile Type fe cv C XML Description Location of Files shows the current path location of the files to be Imported and target locations for exported messages ange auton this will launch a File Location Chooser dialog box wherein sh can specify the path location you can also create the folder with the File Location Chooser dialog T File Type op tion choose the type to be used for Import Export for Import nay Cov file type is available SEND RECEIVE Tasks O Try to execute ths tesk by Stemat e Delay bet veer attempts in Second Description 2 Humber of Attempts specify the number of attempts ta execute this tasks in case there was a connection problem Delay Between Attempts set the delay to execute tasks between attempts 22 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
23. l up the following fields TA Generate New Key Pair E X Confirm Pazsphrase Private Key Filename Public Key Filename Save Cancel Enter Passphrase Password for the Public and Private Key and for login access in the iConnect client application Private Key Filename 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 at the PrivateKeys folder inside the iConnect application folder Public Key Filename 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 at the PublicKeys folder inside the iConnect application folder Use file naming scheme to distinguish different key pair versions Ex Public key company01 pk company02 pk Secret key company01 sk company02 sk 4 Click the Save button to generate the key pairs This will take some minutes to finish depending on the speed of your computer 5 After the key pairs are generated click the Save button at the Security amp Identity Configurations window to set your identity This action might require you to restart the iConnect application 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 t
24. nistrator All you have to do is simply indicate the location of your private key and public key certificate set its valid passphrase and then click the SAVE button Ms Security amp Identity Configurations E x Security amp Identity Server Certificates Global Location Number COLIN f 254567890999 Local Party ID rites Awww panc org phiparty 234567890999 Edit Pretix Company Mame test Location of Private Key secret key c iConnectitest_cer test sk Browse Location af Public Key Certificate c iConnectttest cer test cer Browse Passphrase Ie Require passphrase at login lenerate new Key Pair View Certificate Details Save Cancel 6 When you restart the application again you will be prompted to enter the Passphrase for your Private Key file Enter the valid passphrase to login A iConnect ebXML Client System LOGIN E x Company Mame test Party ID Fttpy hore panc org phiparty 254567390999 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 Go to Options Document Display Configuration to launch the Document Display Configuration window vx iConnect ebxML Client System File Edit Message Options About fl Security
25. nloads 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 jJava version Java version ifl Ol Java TM 2 Runtime Environment Standard Edition build 1 4 1 Java Hotopot rM Client VM bua ld 1 4 1 01 DOT 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 EX C iConnect File Edit View Favorites Tools Help 7 sa Back iJ Gi search Folders c SHistory Las E x mm EE Ez Folders Ge Desktop E 3g My Documents E My Computer E E 3 Floppy El gg WINDOWS C o E s Cg Documents and Settings 43 Connect H Program Files fe WINNT E i Compact Disc D H Control Panel liconneckRunPraxy bat jan iConnectRunProxy sh 3 Run the iConnect Client App a Windows Explorer Go to the iConnect folder and double click iConnectRun bat file b Command Line Go to the iConnect folder type iConnectRun bat and then press Enter C Torun iConnect on Linux use this command inside the iConnect folder sh iConnectRun sh Note Make sure that the file s executable permission is set correctly You can issue this command to make the scri
26. op button at the Schedule Manager 3l Il F Settings for Proxy Server Access iConnect can access the Internet through a proxy server for sending receiving messages Use iConnectRunProxy bat in Windows or iConnectRunProyx sh in Linux to launch iConnect configured for proxy server access To configure iConnect for proxy server access edit iConnectRunProxy bat or iConnectRunProyx sh and specify the proxy server IP address and port number for the following parameters Dhttps proxyHost SET IP ADDRESS HERE Proxy Server IP address CDhttpe proxyPort SBRr PORT VALUE HERE Proxy server Port Value Here s an example of a valid parameter setting inside the batch file java DproxySet true Dhttps proxyHost 192 168 0 111 Dhttps proxyPort 3128 Djavax net debug all other parameters 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 Notes on Proxy Server Setup iConnect 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
27. pt file executable to all users chmod 777 iConnectRun sh 4 After launching the 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 x i i This is either the First time you are running Ehe Connect system or you have modified vour Java environment The iConnect system has just made additional modifications to your Java environment For it to run properly TE will now shut down For these changes to take effect PLEASE RESTART THE iconnect APPLICATION I C Setting Up Your Company s Identity Generating Key Pairs Public and Private keys generated by your iConnect Client app 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 Options gt Security amp Identity at the menu options to launch the Security amp Identity Configurations window vx iConnect ebxML Client System Fil Edit Message Options About Security and Identity Schedule Manager Schema Path Configuration Folders Mapping Configurations b ard Inbox Document Display Configuration Hh Outbox URL of icanneck Server 2 Below is the Security amp Identity Configurations Click the Security and Identity tab
28. rver Receive XML Message from S Set Time Per tem C By Range 12 00 AM From 03 00 AM Ta 0 00 Ph Interval Set Day Everyday C eekdays Specily Mon Tues Wed F Thurs Fri Sat Sun o MEF S Sion Jan 22 2003 wea 2 Location ofFles O Change 4 gt File Type cosy C XH z Selli Scheduler Servige Start Step Close 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 Scheduler Semice is OM 30 Click on the Service Log tab to view the log Messages shown SE Schedule Manager E X Schedule Tasks Service Log re 22 02 37 SchedulerEngine INFO Wext schedule for SEND task Mar 16 2003 9 30 00 AM Scheduler Service Close There are two types of log messages 1 INFO and 2 ERROR Here are some of the common logs that can be shown by INFO and ERROR log messages INFO LOGS Next Schedule Start Date Time value of an executed task Location of successfully imported files Files that were exported Send and Receive duration Number of messages sent received VVVVV V ERROR LOGS gt Send Receive errors gt Import Export errors The log messages also have daily archive files located at the logs folder located inside the iConnect folder To stop the Scheduler Service click the St
29. 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 6 aut of time values added To remove an item from the Time Entry list box select the item and then click the Delete uttan 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 8 cet the start date The default value for the Start Date spinner is the current date value af the operating system For this case we will use the default value 24 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 DATE TIME JAN 22 2003 WED 0 09 PM 9 00 AM JAN 23 2003 THURS 12 15PM 9 59 PM 9 00 AM JAN 27 2003 MON 12 15 PM 9 59 PM 9 00 AM JAN 28 2003 TUES 12 15 PM 0 59 PM 9 00 AM JAN 24 2003 FRI 12 15 PM 5 59 PM 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 this Task Tor autorated run eu Import Fie to XML Message Expert XYL Message to File ME er tere 3
30. uttons press the up down keyboard buttons or type the value 26 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 w TIME V j 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 27 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 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 BS C For Import File Edit ve
31. w Favorites Tocls Help de Eack RJ Aesch fe Folders CbHisory iy GY oa address J Gor Import H Deskto EEA My Documents a My Compu er EH ei 3 Floppy a ET WINDOWS C 3 E C m Docurents ard Settings E C3 Exoorted cu For Import f 7 Connect ES Program Files re C7 wINMT i EH 24 Conpeck Dise 1D Fam Contrel Panel PAICAT PROD T objects Disk Free space 862 MB D bytes My Computer Description 2 Directory Bin folder location Errors Folder all CSW files that were not imported due to errors will be moved hera Imported Folder all CS files that were successfully imported will be moved ere 4 PO Folder place all PO CSW files for import here PRICAT Folder place all PRICAT CSW files for import here f PRODAT Folder place all PRODAT CS files for import here 28 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 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 imported in the Schema Path Configuration and the Import task is set for scheduling a RETURN document
Download Pdf Manuals
Related Search