Get Calendars

UiPath.MicrosoftOffice365.Activities.Calendar.GetCalendars

Description

Usa a API de calendário do Microsoft Graph Get para obter as propriedades e os 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).

Após recuperar os calendários, a atividade gera um objeto Calendar , que representa o calendário padrão do usuário (Calendário Padrão) e uma matriz de objetos Calendar[] , que representa todos os calendários do usuário (Calendários). Esses objetos Calendar 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 escopo do Microsoft Office 365 (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

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 e-mail com o qual interagir. Isso pode incluir qualquer caixa de correio compartilhada à qual o usuário atual tenha direitos de acesso. Se deixado em branco, a conta do usuário atual será assumida. Esta propriedade oferece suporte a variáveis String e valores formatados em string.
  Observação: O campoConta é obrigatório para os tipos de autenticação ApplicationIdAndSecret e ApplicationIdAndCertificate .
• 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 String variáveis 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. Este campo aceita valores booleanos.

Saída

• Calendários - Uma matriz dos calendários do usuário. Esse 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, Create Event e Search Events).
• Calendário padrão — o calendário padrão do usuário autenticado, caso a propriedade User esteja vazia. Esse 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, Create Event e Search Events).

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 Get Calendars dentro da atividade Microsoft Office 365 Scope.
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.