Содержание урока по Qlik Sense
Рекомендации по визуализации, полям и именам Qlik Sense (Guidelines for visualizations, fields, and naming)
Существуют определенные соглашения и ограничения, о которых вам нужно знать при работе с Qlik Sense . Например: максимальное количество символов для использования в именах, описаниях и выражениях, а также символы, зарезервированные для использования только Qlik Sense (эти символы нельзя использовать в наименовании полей, переменных и т.п. объектов кликсенса).
Максимальное количество визуализаций
Максимальное количество визуализаций на листе ограничено количеством ячеек на листе: 288 (24×12).Максимальное практическое число будет меньше этого из-за ограниченного использования для визуализации, состоящих из 1 ячейки.
Ограничения на длину имени
Следующие ограничения применяются к числу символов, которые могут использоваться в различных ситуациях в Qlik Sense:
Ситуация | Максимальное число символов в наименовании |
---|---|
Имена (название, измерение, сноска …) – Names (title, dimension, footnote…) | Макс 255 символов. |
Описания – Descriptions | Макс 512 символов. |
Выражения – Expressions | Максимум 8 192 символов. |
Теги – Tags | Максимум 31 символа для каждого тега и не более 30 тегов для каждого элемента. |
Текст и диаграмма в виде изображения – Text & image chart | Максимум 12 000 символов. |
Именование измерений и мер – Naming dimensions and measures
Если вы используете длинные имена для своих измерений и мер, они будут усечены.
Обозначение ” … ” говорит о том, что эта часть имени скрыта. Также рекомендуется избегать использования символов, зарезервированных для системных целей, поскольку с ними могут возникнуть непредсказуемые результаты и ошибки.
Избегайте использования следующих символов в именах измерений и мер:
- :
- =
- [
- ]
- {
- }
- $
Максимальное количество символов в выражениях
Максимальное количество символов, которое может быть записано в выражении визуализации, равно 8,192. Если вы попытаетесь создать выражение с превышающим числом символов, то выражение будет усечено.
Naming Conventions – Соглашения по наименованиям Qlik Sense
В рамках разработки и поддержки скриптов важно, чтобы вы соблюдали стандартизацию в соглашениях по наименованиям объектов в скрипте. Это облегчит понимание и поддержку кода. То есть, просто взглянув на код, вы сможете найти свою цель в коде, если он стандартизован.
- Field names (Имена полей): Имя поля должно быть определено таким образом, чтобы его можно было легко прочитать конечным пользователям. В большинстве случаев таблица, из которой данные выводятся в Qlik Sense, содержит технические имена полей, но при использовании этих полей в сценариях Qlik Sense важно изменить их на более читаемую форму. Имя в поле должно быть указано в соответствии с данными, содержащимися в нем. Например, если у вас есть поле Prod_code в таблице продуктов, которое содержит код продукта, вы должны переименовать его как [Код продукта].
- Key field names (Имена ключевых полей): Поля, которые используются для связывания двух или более таблиц, либо составного ключа, либо обычного ключа, должны иметь префикс, например символ %. Легче найти связующие поля, просто глядя на символ %. Например, поле ссылки для таблицы продаж и бюджета можно назвать как %Sales_Budget_Key.
- Flag field names (Имена полей-флагов): Иногда Вы можете создавать некоторые поля-флаги в скрипте, в зависимости от сложности кода или по мере необходимости. Эти поля-флаги также должны быть названы так, чтобы их можно было легко идентифицировать. Вы можете использовать символ, например ‘_’, перед именем поля-флага. Например, имя поля флага может быть таким _EmployeeActiveFlag.
- Temporary field names (Имена временных полей): В ходе расчетам Вам приходится создавать временные поля в скрипте загрузки для различных вычислений. Эти поля должны быть легко идентифицированы для облегчения понимания логики кода. Вы можете использовать ключевые слова tmp или temp в конце имени поля, чтобы пометить их как временные поля. Например, Product_Category_Temp.
- Variable names (Имена переменных): Мы все довольно часто используем переменные в Qlik Sense для различных целей. Хотя они содержат данные, как обычные поля, их следует называть по-разному, чтобы их можно было идентифицировать при использовании в разных местах. Как правило, именам переменных предшествует небольшой префикс v. Например, vCount, vMaxDate и т.д.
Примеры Naming Conventions for Qlikview Scripting
Пример соглашения по наименованию “Bitmetric_QlikView_coding_conventions.pdf”
Пример корпоративного стандарта по наименованию (для QlikView, но применимо и к Qlik Sense)
1. Интерфейс
Наименование групп:
- Циклические группы должны быть с префиксом «cc»
- Drill-down группы должны быть с префиксом «dd»
2. Скрипт
Наименование таблиц, полей, переменных:
- Ключевые поля должны быть с префиксом «%»
Пример: %MainKey - Поля-флаги должны быть с префиксом «_»
Пример: _MoneyShow - Таблицы фактов должны начинаться с «FACT_»
Пример: [FACT_строки проводок] - Таблицы справочников должны начинаться с «DIM_»
Пример: [DIM_Контрагент] - Использовать бизнес-названия для полей
Пример:
Чеки: LOAD Дата, [Магазин], [Касса], [Чек Номер], [Тип Операции], [Чек Строка Количество], [Чек Строка Цена], [Чек Строка Сумма] FROM Чеки.qvd (qvd);
- Временные таблицы должны быть с префиксом «tmp_»
Пример: tmp_Чеки - Мапинг таблицы должны быть с префиксом «map_»
Пример: map_Валюта:
3. Переменные
- Переменные должны быть с префиксом «v»
Пример: vLastYear - Переменные содержащие формулы с префиксом «f»
Пример: fSalesMAT