Blackbaud RENXT Import (preview)
Blackbaud Raiser's Edge NXT is een uitgebreide cloudoplossing voor fondsenwerving en donorbeheersoftware die speciaal is gebouwd voor non-profitorganisaties en de hele sociale goede gemeenschap. Gebruik de importconnector om importtaken te beheren en uit te voeren.
Deze connector is beschikbaar in de volgende producten en regio's:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate regio's behalve: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Logische apps | Standard | Alle Logic Apps-regio's , met uitzondering van het volgende: - Azure Government regio's - Azure China-regio's - Us Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps regio's behalve: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate regio's behalve: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Contactpersoon | |
|---|---|
| Name | Ondersteuning voor Blackbaud |
| URL | https://www.blackbaud.com/support |
| skyapi@blackbaud.com |
| Connectormetagegevens | |
|---|---|
| Publisher | Blackbaud, Inc. |
| Website | https://www.blackbaud.com/products/blackbaud-raisers-edge-nxt |
| Privacybeleid | https://www.blackbaud.com/privacy-shield |
| Categorieën | Verkoop en CRM; Productiviteit |
Raiser's Edge NXT is een uitgebreide cloudoplossing voor fondsenwerving en donorbeheersoftware die speciaal is gebouwd voor non-profitorganisaties en de hele sociale goede community.
Deze connector is gebouwd op de SKY-API van Blackbaud en biedt bewerkingen voor het beheren van importtaken binnen The Raiser's Edge NXT.
Raadpleeg de documentatie voor meer informatie.
Prerequisites
Als u deze connector wilt gebruiken, moet u een Blackbaud ID-account hebben met toegang tot een of meer Blackbaud-omgevingen.
Daarnaast moet de beheerder van uw organisatie ook een actie op beheerdersniveau uitvoeren binnen het systeem om deze connector toegang te geven tot uw Blackbaud-omgeving. Meer informatie over deze vereisten vindt u in de eerste installatiedocumentatie .
Hoe kan ik referenties ophalen?
De beheerder van uw organisatie stuurt u een uitnodiging naar de Edge NXT-omgeving van de organisatie en configureert uw gebruikersaccountmachtigingen in de omgeving. Er zijn geen aanvullende referenties vereist voor het gebruik van deze connector.
Bekende problemen en beperkingen
De connector werkt in de context van uw gebruikersaccount en is daarom onderhevig aan uw gebruikersmachtigingen binnen de omgeving.
Acties
| Download-URI voor importtaak-uitzonderingsbestand ophalen |
Retourneert de download-URI voor het uitzonderingsbestand voor een importtaak. |
| Een importtaak bijwerken |
Hiermee worden de details van een importtaak bijgewerkt. |
| Een importtaak maken |
Hiermee maakt u een importtaak die later wordt gestart zodra het bestand is geüpload. |
| Een importtaak ophalen |
Retourneert de details van een specifieke importtaak. |
| Een importtaak starten |
Hiermee start u een achtergrondtaak om de opgegeven import uit te voeren. |
| Een importtaak verwijderen |
Hiermee verwijdert u een importtaak. |
| Importtaken weergeven |
Een lijst met importtaken. |
| Upload-URI voor importtaakbestand ophalen |
Retourneert een nieuwe URI voor het uploaden van bestanden voor een importtaak die in behandeling is. |
Download-URI voor importtaak-uitzonderingsbestand ophalen
Retourneert de download-URI voor het uitzonderingsbestand voor een importtaak.
Parameters
| Naam | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Job-ID
|
job_id | True | string |
De systeemrecord-id van de importtaak. |
Retouren
Informatie over het downloaden van bestanden
Een importtaak bijwerken
Hiermee worden de details van een importtaak bijgewerkt.
Parameters
| Naam | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Taak-id importeren
|
job_id | True | string |
De systeemrecord-id van de importtaak die moet worden bijgewerkt. |
|
Bestandsnaam
|
file_name | string |
De naam van het te importeren bestand. |
Een importtaak maken
Hiermee maakt u een importtaak die later wordt gestart zodra het bestand is geüpload.
Parameters
| Naam | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Bestandsnaam
|
file_name | True | string |
De naam van het te importeren bestand. |
|
Kopregel
|
header_row | string |
De veldnamenrij die moet worden gebruikt bij het importeren van een CSV-bestand. |
Retouren
Samenstellende toestemming gemaakt
Een importtaak ophalen
Retourneert de details van een specifieke importtaak.
Parameters
| Naam | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Job-ID
|
job_id | True | string |
De systeemrecord-id van de importtaak. |
Retouren
Importtaak
- Body
- ImportApi.ImportJob
Een importtaak starten
Hiermee start u een achtergrondtaak om de opgegeven import uit te voeren.
Parameters
| Naam | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Job-ID
|
job_id | True | string |
De id van de importtaak die moet worden gestart. |
Retouren
Rapporttaak gestart
Een importtaak verwijderen
Hiermee verwijdert u een importtaak.
Parameters
| Naam | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Taak-id importeren
|
job_id | True | string |
De systeemrecord-id van de importtaak die moet worden verwijderd. |
Importtaken weergeven
Een lijst met importtaken.
Parameters
| Naam | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Status
|
status | string |
Filter taken op status. |
|
|
Limit
|
limit | integer |
Geeft het aantal records weer dat moet worden geretourneerd. De standaardwaarde is 100. Het maximum is 10000. |
|
|
Vervolgtoken
|
continuation_token | string |
Het vervolgtoken om de volgende pagina met resultaten op te halen. |
Retouren
Taken importeren
Upload-URI voor importtaakbestand ophalen
Retourneert een nieuwe URI voor het uploaden van bestanden voor een importtaak die in behandeling is.
Parameters
| Naam | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Job-ID
|
job_id | True | string |
De systeemrecord-id van de importtaak. |
Retouren
Gegevens over het uploaden van bestanden
Definities
ImportApi.CreateImportJobResponse
Samenstellende toestemming gemaakt
| Naam | Pad | Type | Description |
|---|---|---|---|
|
Id
|
id | string |
De id van de zojuist gemaakte importtaak. |
|
URI voor het uploaden van bestanden
|
file_upload_uri | string |
De URI voor het uploaden van het te importeren bestand. |
|
Veldtoewijzingen
|
field_mappings | array of ImportApi.FieldMapping |
Voor CSV-importbewerkingen worden de veldtoewijzingen uit de veldnamenrij naar de doelvelden weergegeven. |
|
Validatieberichten toewijzen
|
mapping_validation_messages | array of ImportApi.MappingValidationMessage |
De toewijzingsvalidatieberichten van de veldnamenrij van de gemaakte taak. Alleen van toepassing op CSV-importbewerkingen. |
ImportApi.FieldMapping
Veldtoewijzing
| Naam | Pad | Type | Description |
|---|---|---|---|
|
bronveld
|
source_field | string |
De naam van het bronveld. |
|
doelveld
|
target_field | string |
De naam van het doelveld. |
ImportApi.ImportJobFileUploadInfo
Gegevens over het uploaden van bestanden
| Naam | Pad | Type | Description |
|---|---|---|---|
|
URI voor het uploaden van bestanden
|
file_upload_uri | string |
De URI voor het uploaden van het te importeren bestand. |
ImportApi.ImportJob
Importtaak
| Naam | Pad | Type | Description |
|---|---|---|---|
|
Id
|
id | string |
De id van de importtaak. |
|
Bestandsnaam
|
file_name | string |
De naam van het bestand dat wordt geïmporteerd. |
|
Begindatum
|
start_date | date-time |
De datum waarop de importtaak is gestart. |
|
Datum voltooid
|
end_date | date-time |
De datum waarop de importtaak is voltooid. |
|
Uitvoeringsduur
|
run_duration | integer |
De duur van de importtaak in seconden. |
|
Volgorde
|
sequence | integer |
Het volgnummer van de importtaak. |
|
Verwerkte rijen
|
rows_processed | integer |
Het aantal rijen dat door de importtaak wordt verwerkt. |
|
Doorgevoerde rijen
|
rows_committed | integer |
Het aantal rijen dat door de importtaak is vastgelegd. |
|
Rijen geweigerd
|
rows_rejected | integer |
Het aantal rijen dat door de importtaak is geweigerd. |
|
Aantal uitzonderingen
|
exception_count | integer |
Het aantal uitzonderingen dat door de importtaak is aangetroffen. |
|
Foutbericht
|
failure_message | string |
Het foutbericht voor de importtaak. |
|
Status
|
status | string |
De status van de importtaak. |
|
Toegevoegd door id
|
added_by | string |
De gebruiker die de importtaak heeft gemaakt. |
|
Gemaakt op
|
date_added | date-time |
De datum waarop de importtaak is gemaakt. |
|
Datum gewijzigd
|
date_modified | date-time |
De datum waarop de importtaak voor het laatst is gewijzigd. |
ImportApi.ImportJobExceptionFileDownloadInfo
Informatie over het downloaden van bestanden
| Naam | Pad | Type | Description |
|---|---|---|---|
|
URI voor downloaden van bestand
|
file_download_uri | string |
De URI voor het downloaden van het uitzonderingsbestand. |
ImportApi.ImportJobSummary
Importtaak
| Naam | Pad | Type | Description |
|---|---|---|---|
|
Id
|
id | string |
De id van de importtaak. |
|
Bestandsnaam
|
file_name | string |
De naam van het bestand dat wordt geïmporteerd. |
|
Begindatum
|
start_date | date-time |
De datum waarop de importtaak is gestart. |
|
Datum voltooid
|
end_date | date-time |
De datum waarop de importtaak is voltooid. |
|
Uitvoeringsduur
|
run_duration | integer |
De duur van de importtaak in seconden. |
|
Volgorde
|
sequence | integer |
Het volgnummer van de importtaak. |
|
Verwerkte rijen
|
rows_processed | integer |
Het aantal rijen dat door de importtaak wordt verwerkt. |
|
Doorgevoerde rijen
|
rows_committed | integer |
Het aantal rijen dat door de importtaak is vastgelegd. |
|
Rijen geweigerd
|
rows_rejected | integer |
Het aantal rijen dat door de importtaak is geweigerd. |
|
Aantal uitzonderingen
|
exception_count | integer |
Het aantal uitzonderingen dat door de importtaak is aangetroffen. |
|
Foutbericht
|
failure_message | string |
Het foutbericht voor de importtaak. |
|
Status
|
status | string |
De status van de importtaak. |
|
Toegevoegd door id
|
added_by | string |
De gebruiker die de importtaak heeft gemaakt. |
|
Gemaakt op
|
date_added | date-time |
De datum waarop de importtaak is gemaakt. |
|
Datum gewijzigd
|
date_modified | date-time |
De datum waarop de importtaak voor het laatst is gewijzigd. |
ImportApi.ImportJobSummaryCollection
Taken importeren
| Naam | Pad | Type | Description |
|---|---|---|---|
|
Aantal
|
count | integer |
Het totale aantal taken dat overeenkomt met het filter. |
|
Limit
|
limit | integer |
Het aangevraagde aantal records dat moet worden geretourneerd. |
|
Vervolgtoken
|
continuation_token | string |
Het vervolgtoken om de volgende pagina met resultaten op te halen. |
|
jobs
|
jobs | array of ImportApi.ImportJobSummary |
De set items die zijn opgenomen in het antwoord. |
ImportApi.MappingValidationMessage
Validatiebericht voor toewijzing
| Naam | Pad | Type | Description |
|---|---|---|---|
|
recordtoewijzing
|
record_mapping | string |
De recordtoewijzing die is gekoppeld aan het validatiefoutbericht. |
|
doelveld
|
target_field | string |
Het doelveld dat is gekoppeld aan het validatiefoutbericht. |
|
berichttype
|
message_type | string |
Het type validatiebericht. |
|
message
|
message | string |
Het validatiebericht. |
|
bestandsvelden
|
file_fields | array of string |
De bestandsvelden die zijn gekoppeld aan het validatiefoutbericht. |
ImportApi.StartImportJobResponse
Rapporttaak gestart
| Naam | Pad | Type | Description |
|---|---|---|---|
|
Status
|
status | string |
De status van de importtaak. |