Конвертация данных.

№№

1

1.Работа с формами.

1-36

2

2. Конвертация данных.

12-29

3

3. Быстрое освоение.

13-31

4

4. Обработчики.

14-61

5

1

11           Работа с формами.

Как вводить данные быстро

Подбор по наименованию и номеру (коду)

Быстрый ввод дат

Сочетания клавиш

Как копировать данные

Копирование и вставка данных

Копирование документов и элементов справочников

Как быстро вводить документы и заполнять справочники

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

Копирование документов и элементов справочников

Перемещение элементов справочников в группы

Как настроить форму

Настройка списка (обычное приложение)

Настройка периода (обычное приложение)

Настройка списка (управляемое приложение)

Настройка периода (управляемое приложение)

Сортировка по колонке

Как искать данные (обычное приложение)

Как искать данные (управляемое приложение)

Как распечатать таблицу или сохранить ее в файл

Сочетания клавиш

12           Подбор по наименованию и номеру (коду)

Для быстрого ввода в поля, в которых предусмотрена кнопка выбора, достаточно:

•              ввести несколько первых букв наименования, например, "Бел" для контрагента "Белая акация";

•              указать номер (код).

Открыть справочник или журнал документов можно с помощью кнопки выбора или клавиши F4.

13           Быстрый ввод дат

Для быстрого ввода даты можно:

•              ввести только часть даты, например, если указать день и месяц "08.07", то год подставится текущий – "08.07.2008";

•              не указывать разделители: точки и двоеточия, например, "08072008";

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

14           Сочетания клавиш. Форма

Действие             Сочетание клавиш

Перейти к следующему элементу формы/выполнить действие кнопки по умолчанию                Enter

Выполнить действие кнопки по умолчанию     Ctrl + Enter

Перейти к следующему элементу формы             Tab

Вернуться к предыдущему элементу формы      Shift + Tab

Перемещение по элементам, объединенным в одну группу       Up, Down, Left, Right

Закрыть активное вспомогательное окно          Esc

Действие             Сочетание клавиш

Перейти к следующему элементу формы/выполнить действие кнопки по умолчанию                Enter

Выполнить действие кнопки по умолчанию     Ctrl + Enter

Перейти к следующему элементу формы             Tab

Вернуться к предыдущему элементу формы      Shift + Tab

Активизировать командную панель, связанную с активным элементом формы/формой                Alt + F10

Перемещение по элементам, объединенным в одну группу       Up, Down, Left, Right

Закрыть активное окно              Esc

Восстановить положение окна Shift + Alt + R

15           Копирование и вставка данных

Выделите значаение, которое нужно скопировать и нажмите клавиши: Ctrl+C или Ctrl+Ins.

Для вставки используйте: Ctrl+V или Shift+Ins.

Для работы с числами удобно использовать кнопки панели инструментов "Стандартная":

    "М" - запомнить значение;

    "М+" - сложить выделенное значение с запомненным;

    "М-" - вычесть из запомненного значения выделенное.

Для выделения значения, достаточно установить на него курсор.

16           Копирование документов и элементов справочников

Для того чтобы создать документы или элементы справочников подобные существующим, выполните следующие действия:

•              поместите курсор в строку с документом или элементом, который будет скопирован

•              для обычного режима запуска воспользуйтесь пунктом "Действия — Скопировать" или клавишей F9

Далее откроется форма нового документа или элемента справочника, в которой все данные кроме номера (кода) и даты будут скопированы.

17           Создание на основании

В системе 1С:Предприятие можно создавать новые элементы справочников и документы копированием данных из других элементов справочников и документов.

Например, для ввода документа "Оплаты" на основании "Поступления товаров" следует:

•              в списке документов поступлений установить курсор на документ-основание

•              для обычного режима запуска воспользуйтесь пунктом "Действия — Создать на основании — Оплата"

Далее откроется форма нового документа оплаты, с заполненными данными, скопированными из документа поступления.

При создании документа (элемента справочника) ему присваивается очередной порядковый номер (код) и устанавливается текущая дата. Предложенные программой номер и дату документа можно изменить.

18           Копирование документов и элементов справочников

Для того чтобы создать документы или элементы справочников подобные существующим, выполните следующие действия:

•              поместите курсор в строку с документом или элементом, который будет скопирован

•              для обычного режима запуска воспользуйтесь пунктом "Действия — Скопировать" или клавишей F9

Далее откроется форма нового документа или элемента справочника, в которой все данные кроме номера (кода) и даты будут скопированы.

19           Реорганизация

В иерархическом справочнике элементы располагаются в группах. Элемент справочника - это данные о конкретном товаре, например, "Скатерть белая, вязанная". Группа - это набор элементов справочников, например, "Скатерти".

Возможны ситуации, когда требуется переместить элемент справочника из одной группы в другую, для этого:

•              в справочнике установите курсор в строку с тем элементом, который необходимо перенести;

•              воспользуйтесь командой "Переместить в группу";

•              в открывшейся форме, выберите нужную группу.

20           Настройка списка

Как настроить колонки?

Прочие настройки

Для удобства просмотра, список отображаемых колонок можно настроить с помощью пункта "Действия — Настройка списка".

Закладка "Колонки"

В списке флажком отмечены колонки, находящиеся в данный момент на экране - их состав можно менять. Для этого у нужных колонок поставите флажки, а у остальных снимите.

С помощью кнопок "Переместить вверх" и "Переместить вниз" можно установить порядок следования колонок в списке.

Для настройки отображения конкретной колонки, выберите ее и укажите соответствующие настройки в реквизитах справа.

В поле "Положение" выбирается положение колонки.

        "Новая колонка" - расположение справа от предыдущей колонки.

        "На следующей строке" - расположение под предыдущей колонкой. Для первой колонки данный выбор не имеет смысла.

        "В той же колонке" - расположение в той же колонке, что и предыдущая.

Для того чтобы расположить несколько колонок под одной колонкой, нужно выбрать положение "На следующей строке", а для всех последующих колонок выбрать "В той же колонке".

В поле "Изменение размера" устанавливается возможность изменения размера колонки мышью и изменение в зависимости от размеров окна.

В поле "Ширина" задается ширина колонки в символах.

В поле "Высота" задается высота колонки в строках.

Если флажок "Автовысота" установлен, то высота будет вычисляться по представлению значения в колонке с учетом максимального числа строк, заданных в поле "Высота".

Кнопка "Применить" позволяет сразу просмотреть результат выбранных настроек.

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

Важно! Возможны ситуации, когда настройка конкретной колонки запрещена. Также не допускается вставка колонок между двумя колонками, для которых запрещено изменение положения.

При настройке некоторых списков (в редакторах "Все подсистемы", командного интентерфейса, рабочего стола и др.) перемещение и изменение положения колонок не выполняется.

Закладка "Прочее"

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

Для того чтобы при открытии списка таблица отображалась с конца, выберите в поле "При открытии переходить" значение "В конец списка", для отображения таблицы с начала выберите "В начало списка"

Если флажок "Обновлять автоматически каждые ... секунд" установлен, то система будет обновлять список через интервал, указанный в поле, расположенном справа от флажка. Рекомендуется производить эту настройку для постоянно обновляемой открытой или открытой продолжительное время формы списка.

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

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

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

21           Настройка периода

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

Период определяет интервал дат, за которые в списке показывается информация.

Диалог имеет две закладки. Установка интервала может проводиться на любой из них.

На закладке "Интервал"

установка производится выбором начала и конца интервала времени.

На закладке "Период"

указывается период, за который будет произведен отбор данных.

Для сохранения при следующем открытии установите флажок "Использовать эту настройку периода при открытии".

Замечание. Настройка индивидуальна для каждого списка и пользователя.

22           Сортировка по колонке

Данные в таблицах можно сортировать (упорядочивать) по колонкам.

Для этого достаточно щелкнуть по названию колонки - справа появится треугольник. Для сортировки в обратном порядке, следует щелкнуть по названию еще раз.

Замечание 1. Для некоторых колонок сортировка не предусмотрена.

Замечание 2. В иерархических списках сортировка осуществляется в пределах группы.

23           Поиск в списке

Быстрый поиск

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

Замечание. Для иерархического списка с установленным режимом иерархического просмотра поиск осуществляется только по тем колонкам, по которым проведена сортировка - помечены черным треугольником справа от заголовка. Для поиска во всем справочнике следует отключить режим иерархического просмотра.

Произвольный поиск

Наиболее широкими возможностями обладает произвольный поиск по любым значениям и в любом направлении.

Чтобы начать поиск, следует выбрать пункт "Правка - Найти" (Ctrl+F). После установки всех необходимых условий нажмите кнопку "Поиск".

Если в списке несколько подходящих значений, то курсор устанавливается на первое. Можно продолжить поиск с теми же установками, выбрав пункт "Правка — Найти следующий" или "Правка — Найти предыдущий".

Кроме того, в панели инструментов существует специальный элемент для ввода строки поиска. Он позволяет выполнить поиск по строке без вызова диалога поиска. Для использования этого элемента следует ввести в него нужную строку и нажать клавишу Enter или одну из кнопок поиска панели инструментов.

24           Как распечатать таблицу или сохранить ее в файл

Выполните следующие действия:

•              откройте нужную таблицу;

•              для обычного режима запуска воспользуйтесь пунктом "Действия - Вывести список...";

•              в открывшейся форме укажите в поле "Выводить в":

o             табличный документ - если необходимо сохранить границы таблицы;

o             текстовый документ - если границы не важны;

•              отметьте флажками нужные колонки;

•              нажмите кнопку "ОК" - откроется табличный или текстовый документ.

Далее используйте меню "Файл":

•              Печать" - для печати таблицы;

•              Сохранить как..." - для сохранения таблицы в файл (.mxl, .htm, .html, .xls, .txt).

25           Сочетания клавиш

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

•              Глобальные действия

•              Общие действия

•              Командный интерфейс

•              Форма

•              Работа со списком, деревом

•              Работа с табличным документом

•              Работа с текстовым документом

•              Поле ввода

•              Поле картинки

•              Палитра свойств

•              Поле графической схемы

•              Управление окнами

Если несколько клавиш должны быть нажаты одновременно, это показывается знаком + ("плюс") между обозначениями клавиш (например: Ctrl + C).

26           Сочетания клавиш. Глобальные действия

Действие             Сочетание клавиш

Открыть "Справку"      F1

Открыть "Содержание справки"            Shift + F1

Открыть "Индекс справки"      Shift + Alt + F1

Открыть "Поиск по справке"   Alt + F1

Создать новый документ            Ctrl + N

Открыть существующий документ        Ctrl + O

Получить ссылку            Ctrl + F11

Перейти по ссылке         Shift + F11

Добавить в "Избранное"             Ctrl + D

Открыть "Избранное"  Ctrl + Shift + B

Открыть "История"      Ctrl + Shift + H

Открыть встроенный "Калькулятор" системы 1С:Предприятие             Ctrl + F2

Открыть / закрыть "Служебные сообщения"    Ctrl + Shift + Z

Действие             Сочетание клавиш

Открыть "Справку"      F1

Открыть "Содержание справки"            Shift + F1

Открыть "Индекс справки"      Shift + Alt + F1

Открыть "Поиск по справке"   Alt + F1

Создать новый документ            Ctrl + N

Открыть существующий документ        Ctrl + O

Открыть встроенный "Калькулятор" системы 1С:Предприятие             Ctrl + F2

Открыть "Свойства"    Alt + Enter

Ctrl + E

Открыть "Служебные сообщения"        Ctrl + Alt + O

Закрыть "Служебные сообщения"         Ctrl + Shift + Z

Открыть "Табло"           Ctrl + Alt + W

Действие             Сочетание клавиш

Открыть "Справку"      F1

Открыть "Содержание справки"            Shift + F1

Открыть "Индекс справки"      Shift + Alt + F1

Открыть "Поиск по справке"   Alt + F1

Создать новый документ            Ctrl + N

Открыть существующий документ        Ctrl + O

Открыть встроенный "Калькулятор" системы 1С:Предприятие             Ctrl + F2

Действие             Сочетание клавиш

Открыть "Справку"      F1

Открыть "Поиск по справке"   Alt + F1

Получить ссылку            Ctrl + F11

Перейти по ссылке         Shift + F11

Добавить в "Избранное"             Ctrl + D

Открыть "Избранное"  Ctrl + Shift + B

Открыть "История"      Ctrl + Shift + H

Открыть встроенный "Калькулятор" системы 1С:Предприятие             Ctrl + F2

Открыть / закрыть "Служебные сообщения"    Ctrl + Shift + Z

27           Сочетания клавиш. Общие действия

Действие             Сочетание клавиш

Удалить              Del

Добавить            Ins

Сохранить активный документ              Ctrl + S

Печать активного документа   Ctrl + P

Печать на текущий принтер      Ctrl + Shift + P

Копировать в буфер обмена      Ctrl + C

Ctrl + Ins

Вырезать в буфер обмена            Ctrl + X

Shift + Del

Вставить из буфера обмена        Ctrl + V

Shift + Ins

Копировать в буфер обмена как число Shift + Num*

Добавить к буферу обмена         Shift + Num+

Вычесть из буфера обмена         Shift + Num-

Выделить все    Ctrl + A

Отменить последнее действие  Ctrl + Z

Alt + BackSpace

Вернуть отмененное действие  Ctrl + Y

Shift + Alt + BackSpace

Найти   Ctrl + F

Найти следующий          F3

Найти следующий выделенный              Ctrl + F3

Найти предыдущий       Shift + F3

Найти предыдущий выделенный           Ctrl + Shift + F3

Заменить            Ctrl + H

Развернуть (узел дерева, группу табличного документа)             Ctrl + Num+

Свернуть (узел дерева, группу табличного документа) Ctrl + Num-

Развернуть (узел дерева, группу табличного документа) и все подчиненные     Ctrl + Alt + Num+

Свернуть (узел дерева, группу табличного документа) и все подчиненные        Ctrl + Alt + Num-

Развернуть (все узлы  дерева, группы табличного документа) (выполняется в любом месте дерева)     Ctrl + Shift + Num+

Свернуть (все узлы  дерева, группы табличного документа) (выполняется в любом месте дерева)     Ctrl + Shift + Num-

Перейти на следующую страницу           Ctrl + PgDn

Ctrl + Alt + F

Перейти на предыдущую страницу        Ctrl + PgUp

Ctrl + Alt + B

Включить/выключить жирность             Ctrl + B

Включить/выключить курсив  Ctrl + I

Включить/выключить подчеркивание Ctrl + U

Переход к предыдущей веб-странице / главе справки   Alt + Left

Переход к следующей веб-странице / главе справки      Alt + Right

Действие             Сочетание клавиш

Удалить              Del

Добавить            Ins

Сохранить активный документ              Ctrl + S

Печать активного документа   Ctrl + P

Печать на текущий принтер      Ctrl + Shift + P

Копировать в буфер обмена      Ctrl + C

Ctrl + Ins

Вырезать в буфер обмена            Ctrl + X

Shift + Del

Вставить из буфера обмена        Ctrl + V

Shift + Ins

Копировать в буфер обмена как число Shift + Num*

Добавить к буферу обмена         Shift + Num+

Вычесть из буфера обмена         Shift + Num-

