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.

Nachdem die Verfügbarkeit der Teilnehmer analysiert wurde, gibt die Aktivität ein Array von Zeiten, Orten (falls zutreffend) und Teilnehmern zurück, die während des angegebenen Bereichs verfügbar sind (AvailableTimeslots). Wenn die Aktivität keine verfügbaren Zeitfenster findet, wird ein Grund zurückgegeben, sodass 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

• BeiFehlerFortsetzen – Gibt an, dass die Ausführung der verbleibenden Aktivitäten fortgesetzt wird, auch wenn die aktuelle Aktivität nicht ausgeführt werden konnte.
• 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.

Konfiguration für plattformübergreifend

Eigenschaften

Eingabe

• Organisator erforderlich – Gibt an, ob der Organisator ein Pflichtteilnehmer ist. Ist standardmäßig auf True festgelegt.
• Einschränkungen – Die Einschränkungen, die Teilnehmer bei der Suche nach verfügbaren Besprechungszeiten befolgen müssen. Wählen Sie eine der folgenden Optionen aus:
  • Arbeit – Besprechungsvorschläge sind auf die Arbeitsstunden des Benutzers beschränkt, die in dessen Kalender festgelegt sind. Die Standardzeiten sind Montag bis Freitag von 8:00 bis 17:00 Uhr.
  • Persönlich – Besprechungsvorschläge erstrecken sich basierend auf Ihren Kalendereinstellungen über die gesamte Woche. Die Standardzeiten sind Montag bis Sonntag von 8:00 bis 17:00 Uhr.
  • Uneingeschränkt – Besprechungsvorschläge sind jederzeit und an jedem Tag ohne Einschränkungen verfügbar.
• 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.

Ausgabe

• Grund für leeren Vorschlag – Ein Grund dafür, dass keine Meeting-Vorschläge zurückgegeben werden. Mögliche Werte sind attendeesUnavailable, attendeesUnavailableOrUnknown, locationsUnavailable, organizerUnavailable, oder unknown. 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 des Vorschlags anzuzeigen.
• Verfügbare Zeitfenster – Ein Array von Besprechungszeiten, verfügbaren Teilnehmern und ggf. Orten. Dieses Feld unterstützt nur MeetingTimeSuggestion[] -Variablen. Das Feld ist 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.

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.