Partager via

Blackbaud Raisers Edge NXT Interactions

Blackbaud Raiser’s Edge NXT est une solution logicielle complète de collecte de fonds et de gestion des donateurs basée sur le cloud conçue spécifiquement pour les organisations à but non lucratif et l’ensemble de la bonne communauté sociale. Utilisez le connecteur Interactions pour gérer les actions constituantes.

Ce connecteur est disponible dans les produits et régions suivants :

Service classe Régions
Copilot Studio Premium Toutes les régions Power Automate , à l’exception des éléments suivants :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Applications logiques Norme Toutes les régions Logic Apps , à l’exception des suivantes :
     - Régions Azure Government
     - Régions Azure Chine
     - Us Department of Defense (DoD)
Power Apps Premium Toutes les régions Power Apps , à l’exception des suivantes :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Power Automate Premium Toutes les régions Power Automate , à l’exception des éléments suivants :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Contact
Nom Prise en charge de Blackbaud
URL https://www.blackbaud.com/support
Messagerie électronique skyapi@blackbaud.com
Métadonnées du connecteur
Éditeur Blackbaud, Inc.
Site internet https://www.blackbaud.com/products/blackbaud-raisers-edge-nxt
Politique de confidentialité https://www.blackbaud.com/privacy-shield
Catégories Ventes et CRM ; Productivité

Raiser’s Edge NXT est une solution complète de collecte de fonds et de gestion des donateurs basée sur le cloud conçue spécifiquement pour les organisations à but non lucratif et l’ensemble de la bonne communauté sociale.

Ce connecteur est basé sur l’API SKY de Blackbaud et fournit des opérations pour aider à gérer les interations constituantes et les entités associées au sein du NXT edge de The Raiser, notamment :

  • Actions
  • Champs personnalisés d’action
  • Pièces jointes d’action
  • et bien plus encore...

Pour plus d’informations, consultez la documentation.

Prerequisites

Pour utiliser ce connecteur, vous devez disposer d’un compte Blackbaud ID avec accès à un ou plusieurs environnements Blackbaud.

En outre, l’administrateur de votre organisation doit également effectuer une action au niveau de l’administrateur au sein du système pour permettre à ce connecteur d’accéder à votre environnement Blackbaud. Vous trouverez plus d’informations sur ces prérequis dans la documentation de configuration initiale .

Comment obtenir des informations d’identification ?

L’administrateur de votre organisation vous enverra une invitation à l’environnement Edge NXT de l’organisation de l’organisation et configurera les autorisations de votre compte d’utilisateur dans l’environnement. Aucune information d’identification supplémentaire n’est requise pour utiliser ce connecteur.

Problèmes connus et limitations

Le connecteur fonctionne dans le contexte de votre compte d’utilisateur et sera donc soumis à vos autorisations utilisateur dans l’environnement.

Limitations

Nom Appels Période de renouvellement
Appels d’API par connexion 100 60 secondes

Actions

Actions de liste

Retourne une liste d’actions.
Créer un champ personnalisé d’action

Crée un champ personnalisé d’action.
Créer une action constituante

Crée une action constituante.
Créer une pièce jointe d’action

Crée une pièce jointe d’action.
Lister les pièces jointes d’action

Répertorie les pièces jointes d’une action.
Mettre à jour un champ personnalisé d’action

Met à jour un champ personnalisé d’action.
Mettre à jour une action constituante

Met à jour une action constituante.
Mettre à jour une pièce jointe d’action

Met à jour une pièce jointe d’action.
Obtenir une action constituante

Retourne des informations sur une action constituante.
Répertorier les actions constituantes

Répertorie les actions d’un constituant.
Répertorier les champs personnalisés d’action

Répertorie les champs personnalisés d’une action.

Actions de liste

ID d’opération :
ListActions

Retourne une liste d’actions.

Paramètres

Nom Clé Obligatoire Type Description
Liste
 list_id string

Définit un identificateur de liste utilisé pour filtrer l’ensemble d’actions sur ceux inclus dans la liste spécifiée. Si cette valeur est définie, d’autres filtres spécifiés sont ignorés.
État calculé
 computed_status string

Représente un filtre pour les résultats en fonction de l’état de l’action calculée. Les valeurs disponibles sont Open, Completed ou PastDue.
Statut
 status_code string

