File Storage
Due to browser restrictions, Nomad for web browsers does not have access to the native operating system’s file system and instead uses the Origin Private File System (OPFS) to store files needed for ordinary operation. The OPFS is contained within the browser’s sandbox for the site and is not accessible from other sites nor the native operating system. Because the OPFS is in the browser storage, clearing the browser storage also clears the file system.
LotusScript functions | Special behavior |
NotesEmbeddedObject.ExtractFile
|
If the vfs: prefix is used in the file name, the file is placed in the OPFS and can be accessed using other LotusScript functions. If the file name specified does not begin with vfs:, this will cause the extracted file to be downloaded to the native operating system’s file system using the browsers download function. |
|
You must specify vfs: prefix in the file name to access a file in the OPFS because you cannot directly access files in the native operating system’s file system from a web application. If the file name specified does not begin with vfs:, the operation will fail with File not found. |
When using the HCL Nomad for web browsers COM Helper extension, the native applications that are invoked by COM operations only have access to the native operating system, so they cannot access the OPFS. In order to help with this problem, there are operations to copy a file from OPFS to a temporary location on the native operating system’s file system so that native applications can access the data. When you specify vfs: as a prefix of the file name of a COM operation, the path is automatically replaced in the COM commands with the path to the temporary file. In this way, the COM operations will interact with the temporary file in the native file system while the LotusScript command only needs to reference the file in the OPFS.
LotusScript functions | Behavior |
NotesSession.FileOpBegin | FileOpBegin will export the file from the OPFS to a temporary location on the native operating system’s file, and this temporary file will automatically be used when you pass the virtual file to COM commands. |
NotesSession.FileOpEnd | FileOpEnd will copy the file from the temporary location on the native operating system’s file system back to the OPFS. |