Ситуация

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

Решение

Чтобы задачу можно было стартовать с помощью запроса к сервису интеграции, в среде разработки напишите интеграционную функцию, которая по заданному идентификатору найдет задачу и стартует ее. Запросами к сервису определите исполнителя – запись справочника Сотрудники (Employee). Создайте в Directum RX простую задачу (SimpleTask) и добавьте в нее этап маршрута (BlockRouteStep) для найденного исполнителя. Затем вызовите функцию, передав в нее идентификатор созданной задачи из предыдущего ответа сервиса. Для этого:

1.В среде разработки Directum RX в своем решении добавьте интеграционную функцию для старта простой задачи. Интеграционная функция должна выполняться на сервере. Поэтому в редакторе модуля в группе «Функции» перейдите по ссылке Серверные и создайте функцию StartSimpleTaskFromExternalSystem() с атрибутом [Public(WebApiRequestType = RequestType.Post)]. Для этого добавьте код:

[Public(WebApiRequestType = RequestType.Post)]

public void StartSimpleTaskFromExternalSystem(long Id)
{
  // Найти созданную задачу по идентификатору.
  var task = Tasks.Get(Id);
  // Стартовать задачу.
  task.Start();
}

2.Опубликуйте разработку.

3.В среде разработки с установленной библиотекой Simple.OData.Client создайте приложение, например консольное. В коде задайте URL запроса, аутентификационные данные и обязательные заголовки. Подробнее см. раздел «Разработка консольного приложения для интеграции».

4.Напишите пакетный запрос, в котором создайте простую задачу в Directum RX и этап маршрута для нее. В запросе заполните обязательные свойства:

•Тема задачи (Subject);

•Текст задачи (свойство-коллекция Texts);

•Срок (Deadline);

•Кому (Performer);

•Этап маршрута (свойство-коллекция RouteSteps).

Пример кода для создания запроса:

// Задать текст и срок задачи.

var taskText = "Текст задачи";
var oneDayDeadline = Calendar.Today.AddWorkingDays(1);
// Создать пакетный запрос.
var odataBatchRequest = new ODataBatch(odataClientSettings);
// Создать переменную postRequestsResult для сохранения ответов сервиса
// интеграции.
object postRequestsResult;
// Найти исполнителя по имени. Для упрощения считаем, что в ответе сервиса
// интеграции будет список с одним соответствием.
var taskPerformer = await odataClient.For("IEmployees")
  .Expand("Person")
  .Filter("contains(Person/Name, 'Ардо Наталья Алексеевна')")
  .FindEntriesAsync();
var taskPerformerId = taskPerformer.First()["Id"];
// Создать задачу типа SimpleTask.
odataBatchRequest += async odataClient => postRequestsResult = await odataClient.For("ISimpleTasks")
  .Set(new { Id = -1, Subject = "Тема задачи", Deadline = oneDayDeadline })
  .InsertEntryAsync();
// Добавить текст задачи для сущности с идентификатором -1.
odataBatchRequest += async odataClient => await odataClient.For("ISimpleTasks").Key(-1)
  .NavigateTo("Texts")
  .Set(new { Number = 1, Text = taskText }) 
  .InsertEntryAsync();
// Добавить этап маршрута для сущности с идентификатором -1.
odataBatchRequest += async odataClient => await odataClient.For("ISimpleTasks").Key(-1)
  .NavigateTo("RouteSteps")
  .Set(new { Performer = taskPerformerId })
  .InsertEntryAsync();
// Выполнить пакетный запрос.
await odataBatchRequest.ExecuteAsync();

5.Чтобы стартовать созданную задачу, отправьте POST-запрос к функции StartSimpleTaskFromExternalSystem(). В качестве идентификатора используйте идентификатор из ответа сервиса интеграции. Пример кода для запроса:

// Стартовать задачу.

await odataClient
 .For("MyModuleName")
 .Action("StartSimpleTaskFromExternalSystem")
 .Set(new { taskId = postRequestsResult["Id"] })
 .ExecuteAsync();

6.Запустите приложение.

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

Ситуация

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

Решение

