Microsoft SharePoint 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 SharePoint Online spoke v2.7.0 é a versão mais recente.

Nota:

Os spokes do Microsoft SharePoint Online não são compatíveis com o SharePoint no local.

Dependências do spoke

Se você estiver tendo problemas para instalar o aplicativo, verifique se estes plug-ins dependentes estão instalados:

ServiceNow Integration Hub Tempo de execução (com.glide.hub.integration.runtime)
ServiceNow Integration Hub Etapa de ação - REST (com.glide.hub.action_step.rest)
Objeto complexo (com.glide.cobject)
ServiceNow Workflow Studio - Entradas dinâmicas (com.glide.hub.dynamic_inputs)
ServiceNow Integration Hub Etapa de ação - REST (com.glide.hub.action_step.rest)
ServiceNow Integration Hub Modelo de ação - Fluxo de dados (com.glide.hub.action_type.datastream)
ServiceNow Integration Hub Tempo de execução (com.glide.hub.integration.runtime)

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ões compatíveis

Interface de programação de aplicações (API) do Microsoft SharePoint versão v1.

Fluxos de spoke

O Microsoft SharePoint Online spoke fornece fluxos de amostra no estado de rascunho para demonstrar a automação das tarefas Microsoft SharePoint Online. Para personalizar um fluxo de amostra, copie-o para um novo escopo da aplicação. A tabela a seguir mostra os fluxos de amostra disponíveis.


Fluxo	Descrição
Novo anexo no registro cria pasta e copia o anexo	Quando um anexo é criado em uma tabela de banco de dados, uma pasta é criada para um registro de conhecimento no spoke Microsoft SharePoint Online. Em seguida, o anexo é copiado para a pasta.
Criar site para base de conhecimento	Quando uma base de conhecimento é criada na tabela do banco de dados, o fluxo cria um site para ela na Microsoft SharePoint Online

Nota:

Se o Single Sign-on (SSO) estiver configurado, você poderá usar a ação Pesquisar informações do usuário por nome de login e verificar se você está aprovado para executar as ações do spoke.
Os designers de fluxo e de ação devem garantir que as verificações de autorização do usuário sejam realizadas antes que o fluxo ou a ação seja executada.

Subfluxos do spoke

O spoke Microsoft SharePoint Online fornece um subfluxo de amostra no estado de rascunho para demonstrar a automação de tarefas Microsoft SharePoint Online. Para personalizar o subfluxo, copie-o para um novo escopo da aplicação.


Subfluxo	Descrição
Remover e adicionar um usuário a um grupo	Remove um usuário de um grupo Microsoft SharePoint Online e adiciona um novo usuário.
Excluir site moderno (sem grupo do O365)	Exclui o site moderno associado ao grupo não O365 (site de comunicação).
Enviar site moderno (com grupo do O365) para exclusão	Envia um local moderno (com grupo do O365) para exclusão. Nota: Pode levar até 30 minutos para que o site seja movido na seção de sites excluídos do portal do administrador do SharePoint.

Nota:

Os designers de fluxo e de ação devem garantir que as verificações de autorização do usuário sejam realizadas antes que o fluxo ou a ação seja executada.

Ações do spoke

O Microsoft SharePoint Online spokefornece ações para automatizar várias tarefas Microsoft SharePoint Online que são baseadas nos gatilhos na instância ServiceNow.

Você pode executar algumas ações usando a conexão do SharePoint Online e as ações restantes usando a conexão do SharePoint Graph.

As ações na tabela a seguir usam a conexão do SharePoint Online e o registro de alias de credencial.


Ações usando o registro de alias de conexão e credencial do SharePoint Online
Categoria	Ação	Descrição
Gestão de sites	Criar site moderno	Cria um site moderno dos tipos Sites de comunicação e Sites de equipe não associados a grupos.
	Criar subsite	Cria um subsite no SharePoint Online. O locatário determina o local raiz.
	Excluir site moderno	Exclui o site moderno associado ao grupo não pertencente ao O365 (site de comunicação).
	Excluir site moderno com grupo do O365	Envie o site moderno associado ao grupo do O365 (site da equipe) para exclusão. Ele exclui o grupo 0365 associado que exclui o site. Nota: Após a execução, pode levar até 30 minutos para que um site seja excluído.
	Excluir subsite	Remove um subsite do SharePoint Online. A URL de conexão usada determina qual é o local raiz.
	Pesquisar informações do grupo de sites modernos	Recupera os detalhes do grupo associado do O365 de um site moderno (site da equipe).
	Pesquisar informações do site moderno	Obtém os detalhes de um site moderno.
	Pesquisar mudanças no site	Recupera as mudanças de um site que se baseia nas condições de consulta.
	Pesquisar atribuições de função	Recupera todas as atribuições de função definidas no site.
	Pesquisar ID de coleções de sites	Pesquisa um ID de site específico.
	Pesquisar detalhes do subsite	Pesquisa informações sobre um subsite.
	Atualizar informações do site	Atualiza um site Microsoft SharePoint Online.
