Resco Cloud
Resco Cloud — это полностью одно бизнес-решение, которое является высоко настраиваемым, безопасным, функциональным и 100% автономным.
Этот соединитель доступен в следующих продуктах и регионах:
| Услуга | 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) |
| Контакт | |
|---|---|
| Имя | Эксперты Resco готовы слушать и помочь |
| URL | https://www.resco.net/contact-support/ |
| Адрес электронной почты | mobilecrm@resco.net |
| Метаданные соединителя | |
|---|---|
| Publisher | Resco |
| Website | https://www.resco.net/resco-cloud/ |
| Политика конфиденциальности | https://www.resco.net/privacy-notice/ |
| Категории | Продажи и CRM; Продуктивность |
Resco Cloud предоставляет все бизнес-решения, которые являются высоко настраиваемыми, безопасными, функциональными и 100% автономными. Этот соединитель позволяет выполнять операции, которые позволяют легко создавать, читать, обновлять и удалять записи.
Предпосылки
Чтобы использовать этот соединитель, вам потребуется следующее:
- Организация в Resco Cloud или любой связанный продукт из Resco.
- Вы можете зарегистрироваться на бесплатную 30-дневную пробную версию здесь.
- Учетная запись пользователя с правами доступа к схеме или правами системного администратора.
Получение учетных данных
Этот соединитель использует Basic проверку подлинности. При создании соединителя (в Power Apps или Logic Apps) вам потребуется предоставить учетные данные для входа.
Вам также потребуется выбрать сервер для использования с этим соединителем и имя организации, указанное во время регистрации.
Начало работы с соединителем
Просто добавьте любой шаг соединителя Resco Cloud в поток и начать доступ к данным в организации Resco Cloud. Этот соединитель позволяет выполнять основные операции с данными, например чтение, создание, обновление и удаление.
Известные проблемы и ограничения
Paging
Действие List records возвращает не более 1000 записей. Если вы хотите получить больше записей, необходимо использовать входной Skip token параметр. Объект Skip token не возвращается напрямую, а возвращается Next Link , который также содержит Skip token .
Чтобы устранить Skip token следующий List records вызов действия, можно использовать выражение на Set variable шаге, например:
{
"inputs": {
"name": "skipToken",
"value": "@{if(empty(outputs('List_records')?['body/@odata.nextLink']),null,decodeUriComponent(substring(outputs('List_records')?['body/@odata.nextLink'],add(indexOf(outputs('List_records')?['body/@odata.nextLink'], '$skipToken='),11))))}"
}
}
Triggers
Соединитель Resco Cloud поддерживает триггеры для операций создания, обновления и удаления.
В случае дополнительных требований существует обходное решение, доступное с помощью события процесса сервера и вызова HTTP-запроса, предоставленного "При получении HTTP-запроса". Просто создайте автоматический поток облака, назовите его и щелкните,чтобы создать пустой поток. Выполните поиск соединителя "Запрос" и добавьте триггер "При получении HTTP-запроса". Задайте для параметра "Схема JSON текста запроса", чтобы принять id параметр:
{
"type": "object",
"properties": {
"id": {
"type": "string"
}
}
}
В разделе "Показать дополнительные параметры" задайте для метода POST. Сохраните поток для создания URL-адреса HTTP POST.
Теперь необходимо создать процесс для вызова триггера в потоке. Войдите на сервер Resco Cloud, запустите консоль администрирования и выберите "Процессы" в меню. Нажмите кнопку "Создать", введите имя нового процесса, выберите нужную сущность (например, учетная запись) и нужное событие (например, запись создается).
Добавьте переменную headers StringList и добавьте в него элемент Content-Type: application/json;charset=utf-8 .
Добавьте строковую переменную body в виде "Формат текста" с помощью:
\{ "id": "{Entity.id}" \}
Затем добавьте шаг Server.InvokeWebRequest функции с POST методом. URL-адрес, скопированный из триггера и переменной текста HTTP-запроса.
Теперь при создании записи указанного типа сущности триггер активируется.
Распространенные ошибки и средства устранения неполадок
Для облачных серверов убедитесь, что в диалоговом окне подключения указан правильный сервер. В противном случае может возникнуть неавторизованная ошибка. Для пользовательских или локальных серверов введите URL-адрес, включая протокол и порт (если применимо), например https://mycompany.com[:8080]
Часто задаваемые вопросы
- Вопрос. Как использовать
List recordsвходные параметры? Ответ. Это стандартные параметры запроса OData. Синтаксис для каждого входного параметра определяется спецификацией OData. Единственное, о чем следует думать, заключается в использовании логических имен вместо отображаемых имен. (например, учетная запись —> учетная запись, имя —> имя и т. д.). Логические имена можно найти в разделе Сущности в консоли администрирования. - Вопрос. Как получить метку списка выбора?
Ответ. Каждое поле выбора возвращает 2 значения:
-
Field— Это значение списка выбора -
Field (Label)— это метка для значения списка выбора.
-
- Вопрос. Как получить метку подстановки?
Ответ. Каждое поле подстановки возвращает 3 значения:
-
Field— это идентификатор (GUID) ссылки -
Field (Label)— это метка (основное имя) ссылки. -
Field (Type)— это целевая сущность ссылки.
-
- Вопрос. Как настроить поле подстановки?
Ответ. При настройке полей подстановки необходимо создать ссылку, состоящую из типа записи и идентификатора записи.
- Из существующей записи в потоке можно использовать
OData Id - Путем создания
logicalName:idвыражения - Путем создания
logicalName('id')выражения
- Из существующей записи в потоке можно использовать
Создание подключения
Соединитель поддерживает следующие типы проверки подлинности:
| Облачный сервер | Используйте облачный сервер для доступа к вашей организации. | Все регионы | Недоступен для совместного использования |
| Локальный сервер | Используйте локальный сервер для доступа к вашей организации. | Все регионы | Недоступен для совместного использования |
| По умолчанию [не рекомендуется] | Этот параметр предназначен только для старых подключений без явного типа проверки подлинности и предоставляется только для обратной совместимости. | Все регионы | Недоступен для совместного использования |
Облачный сервер
Идентификатор проверки подлинности: cloudServer
Применимо: все регионы
Используйте облачный сервер для доступа к вашей организации.
Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.
| Имя | Тип | Description | Обязательно |
|---|---|---|---|
| Сервер Resco | струна | True | |
| Организация | струна | True | |
| Имя пользователя | securestring | True | |
| Пароль | securestring | True |
Локальный сервер
Идентификатор проверки подлинности: onPremiseServer
Применимо: все регионы
Используйте локальный сервер для доступа к вашей организации.
Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.
| Имя | Тип | Description | Обязательно |
|---|---|---|---|
| Сервер Resco | струна | True | |
| Организация | струна | True | |
| Имя пользователя | securestring | True | |
| Пароль | securestring | True |
По умолчанию [не рекомендуется]
Применимо: все регионы
Этот параметр предназначен только для старых подключений без явного типа проверки подлинности и предоставляется только для обратной совместимости.
Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.
| Имя | Тип | Description | Обязательно |
|---|---|---|---|
| Сервер Resco | струна | True | |
| Организация | струна | True | |
| Имя пользователя | securestring | True | |
| Пароль | securestring | True |
Ограничения регулирования
| Имя | Вызовы | Период обновления |
|---|---|---|
| Вызовы API для каждого подключения | 100 | 60 секунд |
Действия
| Обновить запись |
Обновление записи по идентификатору |
| Получение анкеты |
Получение записи о вопросиве по идентификатору |
| Получение записи |
Получение записи по идентификатору |
| Получение текущего пользователя |
Получение текущей записи пользователя по идентификатору |
| Создание новой записи |
Создание новой записи |
| Создание отчета |
Создание отчета |
| Список анкет |
Получение списка записей анкеты |
| Список записей |
Получение списка записей |
| Удаление записи |
Удаление записи по идентификатору |
Обновить запись
Обновление записи по идентификатору
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Код записи
|
id | True | string |
Введите глобальный уникальный идентификатор (GUID) |
|
ЭТаг
|
If-Match | string |
ETag (версия сущности) |
|
|
имя сущности,
|
entity | True | string |
Имя сущности |
|
body
|
body | True | dynamic |
Новые значения свойств |
Возвращаемое значение
Получение анкеты
Получение записи о вопросиве по идентификатору
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Код записи
|
id | True | string |
Введите глобальный уникальный идентификатор (GUID) |
|
Выбор запроса
|
$select | string |
Ограничение возвращаемых свойств при извлечении данных |
|
|
Имя вопроса
|
questionnaire | True | string |
Имя опрошающего |
Возвращаемое значение
Получение записи
Получение записи по идентификатору
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Код записи
|
id | True | string |
Введите глобальный уникальный идентификатор (GUID) |
|
Выбор запроса
|
$select | string |
Ограничение возвращаемых свойств при извлечении данных |
|
|
Развернуть запрос
|
$expand | string |
Связанные записи для включения с запрошенными записями (по умолчанию = нет) |
|
|
имя сущности,
|
entity | True | string |
Имя сущности |
Возвращаемое значение
Получение текущего пользователя
Получение текущей записи пользователя по идентификатору
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Выбор запроса
|
$select | string |
Ограничение возвращаемых свойств при извлечении данных |
|
|
Развернуть запрос
|
$expand | string |
Связанные записи для включения с запрошенными записями (по умолчанию = нет) |
Возвращаемое значение
Создание новой записи
Создание новой записи
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
имя сущности,
|
entity | True | string |
Имя сущности |
|
body
|
body | True | dynamic |
Новая запись |
Возвращаемое значение
Создание отчета
Создание отчета
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
имя сущности,
|
entity | True | string |
Имя сущности |
|
Код записи
|
id | True | string |
Введите глобальный уникальный идентификатор (GUID) |
|
Название отчета
|
report | True | string |
Имя отчета |
|
Формат
|
extension | True | string |
Формат файла |
Возвращаемое значение
- Содержимое отчета
- binary
Список анкет
Получение списка записей анкеты
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Выбор запроса
|
$select | string |
Ограничение возвращаемых свойств при извлечении данных |
|
|
Запрос фильтра
|
$filter | string |
Запрос фильтра ODATA для ограничения возвращаемых записей |
|
|
Первое число
|
$top | integer |
Общее количество записей для получения |
|
|
Количество пропусков
|
$skip | integer |
Пропуск первых записей n |
|
|
Игнорируемый токен
|
$skiptoken | string |
Маркер для доступа к следующей странице записей |
|
|
Имя вопроса
|
questionnaire | True | string |
Имя опрошающего |
Возвращаемое значение
Список записей
Получение списка записей
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Выбор запроса
|
$select | string |
Ограничение возвращаемых свойств при извлечении данных |
|
|
Запрос фильтра
|
$filter | string |
Запрос фильтра ODATA для ограничения возвращаемых записей |
|
|
Заказ по
|
$orderby | string |
Запрос порядка ODATA Для указания порядка записей |
|
|
Развернуть запрос
|
$expand | string |
Связанные записи для включения с запрошенными записями (по умолчанию = нет) |
|
|
Первое число
|
$top | integer |
Общее количество записей для получения |
|
|
Количество пропусков
|
$skip | integer |
Пропуск первых записей n |
|
|
Игнорируемый токен
|
$skiptoken | string |
Маркер для доступа к следующей странице записей |
|
|
имя сущности,
|
entity | True | string |
Имя сущности |
Возвращаемое значение
Удаление записи
Удаление записи по идентификатору
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Код записи
|
id | True | string |
Введите глобальный уникальный идентификатор (GUID) |
|
ЭТаг
|
If-Match | string |
ETag (версия сущности) |
|
|
имя сущности,
|
entity | True | string |
Имя сущности |
Триггеры
| При создании обновленного элемента |
При создании обновленного элемента |
При создании обновленного элемента
При создании обновленного элемента
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
имя сущности,
|
$entity | True | string |
Имя сущности |
|
Название действия
|
$action | True | string |
Действие |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
id
|
id | string |
Определения
бинарный
Это базовый тип данных binary.