Wiki [3.x] product:api

Создание сообщений о событиях в системной шине ADVANTA ...

anonymous@undisclosed.example.com (Anonymous) — Fri, 05 Dec 2025 09:49:30 +0000

Создание сообщений о событиях в системной шине ADVANTA через API

Шина, события и бизнес-операции

Обмен информацией между модулями ADVANTA выполняется через «системную шину данных». В шине публикуются «сообщения» о случившихся в системе событиях и тех изменениях в данных, которые в результате произошли. Сообщения служат сигналами к запуску «триггеров» в модуле «Цифровой помощник». Сообщения о событиях могут появляться в шине:

в ответ на действия пользователя в интерфейсе.
при запуске настраиваемых команд.
по расписанию.
при вызове API-функций, изменяющих данные в системе.
при вызове специальной API-функции «InsertTimerEvent», которая планирует возникновение в шине события на указанное время.

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

Бизнес-операции могут быть:

повторяющиеся регулярные, запускаемые по таймеру;
однократные, планируемые на определённую дату и время;

Примеры «регулярных» операций: еженедельная отправка отчётов руководителям проектов, планирование регулярных совещаний, периодический расчёт метрик, регулярный обмен данными с внешними системами

«Однократные» операции можно запускать, когда требуется:

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

Пример внешнего события

Предположим, в системе электронного документооборота предприятия «утверждён» приказ о реализации проекта. Надо оповестить об этом ADVANTA, поместив в её шину данных сообщение о соответствующей бизнес-операции. Это можно сделать помощью API-функции «InsertTimerEvent». В сообщении можно передать необходимую информацию, например, идентификатор утверждённого проекта и присвоенный ему статус. В результате в ADVANTA выполнят свою работу триггеры, привязанные к бизнес-операции утверждения проекта: создадут необходимые объекты, оповестят проектную команду, запланируют установочное совещание и другое. Если в будущем потребуется выполнять в ADVANTA какое-то дополнительные действия по созданию нового проекта, достаточно будет создать новый триггер и подключить к уже существующей бизнес-операции.

Пример события с установленными сроками исполнения

Некоторые бизнес-процессы предприятия требуют выполнения работ в период времени, ограниченный регламентом или SLA. К примеру, при получении сообщения об утверждении проекта, его руководитель обязан в течение двух рабочих дней подготовить документ «паспорт проекта». Помимо простого уведомления о начале этой задачи будет полезно при наступлении планового срока завершения автоматически проверить, подготовил он документ или нет. Если не подготовил, надо оповестить всех заинтересованных участников проекта, напомнить исполнителю и запланировать следующую проверку, например, ещё через сутки.

В этом случае можно организовать работу следующим образом:

В справочнике бизнес-операций зарегистрировать две операции: «№1 - Утверждён приказ о проекте», «№2 - Проверка подготовки паспорта проекта».
После утверждения приказа в СЭД, в шине данных ADVANTA с помощью API «InsertTimerEvent» создаётся сообщение о бизнес-операции «№1 - Утверждён приказ о проекте» с датой исполнения на «текущий момент времени».
Создать триггер, который исполняется при появлении в шине сообщения о бизнес-операции «Утверждён приказ о проекте». Этот триггер в свою очередь помещает в шине данных, с помощью всё той же API «InsertTimerEvent», сообщение о запуске бизнес-операции «№2 - Проверка подготовки паспорта проекта», но устанавливает дату запуска этого сообщения, в соответствие с регламентом, например, через двое суток от текущей даты.
Как только наступит дата и время запланированного запуска второго сообщения, оно появится в шине данных и на него смогут отреагировать триггеры, выполняющие проверку, оповещения и прочие необходимые операции. Один из этих триггеров может в свою очередь запланировать повторную проверку, поместив с помощью API «InsertTimerEvent» ещё одно сообщение о запуске бизнес-операции «№2 - Проверка подготовки паспорта проекта» со сроком, например, ещё через сутки. Таких циклов эскалации проблемы можно создать столько, сколько необходимо.

Как регистрировать в ADVANTA «бизнес-операции»

Перечень «бизнес-операций» и расписание регулярного таймера для их запуска можно найти в панели администратора ADVANTA, на странице «Дополнительные сервисы / Расписание пользовательских бизнес-операций»:

Рисунок 1. Запуск справочника пользовательских бизнес-операций

Чтобы создать новую «бизнес-операцию» перейдите в справочник по ссылке «Справочник бизнес-операций»:

Рисунок 2. Переход в справочник бизнес-операций

На странице справочника «бизнес-операций» нажмите кнопку «Добавить»:

Рисунок 3. Добавление бизнес-операции

Введите название новой бизнес-операции и нажмите «Сохранить»:

Рисунок 4. Создание новой бизнес-операции

Операция появится в справочнике. Ей будет присвоен внутренний код, который потребуется при вызове API «InsertTimerEvent»:

Рисунок 5. Новая операция в справочнике бизнес-операций

