CloudTools для Salesforce (предварительная версия)

Apptigent CloudTools предоставляет ряд действий по интеграции данных для Salesforce, к которым можно обращаться любым облачным приложением или рабочим процессом.

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

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

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

Метаданные соединителя
Publisher	Apptigent
Веб-сайт	https://www.apptigent.com
Политика конфиденциальности	https://www.apptigent.com/help/privacy-policy/
Категории	Продуктивность

Автоматизация критически важных бизнес-процессов с помощью простой кроссплатформенной облачной интеграции для Salesforce. Легко подключать Power Apps и Power Automate к организации Salesforce для получения сведений о клиентах, закрытия сделок, создания записей, преобразования потенциальных клиентов, выполнения массовых заданий, выполнения быстрых действий, отправки файлов, связывания документов с записями, веб-каналов обновления, получения связанных файлов и многое другое. Вы даже можете выполнять расширенные запросы и морей с помощью SOQL, SOSL и GraphQL. CloudTools разблокирует потенциал корпоративных данных CRM, делая его доступным из любого приложения или рабочего процесса.

Предпосылки

Для CloudTools требуется допустимая лицензия Salesforce, установка управляемого пакета CloudTools в организации Salesforce (любой выпуск) и текущая подписка CloudTools (выставляется отдельно). Пошаговые инструкции по началу работы.https://www.apptigent.com/solutions/cloudtools/configuration

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

Создайте ключ лицензии (API), выполнив следующие простые действия:

1. Установите управляемый пакет CloudTools через Exchange приложений Salesforce.
2. Запустите страницу конфигурации CloudTools, выбрав ссылку Apptigent CloudTools в средстве запуска приложений.
3. Следуйте инструкциям на экране, чтобы создать подключенное приложение и создать ключ лицензии.
4. Скопируйте ключ и укажите его в новом диалоговом окне подключения в Power Apps, Power Automate или Azure Logic Apps.

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

Для установки и настройки CloudTools для Salesforce Sales Cloud требуются разрешения системного администратора в Salesforce. Обратитесь к администратору Salesforce за помощью, если у вас нет достаточных разрешений в организации.

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

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

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

По умолчанию

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

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

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

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

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

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

Действия

Действия . Выполнение быстрого действия	Выполнение быстрого действия с необходимыми данными
Действия. Описание быстрого действия	Получение всех свойств быстрого действия
Действия— получение быстрых действий	Получение списка всех быстрых действий в организации
Задания — задание прерывания	Прерывание задания
Задания — получение всех заданий	Получение сведений обо всех заданиях
Задания — получение результата массового задания	Получение сведений о результатах массового задания
Задания — получение состояния массового задания	Проверка состояния задания
Задания — создание задания массового запроса	Создание задания массового запроса
Задания — удаление задания	Удалите задание
Задания— создание задания массового вставки	Создание задания массового вставки
Записи — обновление записи	Обновление записи указанного типа объекта
Записи — получение записи	Получение записи указанного типа объекта
Записи — связанные файлы	Получение сведений обо всех файлах, связанных с записью
Записи — создание записи	Создание новой записи указанного типа объекта
Записи — удаление записи	Удаление записи указанного типа объекта
Запросы — GraphQL-запрос	Выполнение запроса Graph QL для получения данных объекта и записи
Запросы — SOQL-запрос	Выполнение запроса SOQL
Запросы — поисковый запрос	Выполнение запроса поиска (SOSL)
Каналы — получение веб-канала записи	Получение канала записей Chatter
Каналы — создание элемента веб-канала	Создание нового элемента веб-канала, связанного с записью
Объекты — метаданные объектов	Получение метаданных объекта sObject
Объекты — описание объекта	Получение всех метаданных и полей sObject
Объекты — перечисление объектов	Получение списка всех объектов sObjects в организации
Объекты — поля, обновляемые объектом	Получение обновляемых полей sObject
Объекты — поля объектов	Получение полей sObject
Организация — перечисление версий API	Получение списка всех поддерживаемых версий API в организации
Организация — последняя версия API	Получение последней поддерживаемой версии API для организации
Потенциальные клиенты — преобразование свинца	Преобразование свинца
Файлы — версии документов	Получение списка сведений о версии отдельного файла (ContentDocument)
Файлы — метаданные документа	Получение сведений о файле (ContentDocument)
Файлы — общий доступ к документу	Связывание файла (ContentDocument) с записью и задание свойств общего доступа
Файлы — получение версии	Получение отдельной версии файла (ContentVersion)
Файлы — сведения о версиях	Получение сведений о отдельной версии файла (ContentVersion)
Файлы — создание версии	Отправка файла в виде нового объекта ContentVersion
Файлы — создание общедоступной ссылки	Создайте ссылку на общедоступный файл, к которому пользователи, не прошедшие проверку подлинности, могут получить доступ

