Microsoft Exchange Online Spoke
O Microsoft Exchange Online spoke cria e gerencia calendário e e-mail em Microsoft Exchange Online. Para criar, gerenciar ou excluir usuários e grupos, use o Microsoft Azure AD spoke.
Nota:
O gerenciamento de usuários e grupos pode ser feito usando somente Microsoft Azure AD e não Microsoft Exchange Online spoke.
Solicitar aplicativos na Store
Acesse o site ServiceNow Store para ver todos os aplicativos disponíveis e obter informações sobre como enviar solicitações para a loja. Para obter informações sobre notas de versão cumulativa para todos os aplicativos liberados, consulte as ServiceNow Store notas de versão do histórico de versão.
Assinatura do Integration Hub
Este spoke requer uma assinatura do Hub de integração. Para obter mais informações, consulte Cronogramas jurídicos - Visão geral do IntegrationHub.
Versão do spoke
Microsoft Exchange Online spoke v3.7.1 é a versão mais recente.
Dependências do spoke
Se você estiver tendo problemas para instalar o aplicativo, verifique se estes plug-ins dependentes estão instalados:
- Etapa de ação do ServiceNow IntegrationHub — REST (com.glide.hub.action_step.rest)
- Tempo de execução do ServiceNow IntegrationHub (com.glide.hub.integration.runtime)
- ServiceNow Flow Designer - Entradas dinâmicas (com.glide.hub.dynamic_inputs)
- Objeto complexo (com.glide.cobject)
- Modelo de ação do ServiceNow IntegrationHub — fluxo de dados (com.glide.hub.action_type.datastream)
- Tabelas remotas (com.glide.script.vtable)
- Fonte de dados de importação do sistema (com.glide.system_import_data_source)
- Pacote do utilitário Spoke do iHub (com.snc.ihub_spoke_util_pack)
Nota:
Alguns desses plug-ins são recursos licenciáveis e exigem uma licença apropriada, se usados fora da implementação do spoke. Para obter informações sobre licenças, entre em contato com o gerente da sua conta.
Versão compatível
Microsoft Graph REST API v1.0
Módulo de spoke
O Microsoft Exchange Online spoke adiciona a aplicação Microsoft Exchange Online à sua instância e inclui estes módulos:
| Módulo | Descrição |
|---|---|
| Eventos | Exibe a lista de eventos no Microsoft Exchange Online. |
| Assinaturas | Exibe a lista de assinaturas no Microsoft Exchange Online. |
| Registro do Webhook | Exibe a lista de registros de webhook do Microsoft Exchange Online. |
| Calendários | Exibe uma lista de calendários no Microsoft Exchange Online. |
| Dados de transformação dos eventos de calendário | Exibe a lista de registros da fonte de dados. |
Fluxos de spoke
O spoke do Microsoft Exchange Online fornece fluxos de amostra no estado publicado para demonstrar a automatização da renovação de assinaturas. Os fluxos de amostra disponíveis incluem:
| Fluxo | Descrição |
|---|---|
| Renovar assinaturas | Recupera todos os registros de assinatura e renova as assinaturas se uma renovação for necessária, com base no tempo de expiração. Se alguma assinatura tiver seu status marcado como "Em exclusão", seu registro será excluído e não será considerado para renovação. |
Subfluxos do spoke
O spoke fornece subfluxos no estado Publicado para integração com o serviço Microsoft Exchange Online. Esses subfluxos podem ser usados como parte de outros subfluxos e fluxos.
| Categoria | Subfluxos | Descrição |
|---|---|---|
| Gestão de webhook | Verificar assinatura de evento | Verifica se existe uma assinatura de webhook com o recurso de evento especificado ou a URL de notificação e o tipo de mudança. |
| Criar ou atualizar registro de assinatura | Verifica se o registro de assinatura especificado existe no Microsoft Exchange Online e atualiza o registro de assinatura se ele existir. Se o registro de assinatura não existir, um novo registro de assinatura será criado. | |
| Criar ou atualizar assinaturas de recursos | Verifica as assinaturas dos recursos especificados. Se a assinatura dos recursos especificados não existir, novas assinaturas serão criadas. Nota: Este subfluxo está disponível somente quando o plug-in Sincronização do calendário do local de trabalho já está instalado. |
|
| Excluir assinatura | Exclui a assinatura especificada quando a assinatura especificada está relacionada somente à aplicação especificada. | |
| Recriar assinatura removida | Recria uma assinatura de webhook removida usando os detalhes do registro de assinatura relacionado. | |
| Gestão de ciclo de vida de assinatura | Gerencia o ciclo de vida de uma assinatura de webhook. | |
| Gestão de calendário | Sincronização de calendário | Sincroniza o calendário recuperando eventos da tabela Dados transformados de eventos do calendário do Exchange Online e adicionando os eventos recuperados à tabela Microsoft Exchange Online Eventos. Ele criará uma assinatura se não existir uma assinatura válida para o calendário especificado do usuário. |
| Criar ou atualizar registro de evento | Verifica o registro de evento específico existente e atualiza com as propriedades especificadas. Se o registro de evento especificado não existir, um novo registro de evento será criado. | |
| Excluir evento de programação de calendário | Exclui o evento especificado no Microsoft Exchange Online e os registros relacionados das tabelas de eventos, anexos relacionados, registros relacionados dos participantes do evento e evento para tabelas m2m de assinatura. | |
| Excluir registro de evento | Exclui o registro de evento especificado das tabelas de eventos e dos anexos relacionados, registros relacionados dos participantes do evento e evento para tabelas m2m de assinatura. | |
| Gestão de ciclo de vida de eventos | Recupera os detalhes do evento e atualiza os registros nas tabelas de evento, participantes e evento para m2m de assinatura. | |
| Pesquisar e atualizar anexos no registro de eventos | Recupera os anexos de um registro de evento específico do Microsoft Exchange Online e os atualiza. | |
| Pesquisar e atualizar mudança de programação de calendário | Recupera os detalhes do evento de um registro de evento especificado e os atualiza. | |
| Sincronizar eventos | Sincroniza a exibição do calendário com base nos dados da tabela Dados transformados de eventos do calendário do Exchange Online. | |
| Atualizar evento de programação de calendário | Atualiza as propriedades de um objeto de evento no Microsoft Exchange Online e o registro relacionado na tabela de eventos. |
Nota:
- Use a tabela Registro de Webhook do Microsoft Exchange Online para gerar um URL de retorno de chamada e armazenar o valor secreto (estado do cliente) para assinaturas de webhook.
- Certifique-se de que a assinatura do webhook esteja armazenada na tabela Assinaturas do Microsoft Exchange Online com o campo Status definido como Ativo.
Ações do spoke
O Microsoft Exchange Online spoke fornece ações para automatizar tarefas de calendário e e-mail quando um incidente é criado na instância ServiceNow.
| Categoria | Ação | Descrição |
|---|---|---|
| Gestão de calendário | Copiar anexo em evento do calendário | Copia um anexo ServiceNow para um evento de calendário Trocar. |
| Criar evento de calendário | Cria um evento no calendário padrão do usuário e especifica o fuso horário para os horários de início e término do evento. | |
| Criar eventos de calendário recorrentes | Cria um evento recorrente no calendário padrão do usuário e especifica o fuso horário para os horários de início e término do evento. | |
| Excluir anexo | Exclui o anexo especificado no evento. | |
| Excluir evento de calendário | Exclui um evento de calendário. | |
| Encontrar horários das reuniões | Recupera horários e locais de reunião com base na disponibilidade do organizador da reunião e dos participantes para o horário e locais especificados. | |
| Pesquisar anexos por ID de evento | Recupera todos os anexos no evento especificado. | |
| Pesquisar calendário por ID | Recupera os detalhes do calendário para o ID especificado. | |
| Pesquisar calendário de eventos por ID de usuário | Recupera a lista de objetos de evento na caixa de correio do usuário. | |
| Pesquisar fluxo de exibição de calendário | Recupera a lista de entradas de reunião para o ID de usuário especificado para o período especificado. | |
| Pesquisar fluxo de calendários | Recupera detalhes dos calendários de todos os usuários. | |
| Pesquisar evento por ID | Recupera os detalhes do evento de calendário para o ID especificado. | |
| Pesquisar cronogramas | Recupera a lista de cronogramas. | |
| Pesquisar configurações de ausência temporária | Recupera os detalhes das configurações de ausência temporária dos destinatários especificados. | |
| Pesquisar fusos horários | Recupera os detalhes de todos os fusos horários disponíveis. | |
| Atualizar evento de calendário | Atualiza as propriedades de um objeto de evento. | |
| Gestão de e-mails | Excluir mensagem | Exclui a mensagem da caixa de entrada de um usuário ou de uma pasta personalizada. |
| Pesquisar pastas de e-mail por ID de usuário | Recupera todas as pastas de e-mail de um ID de usuário especificado. | |
| Pesquisar mensagens por ID de pasta de e-mail | Recupera todas as mensagens em uma pasta de e-mail. | |
| Pesquisar mensagens por ID de usuário | Recupera todas as mensagens na pasta da caixa de entrada do usuário. | |
| Enviar e-mail | Envia um e-mail com o assunto e o corpo da mensagem para a lista de destinatários especificada. | |
| Definir resposta automática da caixa de correio | Define a mensagem de resposta automática do usuário para o período de tempo fornecido. | |
| Gestão de Webhook | Pesquisar assinatura por ID | Recupera detalhes da assinatura de webhook para o ID especificado. |
| Pesquisar fluxo de assinaturas | Recupera detalhes de todas as assinaturas de webhook. | |
| Renovar assinatura de webhook | Renova a assinatura do webhook especificado. | |
| Assinar webhook | Cria uma assinatura de webhook para o recurso especificado. | |
| Cancelar assinatura do webhook | Exclui a assinatura do webhook especificada. | |
| Gestão da caixa de correio | Criar caixa de correio | Cria caixas de correio e contas de usuário simultaneamente. |
| Excluir caixa de correio | Exclui ou desabilita caixas de correio e contas de usuário simultaneamente. | |
| Habilitar caixa de Correio | Habilita uma caixa de correio no Microsoft Exchange Online. A caixa de correio pode estar em um estado arquivado. | |
| Pesquisar caixa de correio | Recupera a lista de caixas de correio. |
As permissões necessárias para executar essas ações são:
| Categoria | Ação | Tipo de permissão | Permissões (do menos para o mais privilegiado) |
|---|---|---|---|
| Gestão de calendário | Copiar anexo em evento do calendário | Delegado (conta corporativa ou de estudante) | Calendars.ReadWrite |
| Delegado (conta pessoal da Microsoft) | Calendars.ReadWrite | ||
| Aplicação | Calendars.ReadWrite | ||
| Criar evento de calendário | Delegado (conta corporativa ou de estudante) | Calendars.ReadWrite | |
| Delegado (conta pessoal da Microsoft) | Calendars.ReadWrite | ||
| Aplicação | Calendars.ReadWrite | ||
| Criar eventos de calendário recorrentes | Delegado (conta corporativa ou de estudante) | Calendars.ReadWrite | |
| Delegado (conta pessoal da Microsoft) | Calendars.ReadWrite | ||
| Aplicação | Calendars.ReadWrite | ||
| Excluir anexo | Delegado (conta corporativa ou de estudante) | Calendars.ReadWrite | |
| Delegado (conta pessoal da Microsoft) | Calendars.ReadWrite | ||
| Aplicação | Calendars.ReadWrite | ||
| Excluir evento de calendário | Delegado (conta corporativa ou de estudante) | Calendars.ReadWrite | |
| Delegado (conta pessoal da Microsoft) | Calendars.ReadWrite | ||
| Aplicação | Calendars.ReadWrite | ||
| Encontrar horários das reuniões | Delegado (conta corporativa ou de estudante) | Calendários.Leitura, Calendários.LeituraGravação | |
| Delegado (conta pessoal da Microsoft) | Sem suporte. | ||
| Aplicação | Sem suporte. | ||
| Pesquisar anexos por ID de evento | Delegado (conta corporativa ou de estudante) | Calendários.Lidos | |
| Delegado (conta pessoal da Microsoft) | Calendários.Lidos | ||
| Aplicação | Calendários.Lidos | ||
| Pesquisar calendário por ID | Delegado (conta corporativa ou de estudante) | Calendários.LeituraBásica, Calendários.Leitura, Calendários.LeituraGravação | |
| Delegado (conta pessoal da Microsoft) | Calendários.LeituraBásica, Calendários.Leitura, Calendários.LeituraGravação | ||
| Aplicação | Calendários.LeituraBásica, Calendários.Leitura, Calendários.LeituraGravação | ||
| Pesquisar calendário de eventos por ID de usuário | Delegado (conta corporativa ou de estudante) | Calendários.LeituraBásica, Calendários.Leitura, Calendários.LeituraGravação | |
| Delegado (conta pessoal da Microsoft) | Calendários.LeituraBásica, Calendários.Leitura, Calendários.LeituraGravação | ||
| Aplicação | Calendários.LeituraBásica, Calendários.Leitura, Calendários.LeituraGravação | ||
| Pesquisar fluxo de exibição de calendário | Delegado (conta corporativa ou de estudante) | Calendários.LeituraBásica, Calendários.Leitura, Calendários.LeituraGravação | |
| Delegado (conta pessoal da Microsoft) | Calendários.LeituraBásica, Calendários.Leitura, Calendários.LeituraGravação | ||
| Aplicação | Calendários.LeituraBásica, Calendários.Leitura, Calendários.LeituraGravação | ||
| Pesquisar fluxo de calendários | Delegado (conta corporativa ou de estudante) | Calendars.ReadBasic, Calendars.Read, Calendars.Read.Shared, Calendars.ReadWrite | |
| Delegado (conta pessoal da Microsoft) | Calendars.ReadBasic, Calendars.Read, Calendars.Read.Shared, Calendars.ReadWrite | ||
| Aplicação | Calendários.LeituraBásica, Calendários.Leitura, Calendários.LeituraGravação | ||
| Pesquisar evento por ID | Delegado (conta corporativa ou de estudante) | Calendários.LeituraBasic, Calendários.Leitura | |
| Delegado (conta pessoal da Microsoft) | Calendários.LeituraBasic, Calendários.Leitura | ||
| Aplicação | Calendários.LeituraBasic, Calendários.Leitura | ||
| Pesquisar cronogramas | Delegado (conta corporativa ou de estudante) | Calendários.LeituraBásica, Calendários.Leitura, Calendários.LeituraGravação | |
| Delegado (conta pessoal da Microsoft) | Sem suporte. | ||
| Aplicação | Calendários.LeituraBásica, Calendários.Leitura, Calendários.LeituraGravação | ||
| Pesquisar configurações de ausência temporária | Delegado (conta corporativa ou de estudante) | E-mail.Lido, E-mail.Lido.Compartilhado | |
| Delegado (conta pessoal da Microsoft) | E-mail.Lido | ||
| Aplicação | E-mail.Lido | ||
| Pesquisar fusos horários | Delegado (conta corporativa ou de estudante) | Usuário.Leitura, Usuário.LeituraBásica.Todos | |
| Delegado (conta pessoal da Microsoft) | User.Read | ||
| Aplicação | User.Read.All | ||
| Atualizar evento de calendário | Delegado (conta corporativa ou de estudante) | Calendars.ReadWrite | |
| Delegado (conta pessoal da Microsoft) | Calendars.ReadWrite | ||
| Aplicação | Calendars.ReadWrite | ||
| Gestão de e-mails | Excluir mensagem | Delegado (conta corporativa ou de estudante) | E-mail.LeituraGravação |
| Delegado (conta pessoal da Microsoft) | E-mail.LeituraGravação | ||
| Aplicação | E-mail.LeituraGravação | ||
| Pesquisar pastas de e-mail por ID de usuário | Delegado (conta corporativa ou de estudante) | Mail.ReadBasic, Mail.Read, Mail.ReadWrite | |
| Delegado (conta pessoal da Microsoft) | Mail.ReadBasic, Mail.Read, Mail.ReadWrite | ||
| Aplicação | Mail.ReadBasic, Mail.Read, Mail.ReadWrite | ||
| Pesquisar mensagens por ID de pasta de e-mail | Delegado (conta corporativa ou de estudante) | Mail.ReadBasic, Mail.Read, Mail.ReadWrite | |
| Delegado (conta pessoal da Microsoft) | Mail.ReadBasic, Mail.Read, Mail.ReadWrite | ||
| Aplicação | Mail.ReadBasic, Mail.Read, Mail.ReadWrite | ||
| Pesquisar mensagens por ID de usuário | Delegado (conta corporativa ou de estudante) | Mail.ReadBasic, Mail.Read, Mail.ReadWrite | |
| Delegado (conta pessoal da Microsoft) | Mail.ReadBasic, Mail.Read, Mail.ReadWrite | ||
| Aplicação | Mail.ReadBasic, Mail.Read, Mail.ReadWrite | ||
| Enviar e-mail | Delegado (conta corporativa ou de estudante) | E-mail.Enviar | |
| Delegado (conta pessoal da Microsoft) | E-mail.Enviar | ||
| Aplicação | E-mail.Enviar | ||
| Definir resposta automática da caixa de correio | Delegado (conta corporativa ou de estudante) | MailboxSettings.ReadWrite | |
| Delegado (conta pessoal da Microsoft) | MailboxSettings.ReadWrite | ||
| Aplicação | MailboxSettings.ReadWrite | ||
| Gestão da caixa de correio | Criar caixa de correio | Essas ações usam cmdlets do PowerShell e, portanto, não requerem permissões de API. | |
| Excluir caixa de correio | |||
| Habilitar caixa de Correio | |||
| Pesquisar caixa de correio | |||
Microsoft requisitos de conta
O Microsoft Exchange Online spoke precisa registrar uma aplicação usando o Microsoft portal do Azure para gerar tokens OAuth 2.0.
Requisitos de aliases de conexão e credencial
Integration Hub usa aliases para gerenciar conexões e informações de credenciais e credenciais de OAuth. O uso de um alias elimina a necessidade de configurar várias credenciais e perfis de informações de conexão ao usar vários ambientes. Se as informações de conexão ou de credencial forem alteradas, não será necessário atualizar nenhuma ação que use a conexão.
Para obter informações sobre como configurar o spoke, consulte Configurar Microsoft Exchange Online spoke..