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

**Pré-requisito**

Um objeto do Blackbaud Raiser’s Edge NXT do qual você deseja ler. Você precisará do nome do objeto.

**Entidades compatíveis quanto à origem**:


| Entidade | Pode ser filtrada | Oferece suporte a limite | Oferece suporte a Ordenar por | Oferece suporte a Selecionar \* | Oferece suporte a particionamento | 
| --- | --- | --- | --- | --- | --- | 
| Endereço do constituinte | Sim | Sim | Não | Sim | Sim | 
| Educação do constituinte | Sim | Sim | Não | Sim | Sim | 
| Endereço de e-mail do constituinte | Sim | Sim | Não | Sim | Sim | 
| Telefone do constituinte | Sim | Sim | Não | Sim | Sim | 
| Observação do constituinte | Sim | Sim | Não | Sim | Sim | 
| Relacionamento do constituinte | Sim | Sim | Não | Sim | Sim | 
| Presença on-line do constituinte | Sim | Sim | Não | Sim | Sim | 
| Oportunidade | Sim | Sim | Não | Sim | Sim | 
| Recurso | Sim | Sim | Não | Sim | Sim | 
| Campaign | Sim | Sim | Não | Sim | Sim | 
| Fundo | Sim | Sim | Não | Sim | Sim | 
| Pacote | Sim | Sim | Não | Sim | Sim | 
| Lote da doação | Sim | Sim | Não | Sim | Não | 
| Participante do evento | Sim | Sim | Sim | Sim | Sim | 
| Atribuição de arrecadação de fundos para constituintes | Não | Não | Não | Sim | Não | 
| Doação | Sim | Sim | Sim | Sim | Sim | 
| Associação | Sim | Sim | Não | Sim | Sim | 
| Ação | Sim | Sim | Não | Sim | Não | 
| Constituinte | Sim | Sim | Sim | Sim | Sim | 
| Bens do constituinte | Sim | Sim | Não | Sim | Sim | 
| Event | Sim | Sim | Sim | Sim | Sim | 
| Campo personalizado da doação | Sim | Sim | Não | Sim | Sim | 

**Exemplo:**

```
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>
    }
```

## Detalhes das entidades e dos campos do Blackbaud Raiser’s Edge NXT
<a name="blackbaud-reading-entity-field-details"></a>

Para obter mais informações sobre os detalhes das entidades e dos campos, consulte:
+ [Ação](https://developer.blackbaud.com/skyapi/renxt/constituent/entities#Action)
+ [Constituinte](https://developer.blackbaud.com/skyapi/renxt/constituent/entities#Constituent)
+ [Endereço do constituinte](https://developer.blackbaud.com/skyapi/renxt/constituent/entities#Address)
+ [Associação do constituinte](https://developer.blackbaud.com/skyapi/renxt/constituent/entities#Membership)
+ [Atribuição de arrecadação de fundos para constituintes](https://developer.blackbaud.com/skyapi/renxt/constituent/entities#FundraiserAssignment)
+ [Educação do constituinte](https://developer.blackbaud.com/skyapi/renxt/constituent/entities#Education)
+ [Endereço de e-mail do constituinte](https://developer.blackbaud.com/skyapi/renxt/constituent/entities#EmailAddress)
+ [Telefone do constituinte](https://developer.blackbaud.com/skyapi/renxt/constituent/entities#Phone)
+ [Observação do constituinte](https://developer.blackbaud.com/skyapi/renxt/constituent/entities#Note)
+ [Presença on-line do constituinte](https://developer.blackbaud.com/skyapi/renxt/constituent/entities#OnlinePresence)
+ [Relacionamento do constituinte](https://developer.blackbaud.com/skyapi/renxt/constituent/entities#Relationship)
+ [Evento](https://developer.blackbaud.com/skyapi/renxt/event/entities#Event)
+ [Participante do evento](https://developer.blackbaud.com/skyapi/renxt/event/entities#Participant)
+ [Recurso](https://developer.blackbaud.com/skyapi/renxt/fundraising/entities#Appeal)
+ [Campanha](https://developer.blackbaud.com/skyapi/renxt/fundraising/entities#Campaign)
+ [Fundo](https://developer.blackbaud.com/skyapi/renxt/fundraising/entities#Fund)
+ [Pacote](https://developer.blackbaud.com/skyapi/renxt/fundraising/entities#Package)
+ [Doação](https://developer.blackbaud.com/skyapi/renxt/gift/entities#Gift)
+ [Campo personalizado da doação](https://developer.blackbaud.com/skyapi/renxt/gift/entities#CustomField)
+ [Lote da doação](https://developer.blackbaud.com/skyapi/renxt/gift-batch/entities#GiftBatch)
+ [Oportunidade](https://developer.blackbaud.com/skyapi/renxt/opportunity/entities#Opportunity)
+ [Códigos do constituinte](https://developer.sky.blackbaud.com/api#api=56b76470069a0509c8f1c5b3)

**nota**  
Os tipos de dados Struct e List são convertidos no tipo de dados String, e o tipo de dados DateTime é convertido em Timestamp na resposta dos conectores.

## Particionamento de consultas
<a name="blackbaud-reading-partitioning-queries"></a>

**Particionamento com base em campo**:

O Blackbaud Raiser’s Edge NXT não oferece suporte ao particionamento baseado em campos ou em registros.

**Particionamento com base em registros**:

É possível fornecer a opção adicional `NUM_PARTITIONS` do Spark se quiser utilizar a simultaneidade no Spark. Com esse parâmetro, a consulta original seria dividida em `NUM_PARTITIONS` subconsultas, que poderiam ser executadas pelas tarefas do Spark simultaneamente.

No particionamento baseado em registros, o número total de registros presentes é consultado na API do Blackbaud Raiser’s Edge NXT e dividido pelo número `NUM_PARTITIONS` fornecido. O número resultante de registros é então buscado simultaneamente por cada subconsulta.
+ `NUM_PARTITIONS`: o número de partições.

Exemplo:

```
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>
    }
```