Поделиться через


Fulcrum (предварительная версия)

Fulcrum — это первое решение, которое позволяет экспертам GIS и членам группы не GIS легко записывать и совместно использовать геопространственные данные. Этот соединитель обеспечивает интеграцию с Fulcrum для управления данными полей, фотографиями, видео и т. д.

Этот соединитель доступен в следующих продуктах и регионах:

Услуга Класс Регионы
Copilot Studio Премиум Все регионы Power Automate за исключением следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Логические приложения Стандарт Все регионы Logic Apps , кроме следующих:
     - Azure Government регионы
     - Azure регионы Китая
     - Министерство обороны США (DoD)
Power Apps Премиум Все регионы Power Apps кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Power Automate Премиум Все регионы Power Automate за исключением следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Контакт
Имя Поддержка Fulcrum
URL https://www.fulcrumapp.com/support
Адрес эл. почты support@fulcrumapp.com
Метаданные соединителя
Publisher Пространственные сети, Inc.
Веб-сайт https://www.fulcrumapp.com
Политика конфиденциальности https://www.fulcrumapp.com/privacy
Категории Продуктивность; Данные

Точка опоры

Fulcrum — это первое решение, которое позволяет экспертам GIS и членам группы не GIS легко записывать и совместно использовать геопространственные данные. Этот соединитель обеспечивает интеграцию с Fulcrum для управления данными полей, фотографиями, видео и т. д.

Publisher

Точка опоры

Предпосылки

  • Активная подписка Fulcrum с включенным доступом к API

Поддерживаемые операции

Triggers

При возникновении события Fulcrum

Активирует при создании, обновлении или удалении ресурсаFulcrum. Поддерживает события для записей, форм, списков выбора и наборов классификации. Настройте веб-перехватчик в организации Fulcrum, чтобы указать, какие события следует отслеживать.

Действия

Получение списка метаданных вложений

Получение списка вложений.

Получение вложения

Получение метаданных для одного вложения.

Получение списка метаданных аудио

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

Получение исходного файла звука

Скачайте исходный звуковой файл.

Получение списка метаданных фотографии

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

Получение исходного файла фотографии

Скачайте исходный файл фотографии.

Получение метаданных фотографии

Получение метаданных для одной фотографии.

Создание запроса POST

Выполнение запроса API запроса с помощью HTTP POST. Предоставьте SQL-запрос, например запрос к данным вашей организации.

Получение списка записей

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

Создание записи

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

Удалить запись

Удаление записи из организации.

Получение записи

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

Частичное обновление записи

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

Обновить запись

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

Получение журнала записи

Получите полный журнал версий записи.

Создание отчета

При необходимости создайте новый отчет для определенной записи с помощью шаблона отчета.

Получение файла отчета

Скачайте созданный PDF-файл отчета.

Получение списка метаданных подписи

Получение метаданных для списка подписей.

Получение метаданных подписи

Получение метаданных для одной подписи.

Получение исходного файла подписи

Скачайте исходный файл подписи.

Получение списка метаданных эскиза

Получение метаданных для списка эскизов.

Получение исходного файла эскиза

Скачайте исходный файл эскиза.

Получение метаданных эскиза

Получение метаданных для одного эскиза.

Получение списка метаданных видео

Получение метаданных для списка видео.

Получение исходного файла видео

Скачайте исходный видеофайл.

Получение учетных данных

Чтобы использовать соединитель Fulcrum, вам потребуется маркер APIFulcrum:

  1. Войдите в учетную запись Fulcrum по адресу https://web.fulcrumapp.com
  2. Перейдите к API параметров >
  3. Создание нового маркера API или использование существующего
  4. Скопируйте маркер и используйте его при создании подключения

Начало работы

Создайте новое подключение и введите маркер APIFulcrum при появлении запроса.

URL-адреса пользовательских узлов

По умолчанию соединитель использует рабочий APIFulcrum по api.fulcrumapp.comадресу. Для других регионов можно указать другой URL-адрес узла при создании подключения.

Региональные конечные точки:

  • United States (по умолчанию): api.fulcrumapp.com
  • Канада: api.fulcrumapp-ca.com
  • Австралия: api.fulcrumapp-au.com
  • Европа: api.fulcrumapp-eu.com

Формат: Введите только имя узла без протокола или пути. Соединитель будет автоматически использовать HTTPS и правильный путь API.

Устранение неполадок:

  • Убедитесь, что пользовательский узел доступен из сети
  • Убедитесь, что имя узла правильно (без опечаток)
  • Убедитесь, что маркер API действителен для указанного узла

Известные проблемы и ограничения

  • Ограничение скорости применяется на основе плана Fulcrum