Выделить все    Ctrl + A

Отменить последнее действие  Ctrl + Z

Alt + BackSpace

Вернуть отмененное действие  Ctrl + Y

Shift + Alt + BackSpace

Найти   Ctrl + F

Найти следующий          F3

Найти предыдущий       Shift + F3

Заменить            Ctrl + H

Развернуть (узел дерева, группу табличного документа)             Shift + Alt + Num+

Свернуть (узел дерева, группу табличного документа) Shift + Alt + Num-

Развернуть (все узлы  дерева, группы табличного документа)(выполняется в любом месте дерева)     Ctrl + Shift + Alt + Num+

Свернуть (все узлы  дерева, группы табличного документа) (выполняется в любом месте дерева)     Ctrl + Shift + Alt + Num-

Перейти на следующую страницу           Ctrl + PgDn

Ctrl + Alt + F

Перейти на предыдущую страницу        Ctrl + PgUp

Ctrl + Alt + B

Переход к предыдущей веб-странице / главе справки   Alt + Left

Переход к следующей веб-странице / главе справки      Alt + Right

28           Сочетания клавиш. Форма

Действие             Сочетание клавиш

Перейти к следующему элементу формы/выполнить действие кнопки по умолчанию                Enter

Выполнить действие кнопки по умолчанию     Ctrl + Enter

Перейти к следующему элементу формы             Tab

Вернуться к предыдущему элементу формы      Shift + Tab

Перемещение по элементам, объединенным в одну группу       Up, Down, Left, Right

Закрыть активное вспомогательное окно          Esc

Действие             Сочетание клавиш

Перейти к следующему элементу формы/выполнить действие кнопки по умолчанию                Enter

Выполнить действие кнопки по умолчанию     Ctrl + Enter

Перейти к следующему элементу формы             Tab

Вернуться к предыдущему элементу формы      Shift + Tab

Активизировать командную панель, связанную с активным элементом формы/формой                Alt + F10

Перемещение по элементам, объединенным в одну группу       Up, Down, Left, Right

Закрыть активное окно              Esc

Восстановить положение окна Shift + Alt + R

29           Сочетания клавиш. Работа со списком и деревом

Действие             Сочетание клавиш

Открыть             F2

Обновить           F5

Скопировать    F9

Новая группа   Ctrl + F9

Удалить строку               Shift + Del

Перенести элемент в другую группу      Ctrl + Shift + M

Перейти на уровень вниз с одновременным раскрытием группы           Ctrl + Down

Перейти на уровень вверх (к "родителю")          Ctrl + Up

Закончить редактирование       Shift + F2

Поиск данных в списке               Ctrl + F

Отменить поиск в списке           Ctrl + Q

Прервать поиск               Ctrl + Break

Развернуть узел дерева                Shift + Alt + Num+

Num+

Ctrl + Num+

Свернуть узел дерева    Shift + Alt + Num-

Num-

Ctrl + Num-

Развернуть узел дерева и все подчиненные        Num*

Ctrl + Alt + Num+

Свернуть узел дерева и все подчиненные            Ctrl + Alt + Num-

Развернуть все узлы дерева (выполняется в любом месте дерева)            Ctrl + Shift + Alt + Num+

Ctrl + Shift + Num+

Свернуть все узлы дерева (выполняется в любом месте дерева)                Ctrl + Shift + Alt + Num-

Ctrl + Shift + Num-

Изменение флажка        Пробел

Выделение всех строк (установлен множественный выбор)       Ctrl + A

Выделение всех строк, начиная с текущей до первой строки в списке

(установлен множественный выбор)     Shift + Home

Выделение всех строк, начиная с текущей до последней строки в списке

(установлен множественный выбор)     Shift + End

Действие             Сочетание клавиш

Открыть             F2

Обновить           F5

Скопировать    F9

Новая группа   Ctrl + F9

Удалить строку               Shift + Del

Перенести элемент в другую группу      Ctrl + Shift + M

Перейти на уровень вниз с одновременным раскрытием группы           Ctrl + Down

Перейти на уровень вверх (к "родителю")          Ctrl + Up

Закончить редактирование       Shift + F2

Поиск данных в списке               Ctrl + F

Отменить поиск в списке           Ctrl + Q

Развернуть узел дерева Shift + Alt + Num+

Свернуть узел дерева    Shift + Alt + Num-

Развернуть узел дерева и все подчиненные        Num*

Ctrl + Alt + Num+

Свернуть узел дерева и все подчиненные            Ctrl + Alt + Num-

Развернуть все узлы дерева (выполняется в любом месте дерева)            Ctrl + Shift + Alt + Num+

Свернуть все узлы дерева (выполняется в любом месте дерева)                Ctrl + Shift + Alt + Num-

Изменение флажка        Пробел

Выделение всех строк (установлен множественный выбор)       Ctrl + A

Выделение всех строк, начиная с текущей до первой строки в списке

(установлен множественный выбор)     Shift + Home

Выделение всех строк, начиная с текущей до последней строки в списке

(установлен множественный выбор)     Shift + End

30           Сочетания клавиш. Работа с табличным документом

Действие             Сочетание клавиш

Перейти к ячейке           Ctrl + G

Перемещение по ячейкам           Up, Down, Left, Right

Перемещение по ячейкам к следующей заполненной или пустой           Ctrl + (Up, Down, Left, Right)

Перемещение по ячейкам к следующей заполненной или пустой с выделением ячеек                Ctrl + Shift + (Up, Down, Left, Right)

Выделить ячейку            Shift + (Up, Down, Left, Right)

Выделение ячеек от текущей до начала строки               Shift + Home

Выделение ячеек от текущей до конца строки Shift + End

Выделение строк            Alt + Shift + (Up, Down)

Выделение строк до следующей заполненной или пустой ячейки          Ctrl + Alt + Shift + (Up, Down)

Выделение колонок      Alt + Shift + (Left, Right)

Выделение колонок до следующей заполненной или пустой ячейки    Ctrl + Alt + Shift + (Left, Right)

Выделение ячеек от текущей до начала документа        Ctrl + Shift + Home

Выделение ячеек от текущей до конца документа         Ctrl + Shift + End

Прокрутить на страницу вверх                PgUp

Прокрутить на страницу вниз  PgDn

Прокрутить на страницу влево                Alt + PgUp

Прокрутить на страницу вправо             Alt + PgDn

Перейти к редактированию содержимого ячейки           Enter

Переключение режима редактирования/ввода в ячейке              F2

Перейти в начало строки            Home

Перейти в конец строки              End

Перейти в начало текста             Ctrl + Home

Перейти в конец текста               Ctrl + End

Установка имени текущей области       Ctrl + Shift + N

Табличный документ, размещенный в форме

Действие             Сочетание клавиш

Выбор значения в ячейке           F4

Очистка значения в ячейке (для ячейки, имеющей составной тип, очищается выбранный ранее тип данных)                Shift+F4

Действие             Сочетание клавиш

Перемещение по ячейкам           Up, Down, Left, Right

Перемещение по ячейкам к следующей заполненной или пустой           Ctrl + (Up, Down, Left, Right)

Прокрутить на страницу вверх                PgUp

Прокрутить на страницу вниз  PgDn

Перейти в начало строки            Home

Перейти в конец строки              End

Перейти в начало текста             Ctrl + Home

Перейти в конец текста               Ctrl + End

31           Сочетания клавиш. Работа с текстовым документом

Действие             Сочетание клавиш

Переключить режим вставки/замены   Ins

Перейти в начало строки            Home

Перейти в конец строки              End

Выделить до начала строки       Shift + Home

Выделить до конца строки        Shift + End

Перейти в начало текста             Ctrl + Home

Перейти в конец текста               Ctrl + End

Выделить до начала текста        Ctrl + Shift + Home

Выделить до конца текста         Ctrl + Shift + End

Прокрутить на одну строку вверх          Ctrl + Up

Прокрутить на одну строку вниз            Ctrl + Down

Перейти к началу предшествующего слова        Ctrl + Left

Перейти к началу следующего слова     Ctrl + Right

Выделить слово               Ctrl + W

Выделить предшествующее слово          Ctrl + Shift + Left

Выделить следующее слово       Ctrl + Shift + Right

Прокрутить на страницу вверх                PgUp

Прокрутить на страницу вниз  PgDn

Выделить предыдущую страницу текста            Shift + PgUp

Выделить следующую страницу текста               Shift + PgDn

Снять выделение            Esc

Перейти к строке            Ctrl + G

Удалить символ слева от курсора           BackSpace

Удалить символ справа от курсора        Del

Удалить слово слева от курсора              Ctrl + BackSpace

Удалить слово справа от курсора           Ctrl + Del

Установить/снять закладку      Alt + F2

Следующая закладка    F2

Предыдущая закладка Shift + F2

Удалить текущую строку           Ctrl + L

Сдвинуть блок вправо Tab

Сдвинуть блок влево    Shift + Tab

Перейти по операторным скобкам назад            Ctrl + [

Перейти по операторным скобкам вперед          Ctrl + ]

Перейти по операторным скобкам назад с выделением текста Ctrl + Shift + [

Перейти по операторным скобкам вперед с выделением текста              Ctrl + Shift + ]

Действие             Сочетание клавиш        

Переключить режим вставки/замены   Ins         

Перейти в начало строки            Home   

Перейти в конец строки              End       

Выделить до начала строки       Shift + Home      

Выделить до конца строки        Shift + End         

Перейти в начало текста             Ctrl + Home       

Перейти в конец текста               Ctrl + End           

Выделить до начала текста        Ctrl + Shift + Home         

Выделить до конца текста         Ctrl + Shift + End             

Перейти к началу предшествующего слова        Ctrl + Left          

Перейти к началу следующего слова     Ctrl + Right        

Выделить слово               Ctrl + W              

Выделить предшествующее слово          Ctrl + Shift + Left             

Выделить следующее слово       Ctrl + Shift + Right          

Прокрутить на страницу вверх                PgUp    

Прокрутить на страницу вниз  PgDn    

Выделить предыдущую страницу текста            Shift + PgUp       

Выделить следующую страницу текста               Shift + PgDn       

Удалить символ слева от курсора           BackSpace          

Удалить символ справа от курсора        Del        

Удалить слово слева от курсора              Ctrl + BackSpace             

32           Сочетания клавиш. Поле ввода

Действие             Сочетание клавиш

Переключить режим вставки/замены   Ins

Кнопка выбора (из формы списка, быстрый выбор, выбор в режиме списка выбора)                F4

Up

Down

Выбор, аналогично кнопке выбора       Alt+Up

Alt+Down

Выбор из списка выбора             Ctrl+Up

Ctrl+Down

Нажатие указателем мыши кнопки "Вверх" для кнопки регулирования           Up

Нажатие указателем мыши кнопки "Вниз" для кнопки регулирования             Down

Ввод по строке с текущим текстом, если текст вводится

При появлении по ожиданию списка выбора ввода по строке переходит к списку                Down

Кнопка открытия           Ctrl + Shift + F4

Очистить поле  Shift + F4

Выделить текущее слово             Ctrl + W

Удалить символ слева от курсора           BackSpace

Удалить символ справа от курсора        Del

Удалить слово слева от курсора              Ctrl + BackSpace

Удалить слово справа от курсора           Ctrl + Del

Перейти в начало строки            Home

Перейти в конец строки              End

Действие             Сочетание клавиш

Переключить режим вставки/замены   Ins

Кнопка выбора               F4

Кнопка открытия           Ctrl + Shift + F4

Очистить поле  Shift + F4

Выделить текущее слово             Ctrl + W

Удалить символ слева от курсора           BackSpace

Удалить символ справа от курсора        Del

Удалить слово слева от курсора              Ctrl + BackSpace

Удалить слово справа от курсора           Ctrl + Del

Перейти в начало строки            Home

Перейти в конец строки              End

33           Сочетания клавиш. Поле картинки

Действие             Сочетание клавиш

Увеличить масштаб      Num+

Уменьшить масштаб    Num-

Прокрутить       Up, Down, Left, Right

Прокрутить на размер окна вверх          PgUp

Прокрутить на размер окна вниз            PgDn

Прокрутить на размер окна влево          Alt + PgUp

Прокрутить на размер окна вправо       Alt + PgDn

34           Сочетания клавиш. Палитра свойств

Действие             Сочетание клавиш

Сохранить свойства      Enter

Восстановить значения свойства            Esc

Раскрыть категорию свойств    Num+

Закрыть категорию свойств      Num-

Перейти в начало палитры        Home

Перейти в конец палитры          End

Перейти к предыдущему свойству         Up

Перейти к следующему свойству            Down

Прокрутить на страницу вверх                PgUp

Прокрутить на страницу вниз  PgDn

Перейти к предыдущей категории         Ctrl + PgUp

Перейти к следующей категории            Ctrl + PgDn

35           Сочетания клавиш. Поле графической схемы

Действие             Сочетание клавиш

Перейти на следующий элемент схемы (элемент должен быть выбран)                Tab, (Right, Down)

Перейти на предыдущий элемент схемы (элемент должен быть выбран)             Shift + Tab, (Left, Up)

Поиск   Ctrl + F

Найти следующий          F3

Найти предыдущий       Shift + F3

Замена Ctrl + H

Скроллирование вверх (не выбрано ни одного элемента)           Left, Up, PgUp

Скроллирование вниз (не выбрано ни одного элемента)             Right, Down, PgDn

36           Сочетания клавиш. Управление окнами

Действие             Сочетание клавиш

Закрыть активное свободное окно, модальный диалог или приложение            Alt + F4

Закрыть активное обычное окно            Ctrl + F4

Закрыть активное окно              Shift + Esc

Активизировать следующее обычное окно        Ctrl + Tab

Ctrl + F6

Активизировать предыдущее обычное окно     Ctrl + Shift + Tab

Ctrl + Shift + F6

Активизировать следующую секцию окна

F6

Активизировать предыдущую секцию окна

Shift + F6

Вызвать системное меню приложения или модального диалога             Alt + Space

Вызвать системное меню окна (кроме модальных диалогов)    Alt + Hyphen ( - )

Alt + Num-

Активизировать главное меню                F10

Вызвать контекстное меню       Shift + F10

Вернуть активность обычному окну     Esc

Восстановить положение окна Alt + Shift + R

Действие             Сочетание клавиш

Закрыть активное окно или приложение           Alt + F4

Вызвать системное меню            Alt + Space

Активизировать главное меню                F10

Вызвать контекстное меню       Shift + F10

Закрыть вспомогательное окно              Esc

Восстановить положение окна Alt + Shift + R

Активизировать следующее окно одного сеанса

Переход на следующую закладку (в режиме открытия окон "В закладках")     Ctrl + Tab

Ctrl + F6

Активизировать предыдущее окно одного сеанса

Переход на предыдущую закладку (в режиме открытия окон "В закладках")  Ctrl + Shift + Tab

Ctrl + Shift + F6

Действие             Сочетание клавиш

Закрыть активное окно или приложение           Alt + F4

Активизировать следующее окно одного сеанса

Переход на следующую закладку (в режиме открытия окон "В закладках")     Ctrl + Tab

Ctrl + F6

Активизировать предыдущее окно одного сеанса

Переход на предыдущую закладку (в режиме открытия окон "В закладках")  Ctrl + Shift + Tab

