<< Щелкните, чтобы показать Содержание >> Интеграционные возможности > Набор средств интеграции > Интеграция с помощью веб-сервисов > Форматы обмена > Строковые форматы обмена

Формат пакета для задач

Contents

Структура формата пакета для задач:

<Object Type="Task" RouteCode="{Код типового маршрута}" >
<WorkflowParams>
<Param Name="{Имя параметра}" Type="{Тип параметра}" >{Значение параметра}</Param>
...
</WorkflowParams>
<Attachments>
<Attachment Type="Reference" ID="{ИД записи справочника}" RefCode="{Код справочника}" />
<Attachment Type="EDocument" ID="{ИД документа}" Name="{Наименование документа}" />
<Attachment Type="Link" ID="{ИД записи внешней системы}" ObjectType="{Тип объекта внешней системы}"
ObjectKey="{Код внешней системы}" />
...
</Attachments>
</Object>
...
<Object Type="EDocument" VED="{Вид документа}"
Name="{Наименование документа}" Editor="{Код приложения-редактора}" >
</Object>
<Object Type="Reference" Name="{Имя справочника}">
...
</Object>

Object – список параметров объекта.

Type. Тип объекта. Возможные значения:

•	Task – данные задач, которые нужно добавить в систему DIRECTUM;

•	EDocument – данные документов, которые нужно добавить в систему DIRECTUM. Подробнее см. раздел «Формат пакета для документов»;

•	Reference – данные записей справочников, которые нужно добавить, изменить, удалить в системе DIRECTUM. Подробнее см. раздел «Формат пакета для справочников».

RouteCode. Код типового маршрута.

WorkflowParams – список параметров типового маршрута.

Param – описание запрашиваемого параметра типового маршрута.

Name. Имя параметра.

Type. Тип параметра. Возможные значения:

•	Integer – целое число;

•	Float – дробное число;

•	String – строка;

•	Pick – признак;

•	DateTime – дата;

•	Boolean – логическое значение;

•	Task – задача;

•	Job – задание;

•	Folder – папка;

•	EDocument – документ;

•	ReferenceRecord – запись справочника;

•	User – пользователь;

•	Role – роль;

•	IntegerCollection – коллекция целых чисел;

•	FloatCollection – коллекция дробных чисел;

•	StringCollection – коллекция строк;

•	PickCollection – коллекция признаков;

•	DateTimeCollection – коллекция дат;

•	BooleanCollection – коллекция логических значений;

•	TaskCollection – коллекция задач;

•	JobCollection – коллекция заданий;

•	FolderCollection – коллекция папок;

•	EDocumentCollection – коллекция документов;

•	ReferenceRecordCollection – коллекция записей справочников;

•	UserCollection – коллекция пользователей;

•	RoleCollection – коллекция ролей;

•	UserList – список пользователей.

Для установки простых типов используется поле Value. Для коллекций и UserList – поле Values.

Пример объявления параметров:

Attachments – список вложений.

Attachment – описание вложения. Для различных типов вложений задаются атрибуты:

Атрибуты	Описание атрибутов
Запись справочника
ID	ИД записи справочника в системе DIRECTUM
RefCode	Код записи справочника системы
Type	Вложение типа «Запись справочника»

Примечание

Запись справочника существует в системе DIRECTUM или описана в этом же пакете

Атрибуты	Описание атрибутов
Документ
ID	ИД документа в системе DIRECTUM. Указывается для документов, которые уже находятся в системе DIRECTUM
Name	Наименование документа. Указывается для документов, которых еще нет в системе DIRECTUM. Документ с таким же наименованием должен быть включен в пакет
Type	Вложение типа «Документ»

Атрибуты	Описание атрибутов
Ссылка на объект внешней системы
ID	ИД записи внешней системы
ObjectKey	Код внешней системы
ObjectType	Тип объекта внешней системы
Type	Вложение типа «Ссылка на объект внешней системы»

Примечание

Система проверяет, существует ли запись справочника Связи с объектами интегрированных систем с переданными кодом интегрированной системы, именем справочника интегрированной системы (атрибут ObjectType) и ИД записи (атрибут ObjectKey). Если записи не существует, то создается новая запись, в которую заносятся переданные параметры. Полученная запись вкладывается в созданную задачу. Задача стартуется

В узле Attachment указываются только ссылки на записи справочника и документы.

Примечание

Формат пакета для задачи не меняется в зависимости от кода интегрируемой системы. От кода интегрируемой системы зависит только формат пакета для справочников.

Пример

Создание задачи по типовому маршруту «Согласование заявки на установку программного обеспечения» с параметрами:

•	код типового маршрута – «Д000022»;

•	вложение записи справочника Работники с ИД 103538.

<Object RouteCode="Д000022" Type="Task">
<WorkflowParams>
<Param Name="Обоснование" Type="String">Работа с офисными документами</Param>
<Param Name="НаименованиеПО" Type="String">Microsoft Word</Param>
<Param Name="КонтактныйТел" Type="String">123-456-789</Param>
<Param Name="Дата" Type="Date">2011-09-16</Param>
<Param Name="ЦЧисло" Type="Integer">1</Param>
<Param Name="ДЧисло" Type="Integer">50</Param>
</WorkflowParams>
<Attachments>
<Attachment ID="103538" RefCode="РАБ" Type="Reference"/>
</Attachments>
</Object>

Сообщество пользователей DIRECTUM