Utilizzo di Microsoft Teams con IBM App Connect Enterprise

Microsoft Teams è uno strumento basato sulla chat che offre una piattaforma comune ai team che lavorano a distanza per condividere informazioni e collaborare. Microsoft Teams si integra con Microsoft 365. IBM® App Connect Enterprise mette a disposizione i nodi "Input" ( Microsoft Teams ) e "Request" ( Microsoft Teams ), che è possibile utilizzare per interagire con Microsoft Teams.

I passaggi seguenti illustrano come connettersi a un account Microsoft Teams e configurare un nodo Request Microsoft Teams utilizzando il rilevamento dei connettori. È possibile seguire una procedura simile per configurare un nodo di input " Microsoft Teams " in modo da monitorare Microsoft Teams alla ricerca di oggetti nuovi o aggiornati, creando un flusso contenente un nodo di input " Microsoft Teams " e configurandolo tramite il rilevamento dei connettori.

1. Nel Toolkit di IBM App Connect Enterprise, crea un flusso contenente un nodo "Richiesta" ( Microsoft Teams ).
2. Seleziona il nodo " Microsoft Teams " nel flusso per visualizzare le proprietà del nodo nell'editor.
3. Nella scheda Di base , selezionare Avvia rilevamento connettore.
   Viene visualizzato un pannello in cui è possibile specificare il nome del progetto di politica e i dettagli del vault da utilizzare durante il rilevamento del connettore.
4. Specificare i dettagli del progetto di politiche e del vault da utilizzare durante il rilevamento del connettore:
   1. Nel campo Progetto politica , specificare il progetto di politica utilizzato per memorizzare le politiche create durante il rilevamento del connettore.
      In alternativa, è possibile creare un nuovo progetto di politica facendo clic su Nuovo e specificando il nome del nuovo progetto di politica. Quindi, fare clic su Fine.
   2. Specificare il vault da utilizzare durante il rilevamento del connettore. Per impostazione predefinita, le credenziali utilizzate durante il rilevamento del connettore vengono archiviate in un vault della directory esterna, che è un vault App Connect Enterprise che può essere utilizzato da qualsiasi server di integrazione. In alternativa, è possibile memorizzare le credenziali in un vault del server di integrazione, che viene creato nella directory di lavoro del server di integrazione e può essere utilizzato soltanto da tale server di integrazione.
      Per specificare il vault da utilizzare per l'archiviazione delle credenziali, completare i passi riportati nella sezione Utilizzo della procedura guidata Rilevamento connettore di uno dei seguenti argomenti:

      • Configurazione di un vault di directory esterno
      • Configurazione di un vault del server di integrazione
   3. Nel campo Chiave vault , immettere la chiave vault utilizzata per accedere alle credenziali memorizzate nel vault. La chiave del vault deve essere lunga almeno 8 caratteri.
   4. Facoltativo: per impostazione predefinita, l'ubicazione del vault e la chiave del vault specificate vengono salvate come preferenze nel Toolkit in modo che i valori siano preimpostati quando si avvia Connector Discovery. Se non si desidera salvare le preferenze, deselezionare Salva nelle preferenze del vault.
