Проект сервиса. Настройка задач геообработки

Для перехода к настройке модели в конструкторе необходимо нажать на название модели.

Откроется окно конструктора. Для вновь созданных (пустых) моделей окно конструктора будет выглядеть так, как показано на рисунке ниже (см. Рисунок 230 ).

Для моделей, уже включающих в себя какие-то инструменты и переменные, окно конструктора будет выглядеть так, как показано на рисунке ниже (см. Рисунок 231 ).

Окно конструктора состоит из двух частей:

• Панель инструментов ;
• Рабочая область .

Панель инструментов содержит основные инструменты для работы с моделью. В центре панели инструментов отображается название модели.

В левой части панели инструментов расположены следующие инструменты:

• кнопка Добавить переменную (см. подробнее п. 10.5.6.2 );
• кнопка Добавить инструмент (см. подробнее п. 10.5.6.3 );
• движок Изменение масштаба рабочей области;
  Для уменьшения или увеличения масштаба необходимо передвинуть ползунок влево или вправо соответственно. Также изменять масштаб можно путем нажатия комбинации клавиш Alt+ или Alt- на клавиатуре.
• Сдвиг экрана - сдвиг рабочей области;
  Необходимо нажать на данную кнопку, чтобы переместить рабочую область. Перемещать/сдвигать рабочую область можно, удерживая нажатой левую кнопку мыши или с помощью стрелок на клавиатуре. Включить/отключить инструмент можно также путем нажатия комбинации клавиш Alt+P на клавиатуре.

В правой части панели инструментов расположены следующие инструменты:

• Редактировать выбранное - переход в режим редактирования выбранной переменной, инструмента или отдельного параметра инструмента;
  Кнопка появляется, когда на рабочей области выбран один из инструментов, параметр инструмента или переменная (см. подробнее п. 10.5.6.4 и п. 10.5.6.5 ).
  Также запустить режим редактирования выбранного элемента можно двойным кликом мыши.
• Удалить связи - позволяет разорвать связь между переменной и входным параметром инструмента, являющимся массивом (см. подробнее п. 10.5.6.6 );
  Кнопка появляется при выделении переменной, связанной с входным параметром инструмента, или при выделении входного параметра, связанного с переменной.
• Разъединить - позволяет разорвать цепочку инструментов (объединение выходного параметра одного инструмента и входного параметра другого) или объединение переменной и входного параметра (см. подробнее п. 10.5.6.6 );
  Кнопка появляется при выделении переменной, объединенной с входным параметром инструмента, или при выделении параметра, объединяющего выходной параметр одного инструмента и входной параметр другого.
• Удаление выбранного - удаление выбранной переменной или инструмента;
  Кнопка появляется, когда на рабочей области выбран один или несколько инструментов или переменных. Также удалить выбранное можно путем нажатия комбинации клавиш Alt+Del на клавиатуре (см. подробнее п. 10.5.6.10 ).
• Скрыть выбранное - скрывает выбранный параметр инструмента (скрывает видимость параметра);
  Кнопка появляется, когда на рабочей области выбран один или несколько параметров инструментов. Также удалить выбранное можно путем нажатия комбинации клавиш Alt+Del на клавиатуре (см. подробнее п. 10.5.6.5 ).
• Вписать схему в экран - автоматически масштабирует все переменные, параметры инструментов и инструменты на рабочей области так, чтобы все элементы влезли в рабочую область;
  При этом модель центрируется.
• Разложить схему модели - автоматически располагает в определенном порядке все переменные, параметры инструментов и инструменты на рабочей области и масштабирует модель;
  При этом входные переменные и параметры инструментов располагаются слева, выходные параметры - слева; модель центрируется.
• Экспорт модели в python-скрипт - создает скрипт на языке Python на основе открытой модели (см. подробнее п. 10.5.6.11 );
• Сохранить изменения модели - сохранение внесенных изменений в модель;
  Кнопка появляется, когда в модель внесены и не сохранены какие-либо изменения.
• - закрытие окна конструктора.

Рабочая область включает в себя графическое изображение модели. Рабочая область - это пространство для размещения инструментов, переменных и связывания их между собой.

В конструкторе используются следующие обозначения для элементов модели (см. Рисунок 232 ):

