The DIRPCE parameter is used to define a default directory to store the attachments that are not stored in the database (the path is defined in the standard UNC path format, eg \\server\dir1\subdir2). This path can contain a maximum of 250 caracters.
On each entry of an attachment, it is possible to have the file name for the attachment starting with the character % (percentage). The % character will be stored in the database, but on each search or entry, the complete network name will be constructed from the DIRPCE parameter. Similarly, if the path for the access to an attachment is entered in a complete fashion and if it starts with the path defined by DIRPCE, the % character will automatically be substituted.
This parameter is of interest because it is used to centrally manage the directories dedicated to the attachments, in general on a dedicated document server. If for one reason or another, it is necessary to move a group of these documents to another server or to another database directory, it will be necessary to change the DIRPCE parameter so that the attachments thus referenced will be found in the correct directory.
The parameter is defined at the level Folder.Belongs to Module ADX (Adonix) and to Group INT (Interface User),in which the following parameters can also be found :
No global variable is associated to it.
Imagine that the path in which the documents are located is \\office_server\technical documents\current docs. This value will be put in DIRPCE.
All documents defined in an attachment and starting with % will then be interpreted as having a path starting with the path given above. For instance, an attachment entered in the form %budgets\version 1\purchase.doc will be looked for with the following complete path:
\\office_server\accounting documents\current docs\ budgets\version 1\purchase.doc
It is possible to start the DIRPCE parameter value with %. In this case, X3 considers that the default document directory is defined with respect to the current directory for the folder (on the application server). This is of most use for the demo folder, in which example attachments are located, stored in a sub-directory called REPDOC. In this case, the value given in DIRPCE is %REPDOC, and the % is replaced with the correct path. Thus, irrespective of the directory where the demo set is installed, the attachments can be found (especially on a portable computer.)