Name:	Medialon FilesManagement
Version:	6.7.2
Available for:	Manager V7 and Manager V6 (Lite & Pro), Showmaster (Mini, ST, Pro, LE, XS & iPro)
Limitation In:	Showmaster: commands and variables marked with * are not available
Device Brand:	Medialon
Positrack Compatible:	No
Resources type:	None

Overview

Note: In Showmaster, the local disk access is restricted to a folder called “UserData”, located in the project folder, and the access to folders on the network is restricted to the folders shared without login and password.

FilesManagement MxM provides a simple way to copy, move or erase any kind of files on hard disk.

It also provides commands for reading and writing files.

The directory where mxmFilesManagement works can be on the local disk or on any accessible disk over the network.

Directories can also be created and their contents can be listed.

A special command lets you change the attribute of files (like their readonly flag).

A serie of commands is provided for manipulating strings, for the purpose of saving and sorting, arrangement of strings in blocks, refinding of strings from blocks. For example, these commands are practical for managing and saving tables of ascii text strings.

Special commands are provided for managing INI files: ini files are very practical for creating simple database files.

They contains sections and items. Folowing is an example of a simple INI file called “Addresses.INI” where names of people are into sections and their address are in items.

[Jack Ripper]
Address = Knife street 13
City = Manchester
Zip code = 123456
[Maria Rabbit]
Address = Carrot street 4
City = New York
Zip code = 654321
[César Escartefigue]
Address = 5 rue des Pacoulins
City = Manosque
Zip code = 010203

In this example, you can read back the address of Maria Rabbit into a variable called Adr with the FilesManagement command: Read items from section ( “Addresses.INI”, “Maria Rabbit”, “Address”, Adr).

Other commands let you create new sections and items.

You can also list all the sections of a file and all the items of a section. With mxmFilesManagement, you can also monitor changes in a folder ( * not available in Showmaster).

WARNING: the monitor command checks for changes in the folder specified AND into the sub-folders. So if there is a big quantity of files in these folders and subfolders, the refresh of monitoring files list can be very slowed down.

MxM Installation

No special installation required

Device Setup

No setup dialog box at creation

Device Commands

The commands marked with * are not available in Showmaster.

Set current directory

Set the current working directory.

• Path [String] New directory path.

Get subdirectories list

Get the list of the sub-directories present in the current directory.

• Return list [String] Variable that will contain the list in return.

Usage: The return variable is a list of strings.

It can be the ‘text’ property of a list object in a Manager or Display Controller user-screen.

Get fileslist

Get the list of files present in the current directory.

• Return list [String] Variable that will contain the list in return.

Usage: The return variable is a list of strings.

It can be the ‘text’ property of a list object in a Manager or Display Controller user-screen.

Copy file

Copy a file from a directory to another directory.

• Source path [String] Full name of the file to copy.
• Destination path [String] Full name of the destination file (can be a new name).

Move/rename file or directory

Move a file from a directory to another directory.

• Source path [String] Full name of the file to move or rename
• Destination path [String] Full name of the destination.

Usage: this command is called “Move/rename” because if you specify a different directory for destination, it is a move and if you specify the same directory as the source, it is a renaming. This command apply to directories, but in this case it only renames.

WARNING: if the destination file exists, the function fails, you must call “delete file” then “move file” in that case.

Delete file

Delete a file from the current directory.

• Path [String] Full name of the file to delete.

Write data to file

Write a string in a file.

• File path [String] Full name of the file to write.
• Data [String] Data to write.
• Data Type [Enum] Type of data to write
  • “Text”
  • “Binary”
• File Mode [Enum] Mode in which the file will be opened
  • “Create” The file is always created as a new file. existing file will be overwritten.
  • “Append” The file is opened to append data (to the end of the file). If the file does not exist, the file is created like with the ‘Create’ file mode.

Usage: If the file does not exist, it is created.

Usage: If data type is set to ‘Binary’, the content of the “Data” variable is decoded using the LowLevelCommunicator binary format (“!XX” where XX is the hexadecimal value of the byte) before it is written into the file.

If the file exists, its previous contents is erased and replaced with the new string, unless ‘Append’ file mode is used.

Read Data from File

Read the contents of a file into a string.

• File path [String] Full name of the file to read from.
• Data [String] Data that will contain the contents of the file in return.
• Data Type [Enum] Type of data to read
  • “Text”
  • “Binary”

Usage: If data type is set to ‘Binary’, the content of the file is encoded using the LowLevelCommunicator binary format (“!XX” where XX is the hexadecimal value of the byte) before it is returned into “Data” variable.

