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 IntegrationHub

Este spoke requer uma assinatura do Hub de integração. Para obter mais informações, consulte Programações jurídicas - Visão geral do IntegrationHub.

Versão do spoke

Microsoft SharePoint Online spoke v 2.4.6 é 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 IntegrationHub Tempo de execução (com.glide.hub.integration.runtime)
ServiceNow IntegrationHub Etapa de ação - REST (com.glide.hub.action_step.rest)
Objeto complexo (com.glide.cobject)
ServiceNow Flow Designer - Entradas dinâmicas (com.glide.hub.dynamic_inputs)
ServiceNow IntegrationHub Etapa de ação - REST (com.glide.hub.action_step.rest)
ServiceNow IntegrationHub Modelo de ação - Fluxo de dados (com.glide.hub.action_type.datastream)
ServiceNow IntegrationHub 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 da aplicação (API) do Microsoft SharePoint versão v1.

Fluxos do spoke

O spoke Microsoft SharePoint Online 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 logon único (SSO) estiver configurado, você poderá usar a ação Pesquisar informações do usuário por nome de login e verificar se você foi aprovado para executar as ações do spoke.
Os designers de fluxo e os designers 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 executado.

Subfluxos do spoke

O spoke Microsoft SharePoint Online fornece um subfluxo de amostra no estado de rascunho para demonstrar a automação de Microsoft SharePoint Online tarefas. 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.

Nota:

Os designers de fluxo e os designers 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 executado.

Ações do spoke

O spoke Microsoft SharePoint Online fornece 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	Cria um site ou subsite em Microsoft SharePoint Online que é baseado no local raiz do locatário.
	Excluir local	Remove um site ou subsite de Microsoft SharePoint Online que se baseia no local fornecido no URL de conexão. Ele remove um subsite que é baseado no parâmetro de entrada do local do site.
	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 sites	Pesquisa os sites e subsites em Microsoft SharePoint Online.
	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 relativo".
	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 do 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 do locatário Microsoft SharePoint Online.
	Cancelar compartilhamento da pasta com o usuário	Remove o acesso a uma pasta de um usuário. 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 check-in, use a ação Pesquisar detalhes do arquivo. Nota: O arquivo já está 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 que você fornece.
	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 do 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 do 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.
Gestão de usuários	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 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 do site 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 do site Microsoft SharePoint Online.
	Atualizar proprietário do grupo (usuário)	Atualiza um usuário como proprietário do grupo.
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 por seu 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 Microsoft SharePoint Online pelo título.
	Atualizar lista em um site por Identificador	Atualiza uma lista em um site Microsoft SharePoint Online por 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 os designers 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 executado.

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 é realizada no log de mudança.
	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 de recurso do SharePoint [].
Gestão de arquivos	Obter link de download do arquivo	Recupera o 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 spoke Microsoft SharePoint Online requer que você crie um app 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

IntegrationHub O usa aliases para gerenciar informações de conexão e de credencial 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.

Locatário único: Este spoke inclui o registro de alias MicrosoftSharepointOnline para autorizar ações em Microsoft SharePoint Online. Selecione este alias no registro do 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 as 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 de site raiz do Sharepoint Online, SharePoint Graph e 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 de raiz no spoke, certifique-se de ter criado três registros de locatário nas tabelas Locatários do Microsoft SharePoint Online spoke para que cada registro de locatário seja associado ao respectivo alias registro.

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