--- title: Documentos do quadro e da tarefa slug: documentos-do-quadro-e-da-tarefa docTags: createdAt: 2026-08-15T00:33:21.989Z --- :::BlockQuote Anexe arquivos ao Board ou a uma task, classifique-os por tipo, consulte os metadados e baixe ou exclua documentos conforme sua permissão. ::: :::hint{type="info"} **Pré-requisito:** Tenha um projeto com a capability de Documentos, Board principal e uma sessão com permissão de visualização. Upload e exclusão exigem a permissão de edição; a gestão do catálogo exige edição e ser administrador do Workspace ou responsável pelo projeto. ::: *** Documentos existem em dois níveis. A tela "Documentos" do Board lista os arquivos do projeto/Board em uma tabela completa; o painel compacto no detalhe da task mostra apenas os anexos daquela tarefa. O mesmo fluxo oferece visualizar detalhes, baixar o arquivo, excluir e, no nível do projeto, configurar os tipos ativos. Cada arquivo é enviado como multipart e recebe um tipo do catálogo do projeto. O tipo pode exigir campos de metadados; por isso o upload não é apenas escolher um arquivo: selecione a classificação, preencha os campos obrigatórios e só então envie. O catálogo é específico do projeto e os tipos inativos deixam de ser opções para novos uploads. *** ### Passo a passo ::::WorkflowBlock :::WorkflowBlockItem **Abrir Documentos do Board** No menu do projeto, selecione "Documentos". A rota valida que a capability está ativa, que o Board solicitado é o Board principal do projeto e que sua sessão tem permissão de visualização. Em um acesso válido, o painel completo mostra o título Documentos e a tabela; não é necessário navegar por uma tela intermediária. ::: :::WorkflowBlockItem **Conferir o catálogo de tipos** Se você pode enviar ou administrar tipos, o painel carrega o catálogo ativo do projeto e preenche o seletor de tipo. O tipo determina o nome exibido na coluna Tipo e quais campos de metadados serão pedidos. Selecione outro tipo quando o arquivo representar uma categoria diferente, em vez de colocar tudo em uma classificação genérica. ::: :::WorkflowBlockItem **Escolher o arquivo** Na área de envio, escolha um arquivo pelo seletor. O componente mantém o arquivo selecionado até o envio terminar, permite escolher novamente o mesmo arquivo e não inicia a operação sem um arquivo. Confirme que o tipo ativo desejado continua selecionado antes de prosseguir. ::: :::WorkflowBlockItem **Preencher metadados** Quando o tipo possui campos configurados, preencha cada campo obrigatório mostrado abaixo do seletor. O painel verifica o texto depois de remover espaços em branco; um campo vazio ou composto apenas por espaços impede o envio. Campos opcionais podem permanecer vazios e não são enviados como metadado. ::: :::WorkflowBlockItem **Enviar o documento** Clique em "Enviar". O Agility envia o arquivo, o tipo e os metadados para o escopo atual. Durante a operação, os controles de upload ficam ocupados; em sucesso, o campo de arquivo e os metadados são limpos e a lista é recarregada no mesmo projeto. Em caso de falha, o arquivo e o tipo permanecem disponíveis para tentar novamente. ::: :::WorkflowBlockItem **Ler a tabela** A tabela apresenta nome do documento, tipo, tamanho, autor e ações. O tamanho é formatado para leitura humana; o autor usa o nome projetado pelo backend e não exibe UUID. Use a busca por nome e o filtro de Tipo para reduzir a lista sem alterar os arquivos. ::: :::WorkflowBlockItem **Abrir detalhes e baixar** Na coluna de ações, abra o botão de informações para ver os detalhes do documento. Use o botão de download para obter um Blob autenticado com o nome original do arquivo; a credencial é enviada pelo fetch e não exposta na URL. O download exige permissão de visualização. ::: :::WorkflowBlockItem **Excluir um documento do Board** Se sua sessão tem edição, use o botão de exclusão na linha. O painel abre a confirmação para o documento específico; confirme apenas depois de verificar nome e tipo. Em sucesso, o diálogo fecha e a tabela é recarregada. A exclusão não é exibida para sessões sem a permissão correspondente. ::: :::WorkflowBlockItem **Configurar tipos do projeto** No cabeçalho da variante completa, administradores e o responsável do projeto com permissão de edição veem "Configurar tipos". Abra esse diálogo para consultar ou manter o catálogo do projeto: cada tipo tem nome, descrição, estado ativo e campos ordenados, que podem ser marcados como obrigatórios. Desative um tipo que não deve mais ser usado sem alterar os documentos históricos que já o utilizam. ::: :::WorkflowBlockItem **Anexar no detalhe da task** Abra um cartão no Quadro e role até "Anexos". O painel compacto usa o escopo Board + Projeto + Task, lista apenas os arquivos vinculados àquela tarefa e repete o envio, detalhes, download e exclusão conforme as permissões. Um documento enviado nesse local não aparece como anexo de outra task; o vínculo é específico da tarefa. ::: :::WorkflowBlockItem **Trocar de projeto ou tarefa com segurança** Ao mudar de projeto, Board ou task, o painel cancela carregamentos e operações do escopo anterior, limpa seleção, metadados, filtros e diálogos e carrega a nova lista. Aguarde a lista do novo contexto antes de enviar ou excluir, para evitar trabalhar no arquivo de outro escopo. ::: :::: :::hint{type="success"} :FontAwesome[]{icon="fa-solid fa-check"} **Verificação** - O documento enviado aparece na tabela com nome, tipo, tamanho e autor, e pode ser encontrado pela busca ou filtro de tipo. - Abrir detalhes mostra o documento correto; baixar cria um arquivo com o nome original. - Depois de uma exclusão confirmada, a linha desaparece após o recarregamento e o documento não pode mais ser aberto naquele escopo. - No detalhe de uma task, o anexo aparece somente no painel compacto daquela task. - Um tipo com campo obrigatório só permite o envio depois que o metadado correspondente é preenchido. ::: :::hint{type="warning"} ****:FontAwesome[****]{icon="fa-solid fa-triangle-exclamation"}** Erros comuns** **Documentos indisponíveis para a sessão** Sem capability efetiva de Documentos, sem Board principal correspondente ou sem permissão de visualização, o acesso é bloqueado e o painel informa a indisponibilidade. Entre no projeto correto ou peça a permissão ao administrador; não tente contornar a rota direta. **Nenhum tipo ativo para upload** O seletor de tipo fica desabilitado quando o catálogo não tem tipos ativos. Um administrador ou responsável deve criar/ativar um tipo na configuração do projeto antes do primeiro envio. **Metadado obrigatório ausente** O botão de upload não avança enquanto algum campo obrigatório estiver vazio ou só contiver espaços. Selecione o tipo correto e preencha todos os campos exigidos; metadados opcionais não precisam ser inventados. **Upload ou download interrompido** Uma falha de rede ou troca de contexto cancela a operação. No upload, a seleção permanece para retry; no download, repita a ação no documento ainda listado e confirme que você continua no mesmo projeto/Board. **Exclusão sem permissão de edição** A ação de excluir não aparece para uma sessão somente leitura. Solicite acesso de edição ao administrador; visualizar e baixar continuam separados da capacidade de apagar. :::