# Lectura de entidades de Blackbaud Raiser's Edge NXT
<a name="blackbaud-reading-from-entities"></a>

**Requisito previo**

Un objeto de Blackbaud Raiser's Edge NXT desde el que desea leer. Necesitará el nombre del objeto.

**Entidades compatibles como origen:**


| Entidad | Se puede filtrar | Admite límite | Admite Ordenar por | Admite Seleccionar \$1 | Admite partición | 
| --- | --- | --- | --- | --- | --- | 
| Dirección del contacto | Sí | Sí | No | Sí | Sí | 
| Educación del contacto | Sí | Sí | No | Sí | Sí | 
| Dirección de correo electrónico del contacto | Sí | Sí | No | Sí | Sí | 
| Teléfono del contacto | Sí | Sí | No | Sí | Sí | 
| Nota del contacto | Sí | Sí | No | Sí | Sí | 
| Relación del contacto | Sí | Sí | No | Sí | Sí | 
| Presencia en línea del contacto | Sí | Sí | No | Sí | Sí | 
| Oportunidad | Sí | Sí | No | Sí | Sí | 
| Campaña | Sí | Sí | No | Sí | Sí | 
| Campaña | Sí | Sí | No | Sí | Sí | 
| Fondo | Sí | Sí | No | Sí | Sí | 
| Paquete | Sí | Sí | No | Sí | Sí | 
| Lote de donaciones | Sí | Sí | No | Sí | No | 
| Participante del evento | Sí | Sí | Sí | Sí | Sí | 
| Recaudación de fondos para los electores | No | No | No | Sí | No | 
| Donación | Sí | Sí | Sí | Sí | Sí | 
| Pertenencia | Sí | Sí | No | Sí | Sí | 
| Acción | Sí | Sí | No | Sí | No | 
| Contacto | Sí | Sí | Sí | Sí | Sí | 
| Bienes del contacto | Sí | Sí | No | Sí | Sí | 
| Evento | Sí | Sí | Sí | Sí | Sí | 
| Campo personalizado de donación | Sí | Sí | No | Sí | Sí | 

**Ejemplo:**

```
blackbaud_read = glueContext.create_dynamic_frame.from_options(
    connection_type="BLACKBAUD",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "entityName",
        "API_VERSION": "v1",
        "SUBSCRIPTION_KEY": <Subscription key associated with one's developer account>
    }
```

## Detalles de entidades y campos de Blackbaud Raiser's Edge NXT
<a name="blackbaud-reading-entity-field-details"></a>

Para obtener más información acerca de las entidades y los detalles de los campos, consulte:
+ [Action](https://developer.blackbaud.com/skyapi/renxt/constituent/entities#Action)
+ [Contacto](https://developer.blackbaud.com/skyapi/renxt/constituent/entities#Constituent)
+ [Dirección del contacto](https://developer.blackbaud.com/skyapi/renxt/constituent/entities#Address)
+ [Membresía del contacto](https://developer.blackbaud.com/skyapi/renxt/constituent/entities#Membership)
+ [Constituent Fundraiser Assignment](https://developer.blackbaud.com/skyapi/renxt/constituent/entities#FundraiserAssignment)
+ [Educación del contacto](https://developer.blackbaud.com/skyapi/renxt/constituent/entities#Education)
+ [Dirección de correo electrónico del contacto](https://developer.blackbaud.com/skyapi/renxt/constituent/entities#EmailAddress)
+ [Teléfono del contacto](https://developer.blackbaud.com/skyapi/renxt/constituent/entities#Phone)
+ [Nota del contacto](https://developer.blackbaud.com/skyapi/renxt/constituent/entities#Note)
+ [Presencia en línea del contacto](https://developer.blackbaud.com/skyapi/renxt/constituent/entities#OnlinePresence)
+ [Relación del contacto](https://developer.blackbaud.com/skyapi/renxt/constituent/entities#Relationship)
+ [Evento](https://developer.blackbaud.com/skyapi/renxt/event/entities#Event)
+ [Participante del evento](https://developer.blackbaud.com/skyapi/renxt/event/entities#Participant)
+ [Campaña](https://developer.blackbaud.com/skyapi/renxt/fundraising/entities#Appeal)
+ [Campaña](https://developer.blackbaud.com/skyapi/renxt/fundraising/entities#Campaign)
+ [Fondo](https://developer.blackbaud.com/skyapi/renxt/fundraising/entities#Fund)
+ [Package](https://developer.blackbaud.com/skyapi/renxt/fundraising/entities#Package)
+ [Donación](https://developer.blackbaud.com/skyapi/renxt/gift/entities#Gift)
+ [Campo personalizado de donación](https://developer.blackbaud.com/skyapi/renxt/gift/entities#CustomField)
+ [Lote de donaciones](https://developer.blackbaud.com/skyapi/renxt/gift-batch/entities#GiftBatch)
+ [Oportunidad](https://developer.blackbaud.com/skyapi/renxt/opportunity/entities#Opportunity)
+ [Códigos del contacto](https://developer.sky.blackbaud.com/api#api=56b76470069a0509c8f1c5b3)

**nota**  
Los tipos de datos de estructura y enumeración se convierten en cadenas, y los de fecha y hora se convierten en marcas de tiempo en la respuesta de los conectores.

## Consultas de partición
<a name="blackbaud-reading-partitioning-queries"></a>

**Partición basada en campos**:

Blackbaud Raiser's Edge NXT no admite la partición basada en campos ni en registros.

**Partición basada en registros**:

Puede proporcionar la opción adicional `NUM_PARTITIONS` de Spark si quiere usar la simultaneidad en Spark. Con estos parámetros, la consulta original se dividiría en `NUM_PARTITIONS` subconsultas que las tareas de Spark pueden ejecutar simultáneamente.

En la partición basada en registros, se consulta el número total de registros presentes en la API de Blackbaud Raiser’s Edge NXT y se divide entre el número de `NUM_PARTITIONS` proporcionado. A continuación, cada subconsulta obtiene simultáneamente el número de registros resultante.
+ `NUM_PARTITIONS`: el número de particiones.

Ejemplo:

```
blackbaud_read = glueContext.create_dynamic_frame.from_options(
    connection_type="BLACKBAUD",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "entityName",
        "API_VERSION": "v1",
        "NUM_PARTITIONS": "2",
        "SUBSCRIPTION_KEY": <Subscription key associated with one's developer account>
    }
```