exportCustomerLogo
Categoria
| Recuperação de metadados |
Descrição
| Retorna um URL que pode ser usado para recuperar o logotipo do cliente |
Permissões obrigatórias para invocar
| Nenhum (devem ser credenciais válidas para a instância) |
Parâmetros obrigatórios na solicitação
| Credenciais |
A solicitação desse método contém apenas uma etiqueta de credenciais para identificar e autorizar o usuário que está fazendo a chamada. Uma vez verificado, o método retorna um documento XML contendo o URL que aponta para o logotipo do cliente.
Formato da solicitação
<?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 credenciais
| |||
Nome da etiqueta
| credenciais | ||
Descrição
| Todas as chamadas de API devem conter um único elemento de credenciais para identificar o usuário que invoca a API. A chamada à API é então executada como este usuário (qualquer trilha de auditoria ou histórico de ações no sistema mostrará que este usuário executou a ação) e, portanto, o usuário deve ter as permissões necessárias para executar a ação para que a chamada à API funcione. bem-sucedido. | ||
Atributos do elemento
| |||
Nome do atributo
| Obrigatório?
| Valor
| Exemplo
|
login | S | O nome de logon do usuário que invoca o método de API. Esse usuário deve ter as permissões necessárias para invocar o método. | sampleuser@company.com |
senha | S | A senha do usuário que invoca o método de API. | my_password |
parâmetros regionais | N | Especifique os parâmetros regionais a serem usados para interpretar números e datas de entrada e para formatar números e datas de saída (usando o separador de milhares, nomes de meses e formatação de data adequados). Os parâmetros regionais também são usados para especificar o idioma em que as mensagens do sistema na resposta devem ser exibidas. Se não especificado, en_US (inglês americano) é usado. | fr_FR |
instanceCode | N | Se o usuário especificado nas credenciais tem acesso a mais de uma instância do Adaptive Planning , esse atributo pode ser usado para especificar que o usuário pretende acessar uma instância diferente da instância por padrão. Se não for especificada, a instância por padrão do usuário será usada. Para determinar os códigos de instância disponíveis, use a API exportInstances. | MYINSTANCE1 |
Conteúdo do elemento
| |||
(nenhum) | |||
Formato da resposta
<?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 resposta
| |||
Nome da etiqueta
| resposta | ||
Atributos do elemento
| |||
Nome do atributo
| Obrigatório?
| Valor
| Exemplo
|
êxito | S | Verdadeiro ou falso, indicando se a chamada à API foi bem-sucedida ou não. Mesmo as chamadas bem-sucedidas podem conter mensagens de aviso na resposta. | verdadeiro |
obsoleto | N | Se presente na etiqueta de resposta e definido como verdadeiro, esse atributo indica que a versão do método ou da API que está sendo invocada se tornou obsoleta e está oficialmente obsoleta. Embora continue a funcionar neste momento, pode deixar de funcionar em breve. Normalmente, esse atributo não está presente. | false |
Conteúdo do elemento
| |||
Um único elemento de mensagens opcional e exatamente um elemento de saída obrigatório. | |||
elemento de saída
| |
Nome da etiqueta
| saída |
Atributos do elemento
| |
(nenhum) | |
Conteúdo do elemento
|
Um único elemento de contas. Esse invólucro de saída é padrão em todas as respostas de API e inclui a saída válida de qualquer chamada de API bem-sucedida. |
elemento de logotipos
| |||
Nome da etiqueta
| logotipos | ||
Descrição
| Contêiner para um elemento de logotipo. | ||
Atributos do elemento
| |||
Nome do atributo
| Obrigatório?
| Valor
| Exemplo
|
(nenhum) | |||
Conteúdo do elemento
| |||
Exatamente um elemento de logotipo. | |||
elemento de logotipo
| |||
Nome da etiqueta
| logotipo | ||
Descrição
| Representa um URL pelo qual o logotipo do cliente pode ser recuperado em resposta a uma chamada à API exportCustomerLogo. | ||
Atributos do elemento
| |||
Nome do atributo
| Obrigatório?
| Valor
| Exemplo
|
url | S | URL pelo qual o logotipo do cliente pode ser recuperado ou a cadeia de caracteres vazia, se nenhum logotipo do cliente for definido para esta instância. | /logo/DCNT/55.jpg?ticket=-1183195070:1:s&login=sampleuser@company.com
|
Conteúdo do elemento
| |||
(nenhum) | |||