Поделиться через

Формы Cognito

Cognito Forms позволяет легко создавать мощные онлайн-формы, такие как опросы, формы заказа, формы регистрации и многое другое. Бесплатно.

Этот соединитель доступен в следующих продуктах и регионах:

Услуга Class Регионы
Copilot Studio Стандарт Все регионы Power Automate , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Логические приложения Стандарт Все регионы Logic Apps , кроме следующих:
     — Регионы Azure для государственных организаций
     — Регионы Azure Для Китая
     - Министерство обороны США (DoD)
Power Apps Стандарт Все регионы Power Apps , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Power Automate Стандарт Все регионы Power Automate , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Контакт
Имя Поддержка форм Cognito
URL https://www.cognitoforms.com/support
Адрес электронной почты support@cognitoforms.com
Метаданные соединителя
Publisher Формы Cognito
Website https://www.cognitoforms.com
Privacy Policy (Политика конфиденциальности) https://www.cognitoforms.com/legal/privacy
Категории Продуктивность; Сотрудничество

Формы Cognito

Cognito Forms позволяет легко создавать мощные онлайн-формы, такие как опросы, формы заказа, формы регистрации и многое другое. Бесплатно. Ознакомьтесь с нашей документацией по поддержке или обратитесь к нам за помощью с нашим общедоступным соединителем Power Automate.

Издатель: Cognito Forms

Предпосылки

Требуется платная подписка.

Поддерживаемые операции

Triggers

Триггеры будут отправляться вскоре после возникновения события подписки.

NewEntry

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

Параметры:
  • form: имя формы, для которой будут подписаны новые события входа.

UpdateEntry

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

Параметры:
  • form: имя формы, для которой будут подписаны обновленные события записи.

EntryDeleted

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

Параметры:
  • form: имя формы, для которой будут подписаны удаленные события записи.

Действия

CreateEntry

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

Параметры:
  • form: имя или идентификатор внутренней формы

EditEntry

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

Параметры:
  • form: имя или идентификатор внутренней формы
  • entryId: номер записи или идентификатор записи для обновляемой записи

SetFormAvailability

Это действие установит параметры ограничения доступности формы. end Параметры start должны быть пустыми, чтобы сделать форму доступной все время. Выходные данные будут обновленными параметрами доступности.

Параметры:
  • form: имя или идентификатор внутренней формы
  • start: дата и время, в котором должна стать доступна форма.
  • end: дата и время, в котором форма больше не должна быть доступна.
  • message: сообщение, которое должно отображаться пользователям, которые пытаются получить доступ к форме за пределами периода доступности.

GetFile

Это действие извлекает файл из хранилища. Выходные данные — это объект, содержащий данные файла, метаданные и временную ссылку на файл.

Параметры:
  • id: идентификатор файла для извлекаемого файла.

GetDocument

Это действие создает и извлекает документ записи с помощью указанной формы, записи и шаблона. Выходные данные — это объект, содержащий данные файла документа, метаданные и временную ссылку на документ.

Параметры:
  • form: имя или идентификатор внутренней формы
  • entry: идентификатор записи или номер записи, для которой должен быть создан документ.
  • templateNumber: число шаблонов, которые должны использоваться для создания документа записи

GetEntry

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

Параметры:
  • form: имя или идентификатор внутренней формы
  • entryId: номер записи или идентификатор записи для извлекаемой записи

DeleteEntry

Это действие приведет к удалению существующей записи для указанной формы. Это действие завершится ошибкой, если запись не существует. Выходные данные не будут.

Параметры:
  • form: имя или идентификатор внутренней формы
  • entryId: номер записи или идентификатор записи для удаления записи

Частные операции

Эти операции являются включениями для общедоступных триггеров и действий.

GetForms

Эта операция возвращает список форм в виде объектов, содержащих Idобъект , InternalNameи Name. При использовании параметра для form действий и триггеров пользователь должен увидеть Nameэтот параметр, но InternalName его следует отправить в API.

GetFormSchema

Эта операция вернет схему для указанной формы. Параметр input должен иметь значение true для действий, чтобы исключить свойства только для чтения и false для триггеров, чтобы включить все свойства. Параметр includeLinks должен иметь значение true для всех действий и триггеров, за исключением EntryDeleted.

Параметры:
  • form: имя или идентификатор внутренней формы
  • input: логическое значение, указывающее, должна ли возвращаемая схема исключить свойства, которые нельзя задать. Значение по умолчанию — ложь.
  • includeLinks: логическое значение, указывающее, должны ли свойства ссылок для файлов, подписей и документов быть включены в схему. Значение true по умолчанию.

Отмена подпискиWebhook

Эта операция отменит подписку указанного веб-перехватчика. Веб-перехватчик больше не получит никаких событий после отправки всех текущих событий очереди.

Параметры:
  • id: Идентификатор веб-перехватчика, который должен быть отменен.
  • module: модуль веб-перехватчика. Для этого соединителя должно быть задано значение forms, так как этот соединитель поддерживает только этот модуль.

