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

Примеры Naming Conventions for Qlikview ScriptingПример соглашения по наименованию “Bitmetric_QlikView_coding_conventions.pdf”

Скачать (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

Добавить комментарий

Ваш e-mail не будет опубликован. Обязательные поля помечены *