Выходной коннектор Добавить объект может использоваться для сохранения данных событий, как записей объектов, через векторный слой сервиса объектов. Этот выходной коннектор создает новую запись объекта для каждой обработанной записи события, перенаправленной на выход. Если целью проектирования является минимизация дублирования записей объектов, рассмотрите возможность использования выходного коннектора Обновить объект. Этот коннектор использует запросы к векторным слоям для добавления новых записей объектов к сервису объектов. Сервис объектов может быть опубликован на сайте ArcGIS Server, размещен на портале ArcGIS Enterprise или в организации ArcGIS Online.
Примечания по использованию
- Используйте этот выходной коннектор для добавления записей объектов к сервису объектов. В сервисе должна быть включена операция создание.
- Этот выходной коннектор спаривает JSON Outbound Adapter с Feature Service Outbound Transport.
- Записи о событиях, перенаправляющиеся в этот выходной коннектор, переформатируются адаптером как объект JSON.
- Транспорт включает форматированный JSON в запрос REST, который отправляется сервису объектов.
- Методы устранения проблем с этим выходным коннектором описаны в блоге GeoNet Debugging the Add a Feature / Update a Feature Output Connectors.
- Функция Зарегистрировать ArcGIS Server, доступная при настройке новых выходных данных, позволяет зарегистрировать подключение к отдельному ArcGIS Server, к хост-серверу ArcGIS Enterprise или хост-серверу, используемому организацией ArcGIS Online. Подключение к серверу должно быть зарегистрировано на ArcGIS GeoEvent Server, это дает возможность выбирать используемую коннектором папку сервисов, сервис объектов и слой объектов.
- Функция Опубликовать сервис объектов, доступная при настройке нового выхода, позволяет публиковать сервис объектов непосредственно из GeoEvent Manager. Для этой функции требуется определение GeoEvent, схема которого соответствует полям, которые вы хотите включить в слой сервиса объектов. Имейте в виду, что ограничения, накладываемые многопользовательской базой геоданных (например, зарезервированные слова и регистр атрибутивных полей) должны быть отражены в определении GeoEvent Definition, используемом при публикации нового сервиса объектов. В опубликованном сервисе объектов не будет записей – это пустой сервис, который используется GeoEvent Server для добавления или обновления записей объектов из обрабатываемых записей событий реального времени. Сервер, на котором вы публикуете новый сервер объектов, должен быть хост-сервером ArcGIS Enterprise или отдельным сервером ArcGIS Server с управляемой базой геоданных. GeoEvent Manager не может использоваться для публикации нового размещенного сервиса объектов в организации ArcGIS Online.
- Значение Генерировать простой JSON по умолчанию не должно меняться при настройке выхода на добавление или обновление записей объектов в базе геоданных. При отключении этого параметра, на выходе сохраняется иерархическая структура атрибутивных значений, отправляемая в сервис объектов, которые не принимаются сервисом объектов, новые записи создаваться не будут.
- Параметр Удалять старые объекты можно включить, если вы хотите, чтобы периодически выполнять запрос слоя объектов сервиса для определения объектов, старше указанного количества минут, и удалять такие записи. Вместо добавления новых записей и удаления старых, рассмотрите возможность создания коннектора Обновление объектов, который позволяет определять объекты с помощью идентификатора трека, такого как серийный номер или уникальный идентификатор оборудования. Также можно использовать фильтры на стороне клиента, чтобы удалять или скрывать старые записи объектов, вместо удаления данных из базы геоданных.
- При выборе Удалять старые объекты, укажите поле даты/времени, которое регулярно обновляется, например, Last Updated или Last Edited. Если используется поле истории или поле фиксированного времени, такое как Date Created, можно случайно удалить записи объектов, которые не обязательно являются устаревшими.
Параметры
| Параметр | Описание |
|---|---|
Имя | Описательное имя выходного коннектора, используемое для справки в GeoEvent Manager. |
Подключение к ArcGIS Server | Подключение ArcGIS Server, ArcGIS Enterprise или ArcGIS Online, зарегистрированное в ArcGIS GeoEvent Server в качестве хранилища данных. Зарегистрированные подключения к серверу кэшируют информацию о сервисах карт/объектов, их слоях и свойствах слоев. |
Папка | Папка сервисов ArcGIS Server или портал/Enterprise / папка с элементами ресурсов ArcGIS Online. |
Название сервиса | Имя сервиса объектов, в который будут добавлены обработанные данные событий в виде новых записей объектов. |
Слой | Имя векторного слоя в сервисе объектов, в который будут добавлены обработанные данные событий в виде новых записей объектов. |
Интервал обновления (секунд) | Задает интервал (в секундах), через который будет очищаться кэш обработанных записей событий и запрашиваться создание новых записей объектов в указанном сервисе объектов. Значение по умолчанию для этого свойства – 1 секунда, что означает, что данные из обработанных записей событий будут кэшироваться, и кэш сбрасывается каждую секунду для сохранения данных событий путем создания новых записей объектов. Можно ограничить число транзакционных запросов, выполняемых на сервере базы данных, увеличив интервал обновления, чтобы данные событий хранились в кэше выходных данных в течение более длительного периода времени. |
Генерировать одномерный JSON | Указывает, как иерархия в обработанной записи события преобразовываться выходным адаптером. Сервисы объектов ArcGIS Server не поддерживают значения данных, организованные в массивы, группы или вложенные значения. Значение по умолчанию – приведение таких структур данных к одному строковому значению, имя атрибута которого берется из имени элемента группы или массива, эффективно генерирует одномерное строковое значение JSON.
Примечание:В то время как свойство Добавить выходной коннектор объектов позволяет приводить иерархические значения к простым строкам, рекомендуется использовать Сопоставление полей для явного сглаживания структуры записи события перед маршрутизацией записи события на выход. Явное отображение значений для разделения полей дискретных атрибутов, тип которых – string, double, date, geometry и т. д. помогает обеспечить целостность данных и соответствие ограничениям на значения полей атрибутов, применяемым сервисом объектов. |
Форматированный JSON | Указывает, будет ли строка объекта JSON иметь отступ с пробелом и форматированием новой строки. Этот JSON, иногда называемый PJSON, обычно подходит только при записи в системный файл, содержимое которого может быть просмотрено в текстовом редакторе. По умолчанию Нет.
|
Удалить устаревшие объекты | Определяет, будет ли выходной коннектор периодически запрашивать векторный слой сервиса объектов для объектов старше заданного количества минут и удалять идентифицируемые записи объектов. По умолчанию Нет.
|
Максимальный возраст объекта (минут) (Условия) | Указывает максимальный возраст (в минутах), в течение которого записи объектов могут сохраняться, прежде чем считаться старыми. Значение по умолчанию – 1440 минут, что означает, что записи объектов старше 24 часов будут удалены из сервиса объектов, если для выходных данных настроено Удалить старые объекты. Примечание:Выходные данные не должны получать обработанные записи объектов для запуска удаления старых записей объектов. Периодически выполняется запрос для идентификации и удаления старых записей параллельно с добавлением или созданием новых записей объектов.Это свойство показывается, когда для свойства Удалить устаревшие объекты задано значение Да, и скрыто, если выбрано значение Нет |
Частота удаления устаревших объектов (секунд) (Условия) | Задает интервал (в секундах), через который будут выполняться запросы для идентификации старых записей объектов. Значение по умолчанию – 20 секунд, что означает, что запросы будут выполняться три раза в минуту для проверки записей объектов, значение даты/времени которых указывает, что запись объекта устарела. Это свойство показывается, когда для свойства Удалить устаревшие объекты задано значение Да, и скрыто, если выбрано значение Нет |
Поле времени в классе объектов (Условия) | Поле атрибута векторного слоя, значение даты/времени которого используется для определения возраста каждой записи объекта. Это свойство не имеет значение по умолчанию. Следует выбрать поле атрибута, значение которого часто обновляется, чтобы избежать случайного удаления записей объектов, которые на самом деле не устарели. Это свойство показывается, когда для свойства Удалить устаревшие объекты задано значение Да, и скрыто, если выбрано значение Нет |
Максимальное число объектов на транзакцию | Максимальное число записей, включаемое в любой запрос сервиса объектов для создания новых записей объектов. Если выходной кэш содержит более заданного максимального числа записей, будет сделано несколько запросов пока не очиститься выходной кэш. Значение по умолчанию равно 500. Рекомендуется сбалансировать размер и сложность каждой записи события с количеством записей событий, обрабатываемых в секунду. Когда записи событий особенно велики, со многими полями атрибутов и / или большими объектами сложной геометрии, уменьшите значение, чтобы избежать отправки запросов, которые больше, чем может обработать сервис объектов. Однако в зависимости от скорости и объема записей событий, обрабатываемых каждую секунду, установка слишком низкого значения может привести к слишком большому числу запросов транзакций. |