Disk Free*

Return the available free space of a disk.

• Drive letter [String] Letter of the drive.
• Return size [Integer] Variable filled with size of free space in KBytes in return.

File size

Return the size of a file.

• File name [String] Full name of the file.
• Return size [Integer] Variable filled with the size of the file in bytes in return.

Force create directories

Create a new directory in the current directory.

• Path [String] Name of the directory.

Usage: Multiple path can be specified, path like Dir1\Dir2\Dir3 are allowed.Relative path (Dir1\Dir2) or full path (C:\Dir1\Dir2) can be used.

Read sections from ini

List all the sections of the specified INI file.

• Ini file name [String] Full name of the ini file.
• Return sections list [String] Variable that will contain the list of sections in return.

Usage: The return variable is a list of strings.

It can be the ‘text’ property of a list and the sections names can then be accessed with the list control commands of Manager or Display Controller.

Read items from section

List all the items of the specified section of a INI file.

• Ini file name [String] Full name of the ini file.
• Section name [String] Name of the section.
• Return items list [String] Variable that will contain the list of items in return.

Usage: The return variable is a list of strings.

It can be the ‘text’ property of a list and the items names can then be accessed with the list control commands of Manager or Display Controller.

Read item value

Read the value of the specified item.

• Ini file name [String] Full name of the ini file.
• Section name [String] Name of the section to read from.
• Item name [String] Name of the item to read from.

Return item value [String] Variable that will contain the value of the item in return.

Write item value

Write the value of the specified item.

• Ini file name [String] Full name of the ini file.
• Section name [String] Name of the section to write to.
• Item name [String] Name of the item to write to.
• Item value [String] Value to write.

Usage: If the INI file does not exist, it is created.

If the section does not exist, it is created. If the item does not exist, it is created, otherwise its value is changed to the new value.

Erase section

Remove the specified section from the ini file.

• Ini file name [String] Full name of the ini file.
• Section name [String] Name of the section to erase.

Set file attributes

Change the attributes of the specified file.

• Read only [Enum] Read only flag
  • “On”
  • “Off”
• Hidden [Enum] Hidden flag
  • “On”
  • “Off”

Usage: Wildcards are allowed: for example, . will change the attributes of all the files in the current directory, *.txt will change the attributes of all the text files in the current directory. Useful when files are copied from a Cd-Rom where they have the read-only flag.

Open file dialog *

Open the default browser window dialog.

• Type [Type: Eum] The type of dialog: Open or Save.
• Title [String] The title of the dialog.
• Filter [String] For filtering files by extension.
• Initial directory [String] The directory on which the window opens.

Usage: If the user selects a file, the name of the file is contained in the variable CurrentFile.

If the user choose Cancel, the variable CurrentFile is empty.

WARNING: this dialog is modal, that means that as long as the dialog is opened, no other command can be performed by the same device (but others devices works, even other FilesManagement devices).

Split file path

Split the name of a file into 3 parts: directory, file name, and extension.

• Full path name [String] The path of the file
• Return directory [String] The string that will contain the directory in return.
• Return filename [String] The string that will contain the file name in return.
• Return extension [String] The string that will contain the extension in return.

Directory monitoring *

Specify the directory to watch. All changes in that directory will be monitored in the monitoring variables ot this device (see variables).

• Directory [String] The directory to watch.

Clear modified files list *

Clear all the names listed in the MonitoringModifiedFiles variable.

Clear new files list *

Clear all the names listed in the MonitoringNewFiles variable.

Clear deleted files list *

Clear all the names listed in the MonitoringDeletedFiles variable.

Copy/move directory

Copy or move the files specified from a directory and from its subdirectory to another directory.

• Source path [String] Full name of the directory to copy.
• Destination path [String] Full name of the destination directory.
• Filter [String] Filter the files to copy.
• Action [Enum] Action can be COPY or MOVE.

Usage: If destination directories don’t exist, they are created.

If the default filter . is not used, only the specified files are copied. When the action is MOVE, all the files specified are moved and the left empty directories of the source are removed.

Delete directory

Delete the directory and all its files and subdirectories.

• Directory [String] Full name of the directory to delete.
• With confirmation [Enum] Display a confirmation dialog: YES or NO.
• Move to recycle bin [Enum] Move all the files to the recycle bin: YES or NO.

WARNING: If the two enums are set to NO, all the files are erased without confirmation and without undo. By default, the enums are set to YES.

Get file information

retrieve informations from a file.