Если требуется реализовать регулярную, повторяющуюся бизнес-операцию, настройте запуск по таймеру. Это можно сделать, вернувшись на страницу расписания бизнес-операций (меню «Дополнительные сервисы / Расписание пользовательских бизнес-операций»). Если требуется однократная операция, которая будет помещаться в шину через API «InsertTimerEvent», расписание не требуется.

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

Создание сообщения через API «InsertTimerEvent»

Для планирования запуска бизнес-операции на определённый день и время служит API-функция «InsertTimerEvent». Описание этой API можно найти на странице службы «APIScheduledEvents». Относительный путь к странице этой службы на вашем стенде ADVANTA: «/components/services/APIScheduledEvents.asmx».

Формат тела запроса для вызова API «InsertTimerEvent» следующий:

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <InsertTimerEvent xmlns="http://streamline/">
        <contract>
            <ASPNETSessionIdstring</ASPNETSessionId>
            <CallTime>dateTime</CallTime>
            <ObjectId>guid</ObjectId>
            <OperationCode>int</OperationCode>
            <Parameters>string</Parameters>
        </contract>
    </InsertTimerEvent>
  </soap:Body>
</soap:Envelope>

Описание параметров API-функции «InsertTimerEvent»:

Параметр	Описание
SessionID	ID сессии пользователя, полученное при авторизации
CallTime	Дата и время, когда событие должно быть помещено в шину
ObjectID	Идентификатор объекта ADVANTA, к которому будет привязано событие
OperationCode	Код операции в справочнике пользовательских бизнес-операций ADVANTA
Parameters	Дополнительные параметры, в формате JSON, которые будут прикреплены к событию и доступны триггеру для обработки

Пример вызова API «InsertTimerEvent» в Postman

Протестировать создание сообщения о выполнении бизнес-операции проще всего через систему Postman. Ниже приведены снимки настроек SOAP-запроса в ней:

Рисунок 6. Настройки заголовков запроса (закладка «Headers»)

Рисунок 7. Настройки тела запроса (закладка «Body»)

Пример триггера для обработки события

Проверить, что сообщение появилось в шине, можно с помощью триггера. Он должен реагировать на событие «Событие таймера, запланированное по подписке». Общие настройки триггера:

Рисунок 8. Настройки триггера

Код проверки «условия» запуска триггера:

TriggerConsole.WriteLine($"Проверка условия: ID события - {Context.EventId}, отправлено - {Context.EventSentTime}");

// Реагируем только на бизнес-операцию с кодом №1
if (Event.BusinessOperationCode == 1){
    TriggerConsole.WriteLine($"ID cобытия таймера: {Event.BusinessOperationCode}");
} else {
    return false; // Если это не операция с кодом №1, не запускаем триггер
}

return true;

Код «скрипта». В данном примере просто выводим в консоль ID и время сообщения, а также параметры, переданные в API-функции «InsertTimerEvent»:

TriggerConsole.WriteLine($"ID события = {Context.EventId}");
TriggerConsole.WriteLine($"Дата и время = {Context.EventSentTime}");

// Код бизнес-операции:
TriggerConsole.WriteLine($"BusinessOperationCode = {Event.BusinessOperationCode}");

// UID объекта, указанный при вызове API InsertTimerEvent:
TriggerConsole.WriteLine($"ObjectId = {Event.ObjectId}");

// Параметры, переданные через API InsertTimerEvent:
TriggerConsole.WriteLine($"Parameters = {Event.Parameters}");

В результате, в логе триггера будут видны переданные через API значения:

Рисунок 9. Лог триггера

Просмотр очереди через API «CheckTimerEvent»

Увидеть всю очередь сообщений бизнес-операции можно с помощью API-функции «CheckTimerEvent». Информацию о способе её вызова также можно найти на странице службы «APIScheduledEvents» (относительный путь на стенде ADVANTA: «/components/services/APIScheduledEvents.asmx»).

Формат вызова API «CheckTimerEvent»:

<!-- Позволяет проверить расписание вызова  -->
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <CheckTimerEvent xmlns="http://streamline/">
        <contract>
            <ASPNETSessionId>string</ASPNETSessionId>
            <ObjectId>guid</ObjectId>
            <OperationCode>int</OperationCode>
        </contract>
    </CheckTimerEvent>
  </soap:Body>
</soap:Envelope>

Пример настройки POST-запроса для вызова «CheckTimerEvent» в Postman:

Рисунок 10. Настройки заголовков вызова API «CheckTimerEvent»

Рисунок 11. Настройки тела запроса API «CheckTimerEvent»

Если запрос настроен верно, в Postman появится перечень сообщений указанной бизнес-операции. Пример:

Рисунок 12. Пример списка запланированных сообщений

Интеграция и расширение функционала ADVANTA с помощью API

anonymous@undisclosed.example.com (Anonymous) — Wed, 01 Oct 2025 04:17:23 +0000

Интеграция и расширение функционала ADVANTA с помощью API

Почему иногда стандартного функционала недостаточно

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

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