Инструкции по развертыванию

Используйте инструкции для развертывания этого соединителя в качестве пользовательского соединителя в Microsoft Power Automate и Power Apps.

Создание подключения

Соединитель поддерживает следующие типы проверки подлинности:

По умолчанию Параметры для создания подключения. Все регионы Недоступен для совместного использования

По умолчанию

Применимо: все регионы

Параметры для создания подключения.

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Имя Тип Описание Обязательный
Токен API securestring Маркер API Fulcrum для проверки подлинности True
URL-адрес узла струна Узел API для экземпляра Fulcrum

Ограничения регулирования

Имя Вызовы Период обновления
Вызовы API для каждого подключения 100 60 секунд

Действия

Обновить запись

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

Получение вложения

Получение метаданных для одного вложения.

Получение журнала записи

Получите полный журнал версий записи.

Получение записи

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

Получение исходного файла видео

Скачайте исходный видеофайл.

Получение исходного файла звука

Скачайте исходный звуковой файл.

Получение исходного файла подписи

Скачайте исходный файл подписи.

Получение исходного файла фотографии

Скачайте исходный файл фотографии.

Получение исходного файла эскиза

Скачайте исходный файл эскиза.

Получение метаданных подписи

Получение метаданных для одной подписи.

Получение метаданных фотографии

Получение метаданных для одной фотографии.

Получение метаданных эскиза

Получение метаданных для одного эскиза.

Получение списка записей

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

Получение списка метаданных аудио

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

Получение списка метаданных видео

Получение метаданных для списка видео.

Получение списка метаданных вложений

Получение списка вложений.

Получение списка метаданных подписи

Получение метаданных для списка подписей.

Получение списка метаданных фотографии

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

Получение списка метаданных эскиза

Получение метаданных для списка эскизов.

Получение файла отчета

Скачайте созданный PDF-файл отчета.

Создание записи

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

Создание запроса POST

Выполнение запроса API запроса с помощью HTTP POST. Предоставьте SQL-запрос, например запрос к данным вашей организации.

Создание отчета

При необходимости создайте новый отчет для определенной записи с помощью шаблона отчета.

Удалить запись

Удаление записи из организации.

Частичное обновление записи

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

Обновить запись

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

Параметры

Имя Ключ Обязательно Тип Описание
Тип контента
Content-Type string

Тип контента

Идентификатор записи
record_id True string

Код записи

X Skipworkflows
X-SkipWorkflows boolean

Пропускает все рабочие процессы приложений

X Skipwebhooks
X-SkipWebhooks boolean

Пропускает все веб-перехватчики приложений

assigned_to_id
assigned_to_id string

Идентификатор пользователя, назначенного этой записи

form_id
form_id True string

Идентификатор формы, к которой принадлежит эта запись

form_values
form_values object

Значения полей, ключом поля

Координаты
coordinates True

Координаты геометрии. Формат зависит от типа: точка использует [долготу, широту], LineString использует массив позиций, Polygon использует массив линейных кругов (сначала внешний, остальные — отверстия), многотипные типы используют массивы их соответствующих структур координат.

тип
type True string

Тип геометрии GeoJSON

широта
latitude number

Координата широты

долгота
longitude number

Координата долготы

project_id
project_id string

Идентификатор проекта

статус
status string

Состояние записи

Получение вложения

Получение метаданных для одного вложения.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор вложения
attachment_id True string

Уникальный идентификатор вложения.

Возвращаемое значение

Тело
Attachment

Получение журнала записи

Получите полный журнал версий записи.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор записи
record_id True string

Уникальный идентификатор записи, журнал которой требуется получить.

Возвращаемое значение

Получение записи

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

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор записи
record_id True string

Уникальный идентификатор извлекаемой записи.

Возвращаемое значение

Получение исходного файла видео

Скачайте исходный видеофайл.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор видео
video_id True string

Уникальный идентификатор видео.

Возвращаемое значение

response
binary

Получение исходного файла звука

Скачайте исходный звуковой файл.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор звука
audio_id True string

Уникальный идентификатор звукового файла.

Возвращаемое значение

response
binary

Получение исходного файла подписи

Скачайте исходный файл подписи.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор подписи
signature_id True string

Уникальный идентификатор подписи.

Возвращаемое значение

response
binary

Получение исходного файла фотографии

Скачайте исходный файл фотографии.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор фотографии
photo_id True string

Уникальный идентификатор фотографии.

Возвращаемое значение

response
binary

Получение исходного файла эскиза

Скачайте исходный файл эскиза.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор эскиза
sketch_id True string

Идентификатор эскиза