• бежевым цветом обозначаются инструменты;
• синим цветом обозначаются переменные и входные параметры инструментов;
• зеленым цветом обозначаются выходные параметры инструментов;
• стопкой элементов обозначаются параметры инструментов и переменные, которые являются массивами;
• штриховым контуром помечаются входные параметры инструментов и переменные, для которых не задано значение;
• сплошным контуром помечаются входные параметры инструментов и переменные, для которых задано значение, а также выходные параметры;
• в цветовом квадрате слева на переменной или параметре инструмента схематично отображаются их типы (например, ABC - тип Строка , 123 - тип Целое число и т. д.);
• знаком помечаются публичные параметры инструментов и переменные;
• основным цветом выбранной цветовой схемы ГИС-сервера (см. п. 3.14 ) обозначаются выделенные инструменты, параметры инструментов и переменные;
• синими стрелками обозначаются потоки данных от входных параметров и переменных к инструменту;
• зелеными стрелками обозначаются потоки данных от инструмента к выходным данным;
• меньшим шрифтом под названием параметра или переменной отображаются их значения.

• Рисунок 232 - Модель геообработки с разными типами элементов Конструктора моделей

Для добавления новой переменной к модели нажмите Добавить переменную на панели инструментов. В выпадающем списке выберите тип переменной (см. Рисунок 233 ).

Доступны следующие типы переменных:

• Строка;
• Целое число;
• Вещественное число;
• Да/Нет;
• Дата;
• Файл;
• Геометрия;
• Экстент;
• Система координат;
• SQL-выражение;
• База геоданных;
• Класс объектов (Table);
• Слой объектов (Display Table);
• Класс пространственных объектов (Feature Class);
• Слой пространственных объектов (Feature Layer);
• Карта;
• Сервис изображений карты;

• Рисунок 233 - Доступные типы переменных

После выбора типа переменной разместите переменную в нужном месте рабочей области (см. Рисунок 234 ).

В открывшемся окне Создание переменной задайте следующие параметры (см. Рисунок 235 ):

• Тип - выбранный тип переменной;
• Имя - обязательный параметр, задайте имя переменной на английском языке;
• Является обязательным - определите, является ли переменная обязательной;
  Нажмите на переключатель, если требуется, чтобы модель была не доступна для запуска, пока не задана переменная.
• Является публичным - определите, является ли переменная публичной;
  Нажмите на переключатель, если требуется, чтобы переменная была доступна для обращения из CoGIS Конструктора или из окна инструмента в интерактивной карте.
  Введите Имя публичного параметра (обязательный параметр) и Описание .
• Является массивом - определите, является ли переменная массивом;
  Нажмите на переключатель, если переменная является совокупностью переменных выбранного типа.
• Источник - Значение , Ссылка , Переменная сервиса - определите, каким образом задается переменная;
  Выберите Ссылка , если требуется, чтобы переменная принимала значения другой переменной или определенного параметра модели.
  Выберите Переменная сервиса , чтобы присвоить переменной значение глобальной переменной (см. подробнее о глобальных переменных в п. 10.5.9 , п. 10.5.6.8 ). Вариант Переменная сервиса доступен, только если среди объявленных глобальных переменных есть переменная подходящего типа.
  Иначе - выберите Значение .
• Значение - задайте значение для переменной.
  Для переменных типов Строка , Целое число , Вещественное число , SQL-выражение введите значение переменной в текстовое поле. Чтобы ввести многострочное значение, растяните строку ввода до нужного размера, удерживая в правом нижнем углу строки ввода.
  Для переменной типа Дата выберите нужную дату из календаря.
  Для переменной типа Да/Нет задайте значение положением переключателя.
  Для переменной типа База геоданных выберите необходимую базу из выпадающего списка подключений (список подключений формируется во вкладке Базы данных Глобальных настроек CoGIS Server , см. подробно Руководство администратора по установке и настройке ).
  Для переменной типа Геометрия укажите картографический сервис и слой.
  Для переменных типов Класс объектов , Слой объектов , Класс пространственных объектов , Слой пространственных объектов выберите, как будет задаваться переменная (параметр Способ задания ):
• • Сервис - в качестве значения переменной используется выбранный слой картографического сервиса (см. Рисунок 236 );
    Выберите из выпадающего списка картографический сервис (параметр Название карты ) и необходимый слой (параметр Название слоя ). Если требуется, задайте SQL-выражение в качестве фильтра (параметр Фильтр ).

