Find Meeting Times

A atividade Find Meeting Times, que usa a API Find Meeting Times do Microsoft Graph, para sugerir horários e locais de reunião com base no organizador e no participante no Microsoft 365.

UiPath.MicrosoftOffice365.Activities.Calendar.FindMeetingTimesConnections

Description

Usa a API Find Meeting Times do Microsoft Graph para sugerir horários e locais de reunião com base na disponibilidade do organizador e do participante (Attendees) e seu intervalo de tempo especificado em que você deseja que a reunião ocorra (IntervalStart, IntervalEnd e MeetingDuration).

Depois de analisar a disponibilidade dos participantes, a atividade retorna uma matriz de horários, locais (se aplicável) e participantes que estão disponíveis durante o intervalo especificado (DisponívelTimeslots). Se a atividade não encontrar nenhum slot de tempo disponível, ela retornará um motivo para que você possa alterar seu intervalo conforme necessário (EmptySuggestionReason).

Observação:

Find Meeting Times não pode ser usado com a autenticação ApplicationIdAndSecret porque a API FindMeetingTimes do Microsoft Graph não é compatível com permissões de aplicativos.

Escopos

Essa atividade requer os seguintes escopos:

• Calendários.ReadWrite

OU

• Calendars.ReadWrite.Shared

Compatibilidade do projeto

Windows | Multiplataforma

• Microsoft Outlook 365 - A conexão para a conta do Microsoft 365 a ser usada na atividade.
• Endereço de email dos participantes — Uma matriz de endereços de email dos participantes. Este campo é compatível apenas com variáveis String[] . Para inserir um endereço de email, inclua-o entre { } e declare-o com " " (por exemplo, {"[e-mail]"}). Para inserir vários endereços de email, inclua tudo entre { }, declare cada um com " " e separe cada um por uma vírgula (por exemplo, {"[e-mail]","[e-mail]"}).
• Intervalo de início - O início do período de tempo para procurar vagas. Este campo é compatível apenas com variáveis DateTime . O valor padrão é Hora do sistema atual (não mostrado). Você pode inserir apenas a data ou a data e a hora. Se você inserir apenas uma data, a atividade pesquisa os horários conforme especificado na propriedade Política .
  Observação:

  • Your DateTime values must be formatted as MM/DD/YYYY or MM/DD/YYYY Hour:Minute:Seconds (e.g., 10/31/2019 12:00:00).
  • The DateTime format is auto-corrected if you enter enough details. For example, if you enter 10/31/19 3pm it auto-corrects to 10/31/2019 15:00:00.
• Intervalo de término - O final do período de tempo para procurar vagas. Este campo é compatível apenas com variáveis DateTime . O valor padrão é Hoje à meia-noite (não mostrado). Você pode inserir apenas a data ou a data e a hora. Se você inserir apenas uma data, a pesquisa será limitada às horas de trabalho especificadas pelos calendários dos participantes.
• Fuso horário — o fuso horário no qual interpretar o Início do intervalo e o Término do intervalo. O valor padrão é o fuso horário do seu sistema (não exibido). Essa propriedade é compatível com variáveis String e valores formatados de string.
• Duração da reunião - A duração desejada para a reunião em minutos. Esse campo é compatível apenas com números inteiros e variáveis Int32 . O valor padrão é 30 (não mostrado).

Configuração

Painel de Propriedades

Entrada

• Organizador obrigatório — especifica se o organizador é um participante obrigatório. Ele é definido como True por padrão.
• Restrições — as restrições que os participantes devem seguir ao procurar horários de reunião disponíveis. Selecione uma das seguintes opções:
  • Trabalho - As sugestões de reunião são limitadas ao horário de trabalho do usuário, conforme definido no calendário dele. O horário padrão é de segunda a sexta-feira, das 8h às 17h.
  • Pessoal - As sugestões de reunião abrangem toda a semana, com base nas configurações do seu calendário. O horário padrão é de segunda a domingo, das 8h às 17h.
  • Sem restrição — as sugestões de reunião estão disponíveis a qualquer hora, em qualquer dia e sem limitações.
• Locations - An array of rooms or locations, given by their display names, to search. If no locations are available, another is selected. This field supports only String[] variables. If the listed meeting rooms are not available, the activity does not return meeting time suggestions.

Saída

• Motivo da sugestão vazia - Um motivo para não retornar qualquer sugestão de reunião. Os valores possíveis são attendeesUnavailable, attendeesUnavailableOrUnknown, locationsUnavailable, organizerUnavailable ou unknown. Esta propriedade será uma string vazia se a propriedade Horários disponíveis não incluir nenhuma sugestão de reunião. Você também pode usar MeetingTimeSuggestion.SuggestionReason para ver o motivo da sugestão.
• Horários disponíveis — uma matriz de horários de reunião, participantes disponíveis e, se aplicável, locais. Este campo é compatível apenas com variáveis MeetingTimeSuggestion[] . O campo é necessário se você planeja usar os dados de saída em atividades subsequentes. O objeto MeetingTimeSuggestion inclui várias propriedades que você pode usar em outras atividades.

Como funciona

As etapas a seguir e o diagrama de sequência de mensagens são um exemplo de como a atividade funciona desde o tempo de design (ou seja, as dependências da atividade e as propriedades de entrada/saída) até o tempo de execução.

1. Conclua as etapas.
2. Adicione a atividade Microsoft Office 365 Scope ao seu projeto.
3. Add the Find Meeting Times activity inside the Microsoft Office 365 Scope activity.
4. Insira valores para as propriedades de entrada.
5. Crie e insira variáveis MeetingTimeSuggestion[] e String para sua propriedade Saída .
6. Execute a atividade.
   • Seus valores de propriedade de entrada são enviados para a API FindMeetingTimes .
   • A API retorna os valores MeetingTimeSuggestion[] e String para sua variável de propriedade de saída.