Changes for page Методы API для работы с ГЛОНАССSoft

Last modified by Андрей Калиновский on 2025/01/14 11:58

From version < 199.1 >

edited by Андрей Калиновский
on 2024/12/20 15:58

To version < 195.1 >

edited by Андрей Калиновский
on 2024/12/20 13:14

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

@@ -2,6 +2,10 @@
  (((
  (% class="box warningmessage" %)
  (((
++
++
++
++
  (% class="mark" %)##Для обеспечения бесперебойной работы команд и серверного оборудования ГЛОНАССSoft убедительно
  просим вас соблюдать несколько простых правил при использовании API-команд:##
  )))
@@ -4674,75 +4674,8 @@
  = (% style="color:#000000; font-size:18.6667px" %)**Раздел: Сельскохозяйственные поля **(%%) =
++== **Получение участка по id** ==
--== **Возвращает список полей** ==
--
--(% class="box successmessage" %)
--(((
--POST **/api/v3/agroLands/find**
--)))
--
--Пример запроса:
--
--(((
--(((
--(((
--{
--  "year": 0, ~/~/ Фильтр по году
--  "name": "string", ~/~/ Фильтр по названию
--  "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Фильтр по подразделению
--}
--)))
--)))
--
--
--)))
--
--Пример ответа:
--
--(((
--[
--  {
--    "sqPlan": 0, ~/~/ Определяет площадь поля, Га.
--    "year": 0, ~/~/ Год поля
--    "startDate": "2024-12-20T12:27:07.523Z", ~/~/ Начало года урожая
--    "endDate": "2024-12-20T12:27:07.523Z", ~/~/ Конец года урожая
--    "status": 0, ~/~/ Статус с/х поля 0 - нет, 1 - открыто, 2 - закрыто
--    "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры
--    "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии
--    "counts": { ~/~/ Счётчики с/х поля
--      "fieldOperations": 0, ~/~/ Количество операций на поле
--      "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле
--      "facts": 0 ~/~/ Счётчик факта
--    },
--    "planState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой
--    "actualPlanState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой
--    "factState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой
--    "taskState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой
--    "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле
--    "sourceId": 0, ~/~/ Ссылка на участок прошлого года
--    "planComment": "string", ~/~/ Комментарий к полю
--    "productivity": 0, ~/~/ Урожайность.
--    "id": 0, ~/~/ Идентификатор объекта геозоны
--    "name": "string", ~/~/ Название объекта геозоны
--    "type": 0, ~/~/ Тип объекта геозоны
--    "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение
--    "fname": "string", ~/~/ Имя файла
--    "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента
--    "beginCalc": "2024-12-20T12:27:07.523Z", ~/~/ Дата начала расчетов для геозоны
--    "endCalc": "2024-12-20T12:27:07.523Z", ~/~/ Дата окончания расчетов для геозоны
--    "description": "string", ~/~/ Описание объекта геозоны
--    "area": 0, ~/~/ Площадь, м2
--    "perimetr": 0, ~/~/ Периметр, м
--    "createDate": "2024-12-20T12:27:07.523Z" ~/~/ Дата создания в бд
--  }
--]
--
--
--)))
--
--== **Получение поля по id** ==
--
  (% class="box infomessage" %)
  (((
  GET **/api/v3/agroLands/{id}**
@@ -4838,7 +4838,7 @@
  )))
--== **Удалить поле** ==
++== **Удалить участок** ==
  (% class="box errormessage" %)
  (((
@@ -4859,7 +4859,7 @@
  )))
  (((
--== **Сохранение поля** ==
++== **Сохранение участка** ==
  (% class="box successmessage" %)
  (((
@@ -4907,6 +4907,10 @@
  )))
++(((
++
++)))
++
  Пример ответа:
  (((
@@ -4998,20 +4998,22 @@
  )))
  (((
--== **Изменение поля** ==
++
++)))
--(% class="box infomessage" %)
  (((
--PUT **/api/v3/agroLands**
++== **Изменение участка** ==
++
++(% class="box successmessage" %)
++(((
++PUT /api/v3/agroLands
  )))
  Пример запроса:
  (((
--(((
  {
--  "id": 0, ~/~/ Идентификатор поля
--  "extId": "string", ~/~/ ExtId
++  "extId": "string",
    "shape": "string", ~/~/ Форма поля
    "shapeFormat": "string", ~/~/ Формат, в котором представлена форма поля
    "display": "string", ~/~/ Настройки отображения
@@ -5018,53 +5018,14 @@
    "year": 0, ~/~/ Год поля
    "name": "string", ~/~/ Наименование
    "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение
--  "startDate": "2024-12-20T10:11:59.425Z", ~/~/ Начало года урожая
--  "endDate": "2024-12-20T10:11:59.425Z", ~/~/ Конец года урожая
--  "planComment": "string", ~/~/Комментарий к полю
--  "cropRotations": [  ~/~/ Данные по севообороту
--    {
--      "landId": 0, ~/~/ ID поля
--      "landName": "string", ~/~/ Название поля
--      "year": 0, ~/~/ Год урожая
--      "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры
--      "cultureName": "string", ~/~/ Название культуры
--      "productivity": 0, ~/~/ Урожайность
--      "area": 0, ~/~/ Площадь поля, Га.
--      "total": 0, ~/~/ Валовый сбор
--      "productivityFact": 0, ~/~/ Фактическая урожайность
--      "areaFact": 0, ~/~/ Фактическая площадь поля, Га.
--      "totalFact": 0, ~/~/ Фактический валовый сбор
--      "start": "2024-12-20T10:11:59.425Z", ~/~/ Дата начала работ
--      "sowing": "2024-12-20T10:11:59.425Z", ~/~/ Дата сева
--      "harvesting": "2024-12-20T10:11:59.425Z", ~/~/ Дата уборки урожая
--      "isyearplan": true,
--      "comment": "string" ~/~/ Комментарий
--    }
--  ],
--  "deleteStatistic": true ~/~/ Нужно ли удалять статистику
--}
--)))
--)))
--
--(((
--
--)))
--
--Пример ответа:
--
--(((
--(((
--(((
--{
--  "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры
--  "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии
--  "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле
--  "sourceId": 0, ~/~/ Ссылка на участок прошлого года
++  "startDate": "2024-12-20T08:19:59.635Z", ~/~/ Начало года урожая
++  "endDate": "2024-12-20T08:19:59.635Z", ~/~/ Конец года урожая
++  "planComment": "string", ~/~/ Комментарий к полю
    "cropRotations": [ ~/~/ Данные по севообороту
      {
        "landId": 0, ~/~/ ID поля
        "landName": "string", ~/~/ Название поля
--      "year": 0, ~/~/  Год урожая
++      "year": 0, ~/~/ Год урожая
        "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры
        "cultureName": "string", ~/~/ Название культуры
        "productivity": 0, ~/~/ Урожайность
@@ -5073,92 +5073,21 @@
        "productivityFact": 0, ~/~/ Фактическая урожайность
        "areaFact": 0, ~/~/ Фактическая площадь поля, Га.
        "totalFact": 0, ~/~/ Фактический валовый сбор
--      "start": "2024-12-20T10:11:59.533Z", ~/~/ Дата начала работ
--      "sowing": "2024-12-20T10:11:59.533Z", ~/~/ Дата сева
--      "harvesting": "2024-12-20T10:11:59.533Z", ~/~/ Дата уборки урожая
--      "isyearplan": true, ~/~/
++      "start": "2024-12-20T08:19:59.635Z", ~/~/ Дата начала работ
++      "sowing": "2024-12-20T08:19:59.635Z", ~/~/ Дата сева
++      "harvesting": "2024-12-20T08:19:59.635Z", ~/~/ Дата уборки урожая
++      "isyearplan": true, ~/~/ Годовой план
        "comment": "string" ~/~/ Комментарий
      }
--  ],
--  "cropVegetation": [ ~/~/ История вегетации поля
--    {
--      "values": [ ~/~/ Данные вегетации и состояния посева
--        {
--          "date": "2024-12-20T10:11:59.533Z", ~/~/ Дата
--          "ndvi": 0 ~/~/ Индекс вегетации
--        }
--      ],
--      "resources": [ ~/~/ Данные о снимках для каждого значения NDVI
--        {
--          "date": "2024-12-20T10:11:59.533Z", ~/~/ Дата
--          "type": "string", ~/~/ Тип
--          "pictureid": "string" ~/~/ Идентификатор ресурса
--        }
--      ],
--      "states": [ ~/~/ Ключевые даты развития поля
--        {
--          "date": "2024-12-20T10:11:59.533Z", ~/~/ Дата
--          "state": 0 ~/~/ Статус 0 - Всходы, 1 - Вершина, 2 - Сбор урожая
--        }
--      ]
--    }
--  ],
--  "endDate": "2024-12-20T10:11:59.533Z", ~/~/ Дата закрытия года урожая
--  "counts": {
--    "fieldOperations": 0, ~/~/ Количество операций на поле
--    "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле
--    "facts": 0 ~/~/ Счётчик факта
--  },
--  "planComment": "string", ~/~/ Комментарий к полю
--  "productivity": 0, ~/~/ Урожайность.
--  "sqPlan": 0, ~/~/ Определяет площадь поля, Га.
--  "startDate": "2024-12-20T10:11:59.533Z", ~/~/ Дата открытия года урожая
--  "year": 0, ~/~/ Год поля
--  "planState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой
--  "actualPlanState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой
--  "factState": 0,  ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой
--  "taskState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой
--  "status": 0, ~/~/ Статус с/х поля 0 - нет, 1 - открыто, 2 - закрыто
--  "id": 0, ~/~/ Идентификатор объекта геозоны
--  "name": "string", ~/~/ Название объекта геозоны
--  "type": 0, ~/~/ Тип объекта геозоны
--  "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение
--  "fname": "string", ~/~/ Имя файла
--  "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента
--  "beginCalc": "2024-12-20T10:11:59.533Z", ~/~/ Дата начала расчетов для геозоны
--  "endCalc": "2024-12-20T10:11:59.533Z", ~/~/ Дата окончания расчетов для геозоны
--  "description": "string", ~/~/ Описание объекта геозоны
--  "area": 0, ~/~/ Площадь, м2
--  "perimetr": 0, ~/~/ Периметр, м
--  "createDate": "2024-12-20T10:11:59.533Z" ~/~/ Дата создания в бд
++  ]
  }
  )))
--)))
--)))
--)))
--)))
--
--== **Функция обновляет закрытие/открытие года урожая** ==
--
--(% class="box successmessage" %)
  (((
--POST **/api/v3/agroLands/updateOpenCloseYear**
++
  )))
--Пример запроса:
--
  (((
--(((
--{
--  "agroLandIds": [  ~/~/ Идентификаторы полей для которых меняется год урожая
--    0
--  ],
--  "newStartDate": "2024-12-20T11:43:43.921Z", ~/~/ Новая дата начала урожая
--  "newEndDate": "2024-12-20T11:43:43.921Z" ~/~/ Новая дата закрытия урожая
--}
--)))
--
  )))
@@ -5167,93 +5167,17 @@
  (((
  (((
  {
--  "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры
++  "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",  ~/~/ Идентификатор культуры
    "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии
--  "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле
--  "sourceId": 0, ~/~/ Ссылка на участок прошлого года
--  "cropRotations": [ ~/~/ Данные по севообороту
--    {
--      "landId": 0, ~/~/ ID поля
--      "landName": "string", ~/~/ Название поля
--      "year": 0, ~/~/ Год урожая
--      "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры
--      "cultureName": "string", ~/~/ Название культуры
--      "productivity": 0, ~/~/ Урожайность
--      "area": 0, ~/~/ Площадь поля, Га.
--      "total": 0, ~/~/ Валовый сбор
--      "productivityFact": 0, ~/~/ Фактическая урожайность
--      "areaFact": 0, ~/~/ Фактическая площадь поля, Га.
--      "totalFact": 0, ~/~/ Фактический валовый сбор
--      "start": "2024-12-20T11:43:44.091Z", ~/~/ Дата начала работ
--      "sowing": "2024-12-20T11:43:44.091Z", ~/~/ Дата сева
--      "harvesting": "2024-12-20T11:43:44.091Z", ~/~/ Дата уборки урожая
--      "isyearplan": true, ~/~/
--      "comment": "string" ~/~/ Комментарий
--    }
--  ],
--  "cropVegetation": [ ~/~/ История вегетации поля
--    {
--      "values": [ ~/~/ Данные вегетации и состояния посева
--        {
--          "date": "2024-12-20T11:43:44.091Z", ~/~/ Дата
--          "ndvi": 0 ~/~/ Индекс вегетации
--        }
--      ],
--      "resources": [ ~/~/ Данные о снимках для каждого значения NDVI
--        {
--          "date": "2024-12-20T11:43:44.091Z", ~/~/ Дата
--          "type": "string", ~/~/ Тип
--          "pictureid": "string" ~/~/ Идентификатор ресурса
--        }
--      ],
--      "states": [ ~/~/ Ключевые даты развития поля
--        {
--          "date": "2024-12-20T11:43:44.091Z", ~/~/ Дата
--          "state": 0 ~/~/ Статус 0 - Всходы, 1 - Вершина, 2 - Сбор урожая
--        }
--      ]
--    }
--  ],
--  "endDate": "2024-12-20T11:43:44.091Z", ~/~/ Дата закрытия года урожая
--  "counts": {
--    "fieldOperations": 0, ~/~/ Количество операций на поле
--    "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле
--    "facts": 0 ~/~/ Счётчик факта
--  },
--  "planComment": "string", ~/~/ Комментарий к полю
--  "productivity": 0, ~/~/ Урожайность.
--  "sqPlan": 0, ~/~/ Определяет площадь поля, Га.
--  "startDate": "2024-12-20T11:43:44.091Z", ~/~/ Дата открытия года урожая
--  "year": 0, ~/~/ Год поля
--  "planState": 0,  ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой
--  "actualPlanState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой
--  "factState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой
--  "taskState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой
--  "status": 0, ~/~/ Статус с/х поля 0 - нет, 1 - открыто, 2 - закрыто
--  "id": 0, ~/~/ Идентификатор объекта геозоны
--  "name": "string", ~/~/ Название объекта геозоны
--  "type": 0, ~/~/ Тип объекта геозоны
--  "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение
--  "fname": "string", ~/~/ Имя файла
--  "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента
--  "beginCalc": "2024-12-20T11:43:44.091Z", ~/~/ Дата начала расчетов для геозоны
--  "endCalc": "2024-12-20T11:43:44.091Z", ~/~/ Дата окончания расчетов для геозоны
--  "description": "string", ~/~/ Описание объекта геозоны
--  "area": 0, ~/~/ Площадь, м2
--  "perimetr": 0, ~/~/ ериметр, м
--  "createDate": "2024-12-20T11:43:44.091Z" ~/~/ Дата создания в бд
--}
++  "fieldId": 0, ~/~/ С
  )))
--
--
--==   ==
--
--(((
--
  )))
  )))
  )))
++
++
  )))
++)))
  = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Корзина**(%%) =

Changes for page Методы API для работы с ГЛОНАССSoft

Summary

Details

Меню