Représente un code d’état d’action pour filtrer les résultats (applicable uniquement lorsque le système est configuré pour utiliser des codes d’état d’action). Par exemple, « En attente » retourne des actions avec l’état « En attente ».
Limit
 limit integer

Représente le nombre d’enregistrements à retourner. La valeur par défaut est 500. La valeur maximale est de 5 000.
Décalage
 offset integer

Représente le nombre d’enregistrements à ignorer. Pour une utilisation avec la pagination.
Ajouté ou après
 date_added date-time

Filtrez les résultats sur les actions créées ou après la date spécifiée (par exemple : « 2020-09-18T04:13:56Z »).
Modifié sur ou après
 last_modified date-time

Filtrez les résultats sur les actions modifiées ou après la date spécifiée (par exemple : « 2020-09-18T04:13:56Z »).

Retours

Actions

Corps
ConstituentApi.ApiCollectionOfActionRead

Créer un champ personnalisé d’action

ID d’opération :
CreateActionCustomField

Crée un champ personnalisé d’action.

Paramètres

Nom Clé Obligatoire Type Description
body
 body True dynamic

Objet qui représente le champ personnalisé à créer.

Retours

Champ personnalisé d’action créé

Corps
ConstituentApi.CreatedActionCustomField

Créer une action constituante

ID d’opération :
CreateAction

Crée une action constituante.

Paramètres

Nom Clé Obligatoire Type Description
ID constituant
 constituent_id True string

ID d’enregistrement système de la constituante associée à l’action.
Date
 date True date-time

Date de l’action (par exemple : '2020-09-18T04:13:56Z').
Catégorie
 category True string

Canal ou intention de l’interaction constituante.
Type
 type string

Description supplémentaire de l’action pour compléter la catégorie.
Résumé
 summary string

Brève description de l’action qui apparaît en haut de l’enregistrement. Limite de caractères : 255.
Note
 description string

Explication détaillée qui s’explique sur le résumé de l’action.
Terminé?
 completed boolean

L’action est-elle terminée ? Si le système est configuré pour utiliser des états d’action personnalisés, cette valeur est basée sur la valeur d’état de l’action.
Effectué le
 completed_date date-time

Date à laquelle l’action a été terminée (par exemple : '2020-09-18T04:13:56Z').
Statut
 status string

État de l’action.
Direction
 direction string

Direction de l’action.
Emplacement
 location string

Emplacement de l’action.
ID d’opportunité
 opportunity_id string

ID d’enregistrement système de l’opportunité associée à l’action.
Résultat
 outcome string

Résultat de l’action.
Priority
 priority string

Priorité de l’action.
Heure de début
 start_time string

Heure de début de l’action. Utilise une heure de 24 heures au format HH :mm.
Heure de fin
 end_time string

Heure de fin de l’action. Utilise une heure de 24 heures au format HH :mm.
Auteur
 author string

Auteur du résumé et de la description de l’action. S’il n’est pas fourni, un jeu par défaut est défini en fonction du compte de l’utilisateur. Limite de caractères : 50.
Collecte de fonds
 fundraisers array of string

Ensemble d’ID d’enregistrement système pour les collectes de fonds associées à l’action.

Retours

Action créée

Corps
ConstituentApi.CreatedAction

Créer une pièce jointe d’action

ID d’opération :
CreateActionAttachment

Crée une pièce jointe d’action.

Paramètres

Nom Clé Obligatoire Type Description
ID d’action
 parent_id True string

ID d’enregistrement système de l’action associée à la pièce jointe.
Type
 type True string

Type de pièce jointe. Les pièces jointes physiques sont des fichiers chargés tels que des images, des fichiers PDF ou des documents Word enregistrés localement ou sur le réseau. Ils sont stockés et gérés dans le système. Les pièces jointes de liens sont des liens vers des fichiers tels que des images, des billets de blog ou des vidéos YouTube en ligne ou dans un compte de stockage cloud. Ils sont stockés et gérés en externe.
Nom
 name string

Nom de fichier de la pièce jointe Limite de caractères : 150.
Date
 date date-time

Date de la pièce jointe (par exemple : '2020-09-18T04:13:56Z'). Ce champ est défini par défaut sur la date et l’heure actuelles s’il n’est pas fourni.
URL
 url string

