Find Meeting Times

UiPath.MicrosoftOffice365.Activities.Calendar.FindMeetingTimes

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).

Depois de analisar a disponibilidade do participante, a atividade retorna uma matriz de horários, locais (se aplicável) e participantes que estão 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 (EmptySuggestionReason).

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 - Legado | Windows

Configuração

Propriedades

Comum

• NomeDeExibição — o nome de exibição da atividade. Essa propriedade é compatível com variáveis String e valores formatados de string.

Entrada

• Participantes - Uma matriz de endereços de e-mail dos participantes. Este campo suporta apenas String[] variáveis. Para inserir um endereço de e-mail, inclua-o entre { } e declare-o com " " (por exemplo, {"[e-mail]"}). Para inserir vários endereços de e-mail, inclua todos entre { }, declare cada um com " " e separe cada um por uma vírgula (por exemplo, {"[e-mail]","[e-mail]"}).
• Fim do Intervalo - O fim do período de tempo no qual procurar vagas. Este campo suporta apenas DateTime variáveis. 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.
• Início do intervalo - O início do período de tempo no qual procurar aberturas. Este campo suporta apenas DateTime variáveis. O valor padrão é Hora atual do sistema (não mostrada). Você pode inserir apenas a data ou a data e a hora. Se você inserir apenas uma data, a atividade pesquisará 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.
• Duração da Reunião - A duração desejada para a reunião em minutos. Este campo suporta apenas variáveis inteiras e Int32 . O valor padrão é 30 (não mostrado).
• Fuso horário - O fuso horário no qual interpretar Interval Start e Interval End. O valor padrão é o fuso horário do seu sistema (não exibido). Esta propriedade oferece suporte a variáveis String e valores formatados em string.

Diversos

• Particular — se selecionada, os valores de variáveis e argumentos não são mais registrados no nível Verbose. Este campo aceita valores booleanos.

Opçõ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.
• Organizador obrigatório - Se selecionado, o usuário é um participante obrigatório da reunião. Este campo oferece suporte a valores booleanos.

• Política - especifica as restrições dos participantes a serem observadas durante a pesquisa de horários de reunião disponíveis. Selecione uma das quatro opções:

  • Desconhecido - Não use esse valor, pois ele será obsoleto no futuro. Atualmente, ele se comporta da mesma forma que Work.
  • Trabalho - Os horários sugeridos estão dentro do horário de trabalho dos usuários. O horário padrão é de segunda a sexta, das 8h às 17h.
  • Pessoal - Os horários sugeridos são dentro do horário de trabalho dos usuários e sábado e domingo. O horário padrão é de segunda a domingo, das 8h às 17h.

  • Irrestrito - Os horários sugeridos podem incluir todas as horas de todos os dias da semana. O valor padrão é Irrestrito. As horas de trabalho de um usuário são definidas em sua configuração de calendário e podem ser personalizadas pelo usuário ou administrador.

Saída

• Horários disponíveis - uma variedade de horários de reunião, participantes disponíveis e locais (se aplicável). Este campo suporta apenas MeetingTimeSuggestion[] variáveis. Obrigatório se você planeja usar os dados de saída em atividades subseqüentes. O objeto MeetingTimeSuggestion inclui várias propriedades que você pode usar em outras atividades.
• Razão de sugestão vazia - Uma razão para não retornar nenhuma sugestão de reunião. Os valores possíveis são participantesnão disponíveis, participantes não disponíveis ou desconhecidos, locais não disponíveis, organizador não disponível ou desconhecido. Esta propriedade é 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.

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.