Три способа добавить новую функциональность

Способ 1: «Цифровой помощник» - скрипты внутри ADVANTA

«Цифровой помощник» - система, которая располагается на веб-сервере «рядом» с ADVANTA. Она отслеживает события, происходящие в ADVANTA по мере работы пользователей. Для каждого события в «цифровом помощнике» можно создать небольшую, простую программу. Такие программы называют «скриптами» или «триггерами» (поэтому второе название «Цифрового помощника» – «модуль триггеров»).

Триггеры – это небольшие скрипты на языке C#. Они могут получать информацию об объектах ADVANTA и изменять её с помощью API-функций. Триггеры запускаются при определённом событии и выполняют рутинные действия, снижая ручную работу. Например, когда пользователь изменяет на «Завершено» статус контрольной точки этапа проекта, триггер может изменить фазу жизненного цикла проекта.

Также триггеры могут выполнять регулярные операции, по таймеру. К примеру, с помощью триггера можно раз в неделю формировать отчёт о состоянии проекта и рассылать его по email.

Способ 2: «Десктопные приложения» - локальный инструмент

Десктопные приложения – это программы для запуска в операционной системе на компьютере пользователя или внутри других приложений. Например, «модуль импорта/экспорта проектов из MS Project» устанавливается на компьютере пользователя. Он интегрируется в Microsoft Project как модуль и работает в её среде, но в процессе своей работы обращается к API-функциям ADVANTA.

Можно создавать и полностью самостоятельные программы для определённой операционной системы. Они могут быть написаны на любом языке программирования, главное, чтобы он был способен вызывать SOAP API и Web-запросы.

Способ 3: «Веб-сервисы» - свобода выбора технологий

Веб-сервисы – Это приложение, которое работает на веб-сервере, как и сама ADVANTA. Его можно разместить на том же сервере или в той же сети, где работает ADVANTA, обеспечивая высокую скорость и надёжность взаимодействия. Как и десктопное приложение, веб-сервис может быть создан на любом языке, будь то Python, JavaScript, AspNet.

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

Когда что использовать? Рекомендации

Выбор между «Цифровым помощником» и внешним сервисом зависит от ваших целей.

Используйте «Цифровой помощник», если вам нужно:

Автоматизировать простые действия внутри ADVANTA (например, при изменении статуса задачи — отправлять уведомление, обновлять поля, создавать дочерние элементы).
Выполнять фоновую обработку данных без отдельного интерфейса.
Выполнять действия, не создающие очень высокой нагрузки на сервер.
Исключить передачу информации за пределы базы данных ADVANTA.

Разрабатывайте внешний веб-сервис, если вам требуется:

Собственный пользовательский интерфейс для ввода информации (форма ввода).
Специфические визуальные элементы (сложный дашборд).
Интеграция с другими системами (CRM, ERP, BI-инструментами и т.д.).
Сложные или ресурсоёмкие вычисления, работа с большими объёмами данных.

Оба подхода полностью совместимы с API ADVANTA и могут дополнять друг друга. Например, триггер может подготовить данные, а внешний сервис — отобразить их в удобном виде.

Безопасность и сквозная авторизация пользователей (SSO)

Одна из главных задач при создании дополнительных сервисов — не усложнять работу пользователей. Чтобы не приходилось запоминать пароли от дополнительных приложений, ADVANTA позволяет реализовать сквозную авторизацию (Single Sign-On, SSO). При авторизации в приложении или веб-сервисе, подключённом к ADVANTA, пользователи не будут вводить логин и пароль повторно. При входе в интегрированное приложение ADVANTA безопасно передаёт информацию об авторизованном пользователе, не раскрывая пароль. Это не только повышает удобство, но и усиливает безопасность.

SSO работает как для «десктопных приложений», так и для веб-сервисов — при условии, что они корректно реализуют протокол обмена с ADVANTA. В результате пользователи получают единый рабочий контекст: они остаются в привычной среде, а новые инструменты ощущаются как естественное продолжение платформы.

Интеграция в интерфейс ADVANTA: как пользователи попадут в ваш сервис

Чтобы новый функционал был действительно полезен, к нему должен быть простой и понятный доступ прямо из интерфейса ADVANTA. Вы можете добавить ссылку на ваше внешнее приложение в левое меню Системы. Это делается через настройки интерфейса, и любой пользователь увидит новый пункт меню — например, «Импорт проектов из CRM» или «BI-дашборд». При клике он мгновенно перейдёт в ваш сервис с уже выполненной авторизацией.

Заключение: ваша ADVANTA - ваша экосистема

ADVANTA - это не просто Система управления проектами, а основа для вашей собственной цифровой экосистемы. Благодаря открытому API и гибким инструментам расширения вы можете адаптировать платформу под уникальные процессы вашей компании - без ожидания обновлений от вендора и без потери контроля над данными.

Начните с малого, ознакомьтесь с примерами сценариев в нашей wiki:

