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 Programações jurídicas - Visão geral do IntegrationHub.

Versão do spoke

Spoke do Microsoft OneDrive v2.3.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 da API v1.

Fluxos do spoke

O Spoke do Microsoft OneDrive fornece fluxos de amostra no estado de rascunho para demonstrar a automação de tarefas Microsoft OneDrive. 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

O Spoke do Microsoft OneDrive fornece subfluxos de amostra no estado de rascunho para demonstrar a automação de 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
Baixar novo arquivo do OneDrive para a ServiceNow	Baixa os novos arquivos carregados em um recurso para um registro da ServiceNow
Assinar 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.
Reconectar 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 ID do sistema do documento, o ID do sistema de detalhes do provedor, o nome da tabela de destino, o ID do sistema 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

O Spoke do Microsoft OneDrive fornece ações para automatizar Microsoft OneDrive tarefas quando os eventos ocorrem 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 uma unidade Microsoft OneDrive específica
Gestão de pastas	Mover arquivo ou item de pasta	Move um arquivo ou pasta em Microsoft OneDrive para o local de destino.
	Criar pasta	Cria uma pasta em Microsoft OneDrive.
	Atualizar nome do arquivo ou pasta	Atualiza o nome de um arquivo ou item de pasta por ID.
	Excluir arquivo ou item da pasta	Exclui um arquivo ou uma 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 de unidade, outros usuários não podem editar o documento. Outros usuários também não podem ver as mudanças que você fez no documento até que você faça o check-in do documento.
	Copiar arquivo do OneDrive para anexo	Copia um arquivo em Microsoft OneDrive para um anexo em um registro em um registro ServiceNow.
	Copiar anexo no OneDrive	Copia um registro de anexo em ServiceNow para Microsoft OneDrive
	Copiar arquivo ou item de pasta	Cria de forma assíncrona uma cópia de um item Microsoft OneDrive (incluindo secundários), em 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 ou ID da 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.
	Copiar anexo no OneDrive usando caminho	Copia um registro de anexo na ServiceNow para o OneDrive.
	Copiar arquivo do OneDrive para anexo usando o caminho do arquivo	Copia um arquivo usando seu caminho no OneDrive para um anexo em um registro na ServiceNow.
	Copiar versão do arquivo do OneDrive para 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 da 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 em 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 de unidade. Um convite de compartilhamento permite que os destinatários acessem o item da unidade e, opcionalmente, envia a eles um e-mail com um link de compartilhamento.
	Criar link de compartilhamento	Cria um link de compartilhamento que permite compartilhar um item de unidade com outros usuários.
	Não tem permissão para excluir	Remove o acesso a um item de unidade.
	Pesquisar permissões	Recupera as permissões de compartilhamento de um item de 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 assinatura	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 unidades secundárias ao longo do tempo.

Módulo do spoke

Os webhooks bidirecionais podem ser configurados para receber notificações sobre os eventos necessários. A política de roteamento define as condições que devem ser atendidas para notificar o app da 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 de forma independente 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 criar e exibir os webhooks do OneDrive na ServiceNow.
Política de roteamento do Webhook do OneDrive	Permite criar e exibir as políticas de roteamento dos webhooks do OneDrive na ServiceNow. Você também pode personalizar as condições nas políticas de roteamento de acordo com seus requisitos.

Requisitos de conta do OneDrive Online

O Spoke do Microsoft OneDrive requer um app personalizado que você cria 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: O spoke do OneDrive inclui o registro de alias do OneDrive para autorizar ações no Microsoft OneDrive. Selecione este alias no registro do 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 MID Server. Use o registro de conexão associado ao alias do Microsoft OneDrive para configurar onde as ações são executadas, bem como definir MID Server atributos de seleção. Para obter mais informações, consulte MID server.