Come utilizzare il modulo Zoom

Zoom permette di lavorare con Zoom API (https://marketplace.zoom.us/docs/guides/).

Installazione del modulo Zoom

API Key e Secret Key dell'applicazione Zoom dell'applicazione devono essere prima recuperati(https://marketplace.zoom.us/develop/create?source=devdocs). Seguendo il link si vedranno diversi tipi di Zoom applicazioni da selezionare.

ZoomL'applicazione API Key e Secret Key verranno visualizzati dopo la selezione del tipo di app.

Meeting e Recurrence Modelli di dati

Quando si installa il modulo Zoom vengono creati anche due modelli di dati virtuali nel progetto: Meeting e Recurrence. Il primo si riferisce all'oggetto videochiamata e si occupa della regolarità (ricorrenza) di questo incontro video. Recurrence è responsabile della regolarità (ricorrenza) di questo incontro video. I seguenti BP sono ausiliari nella creazione e nell'uso di questi modelli di dati:

• Make Zoom Meeting - crea un oggetto di Meeting di tipo modello di dati:
  • Join_url [string] - collegamento alla riunione;
  • start_time [datetime] - orario di inizio della riunione;
  • Status [string] - stato della riunione;
  • Type [enum] - tipo di riunione
    • Instant - riunione non programmata, una tantum
    • Scheduled - riunione programmata
    • Recurring with no fixed time - riunione ricorrente senza orario fisso
    • Recurring with fixed time - ricorrente con orario fisso
  • Meeting_id [integer] - identificatore della riunione;
  • Agenda [string] - informazioni sull'agenda della riunione;
  • Topic [string] - argomento della riunione;
  • Recurrence [recurrence tipo di oggetto] - oggetto di Recurrence tipo di modello di dati;
  • Password [string] - password della riunione;

• Expand Zoom Meeting - espande un oggetto di tipo Meeting tipo di modello di dati;
  • Join_url [string] - link alla riunione;
  • start_time [datetime] - orario di inizio della riunione;
  • Status [string] - stato della riunione;
  • Type [enum] - tipo di riunione
    • Instant - riunione unica non programmata
    • Scheduled - riunione programmata
    • Recurring with no fixed time - riunione ricorrente senza orario fisso
    • Recurring with fixed time - ricorrente con orario fisso
  • Meeting_id [integer] - identificativo della riunione;
  • Agenda [string] - informazioni sull'agenda della riunione;
  • Topic [string] - argomento della riunione;
  • Recurrence [recurrence tipo di oggetto] - oggetto di Recurrence tipo di modello di dati;
  • Password [string] - password della riunione;

• Make Zoom Recurrence - crea un oggetto di tipo Recurrence tipo di modello di dati;
  • Type [enum] - tipo di ricorrenza
    • Daily
    • Weekly
    • Monthly
  • Ends_time [integer] - il numero di volte che la riunione ricorrente si verificherà prima di essere annullata, con un valore compreso tra 1 e 50. Non è possibile utilizzare questo tasto con il tasto end_date_time chiave.
  • Monthly_day [integer] - richiesto solo per le riunioni ricorrenti mensili. Il giorno del mese in cui si svolge una riunione ricorrente, compreso tra 1 e 31.
  • Weekly_days [enum] - richiesto solo per le riunioni ricorrenti settimanali (1 - lunedì, 2 - martedì, ... , 7 - domenica).
  • Repeat_interval [integer] - intervallo di ripetizione della riunione. Per un intervallo giornaliero, un massimo di 90 giorni. Per un intervallo settimanale, un massimo di 12 settimane.
  • End_date_time [datetime] - la data e l'ora finale della riunione ricorrente prima della sua cancellazione, in formato UTC. Non è possibile utilizzare questo tasto con il tasto end_times chiave.

• Expand Zoom Recurrence - espande un oggetto di tipo Recurrence tipo di modello di dati;
  • Type [enum] - tipo di ricorrenza.
    • Daily
    • Weekly
    • Monthly
  • Ends_time [integer] - il numero di volte in cui la riunione ricorrente si verificherà prima di essere annullata, con un valore compreso tra 1 e 50. Non è possibile utilizzare questo tasto con il tasto end_date_time chiave.
  • Monthly_day [integer] - richiesto solo per le riunioni ricorrenti mensili. Il giorno del mese in cui si svolge una riunione ricorrente, compreso tra 1 e 31.
  • Weekly_days [enum] - richiesto solo per le riunioni ricorrenti settimanali (1 - lunedì, 2 - martedì, ... , 7 - domenica).
  • Repeat_interval [integer] - intervallo di ripetizione della riunione. Per un intervallo giornaliero, un massimo di 90 giorni. Per un intervallo settimanale, un massimo di 12 settimane.
  • End_date_time [datetime] - la data e l'ora finale della riunione ricorrente prima della sua cancellazione, in formato UTC. Non è possibile utilizzare questo tasto con il tasto end_times chiave.

Processi aziendali che lavorano con Zoom Module

I processi aziendali preinstallati Zoom I processi di business del modulo preinstallato sono disponibili solo per il backend dell'applicazione:

• Zoom: Get meeting - ottiene l'oggetto riunione con l'identificatore dato:
  • Meeting_id [integer] - identificatore della riunione;

• Zoom: Delete meeting - elimina un record di riunione dalla cartella DB con l'identificatore dato;
  • Meeting_id [integer] (obbligatorio) - identificatore della riunione;

• Zoom: Update meeting - aggiorna l'oggetto riunione nella cartella DB con l'identificatore dato:
  • Meeting_id [integer] (obbligatorio) - identificativo della riunione;
  • Topic [string] - argomento della riunione;
  • Type [enum] - tipo di riunione
    • Instant - riunione non programmata, una tantum
    • Scheduled - riunione programmata
    • Recurring with no fixed time - riunione ricorrente senza orario fisso
    • Recurring with fixed time - ricorrente con orario fisso
  • start_time [datetime] - orario di inizio della riunione;
  • Join_url [string] - link della riunione;
  • Password [string] - password della riunione;
  • Agenda [string] - informazioni sull'agenda della riunione;
  • Recurrence [recurrence tipo di oggetto] - oggetto di Recurrence tipo di modello di dati;

• Zoom: Create Meeting - crea un oggetto di Meeting tipo di modello di dati:
  • Type [enum] - tipo di riunione
    • Instant - riunione non programmata, una tantum
    • Scheduled - riunione programmata
    • Recurring with no fixed time - riunione ricorrente senza orario fisso
    • Recurring with fixed time - ricorrente con orario fisso
  • Password [string] - password della riunione;
  • Agenda [string] - informazioni sull'ordine del giorno della riunione;
  • Recurrence [recurrence tipo di oggetto] - oggetto di tipo modello di dati; [ tipo di oggetto] - oggetto di tipo modello di dati. Recurrence tipo di modello di dati;
  • User_id [string] (obbligatorio) - indirizzo dell'utente o dell'email. ID o indirizzo e-mail dell'utente.

• Zoom: List meetings - utilizzare questo API per elencare le riunioni programmate di un utente (organizzatore di riunioni). L'utente è definito con il suo API_KEY;
  • Page_size [integer] - numero di record restituiti in una singola chiamata. API chiamata. È impostato a 30 per impostazione predefinita.
  • Page_number [integer] - il numero di pagina della pagina corrente nei record restituiti. È impostato su 1 per impostazione predefinita.

Esempio di utilizzo

Vediamo un esempio di generazione di un link a un Zoom un link a una riunione al clic del pulsante. Per utilizzare i processi di business del modulo nel front-end dell'applicazione, il primo passo consiste nell'impostare il parametro Endpoint per creare la generazione del collegamento (Zoom: Create meeting).

1. Creare un nuovo gruppo nella sezione Endpoints sezione.
2. Quando il gruppo viene creato, è necessario creare un nuovo Endpoint. Zoom: Create meeting Il processo aziendale deve essere considerato come un POST tipo di richiesta.
3. Nel processo aziendale dell'applicazione web, l'endpoint appena creato può essere utilizzato come nell'esempio seguente. In questo caso, viene generato un collegamento e fornito come proprietà Label del componente Label quando il pulsante viene cliccato (onClick).

Il risultato è mostrato di seguito: