Перейти к содержанию

Описание XML тегов

Теги, начинающиеся с 1С, определяют настройки системы "1С:Предприятие", а начинающиеся с TC — настройки "Первой Формы" (TC — это аббревиатура TaskCenter, одной из ключевых внутренних подсистем "Первой Формы").

Общие настройки синхронизации

SyncSettings:

Экземпляр настроек синхронизации, используется один тег на XML настройку. Атрибуты SyncSettings:

Наименование Описание
Name Имя настроек, используется для отображения в списке настроек
OneCAddress Адрес сервиса "1С:Предприятие"
OneCUserName Имя пользователя в "1С:Предприятие" для доступа к сервису
OneCPassword Пароль пользователя в "1С:Предприятие" для доступа к сервису
TCAddress Адрес сервиса "Первой Формы"
TCUserName Имя пользователя в "Первой Форме" для доступа к сервису
TCPassword Пароль пользователя в "Первой Форме" для доступа к сервису
TCSommentOnEpChange Признак, публиковать в процессе синхронизации комментарии об изменении ДП (true) или нет (false). > ℹ️ Данный признак устанавливается только в общих настройках синхронизации, а не в настройках отдельных категорий
GUIDExtParamID ID доп. параметра типа "Текст", в котором сохраняется идентификатор записей из "1С:Предприятие". Этот ДП необходимо создать вручную в "Первой Форме". После настройки обмена данными этот ДП будет добавлен во все синхронизируемые категории. В ДП хранятся уникальные идентификаторы на объекты, участвующие в синхронизации. Для каждой базы "1С:Предприятие", с которой будет синхронизироваться "Первая Форма", нужен отдельный ДП для хранения GUID. > ℹ️ При наличии нескольких задач в категории с одинаковым GUID в ходе синхронизации обновляется только последняя задача с наибольшим значением TaskID. Новые задачи при этом не создаются.
UsersDic Название справочника в "1С:Предприятие", содержащего пользователей для синхронизации
QueryRepeatTime Интервал проверки очереди, в формате HH:mm:ss. Например, 00:05:00
UsersFilter Имя булевого реквизита "1С:Предприятие", возвращающего "да" или "нет" для каждого элемента UsersDic и обозначающего, нужно ли синхронизировать и создавать пользователя в "Первой Форме" или нет. Если этот атрибут не указан, но указан UsersDic, то синхронизируются все пользователи
UsersFilterIn1Forma Если реквизит установлен как true, то фильтрация пользователей будет происходить на стороне "Первой Формы", что позволит фильтровать по виртуальным реквизитам. Однако этот метод работает значительно медленнее, чем фильтрация по физическим реквизитам на стороне "1С:Предприятие"
TC1C_SyncLog Настройка логирования первичной выгрузки из 1С. Возможные значения:
-0 — лог-файлы синхронизации 1С отключены
-1 — лог-файлы синхронизации 1С полные (настройка по умолчанию)
-2 — в лог-файлах синхронизации 1С отображаются только ошибки
UpdateLookupsByGuids Настройка, позволяющая включить (true) и отключить (false) синхронизацию в 1С связанных ДП типа Lookup в Первой форме
SendErrorCommentToTask Настройка, позволяющая записывать комментарий в задаче и сообщение в логе об ошибке. По умолчанию (если опция не указана или пустая) устанавливается значение true
ImportStrategy Настройка, позволяющая опционально обновлять, создавать или обновлять+создавать при первичной выгрузке записи в 1Ф из 1С. Возможные значения:
-0 — Только создание
-1 — Только обновление
-2 — Создание и обновление (по умолчанию)
InboxQueueFlowId Настройка для обработки входящего потока из 1С на очередях событий со стороны Первой Формы. При отправке запроса из Первой Формы событие ставится в поток. Поток постепенно читается и, при возвращении ответа от 1С, обновляется GUID, если это необходимо. Возможные значения: -None (по умолчанию).

Синхронизация ДП

SyncRecords: Список настроек справочников для синхронизации, дочерний тег для SyncSettings. Содержит теги Record. Record:

Настройки синхронизации одного справочника, элемент списка SyncRecords. Атрибуты Record:

