Адаптивные карточки CardPlatform (предварительная версия)

CardPlatform позволяет отправлять адаптивные карточки пользователям. Можно использовать для действия содержимого, например утверждения, записи форм и общего обмена сообщениями. Она поддерживает шаблон и пользовательские карточки.

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

Услуга	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)

Контакт
Имя	Поддержка CardPlatform
URL	https://cardplatform.app/support
Адрес электронной почты	support@cardplatform.app

Метаданные соединителя
Publisher	CardPlatform
Веб-сайт	https://cardplatform.app/
Политика конфиденциальности	https://cardplatform.app/privacy/
Категории	Сотрудничество; Коммуникация

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

Pre-requisites

Чтобы использовать CardPlatform, вам потребуется:

Создайте подписку CardPlatform, чтобы начать выбор плана;
Существует бесплатная пробная подписка, с которой можно использовать пробную версию и экспериментировать.

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

После завершения регистрации вы получите ключ API в сообщении электронной почты.

После получения ключа API создайте новое подключение, введите ключ API и начните отправлять карточки.

Начало работы с соединителем

Чтобы приступить к работе, сначала отправьте сообщение:

Выберите действие "Отправить сообщение"
Заполните три поля
- Получатели — укажите адрес электронной почты;
- Заголовок — запись заголовка, например Hello World
- Вставьте адаптивную карточку, в этом примере будет отправляться Hello World в карточку, например.
```
{
    "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
    "type": "AdaptiveCard",
    "version": "1.0",
    "body": [
        {
            "type": "TextBlock",
            "size": "Large",
            "isSubtle": true,
            "wrap": true,
            "text": "Hello World"
        }
    ]
}
```
Запустите поток, и карточка появится в Outlook

Известные проблемы и ограничения

Если адаптивные карточки не отображаются в Outlook, существует подключаемый модуль Outlook с именем Actionnable Message Debugger , который может помочь в устранении проблемы.

Установите с сайта отладчика сообщений с действиями .

Дополнительная поддержка доступна на сайте поддержки CardPlatform.

Часто задаваемые вопросы

Как отправить утверждение?

Используйте действие "Отправить утверждение ";
Как отправить сообщение, не ожидая ответа?

Используйте действие "Отправить сообщение ";
Как создать адаптивные карточки?

Используйте конструктор адаптивных карточек для создания адаптивных карточек;
Где найти схему и примеры для адаптивных карточек?

Схема и примеры можно найти на следующих языках:
- adaptivecards.io
- madewithcards.io
Что такое шаблоны?

Шаблон позволяет создавать адаптивную карточку, а затем применять к ней данные, разделяя данные из макета адаптивной карточки.
1. Что такое общедоступные шаблоны?
  
  Общедоступные шаблоны создаются сообществом и доступны для всех для использования. Все общедоступные шаблоны можно перечислить с помощью действия "Список общедоступных шаблонов ";
2. Что такое частные шаблоны?
  
  Частные шаблоны — это частная коллекция шаблонов, которую можно хранить и повторно использовать.

Создание подключения

Соединитель поддерживает следующие типы проверки подлинности:


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

По умолчанию

Применимо: все регионы

Параметры для создания подключения.

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Имя	Тип	Description	Обязательно
Ключ API	securestring	Ключ API из CardPlatform	True

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

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

Действия

Вывод списка общедоступных шаблонов	Извлекает список всех общедоступных шаблонов.
Вывод списка частных шаблонов	Извлекает список всех частных шаблонов.
Обновление закрытого шаблона	Обновляет содержимое закрытого шаблона.
Отправка адаптивной карточки	Отправляет адаптивную карточку и возвращает ответ с выбранным выбором и введенными полями.
Отправка сообщения	Отправляет адаптивную карточку в виде сообщения (без действий).
Отправка утверждения	Отправляет адаптивную карточку утверждения и возвращает ответ с указанным выбором и полями.
Поиск общедоступного шаблона	Найдите общедоступный шаблон, проанализировав структуру данных.
Получение закрытого шаблона	Извлекает частный шаблон по имени.
Получение общедоступного шаблона	Извлекает содержимое общедоступного шаблона.
Преобразование закрытого шаблона	Заполняет закрытый шаблон данными и возвращает полностью заполненную адаптивную карточку.
Преобразование общедоступного шаблона	Заполняет общедоступный шаблон данными и возвращает полностью заполненную адаптивную карточку.
Создание закрытого шаблона	Создайте закрытый шаблон.
Удаление закрытого шаблона	Удаляет частный шаблон из набора частных шаблонов.

