Chapter 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 dont 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|*

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


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