Наименование Описание Возможные значения
OneCDocName Системное имя справочника/документа в "1С:Предприятие"
OneCSynonym Псевдоним справочника/документа в "1С:Предприятие"
TCSubcatID ID категории в "Первой Форме", созданной для синхронизации с этим справочником/документом
TCSubcatName Название категории в "Первой Форме"
SyncSource Источник данных (только в источнике можно создавать задачи/документы. Таким образом, влияет только на создание задач) -_1C — источник "1С:Предприятие"
-_TC — источник "Первая Форма"
-Both — любая из сторон может выступать источником
SyncDirections Направление синхронизации, влияет на любые изменения -TwoSided — двусторонняя синхронизация
-From1CtoTC — данные синхронизируются только из "1C:Предприятие" в "Первую Форму"
-FromTCto1C — данные синхронизируются только из "Первой Формы" в "1С:Предприятие"
DefaultActionOnError Обработка входящих событий (при ошибке и не только) -NotAssigned — не назначено. Ошибка будет проигнорирована.
-Ignore — проигнорировать ошибку, не будет выполнено никаких дополнительных действий помимо уведомления.
-ForceAddToQuery — не пытаясь выполнить в реальном времени, сразу добавлять событие в очередь и выполнять позднее
-AddToQuery — при ошибке добавить в очередь и выполнить позднее
-Cancel — запретить и отклонить событие
DefaultNotificationOnError Способ уведомления при ошибке для справочника, по умолчанию -NotAssigned — не уведомлять пользователя
-Comment — добавить комментарий к задаче/документу
-Alert — выдать предупреждение
-Both — добавить комментарий к задаче/документу и выдать предупреждение
DefaultErrorMessage Сообщение об ошибке при синхронизации, по умолчанию; используется если не указано сообщение для конкретного события
DefaultSuccessMessage Сообщение при успешной синхронизации, по умолчанию; используется если не указано сообщение для конкретного события
SmartFilterID ID смарт-фильтра в категории, для фильтрации данных, отправляемых из "Первой Формы" в 1С (если не все задачи должны синхронизироваться) -ID смарт-фильтра
-0 — фильтрация отключена
DisableTaskTextSync Если значение False, то при синхронизации тексты задач в "Первой Форме" автоматически заменяются на тексты из 1С. Если значение True, то тексты задач в "Первой Форме" остаются без изменений -True
-False (по умолчанию)
InboxQueueFlowId Опциональное создание входящих потоков для синхронизируемых документов -None (по умолчанию).

Files:

Секция настроек синхронизации файлов для конкретного справочника. Атрибуты Files:

Наименование Описание Возможные значения
CatalogName Имя справочника "1С:Предприятие", в котором хранятся приложенные файлы
BinFileProperty Имя реквизита "1С:Предприятие", в котором хранятся двоичные данные файла
FileNameProperty Имя реквизита "1С:Предприятие", в котором хранится имя файла
OwnerProperty Имя реквизита "1С:Предприятие", в котором хранится ссылка на документ-владелец
SyncDirections Допустимое направление синхронизации файлов -TwoSided — двусторонняя синхронизация
-From1CtoTC — данные синхронизируются только из "1С:Предприятие" в "Первую Форму"
-FromTCto1C — данные синхронизируются только из "Первой Формы" в "1С:Предприятие"
ExtParamIDs Список ID ДП с типом "Файл", для которых нужно выполнять обмен с 1С. Синхронизация будет осуществляться только для этих ДП. Например, если в категории два ДП с типом "Файл", а в настройках указан только один из них, обмен будет инициироваться лишь при добавлении файла именно в этот ДП; при внесении изменений во вложения других ДП или общих вложений в задаче синхронизация не произойдет. -ID ДП с типом "Файл"

SyncProperties: Список настроек реквизитов для синхронизации, дочерний для Record, содержит список элементов Property Property:

Настройки синхронизации одного реквизита. Атрибуты Property:

