Settings and Options
Submitted by Synthetic Dreams on Fri, 08/15/2014 - 15:06
The following attributes may be configured for each data source (and may be reconfigured at run-time):
| Option | Settings Key | Description |
|---|---|---|
| Real-Time Updates | RealTime | "True" = The Base Query Path (and subdirectories if Query Subdirectories is enabled) will be monitored for file updates, resulting in faster queries. "False" = The file system cache will only be updated at query time. A value of "False" should be used if the path being searched will experience a large number of changes while emissary RT: Files is being used (e.g. many file updates/creations/deletions/etc), and only a small amount of queries will be executed. |
| Precache Image | PrecacheImage | "True" = Upon connecting to the data source (or when updating the Base Serach Path at run-time), the Image table (contaning image-related data) will immediately be cached for all image files, resulting in slower connect time, but a faster initial query involving images. "False" = the Image table will not be cached until a query involving it is executed, resulting in faster connection time, but a slower initial query involving images. |
| Precache Audio | PrecacheAudio | "True" = Upon connecting to the data source (or when updating the Base Serach Path at run-time), the Audio table (contaning audio-related data) will immediately be cached for all audio files, resulting in slower connect time, but a faster initial query involving audio. "False" = the Audio table will not be cached until a query involving it is executed, resulting in faster connection time, but a slower initial query involving audio. |
| Base Query Path | BasePath | The directory to execute queries against. For example, after specifying "C:\temp" as a Base Query Path, running a SELECT query would return folders and files within "C:\temp" (and subfolders if Query Subdirectories is enabled), and running a DELETE query would delete folders and files within "C:\temp". This field is required, and must be a valid directory. |
| Query Subdirectories | Recurse | "True" = Subdirectories under the Base Query Path will also be included when executing a query. "False" = Only folders and files within the Base Query Path will be included when executing a query. |
| Copy Mode | Copy | "True" = When performing an UPDATE query on the "Standard" table that changes the value of "Path", "Name", "Parent", "Base", or "Extension", or on the "Image" table that changes the value of "Format", the corresponding file will be copied with the new pathname/extension, leaving the original file. "False" = When performing an UPDATE query on the "Standard" table that changes the value of "Path", "Name", "Parent", "Base", or "Extension", or on the "Image" table that changes the value of "Format", the corresponding file will be renamed with the new pathname information. |
| Interactive Mode | Interactive | "True" = When updating the cache, or executing a INSERT, UPDATE, or DELETE query, a progress meter will be shown to the user. The dialog will allow users to cancel queries. "False" = no dialog boxes will be displayed to the user. "False" must be used when making use of emissary RT: Files in custom applications that cannot interact with the desktop, such as PHP or ASP.NET web apps. |
| Read-only Access | ReadOnly | "True" = INSERT, UPDATE, and DELETE queries are disabled. "False" = INSERT, UPDATE, and DELETE queries are enabled. |
