$upload

Devolve um ID do ficheiro carregado para o servidor

Descrição

Publique essa petição quando quiser fazer upload de um ficheiro para o servidor. Si tiene una imagen, pase $rawPict=true. Para todos los demás archivos, se pasa $binary=true.

Puede modificar el tiempo de espera, que por defecto es de 120 segundos, pasando un valor al parámetro $timeout.

Cenário de carregamento

Imagine que pretende carregar uma imagem para atualizar o atributo imagem de uma entidade.

Para carregar uma imagem (ou qualquer ficheiro binário), deve primeiro selecionar o ficheiro a partir da aplicação cliente. El archivo en sí debe pasarse en el cuerpo de la petición.

Depois, carrega a imagem selecionada para 4D Server usando uma petição como:

POST /rest/$upload?$rawPict=true

Como resultado, o servidor devolve um ID que identifica o ficheiro:

Response:

{ "ID": "D507BC03E613487E9B4C2F6A0512FE50" }

Posteriormente, você usa essa ID para adicioná-la a um atributo usando $method=update para adicionar a imagem a uma entidade. O pedido tem o seguinte aspecto:

POST /rest/Employee/?$method=update

Datos POST:

{
    __KEY: "12",
    __STAMP: 4,
    photo: { "ID": "D507BC03E613487E9B4C2F6A0512FE50" } 
}

Response:

A entidade modificada é devolvida:

{
    "__KEY": "12", 
    "__STAMP": 5, 
    "uri": "http://127.0.0.1:8081/rest/Employee(12)", 
    "ID": 12, 
    "firstName": "John", 
    "firstName": "Smith",
    "photo":
    {
        "__deferred":
        {
            "uri": "/rest/Employee(12)/photo?$imageformat=best&$version=1&$expand=photo",
            "image": true
        }
    },}

Exemplo com um cliente 4D HTTP

El siguiente ejemplo muestra cómo subir un archivo .pdf al servidor utilizando el cliente 4D HTTP.

var $params : Text
var $response : Object
var $result : Integer
var $blob : Blob


ARRAY TEXT($headerNames; 1)
ARRAY TEXT($headerValues; 1)

$url:="localhost:80/rest/$upload?$binary=true" //prepare the REST request

$headerNames{1}:="Content-Type"
$headerValues{1}:="application/octet-stream"

DOCUMENT TO BLOB("c:\\invoices\\inv003.pdf"; $blob) //Load the binary 

 //Execute the first POST request to upload the file
$result:=HTTP Request(HTTP POST method; $url; $blob; $response; $headerNames; $headerValues)

If ($result=200) 
	var $data : Object
    $data:=New object
    $data.__KEY:="3"
    $data.__STAMP:="3"
    $data.pdf:=New object("ID"; String($response.ID)) 

    $url:="localhost:80/rest/Invoices?$method=update" //second request to update the entity

    $headerNames{1}:="Content-Type"
    $headerValues{1}:="application/json"

    $result:=HTTP Request(HTTP POST method; $url; $data; $response; $headerNames; $headerValues)
Else
	ALERT(String($result)+" Error")
End if