Рекомендации по визуализации, полям и именам 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”

Скачать (PDF, 482KB)

Пример корпоративного стандарта по наименованию (для QlikView, но применимо и к Qlik Sense)

1. Интерфейс

Наименование групп:

Циклические группы должны быть с префиксом «cc»
Drill-down группы должны быть с префиксом «dd»

2. Скрипт

Наименование таблиц, полей, переменных:

Ключевые поля должны быть с префиксом «%»
Пример: %MainKey
Поля-флаги должны быть с префиксом «_»
Пример: _MoneyShow
Таблицы фактов должны начинаться с «FACT_»
Пример: [FACT_строки проводок]
Таблицы справочников должны начинаться с «DIM_»
Пример: [DIM_Контрагент]
Использовать бизнес-названия для полей

Пример:

Чеки:
LOAD Дата,
     [Магазин],
     [Касса], 
     [Чек Номер],
     [Тип Операции],
     [Чек Строка Количество],
     [Чек Строка Цена],
     [Чек Строка Сумма]
FROM
     Чеки.qvd (qvd);