Возвращаемое значение

response
binary

Получение метаданных подписи

Получение метаданных для одной подписи.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор подписи
signature_id True string

Уникальный идентификатор подписи.

Возвращаемое значение

Получение метаданных фотографии

Получение метаданных для одной фотографии.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор фотографии
photo_id True string

Уникальный идентификатор фотографии.

Возвращаемое значение

Получение метаданных эскиза

Получение метаданных для одного эскиза.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор эскиза
sketch_id True string

Идентификатор эскиза

Возвращаемое значение

Получение списка записей

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

Параметры

Имя Ключ Обязательно Тип Описание
Самые новые первые
newest_first boolean

При наличии записи будут отсортированы по updated_at дате.

Ограничивающий прямоугольник
bounding_box string

Ограничивающий прямоугольник запрошенных записей. Формат должен быть: lat,long,lat,long (нижний, левый, верхний, правый).

Идентификатор набора изменений
changeset_id string

Идентификатор набора изменений, связанного с записью.

ИД формы
form_id string

Идентификатор формы, с которой связана запись. При выходе из этого поля запрос будет запрашиваться для всех записей.

Идентификатор проекта
project_id string

Идентификатор проекта, с которым связана запись. При выходе из этого поля запрос будет запрашиваться для всех записей.

Клиент, созданный ранее
client_created_before date-time

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

Клиент создан с момента создания
client_created_since date-time

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

Клиент обновлен до
client_updated_before date-time

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

Клиент обновлен с момента обновления
client_updated_since date-time

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

Создано раньше
created_before date-time

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

Создано с момента создания
created_since date-time

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

Обновлено до
updated_before date-time

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

Обновлено с момента
updated_since date-time

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

Страница
page integer

Запрошенный номер страницы

На страницу
per_page integer

Количество элементов на странице

Возвращаемое значение

Тело
RecordsResponse

Получение списка метаданных аудио

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

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор записи
record_id string

Идентификатор записи, с которой связан звуковой файл.

ИД формы
form_id string

Идентификатор формы, с которой связан звуковой файл. Оставляя это пустое, запросит все звуковые файлы.

Самые новые первые
newest_first boolean

При наличии звуковые файлы будут отсортированы по updated_at дате.

Обработано
processed boolean

Фильтруйте аудиофайлы, которые были полностью обработаны.

Запасенный
stored boolean

Фильтруйте аудиофайлы, которые были полностью сохранены.

Загружено
uploaded boolean

Фильтруйте аудиофайлы, которые были полностью отправлены.

Страница
page integer

Запрошенный номер страницы.

На страницу
per_page integer

Количество элементов, возвращаемых на страницу.

Возвращаемое значение

Тело
AudiosResponse

Получение списка метаданных видео

Получение метаданных для списка видео.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор записи
record_id string

Идентификатор записи, с которой связан видео.

ИД формы
form_id string

Идентификатор формы, с которой связан видео. При выходе из этого поля запрос будет запрашиваться для всех ваших видео.

Самые новые первые
newest_first boolean

При наличии видео будет отсортировано по дате updated_at.

Обработано
processed boolean

Фильтруйте видео, которые были полностью обработаны.

Запасенный
stored boolean

Фильтруйте видео, которые были полностью сохранены.

Загружено
uploaded boolean

Фильтруйте видео, которые были полностью загружены.

Страница
page integer

Запрошенный номер страницы.

На страницу
per_page integer

Количество элементов, возвращаемых на страницу.

Возвращаемое значение

Тело
VideosResponse

Получение списка метаданных вложений

Получение списка вложений.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор записи
record_id string

Идентификатор записи, с которой связано вложение. Это необходимо при перечислении вложений записей.

ИД формы
form_id string

Идентификатор формы, с которой связано вложение. Этот параметр позволяет получить все ссылочные файлы в форме, НЕ все вложения записей в форме

Тип владельца
owner_type string

Тип вложения для запроса. Должен быть либоform.record

Сортировать
sort string

Поле для сортировки результатов по.

Направление сортировки
sort_direction string

Направление сортировки (asc, desc). Значение по умолчанию — asc.

Возвращаемое значение

Получение списка метаданных подписи

Получение метаданных для списка подписей.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор записи
record_id string

Идентификатор записи, с которой связана фотография.

ИД формы
form_id string

Идентификатор формы, с которой связана фотография. Оставляя это пустое, запросит все ваши фотографии.

Самые новые первые
newest_first boolean

При наличии фотографии будут отсортированы по updated_at дате.

Обработано
processed boolean

Фильтрация подписей, которые были полностью обработаны.

Запасенный
stored boolean

