Find Meeting Times

UiPath.MicrosoftOffice365.Activities.Calendar.FindMeetingTimes

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 - Legacy | 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 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]"}).
• Interval End - The end of the time period in which to search for openings. This field supports only DateTime variables. The default value is Today at midnight (not shown). You may enter the date only or the date and time. If you enter a date only, the search is limited to the working hours specified by the attendee calendars.
• Interval Start - The beginning of the time period in which to search for openings. This field supports only DateTime variables. The default value is Current system time (not shown). You may enter the date only or the date and time. If you enter a date only, the activity searches for times as specified in the Policy property.
  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.
• Meeting Duration - The desired duration for the meeting in minutes. This field supports only integer and Int32 variables. The default value is 30 (not shown).
• 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.

Diversos

• ContinueOnError - If set, continue executing the remaining activities even if the current activity has failed.
• Particular — se selecionada, os valores de variáveis e argumentos não são mais registrados no nível Verbose. Esse campo aceita valores Booleanos.

Opçõ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.
• Organizador obrigatório — se estiver selecionado, o usuário é um participante obrigatório para a reunião. Esse campo aceita valores Booleanos.
• Policy - Specifies the attendees' restrictions to abide by while searching for available meeting times. Select one of the four options:
  • Unknown - Do not use this value as it will be deprecated in the future. Currently, it behaves as same as Work.
  • Work - Suggested times are within the users' work hours. Default hours are Mon-Fri, 8am to 5pm.
  • Personal - Suggested times are within the users' work hours and Saturday and Sunday. Default hours are Mon-Sun, 8am to 5pm.
  • Sem restrição — os horários sugeridos podem incluir todas as horas de todos os dias da semana. O valor padrão é Sem restrição. O horário de trabalho de um usuário é definido em sua configuração de calendário e pode ser personalizado pelo usuário ou administrador.

Saída

• Horários disponíveis — uma matriz de horários de reunião, participantes disponíveis e locais (se aplicável). Este campo é compatível apenas com variáveis MeetingTimeSuggestion[] . 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.
• Empty Suggestion Reason - A reason for not returning any meeting suggestions. The possible values are attendeesUnavailable, attendeesUnavailableOrUnknown, locationsUnavailable, organizerUnavailable, or unknown. This property is an empty string if the Available Timeslots property does not include any meeting suggestions. You can also use MeetingTimeSuggestion.SuggestionReason to see the suggestion reason.

Configuração para multiplataforma

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.