Fileinfo

Retrieves information about a file from the directory and saves it as a variable.

An excessive load is placed on your system when these conditions are met:

Your tenant has more than ~15 concurrent calls.
The scripts that are running contain file-related actions, such as Writefile, Readfile, and Fileexist.

This results in throttling. Your tenant will experience latency with script execution and other functions, including contact handling and state changes, until the backlog of processes completes.

Supported Script Types

Properties

Property	Details
FileName	The name of the new file. The file name is relative to the folder path where the script is saved. For example, if your script is in a folder called Test, using a file name of Sample.wav will be interpreted as Test\Sample.wav automatically. Access to files above the current script folder is not allowed.
FileInfoVar	The name of the variable to contain the file information. By default, FILE.

Branches

Branch	Details
Default	Path taken unless the script meets a condition that requires it to take one of the other branches. It is also taken if the other branches are not defined.
OnError	Path taken when the action fails to execute properly.

Tips & Tricks

Technically, this is a C# class like used by Createemail. The class contains the following members:

Member	Format	Description
Accessed	DateTime	Date and time the file was last accessed (in UTC).
AuthorID	int	Agent ID of the file’s creator (this is not populated today).
BusNo	int	tenant High-level organizational grouping used to manage technical support, billing, and global settings for your CXone environment number of file’s owner.
ContactID	int	Contact ID A unique numerical identifier assigned to each contact. associated with this file (often used for call logging files).
Created	DateTime	Date and time the file was originally created (in UTC).
DeleteTime	DateTime	Date and time when the file will be deleted automatically (in UTC). This may be the Min datetime value which represents Never.
Description	string	Optional text description associated with the file (unused today).
EntryID	int	The unique ID associated with the file (used internally as a primary key).
FileName	string	The name of the file without the path.
FolderID	int	An ID representing the folder where the file is located.
FullFileName	string	The full path and file name.
IsDeleted	bool	Indicates if this file has been deleted. Deleted files stay in the system for at least 24 hours.
IsFolder	bool	Indicates if this record refers to a folder or a file.
MailStatus	byte	Unused.
Modified	DateTime	Date and time when the file was last modified.
ModifiedID	int	Agent ID of the user which last modified the file (this is not populated today).
NumFiles	int	If IsFolder is true, this may contain the number of files contained within the folder.
PhysicalBytes	int	Indicates the number of bytes occupied by this file on disk.
PhysicalLocation	string	Indicates the path and file name of the system file used to store the contents of the file on disk.
Protected	bool	True if this file is locked to prevent accidental overwrite or deletion.
Purpose	FilePurposeType	Indicates the category of this file. The categories are listed below.
Size	int	Indicates the actual number of bytes that this file requires.
Version	int	Indicates the version number of this file. Used only if file versioning is enabled.
VolumeID	int	Indicates the ID of the physical disk volume where the file is stored.
VolumeStatus	VolumeStatus	Indicates the current status of the physical disk volume where the file is stored.
Weblink	bool	True if this file is visible from the web server for public access.