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