Importazione RENXT blackbaud (anteprima)

Blackbaud Raiser Edge NXT è una soluzione software completa di raccolta fondi e gestione dei donatori basata sul cloud creata appositamente per organizzazioni no profit e l'intera comunità sociale. Usare il connettore di importazione per gestire ed eseguire processi di importazione.

Questo connettore è disponibile nei prodotti e nelle aree seguenti:

Service	Classe	Regions
Copilot Studio	Premium	Tutte le aree Power Automate ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD)
Logic Apps	Standard	Tutte le aree di App per la logica , ad eccezione delle seguenti: - aree Azure per enti pubblici - Aree di Azure Cina - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Apps	Premium	Tutte le aree Power Apps ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Automate	Premium	Tutte le aree Power Automate ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD)

Contatto
Name	Supporto blackbaud
URL	https://www.blackbaud.com/support
Email	skyapi@blackbaud.com

Metadati del connettore
Editore	Blackbaud, Inc.
Website	https://www.blackbaud.com/products/blackbaud-raisers-edge-nxt
Informativa sulla privacy	https://www.blackbaud.com/privacy-shield
Categorie	Vendite e CRM; Produttività

Edge NXT di Raiser è una soluzione software completa di raccolta fondi e gestione dei donatori basata sul cloud creata appositamente per organizzazioni no profit e l'intera comunità sociale.

Questo connettore si basa sull'API SKY di Blackbaud e fornisce operazioni per gestire i processi di importazione all'interno di The Raiser's Edge NXT.

Per altre informazioni, vedere la documentazione.

Prerequisiti

Per usare questo connettore, è necessario disporre di un account Blackbaud ID con accesso a uno o più ambienti Blackbaud.

Inoltre, l'amministratore dell'organizzazione deve eseguire un'azione a livello di amministratore all'interno del sistema per consentire a questo connettore di accedere all'ambiente Blackbaud. Altre informazioni su questi prerequisiti sono disponibili nella documentazione di configurazione iniziale .

Come ottenere le credenziali?

L'amministratore dell'organizzazione invierà un invito all'ambiente NXT edge dell'organizzazione e configurerà le autorizzazioni dell'account utente all'interno dell'ambiente. Per usare questo connettore non sono necessarie credenziali aggiuntive.

Problemi noti e limitazioni

Il connettore funzionerà nel contesto dell'account utente e sarà quindi soggetto alle autorizzazioni utente all'interno dell'ambiente.

Azioni

Aggiornare un processo di importazione	Aggiorna i dettagli relativi a un processo di importazione.
Avviare un processo di importazione	Avvia un processo in background per eseguire l'importazione specificata.
Creare un processo di importazione	Crea un processo di importazione che verrà avviato in un secondo momento dopo il caricamento del file.
Elencare i processi di importazione	Elenca i processi di importazione.
Eliminare un processo di importazione	Elimina un processo di importazione.
Ottenere l'URI di caricamento del file di processo di importazione	Restituisce un nuovo URI di caricamento file per un processo di importazione in sospeso.
Ottenere l'URI di download del file di eccezione del processo di importazione	Restituisce l'URI di download per il file di eccezione per un processo di importazione.
Ottenere un processo di importazione	Restituisce i dettagli di un processo di importazione specifico.

Aggiornare un processo di importazione

ID operazione:: EditImportJob

Aggiorna i dettagli relativi a un processo di importazione.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Importare l'ID processo	job_id	True	string	ID record di sistema del processo di importazione da aggiornare.
Nome del file	file_name		string	Nome del file da importare.

Avviare un processo di importazione

ID operazione:: StartImportJob

Avvia un processo in background per eseguire l'importazione specificata.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID lavoro	job_id	True	string	ID del processo di importazione da avviare.

Valori restituiti

Processo del report avviato

Corpo: ImportApi.StartImportJobResponse

Creare un processo di importazione

ID operazione:: CreateImportJob

Crea un processo di importazione che verrà avviato in un secondo momento dopo il caricamento del file.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Nome del file	file_name	True	string	Nome del file da importare.
Riga di intestazione	header_row		string	Riga di intestazione da usare durante l'importazione di un file CSV.

Valori restituiti

Consenso costitutivo creato

Corpo: ImportApi.CreateImportJobResponse

Elencare i processi di importazione

ID operazione:: ListImportJobs

Elenca i processi di importazione.

Parametri

Nome	Chiave	Tipo	Descrizione
Stato	status	string	Filtrare i processi in base allo stato.
Limit	limit	integer	Rappresenta il numero di record da restituire. L'impostazione predefinita è 100. Il valore massimo è 10000.
Token di continuazione	continuation_token	string	Token di continuazione per ottenere la pagina successiva dei risultati.

Valori restituiti

Importare processi

Corpo: ImportApi.ImportJobSummaryCollection

Eliminare un processo di importazione

ID operazione:: DeleteImportJob

Elimina un processo di importazione.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Importare l'ID processo	job_id	True	string	ID del record di sistema del processo di importazione da eliminare.

Ottenere l'URI di caricamento del file di processo di importazione

ID operazione:: GetImportJobFileUploadUri

Restituisce un nuovo URI di caricamento file per un processo di importazione in sospeso.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID lavoro	job_id	True	string	ID del record di sistema del processo di importazione.

Valori restituiti

Informazioni sul caricamento di file

Corpo: ImportApi.ImportJobFileUploadInfo

Ottenere l'URI di download del file di eccezione del processo di importazione

ID operazione:: GetImportJobExceptionFileDownloadUri

Restituisce l'URI di download per il file di eccezione per un processo di importazione.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID lavoro	job_id	True	string	ID del record di sistema del processo di importazione.

