Saltar al contenido principal
Adaptive Planning
Última actualización: 2023-06-23
exportCustomerLogo

exportCustomerLogo

Categoría
Metadata retrieval
Descripción
Devuelve una URL que se puede utilizar para recuperar el logotipo de cliente.
Permisos obligatorios para invocar
Ninguna (deben ser credenciales válidas para la instancia)
Parámetros obligatorios bajo petición
Credenciales
La solicitud de este método solo contiene una etiqueta de credenciales para identificar y autorizar al usuario que llama. Una vez verificado, el método devuelve un documento XML que contiene la URL que apunta al logotipo de cliente.

Formato de solicitud

<?xml version='1.0' encoding='UTF-8'?> <call method="exportCustomerLogo" callerName="a string that identifies your client application"> <credentials login="sampleuser@company.com" password="my_pwd"/> </call>
elemento de credenciales
Nombre de etiqueta
credenciales
Descripción
Todas las llamadas a la API deben contener un único elemento de credenciales para identificar al usuario que invoca la API. A continuación, la llamada a la API se realiza como este usuario (cualquier pista de auditoría o historial de acciones en el sistema mostrará que este usuario ha realizado la acción) y, por lo tanto, el usuario debe tener los permisos necesarios para realizar la acción a fin de que la llamada a la API se lleve a cabo. correcta
Atributos del elemento
Nombre de atributo
¿Obligatorio?
Valor
Ejemplo
inicio de sesión
El nombre de conexión del usuario que invoca el método API. Este usuario debe tener los permisos necesarios para invocar el método.
sampleuser@company.com
contraseña
La contraseña del usuario que invoca el método API.
my_password
configuración regional
No
Especifique la configuración regional que se utilizará para interpretar los números y las fechas de entrada, y para dar formato a los números y las fechas de salida (utilizando el separador de miles, los nombres de mes y el formato de fecha adecuados). La configuración regional también se utiliza para especificar el idioma en el que deben aparecer los mensajes del sistema en la respuesta. Si no se especifica, se utiliza en_US (inglés americano).
fr_FR
instanceCode
No
Si el usuario especificado en las credenciales tiene acceso a más de una instancia de
Adaptive Planning
, este atributo se puede utilizar para especificar que el usuario tiene la intención de acceder a una instancia distinta a la instancia por defecto. Si no se especifica, se utilizará la instancia por defecto del usuario. Para determinar los códigos de instancia disponibles, utilice la API exportInstances.
MYINSTANCE1
Contenido del elemento
(ninguno)

Formato de respuesta

<?xml version='1.0' encoding='UTF-8'?> <response success="true"> <output> <logos> <logo url="/logo/DCNT/55.jpg?ticket=-1183195070:1:s&login=sampleuser@company.com" /> </logos> </output> </response>
elemento de respuesta
Nombre de etiqueta
respuesta
Atributos del elemento
Nombre de atributo
¿Obligatorio?
Valor
Ejemplo
éxito
Verdadero o falso, que indica si la llamada a la API se ha realizado correctamente o no. Incluso las llamadas correctas pueden contener mensajes de aviso en su respuesta.
verdadero
obsoleto
No
Si está presente en la etiqueta de respuesta y se establece en verdadero, este atributo indica que la versión del método o API que se está invocando ha quedado obsoleta y está oficialmente desaprobada. Aunque sigue funcionando en este momento, es posible que deje de funcionar en un breve periodo de tiempo. Normalmente, este atributo no está presente.
falso
Contenido del elemento
Un único elemento de mensajes opcional y exactamente un elemento de resultado obligatorio.
elemento de resultado
Nombre de etiqueta
salida
Atributos del elemento
(ninguno)
Contenido del elemento
Un solo elemento de cuentas Este contenedor de salida es estándar en todas las respuestas de API e incluye la salida válida de cualquier llamada API correcta.
elemento de logotipos
Nombre de etiqueta
logotipos
Descripción
Contenedor para un elemento de logotipo.
Atributos del elemento
Nombre de atributo
¿Obligatorio?
Valor
Ejemplo
(ninguno)
Contenido del elemento
Exactamente un elemento de logotipo.
elemento de logotipo
Nombre de etiqueta
logo
Descripción
Representa una URL mediante la cual se puede recuperar el logotipo de cliente en la respuesta a una llamada a la API exportCustomerLogo.
Atributos del elemento
Nombre de atributo
¿Obligatorio?
Valor
Ejemplo
URL
La URL mediante la que se puede recuperar el logotipo de cliente o la cadena vacía si no se ha definido ningún logotipo de cliente para esta instancia.
/logo/DCNT/55.jpg?ticket=-1183195070:1:s&login=sampleuser@company.com
Contenido del elemento
(ninguno)