Функции файла Qlik Sense с синтаксисом и примерами
Сегодня мы поговорим о функциях файла Qlik Sense. Более того, мы рассмотрим использование функций файла в Qlik Sense для управления табличными файлами, которые загружаются в сценарии загрузки данных. Эти функции не применимы к любому другому типу используемых источников данных и возвращают NULL, если используются другой тип представления данных.
Функции файла Qlik Sense с синтаксисом и примерами
i. Функция Attribute()
Эта функция возвращает имена атрибутов, также известные как мета-теги файла. Мета-теги нужно сохранить как часть самого файла, чтобы функция могла их прочитать. Qlik Sense поддерживает ряд форматов файлов, таких как MP3, WMA, WMV, PNG и JPG.
Синтаксис функции файла Qlik Sense:
Attribute(filename, attributename)
где filename – имя файла, атрибуты или метатег которого вы хотите получить. В некоторых случаях вам также может потребоваться указать путь к файлу, например, «lib://Table Files/».
attributename – это имя атрибутов или метатегов, которые вы хотите, чтобы эта функция возвращала.
Например,
Attribute(FileLongName, ‘ImageWidth’) как ImageWidth,
Attribute(FileLongName, ‘ImageLength’) как ImageLength,
Attribute(FileLongName, ‘BitsPerSample’) как BitsPerSample,
Attribute(FileLongName, ‘Compression’) как Compression,
ii. Функция ConnectString()
Эта функция возвращает строку с именами активных или подключенных в данный момент соединений ODBC или OLE DB. Если активного соединения нет, функция вернет пустую строку.
Синтаксис функции файла Qlik Sense:
ConnectString()
Например, если сценарий подключен к соединению OBDC с именем «Sales», функция вернет то же имя в строке.
Загрузка ConnectString() как ODBCConnection вернет строку «Sales» в поле ODBCConnection.
iii. Функция FileBaseName()
Эта функция возвращает строку, в которой содержится базовое имя файла таблицы, который в данный момент читается в сценарии. Базовое имя – это только имя файла без остальных деталей пути к файлу.
Синтаксис функции файла Qlik Sense:
FileBaseName()
Например, если файл с путем «C:\UserFiles\Sales.txt» в настоящее время читается системой, функция FileBaseName() вернет строку «Sales».
iv. Функция FileDir()
Эта функция возвращает путь к каталогу файла таблицы, который в данный момент читается в сценарии, в виде строки.
Синтаксис функции файла Qlik Sense:
FileDir()
Например, если путь к файлу таблицы такой: C:\UserFiles\Sales.txt, тогда
FileDir() вернет «C:\UserFiles» в качестве каталога для файла «Sales».
v. Функция FileExtension()
Эта функция возвращает расширение файла таблицы в виде строки. Табличный файл должен быть тем, который читается в данный момент.
Синтаксис функции файла Qlik Sense:
FileExtension()
Например, если путь к файлу таблицы такой: C:\UserFiles\Sales.txt, тогда FileExtension() вернет «txt» как расширение файла «Sales».
vi. Функция FileName()
Эта функция возвращает строку, содержащую имя файла с его расширением.
Синтаксис функции файла Qlik Sense:
FileName()
Например, если путь к файлу таблицы такой: C:\UserFiles\Sales.txt, тогда FileName() вернет Sales.txt в качестве имени файла «Sales».
vii. Функция FilePath()
Эта функция возвращает полный путь к табличному файлу, который в данный момент читается в сценарии. Тип данных – строка.
Синтаксис функции файла Qlik Sense:
FilePath()
Например, если путь к файлу таблицы такой: C:\UserFiles\Sales.txt , то
FilePath() вернет «C:\UserFiles\Sales.txt» в качестве пути к файлу.
viii. Функция FileSize()
Эта функция возвращает размер файла в байтах в виде целого числа. Имя файла может быть указано, а если оно не указано, возвращается размер файла таблицы, загружаемой в данный момент.
Синтаксис функции файла Qlik Sense:
FileSize([filename])
Например, если путь к файлу таблицы такой: C:\UserFiles\Sales.txt , то FileSize («C:\UserFiles\Sales.txt») вернет 65,724 в качестве размера файла Sales.txt в байтах.
ix. Функция FileTime()
Эта функция возвращает строку, содержащую метку времени, то есть дату и время последнего изменения файла или файла таблицы. Вы также можете указать имя файла, для которого хотите получить метку времени.
Синтаксис функции файла Qlik Sense:
FileTime([ filename ])
Например, файл «Sales.xls» изменен в 2018-11-15 1:28:00, то функция FileTime («Sales.xls») вернет «2018-11-15 1:28:00» в качестве отметка времени.
x. Функция GetFolderPath()
Эта функция возвращает строку, содержащую полный путь к папке Microsoft Windows.
Синтаксис функции файла Qlik Sense:
GetFolderPath(foldername)
Например, в приведенном ниже примере сценария требуются пути к некоторым папкам.
LOAD GetFolderPath('Music') GetFolderPath('Pictures') GetFolderPath('Windows') AutoGenerate 1;
Этот код вернет пути для каждой папки, упомянутой в функции,
C:\Users\smu\Music для папки Music.
C:\Users\smu\Pictures для папки Pictures.
C:\Windows для папки Windows.
xi. Функция QvdCreateTime()
Эта функция возвращает строку с меткой времени XML-заголовка файла QVD. Она возвращает метку времени только в том случае, если в сценарии существует файл QVD. В противном случае возвращается NULL.
Синтаксис функции файла Qlik Sense:
QvdCreateTime(filename)
Например,
QvdCreateTime (‘Sales.qvd’) вернет временную метку XML, например, «2018-02-20 12:29».
QvdCreateTime («C:\MyDir\Sales.qvd»)
xii. Функция QvdFieldName()
Эта функция возвращает имя поля, присутствующего в файле QVD. Эта функция принимает номер поля и имя QVD-файла и возвращает имя поля, соответствующего этому номеру поля. Если поле, соответствующее номеру поля, отсутствует, функция возвращает NULL.
Синтаксис функции файла Qlik Sense:
QvdFieldName(filename , fieldno)
где fieldname – имя файла QVD, в котором мы хотим искать поле.
fieldno – целое число, определяющее количество полей, имя которых вы хотите получить из этой функции.
Например,
В файле QVD с именем Sales третье поле – ProductName, тогда функция будет использоваться как,
QvdFieldName («Sales.qvd», 3) вернет строку «ProductName».
xiii. Функция QvdNoOfFields()
Эта функция возвращает общее количество полей в файле QVD.
Синтаксис функции файла Qlik Sense:
QvdNoOfFields(filename)
Например,
QvdNoOfFields (‘Sales.qvd’) вернет «5», если в файле «Sales.qvd» всего пять полей.
xiv. Функция QvdNoOfRecords()
Эта функция возвращает общее количество записей в файле QVD.
Синтаксис функции файла Qlik Sense:
QvdNoOfRecords(filename)
Например,
QvdNoOfRecords (‘Sales.qvd’) вернет «50», если в файле «Sales.qvd» всего пятьдесят полей.
xv. Функция QvdTableName()
Эта функция возвращает имя таблицы в загруженном файле QVD.
Синтаксис функции файла Qlik Sense:
QvdTableName(filename)
Например, если файл QVD с именем «Sales.qvd» содержит таблицу «Year2018», функция QvdTableName (Sales.qvd) вернет строку «Year2018».