Данные грузоперевозок
Расширение ITSPM данные грузоперевозок - это библиотека по взаимодействию с данными грузоперевозок, заявок, заказов
В расширении имеется примеры с использованием самых простых функций модуля.
Все примеры на форме обработки "ITSPM_ДанныеГрузоперевозок_Пример".
Где можно интерактивно добавить список грузоперевозок и список параметров для получения.
Разные кнопки получают одни и те же данные разыми способами:
ПолучитьЗначениеГрузоперевозки - возвращает значение одного параметра для одной грузоперевозки
ПолучитьЗначениеГрузоперевозок - возвращает соответствие: грузоперевозка -> значение одного параметра
ПолучитьЗначенияГрузоперевозки - возвращает строку табличной части с значениями параметров для N грузоперевозок
ПолучитьЗначенияГрузоперевозок - возвращает либо соответствие (1) грузоперевозка -> строка табличной части с значениями параметров, либо таблицу значения (2) с данными N грузоперевозок и N параметров
Контрольные даты
Для варианта с использованием данных (план/факт) из контрольных дат сделаны отдельные кнопки.
Поскольку для контрольных дат можно хранить 3 значения: План, Факт и Значение
Функция ПолучитьИмяПоляПараметраДляКомпоновки вернет соответствующее аспекту имя поля.
А функции ПолучитьЗначениеГрузоперевозки указание того нужен ли вам план, факт или значение зашито в саму функцию получения параметра.
Ключевое отличие от соответствующих стандартных функций (ЗначениеРеквизитаОбъекта и пр.) это упор на параметры грузоперевозок.
Имея просто ссылку на параметр и ссылку на грузоперевозку - можно получить значение в одно действие.
- Запрос будет делаться используя схему компоновки данных.
- Значение будет иметь тот тип значения который предполагается переданным параметром.
- Помимо данных самой грузоперевозки можно получить такие данные как МониторинговыйСтатус, _ФинансовыйСтатус, ДатаЗакрытияМониторинга и ДатаЗакрытияФинансов
Параметры параметров
Так же запрашиваемы поля могут быть более сложными например такой:
Ссылка.[(пг) Партнер].[Адрес для отправки заявок (Контрагенты)]
Где параметр грузоперевозки с названием "Партнер" имеет тип значения контрагент, который в свою очередь позволяет получить данные в том числе и дополнительных реквизитов контрагента.
Функции "Получить значения" и имена колонок
При использовании функций ПолучитьЗначенияГрузоперевозки и ПолучитьЗначенияГрузоперевозок
Вы можете столкнуться с тем, что список полей вы отправляете такой
А имена колонок получаются вот такие.
Для этого и нужна функция ПолучитьСоответствиеПолейДляРезультата которая вернет вам соответствие того что вы отправляли для получения данных и имена колонок в результате.
Запись данных грузоперевозок
В модуле есть раздел с записью грузоперевозок.
Скорее всего раздел работает, но он не протестирован должным образом на совместимость с некоторыми другими проектами в работе.
Плюс к этому я еще не написал для них примеров использования.
Можно сказать это бета-тест
Ключевые функции этого раздела
УстановитьЗначениеПараметраГП и УстановитьЗначениеПараметраГП_ПоИсточнику
Разница между ними в том, что УстановитьЗначениеПараметраГП сама получает объект и записывает в него данные.
А УстановитьЗначениеПараметраГП_ПоИсточнику принимает в себя справочник-объект и вводит изменения в этот объект не записывая его - используется если нужно изменить 2 и более параметра в одной грузоперевозке.