Blackbaud RENXT Import (Pré-visualização)

O Edge NXT da Blackbaud Raiser é uma solução abrangente de software de angariação de fundos e gestão de doadores baseada na nuvem criada especificamente para organizações sem fins lucrativos e toda a comunidade social. Use o conector Import para gerir e executar trabalhos de importação.

Este conector está disponível nos seguintes produtos e regiões:

Serviço	Class	Regions
Estúdio Copiloto	Premium	Todas as regiões Power Automate exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas	Standard	Todas as regiões do Logic Apps , exceto as seguintes: - Regiões Azure Government - 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 (CCG) - 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 (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD)

Entrar em contato
Name	Suporte Blackbaud
URL	https://www.blackbaud.com/support
Email	skyapi@blackbaud.com

Metadados do conector
Publisher	Blackbaud, Inc.
Sítio Web	https://www.blackbaud.com/products/blackbaud-raisers-edge-nxt
Política de privacidade	https://www.blackbaud.com/privacy-shield
Categorias	Vendas e CRM; Produtividade

O Raiser's Edge NXT é uma solução abrangente de software de angariação de fundos e gestão de doadores baseada na nuvem criada especificamente para organizações sem fins lucrativos e toda a comunidade social do bem.

Este conector é construído sobre a API SKY da Blackbaud e fornece operações para ajudar a gerir trabalhos de importação dentro do Raiser's Edge NXT.

Para mais informações, consulte a documentação.

Prerequisites

Para usar esse conector, você deve ter uma conta Blackbaud ID com acesso a um ou mais ambientes Blackbaud.

Além disso, o administrador da sua organização também deve executar uma ação de nível de 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 configuração inicial .

Como obter credenciais?

O administrador da sua organização enviará um convite para o ambiente Raiser's Edge NXT da organização e configurará as permissões da sua conta de utilizador no ambiente. Não são necessárias credenciais adicionais para usar esse conector.

Problemas e limitações conhecidos

O conector funcionará no contexto da sua conta de usuário e, portanto, estará sujeito às suas permissões de usuário dentro do ambiente.

Ações

Arranja um emprego de importação	Devolve os detalhes de um trabalho específico de importação.
Atualizar um trabalho de importação	Atualiza os detalhes sobre um trabalho de importação.
Comece um trabalho de importação	Inicia um trabalho em segundo plano para executar a importação especificada.
Criar um trabalho de importação	Cria um trabalho de importação que será iniciado mais tarde, assim que o ficheiro for carregado.
Eliminar um trabalho de importação	Apaga um trabalho de importação.
Importar ficheiro de exceção de trabalho, descarregar URI	Devolve o URI de download para o ficheiro de exceção para um trabalho de importação.
Importar ficheiro de trabalho URI de upload	Devolve um novo URI de upload de ficheiro para um trabalho de importação pendente.
Lista de empregos de importação	Lista empregos de importação.

Arranja um emprego de importação

ID da Operação:: GetImportJob

Devolve os detalhes de um trabalho específico de importação.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
ID do trabalho	job_id	True	string	O ID do registo do sistema do trabalho de importação.

Devoluções

Trabalho de importação

Body: ImportApi.ImportJob

Atualizar um trabalho de importação

ID da Operação:: EditImportJob

Atualiza os detalhes sobre um trabalho de importação.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
ID de trabalho de importação	job_id	True	string	O ID do registo do sistema do trabalho de importação a atualizar.
Nome do ficheiro	file_name		string	O nome do ficheiro a importar.

Comece um trabalho de importação

ID da Operação:: StartImportJob

Inicia um trabalho em segundo plano para executar a importação especificada.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
ID do trabalho	job_id	True	string	O ID do trabalho de importação para começar.

Devoluções

Trabalho de relatório iniciado

Body: ImportApi.StartImportJobResponse

Criar um trabalho de importação

ID da Operação:: CreateImportJob

Cria um trabalho de importação que será iniciado mais tarde, assim que o ficheiro for carregado.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
Nome do ficheiro	file_name	True	string	O nome do ficheiro a importar.
Linha de cabeçalho	header_row		string	A linha de cabeçalho a usar ao importar um ficheiro CSV.

Devoluções

Consentimento constituinte criado

Body: ImportApi.CreateImportJobResponse

Eliminar um trabalho de importação

ID da Operação:: DeleteImportJob

Apaga um trabalho de importação.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
ID de trabalho de importação	job_id	True	string	O ID do registo do sistema do trabalho de importação a eliminar.

Importar ficheiro de exceção de trabalho, descarregar URI

ID da Operação:: GetImportJobExceptionFileDownloadUri

