Set error qlikview

Сегодня, в этой статье, мы поговорим о системных переменных по работе с ошибками «Error Variables» и о том, как и где их можно использовать в своем приложении.

В Qlik Sense и QlikView «ErrorVariables» доступны для:

1. Определения, какие действия следует предпринять, если во время выполнения сценария возникает ошибка
2. Предоставления информации об ошибках, возникающих во время выполнения сценария

В этой статье мы рассмотрим следующие четыре переменные «ErrorVariables»:

1. ErrorMode
2. ScriptError
3. ScriptErrorCount
4. ScriptErrorList

Из этих 4 переменных, только одна переменная ErrorMode является переменной, задаваемой пользователем. Эта переменная определяет, что должно произойти, если во время выполнения скрипта возникает ошибка. Эта переменная устанавливается в скрипте следующим образом:

Переменная ErrorMode может принимать одно из трех значений: 0, 1 или 2. По умолчанию, переменная ErrorMode устанавливается в значение 1. Это означает, что при возникновении ошибки при выполнении скрипта скрипт остановится и предложит пользователю выполнить действие. Если для переменной ErrorMode установлено значение 0, то ошибка будет проигнорирована, и выполнение скрипта будет продолжено. Если для параметра ErrorMode установлено значение 2, сценарий завершится с ошибкой и остановится. Переменная ErrorMode должна быть установлена в начале сценария или перед секцией скрипта, где вы знаете, что могут возникнуть ошибки, которые вы хотели бы обработать особенным способом. Как только параметр ErrorMode будет установлен, он останется прежним, если переменная ErrorMode не будет перезагружена / изменена позже в скрипте. Например, вы можете установить для переменной ErrorMode значение 0, если в вашем скрипте есть область, которая может вызывать ошибки, которые вы хотели бы игнорировать (не останавливать выполнение сценария). В этом случае вам может потребоваться установить ErrorMode обратно в 1, если вы хотите, чтобы в дальнейшем сообщалось о других ошибках в скрипте.

Посмотрим, как будут отображаться сообщения об ошибках, если мы запустим простой сценарий ниже, чтобы загрузить группу файлов Excel, которые начинаются с «Book». Обратите внимание, что все загружаемые файлы не включают поле «MonthlySales».

Если перед этим скриптом, переменную ErrorMode выставили в значение «0» (SetErrorMode= 0), то когда скрипт завершит свою работы мы увидим следующее:

Обратите внимание, что скрипт завершил выполнение, хотя произошла ошибка. Теперь посмотрим, что произойдет, если мы оставим значение по умолчанию (ErrorMode= 1) или установим ErrorMode= 2.

Здесь выполнение скрипта остановилось при возникновении ошибки, предоставив возможность нажать кнопку «Close», исправить сценарий и перезагрузить данные снова.

В отличие от переменной ErrorMode переменные ScriptError, ScriptErrorCount и ScriptErrorList инициализируются не пользователем, а самой системой Qlik Sense или QlikView, которые предоставляют информацию об ошибке, которая была обнаружена при выполнении скрипта. Переменная ScriptError вернет код ошибки. Список кодов ошибок и их описания можно найти в справке Qlik Sense (или QlikView). ScriptErrorCount возвращает количество операторов, вызвавших ошибку во время выполнения скрипта. Наконец, переменная ScriptErrorList возвращает список ошибок, возникающих при выполнении сценария. Если имеется более одной ошибки, они разделяются переносом строки. Эти ошибки могут быть доступны в скрипте или через пользовательский интерфейс. В скрипте вы можете просто ссылаться на переменную ScriptError, чтобы найти его значение. Например, в приведенном ниже скрипте я могу проверить код ошибки 8 («Файл не найден»), чтобы определить, отсутствует ли загружаемый файл.

Переменные «ErrorVariables» также могут быть доступны в пользовательском интерфейсе через объект «Текст и изображение» (Text & image). В измерении объекта «Text& image» просто введите знак равенства и имя переменной:

Чтобы вернуть что-то вроде этого:

Переменные «ErrorVariables» полезны и просты в использовании. Например, мы, в своих проектах, чаще всего используем ErrorMode= 0 там где мы предполагаем, что существует вероятность того, что скрипт может вернуть ошибку, которую можно игнорировать. Это также полезно, если вам нужно контролировать путь выполнения скрипта на основе ошибки. Вы можете узнать больше об ошибках в справке Qlik Sense (или QlikView).

Error Handling – Any system needs application or logic to handle error, the same logic is applicable to Qlikview…

This document is general overview and guideline around Qlikview Error Handling, suggesting best practices and providing some sample existing functions to achieve it, In brief document covers following functional areas:

1. Overview to Qlikview Error Handling
   
2. Customizing default Qlikview behaviour on encountering error
   
3. Defining exceptions – information, warning or errors
   
4. Defining Custom behaviour and application specific error messages
   

Qlikview Error Handling

Qlikview scripting allow error handling primary using Qlikview ErrorMode functions, where Value of ErrorMode defines, what type of behaviour application will have. Primary following are main ErrorMode values are used

Code in development should have always ErrorMode=1, Production Environment (batch modes) generally have value as 2, or in specific scenarios it can have 0 also…

Note:
Setting variable ErrorMode = 0 ignores any error and continue to next code syntax, but return code from that script will be non-zero(failure), so generally in batch event, where return code of a Qlikview is required to trigger the next job, it will create an issue.

Defining Exceptions – Information, Warning or Errors

Now based on the business functionality, any processing issue can be termed as Information/Warning or Error; these are further classified down as:

1. System Generated Errors
   

2. Custom
   

   1. Warning – Generally overriding System Error
      
   2. Errors – Errors Generated at specific event
      

Custom Messages

Warning:

Generally these are the errors, which are not business critical, but needs to be reported/logged

Example

Generally critical production system has BCP features(hot/cold), which means once primary system is down, secondary becomes operation and accessible. Certain organization had Production system copy/backup, but no automated BCPing(or failover) process, So Once Primary system is down, application accessing the primary application has to now access new application, generally different location/credential

Flow Logic

So in the above case, Qlikview ignores error messages, when system1 does not respond and continues to next system2, thus overriding default Qlikview behaviour of failure

Custom Error:

In the same process flow, there is section “Data validation fails” – This section can be used to check a number of business logics – like number of rows, %change in volume more than a threshold and based on that process can decide to action according

Assuming, if both systems are responding fine, but number of rows returned is zero, so in this case it is not a system error, but a processing error and hence require a custom errors

Attached external library:

Sample error library, which can be used to achieve and experiment certain standard process behaviour. These files can be customized for specific application/group to cater delivery of customized messages/warning or errors

Other useful areas from application

1. Set Statement used to execute a complete function – ERRORLOG