• • Рисунок 236 - Способ задания значения для переменной типов Класс объектов, Слой объектов, Класс пространственных объектов, Слой пространственных объектов - Сервис
  • Таблица из базы данных - в качестве значения переменной используется выбранная таблица из подключенной базы данных (см. Рисунок 237 );
    Выберите Базу данных из выпадающего списка подключений (обязательный параметр) и укажите необходимое Имя таблицы (обязательный параметр).

• • Рисунок 237 - Способ задания значения для переменной типов Класс объектов, Слой объектов, Класс пространственных объектов, Слой пространственных объектов - Таблица из базы данных
  • • Новая таблица - в качестве значения переменной создается новая таблица во временной базе данных (см. Рисунок 238 ).
      Укажите Имя таблицы (обязательный параметр) и тип геометрии. Определите систему координат, если создается таблица с геометрией.
      Добавьте набор атрибутивных полей, нажимая на кнопку . Определите свойства атрибутивных полей - имя, тип, обязательное или нет, длина, значение по умолчанию.

• • • Рисунок 238 - Способ задания значения для переменной типов Класс объектов, Слой объектов, Класс пространственных объектов, Слой пространственных объектов - Новая таблица
      Для переменной типа Карта выберите картографический сервис из выпадающего списка.
      Для переменной типа Сервис изображений карты выберите сервис изображений из выпадающего списка.
      Для переменной типа Экстент выберите сервис из выпадающего списка. В модели будет использован только экстент выбранного сервиса.
      Для переменной типа Система координат выберите необходимую систему координат в окне Выбор системы координат , нажав на кнопку Добавить систему координат .

Если переменная является ссылкой (в параметре Источник выбрано Ссылка ), в параметре Значение выберите нужную переменную или параметр текущей модели из выпадающего списка. Выбранная переменная будет визуально связана с настраиваемой переменной.

Если для переменной в параметре Источник выбрано Переменная сервиса , в параметре Значение выберите нужную глобальную переменную из выпадающего списка. Список глобальных переменных фильтруется, согласно типу переменной (см. подробнее о глобальных переменных в п. 10.5.9 ).

Если переменная является массивом, задайте необходимое количество значений переменной, нажимая на кнопку   Добавить значение . Чтобы добавить в качестве значения массива одну или несколько других переменных или параметров текущей модели, нажмите на кнопку   Добавить переменную и выберите из выпадающего списка необходимую переменную или параметр модели. Чтобы добавить в качестве значения массива одну или несколько глобальных переменных проекта, нажмите кнопку   Добавить переменную сервиса и выберите из выпадающего списка необходимую глобальную переменную. Чтобы изменить порядок следования значений в массиве, используйте команды меню -   Выше или   Ниже или перетаскивайте значения вручную. Чтобы удалить выбранное значение из массива, нажмите в строке со значением (см. Рисунок 239 ).

Поля, обязательные для заполнения, отмечены символом . По завершении настройки новой переменной нажмите Создать переменную , для отмены создания нажмите Отмена .

Для добавления нового инструмента к модели нажмите Добавить инструмент на панели инструментов или комбинацию клавиш Alt+T на клавиатуре.

Разместите инструмент на рабочей области (см. Рисунок 240 ).

В открывшемся окне Создание инструмента геообработки выберите нужный инструмент из выпадающего списка Тип (группы инструментов) (см. Рисунок 241 ), Имя заполнится автоматически.

Доступны следующие типы инструментов (см. Рисунок 242 ):

• Структура БД и схема данных ;
• Операции с данными ;
• Геометрические операции ;
• Операции с картой ;
• Операции с файлами ;
• Построение модели ;
• Импорт и экспорт ;
• Операции с 3D .

Каждый тип содержит ряд инструментов геообработки. Полный список инструментов см. в п. 13 .

Нажмите Создать инструмент , чтобы добавить выбранный инструмент в модель. Если добавление инструмента не требуется, нажмите Отмена .

Перейти к редактированию переменной или отдельного параметра инструмента можно по двойному щелчку или по нажатию кнопки на панели инструментов для выделенного элемента.

В открывшемся окне Редактирование переменной внесите необходимые изменения (см. Рисунок 243 ). Параметры, доступные для редактирования, те же, что и при создании переменной (см. п. 10.5.6.2 ), тип переменной изменить нельзя.