Devolve o URI de download para o ficheiro de exceção para um trabalho de importação.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
ID do trabalho	job_id	True	string	O ID do registo do sistema do trabalho de importação.

Devoluções

Informação para download do ficheiro

Body: ImportApi.ImportJobExceptionFileDownloadInfo

Importar ficheiro de trabalho URI de upload

ID da Operação:: GetImportJobFileUploadUri

Devolve um novo URI de upload de ficheiro para um trabalho de importação pendente.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Descrição
ID do trabalho	job_id	True	string	O ID do registo do sistema do trabalho de importação.

Devoluções

Informação de upload do ficheiro

Body: ImportApi.ImportJobFileUploadInfo

Lista de empregos de importação

ID da Operação:: ListImportJobs

Lista empregos de importação.

Parâmetros

Nome	Chave	Tipo	Descrição
Status	status	string	Filtra empregos por estatuto.
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 página seguinte de resultados.

Devoluções

Empregos de importação

Body: ImportApi.ImportJobSummaryCollection

Definições

ImportApi.CreateImportJobResponse

Consentimento constituinte criado

Nome	Caminho	Tipo	Descrição
ID	id	string	O ID do novo trabalho de importação criado.
URI de upload do ficheiro	file_upload_uri	string	O URI para carregar o ficheiro para importar.
Mapeamentos de campos	field_mappings	array of ImportApi.FieldMapping	Para importações CSV, o campo mapeia da linha do cabeçalho para os campos de destino.
Mapeamento de mensagens de validação	mapping_validation_messages	array of ImportApi.MappingValidationMessage	As mensagens de validação de mapeamento a partir da linha de cabeçalho do trabalho criado. Aplica-se apenas a importações de CSV.

ImportApi.FieldMapping

Mapeamento de campos

Nome	Caminho	Tipo	Descrição
Campo de origem	source_field	string	O nome do campo de origem.
Campo de alvo	target_field	string	O nome do campo alvo.

ImportApi.ImportJobFileUploadInfo

Informação de upload do ficheiro

Nome	Caminho	Tipo	Descrição
URI de upload do ficheiro	file_upload_uri	string	O URI para carregar o ficheiro para importar.

ImportApi.ImportJob

Trabalho de importação

Nome	Caminho	Tipo	Descrição
ID	id	string	O identificador de trabalho de importação.
Nome do ficheiro	file_name	string	O nome do ficheiro a ser importado.
Data de início	start_date	date-time	A data em que o trabalho de importação foi iniciado.
Data de conclusão	end_date	date-time	A data em que o trabalho de importação foi concluído.
Duração da 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 cometidas	rows_committed	integer	O número de linhas comprometidas 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 para o trabalho de importação.
Status	status	string	O status do trabalho de importação.
Adicionado por ID	added_by	string	O utilizador 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 de modificação	date_modified	date-time	A data em que o trabalho de importação foi modificado pela última vez.

ImportApi.ImportJobExceptionFileDownloadInfo

Informação para download do ficheiro

Nome	Caminho	Tipo	Descrição
URI para download de ficheiro	file_download_uri	string	O URI para descarregar o ficheiro de exceção.

ImportApi.ImportJobSummary

Trabalho de importação

Nome	Caminho	Tipo	Descrição
ID	id	string	O identificador de trabalho de importação.
Nome do ficheiro	file_name	string	O nome do ficheiro a ser importado.
Data de início	start_date	date-time	A data em que o trabalho de importação foi iniciado.
Data de conclusão	end_date	date-time	A data em que o trabalho de importação foi concluído.
Duração da 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 cometidas	rows_committed	integer	O número de linhas comprometidas 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 para o trabalho de importação.
Status	status	string	O status do trabalho de importação.
Adicionado por ID	added_by	string	O utilizador 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 de modificação	date_modified	date-time	A data em que o trabalho de importação foi modificado pela última vez.

ImportApi.ImportJobSummaryCollection

Empregos de importação

Nome	Caminho	Tipo	Descrição
Contagem	count	integer	O número total de trabalhos que correspondem ao filtro.
Limit	limit	integer	O número solicitado de registos para devolver.
Token de continuação	continuation_token	string	O token de continuação para obter a página seguinte 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	Descrição
Mapeamento de registos	record_mapping	string	O mapeamento de registos associado à mensagem de erro de validação.
Campo de alvo	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 ficheiro	file_fields	array of string	Os campos do ficheiro associados à mensagem de erro de validação.

ImportApi.StartImportJobResponse

Trabalho de relatório iniciado

Nome	Caminho	Tipo	Descrição
Status	status	string	O status do trabalho de importação.