Post ‘multipart/form-data’ out of Salesforce.com with APEX

¿Es cierto que Salesforce no permite realizar peticiones HTTP (callouts) con datos multipart/form-data desde APEX? Pues la respuesta es que Salesforce sí lo permite, lo único que tenemos que tener en cuenta es qué tipo de datos admite el servidor destino al que enviamos la petición.

Esto es muy importante cuando queremos subir archivos desde Salesforce (vía APEX, por supuesto) a un servidor externo a Salesforce, como Box o WatchDox, por ejemplo. Esto resulta económicamente rentable, cuando el coste de almacenamiento del servidor externo es inferior al coste de almacenaniento de Salesforce.

Lo primero que debemos averiguar es qué tipo de datos admite el servidor externo en las peticiones con datos multipart/form-data. Puede ser que el servidor externo sólo admita contenido binario, o puede ser que admita contenido codificado en base64, o ambos.

En el primero de los casos, en el que el servidor destino sólo admita contenido binario, Enrico Murro, miembro de Cloudspokes al igual que yo, ha desarrollado hace escasos días una magnífica solución, que puedes ver aquí. Se trata de una solución que muchos desarrolladores de Salesforce estaban esperando, y que gracias a este reto de Cloudspokes en el que ambos hemos participado, pudimos investigar a fondo sobre este tema.

Si el servidor destino admite también contenido codificado en base64, en este caso la solución es mucho más sencilla. Esta fue la opción que yo opté para este reto, ya que el servidor destino admitía ambos tipos de contenido.

A continuación muestro un código de ejemplo para este tipo de servidores:

public static HTTPResponse uploadFile(String fileName, Blob fileBody, String contentType){

		// Body
		String boundary = String.valueOf(DateTime.now().getTime());
		String body = '------------' + boundary + '\r\n';
        body+='Content-Disposition: form-data; name="data"; filename="' + fileName + '"\r\n';
        body+='Content-Transfer-Encoding: base64\r\n';
        if ((contentType == null) || (contentType == '')){contentType = 'application/octet-stream';}
        body+='Content-Type: ' + contentType + '\r\n\r\n';
        body+=EncodingUtil.base64Encode(fileBody);
       	body+='\r\n------------' + boundary + '--';

		// Instantiate a new HTTP request, specify the method (POST) as well as the endpoint
		HttpRequest req = new HttpRequest();

		// Set headers
		req.setHeader('Content-Type', 'multipart/form-data; boundary=----------' + boundary);
		req.setHeader('Content-Length',String.valueof(body.length()));

		// Set body
		req.setBody(body);

        // Set method and endpoint
		req.setMethod('POST');
		req.setEndpoint('http://www.TuServidorExterno.com');

		// Send HTTP request and get HTTP response
		Http http = new Http();
 		return(http.send(req));
    }

Puedes ver el vídeo de esta funcionalidad en acción correspondiente a mi solución creada para el reto de Cloudspokes, la cual permite subir todo tipo de archivos de hasta 3Mb a WatchDox desde Salesforce. Si el explorador web soporta HTML5, se pueden seleccionar varios archivos para subirlos en el mismo proceso, soporta drag&drop, y además se muestra una barra de progreso por cada archivo que se quiere subir.

Espero que este post os sirva de ayuda.