Наименование Описание Возможные значения
RequisiteName Системное имя реквизита в "1С:Предприятие"
Synonym Имя реквизита в "1С:Предприятие"
ExtParamID ID доп. параметра в "Первой Форме"
ExtParamName Имя доп. параметра в "Первой Форме"
Type Тип доп. параметра в "Первой Форме" -Checkbox — флажок да/нет
-Combobox — выбор из выпадающего списка
-Date — дата
-DateTime — дата и время
-LookUpField — ссылка на задачу (документ)
-Money — деньги
-Numerator — число
-NumericValue — число
-Select — выбор из выпадающего списка
-Table — таблица
-Text — текст
-TextArea — большой текст
-TextareaWOFormat — большой текст без форматирования
-URL — нетипизированная ссылка
IsRequired Обязателен ли для заполнения. При создании категории в "Первой Форме" будет создано соответствующее ограничение -True
-False
<Links><Link Name="Справочник.ХХХ" />...</Links> Для типов "ссылка" (lookup). Указывается имя справочника, на который указывает ссылка (или нескольких справочников, если ДП настроен на сводный раздел). При указании имени справочника (названия категории-источника), поиск будет осуществлен во всех категориях системы. Если в БД найдена одна уникальная запись по GUID, она будет подставлена в Lookup-поле. Если глобальный поиск выдал более одной записи с одним GUID, система выдаст ошибку "...задачи с таким идентификатором не существует". В таком случае необходимо указать имя справочника из 1С - атрибут "OneCDocName" в соответствующей секции "Records".
TCLookupGUIDEPID Не заполняется вручную. ДП, хранящий GUID для синхронизации ссылок с "1С:Предприятие" (см. здесь)
OneCDateTimeFormat Для типов Дата, ДатаВремя — формат, в котором передаётся время в "1С:Предприятие". Пример: "HH:mm:ss". (больше не используется, см. Примечание 3)
PropertyUse Объекты в иерархии справочников (для документов не актуально), для которых можно использовать данный реквизит -ДляГруппыИЭлемента — для любого объекта
-ДляГруппы — только для группы
-ДляЭлемента — только для элемента
-Виртуальный — для виртуального реквизита
RepresentAsReadonlyText Свойство можно использовать в тех случаях, когда из 1С необходимо получить ссылочный объект, но в первой форме для его отображения достаточно только текстового представления (без необходимости синхронизации справочника, на который он ссылается). Если true и указан тип "ссылка", то будет передаваться как текстовое представление, без выгрузки подчиненного словаря. Пример: в 1С есть справочник "Склады", и нам в категории достаточно только текстовое представление. В таком случае мы можем создать ДП с типом "Текст", связать его с ссылочным типом "Склад из 1С" и установить признак RepresentAsReadonlyText="true". В результате чего в ДП будет передано текстовое представление ссылки, как это выглядит в 1С -True
-False
OneCEvents Список событий из 1С, при которых необходимо передавать данный реквизит. С помощью данных атрибутов можно более точечно настроить синхронизацию. Подробнее в разделе "Настройка списка передаваемых реквизитов". -Create — создание документа
-Modify — изменение документа
-Post — проведение
-ClearPost — отмена проведения
-Repost — перепроведение
-MarkDelete — пометка на удаление
-UnmarkDelete — снятие пометки на удаление
TcEvents Список событий из 1F, при которых необходимо передавать данный реквизит. С помощью данных атрибутов можно более точечно настроить синхронизацию. Подробнее в разделе "Настройка списка передаваемых реквизитов". -CreateTask — создание задачи
-ChangeTask — изменение доп. параметров в задаче
-ChangeToStatus — переход в статус
-MakeStep — переход по маршруту
-DeleteTask — удаление задачи
-FileUpload — вложение файла в задачу
-FileDelete — удаление файла
-EPFileUpload — загрузка файла в ДП
-CustomEvent — произвольное событие

Примечание 1. Таблица соответствия типов ДП "Первой Формы" и данных "1С:Предприятие":

Тип в "Первой Форме" Тип в "1С:Предприятие"
Checkbox Булево
Combobox, Select Перечисление (ПеречислениеСсылка)
Date, DateTime Дата
LookUpField Типизированная ссылка на справочник или документ (ДокументСсылка, СправочникСсылка)
NumericValue, Money, Numerator Число
Text, TextArea, TextAreaWOFormat Строка либо УникальныйИдентификатор
Table ТабличнаяЧасть
URL НетипизированнаяСсылка

