Come utilizzare Google Chatta con IBM App Connect Enterprise

Google Chat è un'applicazione di messaggistica sicura che ha lo scopo di facilitare le comunicazioni all'interno dell'ambiente Google Workspace. Consente di lavorare in modo rapido ed efficiente con il team collaborando tramite testo, creando chat room collaborative, condividendo documenti, fornendo presentazioni e configurando conferenze Web. Utilizza IBM® App Connect Enterprise per integrare la chat d Google e con altre applicazioni. IBM App Connect Enterprise fornisce un nodo " Richiesta chat di Google ", che è possibile utilizzare per connettersi alla chat di Google e inviare richieste per eseguire operazioni su oggetti quali membri, messaggi e spazi.

1. Nel Toolkit di IBM App Connect Enterprise, crea un flusso contenente un nodo "Richiesta chat" di Google.
2. Selezionare il nodo Google Chat Request nel flusso per mostrare 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 rilevamento per avviare la procedura guidata Rilevamento connettore per il connettore Google Chat .
   Viene visualizzata la finestra Rilevamento connettore . Se sono disponibili connessioni (account) Google Chat esistenti, viene visualizzato un elenco di tali connessioni. Se non ci sono connessioni esistenti, lo stato del connettore Google Chat viene visualizzato come Not connected.
   • Se sono disponibili una o più connessioni (account) Google Chat , completare la seguente procedura:
     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 richiamare i membri da Google Chat, fai clic su Members e quindi su Retrieve members.
   • 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 richiamare i membri da Google Chat, fai clic su Members e quindi su Retrieve members.
     2. Fare clic su Connetti.
        Viene visualizzata una finestra in cui immetti i dettagli di connessione per il tuo account Google Chat . Immetti le seguenti informazioni:

        • ID client delle applicazioni : l'identificativo univoco generato dalla console API di Google associata a specifiche richieste di progetto.
        • Segreto client delle applicazioni : il segreto del client delle applicazioni per l'ID client delle applicazioni univoco creato per uno specifico progetto.
        • Token di accesso: il token di accesso generato dall'ID client dell'applicazione e dal segreto client.
        • Token di aggiornamento : il token di aggiornamento generato dall'ID client dell'applicazione e dal segreto client.
        • Nome proxy : selezionare o specificare il nome del proxy che si desidera App Connect utilizzare per inoltrare le chiamate del connettore. Questo campo è richiesto solo se le chiamate devono passare attraverso un proxy. Quando si utilizza il Toolkit " IBM App Connect Enterprise ", il nome del proxy deve essere specificato nel formato: {PolicyProjectName}:HTTPProxyPolicyName

        Per ulteriori informazioni su come accedere o generare questi dati di connessione, consultare la sezione "Come utilizzare IBM App Connect con Google Chat" nella documentazione sulla Continuous Delivery (CD) disponibile all'indirizzo IBM App Connect in containers.

     3. Fare clic su Connetti.
6. Impostare le proprietà del connettore richieste nella procedura guidata.
   Per le azioni di richiamo o aggiornamento, è possibile aggiungere condizioni per il richiamo dei dati facendo clic su Aggiungi condizione e selezionando la proprietà in base alla quale si desidera filtrare.

   Se si aggiungono le condizioni per richiamare o aggiornare le azioni, è possibile facoltativamente utilizzare il filtro delle condizioni per perfezionare le condizioni applicate. Per utilizzare il filtro delle condizioni, uscire dalla procedura guidata Connector Discovery facendo clic sul pulsante Chiudi (X), quindi completare le istruzioni riportate in Utilizzo del filtro delle condizioni.

   Per le azioni di creazione, è possibile utilizzare facoltativamente la modalità avanzata. Nella vista di modifica predefinita per un'azione, alcune applicazioni hanno campi nascosti perché non sono richiesti per i casi di utilizzo generali. Per casi di utilizzo più avanzati, è possibile passare alla modifica in modalità avanzata, che fornisce funzionalità aggiuntive per la modifica dei flussi. Per utilizzare la modalità avanzata, uscire dalla procedura guidata Connector Discovery facendo clic sul pulsante Chiudi (X) e quindi completare le istruzioni riportate in Utilizzo della modalità avanzata.

   È 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 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.
8. Una volta specificate le proprietà nella procedura guidata Rilevamento connettore, fare clic su Salva.
   I valori delle proprietà impostate nella procedura guidata vengono restituiti al nodo " Google ChatRequest" nel Toolkit " IBM App Connect Enterprise ".
9. Torna alla modifica del nodo "Richiesta chat" ( Google ) nel Toolkit " IBM App Connect Enterprise ".
   Le proprietà del connettore che erano state impostate nella procedura guidata di rilevamento del connettore (nel passo 6) sono ora visibili sul nodo Google Chat Request 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 è stata selezionata l'opzione Membri > Recupera membri, nella scheda Base del nodo saranno visibili le seguenti proprietà:

   • Azione - RETRIEVEALL
   • Oggetto - getSpacesBySpaceNameMembers_model

   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à Nome base dello schema specifica il nome base dei file di schema che descrivono il formato dei messaggi di risposta e di richiesta inviati e ricevuti dal connettore Google Chat . 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.Google_Chat_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à sul nodo Google Chat Request siano corrette, quindi salvare il flusso di messaggio.
11. Nella scheda Connessione del nodo Google Richiesta chat , la propriet ... Politica mostra il nome della politica che contiene i dettagli dell'identit ... di sicurezza da utilizzare per la connessione. La politica ha un tipo Google Chat.
    Per ulteriori informazioni, consulta la Google Politica sulla chat.
12. Facoltativo: impostare la proprietà Timeout nella scheda Connessione per specificare il periodo di tempo (in secondi) in cui il nodo attende Google Chat per elaborare l'operazione.
13. La scheda Filter del nodo Google Chat Request contiene proprietà che controllano il modo in cui il flusso di messaggi seleziona i dati. I valori iniziali di queste proprietà vengono presi dai valori delle proprietà impostati per il connettore Google Chat nella procedura guidata di rilevamento del connettore, incluse le proprietà delle 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à, tali aggiornamenti si rifletteranno nelle proprietà impostate sul nodo.

    Le proprietà Opzioni filtro controllano gli oggetti da utilizzare quando viene eseguito il nodo Google Chat Request . Le proprietà Limite filtro controllano il numero massimo di elementi da richiamare e l'azione da intraprendere 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 o espressioni ESQL o XPATH risolte dal contenuto del messaggio passato al nodo Google Chat Request durante l'esecuzione.

14. Nella scheda Richiesta , impostare la proprietà Ubicazione dati per specificare l'ubicazione nella struttura ad albero del messaggio in entrata che contiene i dati dell'oggetto da creare in Google Chat. Questi dati formano la richiesta inviata dal nodo Google Chat Request a Google Chat.
15. Nella scheda Risultato , impostare la proprietà Ubicazione dati di output per specificare la posizione nella struttura ad albero del messaggio di output che conterrà i dati del record creato in Google Chat.
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 della richiesta o modificare le impostazioni di convalida utilizzando le proprietà Convalida del nodo Google Chat Request .
17. Salvare il flusso di messaggi.