Для сохранения внесенных изменений нажмите ОК . Если изменения сохранять не требуется, нажмите Отмена .

Сохраните изменения в модели, нажав на кнопку на панели инструментов.

Перейти к редактированию всех параметров инструмента можно по двойному щелчку или по нажатию кнопки на панели инструментов для выделенного инструмента.

В открывшемся окне Редактирование параметров инструмента внесите необходимые изменения (см. Рисунок 244 ):

• изменить название инструмента;
• добавить или изменить описание инструмента;
  Если для инструмента добавлено описание, то плашка инструмента помечается меткой , при наведении на которую отображается введенное описание инструмента (см. Рисунок 245 ).
• указать значения для входных параметров инструмента;
  Значения должны соответствовать типу параметра (см. подробнее об указании значения переменной в п. 10.5.6.2 ).
  Если параметр инструмента является ссылкой, в параметре выберите нужную переменную или другой параметр текущей модели из выпадающего списка.
  Если в свойствах параметра в качестве Источника выбрано Переменная сервиса , в параметре выберите нужную глобальную переменную из выпадающего списка. Список глобальных переменных фильтруется, согласно типу параметра (см. подробнее о глобальных переменных в п. 10.5.9 ).
  Если параметр инструмента является массивом, задайте необходимое количество значений переменной, нажимая на кнопку . Чтобы добавить в качестве значения массива одну или несколько переменных или других параметров текущей модели, нажмите на кнопку и выберите из выпадающего списка необходимую переменную или параметр модели. Чтобы добавить в качестве значения массива одну или несколько глобальных переменных проекта, нажмите на кнопку   Добавить переменную сервиса и выберите из выпадающего списка необходимую глобальную переменную. Чтобы изменить порядок следования значений в массиве, перетаскивайте значения, удерживая . Чтобы удалить выбранное значение из массива, нажмите в строке со значением
• при необходимости отключить видимость некоторых параметров инструмента на рабочей области.
  Для выбранного параметра нажмите на кнопку - видимость параметра отключена. Чтобы включить видимость параметра, нажмите на кнопку

Обратите внимание, что тип инструмента изменить нельзя.

После внесения изменений закройте окно по кнопке Закрыть , изменения применятся автоматически.

Сохраните изменения в модели, нажав на кнопку на панели инструментов.

Связывание инструментов между собой происходит за счет параметров: необходимо указать, что выходные параметры одного инструмента являются входными для другого инструмента.

Для этого выходной параметр одного инструмента необходимо перетащить и совместить с нужным входным параметром другого инструмента. Аналогично соединяются отдельно добавленные переменные с входными параметрами инструментов.

На примере ниже выходной параметр Буферизированный слой с пространственными объектами первого инструмента был совмещен с параметром Входной класс пространственных объектов и стал входным параметром для второй инструмента (см. Рисунок 246 и Рисунок 247 ). Таким образом сформировалась цепочка из двух инструментов.

Сохраните изменения в модели, нажав на кнопку на панели инструментов.

Чтобы разделить связанные параметры (переменную и параметр), нажмите   Разъединить на панели инструментов Конструктора моделей.

Если было сформировано частичное связывание (например, выходной параметр одного инструмента лишь одного из значений массива входного параметра второго значения), то чтобы разорвать такую связь, нажмите Удалить связи на панели инструментов Конструктора моделей (см. Рисунок 248 ).

При наличии в одной модели нескольких отдельных несвязанных инструментов или цепочек необходимо определить очередность выполнения инструментов.

Определить очередность выполнения можно несколькими способами:

• с помощью инструмента геообработки Выполнение инструментов по очереди (см. п. 13 );
• с помощью кнопки Выполнять после следующих инструментов , расположенной в окне редактирования инструмента (см. п. 10.5.6.5 ).

Сохраните изменения в модели, нажав на кнопку на панели инструментов.

Очередность с помощью инструмента Выполнение инструментов по очереди

Имея два отдельных инструмента, не связанных параметрами, или две отдельных цепочки инструментов, вы можете указать, какой инструмент (или цепочка) будет выполняться в первую очередь, а какой за ним.

Для этого добавьте в модель инструмент Выполнение инструментов по очереди типа Построение модели (см. п. 13 , см. Рисунок 249 ).

Определите настройки входных параметров инструмента:

