O bloco permite criar um objeto form-data para realizar uma requisição do tipo multipart/form-data com o uso do bloco Obter conteúdo da URL.  


Figura 1 - Objeto para Form-Data

Compatibilidade

  • Bloco servidor: cronapi.util.Operations.getFormDataObject()

Retorno

Retorna um objeto JSON contendo os atributos "value", "contentType" e "filename".

Parâmetros

Descrição dos parâmetros do bloco.

Valor

Conteúdo do arquivo.

  • Posição: 1
  • Inglês: Value
  • Tipos: Arquivo (file), array de byte, input string ou texto (como o base64).
  • Exemplo: "meu texto."

Tipo de conteúdo

Define o tipo do arquivo a ser enviado a partir dos tipos MIME (lista com os principais MIME types).

  • Posição: 2
  • Inglês: Content type
  • Tipo: Texto / String
  • Exemplo: "image/png"

Nome do Arquivo

Nome do arquivo, o recurso que irá receber a requisição poderá utilizar esse nome para renomear o arquivo.

  • Posição: 3
  • Inglês: File name
  • Tipo: Texto / String
  • Exemplo: "Minha Foto.png"

Exemplo

No exemplo da função abaixo, a variável "arq" (destaque 1 da figura 2) obtém o conteúdo de um arquivo a partir do bloco Abrir arquivo para leitura, em seguida, a variável "map" (destaque 2) recebe um mapa que possui a chave "file" e, em seu valor, é passado o objeto criado pelo bloco Objeto para Form-Data com os parâmetros contendo o conteúdo de um arquivo .pdf, o content-type desse formato e o nome do arquivo.

A variável "resp" (destaque 3) possui o bloco Obter conteúdo da URL configurado com o Método de requisição "POST", no parâmetro Tipo de conteúdo foi selecionado a opção "multipart/form-data", no parâmetro Endereço URL foi passado um recurso REST que espera receber requisições nesse formato, o parâmetro Dados para postagem (corpo da requisição) informamos o mapa com o objeto gerado pelo bloco Objeto para Form-Data e, no último parâmetro, selecionamos a opção "Status" em Tipo da resposta.

Ao executar, o bloco Obter conteúdo da URL irá retornar o Status "200", confirmando o sucesso da requisição.


Figura 2 - Função que dispara uma requisição REST do tipo multipart/form-data

Nesta página