Вывод списка общедоступных шаблонов

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

Извлекает список всех общедоступных шаблонов.

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

response: object

Вывод списка частных шаблонов

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

Извлекает список всех частных шаблонов.

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

Имя	Путь	Тип	Описание
		array of string

Обновление закрытого шаблона

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

Обновляет содержимое закрытого шаблона.

Параметры

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

Отправка адаптивной карточки

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

Отправляет адаптивную карточку и возвращает ответ с выбранным выбором и введенными полями.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Получатели	recipients	True	array of string	Адрес электронной почты получателей
Heading	heading	True	string	Heading
Адаптивная карточка	card	True	string	Адаптивная карточка
Идентификатор	id		string	Идентификатор для идентификации карточки
Имя карточки	cardname		string	Имя карточки

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

Ответ от предыдущей карточки

Ответ: ResponseSchema

Отправка сообщения

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

Отправляет адаптивную карточку в виде сообщения (без действий).

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Получатели	recipients	True	array of string	Адрес электронной почты получателей
Heading	heading	True	string	Heading
Адаптивная карточка	card	True	string	Адаптивная карточка

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

response: CardResponseSchema

Отправка утверждения

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

Отправляет адаптивную карточку утверждения и возвращает ответ с указанным выбором и полями.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Получатели	recipients	True	array of string	Электронная почта получателей
Heading	heading	True	string	Heading
Инструкции	instructions	True	string	Инструкции
Действия	actions	True	array of string	Список действий
Выбор типа	choiceType	True	string	Выбор типа
Выбор по умолчанию для утверждения	approvalChoice	True	string	Выбор по умолчанию для утверждения
Выбор по умолчанию для отклонения	rejectionChoice	True	string	Выбор по умолчанию для отклонения

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

Ответ от предыдущей карточки

Ответ: ResponseSchema

Поиск общедоступного шаблона

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

Найдите общедоступный шаблон, проанализировав структуру данных.

Параметры

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

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

response: object

Получение закрытого шаблона

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

Извлекает частный шаблон по имени.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Имя закрытого шаблона	name	True	string	Имя закрытого шаблона

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

response: object

Получение общедоступного шаблона

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

Извлекает содержимое общедоступного шаблона.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Путь к общедоступному шаблону	path	True	string	Путь к общедоступному шаблону

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

Список шаблонов

Список шаблонов: TemplateListSchema

Преобразование закрытого шаблона

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

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

Параметры

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

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

response: object

Преобразование общедоступного шаблона

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

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

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Общедоступный путь к шаблону	path	True	string	Путь к общедоступному шаблону
			object

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

response: object

Создание закрытого шаблона

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

Создайте закрытый шаблон.

Параметры

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

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

response: object

Удаление закрытого шаблона

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

Удаляет частный шаблон из набора частных шаблонов.

Параметры

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

Определения

ResponseSchema

Ответ от предыдущей карточки

Имя	Путь	Тип
респондент	respondent	string
respondentName	respondentName	string
respondentEmail	respondentEmail	string
choice	choice	string
Комментарий	comment	string
responseDate	responseDate	string

TemplateListSchema

Список шаблонов

Имя	Путь	Тип
list	list	array of object
key	list.key	string
templates	list.templates	array of object
file	list.templates.file	string
fullPath	list.templates.fullPath	string

CardResponseSchema

: string

объект

Это тип object.

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

Адаптивные карточки CardPlatform (предварительная версия)

Pre-requisites

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

Начало работы с соединителем

Известные проблемы и ограничения

Часто задаваемые вопросы

Создание подключения

По умолчанию

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

Действия

Вывод списка общедоступных шаблонов

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

Вывод списка частных шаблонов

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

Обновление закрытого шаблона

Параметры

Отправка адаптивной карточки

Параметры

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

Отправка сообщения

Параметры

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

Отправка утверждения

Параметры

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

Поиск общедоступного шаблона

Параметры

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

Получение закрытого шаблона

Параметры

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

Получение общедоступного шаблона

Параметры

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

Преобразование закрытого шаблона

Параметры

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

Преобразование общедоступного шаблона

Параметры

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

Создание закрытого шаблона

Параметры

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

Удаление закрытого шаблона

Параметры

Определения

ResponseSchema

TemplateListSchema

CardResponseSchema

объект