Exercício – Acessar eventos do calendário de um usuário usando o Microsoft Graph

Concluído

Agora vamos usar todos os conceitos discutidos até esse ponto e fazer alterações no exemplo de aplicativo para acessar os eventos do calendário.

1. Abra o Startup.cs no seu editor e dedique alguns minutos a explorar o Microsoft Identity, o Microsoft Graph e o middleware ASP.NET Core que está definido no ConfigureServices.

2. Localize o seguinte código no método ConfigureServices(). Esse código habilita a injeção de dependência para objetos personalizados chamados GraphProfileClient e GraphEmailClient. Os objetos têm como escopo a solicitação HTTP, o que significa que serão criados uma vez por solicitação para o servidor.

   services.AddScoped<GraphProfileClient>();
   services.AddScoped<GraphCalendarClient>();
   

3. Abra o Graph/GraphCalendarClient.cs e dedique alguns minutos a explorar o código existente. Observe os seguintes campos e métodos:

   • Dois campos readonly denominados _logger e _graphServiceClient estão incluídos na classe. Os objetos injetados no construtor serão atribuídos a esses campos.
   • A classe contém os métodos GetEvents(), GetUserMailboxSettings() e GetUtcStartOfWeekInTimeZone().

4. Remova o código existente no construtor.

5. Modifique o construtor para injetar ILogger<GraphCalendarClient> e GraphServiceClient e atribua os valores de parâmetro aos campos associados:

   public GraphCalendarClient(
     ILogger<GraphCalendarClient> logger,
     GraphServiceClient graphServiceClient)
   {
       _logger = logger;
       _graphServiceClient = graphServiceClient;
   }
   

6. Localize o método GetEvents() e substitua o código existente pelo seguinte. Esse código define as datas de início e término para os eventos de calendário que serão recuperados.

   _logger.LogInformation($"User timezone: {userTimeZone}");
   // Configure a calendar view for the current week
   var startOfWeek = DateTime.Now;
   var endOfWeek = startOfWeek.AddDays(7);
   var viewOptions = new List<QueryOption>
   {
     new QueryOption("startDateTime", startOfWeek.ToString("o")),
     new QueryOption("endDateTime", endOfWeek.ToString("o"))
   };
   

7. Imediatamente abaixo do código anterior adicionado em GetEvents(), adicione os seguintes blocos de código try/catch:

   try
   {
   
   }
   catch (Exception ex)
   {
       _logger.LogError($"Error calling Graph /me/calendaview: { ex.Message}");
       throw;
   }
   

8. Dentro do bloco try, adicione o seguinte código para usar o viewOptions, definir as propriedades do evento do calendário a serem retornadas, definir como classificar os resultados e iniciar uma chamada para me/calendarView:

   // Use GraphServiceClient to call Me.CalendarView
   var calendarEvents = await _graphServiceClient
       .Me
       .CalendarView
       .Request(viewOptions)
       .Header("Prefer", $"outlook.timezone=\"{userTimeZone}\"")
       .Select(evt => new
       {
         evt.Subject,
         evt.Organizer,
         evt.Start,
         evt.End
       })
       .OrderBy("start/DateTime")
       .GetAsync();
   
   return calendarEvents;
   

9. Salve o GraphCalendarClient.cs antes de continuar.

10. Abra o Pages/Calendar.cshtml.cs e dedique alguns minutos a explorar o código existente. Observe as seguintes características:

    • A classe CalendarModel contém vários campos e propriedades, como _logger, _graphCalendarClient, _graphProfileClient, MailboxSettings e Events.
    • ILogger<CalendarModel>, GraphCalendarClient e GraphProfileClient são injetados no construtor e atribuídos aos campos associados.
    • Um método FormatDateTimeZone() está incluído na classe. É usado para formatar um objeto DateTime.

11. Localize o método OnGetAsync() e substitua o código existente pelo seguinte:

    MailboxSettings = await _graphCalendarClient.GetUserMailboxSettings();
    var userTimeZone = (String.IsNullOrEmpty(MailboxSettings.TimeZone))
        ? "Pacific Standard Time"
        : MailboxSettings.TimeZone;
    Events = await _graphCalendarClient.GetEvents(userTimeZone);
    

    Este código obtém as definições da caixa de correio do utilizador, determina se um fuso horário está definido e passa o fuso horário do utilizador para o GetEvents() método que criou anteriormente na classe GraphCalendarClient . Os eventos obtidos são armazenados na propriedade Eventos da classe.