Фильтр для подписей, которые были полностью сохранены.

Загружено
uploaded boolean

Фильтруйте подписи, которые были полностью отправлены.

Страница
page integer

Запрошенный номер страницы.

На страницу
per_page integer

Количество элементов, возвращаемых на страницу.

Возвращаемое значение

Получение списка метаданных фотографии

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

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор записи
record_id string

Идентификатор записи, с которой связана фотография.

ИД формы
form_id string

Идентификатор формы, с которой связана фотография. Оставляя это пустое, запросит все ваши фотографии.

Самые новые первые
newest_first boolean

При наличии фотографии будут отсортированы по updated_at дате.

Обработано
processed boolean

Фильтр для фотографий, которые были полностью обработаны.

Запасенный
stored boolean

Фильтр для фотографий, которые были полностью сохранены.

Загружено
uploaded boolean

Фильтруйте фотографии, которые были полностью загружены.

Страница
page integer

Запрошенный номер страницы.

На страницу
per_page integer

Количество элементов, возвращаемых на страницу.

Возвращаемое значение

Тело
PhotosResponse

Получение списка метаданных эскиза

Получение метаданных для списка эскизов.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор записи
record_id string

Идентификатор записи, с которой связан эскиз.

ИД формы
form_id string

Идентификатор формы, с которой связан эскиз. Оставляя это пустое, запросит все ваши эскизы.

Самые новые первые
newest_first boolean

При наличии эскизы будут отсортированы по updated_at дате.

Обработано
processed boolean

Эскиз полностью обработан.

Запасенный
stored boolean

Эскиз полностью сохранен.

Загружено
uploaded boolean

Эскиз был полностью загружен.

Страница
page integer

Запрошенный номер страницы

На страницу
per_page integer

Количество элементов на странице

Возвращаемое значение

Тело
SketchesResponse

Получение файла отчета

Скачайте созданный PDF-файл отчета.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор отчета
report_id True uuid

Уникальный идентификатор отчета.

Возвращаемое значение

response
binary

Создание записи

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

Параметры

Имя Ключ Обязательно Тип Описание
Тип контента
Content-Type string

Тип контента

X Skipworkflows
X-SkipWorkflows boolean

Пропускает все рабочие процессы приложений

X Skipwebhooks
X-SkipWebhooks boolean

Пропускает все веб-перехватчики приложений

assigned_to_id
assigned_to_id string

Идентификатор пользователя, назначенного этой записи

form_id
form_id True string

Идентификатор формы, к которой принадлежит эта запись

form_values
form_values object

Значения полей, ключом поля

Координаты
coordinates True

Координаты геометрии. Формат зависит от типа: точка использует [долготу, широту], LineString использует массив позиций, Polygon использует массив линейных кругов (сначала внешний, остальные — отверстия), многотипные типы используют массивы их соответствующих структур координат.

тип
type True string

Тип геометрии GeoJSON

широта
latitude number

Координата широты

долгота
longitude number

Координата долготы

project_id
project_id string

Идентификатор проекта

статус
status string

Состояние записи

Возвращаемое значение

Создание запроса POST

Выполнение запроса API запроса с помощью HTTP POST. Предоставьте SQL-запрос, например запрос к данным вашей организации.

Параметры

Имя Ключ Обязательно Тип Описание
Страница
page integer

Запрошенный номер страницы.

На страницу
per_page integer

Количество элементов, возвращаемых на страницу.

format
format string

Формат ответа

q
q True string

SQL-запрос для выполнения

имя_таблицы
table_name string

Имя таблицы для запроса

Создание отчета

При необходимости создайте новый отчет для определенной записи с помощью шаблона отчета.

Параметры

Имя Ключ Обязательно Тип Описание
record_id
record_id True uuid

Идентификатор записи для создания отчета

идентификатор_шаблона
template_id uuid

Идентификатор шаблона отчета для использования (необязательно)

Возвращаемое значение

Тело
ReportResponse

Удалить запись

Удаление записи из организации.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор записи
record_id True string

Уникальный идентификатор записи для удаления.

X Skipworkflows
X-SkipWorkflows boolean

Пропускает все рабочие процессы приложений

X Skipwebhooks
X-SkipWebhooks boolean

Пропускает все веб-перехватчики приложений

Возвращаемое значение

Частичное обновление записи

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

Параметры

Имя Ключ Обязательно Тип Описание
Тип контента
Content-Type string

Тип контента

Идентификатор записи
record_id True string

Код записи

X Skipworkflows
X-SkipWorkflows boolean

Пропускает все рабочие процессы приложений

X Skipwebhooks
X-SkipWebhooks boolean

