User Manual

bulletChapter 4 - Catalog files

Each catalog file is an ASCII (text) file that contains information about group of items that have something in common. A specific menu entry will point to each catalog. Each line in the catalog represents one item.

Line Format:

ItemNo|Description|Price|ItemDesc|Pic_Lg.gif[ or HTML Page Name],Pic_Sml.gif|Audio|PurchaseForm|
ShipHandleInfo|Password

ItemNo - is an item number or SKU number
Description - is a short item description
Price[;from-to] - is an item price (1.00, 58.95, etc) or price and item range (see multi-price section below)
ItemDesc - this field can contain: 1) name of the ASCII text file in Txt directory. This file can be up to 32K long. It usually contains detailed information about this item. 2) the description itself in one long line. The JSC will break this line into several small lines based on "ItemTextLineSize" in the JSC.ini file.
Pic1.gif[,Pic2.gif] 

or 

HTML option
ItemHTMLPages=Yes
 in JSC.ini file
- is a GIF or JPG file that contain an image of this item in the Pic directory. The Pic1 represents large image that will be displayed in the Item window. The Pic2 is an optional thumbnail image. If it is omitted the Pic1 will be used in both places. 
- is a HTML page name containing item Image and Description. In most cases you need to specify Path for each page unless you put your pages in the same directory where you keep your .class , .jar, .cab files. For example if you keep pages on the same level as your ViaJCart directory you will need to use ../ in front of the page name ../MyhtmlPage.htm. 
Audio - is an audio file for this item in the Aud directory in .au format or HTML page that points to the Real Audio file format. If you use .au files exercise caution because audio files in .au format are large even if you have just a few seconds of audio. See Chapter on Audio to see how to setup RealAudio for each item.
PurchaseForm - is a name of the ASCII purchase form file in Frm directory. See Chapter 5 for information on how to create this form.
ShipHandleInfo - is the indicator with represents a type of an item. See Chapter 5 for more info.
Password - is a password that will be send to the customer if you allow immediate download after the credit card was processed. The passwords must be encrypted via Decrypt utility before uploading the catalog. See chapter about Real Time processing for more details. IMPORTANT: This field is optional and should not be used if don’t use this feature. You can leave it off completely or use ‘*’ as a placeholder.

The line contains 8 fields separated with '|'. You have use any text edit (NotePad for example) to create it as long as you save this file as plain ASCII (text) file. The fields can contain an "*" if specific field is not utilized. We recommend that you create a default image and text file instead of "*".

Multiple Prices Depending of Number of Items Ordered:

Many wholesaler merchants provide discounted prices for bulk purchases. This shopping cart provides a way of handling this requirement.

For example, a price of one hand held calculator is $20. If you buy 5 to 20 it is $15 and if you buy 20+ it is $10. To express this in the catalog you need to enter 3 different entries for the same items. In other words, you need to have a separate unique entry in the catalog for each price. The cart program will check and make sure that the customer orders correct number of items.

Example:
Calc01|Hand Held Sony Calculator Model 1000A|20;1-4|scalc.txt|calc.jpg|calc.au|*|a
Calc02|Hand Held Sony Calculator Model 1000A bulk 5 to 20|15;5-20|scalc.txt|calc.jpg|calc.au|*|a
Calc03|Hand Held Sony Calculator Model 1000A bulk 20+|10;20-9999|scalc.txt|calc.jpg|calc.au|*|a

The first record has price of $20 and range of 0 to 4. The second has price of $15 and range of 5 to 20.The last one has price of $10 with the range of 20 to 9999.

If a customer tries to buy only one calculator in the bulk entry he will receive the following message:

"Quantity is out of range for this price break. Please make another item selection."

You can change this message to your like by updating JSCStrings.ini file.


Example: Catalog file without HTML pages

A15pc|Insignia Assortment|19.58|insignia.txt|insignia_lg.gif,insignia_sm.gif|*|pform1.txt|*
JFH1|Floral Heart|9.53|jerbeau.txt|jerbeau.gif,jerbeau_t.gif|*|pform2.txt|*
CCBmn|Chocolate Champagne Bottle|40|choco_b.txt|choco_b.gif,choco_b_t.gif|*|pform_choco_b.txt|*
#106016-5|Petits-Fours Tray|90|petits-fours.txt|petits_fours.jpg,petits_fours_t.jpg|*|pform2.txt|*
#371270-3|Marrons Glaces|35|marrons_glaces.txt|marrons_glaces.jpg,marrons_glaces_t.jpg|*|pform2.txt|*
CBar|Chocolate bar|2.25|chocolate_bar.txt|chocolate_bar.jpg,chocolate_bar_t.jpg|*|pform_chocolate_bar.txt|*
CCgr|Chocolate Cigars|27|chocolate_cigars.txt|chocolate_c.jpg,chocolate_c_t.jpg|*|pform_chocolate_c.txt|*
CRose|Chocolate Roses|70|chocolate_roses.txt|chocolate_r.jpg,chocolate_r_t.jpg|*|pform_chocolate_r.txt|*

Example: Catalog file with HTML pages (pages are located in "Html" folder)

A15pc|Insignia Assortment|19.58|*|Html/insignia_lg.htm|*|pform1.txt|*
JFH1|Floral Heart|9.53|*|Html/jerbeau.htm|*|pform2.txt|*
CCBmn|Chocolate Champagne Bottle|40|*|Html/choco_b.htm|*|pform_choco_b.txt|*
#106016-5|Petits-Fours Tray|90|*|Html/petits_fours.htm|*|pform2.txt|*
#371270-3|Marrons Glaces|35|*|Html/marrons_glaces.htm|*|pform2.txt|*
CBar|Chocolate bar|2.25|*|Html/chocolate_bar.htm|*|pform_chocolate_bar.txt|*
CCgr|Chocolate Cigars|27|*|Html/chocolate_c.htm|*|pform_chocolate_c.txt|*
CRose|Chocolate Roses|70|*|Html/chocolate_r.htm|*|pform_chocolate_r.txt|*

top

nextnext

arrow Chapter 1 - Installation
arrow Chapter 2 - JSC.ini control file
arrow Chapter 3 - Menu file creation
arrow Chapter 4 - Catalog files
arrow Chapter 5 - Checking out process
arrow Chapter 6 - Order; Encryption/Decryption process
arrow Chapter 7 - ViaJcart Customization with JSCStrings.ini
arrow Chapter 8 - Audio Setup
arrow Chapter 9 - Real-Time Credit Card Processing
arrow Chapter 10 - Troubleshooting
arrow Chapter 11 - Upgrade From 1.x to 2.x

H o m e
Send Email

VSSD logo
w w w . v s s d . c o m

Copyright © 1996-2000 Vilgorin Software Systems Development.
All Rights Reserved.