сценарии «Цифрового помощника»;
примеры внешних приложений и веб-сервисов, расширяющих функционал;
примеры интеграционных решений.

Ознакомьтесь с документацией по API:

Ваша система - ваше правило. Расширяйте, интегрируйте, улучшайте!

Примеры документации по интеграции

anonymous@undisclosed.example.com (Anonymous) — Tue, 22 Apr 2025 04:20:42 +0000

Примеры документации по интеграции

Общий обзор интеграционных решений

Примеры решений, которые расширяют функциональные возможности Системы ADVANTA за счет скриптов, а также кейсы интеграции с внешними системами.

Примеры интеграционных решений Адванты

ТЗ на интеграцию ADVANTA c 1C

Пример интеграции Системы ADVANTA с 1С, описывающий принципы обмена данными между ними, включая авторизацию, передачу информации о контрагентах, договорах, счетах и платежах - с примерами SOAP-запросов и структурой данных для корректной настройки взаимодействия через API.

ТЗ на интеграцию ADVANTA c 1C

Инструкции пользователя по интеграции 1С и ADVANTA

Инструкция пользователя по настройке обмена данными между системой 1С и платформой ADVANTA с использованием обработки «Адванта: выгрузка данных». Она описывает как ручной, так и автоматический режимы выгрузки, включая настройку параметров в 1С, выбор типов данных для передачи (контрагенты, договоры, оплаты), а также установку расписания для автоматической синхронизации.

Инструкции пользователя по интеграции 1С и Адванта

Концепция интеграции 1С и ADVANTA

Описание концепции интеграции 1С и ADVANTA, включая цели, архитектуру, методы обмена данными (API, веб-сервисы), подходы к синхронизации, безопасности и мониторингу.

Концепция интеграции 1С и ADVANTA

Создание приложений с SSO-аутентификацией в ADVANTA

Описание принципа организации системы аутентификации пользователей в приложениях (SSO) с единым входом через ADVANTA. Примеры программного кода на C#.

Принцип действия SSO в ADVANTA и примеры кода

Пример кода A2-SSO-Demo.zip

Пример кода A2-SSO-Demo-ASPNETCore.zip

Ответы на вопросы по интеграциям

anonymous@undisclosed.example.com (Anonymous) — Wed, 20 Aug 2025 11:09:40 +0000

Ответы на вопросы по интеграциям

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

Синхронизация данных с внешним приложением

Ситуация

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

Вопрос

каким образом можно проводить регулярное обновление/слияние данных из внешнего источника с перечнем задач в ADVANTA, ничего при этом не потеряв из тех задач/подзадач, по которым в ADVANTA со времени последнего обмена произошли изменения определённых атрибутов (часть подзадач уже выполнена, сроки основной задачи изменились и т.п.)?

Ответ

Для реализации изложенной ниже логики пишем скрипт на Power Shell, Python или мини-приложение на C# (.Net), но можно использовать и другие языки / средства запуска сценариев.
Получаем данные из внешней системы (из файла, API или шины). Критически важно, чтобы у полученных из внешнего источника данных были уникальные идентификаторы по каждой задаче (уникальные для данного источника и однозначно идентифицирующие каждую задачу – далее «внешний ключ» задачи).
Сохраняем полученные данные в скрипте (или нашем приложении из п.1) в массив для обработки.
Последовательно обрабатываем хранящиеся в массиве задачи с использованием цикла.
Запросом в API ADVANTA (быстрее всего будет сделать вызов LINQ-запроса с параметром в виде «внешнего ключа») проверяем что в ADVANTA еще нет объекта, связанного с задачей из внешнего источника. Если это так, то создаем в ADVANTA через API новый объект и в скрытом поле этого объекта (надо его будет создать через админку) сохраняем значение «внешнего ключа» для будущих синхронизаций. Все полученные из внешней системы атрибуты задачи сохраняем в системные или кастомные реквизиты объекта в ADVANTA (или в справочники, при необходимости). Созданную в ADVANTA задачу (имеющую связь с внешней системой) желательно не изменять вручную, но декомпозировать на вложенные в нее подчиненные задачи/объекты и вести работу с ними (либо использовать горизонтальные связи с другими задачами в ADVANTA - новыми или уже существующими).
Если связанный с задачей из внешнего источника объект уже есть в ADVANTA (найдено совпадение по «внешнему ключу»), то полученные из внешней системы данные необходимо сохранить в объекте ADVANTA, но не затирая текущие значения его реквизитов, а сохранив полученные из внешней системы данные в отдельном табличном справочнике (нескольких справочниках, при необходимости).
По «связанным» с внешней системой объектам в ADVANTA можно создать контрольный отчет, для отображения расхождений в атрибутах задачи в ADVANTA и полученных по этой задаче данных из внешней системы.
Можно дополнительно на уровне скрипта/приложения или через модуль ADVANTA «Цифровой помощник» (Триггеры) делать сравнение атрибутов, и в случае их изменения направлять уведомление (или создавать дискуссию в ADVANTA) на заинтересованных пользователей с информацией о произошедших изменениях.
С заданной регулярностью запускаем созданный скрипт (через cron в Linux или планировщик задач в Windows)

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

