Chapter 2: New URLs and Files

Links to NetStores pages

The ./dwos-bin directory contains all the programs used by NetStores. Here's a list of the links you can use directly in an HTML page. Other files in the ./dwos-b in directory are used internally by NetStores to process forms that customers submit.

In addition to the new Perl programs listed here, the UNIX shell scripts used by NetStores v1.0 are still available (on UNIX platforms only).

• Search page:

     /dwos-bin/gen-srch.pl?store-abbrev
     

  Link to the search page for a store. Use the store-abbrev as the parameter. For example, http://www.netstores.com/dwos-bin/gen-srch.pl?mal.

• Directed search results:

     /dwos-bin/drv-srch.pl?-m+store-abbrev+-f+ 
     field%3Dvalue|field%3Dvalue|...
     

  Link to produce a specific set of search results. For example, you can create links to search results for each product category. You can set values for any fields in the search form, including check boxes, the "sortby" field and the "limit" field.

  The first parameter must be "-m". The second parameter must be the store abbreviation. The third parameter must be "-f". The fourth parameter is a list of the field names and field values you want to set. Separate each field-value pair with the pipe character ("|"). Separate each field from its value with "%3D" (the Hex code for "="). Make sure you use uppercase and lowercase letters that match the values you want exactly. If your field names or values contain any special characters, use the Hex codes listed here instead of the actual character:

  space -- %20	& -- %26	: -- %3A	/ -- %2F
  # -- %23	+ -- %2B	; -- %3B	\ -- %5C
  % -- %25	= -- %3D	? -- %3F

  For example, http://www.netstores.com/dwos-bin/drv-srch.pl?-m+mal+- f+Category%3DHIP%20HOP|Label%3DATLANTIC|sortby%3DTitle.

• Retrieve orders:

     /dwos-bin/gen-srco.pl?store-abbrev+-o
     

  Generates a page that allows customers to search for orders. Use the store abbreviation as the first parameter. For example, http://www.netstores.com/dwos- bin/gen-srco.pl?mal+-o.

• Retrieve quotes:

     /dwos-bin/gen-srco.pl?store-abbrev+-q
     

  Generates a page that allows customers to search for quotes they have saved. Use the store abbreviation as the first parameter. For example, http://www.netstores.com/dwos-bin/gen-srco.pl?mal+-q.

• Show shopping basket:

     /dwos-bin/gen-m2o.pl?-mstore-abbrev+-t
     

  Shows customers the current items in their shopping basket. The current order total is shown and the customer can click buttons to begin a new search, clear the order quantities, modify the order, or complete the order. For example, http://www.netstores.com/dwos-bin/gen-m2o.pl?-mmal+-t.

• Open a new account:

     /dwos-bin/gen-acct.pl
     

  Generates a page that allows customers to open new accounts. Use the store- abbrev as the parameter in the URL. For example, http://www.netstores.com/dwos-bin/gen-acct.pl?vcp.

• Help page:

     /dwos-bin/gen-help.pl?store-abbrev+#
     

  Link to the specified help page. The first parameter should be the store- abbrev. The second parameter should be "#" where the filename of the HTML page you want to display is ./dwos/data/store-abbrev/help#.html. For example, http://www.netstores.com/dwos-bin/gen-help.pl?ent+1 displays the ./dwos/data/ent/help1.html file.

• Mallfront page:

     /dwos-bin/dwos.pl
     

  Generates a "mallfront" page with links to all the stores in the mall. No parameters are needed. For example, http://www.netstores.com/dwos-bin/dwos.pl.

• Report on product searching preferences:

     /dwos-bin/gen-rpt.pl?store-abbrev
     

  Shows a report of the search qualifiers customers are using. You can restrict the report to a date range you choose. You can only see these reports if you are accessing NetStores from the IP address specified by the NCADMIN parameter. For example, http://www.netstores.com/dwos-bin/gen-rpt.pl?mal.

• Show environment variables:

     /dwos-bin/dsply-env.pl
     

  Shows a list of variables defined for the server. This is helpful for troubleshooting your application. Accepts up to four parameters in the URL that will be displayed after the list of environment variables. For example, http://www.netstores.com/dwos-bin/dsply-env.pl?test1+two++four.

• Examine files remotely:

     /dwos-bin/dwos-cat.pl?file-location
     

  Lets you examine files in your ./dwos directory tree remotely if the ADMIP parameter matches your IP address. The parameter in the URL should be the filename you want to see relative to the ./dwos directory. For example, http://www.netstores.com/dwos-bin/dwos-cat.pl?data/ent/params.sh. (The example files are accessible through dwos-cat even if your IP address does not match ADMIP.)

• Find customer information:

     /dwos-bin/gen-cmnt.pl?store-abbrev
     

  Generates a form that allows the mall administrator to search for information about a customer. You can only run this program if your IP address matches the definition of the ADMIP parameter. For example, http://www.netstores.com/dwos-bin/gen-cmnt.pl?mal.

• Initial setup form:

     /dwos-bin/gen-mrch.pl
     

  Generates a form that performs the initial setup for a store. You can only see this form if you are accessing NetStores from the IP address specified by the NCADMIN parameter. You will need to edit the files NetStores creates when you submit this form. For example, http://www.netstores.com/dwos-bin/gen-mrch.pl.

NetStores v2.0 Update NetStores v1.0
1: What's New in v2.0? 2: New URLs and Files	3: New Parameters 4: Credit Card Processing Variables
Copyright © 1996 NetStores