Ctrl + Shift + F6

37          

38           2. Конвертация данных.

39           Конвертация данных

Конфигурация "Конвертация данных" является специализированным средством настройки правил обмена данными между различными информационными базами (различных конфигураций) системы программ "1С:Предприятие 7.7" и "1С:Предприятие 8.0".

Порядок работы с конфигурацией приведен в справочной информации к общей форме "Настройка правил обмена"

40           Справочник «Значения объектов»

Справочник «Значения объектов» подчинен справочнику «Объекты метаданных» и содержит информацию о возможных значениях объектов. В справочнике хранятся значения перечислений, имена предопределенных элементов справочников, планов видов характеристик, планов счетов и планов видов расчета. Элементы этого справочника используются при настройке правил обмена между различными конфигурациями.

41           Справочник "Конфигурации"

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

42           Справочник «Объекты метаданных»

Справочник «Объекты метаданных» подчинен справочнику «Конфигурации» и, как следует из названия, содержит информацию об объектах метаданных той или иной конфигурации и их свойствах. Тип объектов фиксируется в соответствующем реквизите. В зависимости от значения реквизита «Тип», заполняются реквизиты, описывающие свойства объекта метаданных. Так для объектов метаданных типа справочник это, к примеру, такие свойства, как «Вид иерархии», «Серии кодов», «Количество уровней», для документов – «Периодичность» и «Автонумерация» и т.д.  Элементы этого справочника используются при настройке правил обмена между различными конфигурациями. Реквизиты объектов метаданных описываются в подчиненном справочнике "Свойства объектов". Значения объектов (значения перечислений и имена предопределенных элементов) описываются в подчиненном справочнике "Значения объектов".

43           Справочник «Свойства объектов»

Справочник «Свойства объектов» подчинен справочнику «Объекты метаданных» и, как следует из названия, содержит информацию об атрибутах и реквизитах объектов метаданных той или иной конфигурации и их свойствах. Здесь хранится о возможных типах реквизита объекта. Справочник двухуровневый. При помощи групп справочника, описываются подчиненные объекты, такие как, "Табличная часть" и возможные "Наборы движений документов". Соответственно, элементами второго уровня, описываются реквизиты табличных частей. Справочник «Свойства объектов» – не редактируемый, а заполняется исключительно обработкой ЗагрузкаМетаданных, которая загружает структуру метаданных любой конфигурации из файла. Элементы этого справочника используются при настройке правил обмена между различными конфигурациями.

44           Порядок настройки правил обмена

Используемые сокращения

ПКО - правило конвертации объекта

ПКС - правило конвертации свойства

ПКЗ - правило конвертации значения

ПВД - правило выгрузки данных

ПОД - правило очистки данных

Загрузка структуры метаданных

Перед началом настройки правил обмена необходимо загрузить структуры метаданных конфигураций источника (поставщика данных) и приемника (получателя данных). Загрузка структуры метаданных конфигураций осуществляется из файлов в формате XML, выгруженных в режиме "1С:Предприятие" из соответствующих конфигураций с помощью внешних обработок MD77Exp.ert (для конфигурации 1С:Предприятие версии 7.7) и MD80Exp.epf (для конфигурации 1С:Предприятие версии 8.0).

После того как конфигурации загружены их структуру можно просматривать в удобной форме описания конфигурации (форма "Конфигурация" вызывается из основной панели конфигурации).

Создание конвертации

Необходимо создать конвертацию, т.е. установить соответствие конфигурации источника и приемника. Для этого необходимо создать новый элемент справочника "Конвертации", указать конфигурации источник и приемник, а также наименование конвертации для удобства дальнейшего использования.

Теперь можно настраивать правила обмена. Для этого необходимо открыть форму "Настройка правил обмена" из основной панели конфигурации и выбрать одну из созданных ранее конвертаций. Настройка правил обмена будет производиться для выбранной конвертации.

Настройка правил конвертации объектов

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

Возможна настройка ПКО вручную или автоматическая синхронизация объектов конфигурации источника и приемника.

Ручная настройка ПКО

В этом режиме необходимо добавить новое ПКО и указать объект источник (необязательный) и приемник (обязательный). При записи для ПКО будет сформировано имя и наименование. Имя ПКО должно быть уникальным, так как является идентификатором правила и используется в обработчиках событий конвертации.

Автоматическая синхронизацию объектов

Данный режим вызывается из меню "Обработки" командной панели ПКО и называется "Синхронизация объектов".

Настрока правил конвертации свойств

Необходимо настроить правила конвертации свойств (далее ПКС). Настройка ПКС производится на закладке "Конвертация свойств" нижней панели формы.

Возможна настройка ПКС вручную или автоматическая синхронизация свойств объекта источника и приемника.

Ручная настройка ПКС

В этом режиме необходимо добавить новое ПКС и указать свойство источник (необязательный) и приемник (обязательный). При записи для ПКС будет сформировано наименование.

Автоматическая синхронизация свойств объектов

Данный режим вызывается из меню "Обработки" командной панели ПКО  для выбранного ПКО и называется "Синхронизация свойств объектов" (сочетание клавиш Alt+1).

Настройка правил конвертации значений

Необходимо настроить правила конвертации значений (далее ПКЗ). ПКЗ используются для синхронизации значений перечислений, предопределенных бухгалтерских счетов,  видов характеристик и видов расчетов. Настройка ПКЗ производится на закладке "Конвертация значений" нижней панели формы.

Возможна настройка ПКЗ вручную или автоматическая синхронизация значений объекта источника и приемника.

Ручная настройка ПКЗ

В этом режиме необходимо добавить новое ПКЗ и указать значение источник (необязательный) и приемник (обязательный). При записи для ПКЗ будет сформировано наименование.

Автоматическую синхронизация значений объектов

Данный режим вызывается из меню "Обработки" командной панели ПКО  для выбранного ПКО и называется "Синхронизация значений объектов" (сочетание клавиш Alt+2).

Простановка синхронизирующих свойств

Необходимо выполнить простановку синхронизирующих свойств. Для объектов типа справочник или документ при загрузке осуществляется поиск в информационной базе приемнике по свойствам для которых в ПКС установлен флаг "Поиск". Если объект с указанными значениями синхронизирующих свойств найден в информационной базе, то он либо оставляется без изменений либо замещается в зависимости от настройки в ПКО флага "Не замещать". То есть для синхронизирующего свойства объекта необходимо установить флаг "Поиск" для тех ПКС, по которым будут синхронизироваться объекты при загрузке в конфигурацию приемник.

Простановка синхронизирующих свойствой выполняется вручную установкой флага "Поиск" для определенных ПКС или автоматической синхронизацией.

Автоматическая простановка синхронизирующих свойств

Для этого необходимо перейти на закладку "Синхронизация" верхней панели формы и вызвать действие "Обновить" панели синхронизации. Таблица будет заполнена существующими ПКО с указанием текущего и предлагаемого способов синхронизации, а так же различиями между ними. Для ПКО с найденными различиями будет установлен флаг простановки синхронизирующих свойств. По окончании автоматической синхронизации возможно установить флажки простановки синхронизирующих свойств только для необходимых ПКО. Вызов действия "Записать" панели синхронизации проставляет флаг "Поиск" для различий между текущими и предлагаемыми способами синхронизации.

Настройка правил выгрузки данных

Необходимо настроить правила выгрузки данных (далее ПВД). ПВД описывают способ сбора данных из информационной базы конфигурации источника и вызывают для этого ПКО. По умолчанию ПВД вызывают одно ПКО в случае стандартной выборки. Если для ПВД способ выгрузки установлен "Произвольный алгоритм", тогда в алгоритме могут быть ссылки на различные ПКО. Настройка ПВД производится на закладке "Правила выгрузки данных" верхней панели формы.

Возможна настройка ПВД вручную или автоматическое создание.

Ручная настройка ПВД

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

Автоматическое создание

Данный режим вызывается из меню "Обработки" командной панели ПКО  для выбранного ПКО и называется "Создание правил выгрузки данных".

Сохранение правил конвертации

Необходимо сохранить настроенные правила в XML файл, необходимый для дальнейшего использования при выгрузке данных из конфигурации источника. Для этого необходимо вызвать действие "Сохранить правила" из основной панели формы "Правила обмена". В открывшемся диалоге необходимо указать имя файла выгрузки правил обмена, выбрать конвертацию и выполнить сохранение.

Выгрузка данных (1С:Предприятие 8.0)

Выгрузка данных из конфигурации источника осуществляется в режиме "1С:Предприятие" с помощью внешней обработки Универсальный обмен данными в формате XML (V8Exchan.epf)  и с использованием ранее полученного файла правил обмена.

Выгрузка данных (1С:Предприятие 7.7)

Выгрузка данных из конфигурации источника осуществляется в режиме "1С:Предприятие" с помощью внешней обработки "Универсальная выгрузка данных в формате XML (V77Exp.ert)" и с использованием ранее полученных файла правил обмена и модуля обработки.

Загрузка  данных

Загрузка данных в конфигурацию приемник осуществляется в режиме "1С:Предприятие" с помощью внешней обработки Универсальный обмен данными в формате XML (V8Exchan.epf) и с использованием ранее полученного файла выгрузки данных.

45           Справочник «Алгоритмы»

Справочник «Алгоритмы» подчинен справочнику «Конвертации». Каждый элемент справочника описывет алгоритм, который может многократно использоваться в любых обработчиках событий выгрузки и загрузки данных в правилах обмена. Такая возможность существенно облегчает отладку правил обмена. Например, может быть определен алгоритм ПересчетСуммыДокумента, который будет использоваться в правилах конвертации реквизита Сумма различных документов. Если алгоритм применяется в обработчиках событий загрузки данных, то в форме настройки алгоритма необходимо установить флажок "Используется при загрузке". Использование алгоритмов в обработчиках событий осуществляется посредством использования встроенных функций языка: Выполнить() или Вычислить(). В алгоритмах могут использоваться любые параметры обработчиков событий, определенные для данных событий.

Синтаксис вызова любого алгоритма:  Выполнить(Алгоритмы.<ИмяАлгоритма>)

46           Справочник «Запросы»

Справочник «Запросы» подчинен справочнику «Конвертации». Каждый элемент справочника описывет текст запроса, который может многократно выполняться с различными параметрами в любых обработчиках событий выгрузки и загрузки данных в правилах обмена. Такая возможность облегчает отладку правил обмена. Если запрос используется в обработчиках событий загрузки данных, то в форме настройки запроса необходимо установить флажок "Используется при загрузке".

Пример вызова запроса:

Запросы.<ИмяЗапроса>.УстановитьПараметр(<Имя>, <Значение>);

РезультатЗапроса = Запросы.<ИмяЗапроса>.Выполнить();

47           Справочник «Конвертации»

Понятие конвертации весьма абстрактно. Это может быть настройка преобразования одного вида документа в другой (например, выгрузка расходной накладной и конвертация ее в загружаемую приходную накладную), это может быть синхронизация справочников (например: единая номенклатура холдинга), настройка перехода на другую конфигурацию или новую редакцию конфигурации и т.д. Каждый элемент этого справочника имеет реквизиты «Источник» и «Приемник», которые ссылаются на справочник «Конфигурации». Таким образом, в настройках конвертации, прежде всего, определяется между какими конфигурациями осуществляется обмен и в каком направлении. При этом может быть множество конвертаций, у которых и источник, и приемник – одна и та же конфигурация. Таким образом, конвертация, в большей степени, определяется правилами обмена, настройки которых хранятся в подчиненных справочниках «Правила конвертации объектов», «Правила выгрузки данных» и «Правила очистки данных».

Результатом настройки конвертации является файл правил обмена. Полное имя файла правил обмена храниться раздельно для каждого пользователя и может быть указано в форме элемента. Настройка и выгрузка правил обмена в файл осуществляется в общей форме "Настройка правил обмена".

В форме элемента справочника "Конвертации" на закладке "События" могут быть настроены обработчики событий конвертации. Обработчики событий предствляют собой фрагменты алгоритмов (скрипты), реализованные на встроенном языке 1С:Предприятия и выполняемые в определенные моменты выгрузки и загрузки данных.

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

Параметры.<ИмяПараметра>

Одним из типичных вариантов использования параметров является их инициализация в обработчиках конвертации "Перед выгрузкой данных" или "Перед загрузкой данных" для последующего анализа в событиях правил обмена. Например, определив перед выгрузкой данных параметр ОтборДокументовПоСкладу:

Параметры.ОтборДокументовПоСкладу = Константы.ОсновнойСклад.Получить();

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

На закладке "Подключаемые обработки" могут быть загружены произвольные внешние обработки, используемые в процессе обмена. Можно выделить два основных варианта использования подключаемых обработок.

Вариант 1: Подключаемая обработка является своего рода библиотекой экспортируемых процедур / функций, используемых в процессе обмена.

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

Подключаемых обработок для обоих вариантов может быть произвольное количество. Для интерфейсных обработок необходимо установить флажок "Это обработка формы настройки". В этом случае, в обработке "Универсальный обмен данными", после загрузки правил обмена, становиться доступной кнопка настройки, по нажатию на которую, либо открывается форма настройки, либо выпадает меню (если подключено несколько интерфейсных обработок). При настройке интерфейсной обработки, могут быть указаны параметры обработки, связанные с параметрами  конвертации. В этом случае, необходимые параметры конвертации инициализируются автоматически. Указанные параметры, должны совпадать с одноименными реквизитами обработки или реквизитами основной формы обработки. Инициализация параметров конвертации происходит, если при закрытии формы настройки возвращается значение отличное от Неопределено, в противном случае считается, что пользователь нажал кнопку "Отмена", т.е. закрыл форму без сохранения изменений.

Доступ к подключаемым обработкам в обработчиках событий обмена осуществляется так:

ДопОбработки.<ИмяОбработки>.<ИмяЭкспортируемойПроцедурыИлиФункции()>

2

13                3. Быстрое освоение.

14                Добро пожаловать!

Для чего нужна программа

Выгрузка и загрузка метаданных

Создание правил обмена данными

Автоматическое создание правил обмена

Правила поиска объектов

Правила выгрузки данных

Правила очистки данных

Подробное знакомство с правилами обмена

Подробное знакомство с правилами конвертации объектов

Подробное знакомство с правилами конвертации свойств

Что такое обработчики событий

Что такое алгоритмы и запросы

Оптимизация правил обмена данными

Правила регистрации объектов

Правила регистрации объектов: Особенности использования

Создание правил регистрации объектов

15                 

Добро пожаловать!

Это пособие предназначено для тех, кто только начинает знакомиться с «Конвертация данных». С его помощью Вы сможете быстро освоить основные приемы работы с конвертацие данных и сразу приступить к делу.

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

•   выгрузить и загрузить информацию о конфигурациях между которыми необходимо настроить обмен данными;

•   создать новые правила обмена данными;

•   модифицировать существующие правила обмена.

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

Даже если список разделов закрыт, Вы можете перейти к следующему разделу, нажав на кнопку  , или вернуться к предыдущему, нажав на кнопку  .

Любой раздел можно распечатать. Для этого достаточно нажать на кнопку с изображением принтера  в панели инструментов программы (или выбрать меню Файл — Печать…, или воспользоваться комбинацией клавиш Ctrl+P).

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

