Box Spoke
Mova os anexos para a caixa em que eles possam ser gerenciadas como documentos compartilhados.
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 Boxv 3.4.0 é a versão mais recente.
Versões com suporte
API versão v2.
Requisitos do spoke
Certifique-se de que os mesmos idiomas estejam selecionados em ServiceNow Conta do Box e instância.
- Em seu ServiceNow selecione o idioma necessário navegando até .
- Em sua conta do Box, selecione o idioma desejado navegando até .
Fluxos de spoke
. Spoke do BoxFornece fluxos de amostra no estado de rascunho para demonstrar a automação de tarefas do Box. 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 |
|---|---|
| Mover anexo quando criado para o Box | Move arquivos de anexo de ServiceNow Para o Box quando um novo registro de anexo é adicionado. Atualiza o registro do gatilho com um link compartilhado para o arquivo de anexo movido no Box. |
| Usuário de integração | Cria um usuário no Box quando você cria um ServiceNow usuário no Usuário do Box grupo. |
Ações do spoke
. Spoke do BoxFornece ações para automatizar tarefas do Box quando ocorrem eventos em ServiceNow. As ações disponíveis incluem:
| Categoria | Ação | Descrição |
|---|---|---|
| Gestão de documentos | Adicionar metadados ao arquivo | Armazena as informações de atributos fornecidas adicionando-as como metadados para arquivos do Box. |
| Anexar arquivo de caixa para registro | Copia um arquivo do Box e o anexa ao especificado ServiceNow registro. | |
| ID do arquivo de pesquisa | Recupera o ID do arquivo especificado no Box. | |
| Mover item de propriedade | Move todos os itens pertencentes ao usuário especificado no Box para a pasta especificada. | |
| Remover arquivo | Remove o arquivo especificado do Box. | |
| Pesquisar fluxo de conteúdo | Pesquisa arquivos, pastas, links da web e arquivos compartilhados no conteúdo do usuário ou em toda a empresa. | |
| Carregar Arquivo | Carrega o arquivo especificado para o Box. | |
| Compartilhamento de Documentos | Adicionar colaborador | Concede a um usuário ou grupo um nível especificado de acesso a um arquivo ou pasta específico. Os colaboradores têm um desses níveis de acesso.
|
| Criar link compartilhado | Crie um link direto e somente leitura para um arquivo ou pasta no Box. | |
| Pesquisar colaboradores de pasta por ID | Recupera todos os colaboradores associados ao ID de pasta especificado. | |
| Remover colaborador | Remove a colaboração especificada de um arquivo ou pasta no Box. | |
| Gestão de pastas | Criar pasta | Cria uma pasta no Box em nome da conta de usuário do Box especificada. |
| Excluir pasta | Exclui a pasta especificada no Box. | |
| Pesquisar ID da pasta | Recupera o ID da pasta especificada no Box. Nota: Os itens adicionados ao Box exigem 10 minutos para se tornarem acessíveis. Por exemplo, se uma ação criar uma pasta, uma ação Pesquisar ID de pasta não retornará resultados até que 10 minutos tenham passado. |
|
| Gestão de grupo | Criar Grupo | Cria um grupo no Box com as preferências de convite especificadas. |
| Excluir Grupo | Exclui o grupo especificado no Box. | |
| Atualizar grupo | Atualiza o grupo especificado no Box com as preferências especificadas. | |
| Gestão de retenção jurídica | Atribuir política de retenção jurídica | Atribui uma política de retenção jurídica a um arquivo, versão de arquivo, pasta ou usuário. |
| Crie política de retenção jurídica | Cria uma política de retenção jurídica. | |
| Pesquisar todo o fluxo de políticas de retenção jurídica | Recupera uma lista de políticas de retenção jurídica de uma empresa. | |
| Pesquisar atribuição de política de retenção jurídica por ID | Recupera uma atribuição de política de retenção jurídica para o ID especificado. | |
| Pesquisar fluxo de atribuições de política de retenção jurídica | Recupera uma lista de itens atribuídos a uma política de retenção jurídica. | |
| Pesquisar atribuição de política de retenção jurídica por ID | Recupera uma política de retenção jurídica para o ID especificado. | |
| Remover política de retenção jurídica | Exclui uma política de retenção jurídica existente. | |
| Desatribuir política de retenção jurídica | Remove a atribuição de um item a uma retenção jurídica. | |
| Atualiza a política de retenção jurídica | Atualiza uma política de retenção jurídica. | |
| Gestão de metadados | Pesquisar instância de metadados na pasta por ID de pasta | Recupera a instância de metadados do arquivo com o ID de arquivo especificado. |
| Pesquisar instância de metadados no arquivo por escopo e chave de modelo | Recupera a instância de metadados de uma pasta com o escopo e a chave de modelo especificados. | |
| Pesquisar instância de metadados na pasta por ID de pasta | Recupera todos os metadados da pasta com o ID de pasta especificado. Nota: Não use esta ação em uma pasta raiz que tenha um valor de ID de pasta igual a zero. |
|
| Pesquisar instância de metadados na pasta por escopo e chave de modelo | Recupera todos os metadados de uma pasta com o escopo e a chave de modelo especificados. | |
| Consultar arquivos ou pastas por fluxo de metadados | Pesquisa arquivos ou pastas usando sintaxe semelhante a SQL e retorna os resultados correspondentes. | |
| Gestão de política de retenção | Atribuir política de retenção | Atribui uma política de retenção a um item. |
| Criar política de retenção | Cria uma política de retenção. | |
| Pesquisar políticas de retenção | Recupera todas as políticas de retenção de uma empresa. | |
| Pesquisar atribuição da política de retenção por ID | Recupera a política de retenção com o ID especificado. | |
| Pesquisar fluxo de atribuições da política de retenção | Retorna uma lista de todas as atribuições de política de retenção associadas a uma política de retenção especificada. | |
| Pesquisar política de retenção por ID | Recupera a política de retenção com o ID especificado. | |
| Atualizar política de retenção | Atualiza uma política de retenção. | |
| Gestão de usuários | Adicionar usuário ao grupo | Adiciona o usuário especificado ao grupo especificado no Box. |
| Criar usuário | Cria uma conta de usuário no Box. | |
| Excluir Usuário | Exclui o usuário especificado no Box. | |
| Desabilitar usuário | Define o status do usuário especificado no Box como inativo. | |
| Habilitar usuário | Define o status do usuário especificado no Box como ativo. | |
| ID do usuário de pesquisa | Recupera o ID do usuário especificado no Box. | |
| Atualizar usuário | Atualiza o usuário especificado no Box com as mudanças de função especificadas. | |
| Gestão de Webhook | Criar webhook | Cria um webhook. |
| Pesquisar webhook por ID | Recupera o webhook com o ID especificado. | |
| Pesquisar fluxo de webhooks | Recupera todos os webhooks definidos para a aplicação especificada. | |
| Remover webhook | Remove um webhook. | |
| Atualizar webhook | Atualiza um webhook. |
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.
- 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.
| Agente de IA | Descrição |
|---|---|
| Agente de IA de gestão de usuários do Box | Gerencia tarefas de gestão de usuários (ou seja, adiciona um usuário ao grupo, habilita um usuário, cria usuário, exclui usuário, atualiza usuário, pesquisar ID do usuário, desabilitar usuário) no Box. |
| Agente de IA de gestão de pastas do Box | Gerencia tarefas de gestão de pastas (ou seja, criar uma pasta, pesquisar o ID da pasta, excluir uma pasta) no Box. |
| Agente de IA de compartilhamento de documentos do Box |
Gerencia tarefas de compartilhamento de documentos (ou seja, remover um colaborador, adicionar um colaborador, criar um link compartilhado, pesquisar os colaboradores da pasta por ID) no Box. |
| Agente de IA de gestão de grupos do Box | Gerencia tarefas de gestão de grupo (ou seja, atualizar um grupo, criar um grupo, excluir um grupo) no Box. |
| Agente de IA de gestão de metadados do Box | Gerencia tarefas de recuperação de metadados (ou seja, pesquisar uma instância de metadados em um arquivo por escopo e chave de modelo, pesquisar uma instância de metadados em uma pasta por ID de pasta, pesquisar uma instância de metadados em uma pasta por escopo e chave de modelo, pesquisar uma instância de metadados em um arquivo por ID de arquivo) no Box. |
| Agente de IA de gestão de políticas de retenção do Box | Gerencia tarefas de gestão de política de retenção (ou seja, atualizar uma política de retenção, pesquisar um fluxo de políticas de retenção, pesquisar uma atribuição de política de retenção por ID, pesquisar uma política de retenção por ID, pesquisar um fluxo de atribuições de política de retenção) no Box. |
| Agente de IA de gestão de documentos do Box | Gerencia tarefas de gestão de documentos (ou seja, remover um arquivo, anexar um arquivo de caixa a um registro, carregar um arquivo, mover um item de propriedade, pesquisar um fluxo de conteúdo, pesquisar um ID de arquivo, adicionar metadados a um arquivo) no Box. |
| Agente de IA de gestão de retenção jurídica do Box | Gerencia tarefas de gestão de retenção jurídica (ou seja, criar uma política de retenção jurídica, pesquisar uma atribuição de política de retenção jurídica por ID, atualizar uma política de retenção jurídica, pesquisar todos os fluxos de políticas de retenção jurídica, pesquisar uma política de retenção jurídica por ID, cancelar atribuição de uma política de retenção jurídica, remover uma política de retenção jurídica, pesquisar um fluxo de atribuições de política de retenção jurídica) no Box. |
- 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.
Módulo Spoke do Box
Webhooks bidirecionais podem ser configurados para serem notificados sobre os eventos necessários. Um registro de webhook define as condições que devem ser atendidas para notificar o app ServiceNow. Essas condições são baseadas nos eventos no Box sobre os quais você deseja ser notificado. Quando as condições são atendidas, o nome do gatilho especificado aciona o subfluxo associado, o que, por sua vez, automatiza as tarefas do Box.
| Módulo | Descrição |
|---|---|
| Registro do webhook pronto para uso | Crie e exiba os webhooks da Plivo na ServiceNow. |
| Políticas de retenção jurídica | Exiba a lista de políticas jurídicas do Box disponíveis. |
| Políticas de Retenção | Exiba a lista de políticas de retenção do Box disponíveis. |
Requisitos da conta do Box
. Spoke do BoxRequer a criação de um app personalizado em sua conta do Box para gerar tokens OAuth 2,0. Consulte Crie uma aplicação OAuth.
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.
Este spoke usa os seguintes registros de alias para autorizar ações.
| Alias de conexão e credencial | Descrição | Requisitos de alias de conexão |
|---|---|---|
| Caixa | Conexão com as APIs Colaboração do Box e Gestão de arquivos. |
|
| Carregamento do Box | Conexão com o serviço de carregamento do Box. |
|
Para usar os aliases de conexão do spoke, crie um registro de conexão associado e um registro de credencial associado para cada alias. Para obter informações sobre como configurar o spoke, consulte Configure o spoke do Box.