Примеры интеграций с другими продуктами

anonymous@undisclosed.example.com (Anonymous) — Fri, 11 Apr 2025 09:53:32 +0000

Примеры интеграций с другими продуктами

Системы аналитики и визуализации данных

Интеграция ADVANTA с Analytic Workspace

Экспорт данных из ADVANTA в Google-таблицы

Взаимодействие ADVANTA с BI-системой «Навигатор»

Интеграция ADVANTA с PowerBI Desktop

Системы сквозной авторизации

Blitz IDP

Больше не поддерживаются следующие методы API

anonymous@undisclosed.example.com (Anonymous) — Tue, 18 Jul 2023 14:26:25 +0000

Больше не поддерживаются следующие методы API

Метод	Название	Замена
GetSubprojectsDates	Получение информации о датах подпроектов	GetProjects
GetProjectInfo	Получение информации о проекте	GetProject
UpdateProjectInfo	Обновление информации о проекте	UpdateProject
GetTopicStatus	Получение статуса дискуссии	GetTopicInfo
GetDirectoryRequisites	Получение реквизитов справочника	GetDirectoryInfo
Login	Вход в Систему с логином и паролем пользователя	Authenticate

Описание методов API

anonymous@undisclosed.example.com (Anonymous) — Wed, 18 Feb 2026 06:52:55 +0000

Описание методов API

Авторизация

components/services/login.asmx

Метод	Название	Описание	Начиная с версии
Authenticate	Авторизация	Возвращает идентификатор сессии ASPNETSessionId, который используется при вызове всех методов API
AuthenticateByUser	Авторизация от имени другого пользователя	Позволяет администратору авторизоваться под выбранным пользователем	3.20
AuthenticateAdminAsUser	Авторизация администратора от имени другого пользователя	Позволяет администратору авторизоваться под выбранным пользователем	3.24
AuthenticateByToken	Аутентификация по токену	Метод для аутентификации в системе по выданному токену	3.26
CheckSession	Проверка активности сессии	Возвращает идентификатор сессии ASPNETSessionId, если сессия активна. И Session ends, если сессия не активна	3.14.3232.26072-09fa3d0
Login*	Вход в Систему под определённым пользователем	Метод для входа в Систему с логином и паролем пользователя. `ВНИМАНИЕ: метод устарел.` `Рекомендуется использовать метод Authenticate - Авторизация (см. выше)`
WhoAmI	Проверка пользователя	Возвращает имя и роль пользователя, вошедшего в Систему

Пользователи

components/services/persons.asmx

Метод	Название	Описание	Начиная с версии
AddPersonsToGroups	Добавить пользователей в группы	На входе – массивы значений: GUID пользователей, GUID групп пользователей. На выходе – результат выполнения метода (успешно или нет, с указанием причины). При успешном завершении работы метода соответствующие пользователи будут добавлены в соответствующие группы пользователей Системы.	3.23
CheckUserPhoto	Проверка наличия фотографии у пользователя	Метод возвращает ссылку на фото, типа ~/Pages/PopupPages/Documents/GetImage.ashx?v=1&docid=0d6aecc1-17a3-4af3-939c-8c7b92cb63eb, если фотография нестандартная. В случае стандартной фотографии метод вернет значение null. При возникновении ошибки, вернется ошибка.	2.05.1922.22458-e57d332
CreatePerson	Создание пользователя	Возвращает ID вновь созданного пользователя	Изменен с версии 3.24
DeletePersonsFromGroups	Удалить пользователей из групп	На входе – массивы значений: GUID пользователей, GUID групп пользователей. На выходе – результат выполнения метода (успешно, либо нет с указанием причины). При успешном завершении работы метода соответствующие пользователи будут удалены из соответствующих групп пользователей Системы.	3.23
EditPerson	Редактирование пользователя	Метод изменяет данные о пользователе в системе, согласно переданным параметрам	Изменен с версии 3.23
GetAllowedPersons	Получение списка пользователей, которым разрешен вход в систему	Возвращает всех пользователей в массиве Persons, которым разрешен вход в систему
GetGroups	Получение информации о группах пользователей	Возвращает массив GetGroupsResult, содержащий информацию о группах пользователей
GetPerson	Получение информации о пользователе	Возвращает массив SLPerson, в котором находится информация о полном имени пользователя, его идентификаторе, электронная почта и сведения о привязке пользователя к Active Directory	Изменен с версии 3.29
GetPersonRequests	Получить историю пользовательских запросов		3.17
GetPersons	Получение информации о пользователях	Возвращает массив Persons с информацией о каждом пользователе в подмассиве SlPerson
GetPersonsXml	Получение списка пользователей	Возвращает массив всех пользователей Users, содержащий расширенные сведения о каждом пользователе в подмассивах UserWrapper	2.2.2.2
LinkUserToAD	Создание связи с Active Directory	Возвращает идентификатор созданной связи пользователя системы с Active Directory
DeleteLinkWithAD	Удаление связи с Active Directory	Удаляет привязку пользователя системы к Active Directory
LinkUserToOpenIdConnect	Создание связи с Open ID	Возвращает идентификатор созданной связи пользователя системы с Open ID	3.29
DeleteLinksWithOpenIdConnect	Удаление связи с Open ID	Удаляет привязку пользователя системы к Open ID	3.29
CreateToken	Создание токена для пользователя	Метод для создания токена для пользователя, от имени которого осуществлен вход	3.26
RevokeAllTokensByUsers	Отзыв всех выданных токенов по списку пользователей	4.4.2.1. Метод для отзыва всех действующих токенов по списку пользователей	3.26