Gestão de pastas	Criar pasta	Cria uma pasta em uma biblioteca de documentos em um site Microsoft SharePoint Online.
	Excluir pasta	Exclui uma pasta em Microsoft SharePoint Online. Nota: Você não recebe nenhum aviso ou notificação antes que a pasta seja removida.
	Listar arquivos em uma pasta	Obtém uma lista de arquivos em uma pasta.
	Listar pastas em uma pasta	Obtém uma lista das pastas em uma pasta.
	Pesquisar pasta	Pesquisa uma pasta em Microsoft SharePoint Online e retorna suas propriedades. Por exemplo, a saída pode conter a propriedade "URL relativa".
	Renomear uma pasta	Renomeia uma pasta em Microsoft SharePoint Online.
	Compartilhar pasta com grupo	Compartilha uma pasta com um grupo em Microsoft SharePoint Online. O grupo deve pertencer à conta de locatário Microsoft SharePoint Online.
	Compartilhar pasta com o usuário	Compartilha uma pasta com um usuário emMicrosoft SharePoint Online. O usuário deve pertencer à conta de locatário Microsoft SharePoint Online.
	Cancelar o compartilhamento de pasta com grupo	Remove o acesso a uma pasta de um grupo. O grupo deve pertencer à conta de locatário Microsoft SharePoint Online.
	Cancelar compartilhamento da pasta com o usuário	Remove o acesso de um usuário a uma pasta. O usuário deve pertencer à conta de locatário Microsoft SharePoint Online.
Gestão de arquivos	Anexar arquivo do Sharepoint a um registro	Anexa um arquivo Microsoft SharePoint Online a um registro ServiceNow.
	Fazer check-in do arquivo	Define um arquivo no Microsoft SharePoint Online no estado verificado. Para encontrar o número da versão do arquivo depois que seu estado for definido como submetido a check-in, use a ação Pesquisar detalhes do arquivo, Nota: O arquivo já foi carregado e a ação apenas atualiza o status do arquivo a ser submetido a check-in.
	Fazer check-out no arquivo	Define um arquivo no Microsoft SharePoint Online no estado submetido a check-out. Para encontrar o número da versão do arquivo depois que seu estado for definido como submetido a check-out, use a ação Pesquisar detalhes do arquivo, Nota: O arquivo já foi baixado e a ação apenas atualiza o status do arquivo para submetido a check-out.
	Copiar anexo na pasta	Copia um anexo ServiceNow para uma pasta Microsoft SharePoint Online.
	Copiar arquivo	Copia um arquivo com um novo nome.
	Criar arquivo de texto	Cria um arquivo de texto com as informações fornecidas.
	Exclusão de arquivo	Exclui um arquivo em Microsoft SharePoint Online.
	Pesquisar detalhes do arquivo	Pesquisa os detalhes do arquivo em Microsoft SharePoint Online.
	Mover arquivo	Move um arquivo para outro local em Microsoft SharePoint Online.
	Compartilhar arquivo com o grupo	Compartilha um arquivo com um grupo emMicrosoft SharePoint Online. O grupo deve pertencer à conta de locatário Microsoft SharePoint Online.
	Compartilhar arquivo com o usuário	Compartilha um arquivo com um usuário Microsoft SharePoint Online. O usuário deve pertencer à conta de locatário Microsoft SharePoint Online.
	Cancelar o compartilhamento de arquivo com grupo	Remove o acesso a um arquivo de um grupo Microsoft SharePoint Online. O grupo deve pertencer à conta de locatário Microsoft SharePoint Online.
	Cancelar compartilhamento de arquivo com o usuário	Remove o acesso a um arquivo de um usuário Microsoft SharePoint Online. O usuário deve pertencer à conta de locatário Microsoft SharePoint Online.
Gestão de usuários	Pesquisar informações do usuário por nome de login	Pesquisa um site Microsoft SharePoint Online para obter informações sobre um usuário e retorna as informações.
	Pesquisar informações do usuário por e-mail	Pesquisa o site Microsoft SharePoint Online especificado para um determinado usuário e retorna informações do SharePoint sobre essa conta.
	Pesquisar grupos de SharePoint do usuário	Pesquisa o site Microsoft SharePoint Online para obter informações sobre todos os grupos dos quais um usuário é membro e retorna as informações.
Gestão de pesquisa	Pesquisar fluxo de resultados da consulta de pesquisa	Pesquisa o site raiz do SharePoint e recupera o resultado com base na consulta de pesquisa fornecida.
Gestão de grupo	Adicionar função ao site	Adiciona uma função a um usuário ou grupo Microsoft SharePoint Online.
	Adicionar usuário ao grupo	Adiciona um usuário a um grupo de sites Microsoft SharePoint Online.
	Criar grupo	Cria um grupo em um site Microsoft SharePoint Online.
	Excluir Grupo	Exclui um grupo em um site Microsoft SharePoint Online.
	Pesquisar grupo por nome	Pesquisa um grupo pelo nome em um local do site no Microsoft SharePoint Online. Se nenhum local do site for especificado, a ação pesquisará o site raiz do locatário.
	Remover função do site	Remove permissões de um grupo ou usuário.
	Remover usuário do grupo	Remove um usuário de um grupo de sites Microsoft SharePoint Online.
	Atualizar proprietário do grupo (usuário)	Atualiza um usuário como proprietário do grupo.
	Pesquisar membros do M365 por grupo de sites	Recupera uma lista de usuários e grupos do M365 associados a um grupo do site Microsoft SharePoint Online.
