Импорт Blackbaud RENXT (предварительная версия)
Blackbaud Raiser Edge NXT — это комплексное облачное решение для сбора средств и программного обеспечения для управления донорами, созданное специально для некоммерческих организаций и всего социального хорошего сообщества. Используйте соединитель импорта для управления заданиями импорта и выполнения заданий импорта.
Этот соединитель доступен в следующих продуктах и регионах:
| Услуга | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Логические приложения | Standard | Все регионы Logic Apps , кроме следующих: — Регионы Azure для государственных организаций — Регионы Azure Для Китая - Министерство обороны США (DoD) |
| Power Apps | Premium | Все регионы Power Apps , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Power Automate | Premium | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Контакт | |
|---|---|
| Name | Поддержка Blackbaud |
| URL-адрес | https://www.blackbaud.com/support |
| skyapi@blackbaud.com |
| Метаданные соединителя | |
|---|---|
| Publisher | Blackbaud, Inc. |
| Веб-сайт | https://www.blackbaud.com/products/blackbaud-raisers-edge-nxt |
| Политика конфиденциальности | https://www.blackbaud.com/privacy-shield |
| Categories | Продажи и CRM; Продуктивность |
Edge NXT Raiser — это комплексное облачное решение для сбора средств и программного обеспечения для управления донорами, созданное специально для некоммерческих организаций и всего социального хорошего сообщества.
Этот соединитель построен на основе API Sky Blackbaud и предоставляет операции для управления заданиями импорта в пограничном NXT Edge Raiser.
Дополнительные сведения см. в документации.
Prerequisites
Чтобы использовать этот соединитель, у вас должна быть учетная запись Blackbaud ID с доступом к одной или нескольким средам Blackbaud.
Кроме того, администратор вашей организации также должен выполнять действия уровня администратора в системе, чтобы этот соединитель мог получить доступ к вашей среде Blackbaud. Дополнительные сведения об этих предварительных требованиях см. в документации по начальной настройке .
Как получить учетные данные?
Администратор вашей организации отправит вам приглашение в среду NXT edge организации и настроит разрешения учетной записи пользователя в среде. Для использования этого соединителя дополнительные учетные данные не требуются.
Известные проблемы и ограничения
Соединитель будет работать в контексте учетной записи пользователя и, следовательно, будет применяться к вашим разрешениям пользователя в среде.
Действия
| Запуск задания импорта |
Запускает фоновое задание для выполнения указанного импорта. |
| Обновление задания импорта |
Обновляет сведения о задании импорта. |
| Перечисление заданий импорта |
Перечисляет задания импорта. |
| Получение URI отправки файла задания импорта |
Возвращает новый URI отправки файла для ожидающего задания импорта. |
| Получение задания импорта |
Возвращает сведения о конкретном задании импорта. |
| Получение файла исключения задания импорта скачать URI |
Возвращает URI скачивания для файла исключений для задания импорта. |
| Создание задания импорта |
Создает задание импорта, которое будет запущено позже после отправки файла. |
| Удаление задания импорта |
Удаляет задание импорта. |
Запуск задания импорта
Запускает фоновое задание для выполнения указанного импорта.
Параметры
| Имя. | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор задания
|
job_id | True | string |
Идентификатор запускаемого задания импорта. |
Возвращаемое значение
Запущено задание отчета
Обновление задания импорта
Обновляет сведения о задании импорта.
Параметры
| Имя. | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Импорт идентификатора задания
|
job_id | True | string |
Идентификатор системной записи задания импорта для обновления. |
|
Имя файла
|
file_name | string |
Имя импорта файла. |
Перечисление заданий импорта
Перечисляет задания импорта.
Параметры
| Имя. | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Status
|
status | string |
Фильтрация заданий по состоянию. |
|
|
Limit
|
limit | integer |
Представляет количество возвращаемых записей. Значение по умолчанию равно 100. Максимальное значение — 10000. |
|
|
Метка продолжения
|
continuation_token | string |
Маркер продолжения для получения следующей страницы результатов. |
Возвращаемое значение
Импорт заданий
Получение URI отправки файла задания импорта
Возвращает новый URI отправки файла для ожидающего задания импорта.
Параметры
| Имя. | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор задания
|
job_id | True | string |
Идентификатор системной записи задания импорта. |
Возвращаемое значение
Сведения о отправке файлов
Получение задания импорта
Возвращает сведения о конкретном задании импорта.
Параметры
| Имя. | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор задания
|
job_id | True | string |
Идентификатор системной записи задания импорта. |
Возвращаемое значение
Задача импорта
- Тело
- ImportApi.ImportJob
Получение файла исключения задания импорта скачать URI
Возвращает URI скачивания для файла исключений для задания импорта.
Параметры
| Имя. | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор задания
|
job_id | True | string |
Идентификатор системной записи задания импорта. |
Возвращаемое значение
Сведения о скачивание файла
Создание задания импорта
Создает задание импорта, которое будет запущено позже после отправки файла.
Параметры
| Имя. | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Имя файла
|
file_name | True | string |
Имя импорта файла. |
|
Строка заголовка
|
header_row | string |
Строка заголовка, используемая при импорте CSV-файла. |
Возвращаемое значение
Созданное согласие на создание компонента
Удаление задания импорта
Удаляет задание импорта.
Параметры
| Имя. | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Импорт идентификатора задания
|
job_id | True | string |
Идентификатор системной записи задания импорта для удаления. |
Определения
ImportApi.CreateImportJobResponse
Созданное согласие на создание компонента
| Имя. | Путь | Тип | Описание |
|---|---|---|---|
|
ID
|
id | string |
Идентификатор только что созданного задания импорта. |
|
URI отправки файлов
|
file_upload_uri | string |
URI для отправки файла для импорта. |
|
Сопоставления полей
|
field_mappings | array of ImportApi.FieldMapping |
Для импорта CSV поля сопоставляется со строкой заголовка с целевыми полями. |
|
Сопоставление сообщений проверки
|
mapping_validation_messages | array of ImportApi.MappingValidationMessage |
Сообщения проверки сопоставления из строки заголовка созданного задания. Применяется только к импорту CSV-файлов. |
ImportApi.FieldMapping
Сопоставление полей
| Имя. | Путь | Тип | Описание |
|---|---|---|---|
|
исходное поле
|
source_field | string |
Имя исходного поля. |
|
целевое поле
|
target_field | string |
Имя целевого поля. |
ImportApi.ImportJobFileUploadInfo
Сведения о отправке файлов
| Имя. | Путь | Тип | Описание |
|---|---|---|---|
|
URI отправки файлов
|
file_upload_uri | string |
URI для отправки файла для импорта. |
ImportApi.ImportJob
Задача импорта
| Имя. | Путь | Тип | Описание |
|---|---|---|---|
|
ID
|
id | string |
Идентификатор задания импорта. |
|
Имя файла
|
file_name | string |
Имя импортируемого файла. |
|
Дата начала
|
start_date | date-time |
Дата начала задания импорта. |
|
Дата завершения
|
end_date | date-time |
Дата завершения задания импорта. |
|
Длительность запуска
|
run_duration | integer |
Длительность задания импорта в секундах. |
|
Последовательность
|
sequence | integer |
Порядковый номер задания импорта. |
|
Обработанные строки
|
rows_processed | integer |
Количество строк, обработанных заданием импорта. |
|
Зафиксированные строки
|
rows_committed | integer |
Количество строк, зафиксированных заданием импорта. |
|
Отклоненные строки
|
rows_rejected | integer |
Количество строк, отклоненных заданием импорта. |
|
Число исключений
|
exception_count | integer |
Количество исключений, возникающих заданием импорта. |
|
Сообщение о сбое
|
failure_message | string |
Сообщение об ошибке для задания импорта. |
|
Status
|
status | string |
Состояние задания импорта. |
|
Добавлен по идентификатору
|
added_by | string |
Пользователь, создавший задание импорта. |
|
Дата создания
|
date_added | date-time |
Дата создания задания импорта. |
|
Дата изменения
|
date_modified | date-time |
Дата последнего изменения задания импорта. |
ImportApi.ImportJobExceptionFileDownloadInfo
Сведения о скачивание файла
| Имя. | Путь | Тип | Описание |
|---|---|---|---|
|
Универсальный код ресурса (URI) скачивания файлов
|
file_download_uri | string |
Универсальный код ресурса (URI) для скачивания файла исключений. |
ImportApi.ImportJobSummary
Задача импорта
| Имя. | Путь | Тип | Описание |
|---|---|---|---|
|
ID
|
id | string |
Идентификатор задания импорта. |
|
Имя файла
|
file_name | string |
Имя импортируемого файла. |
|
Дата начала
|
start_date | date-time |
Дата начала задания импорта. |
|
Дата завершения
|
end_date | date-time |
Дата завершения задания импорта. |
|
Длительность запуска
|
run_duration | integer |
Длительность задания импорта в секундах. |
|
Последовательность
|
sequence | integer |
Порядковый номер задания импорта. |
|
Обработанные строки
|
rows_processed | integer |
Количество строк, обработанных заданием импорта. |
|
Зафиксированные строки
|
rows_committed | integer |
Количество строк, зафиксированных заданием импорта. |
|
Отклоненные строки
|
rows_rejected | integer |
Количество строк, отклоненных заданием импорта. |
|
Число исключений
|
exception_count | integer |
Количество исключений, возникающих заданием импорта. |
|
Сообщение о сбое
|
failure_message | string |
Сообщение об ошибке для задания импорта. |
|
Status
|
status | string |
Состояние задания импорта. |
|
Добавлен по идентификатору
|
added_by | string |
Пользователь, создавший задание импорта. |
|
Дата создания
|
date_added | date-time |
Дата создания задания импорта. |
|
Дата изменения
|
date_modified | date-time |
Дата последнего изменения задания импорта. |
ImportApi.ImportJobSummaryCollection
Импорт заданий
| Имя. | Путь | Тип | Описание |
|---|---|---|---|
|
Счетч.
|
count | integer |
Общее количество заданий, соответствующих фильтру. |
|
Limit
|
limit | integer |
Запрошенный номер возвращаемых записей. |
|
Метка продолжения
|
continuation_token | string |
Маркер продолжения для получения следующей страницы результатов. |
|
jobs
|
jobs | array of ImportApi.ImportJobSummary |
Набор элементов, включенных в ответ. |
ImportApi.MappingValidationMessage
Сообщение проверки сопоставления
| Имя. | Путь | Тип | Описание |
|---|---|---|---|
|
Сопоставление записей
|
record_mapping | string |
Сопоставление записей, связанное с сообщением об ошибке проверки. |
|
целевое поле
|
target_field | string |
Целевое поле, связанное с сообщением об ошибке проверки. |
|
тип сообщений
|
message_type | string |
Тип сообщения проверки. |
|
message
|
message | string |
Сообщение проверки. |
|
Поля файлов
|
file_fields | array of string |
Поля файла, связанные с сообщением об ошибке проверки. |
ImportApi.StartImportJobResponse
Запущено задание отчета
| Имя. | Путь | Тип | Описание |
|---|---|---|---|
|
Status
|
status | string |
Состояние задания импорта. |