Importação do BLACKbaud RENXT (versão prévia)
O Blackbaud Raiser's Edge NXT é uma solução abrangente de software de captação de recursos e gerenciamento de doadores baseada em nuvem criada especificamente para organizações sem fins lucrativos e toda a comunidade de bem social. Use o conector De importação para gerenciar e executar trabalhos de importação.
Esse conector está disponível nos seguintes produtos e regiões:
| Serviço | Classe | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões Power Automate exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Azure Governamental regiões - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões Power Apps exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões Power Automate exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Name | Suporte do Blackbaud |
| URL | https://www.blackbaud.com/support |
| skyapi@blackbaud.com |
| Metadados do conector | |
|---|---|
| Publicador | Blackbaud, Inc. |
| Website | https://www.blackbaud.com/products/blackbaud-raisers-edge-nxt |
| Política de privacidade | https://www.blackbaud.com/privacy-shield |
| Categories | Vendas e CRM; Produtividade |
O Raiser's Edge NXT é uma solução abrangente de software de captação de recursos e gerenciamento de doadores baseada em nuvem criada especificamente para organizações sem fins lucrativos e toda a comunidade de bem social.
Esse conector é criado com base na API SKY da Blackbaud e fornece operações para ajudar a gerenciar trabalhos de importação no NXT de Borda do Raiser.
Para obter mais informações, veja a documentação.
Prerequisites
Para usar esse conector, você deve ter uma conta de ID do Blackbaud com acesso a um ou mais ambientes Blackbaud.
Além disso, o administrador da sua organização também deve executar uma ação no nível do administrador dentro do sistema para permitir que esse conector acesse seu ambiente blackbaud. Mais informações sobre esses pré-requisitos podem ser encontradas na documentação de instalação inicial .
Como obter credenciais?
O administrador da sua organização enviará um convite para o ambiente do Raiser's Edge NXT da organização e configurará suas permissões de conta de usuário dentro do ambiente. Não são necessárias credenciais adicionais para usar esse conector.
Limitações e problemas conhecidos
O conector funcionará no contexto da sua conta de usuário e, portanto, estará sujeito às permissões do usuário dentro do ambiente.
Ações
| Atualizar um trabalho de importação |
Atualiza os detalhes sobre um trabalho de importação. |
| Criação de uma tarefa de importação |
Cria um trabalho de importação que será iniciado mais tarde depois que o arquivo tiver sido carregado. |
| Excluir um trabalho de importação |
Exclui um trabalho de importação. |
| Iniciar um trabalho de importação |
Inicia um trabalho em segundo plano para executar a importação especificada. |
| Listar trabalhos de importação |
Lista trabalhos de importação. |
| Obter um trabalho de importação |
Retorna os detalhes de um trabalho de importação específico. |
| Obter URI de download de arquivo de exceção de trabalho de importação |
Retorna o URI de download do arquivo de exceção para um trabalho de importação. |
| Obter URI de upload de arquivo de trabalho de importação |
Retorna um novo URI de upload de arquivo para um trabalho de importação pendente. |
Atualizar um trabalho de importação
Atualiza os detalhes sobre um trabalho de importação.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Importar ID do trabalho
|
job_id | True | string |
A ID do registro do sistema do trabalho de importação a ser atualizado. |
|
Nome do arquivo
|
file_name | string |
O nome do arquivo a ser importado. |
Criação de uma tarefa de importação
Cria um trabalho de importação que será iniciado mais tarde depois que o arquivo tiver sido carregado.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome do arquivo
|
file_name | True | string |
O nome do arquivo a ser importado. |
|
Linha de cabeçalho
|
header_row | string |
A linha de cabeçalho a ser usada ao importar um arquivo CSV. |
Retornos
Consentimento constituinte criado
Excluir um trabalho de importação
Exclui um trabalho de importação.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Importar ID do trabalho
|
job_id | True | string |
A ID do registro do sistema do trabalho de importação a ser excluído. |
Iniciar um trabalho de importação
Inicia um trabalho em segundo plano para executar a importação especificada.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do trabalho
|
job_id | True | string |
A ID do trabalho de importação a ser iniciado. |
Retornos
Trabalho de relatório iniciado
Listar trabalhos de importação
Lista trabalhos de importação.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Status
|
status | string |
Filtrar trabalhos por status. |
|
|
Limit
|
limit | integer |
Representa o número de registros a serem retornados. O padrão é 100. O máximo é 10000. |
|
|
Token de continuação
|
continuation_token | string |
O token de continuação para obter a próxima página de resultados. |
Retornos
Importar trabalhos
Obter um trabalho de importação
Retorna os detalhes de um trabalho de importação específico.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do trabalho
|
job_id | True | string |
A ID do registro do sistema do trabalho de importação. |
Retornos
Importar trabalho
- Body
- ImportApi.ImportJob
Obter URI de download de arquivo de exceção de trabalho de importação
Retorna o URI de download do arquivo de exceção para um trabalho de importação.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do trabalho
|
job_id | True | string |
A ID do registro do sistema do trabalho de importação. |
Retornos
Informações de download de arquivo
Obter URI de upload de arquivo de trabalho de importação
Retorna um novo URI de upload de arquivo para um trabalho de importação pendente.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do trabalho
|
job_id | True | string |
A ID do registro do sistema do trabalho de importação. |
Retornos
Informações de upload de arquivo
Definições
ImportApi.CreateImportJobResponse
Consentimento constituinte criado
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
id | string |
A ID do trabalho de importação recém-criado. |
|
URI de upload de arquivo
|
file_upload_uri | string |
O URI para carregar o arquivo a ser importado. |
|
Mapeamentos de campos
|
field_mappings | array of ImportApi.FieldMapping |
Para importações CSV, o campo mapeia da linha de cabeçalho para os campos de destino. |
|
Mapeando mensagens de validação
|
mapping_validation_messages | array of ImportApi.MappingValidationMessage |
As mensagens de validação de mapeamento da linha de cabeçalho do trabalho criado. Aplica-se apenas às importações de CSV. |
ImportApi.FieldMapping
Mapeamento de campo
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
campo de origem
|
source_field | string |
O nome do campo de origem. |
|
campo de destino
|
target_field | string |
O nome do campo de destino. |
ImportApi.ImportJobFileUploadInfo
Informações de upload de arquivo
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
URI de upload de arquivo
|
file_upload_uri | string |
O URI para carregar o arquivo a ser importado. |
ImportApi.ImportJob
Importar trabalho
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
id | string |
O identificador do trabalho de importação. |
|
Nome do arquivo
|
file_name | string |
O nome do arquivo que está sendo importado. |
|
Data iniciada
|
start_date | date-time |
A data em que o trabalho de importação foi iniciado. |
|
Data concluída
|
end_date | date-time |
A data em que o trabalho de importação foi concluído. |
|
Tempo de execução
|
run_duration | integer |
A duração do trabalho de importação em segundos. |
|
Sequência
|
sequence | integer |
O número de sequência do trabalho de importação. |
|
Linhas processadas
|
rows_processed | integer |
O número de linhas processadas pelo trabalho de importação. |
|
Linhas confirmadas
|
rows_committed | integer |
O número de linhas confirmadas pelo trabalho de importação. |
|
Linhas rejeitadas
|
rows_rejected | integer |
O número de linhas rejeitadas pelo trabalho de importação. |
|
Contagem de exceções
|
exception_count | integer |
O número de exceções encontradas pelo trabalho de importação. |
|
Mensagem de falha
|
failure_message | string |
A mensagem de falha do trabalho de importação. |
|
Status
|
status | string |
O status do trabalho de importação. |
|
Adicionado por ID
|
added_by | string |
O usuário que criou o trabalho de importação. |
|
Data de criação
|
date_added | date-time |
A data em que o trabalho de importação foi criado. |
|
Data da modificação
|
date_modified | date-time |
A data em que o trabalho de importação foi modificado pela última vez. |
ImportApi.ImportJobExceptionFileDownloadInfo
Informações de download de arquivo
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
URI de download de arquivo
|
file_download_uri | string |
O URI para baixar o arquivo de exceção. |
ImportApi.ImportJobSummary
Importar trabalho
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID
|
id | string |
O identificador do trabalho de importação. |
|
Nome do arquivo
|
file_name | string |
O nome do arquivo que está sendo importado. |
|
Data iniciada
|
start_date | date-time |
A data em que o trabalho de importação foi iniciado. |
|
Data concluída
|
end_date | date-time |
A data em que o trabalho de importação foi concluído. |
|
Tempo de execução
|
run_duration | integer |
A duração do trabalho de importação em segundos. |
|
Sequência
|
sequence | integer |
O número de sequência do trabalho de importação. |
|
Linhas processadas
|
rows_processed | integer |
O número de linhas processadas pelo trabalho de importação. |
|
Linhas confirmadas
|
rows_committed | integer |
O número de linhas confirmadas pelo trabalho de importação. |
|
Linhas rejeitadas
|
rows_rejected | integer |
O número de linhas rejeitadas pelo trabalho de importação. |
|
Contagem de exceções
|
exception_count | integer |
O número de exceções encontradas pelo trabalho de importação. |
|
Mensagem de falha
|
failure_message | string |
A mensagem de falha do trabalho de importação. |
|
Status
|
status | string |
O status do trabalho de importação. |
|
Adicionado por ID
|
added_by | string |
O usuário que criou o trabalho de importação. |
|
Data de criação
|
date_added | date-time |
A data em que o trabalho de importação foi criado. |
|
Data da modificação
|
date_modified | date-time |
A data em que o trabalho de importação foi modificado pela última vez. |
ImportApi.ImportJobSummaryCollection
Importar trabalhos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Contagem
|
count | integer |
O número total de trabalhos correspondentes ao filtro. |
|
Limit
|
limit | integer |
O número solicitado de registros a serem retornados. |
|
Token de continuação
|
continuation_token | string |
O token de continuação para obter a próxima página de resultados. |
|
jobs
|
jobs | array of ImportApi.ImportJobSummary |
O conjunto de itens incluídos na resposta. |
ImportApi.MappingValidationMessage
Mensagem de validação de mapeamento
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
mapeamento de registros
|
record_mapping | string |
O mapeamento de registro associado à mensagem de erro de validação. |
|
campo de destino
|
target_field | string |
O campo de destino associado à mensagem de erro de validação. |
|
tipo de mensagem
|
message_type | string |
O tipo da mensagem de validação. |
|
mensagem
|
message | string |
A mensagem de validação. |
|
campos de arquivo
|
file_fields | array of string |
Os campos de arquivo associados à mensagem de erro de validação. |
ImportApi.StartImportJobResponse
Trabalho de relatório iniciado
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Status
|
status | string |
O status do trabalho de importação. |