5. Fare clic su "Avvia individuazione" per avviare la procedura guidata di individuazione del connettore per il connettore " Microsoft Teams ".
   Viene visualizzata la finestra Rilevamento connettore . Se sono presenti connessioni (account) Microsoft Teams, viene visualizzato un elenco di tali connessioni. Se non sono presenti connessioni, lo stato del connettore Microsoft Teams viene visualizzato come Not connected.
   • Se sono disponibili una o più connessioni (account) Microsoft Teams, procedere come segue:
     1. Selezionare la connessione (account) che si desidera utilizzare, facendo clic su di essa.
     2. Fare clic sul tipo di oggetto richiesto e selezionare l'azione che si desidera eseguire sull'oggetto. Ad esempio, per scaricare i canali da Microsoft Teams, clicca su "Canali" e poi su "Scarica canali".
   • Se non ci sono connessioni esistenti (account), completare la seguente procedura:
     1. Fare clic sul tipo di oggetto richiesto e selezionare l'azione che si desidera eseguire su tale oggetto. Ad esempio, per scaricare i canali da Microsoft Teams, clicca su "Canali" e poi su "Scarica canali".
     2. Fare clic su Connetti per visualizzare una finestra in cui immettere i dettagli del proprio account:
        1. Token di accesso : un token di accesso richiesto inviando una richiesta POST all'endpoint della piattaforma di identità Microsoft. Generalmente generato utilizzando i valori ID client, ID titolare, segreto client, ambito, tipo di concessione, nome utente e password per un'applicazione App Connect registrata nel portale di registrazione dell'applicazione Microsoft Azure .
        2. Token di aggiornamento: un token di aggiornamento restituito per la richiesta POST all'endpoint della piattaforma di identità Microsoft.
        3. ID client: il valore ID applicazione (client) generato per un'app App Connect registrata nel portale di registrazione app Microsoft Azure e visualizzato nella pagina di panoramica per l'applicazione registrata.
        4. Segreto client: un segreto client generato per un'applicazione App Connect registrata nel portale di registrazione dell'app Microsoft Azure . Il segreto client viene generato in "Certificati e segreti" per l'app registrata.
        5. Nome del proxy: se necessario, inserire il nome del proxy che si desidera che IBM App Connect Enterprise utilizzi per inoltrare le chiamate al connettore.
     3. Fare clic su Connetti.

     Per ulteriori informazioni su come identificare questi dettagli di connessione, consultare la sezione "Come utilizzare IBM App Connect con Microsoft Teams " nella documentazione sulla Continuous Delivery (CD) disponibile all'indirizzo IBM App Connect in containers.

6. Impostare le proprietà del connettore richieste nella procedura guidata.
   È possibile aggiungere condizioni per il recupero dei dati, facendo clic su Aggiungi condizione e selezionando la proprietà che si desidera filtrare. Ad esempio, se è stato selezionato Canali e quindi Richiama canali, è possibile selezionare Nome di visualizzazione e specificare il nome di visualizzazione nel campo equals . È inoltre possibile impostare le proprietà che specifichino il numero massimo di record da richiamare e l'azione da intraprendere se tale limite viene superato.
7. Una volta specificate le proprietà nella procedura guidata Rilevamento connettore, fare clic su Salva.
   Le credenziali utilizzate per connettersi a Microsoft Teams sono archiviate nel vault, mentre gli altri dettagli di connessione sono salvati nella politica Microsoft Teams. I valori delle proprietà impostati nella procedura guidata vengono restituiti al nodo " Microsoft Teams Request" nel Toolkit " IBM App Connect Enterprise ".
8. Una volta terminato il rilevamento e salvati i valori delle proprietà, uscire dalla procedura guidata Rilevamento connettore facendo clic sulla X nell'angolo in alto a destra della finestra o premendo Alt+F4.
9. Torna alla modifica del nodo "Richiesta di Microsoft Teams " nel Toolkit " IBM App Connect Enterprise ".
   Le proprietà del connettore impostate nella procedura guidata Connector Discovery (al punto 6 ) sono ora visibili nel nodo Richiesta di Microsoft Teams nell'editor delle proprietà. La scheda Di base mostra i valori delle proprietà Azione e Oggetto impostate nella procedura guidata. Ad esempio, se nella procedura guidata si è selezionato Canali > Recupera canali, le seguenti proprietà saranno visibili nella scheda Base del nodo:

   • Azione - RETRIEVEALL
   • Oggetto - Channel

   i valori delle proprietà Azione e Oggetto vengono visualizzati in formato di sola lettura. Se si desidera modificare questi valori, è possibile farlo facendo nuovamente clic su Avvia rilevamento connettori e impostando nuovi valori nella procedura guidata Rilevamento connettori.

   La proprietà " Schema base name" specifica il nome di base dei file di schema che descrivono il formato dei messaggi di richiesta e risposta inviati e ricevuti dal connettore Microsoft Teams. Il nome di base dello schema viene impostato automaticamente la prima volta che si esegue il rilevamento per il nodo e si basa sul nome del flusso corrente e sul nome del nodo. Se si imposta questa proprietà manualmente prima di eseguire il rilevamento per la prima volta, verrà utilizzato il valore impostato. Se si ridenominano gli schemi dopo il rilevamento, è necessario modificare questa proprietà in modo che corrisponda al nome di base dello schema utilizzato dagli schemi ridenominati nel progetto. Se si modifica questa proprietà dopo il rilevamento, è necessario ridenominare i nomi dello schema in modo che corrispondano o eseguire nuovamente il rilevamento.

   A seconda dell'azione selezionata durante il rilevamento, la procedura guidata Rilevamento connettore genera uno schema di richiesta e uno schema di risposta o solo uno schema di risposta. Uno schema di richiesta viene generato solo se l'azione e l'oggetto selezionati richiedono un messaggio di richiesta. Lo schema di richiesta generato viene utilizzato per la convalida del messaggio di richiesta. Se l'azione era RETRIEVE o DELETE, solo lo schema di risposta viene restituito dal connettore.

   I file di schema generati vengono aggiunti al progetto e possono essere utilizzati da un nodo Mapping per la trasformazione dei dati di input o di output. Il nome file completo dello schema deriva dal nome di base dello schema (come gen/MyMessageFlow.Microsoft_Teams_Request), con suffisso response.schema.json o request.schema.json. È possibile aprire lo schema facendo clic su Apri schema di richiesta o Apri schema di risposta.

