# Данные грузоперевозок

Расширение ITSPM данные грузоперевозок - это библиотека по взаимодействию с данными грузоперевозок, заявок, заказов

[![image.png](https://wiki.accounter.org/uploads/images/gallery/2025-04/scaled-1680-/4RVimage.png)](https://wiki.accounter.org/uploads/images/gallery/2025-04/4RVimage.png)

В расширении имеется примеры с использованием самых простых функций модуля.   
Все примеры на форме обработки "**ITSPM\_ДанныеГрузоперевозок\_Пример**".  
Где можно интерактивно добавить список грузоперевозок и список параметров для получения.

[![image.png](https://wiki.accounter.org/uploads/images/gallery/2025-03/scaled-1680-/r7cimage.png)](https://wiki.accounter.org/uploads/images/gallery/2025-03/r7cimage.png)  
Разные кнопки получают одни и те же данные разыми способами:  
**ПолучитьЗначениеГрузоперевозки** - возвращает значение одного параметра для одной грузоперевозки  
**ПолучитьЗначениеГрузоперевозок** - возвращает соответствие: грузоперевозка -> значение одного параметра  
**ПолучитьЗначенияГрузоперевозки** - возвращает строку табличной части с значениями параметров для N грузоперевозок  
**ПолучитьЗначенияГрузоперевозок** - возвращает либо соответствие (1) грузоперевозка -> строка табличной части с значениями параметров, либо таблицу значения (2) с данными N грузоперевозок и N параметров

<details id="bkmrk-%D0%9A%D0%BE%D0%BD%D1%82%D1%80%D0%BE%D0%BB%D1%8C%D0%BD%D1%8B%D0%B5-%D0%B4%D0%B0%D1%82%D1%8B-%D0%94%D0%BB%D1%8F"><summary>Контрольные даты</summary>

Для варианта с использованием данных (план/факт) из контрольных дат сделаны отдельные кнопки.   
Поскольку для контрольных дат можно хранить 3 значения: План, Факт и Значение

[![image.png](https://wiki.accounter.org/uploads/images/gallery/2025-03/scaled-1680-/pMNimage.png)](https://wiki.accounter.org/uploads/images/gallery/2025-03/pMNimage.png)

Функция **ПолучитьИмяПоляПараметраДляКомпоновки** вернет соответствующее аспекту имя поля.  
[![image.png](https://wiki.accounter.org/uploads/images/gallery/2025-03/scaled-1680-/5Rzimage.png)](https://wiki.accounter.org/uploads/images/gallery/2025-03/5Rzimage.png)

А функции ПолучитьЗначениеГрузоперевозки указание того нужен ли вам план, факт или значение зашито в саму функцию получения параметра.  
[![image.png](https://wiki.accounter.org/uploads/images/gallery/2025-03/scaled-1680-/Mneimage.png)](https://wiki.accounter.org/uploads/images/gallery/2025-03/Mneimage.png)

</details>Ключевое отличие от соответствующих стандартных функций (**ЗначениеРеквизитаОбъекта** и пр.) это упор на параметры грузоперевозок.   
Имея просто ссылку на параметр и ссылку на грузоперевозку - можно получить значение в одно действие.   
\- Запрос будет делаться используя схему компоновки данных.  
\- Значение будет иметь тот тип значения который предполагается переданным параметром.  
\- Помимо данных самой грузоперевозки можно получить такие данные как МониторинговыйСтатус, \_ФинансовыйСтатус, ДатаЗакрытияМониторинга и ДатаЗакрытияФинансов

[![image.png](https://wiki.accounter.org/uploads/images/gallery/2025-03/scaled-1680-/ty2image.png)](https://wiki.accounter.org/uploads/images/gallery/2025-03/ty2image.png)

<details id="bkmrk-%D0%9F%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80%D1%8B-%D0%BF%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80%D0%BE%D0%B2"><summary>Параметры параметров</summary>

Так же запрашиваемы поля могут быть более сложными например такой:  
Ссылка.\[(пг) Партнер\].\[Адрес для отправки заявок (Контрагенты)\]

[![image.png](https://wiki.accounter.org/uploads/images/gallery/2025-03/scaled-1680-/5Shimage.png)](https://wiki.accounter.org/uploads/images/gallery/2025-03/5Shimage.png)Где параметр грузоперевозки с названием "Партнер" имеет тип значения контрагент, который в свою очередь позволяет получить данные в том числе и дополнительных реквизитов контрагента.

[![image.png](https://wiki.accounter.org/uploads/images/gallery/2025-03/scaled-1680-/D63image.png)](https://wiki.accounter.org/uploads/images/gallery/2025-03/D63image.png)

</details><details id="bkmrk-%D0%9F%D0%BE%D0%BB%D1%83%D1%87%D0%B8%D1%82%D1%8C-%D0%B7%D0%BD%D0%B0%D1%87%D0%B5%D0%BD%D0%B8%D1%8F-%D0%9F%D1%80"><summary>Функции "Получить значения" и имена колонок</summary>

При использовании функций **ПолучитьЗначенияГрузоперевозки** и **ПолучитьЗначенияГрузоперевозок**  
Вы можете столкнуться с тем, что список полей вы отправляете такой

[![image.png](https://wiki.accounter.org/uploads/images/gallery/2025-03/scaled-1680-/lcJimage.png)](https://wiki.accounter.org/uploads/images/gallery/2025-03/lcJimage.png)

А имена колонок получаются вот такие.

[![image.png](https://wiki.accounter.org/uploads/images/gallery/2025-03/scaled-1680-/qOjimage.png)](https://wiki.accounter.org/uploads/images/gallery/2025-03/qOjimage.png)  
  
Для этого и нужна функция **ПолучитьСоответствиеПолейДляРезультата** которая вернет вам соответствие того что вы отправляли для получения данных и имена колонок в результате.

[![image.png](https://wiki.accounter.org/uploads/images/gallery/2025-03/scaled-1680-/WTMimage.png)](https://wiki.accounter.org/uploads/images/gallery/2025-03/WTMimage.png)

</details><details id="bkmrk-%D0%97%D0%B0%D0%BF%D0%B8%D1%81%D1%8C-%D0%B4%D0%B0%D0%BD%D0%BD%D1%8B%D1%85-%D0%B3%D1%80%D1%83%D0%B7%D0%BE%D0%BF"><summary>Запись данных грузоперевозок</summary>

В модуле есть раздел с записью грузоперевозок.   
Скорее всего раздел работает, но он не протестирован должным образом на совместимость с некоторыми другими проектами в работе.   
Плюс к этому я еще не написал для них примеров использования.   
Можно сказать это бета-тест  
![image.png](https://wiki.accounter.org/uploads/images/gallery/2025-03/scaled-1680-/mgQimage.png)  
Ключевые функции этого раздела   
УстановитьЗначениеПараметраГП и УстановитьЗначениеПараметраГП\_ПоИсточнику  
Разница между ними в том, что УстановитьЗначениеПараметраГП сама получает объект и записывает в него данные.  
А УстановитьЗначениеПараметраГП\_ПоИсточнику принимает в себя справочник-объект и вводит изменения в этот объект не записывая его - используется если нужно изменить 2 и более параметра в одной грузоперевозке.

</details>