Свойства
| Свойство | Тип | Описание | Пример | Версия |
|---|---|---|---|---|
| LastError | строка | Возвращает текст последней ошибки синхронизации. Возвращает null, если синхронизация была выполнена без ошибок | if (FileSystem.LastError != null) {
var log = DB.Create("Document.Log");
log.Report = FileSystem.LastError;
log.Save();
}
| - |
| SuccessSync | логический | Возвращает true, если последняя синхронизация была проведена успешно. Значение сохраняется после выхода из приложения | if (FileSystem.SuccessSync)
DisplaySyncInfo("Success");
else
DisplaySyncInfo("Sync error");
| - |
| LastSyncTime | время | Возвращает время последней синхронизации. Значение сохраняется после выхода из приложения | function DisplaySyncInfo(info) {
$.txtSyncInfo.Text = info;
$.txtSyncTime.Text = FileSystem.LastSyncTime;
}
| - |
Методы
| Метод | Описание | Параметры | Исключения | Пример | Версия |
|---|---|---|---|---|---|
HandleLastError() HandleLastError(message) | Вызывает стандартный обработчик ошибок | message - сообщение, передаваемое в отчет, отсылаемый разработчикам | function HandleFileSystemError() {
FileSystem.HandleLastError(
"An error occurred during finishing workflow");
}
| ||
SyncShared() SyncShared(callback) SyncShared(callback, state) | Выполняет синхронизацию файлов с сервером в /shared/ каталоге | callback - имя функции, вызываемой после успешного или неудачного выполнения синхронизации state - объект, передаваемый в функцию обратного вызова в качестве параметра; Функция обратного вызова: (args), args - аргументы функции обратного вызова; args.Result - возвращает true, если синхронизация была выполнена успешно args.State - объект, переданный в качестве параметра state; | function SyncShared() {
FileSystem.SyncShared(OnSyncCompleted, workflowName);
}
function OnSyncCompleted(args) {
if (args.Result)
FinishSync();
else
HandleFileSystemError(args.State);
}
| - | |
UploadPrivate() UploadPrivate(callback) UploadPrivate(callback, state) | Отправляет на сервер файлы из каталога /private/. Уже выгруженные файлы не передаются | callback - имя функции, вызываемой после успешного или неудачного выполнения операции state - объект, передаваемый в функцию обратного вызова в качестве параметра; Функция обратного вызова: (args), args - аргументы функции обратного вызова; args.Result - возвращает true, если операция была выполнена успешно args.State - объект, переданный в качестве параметра state; | FileSystem.UploadPrivate(OnSyncCompleted, workflowName); function OnSyncCompleted(args) {
if (args.Result)
FinishUpload();
else
HandleFileSystemError(args.State);
}
| - | |
| ClearShared() | Выполняет рекурсивную очистку каталога /shared/ | FileSystem.ClearShared(); SyncShared(); | - | ||
| ClearPrivate() | Выполняет рекурсивную очистку каталога /private/ | function FinishUpload() {
FileSystem.ClearPrivate();
}
| - | ||
| CreateDirectory(name) | Создает новый каталог | name - путь каталога, должен начинаться с /private/ или /shared/ | IOException:
| FileSystem.CreateDirectory("/private/Document.Visit");
| - |
| Delete(name) | Удаляет файл или каталог | name - путь файла или каталога, должен начинаться с /private/ или /shared/ | IOException
| FileSystem.Delete("/private/Document.Visit/visit.jpg");
| - |
| Exists(name) | Возвращает true, если файл или каталог существует | name - путь файла или каталога, должен начинаться с /private/ или /shared/ | IOException
| function HasIcon() {
return FileSystem.Exists("/shared/icon.jpg");
}
| 2.3.3.107 |
| Copy(from, to) | Копирует файл, расположенный в from в to | from - путь файла, должен начинаться с /private/ или /shared/ to - путь файла, должен начинаться с /private/ или /shared/ | IOException
| function HoldIcon() {
FileSystem.Copy("/shared/icon.jpg"
, "/private/icon.jpg");
}
| 2.3.3.107 |
| DirFiles(name) | Возвращает массив имен файлов в указанном каталоге | name - путь каталога, должен начинаться с /private/ или /shared/ | IOException
| function ClearCacheFiles() {
var root = "/private/cache/";
var files = FileSystem.DirFiles(root );
for (file in files)
if(Check(file))
FileSystem.Delete(root + file);
}
| 2.3.3.107 |
| DirFolders(name) | Возвращает массив имен подкаталогов в указанном каталоге | name - путь каталога, должен начинаться с /private/ или /shared/ | IOException
| function RootFolders() {
return FileSystem.DirFolders("shared");
}
| 2.3.3.107 |
| CreateTextFile(name, text) | Создает текстовый файл | name - путь файла, должен начинаться с /private/ или /shared/ text - текст, записываемый в файл | IOException:
| function SaveMessage(m) {
FileSystem.CreateTextFile("private/msg.text", m);
}
| 2.3.3.107 |
| OpenTextFile(name) | Возвращает текстовое содержимое файла | name - путь файла, должен начинаться с /private/ или /shared/ | IOException:
| function ShowMessage() {
var m = FileSystem.OpenTextFile("shared/msg.txt");
Dialog.Message(m);
}
| 2.3.3.107 |
