efdManagementConfiguration.workfolder

The Work folder is used by Enterprise workflow service and web application as a file exchange location. It is used in the following ways:

•EmailRetrieveAgent
Email retrieval agent strips attachments from email messages and saves them to the sub-folder .\EML\.

•FileMonitorAgent
Scans each of the defined channel folders and loads the EDD into the EQuIS database for subsequent processing if the EDD file name matches the file naming convention.

•FtpRetrieveAgent
FTP retrieval agent polls a remote FTP folder and moves all files more than one minute old into the sub-folder .\FTP\

•Download.aspx and the \report\ web service cache user report output in the sub-folder \USER\######\, where ###### is the ST_USER.USER_ID value of the user running the report.

In the equisworkflow folder (by default located on a local machine at C:\Windows\Temp\equisworkflow), there should be at least four sub-folders:

•Archive

•EML

•FTP

•WEB

EQuIS Version: 7

Namespace: EarthSoft.Workflow

Products Affected: Enterprise

Required Modules: Enterprise Workflow Service

ST_CONFIG	VALUE	REMARK
CONFIG_SECTION	efdManagementConfiguration	Required
CONFIG_KEY	workfolder	Required
OBJECT_TYPE		Null
OBJECT_VALUE		Null
STRING_VALUE	<path to work folder>	Path to

Remarks:

In an environment where multiple EQuIS databases are being hosted on the same application server, each database should be set to a unique path. EarthSoft highly recommends NOT sharing the same workfolder setting for two or more instances of either the EQuIS Enterprise Web Application or EQuIS Enterprise Workflow Service.

The Windows Identity of both the EQuIS Enterprise 7 Workflow Service and EQuIS Enterprise Web Application must both have Read/Write/Execute permission in this folder and its sub-folders. This folder should not be a sub-folder of the EQuIS Enterprise Web Application. This folder should not be in any of the Windows Special Folders. The default value for this setting is C:\Windows\Temp\equisworkflow.

The storage requirements on this folder can grow quite large depending on system usage. EQuIS administrators should periodically review and purge the sub-folder .\Archive\. The number of files stored in the sub-folder .\USER\ can be as high as the number of users times the number of user reports. While old files are purged on demand, concerned systems administrators may purge any file that is older than the maximum value for ReportService CacheHours.

Example:

CONFIG_SECTION	CONFIG_KEY	OBJECT_TYPE	OBJECT_VALUE	STRING_VALUE
efdManagementConfiguration	workfolder			C:\Windows\Temp\equisworkflow

Note: There should only be one record for workfolder in ST_CONFIG. Additional workfolder records in ST_CONFIG will cause errors in accessing EQuIS Enterprise and EQuIS Professional.

If the ST_CONFIG table includes a second CONFIG_SECTION: efdManagementConfiguration and CONFIG_KEY = workfolder, the LDAP (Lightweight Directory Access Protocol) may stop and prompt for a username and password to access Enterprise. This will prevent users from logging into EQuIS Professional and may log errors indicating that the username is invalid or that more than one user exists.