File upload#

O bloco "File upload" envia um arquivo para o Armazenamento e passa seu GUID para um parâmetro da tarefa. O GUID é um identificador usado para acessar o arquivo posteriormente no processo. São necessários uma ação, uma fila associada com tarefas e uma pasta no Armazenamento. O administrador deve conceder ao usuário acesso à ação, à pasta selecionada e ao envio de arquivos.

Configuração do envio de arquivos#

No Designer de formulários, clique em "Adicionar" e selecione "File upload". As configurações do bloco definem a pasta de destino, o nome e as restrições do arquivo.

Campos obrigatórios:

• Campo "Nome do parâmetro na tarefa (Task)" — define o parâmetro que recebe o GUID do arquivo enviado. Informe o nome usado pelo processo que trata a tarefa.
• Campo "Pasta de armazenamento" — determina o destino do envio. Selecione uma pasta disponível na lista.
• Campo "Tamanho máximo do arquivo, MB" — limita o tamanho de cada arquivo. O mínimo é 0.01 e um novo bloco usa 10.

Parâmetros adicionais:

• Caixa de seleção "Obrigatório" — quando marcada, impede o envio do formulário sem o GUID de um arquivo. Quando desmarcada, permite um valor vazio. Vem desmarcada em um novo bloco.
• Campo "Título visível" — define o rótulo do bloco no formulário. Um novo bloco usa File upload.
• Campo "Classe" — define uma classe CSS para a aparência do bloco. Não precisa ser alterada quando não houver necessidade de estilo específico.
• Campo "Dica" — define um texto explicativo abaixo do bloco. Vem vazio em um novo bloco.
• Campo "Prefixo do nome do arquivo" — adiciona texto antes do nome original. Um valor vazio preserva o início do nome.
• Campo "Sufixo do nome do arquivo" — adiciona texto após o nome, antes da extensão. Um valor vazio preserva o final do nome.
• Campo "Tipos de arquivo permitidos" — aceita extensões ou tipos MIME separados por vírgulas, como .txt, application/pdf, image/*. Um valor vazio não restringe o tipo de arquivo no bloco. As verificações do servidor continuam válidas.

Após preencher as configurações, clique em "OK" e depois em "Salvar" no Designer de formulários.

Exemplo: para receber um relatório de texto, marque "Obrigatório". Informe Attachment em "Título visível", attachment_guid em "Nome do parâmetro na tarefa (Task)", selecione a pasta Вложения, informe in- em "Prefixo do nome do arquivo", -checked em "Sufixo do nome do arquivo", .txt em "Tipos de arquivo permitidos" e 1 em "Tamanho máximo do arquivo, MB". Deixe "Classe" e "Dica" vazios. O arquivo report.txt será enviado como in-report-checked.txt.

Envio e substituição de um arquivo#

Ao executar a ação, clique em "Escolher arquivo" e selecione um arquivo no computador. Durante o envio, o bloco mostra a porcentagem concluída e impede uma nova seleção. Um envio bem-sucedido exibe um estado verde com o GUID. Para gravar o GUID no parâmetro da tarefa, clique no botão da ação configurado para salvar as alterações na tarefa atual.

Arquivos de tipo não permitido ou com tamanho excessivo não são enviados ao servidor. Um erro do servidor gera um estado vermelho e uma mensagem. Verifique o arquivo, as restrições e o acesso à pasta, e repita a seleção.

Uma nova seleção limpa o GUID anterior no formulário. Se o envio do arquivo substituto falhar, um bloco obrigatório impede salvar o formulário. Os arquivos enviados anteriormente permanecem no Armazenamento. Limpar o formulário redefine o estado do bloco, e mudar para outra tarefa cancela o envio atual na interface.

Atualizar o formulário da tarefa atual restaura seus parâmetros salvos e redefine o estado do envio. Se um novo arquivo foi enviado, mas a tarefa ainda não foi salva, seu GUID não substitui o valor salvo após a atualização do formulário.

Se um conflito ao salvar for resolvido aceitando o valor atual do parâmetro com um GUID diferente, o bloco limpa o estado e o nome do arquivo enviado anteriormente. Ao salvar novamente, o valor aceito é utilizado.

Exemplo: após enviar report.txt com sucesso, selecione archive.zip. Com a restrição .txt, o bloco mostra um erro de tipo de arquivo. Selecione um arquivo de texto adequado e aguarde o estado verde antes de salvar a tarefa.