[en] Caching Files

[en] To improve the time-to-first label and performance in general, NiceLabel Automation supports file caching. When loading the labels, images and database data from network shares, you might experience delays while printing the labels. NiceLabel Automation must fetch all required files before the printing process can begin.

[en] There are two levels of caching that complement each other.

[en] Memory cache: Memory cache stores the already used files. The labels that have been used at least once are loaded in the memory cache. When a trigger requests a printout of the same label, the label is immediately available for printing process. Memory cache is enabled by default. Its contents are cleared after you remove or reload a configuration. The label file is checked for changes for each Open Label action. If there is a newer label available, it loads automatically, replacing the old version in the cache.

注意

[en] After a label is not in use for 8 hours, it is offloaded from the memory cache.
[en] Persistent cache: Persistent cache stores data to disk – its role is to provide medium term storage for files. Caching is managed per file object. After a file is being requested from the network share, the service first verifies if the file is already present in cache, and uses it. If a file is not in the cache, it is fetched from network share and cached for future use. The cache service continuously updates cache contents with new versions of files. You can configure the time intervals for version checking in Options menu.

[en] Prolonging the Time Period for Label Offloading

[en] After a label is used for the first time, it is loaded in the memory cache. The label becomes available for instant printing the next time it is required. Memory cache housekeeping process removes all labels that haven't been in use for 8 hours or more.

[en] To prolong the time interval in which labels are offloaded from memory cache, do the following:

[en] Navigate to the NiceLabel Automation System folder.

%PROGRAMDATA%\NiceLabel\NiceLabel 10
[en] Make a backup copy of the file product.config.
[en] Open product.config in a text editor. The file has XML structure.
[en] Add the element Common/FileUpdater/PurgeAge.
[en] This parameter defines the number of seconds that define the time frame for keeping labels in memory cache. NiceLabel Automation keeps track of the time when each label was used for printing for the last time. When that time frame reaches the defined threshold, the labels are unloaded from memory.

注意

[en] Default value: 28800 (8 hours). Maximum value is 2147483647.

[en] The product.config file should have the following contents:
```
<?xml version="1.0" encoding="utf-8"?>
<configuration>
    <Common>
        <FileUpdater>
            <PurgeAge>28800</PurgeAge>
        </FileUpdater>
    </Common>
...
</configuration>
```
[en] After you save the file, NiceLabel Automation Service automatically applies the setting.

[en] Enabling Persistent Cache

[en] To enable and configure persistent cache, open the Option, select NiceLabel Automation and enable Cache remote files.

[en] Refresh cache files: Defines the time interval in minutes in which the files in the cache will be synchronized with the files in the original folder. This is the time interval that you allow the system to use the old version of the file.
[en] Remove cache files when older than: Defines the time interval in days for removing all files in cache that haven't been accessed for the specified time duration.

[en] NiceLabel Automation uses the following local folder to cache remote files:

%PROGRAMDATA%\NiceLabel\NiceLabel 10\FileCache

注意

[en] File caching supports label and picture file formats. After you enable file caching, restart Automation service to make the changes take effect.