Пропускает все веб-перехватчики приложений

assigned_to_id
assigned_to_id string

Идентификатор пользователя, назначенного этой записи

form_values
form_values object

Значения полей, ключом поля

Координаты
coordinates True

Координаты геометрии. Формат зависит от типа: точка использует [долготу, широту], LineString использует массив позиций, Polygon использует массив линейных кругов (сначала внешний, остальные — отверстия), многотипные типы используют массивы их соответствующих структур координат.

тип
type True string

Тип геометрии GeoJSON

широта
latitude number

Координата широты

долгота
longitude number

Координата долготы

project_id
project_id string

Идентификатор проекта

статус
status string

Состояние записи

Возвращаемое значение

Триггеры

При возникновении события Fulcrum

Активирует при создании, обновлении или удалении ресурсаFulcrum. Поддерживает события для записей, форм, списков выбора и наборов классификации. Настройте веб-перехватчик в организации Fulcrum, чтобы указать, какие события следует отслеживать.

При возникновении события Fulcrum

Активирует при создании, обновлении или удалении ресурсаFulcrum. Поддерживает события для записей, форм, списков выбора и наборов классификации. Настройте веб-перехватчик в организации Fulcrum, чтобы указать, какие события следует отслеживать.

Параметры

Имя Ключ Обязательно Тип Описание
Тип контента
Content-Type string

Тип контента

активный
active boolean

Включена ли веб-перехватчик

Имя веб-перехватчика
name True string

Отображаемое имя веб-перехватчика

run_for_bulk_actions
run_for_bulk_actions boolean

Выполняется ли веб-перехватчик для действий массовой записи

Возвращаемое значение

Полезные данные события веб-перехватчика из Fulcrum

Определения

Вложение

Имя Путь Тип Описание
attached_to_id
attached_to_id string

Идентификатор ресурса, к которому присоединено вложение

attached_to_type
attached_to_type string

Тип ресурса, к которому присоединено вложение

complete
complete boolean

Завершена ли отправка вложения

file_size
file_size integer

Размер файла вложения в байтах

id
id string

Уникальный идентификатор для вложения

имя
name string

Имя файла вложения

owners
owners array of object

Список ссылок владельца для вложения

id
owners.id string

Идентификатор владельца

тип
owners.type string

Тип владельца (например, "запись" или "форма")

статус
status string

Состояние вложения

uploaded_at
uploaded_at date-time

Метка времени отправки вложения

URL-адрес
url uri

URL-адрес для доступа к вложению

ВложенияResponse

Имя Путь Тип Описание
attachments
attachments array of Attachment
итог
total integer

Общее количество возвращенных вложений

total_count
total_count integer

Общее количество доступных вложений

Аудио

Имя Путь Тип Описание
access_key
access_key string

Уникальный идентификатор для звукового ресурса

content_type
content_type string

Тип MIME звукового файла

создано_в
created_at date-time

Метка времени создания звука

создано пользователем
created_by string

Отображаемое имя пользователя, создавшего звук

created_by_id
created_by_id string

Идентификатор пользователя, создавшего звук

deleted_at
deleted_at date-time

Метка времени удаления звука

file_size
file_size integer

Размер звукового файла в байтах

form_id
form_id string

Идентификатор связанной формы

medium
medium uri

URL-адрес для средней версии звука (при обработке)

metadata
metadata object

Метаданные звука (например, длительность, сведения о формате)

Исходный текст
original uri

URL-адрес исходного звукового файла (при хранении)

обработанный
processed boolean

Обрабатывается ли звук

record_id
record_id string

Идентификатор связанной записи

маленький
small uri

URL-адрес для небольшой версии звука (при обработке)

статус
status string

Состояние обработки звука

Хранятся
stored boolean

Хранится ли звук

track
track uri

URL-адрес для доступа к звуковой дорожке (при наличии)

updated_at
updated_at date-time

Метка времени последнего обновления звука

updated_by
updated_by string

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

updated_by_id
updated_by_id string

Идентификатор пользователя, который последний раз обновил звук

Загружены
uploaded boolean

Был ли отправлен звук

URL-адрес
url uri

URL-адрес для доступа к звуковому ресурсу

AudiosResponse

Имя Путь Тип Описание
audio
audio array of Audio
current_page
current_page integer
per_page
per_page integer
total_count
total_count integer
total_pages
total_pages integer

AuditLocation

Метаданные расположения, захваченные во время создания или обновления.

Имя Путь Тип Описание
высота
altitude double

Высота в метрах.

horizontal_accuracy
horizontal_accuracy double

Горизонтальная точность в метрах.

широта
latitude double

Координата широты.

долгота
longitude double

