Testar conexões do Webhook
Criado para:
- Desenvolvedor
Para verificar se a implementação do webhook do seu documento funciona corretamente, execute os testes manuais nesta seção. Essas etapas passam pela interface da Web do Adobe Workfront e atingem indiretamente os endpoints da implementação do webhook.
Pré-requisitos
Os seguintes pré-requisitos são necessários para executar os testes:
-
Uma conta do Workfront com o Gerenciamento avançado de documentos (ADM) habilitado
-
Um usuário do Workfront para esta conta com direitos de administrador do sistema
-
Uma instância do Webhook de documentos com pontos de extremidade HTTP acessíveis para o Workfront
Esses testes também pressupõem que a instância do Webhook do documento está registrada. (Você pode registrar sua instância no Workfront em Configuração > Documentos > Integrações personalizadas.)
Teste 1: provisionar o serviço Webhook de documentos para um usuário
Testa o URL de autenticação e o URL do ponto de extremidade do token para provedores de Webhook baseados em OAuth.
- No Workfront, vá para a página principal Documentos clicando no link Documentos na barra de navegação superior.
- Clique na lista suspensa Adicionar documentos e selecione o serviço Webhook de documentos em Adicionar serviço.
- (Somente serviços OAuth) Depois de concluir a etapa anterior, você verá o carregamento da página de autenticação OAuth2 do seu serviço em uma janela pop-up. (Observação: você pode ser solicitado a fazer logon no serviço primeiro.) Na página de autenticação, conceda acesso à conta do usuário pelo Workfront clicando no botão Confiar ou Permitir.
- Verifique se o serviço foi adicionado à lista suspensa Adicionar documentos. Caso não o veja inicialmente, tente atualizar o navegador.
Teste 2: Vincular um documento no Workfront Testa os seguintes pontos de extremidade: /files, /metadata
- No Workfront, vá para a página principal Documentos clicando no link Documentos na barra de navegação superior.
- Selecione o serviço Webhook de documentos em Adicionar documentos.
- Na modal, navegue pela estrutura de pastas.
- Verifique se você pode navegar pela estrutura de pastas.
- Selecionar e vincular um documento ao Workfront
Teste 3: Navegar até um documento no sistema de gerenciamento de conteúdo
Testa os seguintes pontos de extremidade: /metadata (especificamente o viewLink)
- Vincular um documento ao Workfront
- Selecione o documento e clique no link Abrir.
- Verifique se o documento abre em uma nova guia.
Teste 4: Navegar até um documento no sistema de gerenciamento de conteúdo (com logon)
Testa os seguintes pontos de extremidade: /metadata (especificamente o viewLink)
- Verifique se você está desconectado do sistema de gerenciamento de conteúdo.
- Vincule um documento ao Workfront.
- Selecione o documento e clique no link Abrir.
- Verifique se a tela de logon do sistema de gerenciamento de conteúdo é carregada em uma nova guia.
- Faça logon e verifique se você está direcionado ao documento
Teste 5: Baixar o documento do sistema de gerenciamento de conteúdo
Testa os seguintes pontos de extremidade (especificamente o link de download): /metadata
- Vincule um documento ao Workfront.
- Selecione o documento e clique no link Download.
- Verifique se o download foi iniciado.
Teste 6: Pesquisar por conteúdo
Testa os seguintes pontos de extremidade: /search
- No Workfront, vá para a página principal Documentos clicando no link Documentos na barra de navegação superior.
- Selecione o serviço Webhook de documentos em Adicionar documentos.
- No modal, execute uma pesquisa.
- Verifique se os resultados da pesquisa estão corretos.
Teste 7: Enviar documento do Workfront para o sistema de gerenciamento de conteúdo
Testa os seguintes pontos de extremidade: /files, /uploadInit, /upload
- No Workfront, vá para a página principal Documentos clicando no link Documentos na barra de navegação superior.
- Fazer upload de um documento para o Workfront no seu computador
- Ir para a página de detalhes do documento
- Na lista suspensa Ações do documento, selecione o serviço Webhook do documento em Enviar para…
- Vá para a pasta de destino desejada e clique no botão Save.
- Verifique se o documento foi carregado no local correto no sistema de gerenciamento de conteúdo.
Teste 8: Exibir Miniaturas no Workfront
Testa os seguintes pontos de extremidade: /thumbnail
- Vincule um documento ao Workfront.
- Selecione o documento na lista.
- Verifique se a miniatura aparece no painel direito.
Teste 9: obter os bytes de conteúdo
Testa os seguintes pontos de extremidade: /download
- Vincule um documento ao Workfront.
- Vá para a página de detalhes do documento.
- Envie o documento para o Workfront selecionando Ações do documento > Enviar para… > Workfront. Isso criará uma nova versão do documento no Workfront.
- Baixe o documento do Workfront clicando no link Download.
Teste 10: atualizar token de acesso (somente provedores de Webhook OAuth2)
Testa os seguintes endpoints: URL do endpoint do token
- Provisionar um serviço Webhook de documento para um usuário
- Invalidar o token de acesso do usuário 1 (aguardando o tempo limite) ou 2) invalidando-o manualmente no sistema externo.
- Atualize o token de acesso no Workfront. Você pode fazer isso, por exemplo, vinculando um documento ao Workfront. Você saberá que o token de acesso foi atualizado com êxito se conseguir navegar e vincular um documento.