Microsoft OneDrive Spoke

Solicitar aplicativos na Store

Visite ServiceNow Storepara exibir todos os apps 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

Spoke do Microsoft OneDrive v 2.8.2 é 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)

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

Versão v1 da API.

Fluxos de spoke

. Spoke do Microsoft OneDrive fornece fluxos de amostra no estado de rascunho para demonstrar a automação Microsoft OneDrive tarefas. Para personalizar um fluxo de amostra, copie-o para um novo escopo da aplicação. Os fluxos de amostra disponíveis incluem:


Fluxo	Descrição
Renovar assinaturas	Renova as assinaturas expiradas atualizando a data de expiração da assinatura.

Subfluxos do spoke

. Spoke do Microsoft OneDrive fornece subfluxos de amostra no estado de rascunho para demonstrar a automação Microsoft OneDrive tarefas. Para personalizar um subfluxo de amostra, copie-o para um novo escopo da aplicação. Os subfluxos de amostra disponíveis incluem:


Subfluxo	Descrição
Baixe o novo arquivo do OneDrive para a ServiceNow	Baixa os novos arquivos carregados em um recurso para um registro da ServiceNow
Inscreva-se no webhook	Assina uma aplicação ouvinte para receber notificações quando os dados mudam.
Sincronizar mudanças	Rastreia mudanças em uma unidade e seus secundários ao longo do tempo.
Obter o documento mais recente URL	Obtém o caminho mais recente de um arquivo no OneDrive usando o SYS ID do documento como uma entrada. Para usar este subfluxo, uma conexão e credencial correspondentes do OneDrive devem ser criadas e um token de autorização do OneDrive deve estar disponível.
Reconecte o documento do Microsoft OneDrive	Obtém o URL da web e o URL do webdav mais recentes de um documento do Microsoft OneDrive usando o SYS ID do documento, o SYS ID do detalhe do provedor, o Nome da tabela de destino, o SYS ID da tabela de destino e o Nome do documento. Para usar este subfluxo, uma conexão e credencial correspondentes do OneDrive devem ser criadas e um token de autorização do OneDrive deve estar disponível.

Ações do spoke

. Spoke do Microsoft OneDrive fornece ações para automatizar Microsoft OneDrive tarefas quando ocorrem eventos em ServiceNow. As ações disponíveis incluem:


Categoria	Ação	Descrição
Gestão de unidades	Pesquisar informações da unidade	Obtém os metadados de um específico Microsoft OneDrive unidade
Gestão de pastas	Mover arquivo ou item de pasta	Move um arquivo ou pasta para Microsoft OneDrive para o local de destino.
	Criar pasta	Cria uma pasta em Microsoft OneDrive.
	Atualize o nome do arquivo ou da pasta	Atualiza o nome de um item de arquivo ou pasta por ID.
	Excluir arquivo ou item de pasta	Exclui um arquivo ou pasta de Microsoft OneDrive.
Gestão de arquivos	Check-in do arquivo	Faz o check-in de um item da unidade e envia um convite de compartilhamento. Quando você faz check-in de um arquivo, outros usuários podem acessar o arquivo em check-in.
	Check-out do arquivo	Faz check-out de um item de unidade do OneDrive. Quando você faz check-out de um item da unidade, outros usuários não podem editar o documento. Outros usuários também não podem ver as mudanças feitas no documento até que você faça check-in no documento.
	Copie o arquivo do OneDrive para o anexo	Copia um arquivo em Microsoft OneDrive para um anexo em um registro em um ServiceNow registro.
	Copiar anexo para o OneDrive	Copia um registro de anexo em ServiceNow para Microsoft OneDrive
	Item de arquivo ou pasta	Cria de forma assíncrona uma cópia de um Microsoft OneDrive item (incluindo secundários), com um novo item primário ou com um novo nome.
	Pesquisar itens	Recupera uma lista de itens de unidade de um caminho ou a origem e o ID de origem de um item de unidade.
	Pesquisar informações de item de arquivo ou pasta por ID	Obtém informações de metadados do arquivo do ID de arquivo ou pasta em Microsoft OneDrive.
	Pesquisar informações de item de arquivo ou pasta por caminho	Obtém informações de metadados do arquivo do caminho do arquivo em Microsoft OneDrive.
	Copie o anexo para o OneDrive usando o caminho	Copia um registro de anexo na ServiceNow para o OneDrive.
	Copie o arquivo do OneDrive para o anexo usando o caminho do arquivo	Copia um arquivo usando seu caminho no OneDrive para um anexo em um registro na ServiceNow.
	Copie a versão do arquivo do OneDrive para o anexo	Copia um arquivo no OneDrive para um anexo em um registro na ServiceNow.
	Excluir versão de um arquivo	Exclui a versão especificada de um arquivo do OneDrive.
	Pesquisar todas as versões de um arquivo	Recupera todas as versões de um arquivo no OneDrive.
	Versão do arquivo de restauração	Restaura a versão do arquivo especificada e torna esta versão a mais recente.
	Carregar e substituir arquivo	Carrega a versão atualizada de um arquivo existente ou substitui o arquivo existente por um novo arquivo. Nota: O tamanho máximo do arquivo não pode exceder 4 MB.
