Подготовить проект отдела
Передайте имя нового проекта в Create Project; полученный ID используйте в Update Project только при последующем изменении настроек.
- Действие: Создать проект
- Действие: Обновить проект
Kvantora Platform · интеграция
Коннектор управляет проектами платформы: создаёт, обновляет и перечисляет их.
Пример сценария
Передайте имя нового проекта в Create Project; полученный ID используйте в Update Project только при последующем изменении настроек.
Возможности подключения
Коннектор управляет проектами платформы: создаёт, обновляет и перечисляет их. Это административные операции, поэтому проект для нового отдела стоит создавать по явному решению владельца, а не на каждом входящем событии.
Каталог установленного SDK
Список описывает установленный SDK. Подключение аккаунта, права и внешние тарифы проверяются отдельно.
В этой интеграции нет событий запуска.
Версия подключения: 0.4.8
Примеры применения
Передайте имя нового проекта в Create Project; полученный ID используйте в Update Project только при последующем изменении настроек.
Начало работы
Откройте автоматизации Kvantora Flow и найдите Kvantora Platform в списке подключений.
Откройте подключение выбранного шага и заполните поля по инструкции сервиса: они зависят от его API и способа авторизации.
Для примера «Подготовить проект отдела» добавьте шаги Создать проект → Обновить проект. Сопоставьте нужные поля с входными данными.
Проверьте сценарий на допустимых тестовых данных. Запись, отправка сообщений и обращения к платным API могут иметь внешние последствия; включайте сценарий после проверки результата.
Вопросы и ответы
«Создать проект» принимает название отдельного пространства для сценариев автоматизации отдела. Ставьте действие после согласованной заявки на такое пространство, а не после каждого обращения клиента. Код возвращает необработанное тело ответа платформы; он не извлекает и не гарантирует поле ID. Перед дальнейшим обновлением сначала проверьте фактический ответ и найдите ID нужного проекта.
Да, «Список проектов» читает проекты, где команда ведёт сценарии автоматизации процессов. Перед изменением настроек найдите нужный проект и проверьте его ID, затем передайте ID в «Обновить проект». Похожие названия отделов легко перепутать. Каталог не содержит готового правила выбора или устранения дублей; это условие должно быть задано в вашем маршруте.
Для переименования пространства со сценариями автоматизации процессов есть «Обновить проект». Действие требует ID проекта, новое название и число участников команды. Форма также требует Notify Status, но текущий run не включает его в тело запроса; изменение этого параметра обещать нельзя. Перед записью сверьте ID и обязательные значения, после неё проверьте фактическое название проекта.
У версии 0.4.8 этого подключения нет собственного триггера. Сценарий создания или проверки проекта нужно начинать другим событием, расписанием либо вручную. «Список проектов» читает данные и не сообщает о создании. Если требуется реагировать на событие внешней системы, сначала подтвердите его источник; сам каталог проектов такого события не обещает.
Перед созданием пространства для сценариев автоматизации процессов прочитайте «Список проектов» и сопоставьте найденное с заявкой. Если подходящего проекта нет, действие создания отправит новый запрос; его исходный ответ надо проверить, поскольку SDK не выделяет ID отдельным полем. В каталоге нет готового «найти или создать проект». При одинаковых названиях потребуется дополнительный признак, иначе повтор может дать дубль.
В каталоге есть отдельное действие «Произвольный API-запрос» для задачи, которой нет среди создания, обновления и перечисления проектов. Это не готовая операция с заранее подтверждённым результатом: метод, адрес, тело и допустимые права нужно сверить с API Kvantora Flow для выбранной операции. Для обычной работы с проектами берите именованное действие, чтобы назначение шага было понятно при проверке сценария.
Среди готовых операций этой версии есть только создание, обновление и список проектов, а также произвольный API-запрос. Операции переноса сценариев в списке нет. Для такой задачи сначала уточните поддерживаемый способ переноса в документации платформы и состав данных, который требуется сохранить. Не подменяйте отсутствие готового действия предположением, что перенос выполнит «Обновить проект».
В исходном SDK подключение запрашивает адрес API платформы и секретный API-ключ. Их берут из настроек своей платформы; ключ не вставляют в текст сценария и не передают в заявке. Это подключение к административному API, а не выбор проекта для конкретного действия. После настройки проверьте доступ на безопасном чтении списка проектов.
Выберите нужные шаги в Kvantora Flow и настройте их для своей задачи.