Действия . Выполнение быстрого действия

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

ActionsExecuteQuickAction

Выполнение быстрого действия с необходимыми данными

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Имя	name	True	string	Имя быстрого действия
Данные	data	True	object	Быстрые данные действий

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

Тело

outputStringResult

Действия. Описание быстрого действия

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

ActionsDescribeQuickAction

Получение всех свойств быстрого действия

Параметры

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

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

Тело

outputStringResult

Действия— получение быстрых действий

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

ActionsListQuickActions

Получение списка всех быстрых действий в организации

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

Тело

outputActionList

Задания — задание прерывания

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

GlobalJobsAbortJob

Прерывание задания

Параметры

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

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

Тело

outputStringResult

Задания — получение всех заданий

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

JobsGetAllJobs

Получение сведений обо всех заданиях

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

response

object

Задания — получение результата массового задания

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

JobsGetJobResult

Получение сведений о результатах массового задания

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор задания	jobId		string	Идентификатор задания
Тип задания	jobType		string	Тип задания
Тип результата	resultType		string	Тип результирующий набор для извлечения
Указатель	locator		string	Указатель записи
Максимальное число записей	maxRecords		string	Максимальное количество возвращаемых записей

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

response

object

Задания — получение состояния массового задания

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

GlobalJobsGetStatus

Проверка состояния задания

Параметры

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

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

Тело

outputStringResult

Задания — создание задания массового запроса

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

JobsCreateQueryJob

Создание задания массового запроса

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Операция запроса	operation		string	Тип операции запроса
Разделитель столбцов	delimiter		string	Разделитель столбцов в выходном файле
Окончание строки	lineEnding		string	Конечный элемент строки выходного файла. LF для Unix/Linux/Mac OS, CRLF для Windows
Query	query		string	Большой результирующий запрос SOQL (незакодированный)

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

response

object

Задания — удаление задания

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

GlobalJobsDeleteJob

Удалите задание

Параметры

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

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

Тело

outputStringResult

Задания— создание задания массового вставки

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

JobsCreateInsertJob

Создание задания массового вставки

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Имя объекта	objectName		string	Имя типа sObject (например, Возможность)
Формат файла	fileFormat		string	Формат файла (в настоящее время поддерживается только CSV-файл)
Окончание строки	lineEnding		string	Конца строки входного файла. LF для Unix/Linus/Mac OS, CRLF для Windows
Файл	file		file	Двоичные данные файла (ограничение в 25 МБ)

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

response

object

Записи — обновление записи

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

GlobalUpdateRecord

Обновление записи указанного типа объекта

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Выбор имени объекта	name	True	string	Тип объекта, который будет обновлен
Код записи	recordId	True	string	Идентификатор обновляемой записи
body	body	True	dynamic	Входные данные обновления записи

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

response

object

Записи — получение записи

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

GlobalGetRecord

