Find Meeting Times

UiPath.MicrosoftOffice365.Activities.Calendar.FindMeetingTimes

Beschreibung

Verwendet die Microsoft Graph-API zum Suchen von Besprechungszeiten , um Besprechungszeiten und -orte basierend auf der Verfügbarkeit von Organisatoren und Teilnehmern (Attendees) und Ihrem angegebenen Zeitraum, in dem die Besprechung stattfinden soll (IntervalStart, IntervalEndund MeetingDuration) vorzuschlagen.

Nach der Analyse der Verfügbarkeit des Teilnehmers gibt die Aktivität ein Array von Zeiten, Orten (falls zutreffend) und Teilnehmern zurück, die während Ihres angegebenen Zeitraums verfügbar sind (AvailableTimeslots). Wenn die Aktivität keine verfügbaren Zeitfenster findet, gibt sie einen Grund zurück, damit Sie Ihren Bereich nach Bedarf ändern können (EmptySuggestionReason).

Hinweis: Find Meeting Times kann nicht mit der ApplicationIdAndSecret -Authentifizierung verwendet werden, da die FindMeetingTimes- API von Microsoft Graph keine Anwendungsberechtigungen unterstützt.

Scopes

Diese Aktivität erfordert die folgenden Scopes:

• Calendars.ReadWrite

ODER

• Calendars.ReadWrite.Shared

Projektkompatibilität

Windows – Legacy | Windows

Konfiguration

Eigenschaften

Allgemein

• AnzeigeName (DisplayName) - Der Anzeigename der Aktivität. Diese Eigenschaft unterstützt String-Variablen und stringformatierte Werte.

Eingabe

• Teilnehmer – Ein Array von E-Mail-Adressen der Teilnehmer. Dieses Feld unterstützt nur String[] Variablen. Um eine E-Mail-Adresse einzugeben, fügen Sie sie zwischen { } ein und deklarieren Sie sie mit " " (z. B. {"[e-mail]"}). Um mehrere E-Mail-Adressen einzugeben, fügen Sie alle zwischen { } ein, deklarieren Sie jede mit " " und trennen Sie sie durch ein Komma (z. B. {"[e-mail]","[e-mail]"}).
• Intervallende - Das Ende des Zeitraums, in dem nach Öffnungen gesucht werden soll. Dieses Feld unterstützt nur DateTime Variablen. Der Standardwert ist Heute um Mitternacht (nicht angezeigt). Sie können nur das Datum oder das Datum und die Uhrzeit eingeben. Wenn Sie nur ein Datum eingeben, ist die Suche auf die in den Teilnehmerkalendern angegebenen Arbeitszeiten beschränkt.
• Intervallstart – Der Anfang des Zeitraums, in dem nach Öffnungen gesucht werden soll. Dieses Feld unterstützt nur DateTime Variablen. Der Standardwert ist Aktuelle Systemzeit (nicht angezeigt). Sie können nur das Datum oder das Datum und die Uhrzeit eingeben. Wenn Sie nur ein Datum eingeben, sucht die Aktivität nach Zeiten, wie in der Eigenschaft „Richtlinie“ angegeben.
  Hinweis:

  • Ihre DateTime -Werte müssen als TT/MM/JJJJ oder TT/MM/JJJJ Stunde:Minute:Sekunden formatiert sein (z. B. 31.10.2019 12:00:00).
  • Das DateTime -Format wird automatisch korrigiert, wenn Sie genügend Details eingeben. Wenn Sie beispielsweise den 31.10.19 15:00 Uhr eingeben, wird die automatische Korrektur auf 31.10.2019 15:00:00 vorgenommen .
• Besprechungsdauer - Die gewünschte Dauer für die Besprechung in Minuten. Dieses Feld unterstützt nur Integer- und Int32 -Variablen. Der Standardwert ist 30 (nicht angezeigt).
• Zeitzone – Die Zeitzone, in der Interval Start und Interval Endinterpretiert werden sollen. Der Standardwert ist die Zeitzone Ihres Systems (nicht angezeigt). Diese Eigenschaft unterstützt String -Variablen und zeichenfolgenformatierte Werte.

Sonstiges

