Microsoft SharePoint Online Spoke
. Microsoft SharePoint Online o spoke integra seu ServiceNow® instância com Microsoft SharePoint Online para automatizar várias ações predefinidas como parte de um Fluxo de trabalho. Por exemplo, você pode renomear uma pasta em Microsoft SharePoint Online quando um registro no banco de dados é atualizado.
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 Cronogramas jurídicos - Visão geral do IntegrationHub.
Versão do spoke
Microsoft SharePoint Online spoke v 2.10.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 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 Workflow Studio - 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)
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 com suporte
Microsoft SharePoint Application Programming Interface (API) versão v1.
Fluxos de spoke
. Microsoft SharePoint Online o spoke fornece fluxos de amostra no estado de rascunho para demonstrar a automação do Microsoft SharePoint Online tarefas. 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 |
|---|---|
| O novo anexo no registro cria a 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 Microsoft SharePoint Online spoke. Em seguida, o anexo é copiado para a pasta. |
| Criar Site para Base de Conhecimento | Quando uma base de conhecimento é criada na tabela de banco de dados, o fluxo cria um site para ela no 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 foi aprovado para executar as ações do spoke.
- Designers de fluxo e 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 executada.
Subfluxos do spoke
. Microsoft SharePoint Online o spoke fornece um subfluxo de amostra no estado de rascunho para demonstrar a automação 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 Microsoft SharePoint Online e adiciona um novo usuário. |
| Excluir site moderno (sem grupo O365) | Exclui o site moderno associado ao grupo não O365 (site de comunicação). |
| Enviar site moderno (com grupo O365) para exclusão |
Envia um site moderno (com grupo O365) para exclusão.
Nota: Pode levar até 30 minutos para que o site seja movido para a seção Sites excluídos do portal do administrador do SharePoint. |
Nota:
Designers de fluxo e 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 executada.
Ações do spoke
. Microsoft SharePoint Online spokefornece ações para automatizar vários Microsoft SharePoint Online tarefas baseadas nos gatilhos no ServiceNow instância.
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 SharePoint Online registro de alias de conexão e credencial | ||
|---|---|---|
| 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 ao grupo. |
| 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 O365 (site de comunicação). | |
| Excluir subsite | Remove um subsite do SharePoint Online. A URL de conexão usada determina qual é o local raiz. | |
| Pesquisar informações de sites modernos | Recupera detalhes de um site moderno. | |
| Pesquisar mudanças no site | Recupera as mudanças de um site que é baseado 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 Microsoft SharePoint Online site. | |
| Gestão de pastas | Criar pasta | Cria uma pasta em uma biblioteca de documentos em um Microsoft SharePoint Onlinesite. |
| 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 a. Microsoft SharePoint Online conta de locatário. | |
| Compartilhar pasta com o usuário | Compartilha uma pasta com um usuário em Microsoft SharePoint Online. O usuário deve pertencer a. Microsoft SharePoint Online conta de locatário. | |
| Cancelar o compartilhamento de pasta com grupo | Remove o acesso a uma pasta de um grupo. O grupo deve pertencer a. Microsoft SharePoint Online conta de locatário. | |
| Cancelar compartilhamento da pasta com o usuário | Remove o acesso a uma pasta de um usuário. O usuário deve pertencer a. Microsoft SharePoint Online conta de locatário. | |
| Gestão de arquivos | Anexar arquivo do SharePoint a um registro | Anexa um Microsoft SharePoint Online arquivo para um ServiceNow registro. |
| Fazer check-in do arquivo | Define um arquivo no Microsoft SharePoint Online no estado submetido a check-in. 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 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 atualiza o status do arquivo para submetido a check-out. |
|
| Copiar anexo na pasta | Copia um ServiceNow anexo a um Microsoft SharePoint Online pasta. | |
| 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 em Microsoft SharePoint Online. O grupo deve pertencer a. Microsoft SharePoint Online conta de locatário. | |
| Compartilhar arquivo com o usuário | Compartilha um arquivo com um Microsoft SharePoint Online usuário. O usuário deve pertencer a. Microsoft SharePoint Online conta de locatário. | |
| Cancelar o compartilhamento de arquivo com grupo | Remove o acesso a um arquivo de um Microsoft SharePoint Online grupo. O grupo deve pertencer a. Microsoft SharePoint Online conta de locatário. | |
| Cancelar compartilhamento de arquivo com o usuário | Remove o acesso a um arquivo de um Microsoft SharePoint Online usuário. O usuário deve pertencer a. Microsoft SharePoint Online conta de locatário. | |
| Gestão de usuários | Pesquisar informações do usuário por nome de login | Pesquisa um Microsoft SharePoint Online site para obter informações sobre um usuário e retorna as informações. |
| Pesquisar informações do usuário por e-mail | Pesquisa o especificado Microsoft SharePoint Online Para um determinado usuário e retornar informações do SharePoint sobre essa conta. | |
| Pesquisar grupos de SharePoint do usuário | Pesquisa o. Microsoft SharePoint Online site 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 Microsoft SharePoint Online usuário ou grupo. |
| Adicionar usuário ao grupo | Adiciona um usuário a um Microsoft SharePoint Online grupo de sites. | |
| Criar Grupo | Cria um grupo em um Microsoft SharePoint Online site. | |
| Excluir Grupo | Exclui um grupo em um Microsoft SharePoint Online site. | |
| 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 de grupo | Remove um usuário de um Microsoft SharePoint Online grupo de sites. | |
| Atualizar proprietário do grupo (usuário) | Atualiza um usuário como o proprietário do grupo. | |
| Pesquisar membros do M365 por grupo de sites | Recupera uma lista de usuários e grupos M365 associados a um Microsoft SharePoint Online Grupo de sites. | |
| Gestão de listas | Criar Lista | Cria uma lista em um Microsoft SharePoint Online site 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 Microsoft SharePoint Online Site por seu ID. | |
| Pesquisar detalhes da lista por ID | Pesquisa uma lista em um Microsoft SharePoint Online Site por seu ID. | |
| Pesquisar ID de lista por título | Pesquisa uma lista em um Microsoft SharePoint Online pelo seu título. | |
| Atualizar lista em um site por ID | Atualiza uma lista em um Microsoft SharePoint Online Site por seu 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 formatos diferentes. | |
| Atualizar item da lista por ID | Atualiza um título de item de lista por seu ID. | |
Nota:
Designers de fluxo e 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 executada.
Essas ações usam a conexão do SharePoint Graph e o registro de alias de credencial:
| Ações usando SharePoint Graph registro de alias de conexão e credencial | ||
|---|---|---|
| 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ças. |
| Obter token de link delta para unidade | Recupera o token de link delta mais recente para uma unidade. | |
| Obter próximo token | Recupera o token do próximo link da tabela Token do próximo link do 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 do 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 | Excluir site moderno com o Grupo O365 | Envie o site moderno associado ao Grupo O365 (site de equipe) para exclusão. 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. |
| Pesquisar informações do grupo de sites modernos | Recupera os detalhes do grupo O365 associado de um site moderno (site de equipe). | |
| 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. | |
Agentes de IA disponíveis
Instalar Now Assist Spokes e comece a usar os agentes de IA disponíveis. Para obter mais informações, consulte Now Assist Para Spokes.
Este spoke fornece agentes de IA autônomos que imitam inteligência semelhante à humana para executar tarefas em seu ServiceNow instância.
- Em ServiceNow Sistema agentic, você pode criar um fluxo de trabalho agentic que compreende um conjunto de instruções de modelo de linguagem grande (LLM) junto com um ou mais agentes de IA autônomos para executar um objetivo. Consulte Create an agentic workflow Para obter informações sobre como adicionar agentes de IA para criar fluxos de trabalho do agente de acordo com sua necessidade e fornecer o gatilho necessário.
Você também pode pesquisar outros agentes de IA disponíveis e adicioná-los ao fluxo de trabalho do agente. Para obter mais informações, consulte Find AI agents.
- Você pode criar um clone do agente de IA do spoke necessário e personalizá-lo de acordo com seu requisito. Consulte Duplicate an AI agent para obter mais informações sobre como criar um clone.
- Consulte Now Assist AI agents Para obter informações sobre agentes de IA.
Os agentes de IA disponíveis incluem:
| Agente de IA | Descrição |
|---|---|
| Microsoft SharePoint Online Agente de IA para gestão de arquivos | Automatiza tarefas relacionadas a arquivos, como compartilhar arquivos com usuários ou grupos, copiar arquivos, mover arquivos, criar arquivos de texto, recuperar detalhes do arquivo, e gerenciar permissões de arquivo. |
| Microsoft SharePoint Online Agente de IA de gestão de listas | Automatiza as operações do SharePoint, como gerenciar listas, criar e renovar assinaturas, recuperar detalhes da lista e automatizar fluxos de trabalho. |
| Microsoft SharePoint Online Agente de IA de gestão de sites | Automatiza as operações do SharePoint, como criar e excluir sites, gerenciar conjuntos de sites, recuperar informações do site e automatizar fluxos de trabalho do SharePoint. |
| Microsoft SharePoint Online Agente de IA de gestão de grupo | Automatiza processos de gestão de grupo, como adicionar ou remover usuários de grupos, criar ou excluir grupos, atualizar a propriedade do grupo e gerenciar funções em sites do SharePoint. |
| Microsoft SharePoint Online Agente de IA de gestão de itens de lista | Automatiza as operações do SharePoint, como criar, atualizar, excluir e recuperar itens da lista. |
| Microsoft SharePoint Online Agente de IA de gestão de usuários | Automatiza tarefas de gestão de usuários, como recuperar grupos do SharePoint do usuário, informações do usuário por nome de login e detalhes do usuário por e-mail. |
| Microsoft SharePoint Online Agente de IA para gestão de pastas | Automatiza tarefas de gestão de pastas, como renomear pastas, criar pastas, compartilhar e cancelar o compartilhamento de pastas com usuários ou grupos, listar arquivos e pastas e excluir pastas. |
| Microsoft SharePoint Online Agente de IA de gestão de mudanças | Execute as ações Obter próximo token e Obter token de link delta para unidade. |
| Microsoft SharePoint Online Agente de IA de gestão de pesquisa | Recupera os resultados de consulta de pesquisa necessários e permite que os usuários simplifiquem os processos. |
Procurando um agente de IA?
- Pode haver agentes de IA instalados com o. Now Assistaplicações que não são usadas em fluxos de trabalho agentivos. Para saber como ver todos os agentes disponíveis em sua instância, consulte Encontre agentes de IA .
- Para encontrar agentes que podem não estar instalados em sua instância, visite Mercado de agentes de IA em ServiceNow Store.
Nota:
Certifique-se de que o usuário que executa um agente de IA tenha as funções e permissões necessárias para acessar dados ou executar operações em dados na tabela associada ao agente de IA.
Requisitos de conta do SharePoint Online
. Microsoft SharePoint Online O spoke requer que você crie um aplicativo personalizado em sua conta do SharePoint Online para gerar tokens OAuth 2,0. Consulte Configure a aplicação OAuth no Microsoft Azure.
Requisitos de aliases de conexão e credencial
IntegrationHub 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.
- Locatário único
- Este spoke inclui o registro de alias do MicrosoftSharepointOnline para autorizar ações Microsoft SharePoint Online. Selecione este alias no registro de locatário para autorizar mudanças no Microsoft SharePoint Online para um único locatário.
- Vários locatários
- Este spoke inclui o registro de alias do MicrosoftSharepointOnline para autorizar ações Microsoft SharePoint Online. Crie um registro de alias de conexão e credencial para cada site de locatário adicional ao qual você deseja oferecer suporte. Selecione o alias correto no registro de 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 Crie aliases para vários locatários.
Nota:
Três registros de alias estão disponíveis por padrão com o spoke: Assinatura do site raiz do SharePoint Online, do SharePoint Graph e do SharePoint Graph. Cada registro de alias requer que um locatário seja associado a ele. Se você pretende usar todas as ações SharePoint Online, Graph e Assinatura raiz no spoke, você deve garantir que criou três registros de locatário nas tabelas de locatários do spoke do Microsoft SharePoint Online para que cada registro de locatário seja associado ao respectivo registro de alias.
- Se estiver configurando uma integração para um único locatário, use o existente MicrosoftSharepointOnline registro de alias.
- Você pode usar vários locatários com Microsoft SharePoint Graph alias de conexão somente.