Примечание 2. Любой тип можно отобразить на ДП типа "Текст". В таком случае в "Первую Форму" будет выгружено текстовое представление реквизита. Примечание 3. Чтобы избежать проблем, вызванных различиями региональных настроек серверов 1С, при отправке и получении данных в форматах Дата, Число и Булево всегда используются следующие маски: -Дата: dtYYYYMMDDHHMMSS, где dt — простой текстовый префикс, а HHMMSS — необязательные разряды (если тип поля Дата, а не ДатаВремя, то их можно пропускать); -Число: nm-123456.897 где nm — префикс, десятичный разделитель — точка, число разрядов до и после точки — любое, разделители тысяч не используются; -Булево: false и true. AllowedValues: Список разрешенных значений (для ДП "Выбор из нескольких значений" и для колонки "Выбор из выпадающего списка"). В списке элементы Value. Value:

Значение для выбора. Атрибуты Value:

Наименование Описание
Name Системное имя в "1С:Предприятие"
Synonym Отображаемое значение

TableColumns: Список настроек синхронизации колонок для ДП "Таблица". В списке элементы Column. Column:

Список настроек синхронизации для одной колонки ДП "Таблица".

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

Атрибуты Column:

Наименование Описание Возможные значения
Id ID колонки ДП "Таблица"
IsKey Обозначает ключевую колонку. Значения ключевой колонки в каждой строке таблицы должны быть уникальными. Ключевые колонки синхронизируются в обе стороны независимо от значения атрибута SyncSource. Если в таблице синхронизируются не все колонки, то в синхронизации должна обязательно участвовать ключевая колонка. Если ключевая колонка не указана, то при каждой синхронизации ДП "Таблица" вся табличная часть будет перезаписываться целиком. > ℹ️ В качестве ключевой может быть использована только одна колонка -True — колонка является ключевой. IsKey="true"
-False — колонка не является ключевой. IsKey="false"
Name Внутреннее имя колонки в "1С:Предприятие"
SyncSource Источник данных (определяет направление синхронизации) -_1C — источник "1С:Предприятие"
-_TC — источник "Первая Форма"
-Both — любая из сторон может выступать источником
Synonym Синоним колонки, видимый пользователям. При синхронизации ДП "Таблица", которая содержит столбец типа "Lookup поле", значение, указанное в поле Synonym для соответствующей колонки в XML-настройках, должно в точности совпадать с именем этого столбца в настройках самого ДП в интерфейсе Первой Формы.
Type Тип колонки в таблице -Checkbox — флажок да/нет
-Combobox — выбор из выпадающего списка
-Date — дата
-DateTime — дата и время
-LookUpField — ссылка на задачу(документ)
-Money — деньги
-Numerator — число
-NumericValue — число
-Select — выбор из выпадающего списка
-Text — текст
-TextArea — большой текст
-TextareaWOFormat — большой текст с форматированием
-Tree — дерево выбора
-URL — нетипизированная ссылка
<Links><Link Name="Справочник.ХХХ" />...</Links> Для типов "ссылка" (lookup). Указывается имя справочника, на который указывает ссылка (или нескольких справочников, если ДП настроен на сводный раздел). При указании имени справочника (названия категории-источника), поиск будет осуществлен во всех категориях системы. Если в БД найдена одна уникальная запись по GUID, она будет подставлена в Lookup-поле. Если глобальный поиск выдал более одной записи с одним GUID, система выдаст ошибку "...задачи с таким идентификатором не существует". В таком случае необходимо указать имя справочника из 1С - атрибут "OneCDocName" в соответствующей секции "Records".
RepresentAsReadonlyText Свойство можно использовать в тех случаях, когда из 1С необходимо получить ссылочный объект, но в первой форме для его отображения достаточно только текстового представления (без необходимости синхронизации справочника, на который он ссылается). Если true и указан тип "ссылка", то будет передаваться как текстовое представление, без выгрузки подчиненного словаря. Пример: в 1С есть справочник "Склады", и нам в категории достаточно только текстовое представление. В таком случае мы можем создать ДП с типом "Текст", связать его с ссылочным типом "Склад из 1С" и установить признак RepresentAsReadonlyText="true". В результате чего в ДП будет передано текстовое представление ссылки, как это выглядит в 1С -True
-False

Обработка событий из 1С в "Первой Форме"

SyncEvents1C: События "1С:Предприятие" и действия, выполняющиеся по ним в "Первой Форме". Элементы списка — Event1С.

Event1C:

