Documentación API.

¿Cómo establecer la foto de un tercero en el inventario?

GetFotoTercero (datajson, controlkey, iapp, random) : TMemoryStream

Descripción

Esta función es la encargada de retornar la imagen que tenga asignada un elemento de inventario en el sistema. Un elemento de inventario puede tener asignadas varias imágenes, por lo cual es necesario enviar el código de la imagen que se desea obtener.

Resultado

Retorna un TMemoryStream que contiene la imagen del elemento de inventario.

Seguridad

Aplica todas las configuraciones de seguridad de datos y de seguridad de acciones de ContaPyme / AgroWin.

Compatibilidad de la API

Función disponible desde ContaPyme/AgroWin Versión 4 - Release 7.

Petición

Requisitos

Debe haber realizado el logueo en el agente a través de la función GETAUTH().

Parámetros

Nombre parámetro	Tipo	Descripción	Ejemplo
dataJSON	JSON	Json que contiene en su interior la siguiente estructura. Irecurso: Código del elemento de inventario. Codimg: Código de la imagen que se desea obtener.	{ "irecurso":"06120", "codimg":"1" }
controlkey	Varchar	Corresponde al keyagente obtenido en el logueo (requerido).	"564654"	"222912"
iapp	Varchar	Código que identifica a la aplicación que interactúa con el Agente (requerido)	"1068"
random	Varchar	Cadena aleatoria que se crea en el lado del cliente, esto con el fin de que las peticiones no sean cacheadas por el navegador Internet Explorer (para aplicaciones web). (Opcional).	"54654"

Ejemplo de la ejecución en JavaScript

//Escriba a continuación la URL donde se encuentra su Agente de servicios web de ContaPyme. var URLUbicacion = 'http://local.insoft.co:9000' var URLFuncion = '/datasnap/rest/TCatElemInv/"GetFotoElemInv"/'; //Se construye la URL completa la cual es la concatenación de la ubicación y la función var URL = URLUbicacion + URLFuncion; //Invocamos la función que retorna controlKey para modo aprendizaje var controlkey = getControlKey(URLUbicacion); //1001 es el iapp configurado para agente de servicios web de ContaPyme. var iapp = "1001"; //dataJSON: parámetros de entrada para la función var dataJSON = { "irecurso":"DID003", "codimg":"1" } //Se arma los 4 parámetros de entrada de la funcion URL = URL + JSON.stringify(dataJSON) + "/" + controlkey + "/" + iapp + "/0"; imprimirRespuesta(URL);

► EJECUTAR CODIGO

Ver otros ejemplos en: PHP , JAVA , C# , Visual Basic.net , Visual Basic 6 , Delphi.

Ver documentación de la petición por GET.

Respuesta

JSON Ir arriba

El resultado de la petición es un stream cuya presentación es algo como lo que sigue (extracto de los primeros caracteres):

"ÿØÿà\u0000\u0010JFIF\u0000\u0001\u0002\u0001\u0000`\u0000`\
u0000\u0000ÿî\u0000\u000eAdobe\u0000d\u0000\u0000\u0000\u0000\u0001ÿá\u0014#Exif\u0000\u0000MM\u0000*\
u0000\u0000\u0000\b\u0000\u0007\u00012\u0000\u0002\u0000\u0000\u0000\u0014"

Para poder visualizar la imagen en una página web se debe poner la URL de la petición en la propiedad src de la etiqueta img, la url debe tener los parámetros que recibe la función, el ejemplo lo podemos ver a continuación.

<img src= http://190.248.152.10:8011/datasnap/rest/TCatElemInv/GetFotoElemInv/{"irecurso":"06120","codimg":"1"}
/306407550588300/1028/12891266518477008>