• Privat (Private) - Bei Auswahl werden die Werte von Variablen und Argumenten nicht mehr auf der Stufe Verbose protokolliert. Dieses Feld unterstützt nur boolesche Werte.

Optionen

• Standorte – Ein Array von Räumen oder Standorten, die durch ihre Anzeigenamen angegeben werden sollen. Wenn keine Speicherorte verfügbar sind, wird ein anderer ausgewählt. Dieses Feld unterstützt nur String[] Variablen. Wenn die aufgelisteten Besprechungsräume nicht verfügbar sind, gibt die Aktivität keine Vorschläge zur Besprechungszeit zurück.
• Organisator erforderlich – Wenn diese Option ausgewählt ist, ist der Benutzer ein erforderlicher Teilnehmer für das Meeting. Dieses Feld unterstützt boolesche Werte.

• Richtlinie – Gibt die Einschränkungen der Teilnehmer an, die bei der Suche nach verfügbaren Besprechungszeiten eingehalten werden müssen. Wählen Sie eine der vier Optionen aus:

  • Unbekannt – Verwenden Sie diesen Wert nicht, da er in Zukunft veraltet ist. Derzeit verhält es sich wie Work.
  • Arbeit – Die vorgeschlagenen Zeiten liegen innerhalb der Arbeitszeiten der Benutzer. Die Standardzeiten sind Montag bis Freitag von 8:00 bis 17:00 Uhr.
  • Persönlich – Die vorgeschlagenen Zeiten liegen innerhalb der Arbeitszeiten der Benutzer sowie Samstag und Sonntag. Standardzeiten sind Mo-So, 8:00 bis 17:00 Uhr.

  • Uneingeschränkt – Vorgeschlagene Zeiten können alle Stunden aller Wochentage umfassen. Der Standardwert ist Unrestricted. Die Arbeitszeiten eines Benutzers werden in seiner Kalenderkonfiguration definiert und können vom Benutzer oder Administrator angepasst werden.

Ausgabe

• Verfügbare Zeitfenster – Ein Array von Besprechungszeiten, verfügbaren Teilnehmern und Standorten (falls zutreffend). Dieses Feld unterstützt nur MeetingTimeSuggestion[] Variablen. Erforderlich, wenn Sie die Ausgabedaten in nachfolgenden Aktivitäten verwenden möchten. Das MeetingTimeSuggestion -Objekt enthält mehrere Eigenschaften , die Sie in anderen Aktivitäten verwenden können.
• Leerer Vorschlagsgrund – Ein Grund, warum keine Besprechungsvorschläge zurückgegeben werden. Die möglichen Werte sind AttendeesUnavailable, AttendeesUnavailableOrUnknown, LocationsUnavailable, OrganizerUnavailable oder Unbekannt. Diese Eigenschaft ist eine leere Zeichenfolge, wenn die Eigenschaft Verfügbare Zeitfenster keine Besprechungsvorschläge enthält. Sie können auch MeetingTimeSuggestion.SuggestionReason verwenden, um den Grund für den Vorschlag anzuzeigen.

Wie es funktioniert

Die folgenden Schritte und das folgende Nachrichtensequenzdiagramm sind ein Beispiel dafür, wie die Aktivität von der Entwurfszeit (d. h. den Aktivitätsabhängigkeiten und Eingabe-/Ausgabeeigenschaften) bis zur Laufzeit funktioniert.

1. Führen Sie die Schritte aus.
2. Fügen Sie die Aktivität Microsoft Office 365 Scope zu Ihrem Projekt hinzu.
3. Fügen Sie die Aktivität Find Meeting Times innerhalb der Aktivität Microsoft Office 365 Scope hinzu.
4. Geben Sie Werte für die Eingabeeigenschaften ein.
5. Erstellen und geben Sie die Variablen MeetingTimeSuggestion[] und String für Ihre Output-Eigenschaft ein.

6. Führen Sie die Aktivität aus.

   • Ihre Eingabeeigenschaftswerte werden an die FindMeetingTimes-API gesendet.
   • Die API gibt die Werte MeetingTimeSuggestion[] und String an Ihre Ausgabeeigenschaftsvariable zurück.