Importowanie programu Blackbaud RENXT (wersja zapoznawcza)
Blackbaud Raiser's Edge NXT to kompleksowe oparte na chmurze rozwiązanie do zbierania funduszy i zarządzania darczyńcami opracowane specjalnie dla organizacji non-profit i całej dobrej społeczności społecznej. Użyj łącznika Importuj, aby zarządzać zadaniami importowania i wykonywać je.
Ten łącznik jest dostępny w następujących produktach i regionach:
| Usługa | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Logic Apps | Standard | Wszystkie regiony usługi Logic Apps z wyjątkiem następujących: — Regiony platformy Azure Government — Regiony platformy Azure (Chiny) - Departament Obrony USA (DoD) |
| Power Apps | Premium | Wszystkie regiony usługi Power Apps z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Power Automate - narzędzie do automatyzacji procesów | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Kontakt biznesowy | |
|---|---|
| Name | Obsługa rozwiązania Blackbaud |
| adres URL | https://www.blackbaud.com/support |
| skyapi@blackbaud.com |
| Metadane łącznika | |
|---|---|
| Publisher | Blackbaud, Inc. |
| Witryna internetowa | https://www.blackbaud.com/products/blackbaud-raisers-edge-nxt |
| Zasady ochrony prywatności | https://www.blackbaud.com/privacy-shield |
| Kategorie | Sprzedaż i CRM; Produktywność |
Raiser's Edge NXT to kompleksowe oparte na chmurze rozwiązanie do zbierania funduszy i zarządzania darczyńcami opracowane specjalnie dla organizacji non-profit i całej społeczności dobra społecznego.
Ten łącznik jest oparty na interfejsie API SKY firmy Blackbaud i zapewnia operacje ułatwiające zarządzanie zadaniami importu w narzędziu NXT usługi Raiser's Edge.
Aby uzyskać więcej informacji, zapoznaj się z dokumentacją.
Prerequisites
Aby korzystać z tego łącznika, musisz mieć konto identyfikatora Blackbaud z dostępem do co najmniej jednego środowiska Blackbaud.
Ponadto administrator organizacji musi również wykonać akcję na poziomie administratora w systemie, aby umożliwić temu łącznikowi dostęp do środowiska Blackbaud. Więcej informacji na temat tych wymagań wstępnych można znaleźć w dokumentacji początkowej konfiguracji .
Jak uzyskać poświadczenia?
Administrator organizacji wyśle Ci zaproszenie do środowiska NXT aplikacji Raiser's Edge i skonfiguruje uprawnienia konta użytkownika w środowisku. Do korzystania z tego łącznika nie są wymagane żadne dodatkowe poświadczenia.
Znane problemy i ograniczenia
Łącznik będzie działać w kontekście konta użytkownika i w związku z tym będzie podlegać uprawnieniam użytkownika w środowisku.
Akcje
| Aktualizowanie zadania importu |
Aktualizuje szczegółowe informacje o zadaniu importu. |
| Pobieranie identyfikatora URI pobierania pliku wyjątku zadania importu |
Zwraca identyfikator URI pobierania dla pliku wyjątku dla zadania importu. |
| Pobieranie identyfikatora URI przekazywania pliku zadania importu |
Zwraca nowy identyfikator URI przekazywania pliku dla oczekującego zadania importu. |
| Pobieranie zadania importu |
Zwraca szczegóły określonego zadania importu. |
| Uruchamianie zadania importu |
Uruchamia zadanie w tle w celu wykonania określonego importu. |
| Usuwanie zadania importu |
Usuwa zadanie importu. |
| Utwórz zadanie importu |
Tworzy zadanie importu, które zostanie uruchomione później po przekazaniu pliku. |
| Wyświetlanie listy zadań importu |
Wyświetla listę zadań importu. |
Aktualizowanie zadania importu
Aktualizuje szczegółowe informacje o zadaniu importu.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator zadania importu
|
job_id | True | string |
Identyfikator rekordu systemu zadania importu do zaktualizowania. |
|
Nazwa pliku
|
file_name | string |
Nazwa pliku do zaimportowania. |
Pobieranie identyfikatora URI pobierania pliku wyjątku zadania importu
Zwraca identyfikator URI pobierania dla pliku wyjątku dla zadania importu.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator zadania
|
job_id | True | string |
Identyfikator rekordu systemu zadania importu. |
Zwraca
Informacje o pobieraniu plików
Pobieranie identyfikatora URI przekazywania pliku zadania importu
Zwraca nowy identyfikator URI przekazywania pliku dla oczekującego zadania importu.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator zadania
|
job_id | True | string |
Identyfikator rekordu systemu zadania importu. |
Zwraca
Informacje o przekazaniu pliku
Pobieranie zadania importu
Zwraca szczegóły określonego zadania importu.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator zadania
|
job_id | True | string |
Identyfikator rekordu systemu zadania importu. |
Zwraca
Zadanie importu
- Body
- ImportApi.ImportJob
Uruchamianie zadania importu
Uruchamia zadanie w tle w celu wykonania określonego importu.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator zadania
|
job_id | True | string |
Identyfikator zadania importu do uruchomienia. |
Zwraca
Rozpoczęte zadanie raportu
Usuwanie zadania importu
Usuwa zadanie importu.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator zadania importu
|
job_id | True | string |
Identyfikator rekordu systemowego zadania importu do usunięcia. |
Utwórz zadanie importu
Tworzy zadanie importu, które zostanie uruchomione później po przekazaniu pliku.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Nazwa pliku
|
file_name | True | string |
Nazwa pliku do zaimportowania. |
|
Wiersz nagłówka
|
header_row | string |
Wiersz nagłówka do użycia podczas importowania pliku CSV. |
Zwraca
Utworzono zgodę składników
Wyświetlanie listy zadań importu
Wyświetla listę zadań importu.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Status
|
status | string |
Filtruj zadania według stanu. |
|
|
Limit
|
limit | integer |
Reprezentuje liczbę rekordów do zwrócenia. Wartość domyślna to 100. Wartość maksymalna to 10000. |
|
|
Token kontynuacji
|
continuation_token | string |
Token kontynuacji umożliwiający uzyskanie następnej strony wyników. |
Zwraca
Importowanie zadań
Definicje
ImportApi.CreateImportJobResponse
Utworzono zgodę składników
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
identyfikator
|
id | string |
Identyfikator nowo utworzonego zadania importu. |
|
Identyfikator URI przekazywania pliku
|
file_upload_uri | string |
Identyfikator URI przekazywania pliku do zaimportowania. |
|
Mapowania pól
|
field_mappings | array of ImportApi.FieldMapping |
W przypadku importu woluminów CSV mapowania pól z wiersza nagłówka na pola docelowe. |
|
Komunikaty sprawdzania poprawności mapowania
|
mapping_validation_messages | array of ImportApi.MappingValidationMessage |
Komunikaty sprawdzania poprawności mapowania z wiersza nagłówka utworzonego zadania. Dotyczy tylko importu woluminów CSV. |
ImportApi.FieldMapping
Mapowanie pól
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
pole źródłowe
|
source_field | string |
Nazwa pola źródłowego. |
|
pole docelowe
|
target_field | string |
Nazwa pola docelowego. |
ImportApi.ImportJobFileUploadInfo
Informacje o przekazaniu pliku
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator URI przekazywania pliku
|
file_upload_uri | string |
Identyfikator URI przekazywania pliku do zaimportowania. |
ImportApi.ImportJob
Zadanie importu
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
identyfikator
|
id | string |
Identyfikator zadania importu. |
|
Nazwa pliku
|
file_name | string |
Nazwa importowanego pliku. |
|
Data rozpoczęcia
|
start_date | date-time |
Data rozpoczęcia zadania importu. |
|
Data ukończenia
|
end_date | date-time |
Data zakończenia zadania importu. |
|
Czas trwania uruchomienia
|
run_duration | integer |
Czas trwania zadania importu w sekundach. |
|
Sequence
|
sequence | integer |
Numer sekwencji zadania importu. |
|
Przetworzone wiersze
|
rows_processed | integer |
Liczba wierszy przetworzonych przez zadanie importu. |
|
Zatwierdzone wiersze
|
rows_committed | integer |
Liczba wierszy zatwierdzonych przez zadanie importu. |
|
Odrzucone wiersze
|
rows_rejected | integer |
Liczba wierszy odrzuconych przez zadanie importu. |
|
Liczba wyjątków
|
exception_count | integer |
Liczba wyjątków napotkanych przez zadanie importu. |
|
Komunikat o błędzie
|
failure_message | string |
Komunikat o błędzie zadania importu. |
|
Status
|
status | string |
Stan zadania importu. |
|
Dodano według identyfikatora
|
added_by | string |
Użytkownik, który utworzył zadanie importu. |
|
Data utworzenia
|
date_added | date-time |
Data utworzenia zadania importu. |
|
Data modyfikacji
|
date_modified | date-time |
Data ostatniej modyfikacji zadania importu. |
ImportApi.ImportJobExceptionFileDownloadInfo
Informacje o pobieraniu plików
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator URI pobierania pliku
|
file_download_uri | string |
Identyfikator URI pobierania pliku wyjątku. |
ImportApi.ImportJobSummary
Zadanie importu
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
identyfikator
|
id | string |
Identyfikator zadania importu. |
|
Nazwa pliku
|
file_name | string |
Nazwa importowanego pliku. |
|
Data rozpoczęcia
|
start_date | date-time |
Data rozpoczęcia zadania importu. |
|
Data ukończenia
|
end_date | date-time |
Data zakończenia zadania importu. |
|
Czas trwania uruchomienia
|
run_duration | integer |
Czas trwania zadania importu w sekundach. |
|
Sequence
|
sequence | integer |
Numer sekwencji zadania importu. |
|
Przetworzone wiersze
|
rows_processed | integer |
Liczba wierszy przetworzonych przez zadanie importu. |
|
Zatwierdzone wiersze
|
rows_committed | integer |
Liczba wierszy zatwierdzonych przez zadanie importu. |
|
Odrzucone wiersze
|
rows_rejected | integer |
Liczba wierszy odrzuconych przez zadanie importu. |
|
Liczba wyjątków
|
exception_count | integer |
Liczba wyjątków napotkanych przez zadanie importu. |
|
Komunikat o błędzie
|
failure_message | string |
Komunikat o błędzie zadania importu. |
|
Status
|
status | string |
Stan zadania importu. |
|
Dodano według identyfikatora
|
added_by | string |
Użytkownik, który utworzył zadanie importu. |
|
Data utworzenia
|
date_added | date-time |
Data utworzenia zadania importu. |
|
Data modyfikacji
|
date_modified | date-time |
Data ostatniej modyfikacji zadania importu. |
ImportApi.ImportJobSummaryCollection
Importowanie zadań
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Liczba
|
count | integer |
Całkowita liczba zadań pasujących do filtru. |
|
Limit
|
limit | integer |
Żądana liczba rekordów do zwrócenia. |
|
Token kontynuacji
|
continuation_token | string |
Token kontynuacji umożliwiający uzyskanie następnej strony wyników. |
|
jobs
|
jobs | array of ImportApi.ImportJobSummary |
Zestaw elementów uwzględnionych w odpowiedzi. |
ImportApi.MappingValidationMessage
Komunikat weryfikacji mapowania
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
mapowanie rekordów
|
record_mapping | string |
Mapowanie rekordów skojarzone z komunikatem o błędzie weryfikacji. |
|
pole docelowe
|
target_field | string |
Pole docelowe skojarzone z komunikatem o błędzie weryfikacji. |
|
typ komunikatu
|
message_type | string |
Typ komunikatu weryfikacji. |
|
komunikat
|
message | string |
Komunikat weryfikacji. |
|
pola pliku
|
file_fields | array of string |
Pola pliku skojarzone z komunikatem o błędzie walidacji. |
ImportApi.StartImportJobResponse
Rozpoczęte zadanie raportu
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Status
|
status | string |
Stan zadania importu. |