Получение записи указанного типа объекта

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Выбор имени объекта	name	True	string	Тип объекта, который будет извлечен
Код записи	recordId	True	string	Идентификатор извлекаемой записи

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

response

object

Записи — связанные файлы

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

GlobalRecordLinkedFiles

Получение сведений обо всех файлах, связанных с записью

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Код записи	recordId	True	string	Код записи
Типы ссылок	linkTypes	True	string	Тип связанных файлов для включения

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

response

object

Записи — создание записи

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

GlobalCreateRecord

Создание новой записи указанного типа объекта

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Выбор имени объекта	name	True	string	Тип объекта, который будет создан
body	body	True	dynamic	Входные данные для создания записи

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

response

object

Записи — удаление записи

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

GlobalDeleteObject

Удаление записи указанного типа объекта

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Выбор имени объекта	name	True	string	Тип объекта, который будет удален
Код записи	recordId	True	string	Идентификатор записи для удаления

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

response

object

Запросы — GraphQL-запрос

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

QueriesGraphQuery

Выполнение запроса Graph QL для получения данных объекта и записи

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Query	query	True	string	Текст запроса GraphQL

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

response

object

Запросы — SOQL-запрос

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

QueriesSOQlQuery

Выполнение запроса SOQL

Параметры

Имя	Ключ	Обязательно	Тип	Описание
query	query	True	string	Текст запроса SOQL (незакодированный)

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

response

object

Запросы — поисковый запрос

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

QueriesSearchQuery

Выполнение запроса поиска (SOSL)

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Имя	query	True	string	Текст запроса поиска (незакодированный)

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

response

object

Каналы — получение веб-канала записи

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

FeedsGetRecordElements

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

Параметры

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

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

response

object

Каналы — создание элемента веб-канала

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

FeedCreateItem

