Руководство администратора

Обратная связь

Описание 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

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 (по умолчанию).

•{flowId}

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

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 (по умолчанию). •{flowId}

Files

Секция настроек синхронизации файлов для конкретного справочника.

Атрибуты Files:

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

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	Если true и указан тип "ссылка", то будет передаваться как текстовое представление, без выгрузки подчиненного словаря	•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 колонки ДП "Таблица"

IsKey

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

Обратите внимание: в качестве ключевой может быть использована только одна колонка

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

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

Возможные значения:

•True — колонка является ключевой. IsKey="true"

•False — колонка не является ключевой. IsKey="false"

Name

Внутреннее имя колонки в "1С:Предприятие"

SyncSource

Источник данных (определяет направление синхронизации)

Возможные значения:

•_1C — источник "1С:Предприятие"

•_TC — источник "Первая Форма"

•Both — любая из сторон может выступать источником

Synonym

Синоним колонки, видимый пользователям

Type

Тип колонки в таблице

•Checkbox — флажок да/нет

•Combobox — выбор из выпадающего списка

•Date — дата

•DateTime — дата и время

•LookUpField — ссылка на задачу(документ)

•Money — деньги

•Numerator — число

•NumericValue — число

•Select — выбор из выпадающего списка

•Text — текст

•TextArea — большой текст

•TextareaWOFormat — большой текст с форматированием

•Tree — дерево выбора

•URL — нетипизированная ссылка

Для типов "ссылка" (lookup). Указывается имя справочника, на который указывает ссылка (или нескольких справочников, если ДП настроен на сводный раздел)

При указании имени справочника (названия категории-источника), поиск будет осуществлен во всех категориях системы. Если в БД найдена одна уникальная запись по GUID, она будет подставлена в Lookup-поле. Если глобальный поиск выдал более одной записи с одним GUID, система выдаст ошибку "...задачи с таким идентификатором не существует". В таком случае необходимо указать имя справочника из 1С - атрибут "OneCDocName" в соответствующей секции "Records".

RepresentAsReadonlyText

Если true и указан тип "ссылка", то будет передаваться как текстовое представление, без выгрузки подчиненного словаря

•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С отправляется только значение измененного ДП. Если нужно синхронизировать все ДП, используйте смарт-действие "Синхронизировать доп.параметры задач".

Атрибуты 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>

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

</SyncEventsTC>

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