URL de la pièce jointe. Cela est requis pour les pièces jointes de lien et non applicables aux pièces jointes physiques.
Nom de fichier
 file_name string

Le nom du fichier. Limite de caractères : 36. Pour les pièces jointes physiques uniquement.
ID de fichier
 file_id string

L’identificateur du fichier. Limite de caractères : 36. Pour les pièces jointes physiques uniquement.
ID de miniature
 thumbnail_id string

Identificateur de la miniature. Limite de caractères : 36. Pour les pièces jointes physiques uniquement.
Étiquettes
 tags array of string

Balises associées à la pièce jointe.

Retours

Pièce jointe d’action créée

Corps
ConstituentApi.CreatedActionAttachment

Lister les pièces jointes d’action

ID d’opération :
ListActionAttachments

Répertorie les pièces jointes d’une action.

Paramètres

Nom Clé Obligatoire Type Description
ID d’action
 action_id True string

ID d’enregistrement système de l’action.

Retours

Attachments

Corps
ConstituentApi.ApiCollectionOfActionAttachmentRead

Mettre à jour un champ personnalisé d’action

ID d’opération :
EditActionCustomField

Met à jour un champ personnalisé d’action.

Paramètres

Nom Clé Obligatoire Type Description
ID de champ personnalisé
 custom_field_id True string

ID d’enregistrement système du champ personnalisé à mettre à jour.
body
 body True dynamic

Objet qui représente les propriétés du champ personnalisé à mettre à jour.

Mettre à jour une action constituante

ID d’opération :
EditAction

Met à jour une action constituante.

Paramètres

Nom Clé Obligatoire Type Description
ID d’action
 action_id True string

ID d’enregistrement système de l’action à mettre à jour.
Date
 date date-time

Date de l’action (par exemple : '2020-09-18T04:13:56Z').
Catégorie
 category string

Canal ou intention de l’interaction constituante.
Type
 type string

Description supplémentaire de l’action pour compléter la catégorie.
Résumé
 summary string

Brève description de l’action qui apparaît en haut de l’enregistrement. Limite de caractères : 255.
Note
 description string

Explication détaillée qui s’explique sur le résumé de l’action.
Terminé?
 completed boolean

L’action est-elle terminée ? Si le système est configuré pour utiliser des états d’action personnalisés, cette valeur est basée sur la valeur d’état de l’action.
Effectué le
 completed_date date-time

Date à laquelle l’action a été terminée (par exemple : '2020-09-18T04:13:56Z').
Statut
 status string

État de l’action.
Direction
 direction string

Direction de l’action.
Emplacement
 location string

Emplacement de l’action.
ID d’opportunité
 opportunity_id string

ID d’enregistrement système de l’opportunité associée à l’action.
Résultat
 outcome string

Résultat de l’action.
Priority
 priority string

Priorité de l’action.
Heure de début
 start_time string

Heure de début de l’action. Utilise une heure de 24 heures au format HH :mm.
Heure de fin
 end_time string

Heure de fin de l’action. Utilise une heure de 24 heures au format HH :mm.
Collecte de fonds
 fundraisers array of string

Ensemble d’ID d’enregistrement système pour les collectes de fonds associées à l’action.

Mettre à jour une pièce jointe d’action

ID d’opération :
EditActionAttachment

Met à jour une pièce jointe d’action.

Paramètres

Nom Clé Obligatoire Type Description
ID de pièce jointe
 attachment_id True string

ID d’enregistrement système de la pièce jointe à mettre à jour.
Nom
 name string

Nom de fichier de la pièce jointe Limite de caractères : 150.
Date
 date date-time

Date de la pièce jointe (par exemple : '2020-09-18T04:13:56Z').
URL
 url string

URL de la pièce jointe. Cela est requis pour les pièces jointes de lien et non applicables aux pièces jointes physiques.
Étiquettes
 tags array of string

Balises associées à la pièce jointe.

Obtenir une action constituante

ID d’opération :
GetAction

Retourne des informations sur une action constituante.

Paramètres

Nom Clé Obligatoire Type Description
ID d’action
 action_id True string

ID d’enregistrement système de l’action à obtenir.

Retours

Action

Corps
ConstituentApi.ActionRead

Répertorier les actions constituantes

ID d’opération :
ListConstituentActions

Répertorie les actions d’un constituant.

Paramètres

Nom Clé Obligatoire Type Description
ID constituant
 constituent_id True string