Создание нового элемента веб-канала, связанного с записью

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Содержимое веб-канала	body	True	string	Содержимое элемента веб-канала. Принимает значения обычного текста или объект JSON messageSegments для более сложных типов post (см. ссылку https://bit.ly/4706k0M).
Код записи	recordId	True	string	Связанный идентификатор записи

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

response

object

Объекты — метаданные объектов

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

GlobalObjectMetadata

Получение метаданных объекта sObject

Параметры

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

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

Тело

outputStringResult

Объекты — описание объекта

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

GlobalDescribeObject

Получение всех метаданных и полей sObject

Параметры

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

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

Тело

outputStringResult

Объекты — перечисление объектов

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

GlobalListObjects

Получение списка всех объектов sObjects в организации

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

Тело

outputStringResult

Объекты — поля, обновляемые объектом

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

GlobalObjectUpdateFields

Получение обновляемых полей sObject

Параметры

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

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

Тело

outputStringResult

Объекты — поля объектов

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

GlobalObjectFields

Получение полей sObject

Параметры

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

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

Тело

outputStringResult

Организация — перечисление версий API

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

OrgListVersions

Получение списка всех поддерживаемых версий API в организации

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

Тело

outputVersionList

Организация — последняя версия API

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

OrgLatestVersion

Получение последней поддерживаемой версии API для организации

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

Тело

outputStringResult

Потенциальные клиенты — преобразование свинца

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

RecordsLeadsConvertLead

Преобразование свинца

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор свинца	leadId	True	string	Идентификатор свинца
Создание возможности	createOpportunity		boolean	Создайте запись возможности при преобразовании. Значение по умолчанию — истинно.
Имя возможности	opportunityName		string	Задает имя возможности создания. Если имя не указано, это значение по умолчанию соответствует имени компании свинца.
Перезапись источника свинца	overwriteLeadSource		boolean	Перезаписать поле LeadSource в целевом объекте контакта с содержимым поля LeadSource в исходном объекте свинца. По умолчанию — false.
Отправка электронной почты уведомлений	sendNotificationEmail		boolean	Отправьте уведомление владельцу. По умолчанию — false.
Слияние с идентификатором учетной записи	mergeAccountId		string	Идентификатор учетной записи, в которую объединяется свинца. Используйте только при обновлении существующей учетной записи.
Слияние с идентификатором контакта	mergeContactId		string	Идентификатор контакта, в котором будет объединен потенциальный объект (должен быть уже связан с учетной записью, указанной в mergeAccountId). Используйте только при обновлении существующего контакта.
Слияние с идентификатором возможности	mergeOpportunityId		string	Идентификатор возможности объединения свинца. Используйте только при обновлении существующей возможности.
Идентификатор ответственного	ownerId		string	Идентификатор лица, которому принадлежит любая только что созданная учетная запись, контакт или возможность. Если пустое значение владельца свинца будет использоваться.

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

response

object

Файлы — версии документов

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

FilesListVersions

Получение списка сведений о версии отдельного файла (ContentDocument)

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор версии	documentId	True	string	Идентификатор объекта документа содержимого, содержащего версии, которые необходимо извлечь

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

response

object

Файлы — метаданные документа

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

FilesDocumentMetadata

Получение сведений о файле (ContentDocument)

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор документа	documentId	True	string	Идентификатор документа содержимого файла, который требуется получить

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

response

object

Файлы — общий доступ к документу

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

FilesShareDocument

Связывание файла (ContentDocument) с записью и задание свойств общего доступа

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор документа	documentId	True	string	Идентификатор файла (объект ContentDocument)
Код записи	recordId	True	string	Идентификатор записи, с которым будет связан файл
Видимость	visibility	True	string	Пользователи, которые могут получить доступ к файлу
Permissions	permissions	True	string	Разрешения для общего доступа (просмотр [только просмотр], сотрудник [просмотр/изменение/общий доступ], вывод из связанной записи)

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

response

object

Файлы — получение версии

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

FilesGetVersion

Получение отдельной версии файла (ContentVersion)

Параметры

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

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

response

object

Файлы — сведения о версиях

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

FilesVersionMetadata

Получение сведений о отдельной версии файла (ContentVersion)

Параметры

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

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

response

object

Файлы — создание версии

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

FilesCreateVersion

Отправка файла в виде нового объекта ContentVersion

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Имя	name		string	Имя файла (включая расширение)
Название	title		string	Заголовок файла
Идентификатор документа	documentId		string	(Необязательно) Идентификатор объекта ContentDocument (используется только при добавлении новой версии в существующий файл)
Причина изменения	reasonForChange		string	(Необязательно) Описание изменения
Файл	file		file	Двоичные данные файла

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

response

object

Файлы — создание общедоступной ссылки

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

FilesCreatePublicLink

Создайте ссылку на общедоступный файл, к которому пользователи, не прошедшие проверку подлинности, могут получить доступ

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор версии	versionId	True	string	Идентификатор версии содержимого файла
Имя файла	name	True	string	Имя файла
Просмотр в браузере	viewInBrowser		boolean	Создание ссылки предварительного просмотра для просмотра в браузере
Разрешить загрузку	allowDownload		boolean	Создание ссылки на скачивание для получения содержимого файла
Пароль	password		boolean	Пароль
Expiration	expiration		string	Дата окончания срока действия (необязательно)

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

Тело

outputPublicLink

Определения

outputActionList

Имя	Путь	Тип	Описание
Results	results	array of object	Results
items	results	object

outputPublicLink

Имя	Путь	Тип	Описание
Код объекта	objectId	string	Идентификатор объекта распространения содержимого
Success	success	boolean	Указывает на успешность или сбой операции
Пароль	password	string	Автоматическое создание значения пароля
URL-адрес	url	string	Общедоступный URL-адрес

outputStringResult

Имя	Путь	Тип	Описание
результат	result	string	Текстовый ответ

outputVersionList

Имя	Путь	Тип	Описание
Results	results	array of object	Results
items	results	object

объект

Это тип object.