• Первый объект - тип Объект - в качестве значения указывается параметр того инструмента (или переменная), цепочка с которым (которой) должна выполняться в первую очередь;
• Второй объект - тип Объект - в качестве значения указывается параметр того инструмента (или переменная), цепочка с которым (которой) должна выполняться во вторую очередь.

Выходной параметр Первого объекта можно задавать в качестве значения во входной параметр следующего инструмента в первой цепочке.

Выходной параметр Второго объекта можно задавать в качестве значения во входной параметр следующего инструмента во второй цепочке.

Таким образом, сначала выполняется цепочка, которая задается в Первом объекте , а затем цепочка, которая задается во Втором объекте .

Инструмент Выполнение инструментов по очереди можно добавлять в модель несколько раз, добавляя каждую следующую цепочку инструментов во Второй объект инструмента.

Пример использования инструмента Выполнение инструментов по очереди - Рисунок 250 .

Очередность с помощью кнопки Выполнять после следующих инструментов

Вы можете настроить очередность выполнения отдельных инструментов модели или ваших цепочек инструментов с помощью кнопки Выполнять после следующих инструментов .

Для этого в окне редактирования параметров инструмента, который надо запустить после одного или нескольких других, нажмите кнопку Выполнять после следующих инструментов (см. Рисунок 251 ).

В открывшемся окне Выполнять после следующих инструментов выберите из списка всех инструментов модели те, которые должны быть запущены до просматриваемого (см. Рисунок 252 ). Чтобы выбрать сразу все инструменты модели, нажмите кнопку Выбрать все , расположенную справа над списком инструментов.

В окне Выполнять после следующих инструментов доступен однострочный поиск по инструментам модели. Список инструментов отфильтруется по содержанию поисковой строки в названии инструментов. Помимо этого, для каждого инструмента отображается количество входных ( Inputs ) и выходных параметров ( Outputs ).

После выбора инструментов нажмите Подтвердить . В скобках рядом с названием кнопки отображается количество выбранных инструментов модели. Очередность определена.

Если очередь устанавливать не требуется, нажмите Отмена в окне Выполнять после следующих инструментов .

Инструмент, для которого определена очередность, помечается в модели . При наведении на метку штриховыми линиями подсвечивается порядок выполнения инструмента (см. Рисунок 253 ).

Таким образом вы можете определить очередность выполнения любого инструмента или отдельной цепочки модели.

Вы можете использовать в модели глобальные переменные, заданные на уровне проекта сервиса (см. об объявлении глобальных переменных в п. 10.5.9 ).

Чтобы назначить переменной модели (или входному параметру инструмента модели) глобальную переменную, перейдите в режим редактирования переменной (или входного параметра).

Если в списке глобальных переменных есть переменная типа, подходящего для выбранной переменной модели (или выбранного входного параметра), в опции Источник будет доступен дополнительный вариант - Переменная сервиса . Выберите этот вариант и в качестве Значения укажите нужную глобальную переменную из выпадающего списка (см. Рисунок 254 ).

Если переменная модели (или входной параметр инструмента модели) является массивом, то чтобы добавить в качестве значения массива одну или несколько глобальных переменных проекта, нажмите кнопку   Добавить переменную сервиса и выберите из выпадающего списка необходимую глобальную переменную (см. Рисунок 255 ).

Вы можете добавить в модель в качестве инструмента другую модель или Python-скрипт текущего проекта.

Нажмите кнопку Добавить инструмент и в графе Тип выберите Текущий сервис . Справа будет показан список всех моделей и скриптов текущего проекта, в том числе выключенных (см. Рисунок 256 ).

Выберите нужную модель или скрипт. Выбранная модель добавится в текущую модель как инструмент с параметрами, которые в исходной модели были отмечены как публичные (см. пп. 10.5.6.2 , 10.5.6.4 - Рисунок 257 ). Выбранный скрипт добавится в текущую модель как инструмент с параметрами, которые были заданы в окне Параметры скрипта (см. п. 10.5.8.1 - Рисунок 258 ).

Чтобы удалить переменную или инструмент, выделите нужный элемент в модели и нажмите кнопку на панели инструментов Конструктора моделей или клавишу Delete на клавиатуре.

Сохраните изменения в модели, нажав на кнопку на панели инструментов.

Чтобы экспортировать модель в Python-скрипт, нажмите в списке моделей на кнопку на панели инструментов (см. п. 10.5.2 , см. Рисунок 259 ) или на аналогичную кнопку в Конструкторе моделей (см. п. 10.5.6.1 , см. Рисунок 260 ).