Следующий раздел: «Для чего нужна эта программа»

16                 

Для чего нужна эта программа

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

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

Таким образом, обмен данными  можно разделить на две стадии – стадию подготовки правил обмена и стадию обмена данными. Самый сложным и ответственным этапа безусловно является подготовка правил обмена. Данная программа как раз и пердназначена для разработки правил обмена данными.

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

Следующий раздел: «Выгрузка и загрузка информации о структуре информационной базы»

17                 

Выгрузка и загрузка информации о структуре информационной базы

Выгрузка информации о структуре информационной базы

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

У нас имеется информационная база по которой нам нужно получить информацию о ее структуре. Выгрузим информацию о структуре информационной базы в файл. Для этого используется внешняя обработка MD81Exp.epf и MD80Exp.epf  для конфигураций на платформе "1С:Предприятии 8.1" и  "1С:Предприятии 8.0" а так же MD77Exp.ert для конфигураций на платформе "1С:Предприятии 7.7". Эти обработки входят в комплект дистрибутива конфигурации "Конвертация данных 2.0".

Для подготовки XML-файла содержащего описание структуры метаданных конфигурации нужно запустить внешнюю обработку соответствующую версии платформы , указать путь для файла, в который необходимо выгрузить информацию о структуре информационной базы и нажать кнопку "Выгрузить".

Если наша информационная база работает на базе платформы 1С:Предприятие 8.1, то процесс выгрузки информации о структуре информационной базы будет выглядеть следующим образом:

1. Открытие информационной базы, информацию о структуре метаданных которой необходимо получить (одинаков для всех платформ)

2. Открытие внешней обработки MD81Exp.epf. Для этого достаточно в главном меню открыть пункт "Файл\Открыть" и указать путь по которому располагается обработка MD81Exp.epf (для платформы 7.7 и 8.0 нужно открывать обработки MD77Exp.ert  соответственно MD80Exp.epf).

3. Указание имени файла, в который необходимо сохранить информацию о структуре информационной базы

4. Нажатие на кнопку  Выполнить

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

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

Загрузка информации о структуре информационной базы

Когда файл с информацией о структуре метаданных готов, его можно загрузить в конфигурацию "Конвертация данных".

Для этого достаточно открыть "Панель функций" и выбрать пункт "Загрузить структуру метаданных конфигурации".

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

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

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

После окончания загрузки программа откроет информацию о загруженных данных. При этом будет создан новый элемент справочника "Конфигурации". Этот элемент справочника в дальнейшем будет соответствовать информации о выгруженной конфигурации.

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

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

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

Следующий раздел: «Создание правил обмена данными (конвертации)»

18                 

Создание правил обмена данными

Мы знаем структуру метаданных информационной базы источник и приемника. Этой информации нам вполне достаточно для того, что бы определить какие объекты информационной базы источника должны преобразовываться в какие объекты информационной базы приемника. То есть мы можем установить некоторое соответствие между объектами информационной базы источника и приемника. Например, мы можем задать, что справочнику Номенклатура информационной базы источника соответствует справочник Номенклатура (или какой - либо другой справочник) информационной базы приемника.

Такое соответствие между объектами источника и приемника будем называть "Правила конвертации объектов" или ПКО.

На приведенном примере видно, что для правил обмена (или Конвертации) "Два объекта в один" установлено соответствие объектов для справочников "Пользователи" и "ФизическиеЛица". То есть задано, что объекты справочника "Пользователи" из информационной базы источника нужно переносить в объекты справочника "Пользователи" информационной базы приемника.

Когда соответствие между объектами установлено, можно определить каким образом необходимо переносить реквизиты этих объектов. То есть, нам нужно задать, что реквизиту "Наименование" одного справочника соответствует реквизит "Наименование" другого.

Такое соответствие между свойствами (или реквизитами) объектов источника и приемника будем называть "Правила конвертации свойств" или ПКС.

На приведенном примере видно, что для правил конвертации объектов "Пользователи" установлено 3 соответствия между свойствами (или реквизитами) объектов. Указано, что реквизит "Наименование" справочника "Пользователи" информационной базы источника должен преобразовываться в реквизит "Наименование" справочника "Пользователи" информационной базы приемника.

Когда соответствие между свойствами объектов задано, программе нужно указать критерии сопоставления объектов (то есть нужно указать, как по объекту источнику искать объект в приемнике) в двух информационных базах. Для такого сопоставления используется флажок "Поиск" у соответствующего правила конвертации объектов. Если флажок взведен, то поиск соответствующего объекта будет выполняться по этому свойству. В приведенном примере, видно, что поиск объекта в информационной базе приемнике будет выполняться по реквизиту "Наименование". Если поиск установлен по нескольким реквизитам, то поиск будет осуществляться по ним всем одновременно (то есть условия накладываются по "И". В этом случае, правило сопоставления звучит следующим образом: Искать в информационной базе - приемнике объект у которого все реквизиты поиска совпадают с реквизитами поиска объекта источника).

Кроме того, имеется возможность задать соответствие между предопределенными элементами справочников, планов видов характеристик и значений перечислений. Такое сопоставление будем называть "Правила конвертации значений" ПКЗ.

На приведенном примере видно, что для правил конвертации объектов "ВидыАгентскихДоговоров" установлено соответствие между значениями перечисления. То есть значение перечисления "Аренда" в информационной базе источнике должна преобразовываться в значение перечисления "Аренда" в информационной базе приемнике.

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

Следующий раздел: «Автоматическое создание правил обмена»

19                 

Автоматическое создание правил обмена данными

Мы знаем что такое правила Конвертации объектов, свойств и значений и для чего они нужны. Теперь рассмотрим подходы к созданию таких правил.

После того, как были созданы новые правила обмена данными, задали конфигурацию источник и приемник, сохранили новую Конвертацию, у нас нет ни одного правила конвертации объектов.

Можно создать правила конвертации объектов самостоятельно. Для этого достаточно добавить новый элемент на закладке "Правила конвертации объектов".

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

Правила конвертации объектов можно создать и иначе. В пункте меню "Обработки" панели управления правилами конвертации объектов выберите пункт "Синхронизация объектов". После этого программа автоматически сопоставит все одноименные объекты в двух конфигурациях и предложит по ним создать правила конвертации объектов. В форме выбора для создания правил конвертации объектов Вы можете отказаться от создания некоторых правил, убрав в строке флажок.

Для тех строк соответствия объектов в которых остались флажки программа создаст правила конвертации объектов.

Теперь, когда правила конвертации объектов созданы можно перейти к заданию правил конвертации свойств этих объектов. Установим курсор на то правило конвертации объектов для которого необходимо установить соответствие свойств. Достаточно нажать на кнопку "Добавить" в панели управления правилами конвертации свойств для создания нового правила.

В открывшейся форме нового правила конвертации свойств достаточно указать соответствие между реквизитом объекта источника и объектом приемника. Например, можно задать, что реквизиту "Номер" документа "Реализация товаров и услуг" информационной базы источника соответствует реквизит "Номер" документа "Реализация товаров и услуг" информационной базы приемника. После чего, нажав на кнопку "ОК" будет записано новое правило конвертации свойств.

Можно поступить точно так же и с другими реквизитами. Но если реквизитов много, то это занятие может затянуться на длительное время. Программа может самостоятельно создать необходимые правила конвертации свойств для одноименных реквизитов. Для этого достаточно выбрать пункт меню "Синхронизация свойств" в панели управления правил конвертации свойств.

Программа показывает список свойств объектов которые можно автоматически сопоставить. Устанавливая и убирая флажки в строках этого соответствия можно согласится или отказаться от создания правил. Флажок "Рекурсивно создавать правила конвертации, свойств и значений" управляет технологией создания правил конвертации свойств для не примитивных типов. Например, если реквизит "ВалютаДокумента" с типом "СправочникСсылка.Валюты" и для этого реквизита создается правило конвертации свойств, то автоматически будет создано правило для конвертации объектов с типом "СправочникСсылка.Валюты".

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

Действия при "ручном" сопоставлении значений:

Действия при автоматическом сопоставлении значений:

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

Следующий раздел: «Правила поиска объектов»

20                 

Правила поиска объектов

Когда правила конвертации свойств и значений созданы, можно указать принципы сопоставления (поиска) объектов по их свойствам. Если говорить упрощенно, то пока мы умеем сообщать системе какой тип в какой должен преобразовываться. Например, документ "Реализация товаров и услуг" в источнике должен преобразовываться в документ "Реализация товаров и услуг" в приемнике. Но пока не знаем как системе сообщить, что документ в источнике "Реализация товаров и услуг" c номером 0001 и датой 01.01.2008 должен заменять документ  в приемнике "Реализация товаров и услуг"  с тем же номером.

Нам нужно сообщить программе принципы поиска соответствующих объектов в приемнике. Это делается очень просто. Для свойств, по которым необходимо производить поиск объектов для их изменения, необходимо установить флажок поиск в соответствующем правиле конвертации свойств. Это можно сделать самостоятельно для каждого типа объектов. Если поиск установлен по нескольким реквизитам, то в информационной базе приемнике объект будет искаться на совпадение всем реквизитам объекта источника (то есть условия поиска объединяются логической операцией "И").

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

Достаточно перейти на закладку "Поиск объектов в приемнике" и программа предложит установить поиск по определенным свойствам.

При нажатии на кнопку "Установить правила поиска" программа установит поиск по выбранным свойствам.

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

Сопоставление объектов в конфигурациях на базе конфигурации "Библиотека стандартных подсистем" (БСП).

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

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

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

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

Следующий раздел: «Создание Правил выгрузки данных»

21                 

Создание правил выгрузки данных

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

Правила выгрузки данными указывают какие объекты разрешить пользователю для выгрузки.

Проще всего объяснить это на конкретном примере. Сформулируем задачу: Имеются две однотипные конфигурации "Бухгалтерия предприятия". Необходимо из одной конфигурации в другую загрузить справочник "Номенклатура".

Покажем последовательность действий в этом случае:

1. Создаем новое правило обмена данными

2. В появившемся окне сообщения указываем, что хотим самостоятельно создать новое правило конвертации объектов:

3. Указываем объект источник и приемник:

4. Согласимся с предложением программы автоматически создать правила конвертации свойств и значений (можно заметить, что автоматически были созданы еще правила конвертации объектов, они как раз нужны для того что бы переносить объекты не примитивных типов справочника "Номенклатуры". Посмотрите, что программа создала несколько правил конвертации объектов. Эти правила созданы не случайно!). После чего программа предложит нам автоматически создать правила выгрузки данных. Выберем, что бы программа создала правило выгрузки данных только для номенклатуры:

5. Если перейти на закладку "Правила выгрузки данных", то увидим что создано всего лишь одно правило выгрузки. То есть мы сообщили программе, что при выгрузке данных нужно выгружать только объекты справочника "Номенклатура" (плюс ко всему будут выгружены так же те объекты на которые элементы справочника "Номенклатура" ссылаются):

6. Правила полностью готовы к использованию. Сохраним их в файл:

7. Откроем программу "Бухгалтерия предприятия" откроме универсальную обработку выгрузки и загрузки данных из XML и загрузим правила обмена:

В списке объектов для выгрузки присутствует только справочник "Номенклатура". Собственно в этом списке будет присутствовать только список объектов, которые заданы в правилах выгрузки (по сути правила выгрузки именно это и определяют. Пользователю не показывается лишняя информация о связанных объектах, которые так же подлежат выгрузке). Далее, пользователь может указать дополнительные ограничения для выгрузки данных и выгрузить данные в файл.

8. После того как файл с данными был выгружен остается только загрузить эти данные в информационной базе - приемнике:

ВНИМАНИЕ!!!

Для ускорения выгрузки данных рекомендуется располагать правила выгрузки в таком порядке, что бы, если есть зависимые правила, то все ссылки были снизу вверх. То есть, в начале списка выгружаемых данных необходимо располагать объекты, которые ни на кого не ссылаются (Например, если справочник Пользователи ссылается на справочник Физические Лица, то рекомендуемый порядок выгрузки данных Физические Лица, Пользователи). Такой способ расположения объектов может существенно сказаться на скорости выгрузки данных.

Если в правиле конвертации объектов нет конвертации табличных частей или движений и в событиях перед выгрузкой данных нет обращений к самому выгружаемому объекту, то имеет смысл установить у правила Выгрузки данных Флажок "Выбирать данные для выгрузки одним запросом". Такой подход позволит при выгрузке данных одним запросом получить все данные, которые нужно выгружать и это может заметно сократить время выгрузки.

Эти достаточно просты оптимизации позволяют сократить время выгрузки данных на 30-40 (!!!) % и более!

Следующий раздел: «Правила очистки данных»

22                 

Правила очистки данных

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

Рассмотрим один из вариантов использования правил очистки данных на примере:

Торговое предприятие принимает решение открыть офис по приему заказов на продукты питания в пригороде. Для эффективной работы необходимо постоянно иметь в базе данных офиса актуальную версию справочника Номенклатура. Причем, было решено каждый раз помечать на удаление те номенклатурные позиции, которых в настоящий момент нет на складе в центральном офисе. Загрузка справочника должна производиться еженедельно, при этом товары, зарегистрированные в базе данных офиса, заказ которых стал невозможен (например, нет на складе) должны быть помечены на удаление, или при восстановлении доступности номенклатурной позиции для заказа - пометка удаления должна быть снята.

Реализовать такой механизм нам поможет использование правил очистки данных. Правила очистки выполняются в базе приемнике перед загрузкой объектов. С помощью этого инструмента можно пометить на удаление или удалить непосредственно объекты данных. В нашем случае мы будем ставить пометки на удаления у элементов справочника Номенклатура. При синхронизации элемента справочника в момент загрузки, пометка будет снята, поскольку загружаемые элементы Номенклатуры не имеют пометки на удаление. Таким образом, все "лишние" элементы, отсутствующие в загружаемом файле, останутся помеченными на удаление.

Правила очистки данных задаются на закладке "Правила очистки данных". Покажем как это делается:

Достаточно указать объект для выборки данных - то есть для удаления, указать что нужно помечать объекты на удаление, а не физически удалять из информационной базы и нажать на "ОК".

Следующий раздел: «Подробное знакомство с правилами обмена»

23                 

Подробное знакомство с правилами обмена

Мы знаем что такое правила обмена и зачем они нужны. Познакомимся более подробно с дополнительным функционалом работы с правилами обмена.  Откроем настройки правил обмена данными (конвертации):

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

Закладка "Дополнительно":

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

Закладка "Параметры":

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

Для этого случая нам придется освоить два новых приема работы с конфигурацией "Конвертация данных" - использование обработчиков и настройку параметров.

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

Для редактирования параметров откроем форму элемента справочника Конвертации для редактируемых правил обмена и перейдем на закладку параметры. Создадим новый элемент справочника Параметры. Присвоим имя параметра – ВыгружатьУслуги. Имя параметра служит для обращения к нему в структуре Параметры при написании программного кода в обработчиках. Наименование будет отображаться в табличной части Параметров в форме обработки универсального обмена данными. Для того, чтобы параметр был виден в диалоге при настройке выгрузки нужно установить флажок "Устанавливать в диалоге" и выбрать тип значения параметра. Для работы с параметрами в диалоге необходимо также установить флажок "Выгружать параметры в формате версии 2.01" в форме элемента справочника Конвертации.

