Importación de RENXT de Blackbaud (versión preliminar)
Blackbaud Raiser's Edge EDITION es una completa solución de software de recaudación de fondos y administración de donantes basada en la nube creada específicamente para organizaciones sin ánimo de lucro y toda la comunidad de buena comunidad social. Use el conector de importación para administrar y ejecutar trabajos de importación.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas las regiones Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Standard | Todas las regiones de Logic Apps excepto las siguientes: - regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Premium | Todas las regiones Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Premium | Todas las regiones Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Name | Compatibilidad con Blackbaud |
| Dirección URL | https://www.blackbaud.com/support |
| skyapi@blackbaud.com |
| Metadatos del conector | |
|---|---|
| Publicador | Blackbaud, Inc. |
| Sitio web | https://www.blackbaud.com/products/blackbaud-raisers-edge-nxt |
| Directiva de privacidad | https://www.blackbaud.com/privacy-shield |
| Categories | Ventas y CRM; Productividad |
Raiser's Edge EDITION es una solución completa de software de gestión de donantes y recaudación de fondos basada en la nube creada específicamente para organizaciones sin ánimo de lucro y toda la comunidad social.
Este conector se basa en la API SKY de Blackbaud y proporciona operaciones para ayudar a administrar los trabajos de importación dentro de The Raiser's Edge INTUNE.
Para obtener más información, consulte la documentación.
Prerequisites
Para usar este conector, debe tener una cuenta de identificador de Blackbaud con acceso a uno o varios entornos de Blackbaud.
Además, el administrador de la organización también debe realizar una acción de nivel de administrador dentro del sistema para permitir que este conector acceda al entorno de Blackbaud. Puede encontrar más información sobre estos requisitos previos en la documentación de configuración inicial .
¿Cómo obtener credenciales?
El administrador de la organización le enviará una invitación al entorno edge DE RAISER de raiser y configurará los permisos de la cuenta de usuario dentro del entorno. No se requieren credenciales adicionales para usar este conector.
Limitaciones y problemas conocidos
El conector funcionará en el contexto de la cuenta de usuario y, por tanto, estará sujeto a los permisos de usuario dentro del entorno.
Acciones
| Actualización de un trabajo de importación |
Actualiza los detalles sobre un trabajo de importación. |
| Crear un trabajo de importación |
Crea un trabajo de importación que se iniciará más adelante una vez cargado el archivo. |
| Eliminación de un trabajo de importación |
Elimina un trabajo de importación. |
| Enumeración de trabajos de importación |
Enumera los trabajos de importación. |
| Inicio de un trabajo de importación |
Inicia un trabajo en segundo plano para ejecutar la importación especificada. |
| Obtención de un trabajo de importación |
Devuelve los detalles de un trabajo de importación específico. |
| Obtención del URI de carga de archivos de trabajo de importación |
Devuelve un nuevo URI de carga de archivos para un trabajo de importación pendiente. |
| Obtención del URI de descarga del archivo de excepción del trabajo de importación |
Devuelve el URI de descarga del archivo de excepción de un trabajo de importación. |
Actualización de un trabajo de importación
Actualiza los detalles sobre un trabajo de importación.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de trabajo de importación
|
job_id | True | string |
Identificador de registro del sistema del trabajo de importación que se va a actualizar. |
|
Nombre del archivo
|
file_name | string |
Nombre del archivo que se va a importar. |
Crear un trabajo de importación
Crea un trabajo de importación que se iniciará más adelante una vez cargado el archivo.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre del archivo
|
file_name | True | string |
Nombre del archivo que se va a importar. |
|
Fila de encabezado
|
header_row | string |
Fila de encabezado que se va a usar al importar un archivo CSV. |
Devoluciones
Consentimiento constituyente creado
Eliminación de un trabajo de importación
Elimina un trabajo de importación.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de trabajo de importación
|
job_id | True | string |
Identificador de registro del sistema del trabajo de importación que se va a eliminar. |
Enumeración de trabajos de importación
Enumera los trabajos de importación.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Situación
|
status | string |
Filtre los trabajos por estado. |
|
|
Limit
|
limit | integer |
Representa el número de registros que se van a devolver. El valor predeterminado es 100. El máximo es 10000. |
|
|
Token de continuación
|
continuation_token | string |
Token de continuación para obtener la siguiente página de resultados. |
Devoluciones
Importar trabajos
Inicio de un trabajo de importación
Inicia un trabajo en segundo plano para ejecutar la importación especificada.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. del trabajo
|
job_id | True | string |
Identificador del trabajo de importación que se va a iniciar. |
Devoluciones
Trabajo de informe iniciado
Obtención de un trabajo de importación
Devuelve los detalles de un trabajo de importación específico.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. del trabajo
|
job_id | True | string |
Identificador de registro del sistema del trabajo de importación. |
Devoluciones
Trabajo de importación
- Body
- ImportApi.ImportJob
Obtención del URI de carga de archivos de trabajo de importación
Devuelve un nuevo URI de carga de archivos para un trabajo de importación pendiente.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. del trabajo
|
job_id | True | string |
Identificador de registro del sistema del trabajo de importación. |
Devoluciones
Información de carga de archivos
Obtención del URI de descarga del archivo de excepción del trabajo de importación
Devuelve el URI de descarga del archivo de excepción de un trabajo de importación.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. del trabajo
|
job_id | True | string |
Identificador de registro del sistema del trabajo de importación. |
Devoluciones
Información de descarga de archivos
Definiciones
ImportApi.CreateImportJobResponse
Consentimiento constituyente creado
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
ID
|
id | string |
Identificador del trabajo de importación recién creado. |
|
URI de carga de archivos
|
file_upload_uri | string |
URI para cargar el archivo que se va a importar. |
|
Asignación de campos
|
field_mappings | array of ImportApi.FieldMapping |
Para las importaciones de CSV, las asignaciones de campos de la fila de encabezado a los campos de destino. |
|
Asignación de mensajes de validación
|
mapping_validation_messages | array of ImportApi.MappingValidationMessage |
Mensajes de validación de asignación de la fila de encabezado del trabajo creado. Solo se aplica a las importaciones csv. |
ImportApi.FieldMapping
Asignación de campos
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
campo de origen
|
source_field | string |
Nombre del campo de origen. |
|
campo de destino
|
target_field | string |
Nombre del campo de destino. |
ImportApi.ImportJobFileUploadInfo
Información de carga de archivos
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
URI de carga de archivos
|
file_upload_uri | string |
URI para cargar el archivo que se va a importar. |
ImportApi.ImportJob
Trabajo de importación
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
ID
|
id | string |
Identificador del trabajo de importación. |
|
Nombre del archivo
|
file_name | string |
Nombre del archivo que se va a importar. |
|
Fecha de inicio
|
start_date | date-time |
Fecha en que se inició el trabajo de importación. |
|
Fecha de finalización
|
end_date | date-time |
Fecha en que se completó el trabajo de importación. |
|
Duración de ejecución
|
run_duration | integer |
Duración del trabajo de importación en segundos. |
|
Secuencia
|
sequence | integer |
Número de secuencia del trabajo de importación. |
|
Filas procesadas
|
rows_processed | integer |
Número de filas procesadas por el trabajo de importación. |
|
Filas confirmadas
|
rows_committed | integer |
Número de filas confirmadas por el trabajo de importación. |
|
Filas rechazadas
|
rows_rejected | integer |
Número de filas rechazadas por el trabajo de importación. |
|
Recuento de excepciones
|
exception_count | integer |
Número de excepciones detectadas por el trabajo de importación. |
|
Mensaje de error
|
failure_message | string |
Mensaje de error del trabajo de importación. |
|
Situación
|
status | string |
El estado del trabajo de importación. |
|
Agregado por id.
|
added_by | string |
Usuario que creó el trabajo de importación. |
|
Fecha de creación
|
date_added | date-time |
Fecha en que se creó el trabajo de importación. |
|
Fecha de modificación
|
date_modified | date-time |
Fecha en la que se modificó por última vez el trabajo de importación. |
ImportApi.ImportJobExceptionFileDownloadInfo
Información de descarga de archivos
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
URI de descarga de archivos
|
file_download_uri | string |
URI para descargar el archivo de excepción. |
ImportApi.ImportJobSummary
Trabajo de importación
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
ID
|
id | string |
Identificador del trabajo de importación. |
|
Nombre del archivo
|
file_name | string |
Nombre del archivo que se va a importar. |
|
Fecha de inicio
|
start_date | date-time |
Fecha en que se inició el trabajo de importación. |
|
Fecha de finalización
|
end_date | date-time |
Fecha en que se completó el trabajo de importación. |
|
Duración de ejecución
|
run_duration | integer |
Duración del trabajo de importación en segundos. |
|
Secuencia
|
sequence | integer |
Número de secuencia del trabajo de importación. |
|
Filas procesadas
|
rows_processed | integer |
Número de filas procesadas por el trabajo de importación. |
|
Filas confirmadas
|
rows_committed | integer |
Número de filas confirmadas por el trabajo de importación. |
|
Filas rechazadas
|
rows_rejected | integer |
Número de filas rechazadas por el trabajo de importación. |
|
Recuento de excepciones
|
exception_count | integer |
Número de excepciones detectadas por el trabajo de importación. |
|
Mensaje de error
|
failure_message | string |
Mensaje de error del trabajo de importación. |
|
Situación
|
status | string |
El estado del trabajo de importación. |
|
Agregado por id.
|
added_by | string |
Usuario que creó el trabajo de importación. |
|
Fecha de creación
|
date_added | date-time |
Fecha en que se creó el trabajo de importación. |
|
Fecha de modificación
|
date_modified | date-time |
Fecha en la que se modificó por última vez el trabajo de importación. |
ImportApi.ImportJobSummaryCollection
Importar trabajos
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Total
|
count | integer |
Número total de trabajos que coinciden con el filtro. |
|
Limit
|
limit | integer |
Número solicitado de registros que se van a devolver. |
|
Token de continuación
|
continuation_token | string |
Token de continuación para obtener la siguiente página de resultados. |
|
jobs
|
jobs | array of ImportApi.ImportJobSummary |
Conjunto de elementos incluidos en la respuesta. |
ImportApi.MappingValidationMessage
Mensaje de validación de asignación
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
asignación de registros
|
record_mapping | string |
Asignación de registros asociada al mensaje de error de validación. |
|
campo de destino
|
target_field | string |
Campo de destino asociado al mensaje de error de validación. |
|
tipo de mensaje
|
message_type | string |
Tipo del mensaje de validación. |
|
message
|
message | string |
Mensaje de validación. |
|
campos de archivo
|
file_fields | array of string |
Los campos de archivo asociados al mensaje de error de validación. |
ImportApi.StartImportJobResponse
Trabajo de informe iniciado
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Situación
|
status | string |
El estado del trabajo de importación. |