Get Calendars

UiPath.MicrosoftOffice365.Activities.Calendar.GetCalendars

Description

Usa a API Get Calendar do Microsoft Graph para obter as propriedades e relacionamentos de um calendário. O calendário pode ser de um usuário ou o calendário padrão de um grupo do Office 365 (Usuário).

Depois de recuperar os calendários, a atividade gera um objeto Calendar que representa o calendário padrão do usuário (Default Calendar) e uma matriz de objetos Calendar[] que representa todos os calendários do usuário (Calendars). Esses objetos Calendar de saída podem ser usados como variáveis de propriedade de entrada nas atividades Create Event e Search Events .

Esta atividade não se limita a recuperar seu calendário. Você também pode recuperar o calendário de outro usuário se o aplicativo registrado no Microsoft Office 365 Scope (ApplicationId) tiver permissões ou as permissões delegadas apropriadas do usuário.

Escopos

Essa atividade requer os seguintes escopos:

• Calendários.Leia

OU

• Calendars.Read.Shared

OU

• Calendários.ReadWrite

OU

• Calendars.ReadWrite.Shared

OU

• Group.Read.All

OU

• Group.ReadWrite.All

Compatibilidade do projeto

Windows - Legado | Windows

Configuração

Painel de 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

• Conta — (opcional) o endereço de email com o qual interagir. Isso pode incluir qualquer caixa de correio compartilhada à qual o usuário atual tenha direito de acesso. Se deixado em branco, a conta atual do usuário será utilizada. Essa propriedade é compatível com variáveis String e valores formatados de string.

  Observação:

  Account field is mandatory for ApplicationIdAndSecret and ApplicationIdAndCertificate authentication types.

• Usuário - O endereço de email da pessoa da qual o calendário é recuperado. Se nenhum for fornecido, o próprio calendário do usuário será usado. O usuário deve ter permissões de API para ler calendários. Para obter mais informações, consulte o guia de Configuração . Essa propriedade é compatível com variáveis String e valores formatados de string.

Diversos

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

Saída

• Calendários — uma matriz dos calendários do usuário. Este campo é compatível apenas com variáveis Calendar[] . Obrigatório se você planeja usar os dados de saída em atividades subsequentes. Você também pode usar essa variável como variável de entrada em outras atividades (por exemplo, Criar evento e Pesquisar eventos).
• Calendário padrão — o calendário padrão do usuário autenticado, caso a propriedade User esteja vazia. Este campo é compatível apenas com variáveis Calendar . Obrigatório se você planeja usar os dados de saída em atividades subsequentes. Você também pode usar essa variável como variável de entrada em outras atividades (por exemplo, Criar evento e Pesquisar eventos).

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 Get Calendars activity inside the Microsoft Office 365 Scope activity.
4. Insira valores para as propriedades de entrada.
5. Crie e insira variáveis Calendar e Calendar[] para sua propriedade Saída .
6. Execute a atividade.
   • Seus valores de propriedade de entrada são enviados para a API GetCalendar .
   • A API retorna os valores Calendar e Calendar[] para sua variável de propriedade de saída.