Недостаточно просто указать параметры, надо чтобы алгоритм выполнения выгрузки "понимал", в каком случаем выгружать элемент, а в каком нет. Для подобных (и многих других) случаев используется механизм обработчиков. Суть его заключается в том, что в ключевых точках выполнения всех базовых алгоритмов выгрузки и загрузки данных обрабатывается код, написанный разработчиком при создании правил обмена. Естественно, что использование такого тонкого инструмента требует осторожности и продуманности. Мы рекомендуем перед написанием собственных обработчиков внимательно ознакомится со справкой к конфигурации "Конвертация данных 2.0", где описаны все доступные в обработчиках переменные и способы их использования, а также перечислены виды обработчиков и особенности их вызова в алгоритмах обмена данными.

Для нашей цели необходимо использовать обработчик правила выгрузки "Перед выгрузкой". Откроем правило выгрузки данных Номенклатура и поместим в поле "Перед выгрузкой" на закладке "События" следующий программный код:

Что же делает наш обработчик? При написании программного кода мы использовали переменные алгоритмов выгрузки данных. Структура Параметры служит для обращения к параметру ВыгружатьУслуги, который задается в форме обработки обмена данными. Переменная объект предоставляет доступ к выгружаемому объекту. А переменная Отказ позволяет контролировать отказ от выгрузки текущего объекта. Обработчик исполняется непосредственно перед началом выгрузки объекта, что и дает возможность отменить выгрузку объекта.

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

ТОЛЬКО ДЛЯ ОБМЕНА V8 - V8 И ОБРАБОТКИ ВЫГРУЗКИ И ЗАГРУЗКИ НЕ НИЖЕ 2.0.18.1

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

Процедура ПередатьОдинПараметрВПриемник(Имя, ИсходноеЗначениеПараметра, ПравилоКонвертации = "") Экспорт

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

На закладках Версии и Обновления можно посмотреть информацию о выгруженных и загруженных версиях правил обмена.

Следующий раздел: «Подробное знакомство с правилами конвертации объектов»

24                 

Подробное знакомство с правилами конвертации объектов

Как мы уже знаем, правила конвертации объектов используются для сопоставления объектов в конфигурациях источнике и приемнике. Естественно, что в правиле задается объект источник данных (то есть откуда брать данные) и объект - приемник данных (то есть куда переносить или записывать данные).

Кроме них имеется еще ряд свойств смысл которых постараемся раскрыть.

Искать объект приемника по внутреннему идентификатору объекта источника - флаг определяющий поиск объектов в приемнике для версии платформы V8. Если этот флажок взведен, то поиск объекта для модификации в базе приемнике осуществляется по внутреннему (уникальному) идентификатору объекта. Этот идентификатор не виден пользователю а средствами программы поддерживается уникальность идентификаторов в информационной базе, так что никакие два объекта информационной базы не имеют одинаковых идентификаторов.

Продолжить поиск по полям поиска, если по идентификатору объект приемник не найден ** - флаг определяет продолжать поиск объекта в информационной базе приемнике, если поиск по уникальному идентификатору не привел к положительному результату.

Не замещать существующие объекты в приемнике при загрузке, а только создавать новые и заполнять их * - флаг определяет нужно ли выполнять изменение реквизитов объекта в информационной базе приемнике, если объект был успешно найден по уникальному идентификатору или по полям поиска.

Не создавать новый объект в приемнике, если он НЕ найден * - флаг определяет нужно ли создавать новый объект в информационной базе - приемнике, если он не был найден по уникальному идентификатору или по полям поиска.

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

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

Не запоминать выгруженные объекты - флаг определяет нужно ли системе при выгрузке КЭШировать последние выгруженные объекты. КЭШирование позволяет ускорить процесс выгрузки и загрузки данных.

Использовать быстрый поиск объекта при выгрузке и загрузке - флаг определяет использовать ли быстрый поиск объектов для выгрузки. Имеет смысл применять для небольших по количеству записей справочников (Количество записей не более 1000 элементов). Эффект достигается в том случае, если у многих объектов установлен флаг Не выгружать объекты свойств по ссылкам. При такой схеме выгрузки и загрузке данных скорость возрастает в несколько раз.

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

On-line обмен

Выгружать объект (полностью), только при наличии на него ссылки - настройка определяет при каких обстоятельствах необходимо выгружать объект. В том случае, если флажок установлен, то выгрузка объекта будет выполнена по следующим правилам:

1. По правилам выгрузки если объект уже выгружался, то выгружаем его как есть

2. По правилам выгрузки если объект не выгружался, то не выгружаем

3. При выгрузке по ссылке на объект выгружаем целиком

Например, если нужно переносить не всю номенклатуру из одной ИБ в другую, а только ту, на которую есть ссылки, то флажок подойдет.

Не замещать объект созданный в информационной базе приемнике при загрузке - настройка определяет нужно ли (обратно) переносить объект, который был создан в информационной базе, с которой организован обмен. То есть, если документ создан в информационной базе 1, при помощи обмена поступил в информационную базу 2, то стоит ли его при изменении в базе 2 переносить в базу 1. Настройка позволяет указать приоритет объекта при обмене по месту его создания. То есть изменения в информационной базе, где был создан объект распространяются везде, а изменения в других базах не влияют на этот объект в базе 1.

Приоритет объекта загрузки - настройка определяет приоритет объекта при загрузке в случае коллизии изменений. Значение по умолчанию и в случае незаполненного значения - Выше. Если произошла коллизия, программа анализирует приоритет объекта загрузки. Только в том случае, если приоритет объекта загрузки равен Выше он будет записан в информационную базу приемника. В случае если приоритет Совпадает или Ниже программа зафиксирует соответствующую информацию о коллизии в информационной базе, но объект менять при этом не будет.

Варианты настроек полей поиска - таблица с возможными вариантами настроек полей поиска для пользователя. Разработчик правил определяет возможные комбинации полей поиска, которые пользователь может выбирать при настройке обмена. Все настройки указанные разработчиком правил должны быть отработаны в коде обработчика "Поля поиска". Переменная НастройкаПоиска в обработчике определяет выбранный пользователем вариант сопоставления (ИмяНастройкиДляАлгоритма из соответствующей строки таблицы). Если пользователь не выбрал ни один вариант сопоставления, или ему ни один вариант не был предложен, то НастройкаПоиска - пустая строка.

На закладке "Дополнительно" можно редактировать наименование правила, вхождение его в определенную группу а так же описание правила.

Примечания:

*   Не рекомендуется для использования при настройке on-line обмена

**  Не используется в обмене на базе конфигурации "Библиотека стандартных подсистем".

Следующий раздел: «Подробное знакомство с правилами конвертации объектов»

25                 

Подробное знакомство с правилами конвертации свойств

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

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

Поиск объекта при загрузке по данному свойству - флаг определяющий нужно ли по данному свойству производить поиск объектов в информационной базе приемнике. Если сразу у нескольких реквизитов установлено свойство поиска данных, то условия поиска объединяются по "И". В этом случае правило поиска звучит следующим образом: Найти объект у которых все реквизиты поиска совпадают с источником. (ВНИМАНИЕ!!!! Поиск по уникальному идентификатору, который может быть установлен у правила конвертации объектов более приоритетный, то есть если он установлен то поиск будет выполнен по этому идентификатору).

Отключить обработку данного правила - флаг, позволяет отключить обработку данного свойства, не удаляя его из правил конвертации объектов.

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

Автоматически приводить значение к длине приемника - флаг, позволяет включить автоматическое приведение Номера или Кода справочника соответствующему значению в приемнике по длине. При этом префиксы сохраняются, а числовые части преобразуются под длину поля в приемнике.

ТОЛЬКО ДЛЯ ОБМЕНА V8 - V8

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

Передавать данные в приемник - флаг определяет куда будут помещены данные при загрузке. Непосредственно в найденный для изменения объект.

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

Доступ к этим данным возможен в событии после загрузки. Например так:

Если ПараметрыОбъекта <> Неопределено тогда

ИмяКонтрагента = ПараметрыОбъекта["ИмяКонтрагента"];

КонецЕсли;

// если нужен доступ к параметрам табличной части

Если ПараметрыОбъекта <> Неопределено тогда

ТаблицаПараметровТовары = ПараметрыОбъекта["ТоварыТабличнаяЧасть"];

Для Каждого СтрокаПараметров Из ТаблицаПараметровТовары Цикл

ИмяНоменклатуры = СтрокаПараметров.ИмяНоменклатуры;

КонецЦикла;

КонецЕсли;

Выгружать элементы группы через промежуточный файл - флаг определяет как выгружать объекты данного типа, через промежуточный файл (экономично с точки зрения оперативной памяти) или напрямую через память (оптимально по скорости, но при больших объемах передаваемых данных оперативная память может закончится).

На закладке "Дополнительно" можно редактировать вхождение правила в определенную группу, а так же его описание. Наименование правила формируется автоматически и недоступно для изменения.

Следующий раздел: «Что такое обработчики событий»

26                 

Что такое обработчики событий

Механизм обработчиков событий является один из ключевых в технологии конвертации данных с помощью "Конвертации данных 2.0". Грамотное и умелое использование этого механизма позволяет разработчику быстро решать практически любые задачи по преобразованию данных. С помощью технологии обработчиков легко реализуются отбор данных, конвертации данных разных типов, сложные выборки данных, настройка параметров конвертации и многие другие задачи.

Рассмотрим основные принципы этой технологии. В ключевых точках алгоритмов выгрузки и загрузки данных обработок универсального обмена есть возможность исполнения программного кода взятого из правил обмена данными, а не "зашитого" в обработке выгрузки или загрузке данных. Конфигурация "Конвертация данных 2.0" предоставляет возможности для интеграции такого программного кода в правила обмена данными.

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

Код обработчиков событий "привязан" к объектам правил обмена - элементам справочников: конвертации, правила конвертации объектов, правила конвертации свойств, правила выгрузки данных и правила очистки данных. Естественно, что  код обработчиков событий должен удовлетворят ряду требования. В частности для управления процессом конвертации в коде обработчиков необходимо использовать специальные переменные - параметры. Полное описание всех типов обработчиков событий и доступных переменных можно найти в информации об обработчиках в соответствующих формах.

ВНИМАНИЕ!!!

Технологии "Конвертации данных 2.0" позволяют вести обмена данными с информационными базами, реализованными на платформах "1С:Предприятие 7.7" и "1С:Предприятие 8.0". В силу особенностей работы платформы "1С:Предприятие 7.7" подготовка правил обмена данных с использованием обработчиков событий для информационных баз, реализованных на этой платформе имеет ряд особенностей.

Для платформы "1С:Предприятие 7.7" нет возможности выполнить произвольный код (аналог функции Выполнить для V8). Если необходимо использовать обработчики событий для платформы V7.7 необходимо заменять текст обработки выгрузки или загрузки данных текстами обработок, которые выдает конфигурация "Конвертации данных 2.0".

Если необходимо перенести данные из V7.7 в V8 тогда:

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

При разработке решений по обмену данными на платформе "1С:Предприятие 7.7"  нужно помнить про эту важную "мелочь". Ваши правила будут корректно работать только в том случае, если Вы используете модифицированную обработку, текст модуля которой создан при выгрузке правил обмена данными. У этого правила есть одно исключение - если Вы не пользуетесь обработчиками событий, то можно применять стандартную обработку.

Следующий раздел: «Что такое алгоритмы и запросы»

27                 

Что такое алгоритмы и запросы

Допустим у нас есть правила обмена данными. При этом два разных правила конвертации объектов используют абсолютно одинаковые по структуре выборки данных, только с разными параметрами. Возникает резонный вопрос, а можно ли где-нибудь зафиксировать этот запрос, а затем использовать его во всех местах где нужно. Для этих целей существуют Запросы.

Технология использования очень проста. На закладке "Запросы" создаем и описываем текст запроса:

Далее в тексте обработчиков можно использовать такой код:

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

А вызов этого кода будет очень прост: Выполнить(Алгоритмы.СоздатьТаблицу);

Следующий раздел: «Оптимизация правил обмена данными»

28                 

Оптимизация правил обмена данными

Несколько простых рекомендаций, которые могут ускорить выгрузку и загрузку данных.

Правила Выгрузки данных

1. Порядок правил выгрузки данных

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

Пример: Нужно выгрузить два справочника Пользователи и Физические лица. Справочник Пользователи имеет реквизит Физ. лицо - ссылка на справочник Физические лица.  То есть справочник Пользователи ссылается на справочник Физические лица. Рекомендуемая последовательность правил выгрузки в этом случае: Физические лица, пользователи.

2. Выбирать данные для выгрузки одним запросом

Если в правиле конвертации нет переноса табличных частей и движений, а так же в событиях перед выгрузкой нет прямых обращений к выгружаемому объекту, рекомендуется в правиле выгрузки данных использовать режим "Выбирать данные для выгрузки одним запросом". Этот режим позволит одним запросом получить все выгружаемые данные определенного типа, а не строить отдельные запросы для выгрузки каждого объекта.

Правила Конвертации объектов

3. Использовать быстрый поиск при загрузке

Этот режим выгрузки и загрузки рекомендуется использовать для тех правил конвертации объектов, которые выгружают ссылочные типы общее количество которых сравнительно небольшое (примерно до 1000 элементов), на которые имеется множество ссылок в других объектов.

Пример: Справочник Пользователи. Практически все документы имеют ссылку на этот справочник и количество элементов справочника не превосходит 1000.

4. Не выгружать объекты свойств по ссылкам

Режим позволяет для правила конвертации объектов не выгружать все элементы на которые есть ссылки. Если режим установлен, то при выгрузке будет выгружен сам объект и информация для поиска всех его ссылок, но полная информация о зависимых элементах выгружена не будет. Эта оптимизация может в несколько раз ускорить выгрузку и загрузку данных.

5. Не запоминать выгруженные объекты

Для правил конвертации не ссылочных объектов (регистров) нужно установить флажок "Не запоминать выгруженные объекты", так как ссылаться на строки регистра нельзя, поэтому нет и смысла запоминать те строки регистров, которые были выгружены. Для ссылочных объектов этот флажок, как правило, нужен, что бы оптимизировать повторное обращение для выгрузки одного и того же объекта.

6. Не делать общих обработчиков событий для всех объектов

Не рекомендуется использовать общие обработчики событий перед выгрузкой и загрузкой данных для всех объектов. Обработки выгрузки и загрузки не знают что будет выполняться в этих обработчиках поэтому некоторые оптимизации (например, при загрузке запись только измененных объектов) действовать не будут. Если есть необходимость использовать одни и те же алгоритмы обработки данных при выгрузке и загрузке, то рекомендуется создать новый Алгоритм, а в событиях у нужных объектов его вызывать.

Обработка "Универсальный обмен данными XML"

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

Этот режим рекомендуется использовать при обмене данными V8-V8, если обработки выгрузки и загрузки на стороне источника и приемника не ниже 2.0.18

8. Загружать данные в режиме обмена

Позволяет отказать от излишних проверок на этапе загрузки данных