Чтобы задачу можно было стартовать с помощью запроса к сервису интеграции, в среде разработки напишите интеграционную функцию, которая по заданному идентификатору найдет задачу и стартует ее. Создайте в Directum RX задачу на свободное согласование (FreeApprovalTask), добавьте согласующих и документ во вложение. Затем вызовите функцию, передав в нее идентификатор созданной задачи из предыдущего ответа сервиса. Для этого:

1.В среде разработки Directum RX в своем решении добавьте интеграционную функцию для старта простой задачи. Интеграционная функция должна выполняться на сервере. Поэтому в редакторе модуля в группе «Функции» перейдите по ссылке Серверные и создайте функцию StartFreeApprovalTaskFromExternalSystem() с атрибутом [Public(WebApiRequestType = RequestType.Post)]. Для этого добавьте код:

[Public(WebApiRequestType = RequestType.Post)]

public void StartFreeApprovalTaskFromExternalSystem(long Id)
{
  // Найти созданную задачу по идентификатору.
  var task = Tasks.Get(Id);
  // Стартовать задачу.
  task.Start();
}

2.Опубликуйте разработку.

3.В среде разработки с установленной библиотекой Simple.OData.Client создайте приложение, например консольное. В коде задайте URL запроса, аутентификационные данные и обязательные заголовки. Подробнее см. раздел «Разработка консольного приложения для интеграции».

4.Напишите пакетный запрос, в котором в котором создайте задачу на свободное согласование в Directum RX, согласующих и документ во вложение. В запросе заполните обязательные свойства:

•Тема задачи (Subject);

•Текст задачи (свойство-коллекция Texts):

•Срок (MaxDeadline);

•Согласующие (Approvers).

Пример кода для создания запроса:

// Задать текст и срок задачи.

var taskText = "Текст задачи";
var oneDayDeadline = Calendar.Today.AddWorkingDays(1);
// Создать пакетный запрос.
var odataBatchRequest = new ODataBatch(odataClientSettings);
// Создать переменную postRequestsResult для сохранения ответов сервиса
// интеграции.
object postRequestsResult;
// Найти согласующих по имени. Для упрощения считаем, что в ответе сервиса
// интеграции будет список с одним соответствием.
var taskApprover = await odataClient.For("IEmployees")
  .Expand("Person")
  .Filter("contains(Person/Name, 'Ардо Наталья Алексеевна')")
  .FindEntriesAsync();
var taskApproverId = taskApprover.First()["Id"];
// Создать задачу типа FreeApprovalTask.
odataBatchRequest += async odataClient => postRequestsResult = await odataClient.For("IFreeApprovalTasks")
  .Set(new { Id = -1, Subject = "Тема задачи", MaxDeadline = oneDayDeadline })
  .InsertEntryAsync();
// Добавить текст задачи для сущности с идентификатором -1.
odataBatchRequest += async odataClient => await odataClient.For("IFreeApprovalTasks").Key(-1)
  .NavigateTo("Texts")
  .Set(new { Number = 1, Text = taskText }) 
  .InsertEntryAsync();
// Добавить документ во вложение.
odataBatchRequest += async odataClient => await odataClient.For("IFreeApprovalTasks").Key(-1)
  .NavigateTo("AttachmentDetails")
  .Set(new { AttachmentId = 192, AttachmentTypeGuid= "5a49b9d1-2dc2-4fff-9226-75294a5a963d", MainTask = new { Id =-1 }
})
  .InsertEntryAsync().Result;
// Выполнить пакетный запрос.
await odataBatchRequest.ExecuteAsync();

5.Чтобы стартовать созданную задачу, отправьте POST-запрос к функции StartFreeApprovalTaskFromExternalSystem(). В качестве идентификатора используйте идентификатор из ответа сервиса интеграции. Пример кода для запроса:

// Стартовать задачу.

await odataClient
 .For("MyModuleName")
 .Action("StartFreeApprovalTaskFromExternalSystem")
 .Set(new { taskId = postRequestsResult["Id"] })
 .ExecuteAsync();

6.Запустите приложение.

В результате в системе стартует задача на свободное согласование с заданными параметрами.

Работа с другими типами задач, например с задачами на согласование по регламенту (ApprovalTask), выполняется аналогично.