12. Salve o Calendar.cshtml.cs antes de continuar.

13. Abra o Pages/Calendar.cshtml. Este é um arquivo Razor Pages usado para renderizar os dados de eventos do calendário armazenados na classe CalendarModel. Ele lida com a iteração através de eventos armazenados na propriedade CalendarModel da classe Events e grava os detalhes sobre cada evento do calendário na página.

14. Reserve um momento para ver o código HTML e Razor e observar que ele lida com as seguintes tarefas:

    • Garante que o usuário seja autenticado.
    • Verifica a propriedade Model.Events para ver se existem eventos para iterar e exibi-los na página.

15. Localize o comentário @* Add foreach here *@ e o substitua pelo seguinte código:

    @foreach(var evt in Model.Events)
    {
    

16. Localize o comentário @* Add foreach closing bracket here *@ e o substitua por um colchete de fechamento para a instrução foreach adicionada na etapa anterior.

17. Localize o comentário @* Add event subject here *@ e o substitua pelo seguinte código para gravar o assunto de cada evento:

    @evt.Subject
    

18. Localize o comentário @* Add event start date/time here *@ e o substitua pelo seguinte código para gravar a data e a hora de início do evento:

    @Model.FormatDateTimeTimeZone(evt.Start)
    

19. Por fim, localize o comentário @* Add event end date/time here *@ e o substitua pelo seguinte código para gravar a data e a hora de término do evento:

    @Model.FormatDateTimeTimeZone(evt.End)
    

    A função FormatDateTimeTimeZone() na classe CalendarModel lida com a conversão dos valores de data e hora de início e término para o fuso horário definido para o usuário conectado usando os MailboxSettings que foram recuperados quando a página foi carregada.

20. Salve o Calendar.cshtml antes de continuar.

Agora que você adicionou os snippets de código para exibir os eventos da próxima semana de um usuário conectado, a próxima etapa é executar o aplicativo localmente.

Execute o aplicativo

Para executar e testar a aplicação, terá de adicionar alguns eventos de calendário ao seu calendário com o Microsoft Outlook ou o Microsoft Teams. Os eventos devem enquadrar-se num período de uma semana a partir da data atual.

Chegou a hora de executar seu aplicativo e ver como ele funciona!

1. Execute a seguinte etapa com base no seu editor de códigos:

   • Visual Studio

     Clique em F5 para compilar e executar o projeto.

   • Visual Studio Code ou outro editor de códigos

     Abra uma janela do terminal na pasta Iniciar e execute o seguinte comando:

     dotnet run
     

2. Abra um navegador e acesse https://localhost:5001.

3. Inicie sessão com o inquilino do programador do Microsoft 365 que utilizou anteriormente ao registar a Aplicação Microsoft Entra.

4. Após você ter dado seu consentimento às permissões necessárias, o aplicativo tentará obter um token de acesso usando os dados validados da conta. Isso é resolvido para você pelo middleware que discutimos anteriormente noStartup.cs.

5. Depois de obter o token novamente na aplicação com êxito, é feito um pedido GET ao ponto final do Microsoft Graph /me e o token de acesso é transmitido no cabeçalho de autorização. A seguir, a chamada para /me irá recuperar os dados do serviço com segurança.

6. Após a resposta do Microsoft Graph ter sido recebida, você verá a mensagem de boas-vindas com o nome do usuário conectado.

   

7. Selecione o link do Calendário no cabeçalho para visualizar os eventos do calendário do usuário.

8. Depois que a página é carregada, uma solicitação GET é feita para o* ponto de extremidade /m*e/calendarView do Microsoft Graph e o token de acesso é passado no Cabeçalho de Autorização. A seguir, a chamada para /me/calendarView irá recuperar os dados do serviço com segurança e exibi-los na página.

   

   Observação

   Se não estiver vendo nenhum evento do calendário, adicione alguns à conta do usuário que você usou para entrar no aplicativo.

9. Feche o navegador e clique em CTRL+C na janela do terminal para interromper o servidor antes de continuar.

   Observação

   Se você abriu o projeto no Visual Studio, poderá fechar o navegador ou selecionar SHIFT+F5 no Visual Studio para interromper o servidor. Se ainda estiver aberta, feche a janela do terminal que o Visual Studio criou.

Você demonstrou com êxito como acessar e exibir os eventos do calendário do Microsoft 365 para um usuário conectado usando o Microsoft Graph e o ASP.NET Core!

Continuar