ID d’enregistrement système de la constituante.

Retours

Actions

Corps
ConstituentApi.ApiCollectionOfActionRead

Répertorier les champs personnalisés d’action

ID d’opération :
ListActionCustomFields

Répertorie les champs personnalisés d’une action.

Paramètres

Nom Clé Obligatoire Type Description
ID d’action
 action_id True string

ID d’enregistrement système de l’action.

Retours

Champs personnalisés

Corps
ConstituentApi.ApiCollectionOfActionCustomFieldRead

Définitions

ConstituentApi.ActionAttachmentRead

Attachment

Nom Chemin d’accès Type Description
ID
 id string

ID d’enregistrement système de la pièce jointe.
ID d’action
 parent_id string

ID d’enregistrement système de l’action associée à la pièce jointe.
Type
 type string

Type de pièce jointe. Les pièces jointes physiques sont des fichiers chargés tels que des images, des fichiers PDF ou des documents Word enregistrés localement ou sur le réseau. Ils sont stockés et gérés dans le système. Les pièces jointes de liens sont des liens vers des fichiers tels que des images, des billets de blog ou des vidéos YouTube en ligne ou dans un compte de stockage cloud. Ils sont stockés et gérés en externe.
Nom
 name string

Nom de fichier de la pièce jointe Limite de caractères : 150.
Date
 date date-time

Date de la pièce jointe.
URL
 url string

URL de la pièce jointe. Cela est requis pour les pièces jointes de lien et non applicables aux pièces jointes physiques.
Nom de fichier
 file_name string

Le nom du fichier. Limite de caractères : 36. Pour les pièces jointes physiques uniquement.
ID de fichier
 file_id string

L’identificateur du fichier. Limite de caractères : 36. Pour les pièces jointes physiques uniquement.
ID de miniature
 thumbnail_id string

Identificateur de la miniature. Limite de caractères : 36. Pour les pièces jointes physiques uniquement.
URL de miniature
 thumbnail_url string

URL d’une miniature. Pour les pièces jointes physiques qui sont uniquement des images. Contient une signature limitée dans le temps qui limite l’accès à 60 minutes.
Type de contenu
 content_type string

Type de contenu. Pour les pièces jointes physiques uniquement.
Taille du fichier
 file_size integer

Taille du fichier en octets. Pour les pièces jointes physiques uniquement.
Étiquettes
 tags array of string

Balises associées à la pièce jointe.

ConstituentApi.ActionCustomFieldRead

Champ personnalisé

Nom Chemin d’accès Type Description
ID
 id string

ID d’enregistrement système du champ personnalisé.
ID d’action
 parent_id string

ID d’enregistrement système de l’action associée au champ personnalisé.
Catégorie
 category string

Catégorie de champ personnalisé.
Type
 type string

Type de données que le champ personnalisé représente.
Valeur
 value

Valeur du champ personnalisé.
Valeur de texte
 text_value string

Valeur de texte du champ personnalisé.
Valeur numérique
 number_value integer

Valeur numérique du champ personnalisé.
Valeur de date
 date_value date

Valeur de date du champ personnalisé.
Valeur monétaire
 currency_value double

Valeur monétaire du champ personnalisé.
Valeur booléenne
 boolean_value boolean

Valeur booléenne du champ personnalisé.
Valeur d’entrée de table
 codetableentry_value string

Valeur d’entrée de table du champ personnalisé.
Valeur d’ID constituante
 constituentid_value string

Valeur d’ID constituante du champ personnalisé.
jour
 fuzzydate_value.d integer

Jour de la date floue.
month
 fuzzydate_value.m integer

Mois à la date approximative.
année
 fuzzydate_value.y integer

L’année dans la date approximative.
Date
 date date

Date du champ personnalisé.
Commentaire
 comment string

Commentaire sur le champ personnalisé. Limite de caractères : 50.
Date d’ajout
 date_added date-time

Date de création du champ personnalisé.
Date de modification
 date_modified date-time

Date de dernière modification du champ personnalisé.

ConstituentApi.ActionRead

Action

Nom Chemin d’accès Type Description
ID
 id string

ID d’enregistrement système de l’action.
ID constituant
 constituent_id string

ID d’enregistrement système de la constituante associée à l’action.
Catégorie
 category string