По нажатию на кнопку автоматически к проекту сервиса добавляется Python-скрипт с именем, аналогичным имени модели, с постфиксом _py .

В открывшемся окне Параметры скрипта заполните необходимые параметры Python-скрипта (см. Рисунок 259 ). Подробнее о параметрах скрипта см. в п. 10.5.7 .

После заполнения параметров открывается окно Редактор скриптов для просмотра полученного текста скрипта (см. Рисунок 261 ).

Действия с полученным скриптом те же, что и с моделью (см. пп. 10.5.2 и 10.5.3 ).

Обратите внимание на ограничения экспорта:

• выгружаемая модель должна быть сохранена в проекте (см. п. 10.6 );
• не экспортируются инструменты геообработки подключаемых .Net-библиотек;
• не экспортируются значения переменных и параметров инструментов, если их источник задан ссылкой на другие переменные или параметры.

Для добавления параметров инструмента геообработки, описываемого в Python-скрипте, нажмите на кнопку в левом верхнем углу Редактора скриптов .

В открывшемся окне Редактирование параметров инструмента (см. Рисунок 267 ) нажмите , чтобы добавить входной или выходной параметр инструмента.

Параметр описывается следующими свойствами (см. Рисунок 268 ):

• Тип - тип параметра:
  Доступны следующие типы параметра:
• • Строка;
  • Целое число;
  • Вещественное число;
  • Да/Нет;
  • Дата;
  • Файл;
  • Экстент;
  • Геометрия;
  • Система координат;
  • SQL-выражение;
  • База геоданных;
  • Класс объектов;
  • Слой объектов;
  • Класс пространственных объектов;
  • Слой пространственных объектов;
  • Карта;
  • Сервис изображений карты;
• Имя - уникальное имя параметра на английском языке;
  По имени параметра происходит обращение к параметру в скрипте.
• Является обязательным - включите эту опцию, чтобы инструмент геообработки был доступен для запуска только в случае, когда все обязательные параметры заданы;
  Данная опция доступна только для входных параметров.
• Описание - краткое описание параметра;
• Является массивом - включите эту опцию, если параметр является совокупностью параметров выбранного выше типа;
• Источник - Значение , Переменная сервиса - определите, каким образом задается параметр;
  Выберите Переменная сервиса , чтобы присвоить переменной значение глобальной переменной (см. подробнее о глобальных переменных в п. 10.5.9 , п. 10.5.8.3 ). Вариант Переменная сервиса доступен, только если среди объявленных глобальных переменных есть переменная подходящего типа.
  Иначе - выберите Значение .
• Значение - фиксированное значение параметра.
  Опция доступна только для входных параметров.
  Для параметров типов Строка , Целое число , Вещественное число , Дата , SQL-выражение введите значение параметра в текстовое поле. Чтобы ввести многострочное значение, растяните строку ввода до нужного размера, удерживая в правом нижнем углу строки ввода.
  Для параметра типа Да/Нет задайте значение положением переключателя.
  Для параметров типов Геометрия , Класс объектов , Слой объектов , Класс пространственных объектов , Слой пространственных объектов укажите картографический сервис и слой.
  Для параметра типа Карта выберите картографический сервис из выпадающего списка.
  Для параметра типа Сервис изображений карты выберите сервис изображений из выпадающего списка.
  Для параметра типа Система координат выберите необходимую систему координат в окне Выбор системы координат , нажав на кнопку Добавить систему координат .
  Для параметра типа База геоданных выберите необходимую базу из выпадающего списка подключений (список подключений формируется во вкладке Базы данных Глобальных настроек CoGIS Server , см. подробно Руководство администратора по установке и настройке ).

Если для параметра в качестве Источника выбрано Переменная сервиса , в качестве Значения выберите нужную глобальную переменную из выпадающего списка. Список глобальных переменных фильтруется, согласно типу параметра (см. подробнее о глобальных переменных в п. 10.5.9 ).

Если параметр является массивом, задайте необходимое количество значений параметра, нажимая на кнопку   Добавить значение . Чтобы добавить в качестве значения массива одну или несколько глобальных переменных проекта, нажмите кнопку   Добавить переменную сервиса и выберите из выпадающего списка необходимую глобальную переменную. Чтобы изменить порядок следования значений в массиве, используйте команды меню -   Выше или   Ниже или перетаскивайте значения вручную. Чтобы удалить выбранное значение из массива, нажмите в строке со значением (см. Рисунок 268 ).

