exportLocales
Categoria
| Recuperação de metadados |
Descrição
| Retorna uma lista de todos os parâmetros regionais de uma empresa. |
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 que descreve o conjunto completo de todos os parâmetros regionais associados a essa empresa.Formato da solicitação
<?xml version='1.0' encoding='UTF-8'?> <call method="exportLocales" 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, será usada a instância por padrão do usuário. 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> <locales> <locale code="en" name="English" isDefault="1" /> <locale code="de" name="German" isDefault="0" /> <locale code="fr" name="French" isDefault="0" /> <locale code="es" name="Spanish" isDefault="0" /> <locale code="pt" name="Portuguese" isDefault="0" /> <locale code="nl" name="Dutch" isDefault="0" /> <locale code="ja" name="Japanese" isDefault="0" /> </locales> </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
| |||
Nome do atributo
| Obrigatório?
| Valor
| Exemplo
|
(nenhum) | |||
Conteúdo do elemento
| |||
Um único elemento de atributos obrigatórios. 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 parâmetros regionais
| |||
Nome da etiqueta
| parâmetros regionais | ||
Descrição
| Contêiner para um ou mais elementos de parâmetros regionais. | ||
Atributos do elemento
| |||
Nome do atributo
| Obrigatório?
| Valor
| Exemplo
|
(nenhum) | |||
Conteúdo do elemento
| |||
Um ou mais elementos de parâmetros regionais. | |||
elemento de parâmetros regionais
| |||
Nome da etiqueta
| parâmetros regionais | ||
Descrição
| Representa um único parâmetro regional associado a uma empresa. | ||
Atributos do elemento
| |||
Nome do atributo
| Obrigatório?
| Valor
| Exemplo
|
código | S | O código de parâmetros regionais padrão usado pelo Firefox. | en |
nome | S | Uma versão legível do nome dos parâmetros regionais. | Inglês |
isDefault | S | Se esse parâmetro regional é o valor por padrão para a empresa, 1. Caso contrário, 0. | 1 |
Conteúdo do elemento
| |||
(nenhum) | |||