Documentos de pesquisa	Pesquisar arquivos ou itens de pasta	Pesquisa os itens da unidade (arquivos ou pastas) com base em atributos de metadados, como o nome do item.
Compartilhamento de documentos	Adicionar colaborador	Adiciona um colaborador e suas permissões a um arquivo ou pasta. Você pode identificar o colaborador pelo alias do Azure AD ou por um ID de objeto.
	Pesquisar colaboradores	Lista todos os detalhes do colaborador associados a um arquivo ou pasta no Microsoft OneDrive.
	Remover colaborador	Remove um colaborador de um arquivo ou pasta em Microsoft OneDrive.
Gestão de permissões	Adicionar permissão	Envia um convite de compartilhamento para um item da unidade. Um convite de compartilhamento permite que os destinatários acessem o item da unidade e, opcionalmente, envia um e-mail com um link de compartilhamento.
	Criar link de compartilhamento	Cria um link de compartilhamento que permite compartilhar um item da unidade com outros usuários.
	Excluir permissão	Remove o acesso a um item da unidade.
	Pesquisar permissões	Recupera as permissões de compartilhamento de um item de unidade.
	Atualizar permissão	Atualiza a data de expiração da assinatura.
Gestão de Webhook	Assinar webhook	Cria uma assinatura que envia notificações quando os dados são alterados.
	Cancelar assinatura do webhook	Exclui o ID de assinatura especificado.
	Obter token de sincronização para assinatura	Recupera o token de sincronização mais recente para o ID de assinatura especificado.
	Pesquisar assinaturas	Recupera a lista de assinaturas ativas.
	Renovar assinatura	Atualiza a data de expiração da assinatura.
	Sincronizar mudanças	Rastreia mudanças em uma unidade e nos secundários da unidade ao longo do tempo.

Agentes de IA disponíveis

Instalar Now Assist para IntegrationHub E comece a usar os agentes de IA disponíveis. Para obter mais informações, consulte Now Assist para IntegrationHub.

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 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 sua necessidade. Consulte para obter mais informações sobre como criar um clone.
Consulte Para obter informações sobre agentes de IA.

Os agentes de IA disponíveis incluem:


Agente de IA	Descrição
Microsoft OneDrive Agente de IA de gestão de compartilhamento	Adiciona ou remove um colaborador e gerencia suas permissões para um arquivo ou pasta em Microsoft OneDrive. Lista todos os detalhes do colaborador associados a um arquivo ou pasta.
Microsoft OneDrive Agente de IA de gestão do Drive	Recupera os metadados de uma unidade específica em Microsoft OneDrive.
Microsoft OneDrive Agente de IA para gestão de arquivos	Gerencia arquivos, versões de arquivos e anexos no Microsoft OneDrive. Recupera detalhes do arquivo necessário.
Microsoft OneDrive Agente de IA para gestão de pastas	Gerencia pastas em Microsoft OneDrive.
Microsoft OneDrive Agente de IA de gestão de permissões	Cria link de compartilhamento para um item de unidade e gerencia permissões.

Pode haver agentes de IA instalados com o. Now Assist aplicações que não são usadas em fluxos de trabalho agentivos. Para saber como ver todos os agentes disponíveis para você, consulte Encontre agentes de IA .

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.

Módulo Spoke

Os webhooks bidirecionais podem ser configurados para receber notificações sobre os eventos necessários. A política de roteamento define condições que devem ser atendidas para notificar o app ServiceNow. Essas condições são baseadas nos eventos no OneDrive sobre os quais você deseja ser notificado. Quando as condições são atendidas, uma política de roteamento aciona o subfluxo associado, que, por sua vez, automatiza as tarefas do OneDrive.

Os webhooks bidirecionais exigem configuração separada e podem ser usados independentemente sem usar as ações do spoke. Por predefinição, a aplicação Webhooks do OneDrive está disponível no Spoke do OneDrive e tem os seguintes módulos:


Módulo	Descrição
Token de sincronização do OneDrive	Permite exibir Tokens de sincronização do OneDrive.
Registros do Webhook do OneDrive	Permite que você crie e exiba os webhooks do OneDrive na ServiceNow.
Política de roteamento do webhook do OneDrive	Permite que você crie e exiba as políticas de roteamento para os webhooks do OneDrive na ServiceNow. Você também pode personalizar as condições nas políticas de roteamento de acordo com sua necessidade.

Requisitos da conta do OneDrive Online

. Spoke do Microsoft OneDrive Requer um app personalizado que você cria 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: O spoke do OneDrive inclui o registro de alias do OneDrive para autorizar ações no Microsoft OneDrive. Selecione este alias no registro de locatário para autorizar mudanças em Microsoft OneDrive para um único locatário.

Para obter informações sobre como configurar o spoke, consulte Configurar Microsoft Spoke do OneDrive.

Requisitos do MID Server

Essas ações usam chamadas REST que podem ser executadas em uma instância ou, opcionalmente, por meio de um MID Server. Use o registro de conexão associado ao alias do Microsoft OneDrive para configurar onde as ações serão executadas e, se necessário, especifique MID Server atributos de seleção. Para obter mais informações, consulte MID server.

Para configurar o. MID Server para este spoke, consulte Configurar MID Server para um spoke.