Canal ou intention de l’interaction constituante.
Terminé?
 completed boolean

L’action est-elle terminée ? Si le système est configuré pour utiliser des états d’action personnalisés, cette valeur est basée sur la valeur d’état de l’action.
Effectué le
 completed_date date-time

Date à laquelle l’action a été terminée.
Date
 date date-time

Date de l’action.
Note
 description string

Explication détaillée qui s’explique sur le résumé de l’action.
Direction
 direction string

Direction de l’action.
Collecte de fonds
 fundraisers array of string

Ensemble d’ID d’enregistrement système pour les collectes de fonds associées à l’action.
Emplacement
 location string

Emplacement de l’action.
ID d’opportunité
 opportunity_id string

ID d’enregistrement système de l’opportunité associée à l’action.
Résultat
 outcome string

Résultat de l’action.
Priority
 priority string

Priorité de l’action.
Heure de début
 start_time string

Heure de début de l’action. Utilise une heure de 24 heures au format HH :mm.
Heure de fin
 end_time string

Heure de fin de l’action. Utilise une heure de 24 heures au format HH :mm.
Statut
 status string

État de l’action.
Code de statut
 status_code string

Code d’état de l’action. Cette propriété est retournée uniquement lorsque le système est configuré pour utiliser des états d’action personnalisés.
État calculé
 computed_status string

État de l’action calculée. Si le système n’est pas configuré pour utiliser des états d’action personnalisés, ce champ calcule l’état en fonction des propriétés terminées et de date. Si ce n’est pas le cas, le champ calcule l’état en fonction de la propriété date de l’action et indique si la propriété État de l’action est configurée comme terminée.
Résumé
 summary string

Brève description de l’action qui apparaît en haut de l’enregistrement. Limite de caractères : 255.
Type
 type string

Description supplémentaire de l’action pour compléter la catégorie.
Date d’ajout
 date_added date-time

Date de création de l’action.
Date de modification
 date_modified date-time

Date de la dernière modification de l’action.

ConstituantApi.ApiCollectionOfActionAttachmentRead

Attachments

Nom Chemin d’accès Type Description
Nombre
 count integer

Nombre d’éléments disponibles pour la récupération dans la collection après l’application de paramètres de requête. Les paramètres de limite et de décalage n’affectent pas le nombre, mais pour faciliter la pagination, ils peuvent affecter le nombre d’éléments dans le jeu de résultats de valeur.
value
 value array of ConstituentApi.ActionAttachmentRead

Ensemble d’éléments inclus dans la réponse. Il peut s’agir d’un sous-ensemble des éléments de la collection.

ConstituentApi.ApiCollectionOfActionCustomFieldRead

Champs personnalisés

Nom Chemin d’accès Type Description
Nombre
 count integer

Nombre d’éléments disponibles pour la récupération dans la collection après l’application de paramètres de requête. Les paramètres de limite et de décalage n’affectent pas le nombre, mais pour faciliter la pagination, ils peuvent affecter le nombre d’éléments dans le jeu de résultats de valeur.
value
 value array of ConstituentApi.ActionCustomFieldRead

Ensemble d’éléments inclus dans la réponse. Il peut s’agir d’un sous-ensemble des éléments de la collection.

ConstituentApi.ApiCollectionOfActionRead

Actions

Nom Chemin d’accès Type Description
Nombre
 count integer

Nombre d’éléments disponibles pour la récupération dans la collection après l’application de paramètres de requête. Les paramètres de limite et de décalage n’affectent pas le nombre, mais pour faciliter la pagination, ils peuvent affecter le nombre d’éléments dans le jeu de résultats de valeur.
value
 value array of ConstituentApi.ActionRead

Ensemble d’éléments inclus dans la réponse. Il peut s’agir d’un sous-ensemble des éléments de la collection.

ConstituentApi.CreatedAction

Action créée

Nom Chemin d’accès Type Description
ID
 id string

ID de l’action nouvellement créée.

ConstituantApi.CreatedActionAttachment

Pièce jointe d’action créée

Nom Chemin d’accès Type Description
ID
 id string

ID de la pièce jointe de l’action nouvellement créée.

ConstituentApi.CreatedActionCustomField

Champ personnalisé d’action créé

Nom Chemin d’accès Type Description
ID
 id string

ID du champ personnalisé de l’action nouvellement créée.