9. Записывать только измененные объекты

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

10. Оптимизированная запись объектов

Режим позволяет резко сократить количество обращений в информационной базе для записи объектов.

11. Записывать регистры наборами записей

Режим позволяет записывать изменения в регистрах наборами записей, а не менеджерами записей.

12. Обмен данными через COM

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

Следующий раздел: «Правила регистрации объектов»

29               

Правила регистрации объектов

В процессе обмена данными в общем случае участвуют не все объекты информационной базы, а только некоторое подмножество - объекты, которые были изменены с момента последнего обмена данными. Это становится возможным благодаря работе службе регистрации изменений. Очень часто требуется поддержать такой сценарий работы обмена данными, при котором объекты мигрируют не по всем информационным базам, участвующим в обмене, а только по выбранным. Для этого следует выполнить настройку ограничения миграции данных.

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

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

•   ПРОБ - правила регистрации по свойствам объекта

•   ПРОП - правила регистрации по свойствам плана обмена

В момент регистрации объекта эти правила выполняются последовательно, сначала выполняются ПРОБ, затем ПРОП. Если объект не проходит отбор, установленный ПРОБ, то ПРОП не выполняются и регистрация объекта к выгрузке не происходит.

ПРОБ описывают сопоставление реквизитов объекта с произвольными значениями.

ПРОП описывают сопоставление реквизитов плана обмена с реквизитами объекта и сопоставление реквизитов плана обмена со значениями констант примитивных типов*. По сути, эти правила и определяют множество узлов плана обмена, на котором будет выполнена регистрация объекта для выгрузки, или, говоря иначе, список информационных баз, в которые будет мигрировать объект.

Поддерживаются три способа настройки ограничения миграции данных или три типа элементов отбора:

•   сопоставление свойств объекта с произвольными значениями 

•   сопоставление свойств объекта со свойствами плана обмена

•   сопоставление свойств плана обмена с константами примитивных типов*

Для настройки правил регистрации в качестве свойств плана обмена могут быть использованы реквизиты шапки и реквизиты табличных частей плана обмена. Для настройки правил регистрации в качестве свойств объекта могут быть использованы только реквизиты шапки объекта.

Для свойств плана обмена и свойств объекта поддерживается разыменование ссылочных полей, т.е. возможно получение вложенных свойств, например, ДокументОснование.Контрагент.ИНН.

В правилах регистрации элементы отбора объединены в группы. При этом все элементы внутри одной группы будут сопоставляться по условию И, либо по условию ИЛИ. Элементы отбора корневой группы сопоставляются по условию И.

В правилах регистрации может быть задано произвольное количество элементов отбора сгруппированных произвольным образом.

На рисунке представлено правило регистрации документа «Авансовый отчет». В правиле регистрации имеет место сопоставление свойств документа со свойствами плана обмена. Свойства шапки документа Дата и Организация сопоставляются со свойством шапки плана обмена ДатаНачалаВыгрузкиДокументов и свойством Организация табличной части Организации плана обмена. Документ будет зарегистрирован на узле плана обмена, только если дата документа больше или равна дате, указанной в узле, и организация документа входит в подмножество организаций, указанных в табличной части узла при установленном отборе по организациям в узле (ИспользоватьОтборПоОрганизациям = Истина). Если отбор по организациям в узле не установлен (ИспользоватьОтборПоОрганизациям = Ложь), то будет использовано только ограничение по дате документа.

На закладке «Отбор по свойствам плана обмена» настраиваются ПРОП, а на закладке «Отбор по свойствам объекта» настраиваются ПРОБ.

* В качестве примитивных типов используются следующие типы: Дата, Число, Строка, Булево.

Следующий раздел: «Правила регистрации объектов: Особенности использования»

30               

Правила регистрации объектов: Особенности использования

Использование ПРО для иерархических справочников

В общем случае для элементов и для групп справочника должны быть созданы два разных правила регистрации. Обусловлено это как прикладным смыслом, так и техническим – состав реквизитов элементов и групп справочника в общем случае различный.

Например, требуется фильтровать регистрацию элементов справочника, в то время как группы справочника фильтровать не требуется. Для этого создаем два правила регистрации.

Первое правило будет использоваться для регистрации элементов справочника, поэтому в обработчике правила Перед обработкой напишем код:

Отказ = Объект.ЭтоГруппа;

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

Второе правило будет использоваться для регистрации групп справочника, поэтому в обработчике правила Перед обработкой напишем код:

Отказ = Не Объект.ЭтоГруппа;

Условия регистрации оставим пустыми – это позволит регистрировать все группы справочника.

Следующий раздел: «Создание Правил регистрации объектов»

31               

Создание правил регистрации объектов

Конфигурация «Конвертация данных» позволяет настраивать не только правила обмена данными, но и правила регистрации данных на узлах планов обмена.

Для начала настройки правил регистрации следует загрузить описание структуры метаданных той конфигурации, для которой планируется создавать правила. Далее следует создать элемент справочника «Регистрации». В этом элементе выбрать конфигурацию и план обмена, для которого предполагается настраивать правила регистрации. Дополнительно можно указать наименование регистрации и файл, в который созданные правила будут выгружены. Имена файлов сохраняются в разрезе пользователей информационной базы.

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

Это заключительный раздел пособия.

3

14                4. Обработчики.

15                Конвертация. После загрузки правил обмена

Конвертация. Перед выгрузкой данных

Конвертация. Перед получением измененных

Конвертация. После выгрузкой объекта

Конвертация. Перед отправкой удаления

Конвертация. Перед конвертацией объекта

Конвертация. После выгрузки объекта

Конвертация. После выгрузки данных

Конвертация. Перед загрузкой данных

Конвертация. После загрузки параметров

Конвертация. После получения информации об узлах обмена

Конвертация. Перед загрузкой объекта

Конвертация. При получении удаления

Конвертация. После загрузки объекта

Конвертация. После загрузки данных

Параметры. После загрузки

Правила конвертации объектов. Перед выгрузкой

Правила конвертации объектов. При выгрузке

Правила конвертации объектов. После выгрузки

Правила конвертации объектов. После выгрузки в файл

Правила конвертации объектов. Поля поиска

Правила конвертации объектов. Перед загрузкой

Правила конвертации объектов. При загрузке

Правила конвертации объектов. После загрузки

Свойства. Перед выгрузкой

Свойства. При выгрузке

Свойства. После выгрузки

Группа свойств. Перед обработкой

Группа свойств. Перед выгрузкой

Группа свойств. При выгрузке

Группа свойств. После выгрузки

Группа свойств. После обработки

Правила выгрузки. Перед обработкой

Правила выгрузки. Перед выгрузкой объекта

Правила выгрузки. После выгрузки объекта

Правила выгрузки. После обработки

Правила очистки. Перед обработкой

Правила очистки. Перед удалением

Правила очистки. После обработки

Правила регистрации объектов. Перед обработкой

Правила регистрации объектов. При обработке

Правила регистрации объектов. При обработке (дополнительный)

Правила регистрации объектов. После обработки

Правила регистрации объектов. Алгоритм получения значения

Правила регистрации объектов. Формат правила регистрации объектов

Правила регистрации объектов. Процедуры и функции

16                 

Обработчики "Конвертация"

После загрузки правил обмена

Условия возникновения события

Служит для первоначальной инициализации параметров при выгрузке данных. Выполняется после загрузки правил обмена. 

Для 1С:Предприятие 8:

Событие выполняется после загрузки правил обмена в универсальной обработке выгрузки и загрузки данных.

Параметры:

Параметры - Структура, в которой хранятся переменные доступные во всех обработчиках

Пример:

Параметры.МойПараметр = 100;

Для 1С:Предприятие 7.7:

Для инициализации параметров при выгрузке на платформе 1С:Предприятие 7.7 необходимо использовать функцию УстановитьЗначениеПараметраКонвертации(ИмяПараметра, Значение), где

ИмяПараметра – Строка           – имя устанавливаемого параметра

Значение        – Произвольный – значение устанавливаемого параметра

Пример:

УстановитьЗначениеПараметраКонвертации("МойПараметр_1", "Значение параметра (1)");

УстановитьЗначениеПараметраКонвертации("МойПараметр_2", "Значение параметра (2)");

17                 

Обработчики "Конвертация"

Перед выгрузкой данных

Условия возникновения события

Событие выполняется самым первым перед началом выгрузки данных и только один раз, после открытия файла для записи. Таким образом в файл могут быть записаны произвольные данные. Кроме того могут быть инициализинованы переменные, которые впоследствии предполагается использовать. Для работы с такими переменными имеется отдельная структура "Параметры".

Параметры:

Отказ - Булево. Если установить значение Истина, то выгрузка данных не производится

Параметры - Структура, в которой хранятся переменные доступные во всех обработчиках

Пример:

Если ЗначениеНеЗаполнено(Параметры.Организация) Тогда

 Сообщить("Не указан параметр Организация. Выгрузка невозможна.");

 Отказ = Истина;

КонецЕсли;

Параметры.Вставить("НомерВерсии", Константы.НомерВерсииКонфигурации.Получить());

18                 

Обработчики "Конвертация"

Перед получением измененных

Условия возникновения события

Событие выполняется только для on-line обмена перед непосредственным получением зарегистрированных объектов для выгрузки данных.

Параметры:

Параметры - Структура, в которой хранятся переменные доступные во всех обработчиках

УзелОбмена - основной узел по которому будут получаться изменения

УзелДляФоновогоОбмена - узел фонового обмена по которому могут выгружаться дополнительные данные

Пример:

Параметры.Вставить("КодУзлаОбмена", УзелОбмена.Код);

19                 

Обработчики "Конвертация"

Перед выгрузкой объекта

Условия возникновения события

Событие вызывается перед выгрузкой всех объектов в файл обмена, не зависимо от того какой объект выгружается. Вызов осуществляется до вызова одноименного обработчика "Правила выгрузки данных". Могут использоваться все параметры орпределенные для одноименного обработчика правила выгрузки данных. По сути и назначению это тот же обработчик, но определенный на глобальном уровне - то есть вызываемый для всех правил выгрузки данных. Обработчик удобен, например, когда для документов всех видов нужно проверить одно и то же условие. Обработчик вызывается только для объектов которые выгружаются непосредственно, а не когда объект выгружается, по тому что на него есть ссылка. В этом случае обработчики выгрузки не вызываются, а вызываются обработчики конвертации объекта.

Параметры:

Полностью совпадают с параметрами обработчика "Перед выгрузкой объекта" у "Правила выгрузки данных"

Пример:

Если Справочники.ТипВсеСсылки().СодержитТип(ТипЗнч(Объект)) Тогда

 Если Объект.Метаданные().Реквизиты.Найти("Организация") <> Неопределено И (Параметры.Организация <> Объект.Организация) Тогда

  Отказ = Истина;

 КонецЕсли;

КонецЕсли;

20                 

Обработчики "Конвертация"

Перед отправкой удаления

Условия возникновения события

Событие выполняется только для On-Line обмена перед отправкой в информационную базу-приемник информации об удалении объекта.

Параметры:

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

Отказ - булево. Служит для отказа выгрузки удаленной ссылки

Пример:

Если ТипЗнч(Ссылка) = Тип("СправочникСсылка.Номенклатура") Тогда

    Отказ = Истина;

КонецЕсли;

21                 

Обработчики "Конвертация"

Перед конвертацией объекта

Условия возникновения события

Событие выполняется перед началом конвертации объекта по правилу конвертации. Вызов осуществляется до вызова обработчика "Перед выгрузкой" правила конвертации объектов. Могут использоваться все параметры орпределенные для указанного обработчика правила конвертации объектов. По сути и назначению это тот же обработчик что и "Перед выгрузкой" в правиле конвертации, но определенный на глобальном уровне - то есть вызываемый для всех правил конвертации. Обработчик удобен, например, когда для справочников всех видов нужно установить НеЗамещатьОбъектПриЗагрузке = Истина или ВсеОбъектыВыгружены = Истина. Обработчик вызывается для всех объектов не зависимо от того выгружается этот объект непосредственно, или потому, что на него есть ссылки.

Параметры:

Полностью совпадают с параметрами обработчика "Перед выгрузкой" у "Правила конвертации объектов"

Пример:

Если Лев(ПКО.Приемник, 10) = "Справочник" Тогда

 НеЗамещатьОбъектПриЗагрузке = Параметры.НеЗамещатьСправочникиПриЗагрузке;

ИначеЕсли Лев(ПКО.Приемник, 8) = "Документ" Тогда

 НеЗамещатьОбъектПриЗагрузке = Параметры.НеЗамещатьДокументыПриЗагрузке;

КонецЕсли;

22                 

Обработчики "Конвертация"

После выгрузки объекта

Условия возникновения события

Событие вызывается после выгрузки объекта выборки, не зависимо от того, какой объект выгружается. Вызов осуществляется до вызова одноименного обработчика "Правила выгрузки данных". Могут использоваться все параметры орпределенные для одноименного обработчика. По сути и назначению это тот же обработчик, но определенный на глобальном уровне - то есть вызываемый для всех правил выгрузки данных. Обработчик вызывается только для объектов которые выгружаются непосредственно, а не когда объект выгружается, по тому что на него есть ссылка. В этом случае обработчики выгрузки не вызываются, а вызываются обработчики конвертации объекта.

Параметры:

Полностью совпадают с параметрами обработчика "После выгрузки объекта" у "Правила выгрузки данных"

Пример:

Параметры.СписокВсехВыгруженныхОбъектов.Добавить(Объект);

23                 

Обработчики "Конвертация"

После выгрузки данных

Условия возникновения события

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

Параметры:

Параметры - Структура, в которой хранятся переменные доступные во всех обработчиках

Пример:

Сообщить("Загрузка завершена.");

24                 

Обработчики "Конвертация"

Перед загрузкой данных

Условия возникновения события

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

Параметры:

Отказ - Булево. Если установить значение Истина, то загрузка данных не производится

Параметры - Структура, в которой хранятся переменные доступные во всех обработчиках

Пример:

Параметры.Вставить("НомерВерсии", Константы.НомерВерсииКонфигурации.Получить());

25                 

Обработчики "Конвертация"

После загрузки параметров

Условия возникновения события

Событие выполняется после загрузки параметров переданных из информационной базы источника в информационную базу приемника. Только для обмена V8-V8.

Параметры:

Отказ - булево. Служит для отказа от продолжения загрузки.

ПричинаОтказа - Строка. Содердит информацию о причине отказа от загрузки.

Пример:

Если Параметры.КодИнформационнойБазы <> 100 Тогда

    Отказ = Истина;

    ПричинаОтказа = "Неверный код информационной базы источника";

КонецЕсли;

26                 

Обработчики "Конвертация"

После получения информации об узлах обмена

Условия возникновения события

Событие выполняется только для on-line обмена при загрузке даннх после того как программа определила по какому узлу обмена будет выполнена загрузка данных.

Параметры:

Параметры - Структура, в которой хранятся переменные доступные во всех обработчиках

УзелОбменаЗагрузкаДанных - узел по которому будут загружаться данные

Пример:

Параметры.Вставить("КодУзлаДляЗагрузкиДанных", УзелОбменаЗагрузкаДанных .Код);

27                 

Обработчики "Конвертация"