Событие "1С:Предприятие". Атрибуты Event1C:

Наименование Описание Возможные значения
Event Тип события в "1С:Предприятие" -Create — создание документа
-Modify — изменение документа
-Post — проведение
-ClearPost — отмена проведения
-Repost — перепроведение
-MarkDelete — пометка на удаление
-UnmarkDelete — снятие пометки на удаление
> ℹ️ Для синхронизации изменений в документах необходимо использовать события Post и Repost вместо Modify
Action Действие в "Первой Форме" по событию -ChangeTask — изменить/создать задачу
-ChangeToStatus — перевести в статус
-DeleteTask — удалить задачу
Status Только для действия ChangeToStatus. ID статуса, в который нужно перейти
IsAllowed Разрешено ли пользователю в "1С:Предприятие" делать действие, приводящее к данному событию. Если запрещено, то "Первая Форма" вернет на это событие в "1С:Предприятие" "отказ", что вызовет либо отклонение событие в соответствии с CanBeDeclined, либо просто пользователь будет уведомлен -True
-False
CanBeDeclined Может ли "Первая Форма" отклонить событие. Если может, то в случае ошибки "1С:Предприятие" отменит действие, вызвавшее событие, и вернет документ в исходное состояние -True
-False
RefreshExtParams Обновить значение доп. параметров независимо от настроенного действия в "Первой Форме" на событие. При RefreshExtParam=true будут обновлены все ДП. При RefreshExtParam=false обновляются только измененные реквизиты и виртуальные реквизиты (у которых свойство PropertyUse = "Виртуальный"), а также табличные части. Если объект новый, то в любом случае отправляются все реквизиты -True
-False
ActionOnError Действие при ошибке. Если не назначено, то берется действие, указанное в описании документа/справочника по умолчанию -NotAssigned — не назначено
-Ignore — проигнорировать
-ForceAddToQuery — сразу добавить в очередь и выполнить позднее не пытаясь выполнить
-AddToQuery — добавить в очередь и выполнить позднее
-Cancel — запретить и отклонить событие
NotificationsOnError Способ уведомление при ошибке. Если не назначено, то берется способ уведомления, указанный в описании документа/справочника по умолчанию -NotAssigned — не уведомлять пользователя
-Comment — добавить комментарий к задаче/документу
-Alert — выдать предупреждение
-Both — добавить комментарий к задаче/документу и выдать предупреждение
MessageOnError Сообщение при ошибке
AddCommentOnSuccess Добавлять ли комментарий при успехе -True
-False
MessageOnSuccess Сообщение при успехе

Обработка событий из "Первой Формы" в 1С

SyncEventsTC (TCEventsReqSync):

События "Первой Формы" и действия, выполняемые по ним в "1С:Предприятие". SyncEventsTC и TCEventsReqSync полностью аналогичны. Элементы списка — EventTC для SyncEventsTC и TCSyncEvent для TCEventsReqSync.

EventTC (TCSyncEvent):

Событие "Первой Формы". EventTC и TCSyncEvent полностью аналогичны. EventTC — дочерний тег SyncEventsTC, а TCSyncEvent — дочерний тег TCEventsReqSync. При изменении ДП в 1С отправляется только значение измененного ДП. Если нужно синхронизировать все ДП, используйте смарт-действие "Синхронизировать доп.параметры задач". При наступлении событий ChangeToStatus и MakeStep система передаёт полный состав реквизитов в соответствии с настройками, включая поля с пустыми значениями. Это гарантирует, что в "1С:Предприятие" своевременно очищаются все ранее заполненные, а затем удалённые данные. При событии ChangeTask передаётся только конкретное изменённое значение. Атрибуты EventTC (TCSyncEvent):

