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