ALP ALP Directory
alp.directory configuration file contains settings about the current directory and its subdirectories. Global (default) alp.directory file is found in the directory containing iewebsrv.dll. ALP engine seeks alp.directory file in the current directory (pointed by the URL) and up to the root of the current site. First found alp.directory file is the only file that takes place when calculating directory settings. It is mixed with the global alp.directory file and the resulting configuration is used by the engine.

ALP Settings shell extensions allow you create and edit these settings more conveniently.

Here is one sample alp.directory file containing all the possible values. Sample used here is used as a default configuration in the ALP distribution.

; ALP Directory configuration
{ DIRECTORY:
    { Access:
    	; Default configuration grants everything
        (int)Scripts=1
        (int)Read=1
        (int)Execute=1
        (int)Browsing=1
	; Cache record entry is available only in the registered version
	; It allows ALP to create cache files for the content of the directory
	;  and its subtree.
	(int)Cache=1
         (int)OfflineExecution=1
         (string)SecurityURL=http://www.mysite.com
         (int)SafeEntrtance=0
         (int)ContentIsSecure=0
         (int)ContentIsSafe=0
    } Access;
    { UseExtensions:
	; Force usage of these extensions for the cache files
        (string)text/rtf=rtf
    } UseExtensions;
    { Documents:
        (string)default=Default.asp
        (string)default=Default.htm
    } Documents;
    { CustomErrors:
        (string)FileNotFound=/errs/err.asp
    } CustomErrors;
} DIRECTORY;

In the current version (1.0) of the ALP there is only one global section in the alp.directory file - DIRECTORY. It contains two possible subsections:

  • Access - Describes allowed actions in the directory
    • Record (int)Scripts - Can be 0 or 1. This value corresponds with the (int)IsScriptEngine value in the subsections sections of the ExecutionMap section of the alp.application file. Value of 1 allows executing modules registered as script engines value of 0 denies it.
    • Record (int)Read - Can be 0 or 1. Corresponds to the File subsection of the InternalExecutionMap section of the alp.application file that defines the component used to process unknown files. Read value denies (0) or allows (1) processing of the unknown files in a particular directory or subtree. Typically it was set if the directory contains for example scripts includes that must not be shown to the user.
    • Record (int)Execute - Can be 0 or 1. It denies (0) or allows (1) execution of the modules handling certain file extensions and are not registered as script engines - see (int)IsScriptEngine value in the alp.application.
    • Record (int)Browsing - Can be 0 or 1. If no default documents are found in a particular directory (see section below) component registered for the section Directory in the InternalExecutionMap of the alp.application file. Its purpose is to show the directory listing. Browsing value denies (0) or allows (1) that.
    • Record (int)Cache - Allows creation of the cache files into the Internet Explorer's cache. This option is available only in the registered versions. It is important to enable caching if you want to use content types passed to external applications - such as generating RTF files.
    • (int)OfflineExecution - 0 - the expired pages are not executed, for example if you press back to return to a page that processes a submitted form. 1 - all the requests are executed.
    • (int)SafeEntrtance - An URL in this directory will succeed only if the previously the user has accessed one of the default documents in the directory.
    • (int)ContentIsSecure= -  if set to 1 declares the content as if it comes over an SSL. 
    • (string)SecurityURL -  If exists and non-empty specifies an impersonalization URL. The content will be treated by the browser as if it comes from that URL.
  • UseExtensions - This content type - file extension map works together with the Cache option (see above). If caching is enabled it specifies what file extensions to be used for the cache files created. By default ALP looks in the HKEY_CLASSES_ROOT\MIME\Database registry key but not all applications register their content types thus this map can be used to ensure that mapping exist. Also this map forces using of the file extension specified here - if content type was found here it will not be searched in the registry.
  • Documents - Contains settings about the documents/files that can be found in the folder.
    • Record(s) (string)default - Contain the names of the documents/resources automatically shown if the URL contains no file/resource name at the end. Multiply records can be supplied. Search order is the same as the order of the values.
  • CustomErrors - contains virtual paths to pages executed whenever certain error occurs
    • (string)FileNotFound - specifies the file/document served whenever ALP is unable to map an URL to a physical file.

 

 

 

newObjects Copyright 2001-2006 newObjects [ ]