Координата долготы.

Геометрия

Имя Путь Тип Описание
Координаты
coordinates

Координаты геометрии. Формат зависит от типа: точка использует [долготу, широту], LineString использует массив позиций, Polygon использует массив линейных кругов (сначала внешний, остальные — отверстия), многотипные типы используют массивы их соответствующих структур координат.

тип
type string

Тип геометрии GeoJSON

Фото

Имя Путь Тип Описание
access_key
access_key string

Уникальный идентификатор фотографии

content_type
content_type string

Тип MIME фотографии

создано_в
created_at date-time

Когда была создана фотография

создано пользователем
created_by string

Отображаемое имя пользователя, создавшего фотографию

created_by_id
created_by_id string

Идентификатор пользователя, создавшего фотографию

deleted_at
deleted_at date-time

Когда фотография была удалена

exif
exif object

Метаданные EXIF из фотографии

file_size
file_size integer

Размер файла фотографии в байтах

form_id
form_id string

Идентификатор связанной формы

большой
large uri

URL-адрес для большой версии фотографии

широта
latitude double

Координата широты, где была сделана фотография

долгота
longitude double

Координата долготы, где была сделана фотография

Исходный текст
original uri

URL-адрес исходной версии фотографии

обработанный
processed boolean

Была ли обработана фотография

record_id
record_id string

Идентификатор связанной записи

Хранятся
stored boolean

Хранится ли фотография

Миниатюру
thumbnail uri

URL-адрес для версии эскиза фотографии

updated_at
updated_at date-time

После последнего обновления фотографии

updated_by
updated_by string

Отображаемое имя пользователя, который последний раз обновил фотографию

updated_by_id
updated_by_id string

Идентификатор пользователя, который последний раз обновил фотографию

Загружены
uploaded boolean

Была ли загружена фотография

URL-адрес
url uri

URL-адрес API для этого ресурса фотографии

PhotoResponse

Имя Путь Тип Описание
current_page
current_page integer
per_page
per_page integer
photos
photos array of Photo
total_count
total_count integer
total_pages
total_pages integer

Запись

Имя Путь Тип Описание
высота
altitude number
assigned_to
assigned_to string
assigned_to_id
assigned_to_id string
client_created_at
client_created_at date-time
client_updated_at
client_updated_at date-time
курс
course number
создано_в
created_at date-time
создано пользователем
created_by string
created_by_id
created_by_id string
created_duration
created_duration number
created_location
created_location AuditLocation

Метаданные расположения, захваченные во время создания или обновления.

edited_duration
edited_duration number
form_id
form_id string
form_values
form_values object

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

геометрия
geometry Geometry
horizontal_accuracy
horizontal_accuracy number
id
id string
широта
latitude number
долгота
longitude number
project_id
project_id string
record_series_id
record_series_id string
speed
speed number
статус
status string
system_status
system_status string
updated_at
updated_at date-time
updated_by
updated_by string
updated_by_id
updated_by_id string
updated_duration
updated_duration number
updated_location
updated_location AuditLocation

Метаданные расположения, захваченные во время создания или обновления.

version
version integer
vertical_accuracy
vertical_accuracy number

RecordHistoryItem

Имя Путь Тип Описание
высота
altitude double

Запись высоты в метрах

assigned_to
assigned_to string

Отображаемое имя назначенного пользователя

assigned_to_id
assigned_to_id string

Идентификатор назначенного пользователя

changeset_id
changeset_id string

Идентификатор набора изменений

client_created_at
client_created_at date-time

Метка времени создания на стороне клиента

client_updated_at
client_updated_at date-time

Метка времени обновления на стороне клиента

курс
course double

Курс/заголовок в градусах

создано_в
created_at date-time

Метка времени создания записи

создано пользователем
created_by string

Отображаемое имя пользователя, создавшего запись

created_by_id
created_by_id string

Идентификатор пользователя, создавшего запись

created_duration
created_duration integer

Длительность создания записи в секундах

created_location
created_location AuditLocation

Метаданные расположения, захваченные во время создания или обновления.

edited_duration
edited_duration integer

Общая длительность редактирования в секундах

form_id
form_id string

Идентификатор формы

form_values
form_values object

Значения полей формы (обработанные)

form_version
form_version integer

Версия формы во время создания и обновления записи

Координаты
geometry.coordinates array of number
тип
geometry.type string
history_change_type
history_change_type string

Тип изменения (c=create, u=update, d=delete)

history_changed_by
history_changed_by string

Отображаемое имя пользователя, который сделал это изменение

history_changed_by_id
history_changed_by_id string

Идентификатор пользователя, который сделал это изменение

