Spoke do Box
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 Integration Hub
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 Box v3.2.2 é a versão mais recente.
Versões com suporte
Versão da API v2.
Requisitos do spoke
Certifique-se de que os mesmos idiomas sejam selecionados na instância ServiceNow e na conta do Box.
- Na instância ServiceNow, selecione o idioma necessário navegando até .
- Em sua conta do Box, selecione o idioma necessário navegando até .
Fluxos de spoke
O Spoke do Box fornece fluxos de amostra no estado de rascunho para demonstrar a automatizaçã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 a caixa | Move os arquivos de anexo de ServiceNow para a caixa 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 usuário ServiceNow no grupo Usuários do Box. |
Ações do spoke
O Spoke do Box fornece 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 | Especifica dados personalizados para um arquivo ou pasta específica. |
| Anexar arquivo de caixa para registro | Copia um arquivo do Box e o anexa ao registro ServiceNow especificado. | |
| Pesquisar ID do arquivo | 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 uma pasta ou arquivo 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 à caixa 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 tenham passado 10 minutos. |
|
| 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. | |
| Pesquisar ID do usuário | 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. |
Módulo de spoke do Box
Os 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 aplicativo da 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, que por sua vez automatiza as tarefas do Box.
| Módulo | Descrição |
|---|---|
| Registro do webhook pronto para uso | Crie e exiba os webhooks do Plivo na ServiceNow. |
| Políticas de retenção jurídica | Exiba a lista de apólices 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 de conta do Box
O Spoke do Box requer a criação de um app personalizado em sua conta do Box para gerar tokens OAuth 2.0. Consulte Criar uma aplicação OAuth.
Requisitos de aliases de conexão e credencial
Integration Hub 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 de colaboração e gestão de arquivos do Box. |
|
| Carregamento de caixa | Conexão com o serviço de upload 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 Configurar o spoke do Box.