10. Verificare che le impostazioni delle proprietà del nodo " Microsoft Teams Request" siano corrette, quindi salvare il flusso dei messaggi.
11. Nella scheda "Connessione " del nodo "Richiesta " di " Microsoft Teams ", la proprietà "Policy" mostra il nome del criterio che contiene i dettagli dell'identità di sicurezza da utilizzare per la connessione. Il tipo di politica è Microsoft Teams. Per ulteriori informazioni, consultare la politica " Microsoft Teams ".
12. Facoltativo: impostare la proprietà Timeout nella scheda Connessione per specificare il tempo (in secondi) che il nodo attende affinché Microsoft Teams elabori l'operazione.
13. La scheda Filtro del nodo Richiesta dell' Microsoft Teams e contiene proprietà che controllano il modo in cui il flusso dei messaggi seleziona i dati. I valori iniziali di queste proprietà vengono ricavati dai valori impostati per il connettore " Microsoft Teams " nella procedura guidata Connector Discovery, comprese le proprietà relative alle opzioni di filtro e le eventuali condizioni specificate (come descritto al punto 6 ). Se successivamente si ritorna alla procedura guidata Rilevamento connettore e si modificano i valori di qualsiasi proprietà (aggiungendo nuove condizioni, ad esempio), tali aggiornamenti si rifletteranno nelle proprietà impostate sul nodo.

    Le proprietà "Opzioni filtro " determinano su quali oggetti verrà eseguita l'operazione quando viene eseguito il nodo "Richiesta Microsoft Teams ". Le proprietà Limite filtro controllano il numero massimo di elementi da richiamare e l'azione da eseguire se il limite viene superato.

    È possibile modificare i valori facendo clic su Modifica accanto al valore che si desidera modificare nella sezione Opzioni filtro e modificando i valori delle proprietà impostati nella sezione Limite filtro .

    I valori delle proprietà possono essere valori di testo oppure espressioni ESQL o XPATH che vengono risolte in base al contenuto del messaggio trasmesso al nodo " Microsoft Teams Request " durante la sua esecuzione.

14. Nella scheda Richiesta, impostare la proprietà Posizione dati per specificare la posizione nell'albero dei messaggi in arrivo che contiene i dati dell'oggetto da creare in Microsoft Teams. Questi dati costituiscono la richiesta inviata dal nodo " Microsoft Teams " al sistema " Microsoft Teams ".
15. Nella scheda Risultato, impostare la proprietà Posizione dei dati di output per specificare la posizione nell'albero dei messaggi di output che conterrà i dati del record creato in Microsoft Teams.
16. Per impostazione predefinita, i messaggi di richiesta vengono convalidati rispetto allo schema di richiesta generato durante il rilevamento del connettore. È possibile disattivare la convalida delle richieste o modificare le impostazioni di convalida utilizzando le proprietà di convalida del nodo " Microsoft Teams Request ".
17. Salvare il flusso di messaggi.