Библиотека стандартных подсистем 1С 8.3. Контактная информация

Курс

Рассмотрена подсистема Контактная информация из библиотеки стандартных подсистем (БСП) 3.1.3.

Примеры приведены на конфигурации Управление торговлей 11.4.13.

В пользовательском режиме

Виды контактной информации

Виды контактной информации настраиваются в разделе НСИ и администрирование -> Общие настройки -> Контактная информация -> Виды контактной информации:

Здесь перечислены те объекты, у которых можно добавлять контактную информацию и возможные виды для каждого объекта:

С помощью стрелок можно регулировать последовательность расположения контактной информации:

Также можно создать новый вид контактной информации:

Для каждого вида нужно указать тип контактной информации. Всего есть 7 типов:

  • Адрес
  • Телефон
  • Адрес электронной почты
  • Skype
  • Веб страница
  • Факс
  • Другое

Настройки видов контактной информации

Большинство настроек понятны из названия, рассмотрим основные:

Обязательное заполнение — если установить эту галку, то объект не будет записан, если не заполнен данный вид контактной информации.

Разрешить ввод нескольких значений — через кнопку «Добавить» можно добавлять несколько значений для данного вида:

Хранить историю изменений — в этом случае можно изменять значение контактной информации с сохранением всей истории изменений:

Для адреса можно ввести произвольный комментарий, а также показать адрес на гугл или яндекс картах:

Контактную информацию можно выводить в формах списка или в отчетах через поле Ссылка. Для этого нужно выбрать в меню Еще -> Изменить форму и добавить нужную контактную информацию:

В конфигураторе

Получение контактной информации

Для получения контактной информации объекта можно использовать функцию ПредставлениеКонтактнойИнформацииОбъекта из общего модуля УправлениеКонтактнойИнформацией. Данная функция вернет контактную информацию в виде строки:

С помощью функций КонтактнаяИнформацияОбъекта и КонтактнаяИнформацияОбъектов можно получить всю контактную информацию объекта в виде таблицы. Вторая функция позволяет получить для нескольких объектов сразу:

Во все перечисленные выше функции параметром можно передавать как ссылку на объект, так и сам объект.

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

Используется процедура СоздатьВТКонтактнаяИнформация. В переданном менеджере временных таблиц будет создана временная таблица ВТКонтактнаяИнформация.

Добавление контактной информации

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

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

Можно вручную добавлять контактную информацию в табличную часть КонтактнаяИнформация:

В реквизите Значение хранится контактная информация в формате JSON, в реквизите ЗначенияПолей в XML формате, в реквизите Представление — в виде строки.

Прочие процедуры и функции

Получение всех видов КИ объекта:

Открытие формы ввода адреса:

Добавление контактной информации для нового справочника

  1. Добавить в определяемый тип ВладелецКонтактнойИнформации ссылку на новый справочник:
  1. В справочнике ВидыКонтактнойИнформации создать предопределенную группу для нового справочника. В этой группе создать элементы для каждого вида контактной информации:
  1. У справочника добавить табличную часть КонтактнаяИнформация  со следующими реквизитами:
ИмяТип
ТипПеречислениеСсылка.ТипыКонтактнойИнформации
ВидСправочникСсылка.ВидыКонтактнойИнформации
ПредставлениеСтрока (500)
ЗначениеСтрока неограниченной длины
СтранаСтрока (100)
РегионСтрока (50)
ГородСтрока (50)
АдресЭПСтрока (100)
ДоменноеИмяСервераСтрока (100)
НомерТелефонаСтрока (20)
НомерТелефонаБезКодовСтрока (20)
ЗначенияПолейСтрока неограниченной длины

Для реквизитов Вид и Тип включить индексирование.

Лучше всего скопировать эту табличную часть у другого объекта, например у справочника Партнеры.

  1. В форме элемента создать группу ГруппаКонтактнаяИнформация:

В этой группе будут созданы элементы для заполнения контактной информации.

  1. В модуль формы добавить следующий код:

  1. Разработать обработку для первоначального заполнения видов контактной информации. Ее нужно будет использовать только один раз. Код обработки:

  1. В новом справочнике появятся реквизиты для заполнения контактной информации:

Вывод контактной информации в форме списка и в отчетах

  1. В табличную часть КонтактнаяИнформация добавить реквизит ВидДляСписка с типом СправочникСсылка.ВидыКонтактнойИнформации.
  1. На закладке Данные открыть окно настройки дополнительных характеристик объекта по кнопке Характеристики:
  1. Заполнить как на картинке:
  1. Теперь в форме списка через Изменить форму можно от реквизита Ссылка добавлять адрес и телефон:

Возможность хранения истории изменения

  1. В табличную часть КонтактнаяИнформация добавить реквизит ДействуетС с типом Дата.
  1. Для изменения настроек адреса один раз выполняем следующий код:

  1. Теперь для адреса можно указать дату с которой он действует:

Подписывайтесь на группу ВКонтакте , где я публикую ссылки на новые статьи с данного сайта, а также интересные материалы с других ресурсов по программированию в 1С
Понравилась статья? Поделиться с друзьями:
Добавить комментарий

;-) :| :x :twisted: :smile: :shock: :sad: :roll: :razz: :oops: :o :mrgreen: :lol: :idea: :grin: :evil: :cry: :cool: :arrow: :???: :?: :!:

Используя этот сайт, Вы даете согласие на использование cookies. На данном этапе Вы можете отказаться от использования cookies, настроив необходимые параметры в своем браузере.
ok