$upload

Devuelve un ID del archivo subido al servidor

Descripción

Publique esta petición cuando tenga un archivo que quiera subir al 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.

Escenario de carga

Imagine que quiere subir una imagen para actualizar el atributo imagen de una entidad.

Para cargar una imagen (o cualquier archivo binario), primero debe seleccionar el archivo desde la aplicación cliente. El archivo en sí debe pasarse en el cuerpo de la petición.

A continuación, se sube la imagen seleccionada a 4D Server mediante una petición como:

POST /rest/$upload?$rawPict=true

Como resultado, el servidor devuelve un ID que identifica el archivo:

Response:

{ "ID": "D507BC03E613487E9B4C2F6A0512FE50" }

Después, se utiliza este ID para añadirlo a un atributo utilizando $method=update para añadir la imagen a una entidad. La petición se ve así:

POST /rest/Employee/?$method=update

Datos POST:

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

Response:

Se devuelve la entidad modificada:

{
    "__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
        }
    },}

Ejemplo con un 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" //preparar une petición REST

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

DOCUMENT TO BLOB("c:\\invoices\\inv003.pdf"; $blob) //Cargar el binario 

 //Ejecuta la primera petición POST para subir el archivo
$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" //segunda petición para actualizar la entidad

    $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