Interakce Blackbaud Raisers Edge NXT
Blackbaud Raiser's Edge NXT je komplexní cloudové softwarové řešení pro správu fondů a dárců vytvořené speciálně pro neziskové organizace a celou komunitu, která je vhodná pro sociální sítě. Ke správě základních akcí použijte konektor Interakce.
Tento konektor je dostupný v následujících produktech a oblastech:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Všechny oblasti Power Automate s výjimkou následujících: – státní správa USA (GCC) – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD) |
| Logic Apps | Standard | Všechny oblasti Logic Apps s výjimkou následujících: – Oblasti Azure Government – Oblasti Azure China - Ministerstvo obrany USA (DoD) |
| Power Apps | Premium | Všechny oblasti Power Apps s výjimkou následujících: – státní správa USA (GCC) – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD) |
| Power Automate | Premium | Všechny oblasti Power Automate s výjimkou následujících: – státní správa USA (GCC) – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD) |
| Kontakt | |
|---|---|
| Název | Podpora blackbaudu |
| URL | https://www.blackbaud.com/support |
| skyapi@blackbaud.com |
| Metadata konektoru | |
|---|---|
| Vydavatel | Blackbaud, Inc. |
| Internetová stránka | https://www.blackbaud.com/products/blackbaud-raisers-edge-nxt |
| Zásady ochrany osobních údajů | https://www.blackbaud.com/privacy-shield |
| Kategorie | Prodej a CRM; Produktivita |
Raiser's Edge NXT je komplexní cloudové softwarové řešení pro správu fondů a dárců vytvořené speciálně pro neziskové organizace a celou komunitu, která je vhodná pro sociální sítě.
Tento konektor je založený na rozhraní SKY API společnosti Blackbaud a poskytuje operace, které pomáhají spravovat základní interations a související entity v rámci Edge NXT aplikace Raiser, včetně následujících:
- Akce
- Vlastní pole akce
- Přílohy akcí
- a další...
Další informace najdete v dokumentaci.
Požadavky
Pokud chcete tento konektor použít, musíte mít účet ID Blackbaud s přístupem k jednomu nebo více prostředím Blackbaud.
Kromě toho musí správce vaší organizace v systému také provést akci na úrovni správce, aby tento konektor umožnil přístup k prostředí Blackbaud. Další informace o těchto požadavcích najdete v počáteční dokumentaci k instalaci .
Jak získat přihlašovací údaje?
Správce vaší organizace vám pošle pozvánku do prostředí Raiser Edge NXT vaší organizace a nakonfiguruje oprávnění k vašemu uživatelskému účtu v rámci prostředí. K použití tohoto konektoru nejsou potřeba žádné další přihlašovací údaje.
Známé problémy a omezení
Konektor bude fungovat v kontextu vašeho uživatelského účtu, a proto bude podléhat vašim uživatelským oprávněním v rámci prostředí.
Limity omezování
| Name | Volání | Období obnovení |
|---|---|---|
| Volání rozhraní API na připojení | 100 | 60 sekund |
Akce
| Aktualizace přílohy akce |
Aktualizuje přílohu akce. |
| Aktualizace vlastního pole akce |
Aktualizuje vlastní pole akce. |
| Aktualizace základní akce |
Aktualizuje základní akci. |
| Seznam akcí |
Vrátí seznam akcí. |
| Vlastní pole akcí seznamu |
Zobrazí seznam vlastních polí pro akci. |
| Vytvoření přílohy akce |
Vytvoří novou přílohu akce. |
| Vytvoření vlastního pole akce |
Vytvoří nové vlastní pole akce. |
| Vytvoření základní akce |
Vytvoří novou základní akci. |
| Výpis příloh akcí |
Zobrazí seznam příloh pro akci. |
| Výpis základních akcí |
Zobrazí seznam akcí pro složku. |
| Získání základní akce |
Vrátí informace o základní akci. |
Aktualizace přílohy akce
Aktualizuje přílohu akce.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID přílohy
|
attachment_id | True | string |
ID systémového záznamu přílohy, která se má aktualizovat. |
|
Název
|
name | string |
Název přílohy. Limit znaků: 150. |
|
|
Date
|
date | date-time |
Datum přílohy (např. '2020-09-18T04:13:56Z'). |
|
|
URL
|
url | string |
Adresa URL přílohy. To je vyžadováno pro přílohy propojení a není použitelné pro fyzické přílohy. |
|
|
Štítky
|
tags | array of string |
Značky přidružené k příloze. |
Aktualizace vlastního pole akce
Aktualizuje vlastní pole akce.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID vlastního pole
|
custom_field_id | True | string |
ID systémového záznamu vlastního pole, které se má aktualizovat. |
|
body
|
body | True | dynamic |
Objekt, který představuje vlastnosti vlastního pole pro aktualizaci. |
Aktualizace základní akce
Aktualizuje základní akci.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID akce
|
action_id | True | string |
ID systémového záznamu akce, která se má aktualizovat. |
|
Date
|
date | date-time |
Datum akce (např. 2020-09-18T04:13:56Z). |
|
|
Kategorie
|
category | string |
Kanál nebo záměr základní interakce. |
|
|
Typ
|
type | string |
Další popis akce, která doplňuje kategorii. |
|
|
Shrnutí
|
summary | string |
Krátký popis akce, která se zobrazí v horní části záznamu. Limit znaků: 255. |
|
|
Poznámka:
|
description | string |
Podrobné vysvětlení, které popisuje souhrn akce. |
|
|
Hotový?
|
completed | boolean |
Je akce dokončená? Pokud je systém nakonfigurovaný tak, aby používal stavy vlastních akcí, je tato hodnota založená na hodnotě stavu akce. |
|
|
Dokončeno
|
completed_date | date-time |
Datum dokončení akce (např. 2020-09-18T04:13:56Z). |
|
|
Stav
|
status | string |
Stav akce. |
|
|
Směr
|
direction | string |
Směr akce. |
|
|
Umístění
|
location | string |
Umístění akce. |
|
|
ID příležitosti
|
opportunity_id | string |
ID systémového záznamu příležitosti přidružené k akci. |
|
|
Outcome
|
outcome | string |
Výsledek akce. |
|
|
Priority
|
priority | string |
Priorita akce. |
|
|
Čas zahájení
|
start_time | string |
Počáteční čas akce. Používá 24hodinový čas ve formátu HH:mm. |
|
|
Konečný čas
|
end_time | string |
Čas ukončení akce. Používá 24hodinový čas ve formátu HH:mm. |
|
|
Fundraisery
|
fundraisers | array of string |
Sada SYSTÉMOVÝCH ID záznamů pro fundraisery přidružené k akci. |
Seznam akcí
Vrátí seznam akcí.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
List
|
list_id | string |
Definuje identifikátor seznamu použitý k filtrování sady akcí na ty, které jsou zahrnuté v zadaném seznamu. Pokud je tato hodnota nastavená, budou ostatní zadané filtry ignorovány. |
|
|
Vypočítaný stav
|
computed_status | string |
Představuje filtr výsledků na základě vypočítaného stavu akce. Dostupné hodnoty jsou Open, Completed (Dokončeno) nebo PastDue (PastDue). |
|
|
Stav
|
status_code | string |
Představuje stavový kód akce pro filtrování výsledků (platí pouze v případě, že je systém nakonfigurovaný tak, aby používal stavové kódy akcí). Například čeká na vyřízení vrátí akce se stavem Čeká na vyřízení. |
|
|
Omezení
|
limit | integer |
Představuje počet záznamů, které se mají vrátit. Výchozí hodnota je 500. Maximální hodnota je 5000. |
|
|
Posun
|
offset | integer |
Představuje počet záznamů, které se mají přeskočit. Pro použití se stránkováním. |
|
|
Přidáno dne nebo po
|
date_added | date-time |
Vyfiltrujte výsledky tak, aby se akce vytvořené po zadaném datu (např. 2020-09-18T04:13:56Z). |
|
|
Změněno dne nebo po
|
last_modified | date-time |
Vyfiltrujte výsledky tak, aby se akce změněné po zadaném datu (např. '2020-09-18T04:13:56Z'). |
Návraty
Akce
Vlastní pole akcí seznamu
Zobrazí seznam vlastních polí pro akci.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID akce
|
action_id | True | string |
ID záznamu systému akce. |
Návraty
Vlastní pole
Vytvoření přílohy akce
Vytvoří novou přílohu akce.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID akce
|
parent_id | True | string |
ID systémového záznamu akce přidružené k příloze. |
|
Typ
|
type | True | string |
Typ přílohy. Fyzické přílohy jsou nahrané soubory, jako jsou obrázky, soubory PDF nebo wordové dokumenty uložené místně nebo v síti. Ukládají se a spravují v systému. Přílohy odkazů jsou odkazy na soubory, jako jsou obrázky, blogové příspěvky nebo videa z YouTube, která jsou online nebo v účtu cloudového úložiště. Ukládají se a spravují externě. |
|
Název
|
name | string |
Název přílohy. Limit znaků: 150. |
|
|
Date
|
date | date-time |
Datum přílohy (např. '2020-09-18T04:13:56Z'). Toto pole je ve výchozím nastavení aktuální datum a čas, pokud není zadáno. |
|
|
URL
|
url | string |
Adresa URL přílohy. To je vyžadováno pro přílohy propojení a není použitelné pro fyzické přílohy. |
|
|
Název souboru
|
file_name | string |
Název souboru. Limit znaků: 36. Pouze pro fyzické přílohy. |
|
|
ID souboru
|
file_id | string |
Identifikátor souboru. Limit znaků: 36. Pouze pro fyzické přílohy. |
|
|
ID miniatury
|
thumbnail_id | string |
Identifikátor miniatury. Limit znaků: 36. Pouze pro fyzické přílohy. |
|
|
Štítky
|
tags | array of string |
Značky přidružené k příloze. |
Návraty
Příloha vytvořené akce
Vytvoření vlastního pole akce
Vytvoří nové vlastní pole akce.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
body
|
body | True | dynamic |
Objekt, který představuje vlastní pole k vytvoření. |
Návraty
Vytvoření vlastního pole akce
Vytvoření základní akce
Vytvoří novou základní akci.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID součásti
|
constituent_id | True | string |
ID systémového záznamu součásti přidružené k akci. |
|
Date
|
date | True | date-time |
Datum akce (např. 2020-09-18T04:13:56Z). |
|
Kategorie
|
category | True | string |
Kanál nebo záměr základní interakce. |
|
Typ
|
type | string |
Další popis akce, která doplňuje kategorii. |
|
|
Shrnutí
|
summary | string |
Krátký popis akce, která se zobrazí v horní části záznamu. Limit znaků: 255. |
|
|
Poznámka:
|
description | string |
Podrobné vysvětlení, které popisuje souhrn akce. |
|
|
Hotový?
|
completed | boolean |
Je akce dokončená? Pokud je systém nakonfigurovaný tak, aby používal stavy vlastních akcí, je tato hodnota založená na hodnotě stavu akce. |
|
|
Dokončeno
|
completed_date | date-time |
Datum dokončení akce (např. 2020-09-18T04:13:56Z). |
|
|
Stav
|
status | string |
Stav akce. |
|
|
Směr
|
direction | string |
Směr akce. |
|
|
Umístění
|
location | string |
Umístění akce. |
|
|
ID příležitosti
|
opportunity_id | string |
ID systémového záznamu příležitosti přidružené k akci. |
|
|
Outcome
|
outcome | string |
Výsledek akce. |
|
|
Priority
|
priority | string |
Priorita akce. |
|
|
Čas zahájení
|
start_time | string |
Počáteční čas akce. Používá 24hodinový čas ve formátu HH:mm. |
|
|
Konečný čas
|
end_time | string |
Čas ukončení akce. Používá 24hodinový čas ve formátu HH:mm. |
|
|
Author
|
author | string |
Autor souhrnu a popisu akce. Pokud není zadaný, bude mít výchozí sadu založenou na účtu uživatele. Limit znaků: 50. |
|
|
Fundraisery
|
fundraisers | array of string |
Sada SYSTÉMOVÝCH ID záznamů pro fundraisery přidružené k akci. |
Návraty
Vytvořená akce
Výpis příloh akcí
Zobrazí seznam příloh pro akci.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID akce
|
action_id | True | string |
ID záznamu systému akce. |
Návraty
Attachments
Výpis základních akcí
Zobrazí seznam akcí pro složku.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID součásti
|
constituent_id | True | string |
ID systémového záznamu součásti. |
Návraty
Akce
Získání základní akce
Vrátí informace o základní akci.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
ID akce
|
action_id | True | string |
ID systémového záznamu akce, která se má získat. |
Návraty
Činnost
Definice
ConstituentApi.ActionAttachmentRead
Příloha
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
ID
|
id | string |
ID záznamu systému přílohy. |
|
ID akce
|
parent_id | string |
ID systémového záznamu akce přidružené k příloze. |
|
Typ
|
type | string |
Typ přílohy. Fyzické přílohy jsou nahrané soubory, jako jsou obrázky, soubory PDF nebo wordové dokumenty uložené místně nebo v síti. Ukládají se a spravují v systému. Přílohy odkazů jsou odkazy na soubory, jako jsou obrázky, blogové příspěvky nebo videa z YouTube, která jsou online nebo v účtu cloudového úložiště. Ukládají se a spravují externě. |
|
Název
|
name | string |
Název přílohy. Limit znaků: 150. |
|
Date
|
date | date-time |
Datum přílohy. |
|
URL
|
url | string |
Adresa URL přílohy. To je vyžadováno pro přílohy propojení a není použitelné pro fyzické přílohy. |
|
Název souboru
|
file_name | string |
Název souboru. Limit znaků: 36. Pouze pro fyzické přílohy. |
|
ID souboru
|
file_id | string |
Identifikátor souboru. Limit znaků: 36. Pouze pro fyzické přílohy. |
|
ID miniatury
|
thumbnail_id | string |
Identifikátor miniatury. Limit znaků: 36. Pouze pro fyzické přílohy. |
|
Adresa URL miniatury
|
thumbnail_url | string |
Adresa URL miniatury. Pouze pro fyzické přílohy, které jsou obrázky. Obsahuje časový podpis, který omezuje přístup na 60 minut. |
|
Typ obsahu
|
content_type | string |
Typ obsahu. Pouze pro fyzické přílohy. |
|
Velikost souboru
|
file_size | integer |
Velikost souboru v bajtech. Pouze pro fyzické přílohy. |
|
Štítky
|
tags | array of string |
Značky přidružené k příloze. |
ConstituentApi.ActionCustomFieldRead
Vlastní pole
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
ID
|
id | string |
ID systémového záznamu vlastního pole. |
|
ID akce
|
parent_id | string |
ID systémového záznamu akce přidružené k vlastnímu poli. |
|
Kategorie
|
category | string |
Kategorie vlastního pole. |
|
Typ
|
type | string |
Typ dat, která vlastní pole představuje. |
|
Hodnota
|
value |
Hodnota vlastního pole. |
|
|
Textová hodnota
|
text_value | string |
Textová hodnota vlastního pole. |
|
Číselná hodnota
|
number_value | integer |
Číselná hodnota vlastního pole |
|
Hodnota data
|
date_value | date |
Hodnota data vlastního pole. |
|
Hodnota měny
|
currency_value | double |
Hodnota měny vlastního pole. |
|
Logická hodnota
|
boolean_value | boolean |
Logická hodnota vlastního pole. |
|
Hodnota položky tabulky
|
codetableentry_value | string |
Hodnota položky tabulky vlastního pole. |
|
Hodnota ID součásti
|
constituentid_value | string |
Hodnota ID součásti vlastního pole. |
|
den
|
fuzzydate_value.d | integer |
Den v přibližné datum. |
|
měs
|
fuzzydate_value.m | integer |
Měsíc v přibližném datu. |
|
rok
|
fuzzydate_value.y | integer |
Rok v přibližném datu. |
|
Date
|
date | date |
Datum vlastního pole. |
|
Comment
|
comment | string |
Komentář k vlastnímu poli. Limit znaků: 50. |
|
Datum přidání
|
date_added | date-time |
Datum vytvoření vlastního pole. |
|
Datum změny
|
date_modified | date-time |
Datum poslední změny vlastního pole. |
ConstituentApi.ActionRead
Činnost
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
ID
|
id | string |
ID záznamu systému akce. |
|
ID součásti
|
constituent_id | string |
ID systémového záznamu součásti přidružené k akci. |
|
Kategorie
|
category | string |
Kanál nebo záměr základní interakce. |
|
Hotový?
|
completed | boolean |
Je akce dokončená? Pokud je systém nakonfigurovaný tak, aby používal stavy vlastních akcí, je tato hodnota založená na hodnotě stavu akce. |
|
Dokončeno
|
completed_date | date-time |
Datum dokončení akce. |
|
Date
|
date | date-time |
Datum akce. |
|
Poznámka:
|
description | string |
Podrobné vysvětlení, které popisuje souhrn akce. |
|
Směr
|
direction | string |
Směr akce. |
|
Fundraisery
|
fundraisers | array of string |
Sada SYSTÉMOVÝCH ID záznamů pro fundraisery přidružené k akci. |
|
Umístění
|
location | string |
Umístění akce. |
|
ID příležitosti
|
opportunity_id | string |
ID systémového záznamu příležitosti přidružené k akci. |
|
Outcome
|
outcome | string |
Výsledek akce. |
|
Priority
|
priority | string |
Priorita akce. |
|
Čas zahájení
|
start_time | string |
Počáteční čas akce. Používá 24hodinový čas ve formátu HH:mm. |
|
Konečný čas
|
end_time | string |
Čas ukončení akce. Používá 24hodinový čas ve formátu HH:mm. |
|
Stav
|
status | string |
Stav akce. |
|
Stavový kód
|
status_code | string |
Stavový kód akce. Tato vlastnost se vrátí pouze v případě, že je systém nakonfigurovaný tak, aby používal stav vlastních akcí. |
|
Vypočítaný stav
|
computed_status | string |
Vypočítaný stav akce. Pokud systém není nakonfigurovaný tak, aby používal stavy vlastních akcí, vypočítá toto pole stav na základě vlastností dokončení a data. Pokud ne, pole vypočítá stav na základě vlastnosti data akce a zda je vlastnost Stav akce nakonfigurována jako dokončená. |
|
Shrnutí
|
summary | string |
Krátký popis akce, která se zobrazí v horní části záznamu. Limit znaků: 255. |
|
Typ
|
type | string |
Další popis akce, která doplňuje kategorii. |
|
Datum přidání
|
date_added | date-time |
Datum vytvoření akce. |
|
Datum změny
|
date_modified | date-time |
Datum poslední změny akce. |
ConstituentApi.ApiCollectionOfActionAttachmentRead
Attachments
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
Počet
|
count | integer |
Počet položek, které jsou k dispozici pro načtení do kolekce po použití parametrů požadavku. Parametry limitu a posunu nemají vliv na počet, ale pro usnadnění stránkování mohou ovlivnit počet položek v sadě výsledků hodnoty. |
|
value
|
value | array of ConstituentApi.ActionAttachmentRead |
Sada položek zahrnutých v odpovědi. Může se jednat o podmnožinu položek v kolekci. |
ConstituentApi.ApiCollectionOfActionCustomFieldRead
Vlastní pole
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
Počet
|
count | integer |
Počet položek, které jsou k dispozici pro načtení do kolekce po použití parametrů požadavku. Parametry limitu a posunu nemají vliv na počet, ale pro usnadnění stránkování mohou ovlivnit počet položek v sadě výsledků hodnoty. |
|
value
|
value | array of ConstituentApi.ActionCustomFieldRead |
Sada položek zahrnutých v odpovědi. Může se jednat o podmnožinu položek v kolekci. |
ConstituentApi.ApiCollectionOfActionRead
Akce
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
Počet
|
count | integer |
Počet položek, které jsou k dispozici pro načtení do kolekce po použití parametrů požadavku. Parametry limitu a posunu nemají vliv na počet, ale pro usnadnění stránkování mohou ovlivnit počet položek v sadě výsledků hodnoty. |
|
value
|
value | array of ConstituentApi.ActionRead |
Sada položek zahrnutých v odpovědi. Může se jednat o podmnožinu položek v kolekci. |
ConstituentApi.CreatedAction
Vytvořená akce
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
ID
|
id | string |
ID nově vytvořené akce. |
ConstituentApi.CreatedActionAttachment
Příloha vytvořené akce
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
ID
|
id | string |
ID nově vytvořené přílohy akce. |
ConstituentApi.CreatedActionCustomField
Vytvoření vlastního pole akce
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
ID
|
id | string |
ID nově vytvořeného vlastního pole akce. |