Безопасность

components/services/APISecurity.asmx

Метод	Название	Описание	Начиная с версии
AddPersonsToProjectMembers	Добавить пользователя в участники	Добавить пользователя в число участников объекта	3.21
DeletePersonsFromProjectMembers	Удалить пользователя из участников	Удалить пользователя из числа участников объекта	3.29
AddPersonsToProjectPermissionRoles	Назначить проектное право	Назначить на проектную роль безопасности определенного пользователя или группы пользователей.	3.20
DeletePersonsToProjectPermissionRoles	Снять проектное право	Снять с проектной роли безопасности определенного пользователя или группы пользователей.	3.20
GetProjectPermissionPersons	Получить список пользователей, назначенных на проектную роль объекта иерархии	Метод позволяет получить список пользователей и групп пользователей, назначенных на указанную проектную роль в указанном объекте	3.24

Проекты

components/services/APIProjects.asmx

Метод	Название	Описание	Начиная с версии
AddLinkTaskToTask	Установка связи между объектами типа «Задача»	Установка временной зависимости между объектами.	3.17
AddResourcesTask	Назначение ресурсов на объект типа «Задача»		3.17
ChangeParent	Перемещение проекта	Изменяет родительский проект у выбранного проекта	2.05.1929.21162-abc1d91
ConvertProjectType	Конвертация типа объекта	Изменяет тип объекта (аналог опции «Преобразовать» на карточке объекта)	3.23
CreateProject	Создание проекта	Создает проект, согласно переданным параметрам	Изменен с версии 3.29
CreateProjectByDiscussion	Создание проекта по дискуссии	Создает проект, согласно переданным параметрам, основанием создания проекта является указанная дискуссия	3.04.2176.31684-3bea33f
DelegateProject	Делегирование проекта	Делегирует проект другому пользователю системы
DeleteLinkTaskToTask	Удаление связи между объектами типа «Задача»	Удаление временной зависимости между объектами.	3.17
DeleteProject	Удаление проекта	Удаляет проект
DeleteResourcesTask	Удаление ресурсов из объекта типа «Задача»		3.17
GetGroupsWithPersonsIdsAllowedToWriteDiscussion	Получение групп и входящих в них пользователей по идентификатору проекта	Возвращает всех участников проекта и группы, в которые входят участники	3.02.2131.30991-7d9e342
GetHorizontalRelationsProjects	Получение горизонтальных связей проекта
GetProject	Получение информации о проекте	Возвращает всю информацию о проекте	Изменен с версии 3.29
GetProjectChilds	Получение подпроектов по типу	Возвращает идентификаторы всех подпроектов по типу проекта с указанием на родительский проект	2.05.1929.21162-abc1d91
GetProjectFields	Получение информации о реквизитах проекта	Возвращает идентификаторы реквизитов, даже если они не заполнены в карточке проекта	2.2.2.2
GetProjectInfo	Получение информации о проекте	Метод устарел. Рекомендуется использовать метод GetProject.
GetProjectResourceAssignments	Получение ресурсов по проекту	Возвращает информацию о ресурсах в выбранном проекте	3.03.2118.29620-0a5e94d
GetProjectTypes	Получение информации о всех типах объектов		3.20
GetProjects	Получение информации о проектах	Возвращает информацию о выбранных фильтром проектах	Изменен с версии 3.29
GetProjectsUidsByType	Получение списка идентификаторов проектов по их типу	Возвращает массив идентификаторов проекта с указанием на родительский проект. Если идентификатор родительского проекта ParentProjectId отсутствует, запрос вернет все проекты указанного типа
GetSubprojectsDates	Получение данных дочерних проектов	Возвращает массив данных дочерних объектов
GetWorkCalendars	Получение списка производственных календарей	Возвращает список производственных календарей	3.23
LockObjectFields	Блокировка реквизитов проекта	Производит блокировку реквизитов проекта, у которых установлена опция «Возможность блокировать»	3.16.3190.21290-49c1b0f
ScheduleProject	Запуск планировщика с уровня указанного объекта	Запускает планировщика с уровня указанного объекта	3.23
UnlockObjectFields	Разблокировка реквизитов проекта	Производит разблокировку реквизитов проекта, у которых установлена опция «Возможность блокировать»	3.16.3190.21290-49c1b0f
UpdateProject	Редактирование информации о проекте	Изменяет выбранный проект, согласно передаваемым параметрам. Возвращает строку Everything allright при удачном обновлении проекта	Изменен с версии 3.29
UpdateProjectExt	Обновление проекта		Не поддерживается после версии 3.23
UpdateProjectFields	Редактирование реквизитов проекта	Изменяет реквизиты выбранного проекта	2.2.2.2