history_created_at
history_created_at date-time

Метка времени создания записи журнала

history_id
history_id string

Идентификатор записи журнала

horizontal_accuracy
horizontal_accuracy double

Горизонтальная точность в метрах

id
id string

Код записи

широта
latitude double

Широта расположения записи

долгота
longitude double

Запись расположения долготы

project_id
project_id string

Код проекта

record_key
record_key string

Необязательный ключ записи

record_sequence
record_sequence integer

Необязательный номер последовательности записей

последовательность
sequence integer

Порядковый номер (при использовании разбиения на страницы на основе последовательности)

speed
speed double

Скорость во время создания записи в м/с

статус
status string

Состояние записи

updated_at
updated_at date-time

Запись метки времени последнего обновления

updated_by
updated_by string

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

updated_by_id
updated_by_id string

Идентификатор пользователя, который последний раз обновил запись

updated_duration
updated_duration integer

Длительность обновления записи в секундах

updated_location
updated_location AuditLocation

Метаданные расположения, захваченные во время создания или обновления.

version
version integer

Номер версии записи

vertical_accuracy
vertical_accuracy double

Вертикальная точность в метрах

RecordHistoryResponse

Имя Путь Тип Описание
current_page
current_page integer

Текущий номер страницы (при использовании разбиения на страницы)

next_sequence
next_sequence integer

Следующий номер последовательности (при использовании разбиения на страницы на основе последовательности)

per_page
per_page integer

Количество записей на страницу (при использовании разбиения на страницы)

Записи
records array of RecordHistoryItem
total_count
total_count integer

Общее количество записей (при использовании разбиения на страницы)

total_pages
total_pages integer

Общее количество страниц (при использовании разбиения на страницы)

RecordsResponse

Имя Путь Тип Описание
current_page
current_page integer
per_page
per_page integer
Записи
records array of Record
total_count
total_count integer
total_pages
total_pages integer

ReportResponse

Имя Путь Тип Описание
завершено_в
report.completed_at date-time

Метка времени завершения создания отчета

создано_в
report.created_at date-time

Метка времени создания отчета

не удалось в
report.failed_at date-time

Метка времени при сбое создания отчета (значение NULL при успешном выполнении)

id
report.id uuid

Уникальный идентификатор отчета

record_id
report.record_id uuid

Идентификатор записи, для который был создан отчет

started_at
report.started_at date-time

Метка времени начала создания отчета

государство
report.state string

Состояние отчета

идентификатор_шаблона
report.template_id uuid

Идентификатор шаблона, используемого для создания отчета

updated_at
report.updated_at date-time

Метка времени последнего обновления отчета

URL-адрес
report.url uri

URL-адрес для скачивания созданного отчета

Signature

Имя Путь Тип Описание
access_key
access_key string

Уникальный идентификатор для подписи

content_type
content_type string

Тип MIME файла подписи

создано_в
created_at date-time

Метка времени создания подписи

создано пользователем
created_by string

Отображаемое имя пользователя, создавшего подпись

created_by_id
created_by_id string

Идентификатор пользователя, создавшего подпись

deleted_at
deleted_at date-time

Метка времени удаления подписи

file_size
file_size integer

Размер файла подписи в байтах

form_id
form_id string

Идентификатор связанной формы

большой
large uri

URL-адрес большой версии сигнатуры

Исходный текст
original uri

URL-адрес исходного файла подписи

обработанный
processed boolean

Выполняется ли обработка подписи

record_id
record_id string

Идентификатор связанной записи

Хранятся
stored boolean

Хранится ли подпись

Миниатюру
thumbnail uri

URL-адрес для версии эскиза подписи

updated_at
updated_at date-time

Метка времени последнего обновления подписи

updated_by
updated_by string

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

updated_by_id
updated_by_id string

Идентификатор пользователя, который последний раз обновил подпись

Загружены
uploaded boolean

Указывает, была ли отправлена подпись

URL-адрес
url uri

URL-адрес API для получения этой подписи

SignaturesResponse

Имя Путь Тип Описание
current_page
current_page integer
per_page
per_page integer
Подписи
signatures array of Signature
total_count
total_count integer
total_pages
total_pages integer

SinglePhotoResponse

Имя Путь Тип Описание
photo;
photo Photo

SingleRecordResponse

Имя Путь Тип Описание
запись
record Record

SingleSignatureResponse

Имя Путь Тип Описание
подпись
signature Signature

SingleSketchResponse

Имя Путь Тип Описание
Эскиз
sketch Sketch

Эскиз

Имя Путь Тип Описание
access_key
access_key string

Уникальный идентификатор эскиза

content_type
content_type string

Тип MIME файла эскиза