• File path [String] Full name of the file.
• Info type [Enum] Type of information:
  • “File Version”
  • “Company Name”
  • “File Description”
  • “Internal Name”
  • “Legal Copyright”
  • “Original Filename”
  • “Product Name”
  • “Product Version”
• Return info [String] The string that will contain the information in return.

NOTE: If the info is not in the file the string returns “Info not found”, if the files doest not exist the string returns “File not found”.

Erase item from section

Erase totally the specified item.

• Ini file name [String] Full name of the ini file.
• Section name [String] Name of the section.
• Item name [String] Name of the item to erase.

Open Connection

Open a connection to a shared folder path on a remote computer.

• Path [String] Full path of the shared folder (Ex: \192.169.0.1\MySharedFolder).
• User [String] name of a user granted to access this shared folder.
• Password [String] password of the user granted to access this shared folder.

NOTE: This command must be called prior to any file or folder command on a shared folder.

Close Connection

Close a connection to a shared folder path on a remote computer.

• Path [String] Full path of the shared folder (Ex: \192.169.0.1\MySharedFolder).

Device Variables

CurrentDirectory

[String] Current directory.

LastError

[Enum] Error message (result of the last command).

• “No Error”
• “Error”

CommandStatus

[Enum] Satus of the running command.

• “Done”
• “Running”

Usage: This command was useful in the version 1.0 of Manager or Display Controller, in order to be sure that the command has finished, but now it is obsolete because the task calling this command will be blocked the time the command will be done (and not the other tasks).

WindowsDirectory *

[String] Current Windows (OS) directory.

SystemDirectory *

[String] Current System (OS) directory.

ProjectsDirectory *

[String] Manager or Display Controller current projects directory.

CurrentFile *

[String] The file selected by the “Open file dialog” command. The string is empty if the user closes the dialog by clicking on the cancel button.

MonitoringModifiedFiles *

[String] List of all the files modified in the monitored directory.

MonitoringNewFiles *

[String] List of all the new files in the monitored directory.

MonitoringDeletedFiles *

[String] List of all the files deleted in the monitored directory.

MonitoringStatus *

[Enum] Status of the monitoring command.

• Directory not found (wrong directory)
• Waiting for changes (monitoring)
• Searching files changed (change signaled)

Revisions

V 1.0.1

• Internal Changes.

V 1.1.0

• Added: Support for Showmaster ST & Pro.
• Fixed: “Copy/Move Directory” with MOVE option doesn’t make a MOVE but a COPY.
• Fixed: “Copy/Move Directory” doesn’t create the root destination directory if not exists as per described in the Help file.
• Fixed: “The device Current” Directory is reset to the Windows Current Directory each time the device starts. It should be done only if the device Current Directory is not yet set..
• Fixed: “Set File Attribute” doesn’t work..
• Fixed: “Open file dialog” doesn’t open in the correct initial directory if the given path is relative to the Current Directory.
• Fixed: “Directory Monitoring” doesn’t work with relative path.

V 1.1.1

• Fixed: "‘Get File Info’ always returns ‘File not found’ under Showmaster.

V 1.1.2

• Added: Support for Manager Kiosk.

V 6.0.0

• Modified: Support of Manager V6/Showmaster V2.

V 6.0.1

• Fixed: Directory Monitoring doesn’t work (bug introduced in v6.0.0).

V 6.0.2

• Fixed: Device variables are not reset after a project load (Requires Manager 6.0.3+).

V 6.0.3

• Internal Changes.

V 6.0.4

• Added: Open Connection and Close Connection methods to handle Shared folder over the network.
• Fixed: Can not access a remote shared folder under Showmaster.

V 6.1.0

• Added: Support for Showmaster LE & Showmaster XS platforms.

V 6.1.1

• Modified: Internal changes.

V 6.2.0

• Added: “Read/Write string from/to file” commands become “Read/Write data from/to file” and get an additional parameter to specify if data is text or binary.

V 6.2.1

• Fixed: The “Delete directory” command does not work if the given path length is smaller than any previous paths already used with this command, within the same Manager/Showmaster session.

V 6.2.2

• Modified: Internal Changes.
• Added: ‘File Mode’ parameter (Create/Append) for ‘Write data to file’ command.

V 6.3.0

• Added: Compatibility for Overture CS.

V 6.3.1

• Fixed: Executing Set current directory($CURRENTPRJ_USERDATA) gives LastError of Path Error(3)

V 6.7.0

• Improved: Support for High DPI displays (require Manager 6.7.0+ or Showmaster Editor 2.7.0+)
• Changed: Compatibility for Manager 6.7.0 and Showmaster Editor 2.7.0