Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Lettura da entità Microsoft Teams
<a name="microsoft-teams-reading-from-entities"></a>

 **Prerequisiti** 
+  Un oggetto Microsoft Teams da cui si desidera leggere. Sarà necessario il nome dell'oggetto, ad esempio team o channel-message. Nella tabella seguente sono illustrate le entità supportate. 

 **Entità supportate come origine** 

 Tutte le entità sono supportate con l'API versione 1.0. 


| Entità | Può essere Filtrato | Supporta Limite | Supporta Ordina per | Supporta Seleziona \* | Supporta Partizionamento | 
| --- | --- | --- | --- | --- | --- | 
| Team | No | No | No | Sì | No | 
| Membri del team | Sì  | Sì | No | Sì | Sì | 
| Gruppi | Sì  | Sì | Sì | Sì | Sì | 
| Membri del gruppo | Sì  | Sì | No | Sì | No | 
| Canali | Sì | No | No | Sì | Sì | 
| Messaggi del canale | No | Sì | No | Sì | No | 
| Risposte ai messaggi del canale | No | Sì | No | Sì | No | 
| Tabulazioni del canale | Sì | No | No | Sì | No | 
| Chat | Sì  | Sì | Sì | Sì | Sì | 
| Eventi del calendario | Sì  | Sì | Sì | Sì | Sì | 

 **Esempio** 

```
MicrosoftTeams_read = glueContext.create_dynamic_frame.from_options(
    connection_type="MicrosoftTeams",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "company",
        "API_VERSION": "v1.0"
    }
```

## Dettagli dell'entità e dei campi di Microsoft Teams
<a name="microsoft-teams-entity-and-field-details"></a>

 Elenco delle entità: 
+  Squadra: [https://docs.microsoft.com/en-us/graph/api/user-list-joinedteams? ](https://docs.microsoft.com/en-us/graph/api/user-list-joinedteams?view=graph-rest-1.0)view=graph-rest-1.0 
+  [Membro del team: -list-members? https://docs.microsoft.com/en-us/ graph/api/team view=graph-rest-1.0](https://docs.microsoft.com/en-us/graph/api/team-list-members?view=graph-rest-1.0) 
+  [Gruppo: -list? https://docs.microsoft.com/en-us/ graph/api/group view=graph-rest-1.0](https://docs.microsoft.com/en-us/graph/api/group-list?view=graph-rest-1.0) 
+  [Membro del gruppo: -list-members? https://docs.microsoft.com/en-us/ graph/api/group view=graph-rest-1.0](https://docs.microsoft.com/en-us/graph/api/group-list-members?view=graph-rest-1.0) 
+  [Canale: -list? https://docs.microsoft.com/en-us/ graph/api/channel view=graph-rest-1.0](https://docs.microsoft.com/en-us/graph/api/channel-list?view=graph-rest-1.0) 
+  [Messaggio del canale: -list-messaggi? https://docs.microsoft.com/en-us/ graph/api/channel view=graph-rest-1.0](https://docs.microsoft.com/en-us/graph/api/channel-list-messages?view=graph-rest-1.0) 
+  [Channel-Message-Reply: -list-replies? https://docs.microsoft.com/en-us/ graph/api/chatmessage view=graph-rest-1.0](https://docs.microsoft.com/en-us/graph/api/chatmessage-list-replies?view=graph-rest-1.0) 
+  [Channel-Tab: -list-tabs? https://docs.microsoft.com/en-us/ graph/api/channel view=graph-rest-1.0](https://docs.microsoft.com/en-us/graph/api/channel-list-tabs?view=graph-rest-1.0) 
+  [Chat: -list? https://docs.microsoft.com/en-us/ graph/api/chat view=graph-rest-1.0]( https://docs.microsoft.com/en-us/graph/api/chat-list?view=graph-rest-1.0) 
+  [Evento del calendario: -list-eventi? https://docs.microsoft.com/en-us/ graph/api/group view=graph-rest-1.0](https://docs.microsoft.com/en-us/graph/api/group-list-events?view=graph-rest-1.0) 

 **Query di partizionamento** 

 Se si desidera utilizzare la simultaneità in Spark, possono essere fornite opzioni Spark `PARTITION_FIELD`, `LOWER_BOUND`, `UPPER_BOUND`, `NUM_PARTITIONS` aggiuntive. Con questi parametri, la query originale viene suddivisa in `NUM_PARTITIONS` query secondarie che possono essere eseguite contemporaneamente dalle attività Spark. 
+  `PARTITION_FIELD`: il nome del campo da utilizzare per partizionare la query. 
+  `LOWER_BOUND`: un valore limite inferiore inclusivo del campo di partizione scelto. 

   Per la data, accettiamo il formato di data di Spark utilizzato nelle query di Spark SQL. Esempio di valori validi: `"2024-02-06"`. 
+  `UPPER_BOUND`: un valore limite superiore esclusivo del campo di partizione scelto. 
+  `NUM_PARTITIONS`: numero di partizioni. 

 I dettagli di supporto del campo di partizionamento per entità sono riportati nella tabella di seguito: 


| Nome entità | Campi di partizionamento | Tipo di dati | 
| --- | --- | --- | 
| Membri del team | visibleHistoryStartDateTime | DateTime | 
| Gruppi | createdDateTime | DateTime | 
| Canali | createdDateTime | DateTime | 
| Chat | createdDateTime, Ora lastModifiedDate | DateTime | 
| Eventi del calendario | createdDateTime, lastModifiedDate Ora, inizio originale | DateTime | 

 **Esempio** 

```
microsoftteams_read = glueContext.create_dynamic_frame.from_options(
    connection_type="MicrosoftTeams",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "group",
        "API_VERSION": "v1.0",
        "PARTITION_FIELD": "createdDateTime"
        "LOWER_BOUND": "2022-07-13T07:55:27.065Z"
        "UPPER_BOUND": "2022-08-12T07:55:27.065Z"
        "NUM_PARTITIONS": "2"
    }
```