Microsoft OneDrive 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 Cronogramas jurídicos - Visão geral do IntegrationHub.

Versão do spoke

Spoke do Microsoft OneDrivev 2.6.0 é 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 com suporte

API versão v1.

Fluxos de spoke

. Spoke do Microsoft OneDrivefornece fluxos de amostra no estado de rascunho para demonstrar a automação Microsoft OneDrivetarefas. 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 vencimento da assinatura.

Subfluxos do spoke

. Spoke do Microsoft OneDrivefornece subfluxos de amostra no estado de rascunho para demonstrar a automação Microsoft OneDrivetarefas. 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
Baixar Novo Arquivo do OneDrive para ServiceNow	Baixa os novos arquivos carregados em um recurso para um registro da ServiceNow
Assinar o webhook	Assina uma aplicação ouvinte para receber notificações quando os dados são alterados.
Sincronizar mudanças	Rastreia mudanças em uma unidade e respectivos itens 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 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 detalhado 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 OneDrivefornece ações para automatizar Microsoft OneDrivetarefas quando ocorrem eventos em ServiceNow. As ações disponíveis incluem:


Categoria	Ação	Descrição
Gestão de unidade	Pesquisar informações da unidade	Obtém os metadados de um específico Microsoft OneDriveunidade
Gestão de pastas	Mover arquivo ou item de pasta	Move um arquivo ou pasta no Microsoft OneDrivepara o local de destino.
	Criar pasta	Cria uma pasta em Microsoft OneDrive.
	Atualizar nome do arquivo ou pasta	Atualiza o nome de um item de arquivo ou pasta por ID.
	Excluir arquivo ou item da pasta	Exclui um arquivo ou pasta de Microsoft OneDrive.
Gestão de arquivos	Fazer check-in do arquivo	Faz check-in de um item de unidade e envia um convite de compartilhamento. Quando você faz check-in de um arquivo, outros usuários podem acessar o arquivo submetido a check-in.
	Fazer 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 do documento.
	Copiar arquivo do OneDrive para anexo	Copia um arquivo no Microsoft OneDrivepara um anexo em um registro em um ServiceNow registro.
	Copiar anexo no OneDrive	Copia um registro de anexo no ServiceNow. Microsoft OneDrive
	Copiar arquivo ou item de pasta	Cria de forma assíncrona uma cópia de um Microsoft OneDriveitem (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 do arquivo ou da pasta em Microsoft OneDrive.
	PESQUISE 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.
	Copiar anexo no OneDrive usando 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.
	Copiar 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.
	Restaurar versão do arquivo	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.
Pesquisar Documentos	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.
	Não tem permissão para excluir	Remove o acesso a um item da unidade.
	Pesquisar permissões	Recupera as permissões de compartilhamento de um item da unidade.
	Atualizar permissão	Atualiza a data de vencimento 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 SyncToken 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 vencimento 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 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 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.

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.

Módulo Spoke

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 aplicativo 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 padrão, a aplicação Webhooks do OneDrive está disponível no spoke do OneDrive e tem os seguintes módulos:


Módulo	Descrição
OneDrive SyncToken	Permite que você exiba SyncTokens do OneDrive.
Registros de 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 seu requisito.

Requisitos da conta do OneDrive Online

. Spoke do Microsoft OneDriveRequer 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 no Microsoft OneDrivepara 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 Serverpara este spoke, consulte Configurar MID Server para um spoke.