Перейти к основному содержимому
Версия: 7.0

Оператор READ

Оператор READ - создание действия, считывающего файл из внешнего ресурса в свойство.

Синтаксис​

READ [CLIENT [DIALOG]] urlExpr [TO propertyId]

Описание​

Оператор READ создает действие, которое читает файл из внешнего ресурса по заданному URL, после чего записывает полученный файл в заданное свойство.

Поддерживаются следующие типы URL:

[file://]path_to_file
http[s]://path_to_file
ftp://username:password[;charset]@host:port[/path_to_file][?param1=value1&param2=value2&...]
ftps://username:password[;charset]@host:port[/path_to_file][?param1=value1&param2=value2&...]
sftp://username:password[;charset]@host:port[/path_to_file]

Для ftp и ftps поддерживаются параметры запроса passivemode, binarytransfermode, datatimeout, connecttimeout.

Если значение свойства, в которое записывается файл принадлежит классу FILE, то в его значение вместе с файлом также записывается расширение файла из URL.

Параметры​

  • CLIENT

    Ключевое слово. Если указывается, то действие будет выполнено на клиенте. По умолчанию действие выполняется на сервере.

  • DIALOG

    Ключевое слово. Если указывается, то перед записью файла, будет показан диалог, в котором пользователь может изменить заданный URL. Можно использовать только при записи на диск (тип URL - file) . По умолчанию диалог не показывается.

  • urlExpr

    Выражение, значением которого является URL, из которого следует произвести чтение. Значение выражения должно быть строкового типа.

  • propertyId

    Идентификатор свойства, в которое будет производиться запись считанных данных. У этого свойства не должно быть параметров и класс его значения должен быть файловым (FILE, RAWFILE, JSONFILE и т.д.). Если свойство не указано, оно автоматически устанавливается равным System.readFile.

Примеры​

readFiles()  {

    LOCAL importFile = FILE ();

    //чтение из HTTP
    READ 'http://www.lsfusion.org/file.xlsx' TO importFile;
    //чтение из HTTPS
    READ 'https://www.lsfusion.org/file.xlsx' TO importFile;
    //чтение из FTP
    READ 'ftp://ftp.lsfusion.org/file.xlsx' TO importFile;
    //чтение из FTPS
    READ 'ftps://ftps.lsfusion.org/file.xlsx' TO importFile;
    //чтение из SFTP
    READ 'sftp://sftp.lsfusion.org/file.xlsx' TO importFile;
    //чтение из FILE
    READ 'D://lsfusion/file.xlsx' TO importFile;
    READ 'file://D://lsfusion/file.xlsx' TO importFile;
}