Перед загрузкой объекта

Условия возникновения события

Событие выполняется перед началом загрузки объекта. Вызов осуществляется до вызова одноименного обработчика правила конвертации объектов. Могут использоваться все параметры определенные для одноименного обработчика правила конвертации объектов. По сути и назначению это тот же обработчик что и "Перед загрузкой объекта" вправиле конвертации объектов, но определенный на глобальном уровне - то есть вызываемый для всех правил конвертации объектов.

Параметры:

Полностью совпадают с параметрами обработчика "Перед загрузкой объекта" у "Правила конвертации объектов"

Пример:

Если Документы.ТипВсеСсылки().СодержитТип(ТипЗнч(Объект)) Тогда

 РежимПроведения = "Оперативный";

КонецЕсли;

28                 

Обработчики "Конвертация"

При получении удаления

Условия возникновения события

Событие выполняется только для On-Line обмена при получении данных об удалении объекта.

Параметры:

Объект - Объект который предполагается удалить при обмене.

Отказ - булево. Служит для отказа от удаления объекта.

Пример:

Если ТипЗнч(Объект) = Тип("ДокументОбъект.РеализацияТоваровУслуг") Тогда

    Отказ = Истина;

КонецЕсли;

29                 

Обработчики "Конвертация"

После загрузки объекта

Условия возникновения события

Событие выполняется после загрузки объекта. Вызов осуществляется до вызова одноименного обработчика правила конвертации объектов. Могут использоваться все параметры орпределенные для одноименного обработчика правила конвертации объектов. По сути и назначению это тот же обработчик что и "После загрузки объекта" в правиле конвертации объектов, но определенный на глобальном уровне - то есть вызываемый для всех правил конвертации объектов.

Параметры:

Полностью совпадают с параметрами обработчика "После загрузки объекта" у "Правила конвертации объектов"

Пример:

Если НЕ ОбъектНайден Тогда

 Объект.УстановитьНовыйКод();

КонецЕсли;

Объект.БазоваяЕдиницаИзмерения = Параметры.ЕдИзмеренияШтуки;

30                 

Обработчики "Конвертация"

После загрузки данных

Условия возникновения события

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

Параметры:

Параметры - Структура, в которой хранятся переменные доступные во всех обработчиках

Пример:

Сообщить("Загрузка данных из файла полностью завершена");

31                 

Обработчики "Параметры"

После загрузки

Условия возникновения события

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

Параметры:

Имя - имя параметра

Значение - значение параметра

Параметры - Структура, в которой хранятся переменные доступные во всех обработчиках

Пример:

Сообщить(Имя + ":" + Значение);

32                 

Обработчики "Правила конвертации объектов"

Перед выгрузкой

Условия возникновения события

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

Параметры:

Параметры - Структура, в которой хранятся переменные доступные во всех обработчиках

Источник - Произвольный - выгружаемый объект источник (ссылка или произвольные данные)

Приемник - Строка. Строковое представление объекта приемника. Может использоваться для тех правил, у ктоторых приемник является значением примитивного типа (Строка, Число, Булево, Дата) или если при помощи правила предполагается идентифицировать по имени предопреденные значения какого-либо ссылочного типа.

ВходящиеДанные - Произвольный - произвольные вспомогательные данные, переданные правилу конвертации из других правил (например из правила выгрузки данных или правила конвертации свойств). Значение параметра, как правило, имеет тип Структура, где ключи значений соответствуют структуре свойств объекта приемника. Таким образом, при конвертации свойств (в правиле конвертации свойств), конвертируемые данные (или часть данных) могут быть получены из этого параметра

ИсходящиеДанные - Произвольный - произвольные вспомогательные данные, передаваемые правилам конвертации свойств (ПКС).

ИмяПКО - Имя данного правила конвертации объектов

ПКО - ссылка на данное правило конвертации объектов

ВыгруженныеОбъекты - Соответствие.  Содержит перечень выгруженных по данному правилу объектов. Ключом соответствия является параметр КлючВыгружаемыхДанных, значением - число-номер объекта в файле. Может использоваться для проверки - выгружен ли объект по ссылкам из других объектов. В целях оптимизации, при выгрузке больших массивов данных, значение параметра может быть очищено - например в обработчике ПослеОбработкиПравилаВыгрузкиДанных

Отказ - Булево - Если Истина, то объект не выгружается

КлючВыгружаемыхДанных - Произвольный. По умолчанию - это ссылка на объект Источник, а если Источник неопределен, то используется ИмяПКО (подразумевается, что правило описывает в таком случае один объект-приемник). Данный параметр необходимо использовать если одному объекту источнику могут соответствовать несколько объектов приемника, например, в зависимости от входящих данных, или в случае, когда объект приемник полностью заполняется из входящих данных (например по результатам запроса), а объект источник, как таковой отсутствует.

ЗапоминатьВыгруженные - Булево. По умолчанию  - определяется в правилах обмена, но может быть изменено. Универсальная обработка выгрузки данных хранит все выгруженные объекты в специальном списке и, таким образом, многократно встречающиеся объекты (по ссылкам из реквизитов других объектов) выгружаются единожды. Однако, установив данный параметр в значение Ложь, можно отключить этот режим. Данный режим может быть полезен для оптимизации, например, когда точно известно, что на выгружаемые объекты нет ссылок, а так же в случае, когда на основании одного объекта-источника в зависимости от различных условий могут формироваться несколько различных объектов-приемников. Только для платформы 1С:Предприятие 8.

НеЗапоминатьВыгруженные - Булево. Параметр противоположный по смыслу параметру ЗапоминатьВыгруженные. По умолчанию  - определяется в правилах обмена, но может быть изменено. Только для платформы 1С:Предприятие 7.7.

НеЗамещатьОбъектПриЗагрузке - Булево. По умолчанию  - определяется в правилах обмена, но может быть изменено. Если для данного параметра установить значение Истина, то объект идентифицированный при загрузке (т.е. найденный в информационной базе приемнике по значению синхронизирующих полей) не будет изменен/замещен.

НеСоздаватьЕслиНеНайден – Булево. По умолчанию определяется в форме элемента правила конвертации объекта. Если Истина, то выполняется только поиск объекта в приемнике, новый объект не создается.

ВсеОбъектыВыгружены - Булево. Если установить Истина, то объект не выгружается - лишь формируется узел ссылки. В списке выгруженных - объект не ищется.

ТолькоПолучитьУзелСсылки - Если Истина, то объект не выгружается - лишь формируется узел ссылки. В списке выгруженных - объект ищется.

РегистрироватьОбъектНаУзлеОтправителе – Булево. По умолчанию - Ложь. Если установить значение параметра в Истина, то объект будет зарегистрирован к выгрузке в базе-приемнике при загрузке данных. Такой режим обмена необходим при расщеплении одного объекта в первой информационной базе на несколько дочерних объектов во второй информационной базе (разных типов метаданных). ПКО дочернего объекта в родительский объект должно выставлять этот флаг в значение Истина. ПКО родительского объекта в дочерний объект не должно поднимать этот флаг. В противном случае возможен случай бесконечной миграции объекта между парой обменивающихся информационных баз.

РежимЗаписи - Строка. Режим записи документа. Имеет смысл только если тип объекта приемника "Документ". Возможные значения "Запись", "Проведение", "ОтменаПроведения"

РежимПроведения - Строка. Режим проведения документа. Имеет смысл только если тип объекта приемника "Документ". Возможные значения "Неоперативный", "Оперативный"

Пример:

Отказ = Источник.ЭтоГруппа();

Если (ПустаяСтрока(Источник.Адрес) = 1) И 

 (ПустаяСтрока(Источник.АдресПочт) = 1) И

 (ПустаяСтрока(Источник.Телефоны) = 1) И

 (ПустаяСтрока(Источник.eMail) = 1) Тогда

 Отказ = 1;

КонецЕсли;

33                 

Обработчики "Правила конвертации объектов"

При выгрузке

Условия возникновения события

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

Параметры:

Источник - Произвольный - выгружаемый объект источник (ссылка или произвольные данные)

ВходящиеДанные - Произвольный - произвольные вспомогательные данные, переданные правилу конвертации из других правил (например из правила выгрузки данных или правила конвертации свойств). Значение параметра, как правило, имеет тип Структура, где ключи значений соответствуют структуре свойств объекта приемника. Таким образом, при конвертации свойств (в правиле конвертации свойств), конвертируемые данные (или часть данных) могут быть получены из этого параметра.

ИсходящиеДанные - Произвольный - произвольные вспомогательные данные, передаваемые правилам конвертации свойств (ПКС).

ИмяПКО - Имя данного правила конвертации объектов

ПКО - ссылка на данное правило конвертации объектов

ВыгруженныеОбъекты - Соответствие.  Содержит перечень выгруженных по данному правилу объектов. Ключом соответствия является параметр КлючВыгружаемыхДанных, значением - число-номер объекта в файле. Может использоваться для проверки - выгружен ли объект по ссылкам из других объектов. В целях оптимизации, при выгрузке больших массивов данных, значение параметра может быть очищено - например в обработчике ПослеОбработкиПравилаВыгрузкиДанных.

КлючВыгружаемыхДанных – значение ключа в соответствии «ВыгруженныеОбъекты». Только для платформы 1С:Предприятие 8.

Отказ – Булево. Если Истина, то объект выгружаться не будет.

СтандартнаяОбработка - Булево - Если установить значение Ложь, то стандартное заполнение Приемника не производится, то есть не выполняется обработка правил конвертации свойств.

Приемник - инициализированный xml-узел объекта приемника. Может быть дополнен призвольным xml-содержимым, например используемым при загрузке. В случае отключения СтандартнойОбработки, правила конвертации свойств (ПКС) не обрабатываются, т.е. необходимо реализовать алгоритм заполняющий узел приемника в соответствии с форматом файла обмена

УзелСсылки - инициализированный xml-узел ссылки. Может использоваться, например для инициализации свойств других объектов.

Пример:

ИнформацияОПользователе = СоздатьУзел("ИнформацияОПользователе");

УстановитьАтрибут(ИнформацияОПользователе, "АутентификацияОС", Источник.АутентификацияОС);

УстановитьАтрибут(ИнформацияОПользователе, "АутентификацияСтандартная", Источник.АутентификацияСтандартная);

УстановитьАтрибут(ИнформацияОПользователе, "ПоказыватьВСпискеВыбора", Источник.ПоказыватьВСпискеВыбора);

УстановитьАтрибут(ИнформацияОПользователе, "ПользовательОС", Источник.ПользовательОС);

УстановитьАтрибут(ИнформацияОПользователе, "ПолноеИмя", Источник.ПолноеИмя);

ЧислоРолей = 1;

Для Каждого Роль Из Источник.Роли Цикл

 УстановитьАтрибут(ИнформацияОПользователе, "Роль"+ЧислоРолей, Роль.Имя);

 Сообщить(Роль.Имя);

 ЧислоРолей = ЧислоРолей + 1;

КонецЦикла;

ДобавитьПодчиненный(Приемник, ИнформацияОПользователе);

34                 

Обработчики "Правила конвертации объектов"

После выгрузки

Условия возникновения события

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

Параметры:

Источник - Произвольный - выгружаемый объект источник (ссылка или произвольные данные)

ВходящиеДанные - Произвольный - произвольные вспомогательные данные, переданные правилу конвертации из других правил (например из правила выгрузки данных или правила конвертации свойств). Значение параметра, как правило, имеет тип Структура, где ключи значений соответствуют структуре свойств объекта приемника. Таким образом, при конвертации свойств (в правиле конвертации свойств), конвертируемые данные (или часть данных) могут быть получены из этого параметра.

ИсходящиеДанные - Произвольный - произвольные вспомогательные данные, передаваемые правилам конвертации свойств (ПКС).

ИмяПКО - Имя данного правила конвертации объектов

ПКО - ссылка на данное правило конвертации объектов

ВыгруженныеОбъекты - Соответствие.  Содержит перечень выгруженных по данному правилу объектов. Ключом соответствия является параметр КлючВыгружаемыхДанных, значением - число-номер объекта в файле. Может использоваться для проверки - выгружен ли объект по ссылкам из других объектов. В целях оптимизации, при выгрузке больших массивов данных, значение параметра может быть очищено - например в обработчике ПослеОбработкиПравилаВыгрузкиДанных.

КлючВыгружаемыхДанных – значение ключа в соответствии «ВыгруженныеОбъекты». Только для платформы 1С:Предприятие 8.

Отказ - Булево - Если Истина, то выгруженный объект в файл не записывается

Приемник - xml-узел объекта приемника, заполненный в соответствии с правилом

УзелСсылки - инициализированный xml-узел ссылки. Может использоваться, например для инициализации свойств других объектов

Пример:

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