Связи

components/services/APIRelations.asmx

Метод	Название	Описание	Начиная с версии
AddHorizontalRelations	Добавить горизонтальную связь		3.21
RemoveHorizontalRelations	Удалить горизонтальную связь		3.21

Справочники

components/Services/APIService.asmx

Метод	Название	Описание	Начиная с версии
ChangeDirectoryRecord	Редактирование записи в справочнике		Изменен с версии 3.23 предыдущие изменения 3.01
ChangeDirectoryRecords	Редактирование записей в справочнике
ChangeDirectoryRecordStatus	Изменение статуса записи справочника	Изменяет статус (утверждено/на редактировании) записи справочника
ConvertClassifierItemIdToObjectId	Получение списка объектов по классификатору	Возвращает ID объекта, которому соответствует указанный ID записи классификатора
DeleteDirectoryRecord	Удаление записи справочника	Удаляет указанную запись справочника
DeleteDirectoryRecords	Удаление записей справочника	Удаляет указанные записи справочника
GetChildRecords	Получение списка записей справочника из дочернего справочника		3.06.2489.27673-42799a3
GetDirectoriesList	Получение списка справочников
GetDocumentVersions	Получение информации о версии документа	Возвращает порядковый номер версии документа по его индентификатору
GetRecords	Получение списка записей справочника	Возвращает по идентификатору справочника: список записей справочника и системная дата. Метод работает только с реквизитами-классификаторами, основанных на объектах.	Изменен с версии 3.23 предыдущие изменения 3.01 (Возвращаются не только записи справочника, но и системные даты.)
GetRelationObjects	Получение связи для указанного шаблона объектного справочника	Возвращает идентификатор связи объектного справочника и проекта	3.06.2467.30148-1017b6b
GetUsedObjectsByClassifier	Получение информации об объектах, к которым привязан справочник	Возвращает объекты, в которых используется справочник
GetUsedTemplatesForClassifier	Получение списка использованных шаблонов
InsertDirectoryRecord	Добавление записи в справочник		Изменен с версии 3.23 предыдущие изменения 3.01
InsertDirectoryRecords	Добавление записей в справочник
InsertObjectToProjectRelation	Создание связи Справочник-Проект	Создает связь существующего справочника и проекта	3.06.2467.30148-1017b6b
SearchDirectoryRecordValues	Поиск идентификаторов объектов по реквизитам справочника	Возвращает идентификаторы всех объектов по заданным параметрам реквизита справочника	3.17
SearchDirectoryRecordsByStatus	Поиск идентификаторов объектов по статусу записей справочника		3.06
SendMail	Отправка сообщения электронной почты	Отправка информации и документов из Системы на почту	изменено с 3.24
SendMessage	Отправка уведомления в Системе

Классификаторы

components/Services/APIService.asmx

Метод	Название	Описание	Начиная с версии
InsertClassifierRecord	Добавление записи в классификатор
GetClassifierRecords	Получение записей классификатора

Табель учёта времени

components/Services/APITimesheets.asmx

Метод	Название	Описание	Начиная с версии
ApproveTimesheet	Утверждение табеля учета времени пользователя Системы		3.23
DeclineTimesheet	Отклонение табеля учета времени пользователя Системы		3.23

Документы

components/Services/APIDocuments.asmx

Метод	Название	Описание	Начиная с версии
CreateTemplateDocument	Добавления контрольного документа в объект	Что такое контрольный документ	3.22
DeleteDocuments	Удаление документа из объекта	Удаляет любой документ (не версии-файлы, а весь документ целиком)	3.22
GetDocumentVersions	Получение идентификатора последней версии документа	Возвращает идентификатор и номер версии документа	3.01 (До версии 3.22 находился в разделе components/Services/APIService.asmx)
UpdateDocumentFields	Изменение реквизитов документа
UpdateDocumentVersion	Добавление новой версии документа	Добавляет файл в качестве новой версии документа	3.24
CreateDocument	Создание документа в объекте	Создаёт документ в объекте и возвращает идентификатор созданного документа	3.24
DownloadDocumentFile	Скачивание версии документа в кодировке base64	Скачивает документ по его индентефикатору	3.24
GetDocumentInfo	Получение информации о документе	Возвращает всю информацию по указанному в запросе документу - данные по его активной версии и реквизитам	3.24
GetDocumentsIds	Получение списка идентификаторов всех документов объекта	Возвращает массив идентификаторов документов в объекте(ах) иерархии Системы.	3.24