После добавления и завершения настройки параметров в окне Редактирование параметров инструмента нажмите ОК. Теперь можно использовать эти параметры, обращаясь к ним в тексте скрипта. Чтобы отменить настройки, нажмите Отмена .

Чтобы отредактировать настроенные и сохраненные параметры, нажмите в левом верхнем углу окна Редактор скриптов еще раз. Переходите между настройками разных параметров, нажимая на их имя в списке.

Чтобы удалить неиспользуемый параметр, нажмите .

При обращении в скрипте к настроенному параметру используйте непосредственно его уникальное имя.

Обращение к настроенным параметрам (параметрам скрипта, см. п. 10.5.8.1 ) в скрипте происходит по имени параметра.

Обращение к инструментам геообработки в скрипте также происходит по имени (имя используется без приписки GpTool ): gp.<имя_инструмента> . Имя инструмента геообработки можно увидеть, например, в окне инструмента в модели (см. Рисунок 269 ).

Инструмент геообработки выступает в скрипте в качестве функции. Входные параметры инструмента указываются в скобках. Результат выполнения инструмента (значение функции) присваивается выходному параметру. Используются имена параметров на английском языке. Имена параметров также можно увидеть, например, в окне инструмента в модели (см. Рисунок 270 ).

Пример вызова инструмента в скрипте - см. Рисунок 271 .

Если выходных параметров несколько, то к каждому выходному параметру происходит обращение через точку (см. Рисунок 272 ).

Вы также можете использовать в своем скрипте глобальные переменные (см. пп. 10.5.9 , 10.5.8.3 ), а также вызывать модели или другие скрипты проекта как инструменты геообработки (см. п. 10.5.8.4 ).

Вы можете использовать в скрипте и объявленные глобальные переменные проекта (см. об объявлении глобальных переменных в п. 10.5.9 ).

Назначить глобальные переменные параметрам в скрипте можно двумя способами:

• непосредственно прописать в тексте скрипта, приравняв имени параметра инструмента уникальное Имя глобальной переменной (см. Рисунок 273 );

• Рисунок 273 - Использование глобальных переменных в тексте скрипта (на примере инструмента Добавление поля в таблицу/слой AddNewField)
• в окне Редактирование параметров в качестве Источника параметра выбрать Переменная сервиса , а в качестве Значения параметра выбрать нужную глобальную переменную из выпадающего списка.
  Выпадающий список глобальных переменных фильтруется, согласно типу выбранного параметра.
  Если параметр скрипта является массивом, то чтобы добавить в качестве значения массива одну или несколько глобальных переменных проекта, нажмите кнопку   Добавить переменную сервиса и выберите из выпадающего списка необходимую глобальную переменную (см. Рисунок 274 ).

• Рисунок 274 - Назначение глобальной переменной параметру-массиву скрипта

Вы можете вызвать из своего Python-скрипта в качестве инструмента модель или другой скрипт текущего проекта.

Вызов модели или другого скрипта происходит непосредственно по уникальному имени ( ID ).

Аналогично обычному инструменту геообработки, модель или другой скрипт выступают в качестве функции. Входные параметры указываются в скобках. Результат модели или скрипта присваивается выходному параметру (см. подробнее п. 10.5.8.2 ).

Пример вызова модели - см. Рисунок 275 .

В приложенном ниже тексте скрипта на языке Python решена следующая задача:

• создание точечного класса объектов:
• • создание класса объектов;
  • заполнение созданного класса объектов случайными точками;
  • добавление и заполнение атрибутивной информации;
• создание полигонального класса объектов:
• • создание класса объектов;
  • заполнение созданного класса объектов случайными полигонами;
  • добавление и заполнение атрибутивной информации;
• построение буферных зон вокруг точечных объектов;
• пересечение построенных буферных зон с созданным полигональным классом объектов;
• запись результата пересечения в новый полигональный класс объектов;
• вывод исходных точечного и полигонального классов объектов и полученного нового полигонального класса объектов в файл GeoPackage (GPKG).

В тексте скрипта output_file - параметр, настроенный в окне Редактирование параметров инструмента .