Blackbaud RENXT Import (préversion)
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 Importer pour gérer et exécuter des travaux d’importation.
Ce connecteur est disponible dans les produits et régions suivants :
| Service | classe | Regions |
|---|---|---|
| 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 | Standard | 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 | |
|---|---|
| Name | Prise en charge de Blackbaud |
| URL | https://www.blackbaud.com/support |
| Messagerie électronique | skyapi@blackbaud.com |
| Métadonnées du connecteur | |
|---|---|
| Éditeur | Blackbaud, Inc. |
| Website | https://www.blackbaud.com/products/blackbaud-raisers-edge-nxt |
| Politique de confidentialité | https://www.blackbaud.com/privacy-shield |
| Categories | 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 gérer les travaux d’importation dans le NXT edge de The Raiser.
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.
Actions
| Créer une tâche d’importation |
Crée un travail d’importation qui sera démarré ultérieurement une fois le fichier chargé. |
| Démarrer un travail d’importation |
Démarre un travail en arrière-plan pour exécuter l’importation spécifiée. |
| Mettre à jour un travail d’importation |
Met à jour les détails d’un travail d’importation. |
| Obtenir l’URI de chargement du fichier de travail d’importation |
Retourne un nouvel URI de chargement de fichier pour un travail d’importation en attente. |
| Obtenir l’URI de téléchargement du fichier d’exception de travail d’importation |
Retourne l’URI de téléchargement du fichier d’exception pour un travail d’importation. |
| Obtenir un travail d’importation |
Retourne les détails d’un travail d’importation spécifique. |
| Répertorier les travaux d’importation |
Répertorie les travaux d’importation. |
| Supprimer un travail d’importation |
Supprime un travail d’importation. |
Créer une tâche d’importation
Crée un travail d’importation qui sera démarré ultérieurement une fois le fichier chargé.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Nom de fichier
|
file_name | True | string |
Nom du fichier à importer. |
|
Ligne d’en-tête
|
header_row | string |
Ligne d’en-tête à utiliser lors de l’importation d’un fichier CSV. |
Retours
Consentement constituant créé
Démarrer un travail d’importation
Démarre un travail en arrière-plan pour exécuter l’importation spécifiée.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de travail
|
job_id | True | string |
ID du travail d’importation à démarrer. |
Retours
Travail de rapport démarré
Mettre à jour un travail d’importation
Met à jour les détails d’un travail d’importation.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de travail d’importation
|
job_id | True | string |
ID d’enregistrement système du travail d’importation à mettre à jour. |
|
Nom de fichier
|
file_name | string |
Nom du fichier à importer. |
Obtenir l’URI de chargement du fichier de travail d’importation
Retourne un nouvel URI de chargement de fichier pour un travail d’importation en attente.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de travail
|
job_id | True | string |
ID d’enregistrement système du travail d’importation. |
Retours
Informations de chargement de fichier
Obtenir l’URI de téléchargement du fichier d’exception de travail d’importation
Retourne l’URI de téléchargement du fichier d’exception pour un travail d’importation.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de travail
|
job_id | True | string |
ID d’enregistrement système du travail d’importation. |
Retours
Informations de téléchargement de fichier
Obtenir un travail d’importation
Retourne les détails d’un travail d’importation spécifique.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de travail
|
job_id | True | string |
ID d’enregistrement système du travail d’importation. |
Retours
Tâche d’importation
- Corps
- ImportApi.ImportJob
Répertorier les travaux d’importation
Répertorie les travaux d’importation.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Status
|
status | string |
Filtrez les travaux par état. |
|
|
Limit
|
limit | integer |
Représente le nombre d’enregistrements à retourner. La valeur par défaut est 100. La valeur maximale est de 1 0000. |
|
|
Jeton de liaison
|
continuation_token | string |
Jeton de continuation pour obtenir la page suivante des résultats. |
Retours
Importer des travaux
Supprimer un travail d’importation
Supprime un travail d’importation.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de travail d’importation
|
job_id | True | string |
ID d’enregistrement système du travail d’importation à supprimer. |
Définitions
ImportApi.CreateImportJobResponse
Consentement constituant créé
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ID
|
id | string |
ID du travail d’importation nouvellement créé. |
|
URI de chargement de fichier
|
file_upload_uri | string |
URI permettant de charger le fichier à importer. |
|
Mappages de champs
|
field_mappings | array of ImportApi.FieldMapping |
Pour les importations CSV, les mappages de champs de la ligne d’en-tête aux champs cibles. |
|
Mappage des messages de validation
|
mapping_validation_messages | array of ImportApi.MappingValidationMessage |
Messages de validation de mappage de la ligne d’en-tête du travail créé. S’applique uniquement aux importations CSV. |
ImportApi.FieldMapping
Mappage de champs
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
champ source
|
source_field | string |
Nom du champ source. |
|
champ cible
|
target_field | string |
Nom du champ cible. |
ImportApi.ImportJobFileUploadInfo
Informations de chargement de fichier
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
URI de chargement de fichier
|
file_upload_uri | string |
URI permettant de charger le fichier à importer. |
ImportApi.ImportJob
Tâche d’importation
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ID
|
id | string |
Identificateur du travail d’importation. |
|
Nom de fichier
|
file_name | string |
Nom du fichier importé. |
|
Date de début
|
start_date | date-time |
Date de démarrage du travail d’importation. |
|
Date terminée
|
end_date | date-time |
Date à laquelle la tâche d’importation a été terminée. |
|
Durée d’exécution
|
run_duration | integer |
Durée du travail d’importation en secondes. |
|
Série
|
sequence | integer |
Numéro de séquence du travail d’importation. |
|
Lignes traitées
|
rows_processed | integer |
Nombre de lignes traitées par le travail d’importation. |
|
Lignes validées
|
rows_committed | integer |
Nombre de lignes validées par le travail d’importation. |
|
Lignes rejetées
|
rows_rejected | integer |
Nombre de lignes rejetées par le travail d’importation. |
|
Nombre d’exceptions
|
exception_count | integer |
Nombre d’exceptions rencontrées par le travail d’importation. |
|
Message d’échec
|
failure_message | string |
Message d’échec du travail d’importation. |
|
Status
|
status | string |
Le status de la tâche d’importation. |
|
Ajouté par ID
|
added_by | string |
Utilisateur qui a créé le travail d’importation. |
|
Date de création
|
date_added | date-time |
Date de création du travail d’importation. |
|
Modifié le
|
date_modified | date-time |
Date de la dernière modification du travail d’importation. |
ImportApi.ImportJobExceptionFileDownloadInfo
Informations de téléchargement de fichier
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
URI de téléchargement de fichier
|
file_download_uri | string |
URI pour le téléchargement du fichier d’exception. |
ImportApi.ImportJobSummary
Tâche d’importation
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ID
|
id | string |
Identificateur du travail d’importation. |
|
Nom de fichier
|
file_name | string |
Nom du fichier importé. |
|
Date de début
|
start_date | date-time |
Date de démarrage du travail d’importation. |
|
Date terminée
|
end_date | date-time |
Date à laquelle la tâche d’importation a été terminée. |
|
Durée d’exécution
|
run_duration | integer |
Durée du travail d’importation en secondes. |
|
Série
|
sequence | integer |
Numéro de séquence du travail d’importation. |
|
Lignes traitées
|
rows_processed | integer |
Nombre de lignes traitées par le travail d’importation. |
|
Lignes validées
|
rows_committed | integer |
Nombre de lignes validées par le travail d’importation. |
|
Lignes rejetées
|
rows_rejected | integer |
Nombre de lignes rejetées par le travail d’importation. |
|
Nombre d’exceptions
|
exception_count | integer |
Nombre d’exceptions rencontrées par le travail d’importation. |
|
Message d’échec
|
failure_message | string |
Message d’échec du travail d’importation. |
|
Status
|
status | string |
Le status de la tâche d’importation. |
|
Ajouté par ID
|
added_by | string |
Utilisateur qui a créé le travail d’importation. |
|
Date de création
|
date_added | date-time |
Date de création du travail d’importation. |
|
Modifié le
|
date_modified | date-time |
Date de la dernière modification du travail d’importation. |
ImportApi.ImportJobSummaryCollection
Importer des travaux
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Nombre
|
count | integer |
Nombre total de travaux correspondant au filtre. |
|
Limit
|
limit | integer |
Nombre demandé d’enregistrements à retourner. |
|
Jeton de liaison
|
continuation_token | string |
Jeton de continuation pour obtenir la page suivante des résultats. |
|
jobs
|
jobs | array of ImportApi.ImportJobSummary |
Ensemble d’éléments inclus dans la réponse. |
ImportApi.MappingValidationMessage
Message de validation de mappage
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
mappage d’enregistrements
|
record_mapping | string |
Mappage d’enregistrements associé au message d’erreur de validation. |
|
champ cible
|
target_field | string |
Champ cible associé au message d’erreur de validation. |
|
type de message
|
message_type | string |
Type du message de validation. |
|
message
|
message | string |
Message de validation. |
|
champs de fichier
|
file_fields | array of string |
Champs de fichier associés au message d’erreur de validation. |
ImportApi.StartImportJobResponse
Travail de rapport démarré
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Status
|
status | string |
Le status de la tâche d’importation. |