Когда скрипт запущен как инструмент-скрипт, ArcPy получает уведомление, из какого приложения он был вызван. Один из главных положительных моментов заключается в том, что вы можете записывать сообщения в ArcPy, и ваши сообщения будут автоматически появляться в диалоговом окне инструмента, в Истории геообработки (Geoprocessing history) и в окне Python. Это также означает, что любая модель или инструмент-скрипт, которые вызывают ваш инструмент-скрипт, получают доступ к созданным вами сообщениям.
Во время выполнения инструмента происходит запись сообщений, которые затем можно извлечь с помощью функций геообработки. Эти сообщения содержат, например, следующую информацию:
- время начала и окончания операции;
- используемые значения параметров;
- общую информацию о ходе операции (информационное сообщение);
- предупреждения о потенциальных проблемах (сообщение с предупреждением);
- ошибки, в результате которых инструмент прекращает работу (сообщение об ошибке).
Весь обмен информацией между инструментами и пользователями осуществляется посредством сообщений. В зависимости от того откуда запускаются инструменты, сообщения будут отображаться в окне История геообработки (Geoprocessing history), в окне Python и в диалоговом окне инструмента. Из Python можно вставить эти сообщения в скрипт, изучить их, распечатать или записать в файл. Все сообщения обладают свойством важности – информационное сообщение, предупреждение или ошибка. Важность обозначается целым числом, где 0 = информационное сообщение, 1 = предупреждение и 2 = ошибка.
| Степень серьезности | |
|---|---|
Информационное сообщение (важность = 0) | Информационное сообщение – это всего лишь сведения о выполнении. Оно никогда не указывает на проблемы. Информационные сообщения содержат только общие сведения, такие как ход работы инструмента, время запуска или завершения работы инструмента, характеристики выходных данных или результаты применения инструмента. |
Сообщение с предупреждением (важность = 1) | Сообщения с предупреждениями создаются при возникновении ситуации, которая может стать причиной проблемы во время работы инструмента или когда может быть получен неожиданный результат. Например, при определении системы координат для набора данных, для которого уже задана система координат, будет выдано предупреждение. Получив предупреждение, можно принять необходимые меры, например отменить запуск инструмента или выбрать другой параметр. |
Сообщение об ошибке (важность = 2) | Сообщения об ошибках указывают на критическое событие, которое нарушает работу инструмента. Ошибки возникают в случае недопустимых значений одного или нескольких параметров или сбоя важного процесса или процедуры. |
И предупреждения и сообщения об ошибках дополняются шестизначным кодом-идентификатором. Эти коды-идентификаторы занесены в документы, содержащие дополнительные сведения об их причинах и необходимых действиях. Когда коды ошибок или предупреждений отображаются в диалоговом окне инструмента, в окне Python или в окне История геообработки, они содержат ссылку, которая позволяет вам напрямую получить дополнительную справку по этому сообщению.