Дискуссии

components/Services/APIDiscussions.asmx

Метод	Название	Описание	Начиная с версии
AskUsersTotopic	Запрос ответа пользователей в дискуссии	Метод запрашивает ответ в указанной дискуссии у заданных пользователей	3.01.2104.30480-d3da9ee
CreateTopic	Создание дискуссии
CreateTopicReply	Создание ответа на дискуссию
CreateTopicWithFields	Создание дискуссии с дополнительными полями	Включено добавление реквизитов дискуссии при создании	3.01.2104.30480-d3da9ee
GetTopicInfo	Получение информации о дискуссии		3.04.2209.34455-ffff9e6
GetTopicsInfoByProject	Получение списка дискуссий по идентификатору проекта	Метод возвращает свойства каждой найденной дискуссии в соответствии с передаваемыми критериями поиска.	3.04.2209.34455-ffff9e6
OpenExistingTopic	Открытие закрытой дискуссии		3.01.2104.30480-d3da9ee
ReaskUsersTotopic	Повторный запрос ответа у всех участников дискуссии	Если запрос уже установлен, он снимается. Затем заново приглашаются в дискуссию все существующие участники	3.01.2104.30480-d3da9ee
UpdateTopic	Редактирование дискуссии		3.20

Согласования

components/Services/APINegotiations.asmx

Метод	Название	Описание	Начиная с версии
CreateNegotiation	Создание согласования	Создаёт согласование без вложений	3.23
GetNegotiation	Получить данные согласования	Возвращает массив данных согласования
UpdateRoute	Изменить перечень согласующих в маршруте согласования
CloseNegotiation	Закрытие согласования	Метод для закрытия активного согласования	3.25

Базовый план

components/Services/APIPlans.asmx

Метод	Название	Описание	Начиная с версии
CreateBaselinePlan	Создание базового плана	Создаёт базовый план выбранного проекта	3.16.3190.21290-49c1b0f
GetBaselinePlanProject	Получение базовых планов	Выгрузка базовых планов	3.04.2147.21764-e8cb788

Формы сбора отчетности

components/Services/APIForms.asmx

Метод	Название	Описание	Начиная с версии
DeleteFormRequest	Удаление запроса заполнения формы сбора отчетности	Отменяет запросы формы или форм	3.24

Отчеты

components/Services/APIReports.asmx

Метод	Название	Описание	Начиная с версии
DownloadSpreadsheetReportFile	Скачивание файла отчёта	Скачивание файла отчёта для дальнейшей отправки на почту	3.24
SaveSpreadsheetReportFileAsDocument	Сохранение отчёта в файл в Системе		3.24

Интеграции

components/services/Integrations.asmx

Метод	Название	Описание	Начиная с версии
DeleteOpenIdConnectProvider	Удаление связи с Open ID (во всех профилях пользователей)	Удаляет привязку к указанному провайдеру Open ID во всех профилях пользователей	3.29

Администрирование

components/services/APIService.asmx

Метод	Название	Описание	Начиная с версии
GetDirectoryInfo	Получение информации о реквизитах объекта\справочника в Администрировании

События

components/services/APIScheduledEvents.asmx

Метод	Название	Описание	Начиная с версии
InsertTimerEvent	Запланировать запуск бизнес-операции на определённый день и время	Позволяет запланировать запуск бизнес-операции на определённый день и время	3.29
CheckTimerEvent	Просмотр очереди сообщений бизнес-операции	Позволяет увидеть всю очередь сообщений бизнес-операции	3.29

Устаревшие методы API

Для изучения API

Вызов методов API с помощью SoapUI

Вызов методов API с помощью Postman

Интеграция с ADVANTA

anonymous@undisclosed.example.com (Anonymous) — Fri, 30 Jan 2026 07:56:29 +0000

Интеграция с ADVANTA

ВАЖНО

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

Описание SOAP API Системы ADVANTA

Описание Web-API для LINQ

Создание своих модулей (сервисов, приложений) для расширения возможностей платформы

Создание сообщений о событиях в системной шине ADVANTA через API

Примеры интеграций с другими продуктами

Примеры документации

Ответы на вопросы

ВНИМАНИЕ

Интеграции с использованием прямого подключения к Базе данных (БД) системы ADVANTA не рекомендуются в связи с возможными изменениями в структуре БД после очередного обновления версии системы или внесения изменений в настройки объектной модели установленного решения.

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

ПРЕДУПРЕЖДЕНИЕ

Прямое подключение к Базе данных системы ADVANTA в режиме «добавления» / «изменения» записей при создании интеграций или загрузке информации недопустимо!

Такие действия с очень высокой вероятностью приведут к нарушению целостности и связанности данных системы, что вызовет ее полную или частичную неработоспособность. Ответственность за такие действия и их последствия полностью ложится на компанию-клиента, которая теряет право на гарантийную поддержку со стороны разработчика системы ADVANTA до восстановления БД в неповрежденное состояние.

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