Запрос = Новый Запрос("

|ВЫБРАТЬ

| КонтактнаяИнформация.Объект,

| КонтактнаяИнформация.Тип,

| КонтактнаяИнформация.Вид,

| КонтактнаяИнформация.Представление,

| КонтактнаяИнформация.Поле1,

| КонтактнаяИнформация.Поле2,

| КонтактнаяИнформация.Поле3,

| КонтактнаяИнформация.Поле4,

| КонтактнаяИнформация.Поле5,

| КонтактнаяИнформация.Поле6,

| КонтактнаяИнформация.Поле7,

| КонтактнаяИнформация.Поле8,

| КонтактнаяИнформация.Поле9,

| КонтактнаяИнформация.Поле10,

| КонтактнаяИнформация.Комментарий

|ИЗ

| РегистрСведений.КонтактнаяИнформация КАК КонтактнаяИнформация

|ГДЕ

| КонтактнаяИнформация.Объект = &Объект");

Запрос.УстановитьПараметр("Объект", Источник);

Выборка = Запрос.Выполнить().Выбрать();

Сообщить(Выборка.Количество());

Пока Выборка.Следующий() Цикл

 ВыгрузитьПоПравилу(Выборка, , , , "КонтактнаяИнформация");

КонецЦикла;

35                 

Обработчики "Правила конвертации объектов"

После выгрузки в файл

Условия возникновения события

Событие выполняется после выгрузки объекта в файл обмена. Может быть использован для выгрузки дополнительной информации по выгруженному объекту в файл обмена. При этом информация будет записана в файл обмена после выгруженного объекта.

Параметры:

Источник - Произвольный - выгружаемый объект источник (ссылка или произвольные данные)

ВходящиеДанные - Произвольный - произвольные вспомогательные данные, переданные правилу конвертации из других правил (например из правила выгрузки данных или правила конвертации свойств). Значение параметра, как правило, имеет тип Структура, где ключи значений соответствуют структуре свойств объекта приемника. Таким образом, при конвертации свойств (в правиле конвертации свойств), конвертируемые данные (или часть данных) могут быть получены из этого параметра.

ИсходящиеДанные - Произвольный - произвольные вспомогательные данные, передаваемые правилам конвертации свойств (ПКС).

ИмяПКО - Имя данного правила конвертации объектов

ПКО - ссылка на данное правило конвертации объектов

ВыгруженныеОбъекты - Соответствие.  Содержит перечень выгруженных по данному правилу объектов. Ключом соответствия является параметр КлючВыгружаемыхДанных, значением - число-номер объекта в файле. Может использоваться для проверки - выгружен ли объект по ссылкам из других объектов. В целях оптимизации, при выгрузке больших массивов данных, значение параметра может быть очищено - например в обработчике ПослеОбработкиПравилаВыгрузкиДанных.

Приемник - xml-узел объекта приемника, заполненный в соответствии с правилом

УзелСсылки - инициализированный xml-узел ссылки. Может использоваться, например для инициализации свойств других объектов

Пример:

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

Запрос = Новый Запрос("

|ВЫБРАТЬ

| КонтактнаяИнформация.Объект,

| КонтактнаяИнформация.Тип,

| КонтактнаяИнформация.Вид,

| КонтактнаяИнформация.Представление,

| КонтактнаяИнформация.Поле1,

| КонтактнаяИнформация.Поле2,

| КонтактнаяИнформация.Поле3,

| КонтактнаяИнформация.Поле4,

| КонтактнаяИнформация.Поле5,

| КонтактнаяИнформация.Поле6,

| КонтактнаяИнформация.Поле7,

| КонтактнаяИнформация.Поле8,

| КонтактнаяИнформация.Поле9,

| КонтактнаяИнформация.Поле10,

| КонтактнаяИнформация.Комментарий

|ИЗ

| РегистрСведений.КонтактнаяИнформация КАК КонтактнаяИнформация

|ГДЕ

| КонтактнаяИнформация.Объект = &Объект");

Запрос.УстановитьПараметр("Объект", Источник);

Выборка = Запрос.Выполнить().Выбрать();

Сообщить(Выборка.Количество());

Пока Выборка.Следующий() Цикл

 ВыгрузитьПоПравилу(Выборка, , , , "КонтактнаяИнформация");

КонецЦикла;

36                 

Обработчики "Правила конвертации объектов"

Поля поиска

Условия возникновения события

Только для платформы V8.

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

Поиск возможен только по тем полям у которых на этапе выгрузка был установлен флаг поиска данных!!!

Параметры:

НомерВариантаПоиска - число. Номер попытки поиска. Попыток поиска может быть не больше 10.

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

ПараметрыОбъекта - либо Неопределено либо Соответствие, в котором хранятся дополнительные параметры, переданные для данного объекта из источника в приемник. Если параметров передано не было, то ПараметрыОбъекта = Неопределено. В данном обработчике соответствие содержит только те параметры, для которых установлен признак поиска.

ПрекратитьПоиск - булево. Если Истина, то поиск объекта прекращается, в зависимости от того СсылкаНаОбъект заполнена или нет создается новый объект.

СсылкаНаОбъект - ссылка на результирующий объект. Если в обработчике установить данную ссылку (не пустую) то программа ее запомнит и поиск на этом будет считать успешно завершенным

УстанавливатьУОбъектаВсеСвойстваПоиска - булево. Определяет нужно ли после удачного завершения поиска установить объекту все реквизиты поиска. Объект может быть найден по части реквизитов. Этот флаг определяет нужно оставшиеся реквизиты, которые не участвовали в поиске (но по которым поиск возможен) установить объекту или нет. Значение по умолчанию: Истина.

НастройкаПоиска - строка. Выбранный пользователем вариант сопоставления объектов. В ПКО есть таблица Варианты настроек полей поиска - с возможными вариантами настроек полей поиска для пользователя. Разработчик правил определяет возможные комбинации полей поиска, которые пользователь может выбирать при настройке обмена. Все настройки указанные разработчиком правил должны быть отработаны в коде обработчика "Поля поиска". Переменная НастройкаПоиска в обработчике определяет выбранный пользователем вариант сопоставления (ИмяНастройкиДляАлгоритма из соответствующей строки таблицы). Если пользователь не выбрал ни один вариант сопоставления, или ему ни один вариант не был предложен, то НастройкаПоиска - пустая строка.

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

Пример:

Если НомерВариантаПоиска = 1 тогда

 СтрокаИменСвойствПоиска = "Код, Наименование";

ИначеЕсли НомерВариантаПоиска = 2 тогда

 СтрокаИменСвойствПоиска = "Код";

Иначе

 СтрокаИменСвойствПоиска = "Наименование";

КонецЕсли;

37                 

Обработчики "Правила конвертации объектов"

Перед загрузкой

Условия возникновения события

Только для платформы V8.

Событие выполняется перед загрузкой объекта. Возможен отказ от загрузки, например, в случае невыполнения каких-либо условий. Загружаемый в БД объект еще не инициализирован.

Параметры:

Отказ - Булево - Если Истина, то объект загружен не будет.

Нпп - Число. Уникальный порядковый номер объекта в файле.

Источник - Строка. Представление объекта источника. Пустая строка, если представление объекта источника не выгружалось.

ИмяПравила - Строка. Имя правила конвертации. Пустая строка, если правила конвертации не используются.

Правило – строка таблицы значений. Ссылка на правило конвертации объекта.

ГенерироватьНовыйНомерИлиКодЕслиНеУказан – Булево. Если Истина и номер или код объекта не заданы, то перед записью будет сгенерирован новый номер или код.

ТипОбъектаСтрокой - Строка. Тип загружаемого объекта. Например: СправочникСсылка.Номенклатура или РегистрСведенийЗапись.ЦеныТоваров

ТипОбъекта - Значение типа Тип. Тип загружаемого объекта.

НеЗамещатьОбъект - Если для данного параметра установить значение Истина, то объект идентифицированный при загрузке (т.е. найденный в информационной базе приемнике по значению синхронизирующих полей) не будет изменен/замещен.

РежимЗаписи - Строка. Режим записи документа. Имеет смысл только если тип объекта приемника "Документ". Возможные значения "Запись", "Проведение", "ОтменаПроведения"

РежимПроведения - Строка. Режим проведения документа. Имеет смысл только если тип объекта приемника "Документ". Возможные значения "Неоперативный", "Оперативный"

Пример:

РежимЗаписи = "ОтменаПроведения";

38                 

Обработчики "Правила конвертации объектов"

При загрузке

Условия возникновения события

Только для платформы V8.

Событие выполняется после попытки идентификации. В случае успешной синхронизации доступен найденный объект. В противном случае его значение Неопределено. Можно произвести произвольную инициализацию, заполняемого данными объекта.

Параметры:

ОбъектНайден - Булево. Если значение параметра равно Ложь, то объект не идентифицирован, то есть не найден в информационной базе

Объект - Произвольный. Загружаемый, модифицируемый объект, созданный по ссылке или найденный в информационной базе. Если способ идентификации объекта в файле не указан (т.е. отсутствует узел "Ссылка"), то параметр содержит значение Неопределено. В этом случае в обработчике возможна произвольная инициализация загружаемого объекта, в противном случае, объект будет создан автоматически.

НеЗамещатьОбъект - Булево - Если установить значение Истина, то существующий объект информационной базы не будет изменен.

ОбъектМодифицирован – Булево. Флажок указывает на то, что в обработчике объект был модифицирован. По умолчанию содержит значение Истина. То есть обработка загрузки считает, что если выполнялся какой-либо обработчик, то объект мог быть модифицирован, и его необходимо записать в информационную базу. Параметр относится только к текущему обработчику и только к найденным объектам. Если объект не был найден, то при любом значении он будет создан и записан. Только для платформы 1С:Предприятие 8.

Пример:

Пользователь = ПользователиИнформационнойБазы.НайтиПоИмени(СокрЛП(Объект.Код));

Если Пользователь = Неопределено Тогда

 Пользователь = ПользователиИнформационнойБазы.СоздатьПользователя();

 Пользователь.Имя      = СокрЛП(Объект.Код);

 Пользователь.ПолноеИмя = СокрЛП(Объект.Код);

КонецЕсли;

Пока ФайлОбмена.Прочитать() Цикл

 ИмяУзла = ФайлОбмена.ЛокальноеИмя;

 ТипУзла = ФайлОбмена.ТипУзла;

 Если ИмяУзла = "ИнформацияОПользователе" И (ТипУзла = одТипУзлаXML_НачалоЭлемента) Тогда

  Пользователь.АутентификацияОС          = одАтрибут(ФайлОбмена, одТипБулево, "АутентификацияОС");

  Пользователь.АутентификацияСтандартная = одАтрибут(ФайлОбмена, одТипБулево, "АутентификацияСтандартная");

  Пользователь.ПоказыватьВСпискеВыбора   = одАтрибут(ФайлОбмена, одТипБулево, "ПоказыватьВСпискеВыбора");

  Пользователь.ПользовательОС            = одАтрибут(ФайлОбмена, одТипСтрока, "ПользовательОС");

  Пользователь.ПолноеИмя                 = одАтрибут(ФайлОбмена, одТипСтрока, "ПолноеИмя");

  СтрокаРоль1 = одАтрибут(ФайлОбмена, одТипСтрока, "Роль1");

  СтрокаРоль2 = одАтрибут(ФайлОбмена, одТипСтрока, "Роль2");

  СтрокаРоль3 = одАтрибут(ФайлОбмена, одТипСтрока, "Роль3");

 ИначеЕсли (ИмяУзла = "ИнформацияОПользователе") И (ТипУзла = одТипУзлаXML_КонецЭлемента) Тогда

  Прервать;

 КонецЕсли;

КонецЦикла;            

Пользователь.ОсновнойИнтерфейс = Метаданные.Интерфейсы.Полный;

Пользователь.Язык              = Метаданные.Языки.Русский;

Пользователь.Роли.Очистить();

Роль1 = Метаданные.Роли.Найти(СокрЛП(СтрокаРоль1));

Роль2 = Метаданные.Роли.Найти(СокрЛП(СтрокаРоль1));

Роль3 = Метаданные.Роли.Найти(СокрЛП(СтрокаРоль1));

Если НЕ Роль1 = Неопределено Тогда

 Пользователь.Роли.Добавить(Роль1);

КонецЕсли;

Если НЕ Роль2 = Неопределено Тогда

 Пользователь.Роли.Добавить(Роль2);

КонецЕсли;

Если НЕ Роль3 = Неопределено Тогда

 Пользователь.Роли.Добавить(Роль3);

КонецЕсли;

Пользователь.Записать();

39                 

Обработчики "Правила конвертации объектов"

После загрузки

Условия возникновения события

Только для платформы V8.

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

Параметры:

Отказ - Булево - Если Истина, то объект загружен не будет.

Объект - Произвольный - загруженный объект.

Ссылка – Произвольный – ссылка на найденный объект в информационной базе.

ОбъектНайден - Булево. Если значение параметра равно Ложь, то объект не идентифицирован, то есть не найден в информационной базе

ПараметрыОбъекта - либо Неопределено либо Соответствие, в котором хранятся дополнительные параметры переденные для данного объекта из источника в приемник. Если параметров передано не было, то ПараметрыОбъекта = Неопределено.

ОбъектМодифицирован – Булево. Флажок указывает на то, что в обработчике объект был изменен. По умолчанию содержит значение Истина. То есть обработка загрузки считает, что если выполнялся какой-либо обработчик, то объект мог быть модифицирован, и его необходимо записать в информационную базу. Параметр относится только к текущему обработчику. Если объект был изменен ранее, то при любом значении переменной ОбъектМодифицирован он будет записан. Только для платформы 1С:Предприятие 8.

ИмяТипаОбъекта – Строка. Имя типа загруженного объекта, например, «СправочникСсылка.Номенклатура».

Пример:

Объект.БазоваяЕдиницаИзмерения = Параметры.ЕдИзмеренияШтуки;

Объект.СтавкаНДС = Перечисления.СтавкиНДС.НДС18;

Если Объект.Услуга Тогда

 Объект.ВидНоменклатуры = Параметры.ВидНомУслуга;

Иначе

 Объект.ВидНоменклатуры = Параметры.ВидНомТовар;

КонецЕсли;

40                 

Обработчики "Правила конвертации свойств"

Перед выгрузкой

Условия возникновения события

Событие выполняется перед выгрузкой значения свойства. Возможен отказ от выгрузки. УзелСвойства еще не создан, конвертируемое значение Неопределено.

Параметры:

Источник - Произвольный. Ссылка на выгружаемый объект источник данных

Приемник - xml-узел формируемого объекта приемника

ВходящиеДанные - Произвольный. Произвольные вспомогательные данные, переданные правилу конвертации из других правил (например из правила выгрузки данных или правила конвертации свойств). Значение параметра, как правило, имеет тип Структура, где ключи значений соответствуют структуре свойств объекта приемника. Таким образом, при конвертации свойств (в ПКС), конвертируемые данные (или часть данных) могут быть получены из этого параметра.

ИсходящиеДанные - Произвольный. Произвольные вспомогательные данные, передаваемые правилам конвертации объектов свойств (ПКО).

ПКС - ссылка на правило конвертации свойств

ПКО - ссылка на правило конвертации объектов - родитель данного правила конвертации свойств

ОбъектКоллекции - ссылка на выгружаемый объект коллекции. Например, строка табличной части или запись регистра или строка таблицы значений или строка результата запроса и т.д.

Отказ - Булево - Если Истина, то конвертация свойства не производится, обработка данного правила конвертации свойств прекращается

Значение - Неопределено. Конвертируемое значение свойства. Если значение определить в теле обработчика, то стандартная процедура получения значения не будет происходить.

ТипПриемника - Строка. Тип свойства приемника. Для свойств не составных типов - всегда определен. Для свойств составных типов - определяется либо правилом конвертации, либо разработчиком конвертации

ИмяПКО - имя правила конвертации, по которому производится преобразование значения свойства. Может быть выбрано в зависимости от каких-либо условий.

ИмяПКОВидСубконто - имя правила конвертации, по которому производится преобразование вида субконто (только для свойств СубконтоДт и СубконтоКт записей регистра бухгалтерии). Может быть выбрано в зависимости от каких-либо условий.

Пусто - Булево - Ложь. Если установить Истина, то в приемник будет записано пустое значение свойства, соответствующего типа и дальнейшая обработка правила конвертации свойств будет прекращена

Выражение - Неопределено. Может быть указано произвольное строковое выражение на встроенном языке, результат вычисления которого при загрузке будет присвоен значению свойства. Если Выражение определить в теле обработчика, то дальнейшая обработка ПКС будет прекращена. Данная возможность, используется только если конфигурация-приемник реализована на платформе V8

НеЗамещать - Булево - по умолчанию определяется в настройках правила, но может быть изменено в теле обработчика. Если установить значение Истина, то для существующих объектов информационной базы установка свойства производиться не будет.

УзелКоллекцииСвойств - xml-узел коллекции свойств

Пример:

Если (ПустаяСтрока(Источник.НомерДокумента) = 0) И (ПустаяСтрока(Источник.Комментарий) = 0) Тогда

 Значение = "Номер документа: " + Источник.НомерДокумента + РазделительСтрок + "Комментарий: " + Источник.Комментарий;

ИначеЕсли (ПустаяСтрока(Источник.НомерДокумента) = 0) Тогда

 Значение = "Номер документа: " + Источник.НомерДокумента;

ИначеЕсли (ПустаяСтрока(Источник.Комментарий) = 0) Тогда

 Значение = "Комментарий: " + Источник.Комментарий;

Иначе

 Отказ = 1;

КонецЕсли;

41                 

Обработчики "Правила конвертации свойств"

При выгрузке