Наименование Описание Возможные значения
Event Тип события в "Первой Форме" -CreateTask — создание задачи
-ChangeTask — изменение доп. параметров в задаче
-ChangeToStatus — переход в статус
-MakeStep — переход по маршруту
-DeleteTask — удаление задачи
-FileUpload — вложение файла в задачу
-FileDelete — удаление файла
-EPFileUpload — загрузка файла в ДП
-CustomEvent — произвольное событие
Action Действие в "1С:Предприятие" по событию -Create — создать документ (Если документ с текущим GUID-ом уже создан, то действие аналогично Modify)
-Modify — изменить документ
-Post — провести
-ClearPost — отменить проведение
-Repost — перепровести
-Lock — заблокировать
-Unlock — разблокировать
-MarkDelete — пометить на удаление
-UnmarkDelete — снять пометку на удаление
Status Только для события ChangeToStatus. ID статуса, при переходе в который выполняется действие
Step Только для события MakeStep. ID перехода, для которого выполняется действие
OnlyForce Только для события ChangeToStatus. Выполнять действие только при принудительных переходах или же при любых -True
-False
ActionOnError Действие при ошибке. Если не назначено, то берется действие, указанное в описании документа/справочника по умолчанию -NotAssigned — не назначено
-Ignore — проигнорировать
-ForceAddToQuery — сразу добавить в очередь и выполнить позднее не пытаясь выполнить
-AddToQuery — добавить в очередь и выполнить позднее
-Cancel — запретить и отклонить событие
NotificationsOnError Способ уведомления при ошибке. Если не назначено, то берется способ уведомления, указанный в описании документа/справочника по умолчанию -NotAssigned — не уведомлять пользователя
-Comment — добавить комментарий к задаче/документу
-Alert — выдать предупреждение
-Both — добавить комментарий к задаче/документу и выдать предупреждение
MessageOnError Сообщение при ошибке
AddCommentOnSuccess Добавлять ли комментарий при успехе -True
-False
MessageOnSuccess Сообщение при успехе

Примеры использования тегов:

Из "1С:Предприятие" в "Первую Форму"

<SyncEvents1C>
<Event1C Event="Create" Action="ChangeTask" IsAllowed="true" CanBeDeclined="true" RefreshExtParams="true" ActionOnError="Cancel" NotificationsOnError="Both" AddCommentOnSuccess="false" MessageOnSuccess="1Ф Новая запись Объект" />
<Event1C Event="Modify" Action="ChangeTask" IsAllowed="true" CanBeDeclined="true" RefreshExtParams="true" ActionOnError="Cancel" NotificationsOnError="Both" AddCommentOnSuccess="false" MessageOnSuccess="Обновлена запись" />
<Event1C Event="Post" Action="ChangeTask" IsAllowed="true" CanBeDeclined="true" RefreshExtParams="true" ActionOnError="Cancel" NotificationsOnError="Both" AddCommentOnSuccess="false" MessageOnSuccess="Обновлена запись" />
<Event1C Event="MarkDelete" Action="ChangeToStatus" Status="43" IsAllowed="true" CanBeDeclined="true" RefreshExtParams="true" ActionOnError="Cancel" NotificationsOnError="Both" AddCommentOnSuccess="false" MessageOnSuccess="Объект помечен на удаление" />
<Event1C Event="UnmarkDelete" Action="ChangeToStatus" Status="44" IsAllowed="true" CanBeDeclined="true" RefreshExtParams="true" ActionOnError="Cancel" NotificationsOnError="Both" AddCommentOnSuccess="false" MessageOnSuccess="Снята пометка на удаление" />
</SyncEvents1C>

Из "Первой Формы" в "1С:Предприятие"

<SyncEventsTC>
<EventTC Event="CreateTask" Action="Modify" ActionOnError="Cancel" NotificationsOnError="Both" AddCommentOnSuccess="false" />
<EventTC Event="ChangeTask" Action="Modify" ActionOnError="Cancel" NotificationsOnError="Both" AddCommentOnSuccess="false" />
<EventTC Event="ChangeToStatus" Status="334" Action="Modify" ActionOnError="Cancel" NotificationsOnError="Both" AddCommentOnSuccess="false" />
<EventTC Event="MakeStep" Step="12" Action="Modify" ActionOnError="Cancel" NotificationsOnError="Both" AddCommentOnSuccess="false" />
<EventTC Event="CustomEvent" CustomEventID="7" Action="Modify" ActionOnError="Cancel" NotificationsOnError="Both" AddCommentOnSuccess="false" />
</SyncEventsTC>

ℹ️ Для документов "1С:Предприятие", поддерживающих механизм проведения, используются методы Create (создание), Post (проведение), Repost (перепроведение) и ClearPost (отмена проведения). Для документов, не поддерживающих проведение, — Create (создание) и Modify (изменение).