Help Version: 2.12
Last Update: 08/01/2001

Understanding How To Use Order Logs:

These are the new features that have been added to the order log routines to allow for more flexibility.

Note that all of the following can be set by opening the Configuration Editor (Step 2 of the Main Menu) and going to the "Config File" tab. The steps to use the features assume that you have already done this.

There are two types of order log files that can be created. The standard log file(s) will contain formatted, easily readable information, while the delimited log file(s) will contain delimited data that is easier to import into an external database program.

Standard Log(s):

  • To use standard log file(s), you need to turn on standard order logging.

    To do this, select "ORDER_PARAMETERS" from the drop-down list, then click on "send_order_to_log" and set it to "yes".

  • You can append all of the orders into one log file.

    To do this, select "ORDER_PARAMETERS" from the drop-down list, then click on "append_to_single_log_file" and set it to "yes".

  • You can select the name of the file for the logs to be appended to, if you are appending to one log file.

    To do this, select "ORDER_PARAMETERS" from the drop-down list, then click on "order_log_file_name" and set it to a file with a ".log" extension. (Example: orders.log)

  • There is also room in the order_logs.pl for future use and custom programming.
Delimited Log(s):

  • To use delimited log file(s), you need to turn on delimited order logging.

    To do this, select "DELIMITED EMAIL" from the drop-down list, then click on "write_delimited_log_file" and set it to "yes".

  • You can append all of the orders into one log file.

    To do this, select "DELIMITED EMAIL" from the drop-down list, then click on "append_delimited_log_file" and set it to "yes".

  • You can select the name of the file for the logs to be appended to, if you are appending to one log file.

    To do this, select "DELIMITED EMAIL" from the drop-down list, then click on "delimited_log_file_name" and set it to a file with a ".log" extension. (Example: comma_delim.log)

  • You can select the delimiter that you would like for the email.

    To do this, select "DELIMITED EMAIL" from the drop-down list, then click on "field_delimiter" and set it to either "comma" or "tab".

  • You can have the email output quotes around each field.

    To do this, select "DELIMITED EMAIL" from the drop-down list, then click on "use_quotes" and set it to "yes".

  • You can encrypt the delimited text.

    To do this, select "DELIMITED EMAIL" from the drop-down list, then click on "encrypt_delimited_text" and set it to "yes".

  • You can write the headers (field names) to the top of the file.

    To do this, select "DELIMITED EMAIL" from the drop-down list, then click on "write_delimited_headers" and set it to "yes".
Notes:

It would not be a good idea to use orders.log, orders.txt, etc. for a real order log filename because, if somebody were trying to guess what your log file name was, these would probably be the first names that they would try.

Also, if you are using both types of order file logging ("send_order_to_log" and "write_delimited_log_file" are both set to "yes") and both are set to append mode ("append_to_single_log_file" and "append_delimited_log_file" are both set to "yes"), then it would usually be a good idea to make sure that the "order_log_file_name" and "delimited_log_file_name" are different files; this way one file is easy to read and the other file is easy to import. If they are both set to use the same file name, the program will append a standard order log, then a delimited order log to the same file.


Copyright 1997-2003 i-Soft, LLC