Find Meeting Times

UiPath.MicrosoftOffice365.Activities.Calendar.FindMeetingTimesConnections

Description

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

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

Observação: Find Meeting Times não pode ser usado com autenticação ApplicationIdAndSecret porque a API FindMeetingTimes do Microsoft Graph não oferece suporte a 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 vírgula (por exemplo, {"[e-mail]","[e-mail]"}).
• Intervalo de início - O início do período de tempo no qual pesquisar vagas. Este campo é compatível apenas com variáveis DateTime . O valor padrão é a Hora atual do sistema (não mostrado). É possível inserir apenas a data ou a data e o horário. Se você inserir apenas uma data, a atividade pesquisa os horários conforme especificado na propriedade Política .
  Observação:

  • Seus valores DateTime devem ser formatados como MM/DD/AAAA ou MM/DD/AAAA Hora:Minuto:Segundos (por exemplo, 31/10/2019 12:00:00).
  • O formato DateTime é corrigido automaticamente se você inserir detalhes suficientes. Por exemplo, se você inserir 31/10/19 15:00 , ele será corrigido automaticamente para 31/10/2019 15:00:00.
• Intervalo de término - O final do período de tempo no qual pesquisar vagas. Este campo é compatível apenas com variáveis DateTime . O valor padrão é Hoje à meia-noite (não mostrado). É possível inserir apenas a data ou a data e o horário. 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 Fim 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

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ões são limitadas às horas de trabalho do usuário, conforme definido em seu calendário. O horário padrão é de segunda a sexta-feira, das 8h às 17h.
  • Pessoal - As sugestões de reuniões abrangem a semana inteira com base nas configurações do seu calendário. O horário padrão é de segunda a domingo, das 8h às 17h.
  • Irrestrito - As sugestões de reuniões estão disponíveis a qualquer hora e em qualquer dia, sem limitações.
• Locais - Uma matriz de quartos ou locais, fornecidos por seus nomes de exibição, para pesquisar. Se nenhum local estiver disponível, outro será selecionado. Este campo suporta apenas String[] variáveis. Se as salas de reunião listadas não estiverem disponíveis, a atividade não retornará sugestões de horário de reunião.

Saída

• Motivo da Sugestão Vazia - Uma razão para não retornar qualquer sugestão de reunião. Os valores possíveis são attendeesUnavailable, attendeesUnavailableOrUnknown, locationsUnavailable, organizerUnavailable ou unknown. Esta propriedade é uma string vazia se a propriedade Horários disponíveis não incluir qualquer 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 é obrigató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. Adicione a atividade Find Meeting Times dentro da atividade Microsoft Office 365 Scope.
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.