Zoommodule gebruiken

Zoom module maakt het mogelijk te werken met Zoom API (https://marketplace.zoom.us/docs/guides/).

Installatie zoommodule

API Key en Secret Key van uw Zoom applicatie moeten eerst worden opgehaald(https://marketplace.zoom.us/develop/create?source=devdocs). Als u de link volgt, ziet u verschillende soorten Zoom apps voor selectie.

Zoom's app API Key en Secret Key worden getoond na de selectie van het type app.

Meeting en Recurrence Gegevensmodellen

Wanneer u de Zoom module, worden in het project ook twee virtuele gegevensmodellen aangemaakt: Meeting en Recurrence. Het eerste verwijst naar het videogespreksobject zelf, en Recurrence is verantwoordelijk voor de regelmaat (herhaling) van deze videogesprek. De volgende BP's helpen bij het aanmaken en gebruiken van deze gegevensmodellen:

• Make Zoom Meeting - creëert een object van Meeting datamodeltype:
  • Join_url [string] - vergadering link;
  • start_time [datetime] - starttijd van de vergadering;
  • Status [string] - status van de vergadering;
  • Type [enum] - type vergadering
    • Instant - ongeplande, eenmalige vergadering
    • Scheduled - geplande vergadering
    • Recurring with no fixed time - terugkerende vergadering zonder vaste tijd
    • Recurring with fixed time - terugkerend met vaste tijd
  • Meeting_id [integer] - identificatie van de vergadering;
  • Agenda [string] - info over de agenda van de vergadering;
  • Topic [string] - onderwerp van de vergadering;
  • Recurrence [recurrence type object] - object van Recurrence datamodel type;
  • Password [string] - wachtwoord van de vergadering;

• Expand Zoom Meeting - breidt een object van Meeting datamodeltype;
  • Join_url [string] - link van de vergadering;
  • start_time [datetime] - starttijd van de vergadering;
  • Status [string] - status van de vergadering;
  • Type [enum] - type vergadering
    • Instant - ongeplande, eenmalige vergadering
    • Scheduled - geplande vergadering
    • Recurring with no fixed time - terugkerende vergadering zonder vast tijdstip
    • Recurring with fixed time - terugkerende met vaste tijd
  • Meeting_id [integer] - identificatie van de vergadering
  • Agenda [string] - info over de agenda van de vergadering;
  • Topic [string] - onderwerp van de vergadering;
  • Recurrence [recurrence type object] - object van Recurrence datamodel type;
  • Password [string] - wachtwoord van de vergadering;

• Make Zoom Recurrence - creëert een object van Recurrence datamodel type;
  • Type [enum] - type herhaling
    • Daily
    • Weekly
    • Monthly
  • Ends_time [integer] - het aantal keren dat de terugkerende vergadering zal plaatsvinden voordat ze wordt geannuleerd, tussen een waarde van 1 en 50. U kunt deze sleutel niet gebruiken met de end_date_time sleutel.
  • Monthly_day [integer] - alleen vereist voor maandelijks terugkerende vergaderingen. De dag van de maand waarop een terugkerende vergadering plaatsvindt, tussen 1 en 31.
  • Weekly_days [enum] - alleen vereist voor wekelijkse terugkerende vergaderingen (1 - maandag, 2 - dinsdag, ... , 7 - zondag).
  • Repeat_interval [integer] - het herhalingsinterval van de vergadering. Voor een dagelijks interval, maximaal 90 dagen. Voor een wekelijkse interval, maximaal 12 weken.
  • End_date_time [datetime] - de einddatum en -tijd van de terugkerende vergadering voordat deze wordt geannuleerd, in UTC formaat. U kunt deze sleutel niet gebruiken met de end_times sleutel.

• Expand Zoom Recurrence - breidt een object uit van Recurrence datamodel type;
  • Type [enum] - type herhaling
    • Daily
    • Weekly
    • Monthly
  • Ends_time [integer] - het aantal keren dat de terugkerende vergadering zal plaatsvinden vooraleer ze geannuleerd wordt, tussen een waarde van 1 en 50. U kunt deze sleutel niet gebruiken met de end_date_time sleutel.
  • Monthly_day [integer] - alleen vereist voor maandelijks terugkerende vergaderingen. De dag van de maand waarop een terugkerende vergadering plaatsvindt, tussen 1 en 31.
  • Weekly_days [enum] - alleen vereist voor wekelijkse terugkerende vergaderingen (1 - maandag, 2 - dinsdag, ... , 7 - zondag).
  • Repeat_interval [integer] - het herhalingsinterval van de vergadering. Voor een dagelijks interval, maximaal 90 dagen. Voor een wekelijkse interval, maximaal 12 weken.
  • End_date_time [datetime] - de einddatum en -tijd van de terugkerende vergadering voordat deze wordt geannuleerd, in UTC formaat. U kunt deze sleutel niet gebruiken met de end_times sleutel.

Bedrijfsprocessen die werken met Zoom Module

Vooraf geïnstalleerde Zoom module bedrijfsprocessen zijn alleen beschikbaar voor de applicatie backend:

• Zoom: Get meeting - krijgt vergaderingsobject met de gegeven identifier:
  • Meeting_id [integer] - meeting identifier;

• Zoom: Delete meeting - verwijdert een vergaderingsrecord uit de DB met de gegeven identifier;
  • Meeting_id [integer] (verplicht) - vergadering identifier;

• Zoom: Update meeting - werkt het vergaderingsobject bij in de DB met de gegeven identifier:
  • Meeting_id [integer] (vereist) - identificatiecode vergadering;
  • Topic [string] - onderwerp van de vergadering;
  • Type [enum] - type vergadering
    • Instant - ongeplande, eenmalige vergadering
    • Scheduled - geplande vergadering
    • Recurring with no fixed time - terugkerende vergadering zonder vast tijdstip
    • Recurring with fixed time - terugkerende met vaste tijd
  • start_time [datetime] - starttijd van de vergadering
  • Join_url [string] - link van de vergadering;
  • Password [string] - wachtwoord voor de vergadering;
  • Agenda [string] - info over de agenda van de vergadering;
  • Recurrence [recurrence type object] - object van Recurrence datamodel type;

• Zoom: Create Meeting - creëert een object van Meeting datamodel type:
  • Type [enum] - type vergadering
    • Instant - ongeplande, eenmalige vergadering
    • Scheduled - geplande vergadering
    • Recurring with no fixed time - terugkerende vergadering zonder vast tijdstip
    • Recurring with fixed time - terugkerende met vaste tijd
  • Password [string] - wachtwoord voor de vergadering;
  • Agenda [string] - info over de agenda van de vergadering;
  • Recurrence [recurrence type object] - object van Recurrence datamodel type;
  • User_id [string] (verplicht) - gebruiker's ID of e-mailadres van de gebruiker.

• Zoom: List meetings - gebruik dit API om de geplande vergaderingen van een gebruiker (meeting host) op te sommen. De gebruiker wordt gedefinieerd met zijn API_KEY;
  • Page_size [integer] - het aantal geretourneerde records binnen een enkele API oproep. Is standaard ingesteld op 30.
  • Page_number [integer] - het paginanummer van de huidige pagina in de geretourneerde records. Is standaard ingesteld op 1.

Gebruiksvoorbeeld

Laten we eens kijken naar een voorbeeld van het genereren van een Zoom vergadering link op de knop klikken. Om de bedrijfsprocessen van de module in de front-end van de applicatie te gebruiken, is de eerste stap om de Endpoint link genereren (Zoom: Create meeting).

1. Maak een nieuwe groep aan in de Endpoints sectie.
2. Wanneer de groep is aangemaakt moet u een nieuwe Endpoint. Zoom: Create meeting bedrijfsproces worden beschouwd als een POST type verzoek.
3. In het webapplicatie bedrijfsproces kan het nieuw aangemaakte eindpunt worden gebruikt zoals op het onderstaande voorbeeld. Hier wordt een link gegenereerd en verstrekt als een Label eigenschap van de Label component wanneer op de knop wordt geklikt (onClick).

Het resultaat wordt hieronder getoond: