Системные функции Qlik Sense – синтаксис и пример
1. Цель
Мы используем системные функции Qlik Sense для получения информации о системе, устройстве и приложениях Qlik Sense, которые вы используете.
Системные функции Qlik Sense – синтаксис и пример
2. Системные функции Qlik Sense
Ниже представлены системные функции Qlik Sense с примерами. Давайте обсудим их более подробно
i. Функция Author() в Qlik Sense
Функция author() возвращает информацию об авторе текущего приложения Qlik Sense в виде строки. Свойства автора приложения Qlik Sense – это сведения о том авторизованном пользователе Qlik Sense, который создал соответствующее приложение. Вы можете использовать эту функцию как в скрипте загрузки данных, так и в выражениях диаграммы.
Синтаксис системной функции Author в Qlik Sense:
Author()
ii. Функция ClientPlatform()
Функция ClientPlatfom() возвращает строку, в которой содержится информация о браузере клиента.
Синтаксис системной функции ClientPlatform в QliK Sense:
ClientPlatfom()
Пример ответа этой функции может выглядеть так: Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/35.0.1916.114 Safari/537.36
iii. Функция ComputerName()
Эта функция вернет строку с именем вашего компьютера. Данная информация будет предоставлена операционной системой. Эту функцию можно использовать как в скрипте загрузки данных, так и в выражениях диаграммы в Qlik Sense.
Синтаксис системной функции ComputerName в Qlik Sense:
ComputerName()
Например, эта функция вернет строку «Windows-PC», если имя вашего компьютера – Windows-PC.
iv. Функция DocumentName()
При использовании этой функции будет возвращена строка, содержащая имя текущего документа Qlik Sense с соответствующим расширением (.qvf). Обратите внимание, что эта функция возвращает не весь путь к документу Qlik Sense, а только имя документа с расширением.
Синтаксис системной функции DocumentName в Qlik Sense:
DocumentName( )
Например, если имя документа Qlik Sense – Анализ продаж. Эта функция вернет строку «Sales Analysis.qvf».
v. Функция DocumentPath()
Функция возвращает строку, которая содержит полный путь к документу Qlik Sense. Вы можете использовать эту функцию как в скрипте загрузки данных, так и в выражении диаграммы.
Синтаксис системной функции DocumentPath в Qlik Sense:
DocumentPath( )
Например, если путь к документу Qlik Sense с именем Costumer Sales – C:\Users\HP\Documents\Qlik\Sense\Apps\Consumer Sales.qvf, эта функция вернет именно это в строке.
vi. Функция DocumentTitle()
Функция documenttitle() возвращает строку только с заголовком документа Qlik Sense. Вы можете использовать эту функцию как в скрипте загрузки данных, так и в выражении диаграммы.
Синтаксис системной функции DocumentTitle в Qlik Sense:
DocumentTitle()
Например, если заголовок вашего документа или приложения Qlik Sense – «Продажи покупателям», эта функция вернет строку «Продажи покупателям».
vii. Функция EngineVersion()
Функция возвращает строку с версией движка Qlik Sense, который вы используете.
Синтаксис системной функции EngineVersion в QliK Sense:
EngineVersion()
Например, если вы используете Qlik Sense версии 3.2, эта функция вернет строку «Qlik Sense 3.2».
viii. Функция GetCollationLocale()
Эта функция возвращает строку с именем языка и региональными параметрами, используемыми вами. Чтобы эта функция возвращала имя языка и региональных параметров, вам необходимо установить для переменной CollationLocale значение, и, если оно не установлено, в результате вы получите фактический языковой стандарт пользовательского компьютера.
Синтаксис системной функции GetCollationLoacle в Qlik Sense:
GetCollationLocale()
ix. Функция GetObjectField()
Эта функция возвращает измерение или поле определенной таблицы.
Синтаксис системной функции GetObjectField в Qlik Sense:
GetObjectField([Index])
где Index – это параметр, с помощью которого вы можете указать, какое измерение или поле вы хотите, чтобы эта функция возвращала. Index – это целое число.
Например, у вас есть три измерения в таблице: ProductLine, ProductCategory и StoreLocation, то, используя выражение,
GetObjectField ([3]) вы получите ответ «StoreLocation».
x. Функция GetRegistryString()
Функция возвращает значение определенного ключа в реестре Windows. Ключи реестра похожи на папки, содержащие информацию о реестре Windows. Значения подобны файлам внутри папок, содержащих подробную информацию о них. Значения реестра могут быть строковыми, двоичными значениями и т. д. Эта функция возвращает только строковое значение для соответствующего ключа.
Синтаксис системной функции GetRegistryString в Qlik Sense:
GetRegistryString(path, key)
где path – это путь к папке реестра, а key – это конкретный ключ, значение которого вы хотите получить в результате этой функции.
Например,
GetRegistryString(HKEY_CURRENT_USER\ControlPanel\Keyboard\KeyboardSpeed, KeyboardSpeed)
Возвращает значение клавиши KeyboardSpeed, равное 31.
Keyboard\KeyboardSpeed, KeyboardSpeed)
xi. Функция IsPartialReload()
Функция возвращает логическое значение (True или False) после оценки того, является ли текущая перезагрузка частичной или нет. Если «Да» или «Истина», то эта функция возвращает -1, а если «Ложь», то возвращается «0».
Синтаксис системной функции IsPartialReload в Qlik Sense:
IsPartialReload()
xii. Функция OSUser()
Функция OSUser() возвращает строку с именем пользователя, который в данный момент использует операционную систему или в настоящее время подключен к Qlik Sense. Вы можете использовать эту функцию как в скрипте загрузки данных, так и в выражении диаграммы.
Синтаксис системной функции OSUser в Qlik Sense:
OSUser()
xiii. Функция ProductVersion()
Эта функция возвращает строку, содержащую полную информацию о версии Qlik Sense, которая используется в настоящее время. Хотя эта функция эквивалентна функции EngineVersion(), которая предпочтительнее функции ProductVersion().
Синтаксис системной функции Productversion в Qlik Sense:
ProductVersion()
xiv. Функция ReloadTime()
Функция ReloadTime() возвращает отметку времени последнего момента, когда произошла загрузка данных. Вы можете использовать эту функцию как в скрипте загрузки данных, так и в функции диаграммы.
Синтаксис системной функции RelaodTime в Qlik Sense:
ReloadTime()
xv. Функция StateName()
Эта функция возвращает имя альтернативного состояния, которое используется для визуализации. Альтернативные состояния используются для динамических текстов или динамических цветов, то есть когда визуализация меняет свое состояние в зависимости от некоторых факторов или выбора в документе Qlik Sense.
Синтаксис системной функции StateName в Qlik Sense:
StateName()
Например,
- Для динамического текста-
='Region - '& if(StateName() = '$', 'Default', StateName())
- Для динамического цвета-
if(StateName() = 'Group 1', rgb(152, 171, 206), if(StateName() = 'Group 2', rgb(187, 200, 179), rgb(210, 210, 210) ) )