ITrack/Enterprise/EDocuments Extension

From ISoft Wiki
Jump to navigationJump to search

E-Documents

This ITrack Enterprise module has no view associated with it, but it generates output based on ASCII reports from the database and ITrack Settings.

Currently, this module is used:

Database Structure

EDocuments require an entry in the table edocument. If such an entry does not exist, no document generation is possible. If the user ever receives an error along the lines of 'cannot generate document due to missing template' this is likely the cause, and an ISoft employee must be contacted.

  • edocumentid: unique identifier
  • type: the specific type/category for the document. All edocuments with the same type will be considered interchangeable in a particular context (example: 'Purchase Order'). All documents with the same type will receive the same data sources when being generated.
  • outputfilename: [optional] the file to which the output data will be written. If this does not exist, no output file is written. This string may contain constant text, functions, and data (see syntax below).
  • description: [optional] a simple description of the edocument and its use.
  • content: the body of the document. This is what will be parsed by the EDocument manager and output to the output file.
  • postgenerationscriptname: [optional] the name of a particular post-generation script. This represents a type of script to be run after document generation. This will also be the heading of a value in the [scripts] section of the host.ini. This allows each computer to have custom post-generation scripts (different locations/command line arguments).
  • postgenerationscriptdefault: [optional] a default value for the post generation script defined above that will be used if no entry is found for the specified script in the user's host.ini.
  • postgenerationscriptparameters: [optional] a string that will be passed on the command line to the post-generation script.

Syntax

Nearly all text in the body of an edocument is considered to be static text and will not be parsed. The only things that will be parsed and processed by the system are functions and data (see below).

Data

Functions