Valori restituiti

Informazioni sul download dei file

Corpo: ImportApi.ImportJobExceptionFileDownloadInfo

Ottenere un processo di importazione

ID operazione:: GetImportJob

Restituisce i dettagli di un processo di importazione specifico.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID lavoro	job_id	True	string	ID del record di sistema del processo di importazione.

Valori restituiti

Processo di importazione

Corpo: ImportApi.ImportJob

Definizioni

ImportApi.CreateImportJobResponse

Consenso costitutivo creato

Nome	Percorso	Tipo	Descrizione
ID	id	string	ID del processo di importazione appena creato.
URI di caricamento file	file_upload_uri	string	URI per il caricamento del file da importare.
Mappature dei campi	field_mappings	array of ImportApi.FieldMapping	Per le importazioni CSV, i mapping dei campi dalla riga di intestazione ai campi di destinazione.
Mapping dei messaggi di convalida	mapping_validation_messages	array of ImportApi.MappingValidationMessage	Messaggi di convalida del mapping dalla riga di intestazione del processo creato. Si applica solo alle importazioni CSV.

ImportApi.FieldMapping

Mapping dei campi

Nome	Percorso	Tipo	Descrizione
campo di origine	source_field	string	Nome del campo di origine.
campo di destinazione	target_field	string	Nome del campo di destinazione.

ImportApi.ImportJobFileUploadInfo

Informazioni sul caricamento di file

Nome	Percorso	Tipo	Descrizione
URI di caricamento file	file_upload_uri	string	URI per il caricamento del file da importare.

ImportApi.ImportJob

Processo di importazione

Nome	Percorso	Tipo	Descrizione
ID	id	string	Identificatore del processo di importazione.
Nome del file	file_name	string	Nome del file da importare.
Data di inizio	start_date	date-time	Data di inizio del processo di importazione.
Data di completamento	end_date	date-time	Data di completamento del processo di importazione.
Durata dell'esecuzione	run_duration	integer	Durata del processo di importazione in secondi.
Sequenza	sequence	integer	Numero di sequenza del processo di importazione.
Righe elaborate	rows_processed	integer	Numero di righe elaborate dal processo di importazione.
Righe di cui è stato eseguito il commit	rows_committed	integer	Numero di righe di cui è stato eseguito il commit dal processo di importazione.
Righe rifiutate	rows_rejected	integer	Numero di righe rifiutate dal processo di importazione.
Numero di eccezioni	exception_count	integer	Numero di eccezioni rilevate dal processo di importazione.
Messaggio di errore	failure_message	string	Messaggio di errore per il processo di importazione.
Stato	status	string	Stato del processo di importazione.
Aggiunta in base all'ID	added_by	string	Utente che ha creato il processo di importazione.
Data di creazione	date_added	date-time	Data di creazione del processo di importazione.
Data dell'ultima modifica	date_modified	date-time	Data dell'ultima modifica del processo di importazione.

ImportApi.ImportJobExceptionFileDownloadInfo

Informazioni sul download dei file

Nome	Percorso	Tipo	Descrizione
File download URI	file_download_uri	string	URI per il download del file di eccezione.

ImportApi.ImportJobSummary

Processo di importazione

Nome	Percorso	Tipo	Descrizione
ID	id	string	Identificatore del processo di importazione.
Nome del file	file_name	string	Nome del file da importare.
Data di inizio	start_date	date-time	Data di inizio del processo di importazione.
Data di completamento	end_date	date-time	Data di completamento del processo di importazione.
Durata dell'esecuzione	run_duration	integer	Durata del processo di importazione in secondi.
Sequenza	sequence	integer	Numero di sequenza del processo di importazione.
Righe elaborate	rows_processed	integer	Numero di righe elaborate dal processo di importazione.
Righe di cui è stato eseguito il commit	rows_committed	integer	Numero di righe di cui è stato eseguito il commit dal processo di importazione.
Righe rifiutate	rows_rejected	integer	Numero di righe rifiutate dal processo di importazione.
Numero di eccezioni	exception_count	integer	Numero di eccezioni rilevate dal processo di importazione.
Messaggio di errore	failure_message	string	Messaggio di errore per il processo di importazione.
Stato	status	string	Stato del processo di importazione.
Aggiunta in base all'ID	added_by	string	Utente che ha creato il processo di importazione.
Data di creazione	date_added	date-time	Data di creazione del processo di importazione.
Data dell'ultima modifica	date_modified	date-time	Data dell'ultima modifica del processo di importazione.

ImportApi.ImportJobSummaryCollection

Importare processi

Nome	Percorso	Tipo	Descrizione
Conteggio	count	integer	Numero totale di processi corrispondenti al filtro.
Limit	limit	integer	Numero di record richiesto da restituire.
Token di continuazione	continuation_token	string	Token di continuazione per ottenere la pagina successiva dei risultati.
jobs	jobs	array of ImportApi.ImportJobSummary	Set di elementi inclusi nella risposta.

ImportApi.MappingValidationMessage

Messaggio di convalida del mapping

Nome	Percorso	Tipo	Descrizione
mapping dei record	record_mapping	string	Mapping di record associato al messaggio di errore di convalida.
campo di destinazione	target_field	string	Campo di destinazione associato al messaggio di errore di convalida.
tipo di messaggio	message_type	string	Tipo del messaggio di convalida.
message	message	string	Messaggio di convalida.
campi di file	file_fields	array of string	Campi del file associati al messaggio di errore di convalida.

ImportApi.StartImportJobResponse

Processo del report avviato

Nome	Percorso	Tipo	Descrizione
Stato	status	string	Stato del processo di importazione.