создано_в
created_at date-time

Метка времени создания эскиза

создано пользователем
created_by string

Отображаемое имя пользователя, создавшего эскиз

created_by_id
created_by_id string

Идентификатор пользователя, создавшего эскиз

exif
exif object

Метаданные EXIF из эскиза

file_size
file_size integer

Размер файла эскиза в байтах

form_id
form_id string

Идентификатор связанной формы

большой
large uri

URL-адрес для большой версии эскиза

medium
medium uri

URL-адрес для средней версии эскиза

Исходный текст
original uri

URL-адрес исходной версии эскиза

обработанный
processed boolean

Был ли обработан эскиз

record_id
record_id string

Идентификатор связанной записи

маленький
small uri

URL-адрес для небольшой версии эскиза

Хранятся
stored boolean

Хранится ли эскиз

Миниатюру
thumbnail uri

URL-адрес для версии эскиза эскиза

updated_at
updated_at date-time

Метка времени последнего обновления эскиза

updated_by
updated_by string

Отображаемое имя пользователя, который последний раз обновил эскиз

updated_by_id
updated_by_id string

Идентификатор пользователя, который последний раз обновил эскиз

Загружены
uploaded boolean

Был ли отправлен эскиз

URL-адрес
url uri

URL-адрес API для доступа к этому ресурсу эскиза

SketchesResponse

Имя Путь Тип Описание
current_page
current_page integer
per_page
per_page integer
Эскизы
sketches array of Sketch
total_count
total_count integer
total_pages
total_pages integer

Video

Имя Путь Тип Описание
access_key
access_key string

Уникальный идентификатор видео

content_type
content_type string

Тип MIME видеофайла

создано_в
created_at date-time

Метка времени создания видео

создано пользователем
created_by string

Отображаемое имя пользователя, создавшего видео

created_by_id
created_by_id string

Идентификатор пользователя, создавшего видео

deleted_at
deleted_at date-time

Метка времени удаления видео

file_size
file_size integer

Размер видеофайла в байтах

form_id
form_id string

Идентификатор связанной формы

medium
medium uri

URL-адрес для средней версии видео

metadata
metadata object

Дополнительные метаданные о видео

Исходный текст
original uri

URL-адрес исходного видеофайла

обработанный
processed boolean

Будет ли обработано видео

record_id
record_id string

Идентификатор связанной записи

маленький
small uri

URL-адрес для небольшой версии видео

статус
status string

Состояние обработки видео

Хранятся
stored boolean

Хранится ли видео

thumbnail_huge
thumbnail_huge uri

URL-адрес для огромного изображения эскиза

thumbnail_huge_square
thumbnail_huge_square uri

URL-адрес для огромного эскиза квадратного изображения

thumbnail_large
thumbnail_large uri

URL-адрес для большого изображения эскиза

thumbnail_large_square
thumbnail_large_square uri

URL-адрес для изображения большого квадратного эскиза

thumbnail_medium
thumbnail_medium uri

URL-адрес для изображения среднего эскиза

thumbnail_medium_square
thumbnail_medium_square uri

URL-адрес на изображение эскиза среднего квадрата

thumbnail_small
thumbnail_small uri

URL-адрес для небольшого эскиза изображения

thumbnail_small_square
thumbnail_small_square uri

URL-адрес для изображения небольшого квадратного эскиза

track
track uri

URL-адрес данных видео отслеживания в формате JSON, если он доступен

updated_at
updated_at date-time

Метка времени последнего обновления видео

updated_by
updated_by string

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

updated_by_id
updated_by_id string

Идентификатор пользователя, который последний раз обновил видео

Загружены
uploaded boolean

Будет ли отправлено видео

URL-адрес
url uri

URL-адрес API для доступа к этому ресурсу видео

ВидеоResponse

Имя Путь Тип Описание
current_page
current_page integer
per_page
per_page integer
total_count
total_count integer
total_pages
total_pages integer
videos
videos array of Video

FulcrumWebhookPayload

Полезные данные события веб-перехватчика из Fulcrum

Имя Путь Тип Описание
Идентификатор события
id string

Уникальный идентификатор события

Тип события
type string

Тип события (например, record.create, record.update, record.delete, form.create, form.update, form.delete, form.delete, choice_list.create, choice_list.update, choice_list.delete, classification_set.create, classification_set.update, classification_set.delete)

Идентификатор ответственного
owner_id string

Идентификатор организации, которая владеет этим веб-перехватчиком

Данные о событиях
data object

Данные записи или ресурса, связанные с событием

Создано в
created_at date-time

Метка времени при возникновении события

бинарный

Это базовый тип данных binary.