Получение учетных данных

Владелец организации должен войти в Cognito Forms и авторизовать подключение.

Известные проблемы

None

Инструкции по развертыванию

Cognito Forms требует допустимого Client id и Client secret создания соединителя. Эти свойства можно найти в хранилище ключей и должны быть заданы только в параметрах проверки подлинности пользовательского соединителя.

  1. Запуск:

     paconn create --api-def apiDefinition.swagger.json --api-prop apiProperties.json

  2. Вход в PowerAutomate

  3. Перейдите к новому соединителю

  4. В разделе "Безопасность" обновите Client id и Client secret

  5. Обновление соединителя

Ограничения регулирования

Имя Вызовы Период обновления
Вызовы API для каждого подключения 100 60 секунд

Действия

Настройка доступности форм

Задает доступность формы.
Обновление записи

Обновляет запись.
Получение документа

Возвращает документ
Получение записи

Возвращает запись.
Получение файла

Возвращает файл по идентификатору
Создание записи

Создает новую запись.
Удаление записи

Удаление записи.

Настройка доступности форм

Идентификатор операции:
SetFormAvailability

Задает доступность формы.

Параметры

Имя Ключ Обязательно Тип Описание
Form
 form True string

Имя формы
Запуск доступности
 start date-time

Дата начала доступности
Окончание доступности
 end date-time

Дата окончания доступности
Недоступное сообщение
 message string

Недоступное сообщение

Возвращаемое значение

Сведения о доступности форм, такие как начальная или конечная доступность и недоступное сообщение.

Тело
FormAvailability

Обновление записи

Идентификатор операции:
EditEntry

Обновляет запись.

Параметры

Имя Ключ Обязательно Тип Описание
Form
 form True string

Имя формы
Идентификатор записи
 entryId True string

Идентификатор записи
Entry
 entry True dynamic

Обновленные данные записи

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Получение документа

Идентификатор операции:
GetDocument

Возвращает документ

Параметры

Имя Ключ Обязательно Тип Описание
Form
 form True string

Имя формы
Идентификатор записи
 entry True string

Идентификатор записи
Номер шаблона
 templateNumber True integer

Номер шаблона

Возвращаемое значение

Ссылка на файл, содержащая данные и метаданные файлов

Тело
FileDataRef

Получение записи

Идентификатор операции:
GetEntry

Возвращает запись.

Параметры

Имя Ключ Обязательно Тип Описание
Form
 form True string

Имя формы
Идентификатор записи
 entryId True string

Идентификатор записи

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Получение файла

Идентификатор операции:
GetFile

Возвращает файл по идентификатору

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор файла
 id True string

Уникальный идентификатор файла

Возвращаемое значение

Ссылка на файл, содержащая данные и метаданные файлов

Тело
FileDataRef

Создание записи

Идентификатор операции:
CreateEntry

Создает новую запись.

Параметры

Имя Ключ Обязательно Тип Описание
Form
 form True string

Имя формы
Entry
 entry True dynamic

Запись, созданная для формы

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Удаление записи

Идентификатор операции:
DeleteEntry

Удаление записи.

Параметры

Имя Ключ Обязательно Тип Описание
Form
 form True string

Имя формы
Идентификатор записи
 entryId True string

Идентификатор записи

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Триггеры

При обновлении записи

Активирует, когда кто-то обновляет запись.
При создании новой записи

Активируется при создании новой записи.
При удалении записи

Активирует при удалении записи.

При обновлении записи

Идентификатор операции:
UpdateEntry

Активирует, когда кто-то обновляет запись.

Параметры

Имя Ключ Обязательно Тип Описание
Form
 publisher True string

Имя формы

Возвращаемое значение

Выходные данные этой операции являются динамическими.

При создании новой записи

Идентификатор операции:
NewEntry

Активируется при создании новой записи.

Параметры

Имя Ключ Обязательно Тип Описание
Form
 publisher True string

Имя формы

Возвращаемое значение

Выходные данные этой операции являются динамическими.

При удалении записи

Идентификатор операции:
EntryDeleted

Активирует при удалении записи.

Параметры

Имя Ключ Обязательно Тип Описание
Form
 publisher True string

Имя формы

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Определения

FileDataRef

Ссылка на файл, содержащая данные и метаданные файлов

Имя Путь Тип Описание
Идентификатор файла
 Id string

Уникальный идентификатор файла.
Имя файла
 Name string

Имя файла
Тип контента файла
 ContentType string

Тип контента файла.
Размер файла
 Size integer

Размер файла.
URL-адрес файла
 File string

URL-адрес файла.
Содержимое файла
 Content byte

Содержимое файла

FormAvailability

Сведения о доступности форм, такие как начальная или конечная доступность и недоступное сообщение.

Имя Путь Тип Описание
Начало доступности форм
 availabilityStart date-time

Начало доступности форм
Конец доступности форм
 availabilityEnd date-time

Конец доступности форм
Недоступное сообщение
 notAvailableMessage string

Недоступное сообщение