Gestão de listas	Criar Lista	Cria uma lista em um site Microsoft SharePoint Online com seu título e descrição.
	Criar assinatura de lista	Cria uma assinatura de webhook para uma lista.
	Excluir lista por ID	Exclui uma lista em um site Microsoft SharePoint Online pelo ID.
	Pesquisar detalhes da lista por ID	Pesquisa uma lista em um site Microsoft SharePoint Online por seu ID.
	Pesquisar ID de lista por título	Pesquisa uma lista em um Microsoft SharePoint Online pelo título.
	Atualizar lista em um site por Identificador	Atualiza uma lista em um site Microsoft SharePoint Online pelo ID.
Gestão do item da lista	Criar item da lista	Cria um item de lista dentro de uma lista.
	Excluir item de lista por ID	Exclui um item de lista pelo ID da lista e pelo ID do item da lista.
	Pesquisar item da lista por ID	Pesquisa um item de lista pelo ID da lista e pelo ID do item da lista.
	Pesquisar itens de lista em uma lista	Obtém uma lista de itens de uma lista em diferentes formatos.
	Atualizar item da lista por ID	Atualiza um título de item de lista por seu ID.

Nota:

Os designers de fluxo e de ação devem garantir que as verificações de autorização do usuário sejam realizadas antes que o fluxo ou a ação seja executada.

Essas ações usam o registro de alias de conexão e credencial do SharePoint Graph:


Ações usando o registro de alias de conexão e credencial do SharePoint Graph
Categoria	Ação	Descrição
Gestão de mudanças	Obter Mudar propriedades da consulta	Recupera as propriedades de consulta de mudança que são usadas para definir uma consulta que é executada no log de mudanças.
	Obter token de link delta para unidade	Recupera o token de link delta mais recente de uma unidade.
	Obter próximo token	Recupera o próximo token de link da tabela Token de próximo link do recurso do SharePoint.
Gestão de arquivos	Obter link de download do arquivo	Recupera a URL de download do arquivo.
	Pesquisar permissões de arquivo	Obtém as permissões para um arquivo.
	Pesquisar arquivos	Recupera todos os arquivos em uma unidade.
Gestão de listas	Criar assinatura de lista	Cria uma assinatura de webhook para uma lista.
	Renovar assinatura de lista	Renova a assinatura por webhook de uma lista.
	Excluir assinatura de lista	Exclui a assinatura de webhook de uma lista.
	Obter lista	Recupera os detalhes de uma lista do locatário do SharePoint.
	Pesquisar unidades	Recupera todas as unidades de um site.
Gestão de sites	Pesquisar coleções de sites	Recupera todos os conjuntos de sites.
	Pesquisar subsites	Recupera os detalhes de todos os subsites em um site.
	Criar assinatura de site raiz	Cria uma assinatura de webhook para um site raiz.
	Pesquisar permissões de site	Recupera todas as permissões de um site.
	Obter site	Obtém os detalhes do site.

Requisitos de conta do SharePoint Online

O Microsoft SharePoint Online spoke requer que você crie um aplicativo personalizado em sua conta do SharePoint Online para gerar tokens OAuth 2.0. Consulte Configurar a aplicação OAuth no Microsoft Azure.

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.

Único locatário: Este spoke inclui o registro de alias MicrosoftSharepointOnline para autorizar ações em Microsoft SharePoint Online. Selecione este alias no registro de locatário para autorizar mudanças em Microsoft SharePoint Online para um único locatário.
Vários locatários: Este spoke inclui o registro de alias MicrosoftSharepointOnline para autorizar ações em Microsoft SharePoint Online. Crie um registro de alias de conexão e credencial para cada site de locatário adicional que você quer oferecer suporte. Selecione o alias correto no registro do locatário para autorizar mudanças no Microsoft SharePoint Online. Crie um registro de alias de conexão e credencial para cada site de locatário adicional que você quer oferecer suporte. Selecione o alias correto no registro de locatário para autorizar mudanças em Microsoft SharePoint Online. Consulte Criar aliases para vários locatários.

Nota:

Três registros de alias estão disponíveis por padrão com o spoke; Assinatura do SharePoint Online, do SharePoint Graph e do site raiz do SharePoint Graph. Cada registro de alias requer que um locatário seja associado a ele. Se você pretende usar todas as ações do SharePoint Online, Graph e Assinatura raiz no spoke, certifique-se de ter criado três registros de locatário nas tabelas de locatários do spoke do Microsoft SharePoint Online para que cada registro de locatário esteja associado ao respectivo alias registro.

Se estiver configurando uma integração para um único locatário, use o registro de alias existente do MicrosoftSharepointOnline.
Você pode usar vários locatários somente com o alias de conexão do Microsoft SharePoint Graph.